diff --git a/CHANGELOG.md b/CHANGELOG.md
index d17a73466b9e..f0fdc1b21b82 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@ Docs: https://docs.openclaw.ai
 ### Changes
 
 ### Fixes
+
 - Tests: fail the kitchen-sink RPC Docker walk when gateway RSS sampling is unavailable instead of silently disabling the per-process memory guard.
 - Tests: suppress the current Rolldown plugin timing warning format in the Vitest wrapper so tiny focused runs do not drown useful stderr in repeated build-timing noise.
 - Models/OpenRouter: use endpoint-specific OpenRouter context limits from `top_provider` metadata so provider-routed models no longer overstate available context. (#85949) Thanks @TurboTheTurtle.
diff --git a/scripts/npm-runner.d.mts b/scripts/npm-runner.d.mts
new file mode 100644
index 000000000000..08e24720af41
--- /dev/null
+++ b/scripts/npm-runner.d.mts
@@ -0,0 +1,16 @@
+export type NpmRunnerParams = {
+  comSpec?: string;
+  env?: NodeJS.ProcessEnv;
+  execPath?: string;
+  existsSync?: (path: string) => boolean;
+  npmArgs?: string[];
+  platform?: NodeJS.Platform;
+};
+
+export function resolveNpmRunner(params?: NpmRunnerParams): {
+  args: string[];
+  command: string;
+  env?: NodeJS.ProcessEnv;
+  shell: boolean;
+  windowsVerbatimArguments?: boolean;
+};
diff --git a/scripts/pnpm-runner.d.mts b/scripts/pnpm-runner.d.mts
new file mode 100644
index 000000000000..03a43e88279f
--- /dev/null
+++ b/scripts/pnpm-runner.d.mts
@@ -0,0 +1,30 @@
+import type { ChildProcess, SpawnOptions } from "node:child_process";
+
+export type PnpmRunnerParams = {
+  comSpec?: string;
+  cwd?: string;
+  detached?: boolean;
+  env?: NodeJS.ProcessEnv;
+  nodeArgs?: string[];
+  nodeExecPath?: string;
+  npmExecPath?: string;
+  platform?: NodeJS.Platform;
+  pnpmArgs?: string[];
+  stdio?: SpawnOptions["stdio"];
+};
+
+export function resolvePnpmRunner(params?: PnpmRunnerParams): {
+  args: string[];
+  command: string;
+  env?: NodeJS.ProcessEnv;
+  shell: boolean;
+  windowsVerbatimArguments?: boolean;
+};
+
+export function createPnpmRunnerSpawnSpec(params?: PnpmRunnerParams): {
+  args: string[];
+  command: string;
+  options: SpawnOptions;
+};
+
+export function spawnPnpmRunner(params?: PnpmRunnerParams): ChildProcess;
diff --git a/scripts/windows-cmd-helpers.d.mts b/scripts/windows-cmd-helpers.d.mts
new file mode 100644
index 000000000000..ef9c3bd2015e
--- /dev/null
+++ b/scripts/windows-cmd-helpers.d.mts
@@ -0,0 +1,3 @@
+export function resolvePathEnvKey(env: NodeJS.ProcessEnv): string;
+
+export function buildCmdExeCommandLine(command: string, args: string[]): string;