@omnicross/cli-launcher 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -1,110 +1,12 @@
+import { ProcessSupervisor } from './types.cjs';
+export { ManagedRun, ManagedRunStdin, RunExit, RunRecord, RunRegistry, RunState, SpawnChildInput, SpawnInput, SpawnPtyInput, TerminationReason } from './types.cjs';
 import { ChildProcess } from 'node:child_process';
+export { PtyAdapterHandle } from './pty-adapter.cjs';
 import { ProviderConfigSource, UsageRecorderImport } from '@omnicross/core';
 import { ApiKeyPoolService } from '@omnicross/core/completion/ApiKeyPoolService';
 import { SubscriptionAuthProfile } from '@omnicross/core/pipeline/SubscriptionAuthSource';
 import { RouteAuthMode } from '@omnicross/core/provider-proxy';
 
-/**
- * Process Supervisor types.
- *
- * Defines all interfaces for subprocess lifecycle management:
- * spawn inputs, run records, exit results, and module contracts.
- *
- * @module types
- */
-type RunState = 'starting' | 'running' | 'exiting' | 'exited';
-type TerminationReason = 'manual-cancel' | 'overall-timeout' | 'no-output-timeout' | 'spawn-error' | 'signal' | 'exit';
-interface SpawnBaseInput {
-    runId?: string;
-    sessionId: string;
-    backendId: string;
-    scopeKey?: string;
-    replaceExistingScope?: boolean;
-    cwd?: string;
-    env?: Record<string, string>;
-    timeoutMs?: number;
-    noOutputTimeoutMs?: number;
-    captureOutput?: boolean;
-    onStdout?: (chunk: string) => void;
-    onStderr?: (chunk: string) => void;
-}
-interface SpawnChildInput extends SpawnBaseInput {
-    mode: 'child';
-    argv: string[];
-    windowsVerbatimArguments?: boolean;
-    input?: string;
-    stdinMode?: 'inherit' | 'pipe-open' | 'pipe-closed';
-}
-interface SpawnPtyInput extends SpawnBaseInput {
-    mode: 'pty';
-    /** Shell executable (defaults: powershell.exe on Windows, /bin/bash on Unix). */
-    shell?: string;
-    /** Arguments passed to the shell. */
-    args?: string[];
-    /** Terminal columns (default: 120). */
-    cols?: number;
-    /** Terminal rows (default: 30). */
-    rows?: number;
-}
-/** Spawn input union — child-process or PTY mode. */
-type SpawnInput = SpawnChildInput | SpawnPtyInput;
-interface RunRecord {
-    runId: string;
-    sessionId: string;
-    backendId: string;
-    scopeKey?: string;
-    pid?: number;
-    startedAtMs: number;
-    lastOutputAtMs: number;
-    createdAtMs: number;
-    updatedAtMs: number;
-    state: RunState;
-    terminationReason?: TerminationReason;
-    exitCode?: number | null;
-    exitSignal?: string | null;
-}
-interface RunExit {
-    reason: TerminationReason;
-    exitCode: number | null;
-    exitSignal: string | null;
-    durationMs: number;
-    stdout: string;
-    stderr: string;
-    timedOut: boolean;
-    noOutputTimedOut: boolean;
-}
-interface ManagedRunStdin {
-    write(data: string): void;
-    end(): void;
-    destroy(): void;
-}
-interface ManagedRun {
-    runId: string;
-    pid?: number;
-    startedAtMs: number;
-    stdin?: ManagedRunStdin;
-    wait: () => Promise<RunExit>;
-    cancel: (reason?: TerminationReason) => void;
-}
-interface ProcessSupervisor {
-    spawn(input: SpawnInput): ManagedRun;
-    cancel(runId: string, reason?: TerminationReason): void;
-    cancelScope(scopeKey: string, reason?: TerminationReason): void;
-    getRecord(runId: string): RunRecord | undefined;
-    /** Resize the PTY terminal. No-op for non-PTY runs. */
-    resizePty(runId: string, cols: number, rows: number): boolean;
-}
-interface RunRegistry {
-    add(record: RunRecord): void;
-    get(runId: string): RunRecord | undefined;
-    list(): RunRecord[];
-    listByScope(scopeKey: string): RunRecord[];
-    updateState(runId: string, state: RunState, patch?: Partial<RunRecord>): void;
-    touchOutput(runId: string): void;
-    finalize(runId: string, reason: TerminationReason, exitCode?: number | null, exitSignal?: string | null): void;
-    delete(runId: string): void;
-}
-
 /**
  * child_process spawn adapter.
  *
@@ -128,36 +30,6 @@ interface ChildAdapterHandle {
     dispose: () => void;
 }
 
-/**
- * PTY Adapter — wraps node-pty into the same handle shape
- * used by child-adapter, so ProcessSupervisor can manage
- * both child_process and PTY sessions uniformly.
- *
- * node-pty is lazily loaded — the import only happens when
- * a PTY spawn is actually requested.
- *
- * @module pty-adapter
- */
-
-interface PtyAdapterHandle {
-    pid: number | undefined;
-    onStdout(cb: (data: string) => void): void;
-    onStderr(cb: (data: string) => void): void;
-    stdin: {
-        write(data: string): void;
-        end(): void;
-        destroy(): void;
-    };
-    write(data: string): void;
-    resize(cols: number, rows: number): void;
-    wait(): Promise<{
-        code: number | null;
-        signal: string | null;
-    }>;
-    kill(signal?: string): void;
-    dispose(): void;
-}
-
 /**
  * Per-CLI launch-config builders for the GENUINELY-NEW interceptable backends
  * (qwen / copilot / opencode) — the OpenAI-Chat-Completions analogue of
@@ -465,4 +337,4 @@ declare function buildCodexLaunchConfig(inputs: CodexLaunchConfigInputs): Promis
 
 declare function getProcessSupervisor(): ProcessSupervisor;
 
-export { CHAT_PROXY_BASE_PATH, CLAUDE_PROXY_API_KEY_SENTINEL, CODEX_PROXY_BASE_PATH, CODEX_PROXY_PROVIDER_NAME, type ChatCliBackendId, type ChatCliLaunchConfig, type ChatCliLaunchConfigInputs, type ChildAdapterHandle, type ClaudeCliLaunchConfigInputs, type CodexLaunchConfig, type CodexLaunchConfigInputs, type GeminiCliLaunchConfigInputs, type ManagedRun, type ManagedRunStdin, OPENCODE_PROXY_PROVIDER_ID, OPENCODE_PROXY_TOKEN_ENV, type ProcessSupervisor, type PtyAdapterHandle, type RunExit, type RunRecord, type RunRegistry, type RunState, type SpawnChildInput, type SpawnInput, type SpawnPtyInput, type TerminationReason, buildChatCliLaunchConfig, buildClaudeCliLaunchConfig, buildCodexConfigOverrides, buildCodexLaunchConfig, buildGeminiCliLaunchConfig, getProcessSupervisor };
+export { CHAT_PROXY_BASE_PATH, CLAUDE_PROXY_API_KEY_SENTINEL, CODEX_PROXY_BASE_PATH, CODEX_PROXY_PROVIDER_NAME, type ChatCliBackendId, type ChatCliLaunchConfig, type ChatCliLaunchConfigInputs, type ChildAdapterHandle, type ClaudeCliLaunchConfigInputs, type CodexLaunchConfig, type CodexLaunchConfigInputs, type GeminiCliLaunchConfigInputs, OPENCODE_PROXY_PROVIDER_ID, OPENCODE_PROXY_TOKEN_ENV, ProcessSupervisor, buildChatCliLaunchConfig, buildClaudeCliLaunchConfig, buildCodexConfigOverrides, buildCodexLaunchConfig, buildGeminiCliLaunchConfig, getProcessSupervisor };

package/dist/index.d.ts

@@ -1,110 +1,12 @@
+import { ProcessSupervisor } from './types.js';
+export { ManagedRun, ManagedRunStdin, RunExit, RunRecord, RunRegistry, RunState, SpawnChildInput, SpawnInput, SpawnPtyInput, TerminationReason } from './types.js';
 import { ChildProcess } from 'node:child_process';
+export { PtyAdapterHandle } from './pty-adapter.js';
 import { ProviderConfigSource, UsageRecorderImport } from '@omnicross/core';
 import { ApiKeyPoolService } from '@omnicross/core/completion/ApiKeyPoolService';
 import { SubscriptionAuthProfile } from '@omnicross/core/pipeline/SubscriptionAuthSource';
 import { RouteAuthMode } from '@omnicross/core/provider-proxy';
 
-/**
- * Process Supervisor types.
- *
- * Defines all interfaces for subprocess lifecycle management:
- * spawn inputs, run records, exit results, and module contracts.
- *
- * @module types
- */
-type RunState = 'starting' | 'running' | 'exiting' | 'exited';
-type TerminationReason = 'manual-cancel' | 'overall-timeout' | 'no-output-timeout' | 'spawn-error' | 'signal' | 'exit';
-interface SpawnBaseInput {
-    runId?: string;
-    sessionId: string;
-    backendId: string;
-    scopeKey?: string;
-    replaceExistingScope?: boolean;
-    cwd?: string;
-    env?: Record<string, string>;
-    timeoutMs?: number;
-    noOutputTimeoutMs?: number;
-    captureOutput?: boolean;
-    onStdout?: (chunk: string) => void;
-    onStderr?: (chunk: string) => void;
-}
-interface SpawnChildInput extends SpawnBaseInput {
-    mode: 'child';
-    argv: string[];
-    windowsVerbatimArguments?: boolean;
-    input?: string;
-    stdinMode?: 'inherit' | 'pipe-open' | 'pipe-closed';
-}
-interface SpawnPtyInput extends SpawnBaseInput {
-    mode: 'pty';
-    /** Shell executable (defaults: powershell.exe on Windows, /bin/bash on Unix). */
-    shell?: string;
-    /** Arguments passed to the shell. */
-    args?: string[];
-    /** Terminal columns (default: 120). */
-    cols?: number;
-    /** Terminal rows (default: 30). */
-    rows?: number;
-}
-/** Spawn input union — child-process or PTY mode. */
-type SpawnInput = SpawnChildInput | SpawnPtyInput;
-interface RunRecord {
-    runId: string;
-    sessionId: string;
-    backendId: string;
-    scopeKey?: string;
-    pid?: number;
-    startedAtMs: number;
-    lastOutputAtMs: number;
-    createdAtMs: number;
-    updatedAtMs: number;
-    state: RunState;
-    terminationReason?: TerminationReason;
-    exitCode?: number | null;
-    exitSignal?: string | null;
-}
-interface RunExit {
-    reason: TerminationReason;
-    exitCode: number | null;
-    exitSignal: string | null;
-    durationMs: number;
-    stdout: string;
-    stderr: string;
-    timedOut: boolean;
-    noOutputTimedOut: boolean;
-}
-interface ManagedRunStdin {
-    write(data: string): void;
-    end(): void;
-    destroy(): void;
-}
-interface ManagedRun {
-    runId: string;
-    pid?: number;
-    startedAtMs: number;
-    stdin?: ManagedRunStdin;
-    wait: () => Promise<RunExit>;
-    cancel: (reason?: TerminationReason) => void;
-}
-interface ProcessSupervisor {
-    spawn(input: SpawnInput): ManagedRun;
-    cancel(runId: string, reason?: TerminationReason): void;
-    cancelScope(scopeKey: string, reason?: TerminationReason): void;
-    getRecord(runId: string): RunRecord | undefined;
-    /** Resize the PTY terminal. No-op for non-PTY runs. */
-    resizePty(runId: string, cols: number, rows: number): boolean;
-}
-interface RunRegistry {
-    add(record: RunRecord): void;
-    get(runId: string): RunRecord | undefined;
-    list(): RunRecord[];
-    listByScope(scopeKey: string): RunRecord[];
-    updateState(runId: string, state: RunState, patch?: Partial<RunRecord>): void;
-    touchOutput(runId: string): void;
-    finalize(runId: string, reason: TerminationReason, exitCode?: number | null, exitSignal?: string | null): void;
-    delete(runId: string): void;
-}
-
 /**
  * child_process spawn adapter.
  *
@@ -128,36 +30,6 @@ interface ChildAdapterHandle {
     dispose: () => void;
 }
 
-/**
- * PTY Adapter — wraps node-pty into the same handle shape
- * used by child-adapter, so ProcessSupervisor can manage
- * both child_process and PTY sessions uniformly.
- *
- * node-pty is lazily loaded — the import only happens when
- * a PTY spawn is actually requested.
- *
- * @module pty-adapter
- */
-
-interface PtyAdapterHandle {
-    pid: number | undefined;
-    onStdout(cb: (data: string) => void): void;
-    onStderr(cb: (data: string) => void): void;
-    stdin: {
-        write(data: string): void;
-        end(): void;
-        destroy(): void;
-    };
-    write(data: string): void;
-    resize(cols: number, rows: number): void;
-    wait(): Promise<{
-        code: number | null;
-        signal: string | null;
-    }>;
-    kill(signal?: string): void;
-    dispose(): void;
-}
-
 /**
  * Per-CLI launch-config builders for the GENUINELY-NEW interceptable backends
  * (qwen / copilot / opencode) — the OpenAI-Chat-Completions analogue of
@@ -465,4 +337,4 @@ declare function buildCodexLaunchConfig(inputs: CodexLaunchConfigInputs): Promis
 
 declare function getProcessSupervisor(): ProcessSupervisor;
 
-export { CHAT_PROXY_BASE_PATH, CLAUDE_PROXY_API_KEY_SENTINEL, CODEX_PROXY_BASE_PATH, CODEX_PROXY_PROVIDER_NAME, type ChatCliBackendId, type ChatCliLaunchConfig, type ChatCliLaunchConfigInputs, type ChildAdapterHandle, type ClaudeCliLaunchConfigInputs, type CodexLaunchConfig, type CodexLaunchConfigInputs, type GeminiCliLaunchConfigInputs, type ManagedRun, type ManagedRunStdin, OPENCODE_PROXY_PROVIDER_ID, OPENCODE_PROXY_TOKEN_ENV, type ProcessSupervisor, type PtyAdapterHandle, type RunExit, type RunRecord, type RunRegistry, type RunState, type SpawnChildInput, type SpawnInput, type SpawnPtyInput, type TerminationReason, buildChatCliLaunchConfig, buildClaudeCliLaunchConfig, buildCodexConfigOverrides, buildCodexLaunchConfig, buildGeminiCliLaunchConfig, getProcessSupervisor };
+export { CHAT_PROXY_BASE_PATH, CLAUDE_PROXY_API_KEY_SENTINEL, CODEX_PROXY_BASE_PATH, CODEX_PROXY_PROVIDER_NAME, type ChatCliBackendId, type ChatCliLaunchConfig, type ChatCliLaunchConfigInputs, type ChildAdapterHandle, type ClaudeCliLaunchConfigInputs, type CodexLaunchConfig, type CodexLaunchConfigInputs, type GeminiCliLaunchConfigInputs, OPENCODE_PROXY_PROVIDER_ID, OPENCODE_PROXY_TOKEN_ENV, ProcessSupervisor, buildChatCliLaunchConfig, buildClaudeCliLaunchConfig, buildCodexConfigOverrides, buildCodexLaunchConfig, buildGeminiCliLaunchConfig, getProcessSupervisor };

package/dist/pty-adapter.cjs

@@ -0,0 +1,103 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pty-adapter.ts
+var pty_adapter_exports = {};
+__export(pty_adapter_exports, {
+  buildPtyEnv: () => buildPtyEnv,
+  createPtyAdapter: () => createPtyAdapter
+});
+module.exports = __toCommonJS(pty_adapter_exports);
+function buildPtyEnv(overlay) {
+  return overlay ? { ...process.env, ...overlay } : { ...process.env };
+}
+function createPtyAdapter(input) {
+  const nodePty = require("node-pty");
+  const shell = input.shell ?? (process.platform === "win32" ? "powershell.exe" : "/bin/bash");
+  const pty = nodePty.spawn(shell, input.args ?? [], {
+    name: "xterm-256color",
+    cols: input.cols ?? 120,
+    rows: input.rows ?? 30,
+    cwd: input.cwd,
+    env: buildPtyEnv(input.env)
+  });
+  const stdoutListeners = [];
+  const stderrListeners = [];
+  const dataDisposable = pty.onData((data) => {
+    for (const cb of stdoutListeners) cb(data);
+  });
+  let exitResolve = null;
+  const exitPromise = new Promise((resolve) => {
+    exitResolve = resolve;
+  });
+  const exitDisposable = pty.onExit(({ exitCode, signal }) => {
+    exitResolve?.({ code: exitCode, signal: signal != null ? String(signal) : null });
+  });
+  let disposed = false;
+  return {
+    pid: pty.pid,
+    onStdout(cb) {
+      stdoutListeners.push(cb);
+    },
+    onStderr(cb) {
+      stderrListeners.push(cb);
+    },
+    stdin: {
+      write(data) {
+        if (!disposed) pty.write(data);
+      },
+      end() {
+        if (!disposed) pty.write("");
+      },
+      destroy() {
+      }
+    },
+    write(data) {
+      if (!disposed) pty.write(data);
+    },
+    resize(cols, rows) {
+      if (!disposed) pty.resize(cols, rows);
+    },
+    wait() {
+      return exitPromise;
+    },
+    kill(signal) {
+      if (disposed) return;
+      try {
+        pty.kill(signal);
+      } catch {
+      }
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      dataDisposable.dispose();
+      exitDisposable.dispose();
+      try {
+        pty.kill();
+      } catch {
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildPtyEnv,
+  createPtyAdapter
+});

package/dist/pty-adapter.d.cts

@@ -0,0 +1,50 @@
+import { SpawnPtyInput } from './types.cjs';
+
+/**
+ * PTY Adapter — wraps node-pty into the same handle shape
+ * used by child-adapter, so ProcessSupervisor can manage
+ * both child_process and PTY sessions uniformly.
+ *
+ * node-pty is lazily loaded — the import only happens when
+ * a PTY spawn is actually requested.
+ *
+ * @module pty-adapter
+ */
+
+interface PtyAdapterHandle {
+    pid: number | undefined;
+    onStdout(cb: (data: string) => void): void;
+    onStderr(cb: (data: string) => void): void;
+    stdin: {
+        write(data: string): void;
+        end(): void;
+        destroy(): void;
+    };
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    wait(): Promise<{
+        code: number | null;
+        signal: string | null;
+    }>;
+    kill(signal?: string): void;
+    dispose(): void;
+}
+/**
+ * Build the env object passed to node-pty.spawn.
+ *
+ * Inherits `process.env` as base so the PTY shell sees PATH/HOME/APPDATA
+ * and any directories the host has injected at runtime — notably the bin
+ * dirs of portable-installed Node/uv/git. Without this, PTY-mode CLI backends
+ * (Claude Code, Codex, Gemini-CLI) silently fail to find host-managed tools
+ * because the underlying shell only sees the system-level PATH from the
+ * Windows registry / Unix dotfiles, not the augmented `process.env.PATH`.
+ *
+ * Mirrors the merge already performed in `child-adapter.ts:37`.
+ *
+ * Exported for direct unit testing — the adapter itself depends on the
+ * native `node-pty` module which is awkward to mock from a unit test.
+ */
+declare function buildPtyEnv(overlay: Record<string, string> | undefined): Record<string, string>;
+declare function createPtyAdapter(input: SpawnPtyInput): PtyAdapterHandle;
+
+export { type PtyAdapterHandle, buildPtyEnv, createPtyAdapter };

