peaks-loop-internal-runtime 0.0.1 → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peaks contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/dispatch.d.ts

@@ -1,3 +1,4 @@
+import type { ChildProcess } from 'node:child_process';
 export interface DispatchInput {
     sid: string;
     rid: string;
@@ -13,6 +14,7 @@ export interface DispatchInput {
 export interface DispatchResult {
     pid: number;
     dispatchRecordPath: string;
+    child?: ChildProcess;
 }
 export declare function dispatchDetached(i: DispatchInput): Promise<DispatchResult>;
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,KAAK,GAAC,iBAAiB,CAAC;IACvE,MAAM,EAAE,QAAQ,GAAC,OAAO,GAAC,SAAS,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AACD,MAAM,WAAW,cAAc;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;CAAE;AAE5E,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAkChF"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYvD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,KAAK,GAAC,iBAAiB,CAAC;IACvE,MAAM,EAAE,QAAQ,GAAC,OAAO,GAAC,SAAS,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AACD,MAAM,WAAW,cAAc;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAAE;AAElG,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAkChF"}

package/dist/dispatch.js

@@ -36,5 +36,5 @@ export async function dispatchDetached(i) {
         rid: i.rid, mode: 'detached', vendor: i.vendor,
         status: 'running', heartbeats: [], at: Date.now(),
     }, null, 2));
-    return { pid: handle.pid, dispatchRecordPath: recPath };
+    return { pid: handle.pid, dispatchRecordPath: recPath, child: handle.child };
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export declare const RUNTIME_VERSION = "4.0.19";
+export declare const RUNTIME_VERSION = "4.0.22";
+export declare const RUNTIME_NPM_VERSION = "0.0.3";
 export { ClaudeAdapter } from './vendor/claude-adapter.js';
 export { CodexAdapter } from './vendor/codex-adapter.js';
 export { CopilotAdapter } from './vendor/copilot-adapter.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,WAAW,CAAC;AAMxC,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,4 +1,12 @@
-export const RUNTIME_VERSION = '4.0.19';
+// API contract: RUNTIME_VERSION tracks peaks-loop root version (4.0.x).
+// This is what consumers (sub-agents dispatched by peaks-code) check at
+// runtime to verify protocol compatibility.
+export const RUNTIME_VERSION = '4.0.22';
+// npm version: independent 0.0.x SemVer. Runtime is its own package
+// (peaks-loop-internal-runtime@NPM_VERSION) on the registry; bumps
+// per peaks release notes when its public surface actually changes
+// (not per root version bump).
+export const RUNTIME_NPM_VERSION = '0.0.3';
 export { ClaudeAdapter } from './vendor/claude-adapter.js';
 export { CodexAdapter } from './vendor/codex-adapter.js';
 export { CopilotAdapter } from './vendor/copilot-adapter.js';

package/dist/vendor/claude-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/claude-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,MAAM,YAAY;IAC3B,QAAQ,CAAC,cAAc,SAAY;IAEnC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAO7E,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAe7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAM1C"}
+{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/claude-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,MAAM,YAAY;IAC3B,QAAQ,CAAC,cAAc,SAAY;IAEnC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAO7E,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAe7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAG1C"}

package/dist/vendor/claude-adapter.js

@@ -1,6 +1,4 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-const pExecFile = promisify(execFile);
+import { detectBinaryInstalled } from './detect-binary.js';
 export class ClaudeAdapter {
     id = 'claude';
     binary = 'claude';
@@ -30,12 +28,6 @@ export class ClaudeAdapter {
         }
     }
     async detectInstalled() {
-        try {
-            const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
-            return stdout.length > 0;
-        }
-        catch {
-            return false;
-        }
+        return detectBinaryInstalled(this.binary);
     }
 }

package/dist/vendor/codex-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/codex-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAC/B,QAAQ,CAAC,MAAM,WAAW;IAC1B,QAAQ,CAAC,cAAc,SAAY;IACnC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAGtC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAI1C"}
+{"version":3,"file":"codex-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/codex-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAC/B,QAAQ,CAAC,MAAM,WAAW;IAC1B,QAAQ,CAAC,cAAc,SAAY;IACnC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAGtC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAG1C"}

package/dist/vendor/codex-adapter.js

