@omnicross/cli-launcher 0.1.0 → 0.1.2

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.2",
   "description": "Omnicross CLI-launcher — the ProcessSupervisor subprocess-lifecycle mechanism + per-CLI proxy-env wiring.",
   "license": "MIT",
   "author": "Sayo (https://github.com/Dumoedss)",
@@ -50,7 +50,9 @@
     "typecheck": "tsc -p tsconfig.typecheck.json --noEmit"
   },
   "dependencies": {
-    "@omnicross/core": "^0.1.0",
+    "@omnicross/core": "^0.1.0"
+  },
+  "optionalDependencies": {
     "node-pty": "npm:@karinjs/node-pty@^1.1.3"
   }
 }