package/dist/pty-adapter.d.ts

@@ -0,0 +1,50 @@
+import { SpawnPtyInput } from './types.js';
+
+/**
+ * PTY Adapter — wraps node-pty into the same handle shape
+ * used by child-adapter, so ProcessSupervisor can manage
+ * both child_process and PTY sessions uniformly.
+ *
+ * node-pty is lazily loaded — the import only happens when
+ * a PTY spawn is actually requested.
+ *
+ * @module pty-adapter
+ */
+
+interface PtyAdapterHandle {
+    pid: number | undefined;
+    onStdout(cb: (data: string) => void): void;
+    onStderr(cb: (data: string) => void): void;
+    stdin: {
+        write(data: string): void;
+        end(): void;
+        destroy(): void;
+    };
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    wait(): Promise<{
+        code: number | null;
+        signal: string | null;
+    }>;
+    kill(signal?: string): void;
+    dispose(): void;
+}
+/**
+ * Build the env object passed to node-pty.spawn.
+ *
+ * Inherits `process.env` as base so the PTY shell sees PATH/HOME/APPDATA
+ * and any directories the host has injected at runtime — notably the bin
+ * dirs of portable-installed Node/uv/git. Without this, PTY-mode CLI backends
+ * (Claude Code, Codex, Gemini-CLI) silently fail to find host-managed tools
+ * because the underlying shell only sees the system-level PATH from the
+ * Windows registry / Unix dotfiles, not the augmented `process.env.PATH`.
+ *
+ * Mirrors the merge already performed in `child-adapter.ts:37`.
+ *
+ * Exported for direct unit testing — the adapter itself depends on the
+ * native `node-pty` module which is awkward to mock from a unit test.
+ */
+declare function buildPtyEnv(overlay: Record<string, string> | undefined): Record<string, string>;
+declare function createPtyAdapter(input: SpawnPtyInput): PtyAdapterHandle;
+
+export { type PtyAdapterHandle, buildPtyEnv, createPtyAdapter };