@@ -1,6 +1,4 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-const pExecFile = promisify(execFile);
+import { detectBinaryInstalled } from './detect-binary.js';
 export class CodexAdapter {
     id = 'codex';
     binary = 'codex';
@@ -20,12 +18,6 @@ export class CodexAdapter {
         }
     }
     async detectInstalled() {
-        try {
-            const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
-            return stdout.length > 0;
-        }
-        catch {
-            return false;
-        }
+        return detectBinaryInstalled(this.binary);
     }
 }

package/dist/vendor/copilot-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/copilot-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,EAAE,EAAG,SAAS,CAAU;IACjC,QAAQ,CAAC,MAAM,aAAa;IAC5B,QAAQ,CAAC,cAAc,SAAY;IACnC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IACtC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAI1C"}
+{"version":3,"file":"copilot-adapter.d.ts","sourceRoot":"","sources":["../../src/vendor/copilot-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,EAAE,EAAG,SAAS,CAAU;IACjC,QAAQ,CAAC,MAAM,aAAa;IAC5B,QAAQ,CAAC,cAAc,SAAY;IACnC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IACtC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO7C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAG1C"}

package/dist/vendor/copilot-adapter.js

@@ -1,6 +1,4 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-const pExecFile = promisify(execFile);
+import { detectBinaryInstalled } from './detect-binary.js';
 export class CopilotAdapter {
     id = 'copilot';
     binary = 'copilot';
@@ -18,12 +16,6 @@ export class CopilotAdapter {
         }
     }
     async detectInstalled() {
-        try {
-            const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
-            return stdout.length > 0;
-        }
-        catch {
-            return false;
-        }
+        return detectBinaryInstalled(this.binary);
     }
 }

package/dist/vendor/detect-binary.d.ts

@@ -0,0 +1,3 @@
+/** Resolve a binary through the platform's PATH lookup without invoking a shell. */
+export declare function detectBinaryInstalled(binary: string): Promise<boolean>;
+//# sourceMappingURL=detect-binary.d.ts.map

package/dist/vendor/detect-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-binary.d.ts","sourceRoot":"","sources":["../../src/vendor/detect-binary.ts"],"names":[],"mappings":"AAIA,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQtE"}

package/dist/vendor/detect-binary.js

@@ -0,0 +1,11 @@
+import { execFile } from 'node:child_process';
+const DETECT_TIMEOUT_MS = 3000;
+/** Resolve a binary through the platform's PATH lookup without invoking a shell. */
+export function detectBinaryInstalled(binary) {
+    const locator = process.platform === 'win32' ? 'where.exe' : 'which';
+    return new Promise((resolve) => {
+        execFile(locator, [binary], { timeout: DETECT_TIMEOUT_MS }, (error, stdout) => {
+            resolve(error === null && stdout.trim().length > 0);
+        });
+    });
+}

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "peaks-loop-internal-runtime",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "Detached sub-agent runtime: ProcessSupervisor + LifecycleOwner + VendorAdapter (claude/codex/copilot) + G8 infinite-context auto-compact. Slice 2026-08-10.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SquabbyZ/peaks-loop"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,15 +15,15 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run tests/unit/runtime"
-  },
   "peerDependencies": {
-    "peaks-loop-shared": "workspace:*"
+    "peaks-loop-shared": "0.0.53"
   },
   "devDependencies": {
     "typescript": "^5.4.0",
     "vitest": "4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run tests/unit/runtime"
   }
-}
+}

package/src/dispatch.ts

@@ -1,5 +1,6 @@
 import { writeFileSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
+import type { ChildProcess } from 'node:child_process';
 import { ProcessSupervisor } from './process-supervisor.js';
 import { LifecycleOwner } from './lifecycle.js';
 import { VendorAdapterRegistry } from './vendor/registry.js';
@@ -18,7 +19,7 @@ export interface DispatchInput {
   runtimeDir: string; subAgentsDir: string;
   verbatimBlocks?: string[];
 }
-export interface DispatchResult { pid: number; dispatchRecordPath: string; }
+export interface DispatchResult { pid: number; dispatchRecordPath: string; child?: ChildProcess; }
 
 export async function dispatchDetached(i: DispatchInput): Promise<DispatchResult> {
   const registry = new VendorAdapterRegistry([new ClaudeAdapter(), new CodexAdapter(), new CopilotAdapter()]);
@@ -53,5 +54,5 @@ export async function dispatchDetached(i: DispatchInput): Promise<DispatchResult
     status: 'running', heartbeats: [], at: Date.now(),
   }, null, 2));
 