package/dist/pty-adapter.js

@@ -0,0 +1,84 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/pty-adapter.ts
+function buildPtyEnv(overlay) {
+  return overlay ? { ...process.env, ...overlay } : { ...process.env };
+}
+function createPtyAdapter(input) {
+  const nodePty = __require("node-pty");
+  const shell = input.shell ?? (process.platform === "win32" ? "powershell.exe" : "/bin/bash");
+  const pty = nodePty.spawn(shell, input.args ?? [], {
+    name: "xterm-256color",
+    cols: input.cols ?? 120,
+    rows: input.rows ?? 30,
+    cwd: input.cwd,
+    env: buildPtyEnv(input.env)
+  });
+  const stdoutListeners = [];
+  const stderrListeners = [];
+  const dataDisposable = pty.onData((data) => {
+    for (const cb of stdoutListeners) cb(data);
+  });
+  let exitResolve = null;
+  const exitPromise = new Promise((resolve) => {
+    exitResolve = resolve;
+  });
+  const exitDisposable = pty.onExit(({ exitCode, signal }) => {
+    exitResolve?.({ code: exitCode, signal: signal != null ? String(signal) : null });
+  });
+  let disposed = false;
+  return {
+    pid: pty.pid,
+    onStdout(cb) {
+      stdoutListeners.push(cb);
+    },
+    onStderr(cb) {
+      stderrListeners.push(cb);
+    },
+    stdin: {
+      write(data) {
+        if (!disposed) pty.write(data);
+      },
+      end() {
+        if (!disposed) pty.write("");
+      },
+      destroy() {
+      }
+    },
+    write(data) {
+      if (!disposed) pty.write(data);
+    },
+    resize(cols, rows) {
+      if (!disposed) pty.resize(cols, rows);
+    },
+    wait() {
+      return exitPromise;
+    },
+    kill(signal) {
+      if (disposed) return;
+      try {
+        pty.kill(signal);
+      } catch {
+      }
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      dataDisposable.dispose();
+      exitDisposable.dispose();
+      try {
+        pty.kill();
+      } catch {
+      }
+    }
+  };
+}
+export {
+  buildPtyEnv,
+  createPtyAdapter
+};

package/dist/types.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/types.d.cts

@@ -0,0 +1,102 @@
+/**
+ * Process Supervisor types.
+ *
+ * Defines all interfaces for subprocess lifecycle management:
+ * spawn inputs, run records, exit results, and module contracts.
+ *
+ * @module types
+ */
+type RunState = 'starting' | 'running' | 'exiting' | 'exited';
+type TerminationReason = 'manual-cancel' | 'overall-timeout' | 'no-output-timeout' | 'spawn-error' | 'signal' | 'exit';
+interface SpawnBaseInput {
+    runId?: string;
+    sessionId: string;
+    backendId: string;
+    scopeKey?: string;
+    replaceExistingScope?: boolean;
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    noOutputTimeoutMs?: number;
+    captureOutput?: boolean;
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+}
+interface SpawnChildInput extends SpawnBaseInput {
+    mode: 'child';
+    argv: string[];
+    windowsVerbatimArguments?: boolean;
+    input?: string;
+    stdinMode?: 'inherit' | 'pipe-open' | 'pipe-closed';
+}
+interface SpawnPtyInput extends SpawnBaseInput {
+    mode: 'pty';
+    /** Shell executable (defaults: powershell.exe on Windows, /bin/bash on Unix). */
+    shell?: string;
+    /** Arguments passed to the shell. */
+    args?: string[];
+    /** Terminal columns (default: 120). */
+    cols?: number;
+    /** Terminal rows (default: 30). */
+    rows?: number;
+}
+/** Spawn input union — child-process or PTY mode. */
+type SpawnInput = SpawnChildInput | SpawnPtyInput;
+interface RunRecord {
+    runId: string;
+    sessionId: string;
+    backendId: string;
+    scopeKey?: string;
+    pid?: number;
+    startedAtMs: number;
+    lastOutputAtMs: number;
+    createdAtMs: number;
+    updatedAtMs: number;
+    state: RunState;
+    terminationReason?: TerminationReason;
+    exitCode?: number | null;
+    exitSignal?: string | null;
+}
+interface RunExit {
+    reason: TerminationReason;
+    exitCode: number | null;
+    exitSignal: string | null;
+    durationMs: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    noOutputTimedOut: boolean;
+}
+interface ManagedRunStdin {
+    write(data: string): void;
+    end(): void;
+    destroy(): void;
+}
+interface ManagedRun {
+    runId: string;
+    pid?: number;
+    startedAtMs: number;
+    stdin?: ManagedRunStdin;
+    wait: () => Promise<RunExit>;
+    cancel: (reason?: TerminationReason) => void;
+}
+interface ProcessSupervisor {
+    spawn(input: SpawnInput): ManagedRun;
+    cancel(runId: string, reason?: TerminationReason): void;
+    cancelScope(scopeKey: string, reason?: TerminationReason): void;
+    getRecord(runId: string): RunRecord | undefined;
+    /** Resize the PTY terminal. No-op for non-PTY runs. */
+    resizePty(runId: string, cols: number, rows: number): boolean;
+}
+interface RunRegistry {
+    add(record: RunRecord): void;
+    get(runId: string): RunRecord | undefined;
+    list(): RunRecord[];
+    listByScope(scopeKey: string): RunRecord[];
+    updateState(runId: string, state: RunState, patch?: Partial<RunRecord>): void;
+    touchOutput(runId: string): void;
+    finalize(runId: string, reason: TerminationReason, exitCode?: number | null, exitSignal?: string | null): void;
+    delete(runId: string): void;
+}
+
+export type { ManagedRun, ManagedRunStdin, ProcessSupervisor, RunExit, RunRecord, RunRegistry, RunState, SpawnBaseInput, SpawnChildInput, SpawnInput, SpawnPtyInput, TerminationReason };