-  return { pid: handle.pid, dispatchRecordPath: recPath };
+  return { pid: handle.pid, dispatchRecordPath: recPath, child: handle.child };
 }

package/src/index.ts

@@ -1,13 +1,13 @@
 // API contract: RUNTIME_VERSION tracks peaks-loop root version (4.0.x).
 // This is what consumers (sub-agents dispatched by peaks-code) check at
 // runtime to verify protocol compatibility.
-export const RUNTIME_VERSION = '4.0.20';
+export const RUNTIME_VERSION = '4.0.22';
 
 // npm version: independent 0.0.x SemVer. Runtime is its own package
 // (peaks-loop-internal-runtime@NPM_VERSION) on the registry; bumps
 // per peaks release notes when its public surface actually changes
 // (not per root version bump).
-export const RUNTIME_NPM_VERSION = '0.0.1';
+export const RUNTIME_NPM_VERSION = '0.0.3';
 export { ClaudeAdapter } from './vendor/claude-adapter.js';
 export { CodexAdapter } from './vendor/codex-adapter.js';
 export { CopilotAdapter } from './vendor/copilot-adapter.js';

package/src/vendor/claude-adapter.ts

@@ -1,9 +1,6 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
 import type { VendorAdapter } from './adapter.js';
 import type { ChildStatus } from '../types.js';
-
-const pExecFile = promisify(execFile);
+import { detectBinaryInstalled } from './detect-binary.js';
 
 export class ClaudeAdapter implements VendorAdapter {
   readonly id = 'claude' as const;
@@ -33,9 +30,6 @@ export class ClaudeAdapter implements VendorAdapter {
   }
 
   async detectInstalled(): Promise<boolean> {
-    try {
-      const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 });
-      return stdout.length > 0;
-    } catch { return false; }
+    return detectBinaryInstalled(this.binary);
   }
 }

package/src/vendor/codex-adapter.ts

@@ -1,8 +1,6 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
 import type { VendorAdapter } from './adapter.js';
 import type { ChildStatus } from '../types.js';
-const pExecFile = promisify(execFile);
+import { detectBinaryInstalled } from './detect-binary.js';
 
 export class CodexAdapter implements VendorAdapter {
   readonly id = 'codex' as const;
@@ -19,7 +17,6 @@ export class CodexAdapter implements VendorAdapter {
     } catch { return null; }
   }
   async detectInstalled(): Promise<boolean> {
-    try { const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 }); return stdout.length > 0; }
-    catch { return false; }
+    return detectBinaryInstalled(this.binary);
   }
 }

package/src/vendor/copilot-adapter.ts

@@ -1,8 +1,6 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
 import type { VendorAdapter } from './adapter.js';
 import type { ChildStatus } from '../types.js';
-const pExecFile = promisify(execFile);
+import { detectBinaryInstalled } from './detect-binary.js';
 
 export class CopilotAdapter implements VendorAdapter {
   readonly id = 'copilot' as const;
@@ -17,7 +15,6 @@ export class CopilotAdapter implements VendorAdapter {
     } catch { return null; }
   }
   async detectInstalled(): Promise<boolean> {
-    try { const { stdout } = await pExecFile(this.binary, ['--version'], { timeout: 3000 }); return stdout.length > 0; }
-    catch { return false; }
+    return detectBinaryInstalled(this.binary);
   }
 }

package/src/vendor/detect-binary.ts

@@ -0,0 +1,14 @@
+import { execFile } from 'node:child_process';
+
+const DETECT_TIMEOUT_MS = 3000;
+
+/** Resolve a binary through the platform's PATH lookup without invoking a shell. */
+export function detectBinaryInstalled(binary: string): Promise<boolean> {
+  const locator = process.platform === 'win32' ? 'where.exe' : 'which';
+
+  return new Promise((resolve) => {
+    execFile(locator, [binary], { timeout: DETECT_TIMEOUT_MS }, (error, stdout) => {
+      resolve(error === null && stdout.trim().length > 0);
+    });
+  });
+}