package/dist/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Process Supervisor types.
+ *
+ * Defines all interfaces for subprocess lifecycle management:
+ * spawn inputs, run records, exit results, and module contracts.
+ *
+ * @module types
+ */
+type RunState = 'starting' | 'running' | 'exiting' | 'exited';
+type TerminationReason = 'manual-cancel' | 'overall-timeout' | 'no-output-timeout' | 'spawn-error' | 'signal' | 'exit';
+interface SpawnBaseInput {
+    runId?: string;
+    sessionId: string;
+    backendId: string;
+    scopeKey?: string;
+    replaceExistingScope?: boolean;
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    noOutputTimeoutMs?: number;
+    captureOutput?: boolean;
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+}
+interface SpawnChildInput extends SpawnBaseInput {
+    mode: 'child';
+    argv: string[];
+    windowsVerbatimArguments?: boolean;
+    input?: string;
+    stdinMode?: 'inherit' | 'pipe-open' | 'pipe-closed';
+}
+interface SpawnPtyInput extends SpawnBaseInput {
+    mode: 'pty';
+    /** Shell executable (defaults: powershell.exe on Windows, /bin/bash on Unix). */
+    shell?: string;
+    /** Arguments passed to the shell. */
+    args?: string[];
+    /** Terminal columns (default: 120). */
+    cols?: number;
+    /** Terminal rows (default: 30). */
+    rows?: number;
+}
+/** Spawn input union — child-process or PTY mode. */
+type SpawnInput = SpawnChildInput | SpawnPtyInput;
+interface RunRecord {
+    runId: string;
+    sessionId: string;
+    backendId: string;
+    scopeKey?: string;
+    pid?: number;
+    startedAtMs: number;
+    lastOutputAtMs: number;
+    createdAtMs: number;
+    updatedAtMs: number;
+    state: RunState;
+    terminationReason?: TerminationReason;
+    exitCode?: number | null;
+    exitSignal?: string | null;
+}
+interface RunExit {
+    reason: TerminationReason;
+    exitCode: number | null;
+    exitSignal: string | null;
+    durationMs: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    noOutputTimedOut: boolean;
+}
+interface ManagedRunStdin {
+    write(data: string): void;
+    end(): void;
+    destroy(): void;
+}
+interface ManagedRun {
+    runId: string;
+    pid?: number;
+    startedAtMs: number;
+    stdin?: ManagedRunStdin;
+    wait: () => Promise<RunExit>;
+    cancel: (reason?: TerminationReason) => void;
+}
+interface ProcessSupervisor {
+    spawn(input: SpawnInput): ManagedRun;
+    cancel(runId: string, reason?: TerminationReason): void;
+    cancelScope(scopeKey: string, reason?: TerminationReason): void;
+    getRecord(runId: string): RunRecord | undefined;
+    /** Resize the PTY terminal. No-op for non-PTY runs. */
+    resizePty(runId: string, cols: number, rows: number): boolean;
+}
+interface RunRegistry {
+    add(record: RunRecord): void;
+    get(runId: string): RunRecord | undefined;
+    list(): RunRecord[];
+    listByScope(scopeKey: string): RunRecord[];
+    updateState(runId: string, state: RunState, patch?: Partial<RunRecord>): void;
+    touchOutput(runId: string): void;
+    finalize(runId: string, reason: TerminationReason, exitCode?: number | null, exitSignal?: string | null): void;
+    delete(runId: string): void;
+}
+
+export type { ManagedRun, ManagedRunStdin, ProcessSupervisor, RunExit, RunRecord, RunRegistry, RunState, SpawnBaseInput, SpawnChildInput, SpawnInput, SpawnPtyInput, TerminationReason };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnicross/cli-launcher",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Omnicross CLI-launcher — the ProcessSupervisor subprocess-lifecycle mechanism + per-CLI proxy-env wiring.",
   "license": "MIT",
   "author": "Sayo (https://github.com/Dumoedss)",