@botiverse/oar 0.0.4 → 0.0.6

package/dist/shared/acp/session.js

@@ -0,0 +1,254 @@
+import { asRecord } from "../json.js";
+import { sealSession } from "../seal-session.js";
+import { createSessionKernel } from "../session-kernel.js";
+import { AcpError, acpProcessExitedError } from "./errors.js";
+import { closeAcpSession, hasAcpCapability, openAcpSession, promptAcp, } from "./profile.js";
+import { methods, startAcpProcess } from "./process.js";
+import { acpFailureOutcome, acpRuntimeExitedOutcome, createAcpProjectionState, defaultAcpPromptOutcome, finishAcpTools, projectAcpUpdate, } from "./projection.js";
+import { createAcpClientApp, createAcpTerminalHost } from "./terminal.js";
+function ignoreUpdate(_notification) { }
+export function acpSession(profile) {
+    return async (installation, options) => {
+        if (installation.via !== "executable") {
+            throw new Error("ACP runtimes require an executable installation");
+        }
+        profile.validateOptions?.(options);
+        const args = typeof profile.args === "function" ? profile.args(options) : profile.args;
+        const environment = { ...process.env, ...options.env };
+        const terminalHost = createAcpTerminalHost(options.cwd, environment, {
+            shellCommand: profile.terminalShellCommand === true,
+        });
+        let receiveUpdate = ignoreUpdate;
+        const runtime = startAcpProcess(installation.command, args, createAcpClientApp(terminalHost, (notification) => {
+            receiveUpdate(notification);
+        }), {
+            cwd: options.cwd,
+            env: environment,
+        });
+        const opened = await openAcpSession(runtime, profile, options).catch(async (error) => {
+            runtime.kill();
+            await runtime.exited;
+            await terminalHost.dispose();
+            throw error;
+        });
+        const capabilities = asRecord(opened.initialized.agentCapabilities);
+        const sessionCapabilities = asRecord(capabilities?.sessionCapabilities);
+        const supportsClose = hasAcpCapability(sessionCapabilities?.close);
+        const kernel = createSessionKernel(opened.sessionId);
+        const held = [];
+        let active = null;
+        let contextUsage = null;
+        let nextRequest = 0;
+        let disposed = false;
+        let dead = false;
+        const settle = (state, outcome) => {
+            if (state.kernelTurn.settled()) {
+                return;
+            }
+            for (const body of finishAcpTools(state.projection)) {
+                state.kernelTurn.emit(body);
+            }
+            state.kernelTurn.settle(outcome);
+            if (active === state) {
+                active = null;
+            }
+            queueMicrotask(drainHeld);
+        };
+        const failHeld = () => {
+            while (held.length > 0) {
+                held.shift();
+                kernel.begin()?.settle({
+                    kind: "failed",
+                    reason: "ACP process exited before queued input could run",
+                    failure: "runtime_exited",
+                });
+            }
+        };
+        receiveUpdate = (notification) => {
+            if (notification.sessionId !== opened.sessionId) {
+                return;
+            }
+            const update = asRecord(notification.update);
+            if (update === null) {
+                return;
+            }
+            const state = active;
+            const projected = projectAcpUpdate(state?.projection ?? createAcpProjectionState(), update);
+            contextUsage = projected.contextUsage ?? contextUsage;
+            if (state !== null && !state.kernelTurn.settled()) {
+                for (const body of projected.bodies) {
+                    state.kernelTurn.emit(body);
+                }
+            }
+        };
+        const finishRequest = (state, requestNumber, outcome) => {
+            if (state.kernelTurn.settled()) {
+                return;
+            }
+            state.pending.delete(requestNumber);
+            state.outcomes.set(requestNumber, outcome);
+            if (state.pending.size === 0) {
+                settle(state, state.outcomes.get(state.latestRequest) ?? outcome);
+            }
+        };
+        const startVendorPrompt = (state, input, extraParams = {}) => {
+            nextRequest += 1;
+            const requestNumber = nextRequest;
+            state.latestRequest = requestNumber;
+            state.pending.add(requestNumber);
+            void (async () => {
+                try {
+                    const result = await promptAcp(runtime, opened.sessionId, input, extraParams);
+                    contextUsage = profile.promptContextUsage?.(result) ?? contextUsage;
+                    finishRequest(state, requestNumber, profile.promptOutcome?.(result) ?? defaultAcpPromptOutcome(result));
+                }
+                catch (error) {
+                    const outcome = state.abortRequested
+                        && !(error instanceof AcpError && error.kind === "process_exited")
+                        ? { kind: "aborted" }
+                        : acpFailureOutcome(error);
+                    finishRequest(state, requestNumber, outcome);
+                }
+            })();
+        };
+        const makeTurn = (state) => {
+            const steerParams = profile.steerParams;
+            return {
+                id: state.kernelTurn.id,
+                outcome: state.kernelTurn.outcome,
+                abort: async () => {
+                    if (state.kernelTurn.settled()) {
+                        return;
+                    }
+                    if (!state.abortRequested) {
+                        state.abortRequested = true;
+                        try {
+                            await runtime.connection.agent.notify(methods.agent.session.cancel, { sessionId: opened.sessionId });
+                        }
+                        catch (error) {
+                            settle(state, acpFailureOutcome(error));
+                        }
+                    }
+                    const timeoutMs = profile.abortTimeoutMs ?? 10_000;
+                    const fallback = setTimeout(() => {
+                        if (!state.kernelTurn.settled()) {
+                            dead = true;
+                            settle(state, { kind: "aborted" });
+                            runtime.kill();
+                        }
+                    }, timeoutMs);
+                    fallback.unref();
+                    await state.kernelTurn.outcome;
+                    clearTimeout(fallback);
+                },
+                ...(steerParams === undefined ? {} : {
+                    steer: async (input) => {
+                        await runtime.spawned;
+                        if (state.kernelTurn.settled() || active !== state) {
+                            return {
+                                kind: "not_steerable",
+                                reason: "turn already ended",
+                            };
+                        }
+                        if (runtime.closed) {
+                            throw acpProcessExitedError(runtime.exitCode);
+                        }
+                        startVendorPrompt(state, input, steerParams(input));
+                        return { kind: "accepted" };
+                    },
+                }),
+            };
+        };
+        const beginInput = (input) => {
+            const kernelTurn = kernel.begin();
+            if (kernelTurn === null) {
+                return null;
+            }
+            const state = {
+                kernelTurn,
+                outcomes: new Map(),
+                pending: new Set(),
+                projection: createAcpProjectionState(),
+                abortRequested: false,
+                latestRequest: 0,
+            };
+            active = state;
+            if (dead || runtime.closed) {
+                settle(state, acpRuntimeExitedOutcome(null));
+            }
+            else {
+                startVendorPrompt(state, input);
+            }
+            return makeTurn(state);
+        };
+        function drainHeld() {
+            if (disposed || active !== null) {
+                return;
+            }
+            if (dead || runtime.closed) {
+                failHeld();
+                return;
+            }
+            const input = held.shift();
+            if (input !== undefined) {
+                beginInput(input);
+            }
+        }
+        const onRuntimeExit = (code) => {
+            void terminalHost.dispose();
+            if (disposed) {
+                return;
+            }
+            dead = true;
+            if (active !== null) {
+                settle(active, acpRuntimeExitedOutcome(code));
+            }
+            failHeld();
+        };
+        // oxlint-disable-next-line promise/prefer-await-to-then, promise/always-return -- Exit observation outlives session creation.
+        void runtime.exited.then(onRuntimeExit);
+        return sealSession({
+            id: kernel.sessionId,
+            prompt(input) {
+                const next = beginInput(input);
+                return next === null ? { kind: "busy" } : { kind: "turn", turn: next };
+            },
+            subscribe: (observer) => kernel.subscribe(observer),
+            contextUsage: () => contextUsage,
+            queue: {
+                durable: false,
+                add: async (input) => {
+                    await runtime.spawned;
+                    if (disposed || dead || runtime.closed) {
+                        throw acpProcessExitedError(runtime.exitCode);
+                    }
+                    held.push(input);
+                    queueMicrotask(drainHeld);
+                },
+            },
+            dispose: async () => {
+                if (disposed) {
+                    return;
+                }
+                disposed = true;
+                held.splice(0);
+                if (active !== null && !active.kernelTurn.settled()) {
+                    try {
+                        await runtime.connection.agent.notify(methods.agent.session.cancel, { sessionId: opened.sessionId });
+                    }
+                    catch {
+                        // Local settlement below is authoritative during disposal.
+                    }
+                    settle(active, { kind: "aborted" });
+                }
+                if (supportsClose && !runtime.closed) {
+                    await closeAcpSession(runtime, opened.sessionId).catch(() => { });
+                }
+                runtime.kill();
+                await runtime.exited;
+                await terminalHost.dispose();
+            },
+        });
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/shared/acp/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/shared/acp/session.ts"],"names":[],"mappings":"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"}

package/dist/shared/acp/terminal.d.ts

@@ -0,0 +1,17 @@
+import { type ClientApp, type CreateTerminalRequest, type CreateTerminalResponse, type KillTerminalRequest, type KillTerminalResponse, type ReleaseTerminalRequest, type ReleaseTerminalResponse, type SessionNotification, type TerminalOutputRequest, type TerminalOutputResponse, type WaitForTerminalExitRequest, type WaitForTerminalExitResponse } from "@agentclientprotocol/sdk";
+export interface AcpTerminalHost {
+    create(params: CreateTerminalRequest): Promise<CreateTerminalResponse>;
+    output(params: TerminalOutputRequest): TerminalOutputResponse;
+    waitForExit(params: WaitForTerminalExitRequest): Promise<WaitForTerminalExitResponse>;
+    kill(params: KillTerminalRequest): KillTerminalResponse;
+    release(params: ReleaseTerminalRequest): Promise<ReleaseTerminalResponse>;
+    dispose(): Promise<void>;
+}
+export interface AcpTerminalHostOptions {
+    readonly shellCommand?: boolean;
+}
+/** Compose OAR's typed ACP client handlers directly on the official SDK app. */
+export declare function createAcpClientApp(terminal: AcpTerminalHost, update: (notification: SessionNotification) => void): ClientApp;
+/** Host implementation of ACP v1's typed terminal reverse-RPC surface. */
+export declare function createAcpTerminalHost(cwd: string, environment: NodeJS.ProcessEnv, options?: AcpTerminalHostOptions): AcpTerminalHost;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/shared/acp/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/shared/acp/terminal.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAG5B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EACjC,MAAM,0BAA0B,CAAC;AA2BlC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvE,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,CAAC;IAC9D,WAAW,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACtF,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;IACxD,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAUD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,GAClD,SAAS,CAWX;AA+DD,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,CAAC,UAAU,EAC9B,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAwHjB"}

package/dist/shared/acp/terminal.js

@@ -0,0 +1,193 @@
+/* oxlint-disable typescript/promise-function-async -- SDK handlers deliberately return terminal promises directly. */
+import { client as createClient, methods, RequestError, } from "@agentclientprotocol/sdk";
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { StringDecoder } from "node:string_decoder";
+import spawn from "cross-spawn";
+const DEFAULT_OUTPUT_LIMIT = 4 * 1024 * 1024;
+const MAX_OUTPUT_LIMIT = 16 * 1024 * 1024;
+function allowPermission(request) {
+    const selected = request.options.find((option) => option.kind === "allow_always")
+        ?? request.options.find((option) => option.kind === "allow_once");
+    return selected === undefined
+        ? { outcome: { outcome: "cancelled" } }
+        : { outcome: { outcome: "selected", optionId: selected.optionId } };
+}
+/** Compose OAR's typed ACP client handlers directly on the official SDK app. */
+export function createAcpClientApp(terminal, update) {
+    return createClient({ name: "oar" })
+        .onRequest(methods.client.session.requestPermission, ({ params }) => allowPermission(params))
+        .onRequest(methods.client.terminal.create, ({ params }) => terminal.create(params))
+        .onRequest(methods.client.terminal.output, ({ params }) => terminal.output(params))
+        .onRequest(methods.client.terminal.waitForExit, ({ params }) => terminal.waitForExit(params))
+        .onRequest(methods.client.terminal.kill, ({ params }) => terminal.kill(params))
+        .onRequest(methods.client.terminal.release, ({ params }) => terminal.release(params))
+        .onNotification(methods.client.session.update, ({ params }) => {
+        update(params);
+    });
+}
+function invalid(message) {
+    throw RequestError.invalidParams(undefined, message);
+}
+function outputLimit(value) {
+    if (value === undefined || value === null) {
+        return DEFAULT_OUTPUT_LIMIT;
+    }
+    if (!Number.isFinite(value) || value < 0) {
+        invalid("ACP terminal outputByteLimit must be finite and nonnegative");
+    }
+    return Math.min(Math.floor(value), MAX_OUTPUT_LIMIT);
+}
+function tailAtCharacterBoundary(value, limit) {
+    const encoded = Buffer.from(value);
+    if (encoded.byteLength <= limit) {
+        return value;
+    }
+    let start = encoded.byteLength - limit;
+    while (start < encoded.byteLength) {
+        const byte = encoded[start];
+        if (byte === undefined || (byte & 0xC0) !== 0x80) {
+            break;
+        }
+        start += 1;
+    }
+    return encoded.subarray(start).toString("utf8");
+}
+function appendOutput(state, text) {
+    if (text.length === 0) {
+        return;
+    }
+    const combined = `${state.output}${text}`;
+    if (Buffer.byteLength(combined) > state.outputLimit) {
+        state.truncated = true;
+        state.output = tailAtCharacterBoundary(combined, state.outputLimit);
+    }
+    else {
+        state.output = combined;
+    }
+}
+function terminalFor(terminals, params) {
+    const terminal = terminals.get(params.terminalId);
+    if (terminal === undefined || terminal.sessionId !== params.sessionId) {
+        invalid(`Unknown ACP terminal: ${params.terminalId}`);
+    }
+    return terminal;
+}
+async function stopTerminal(state) {
+    if (state.exitStatus === null) {
+        state.child.kill("SIGKILL");
+    }
+    await state.exited;
+}
+/** Host implementation of ACP v1's typed terminal reverse-RPC surface. */
+export function createAcpTerminalHost(cwd, environment, options = {}) {
+    const terminals = new Map();
+    const create = async (params) => {
+        if (params.command.length === 0) {
+            invalid("ACP terminal request requires command");
+        }
+        if (params.cwd !== undefined && params.cwd !== null && !path.isAbsolute(params.cwd)) {
+            invalid("ACP terminal cwd must be an absolute path");
+        }
+        const terminalId = randomUUID();
+        const child = spawn(params.command, params.args ?? [], {
+            cwd: params.cwd ?? cwd,
+            env: {
+                ...environment,
+                ...Object.fromEntries((params.env ?? []).map(({ name, value }) => [name, value])),
+            },
+            shell: options.shellCommand === true && params.args === undefined,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const { stdout, stderr } = child;
+        if (stdout === null || stderr === null) {
+            child.kill("SIGKILL");
+            throw RequestError.internalError(undefined, "ACP terminal process has no output streams");
+        }
+        const { promise: spawned, resolve: resolveSpawned, reject: rejectSpawned } = Promise.withResolvers();
+        const { promise: exited, resolve: resolveExited } = Promise.withResolvers();
+        const state = {
+            child,
+            exited,
+            sessionId: params.sessionId,
+            stderrDecoder: new StringDecoder("utf8"),
+            stdoutDecoder: new StringDecoder("utf8"),
+            terminalId,
+            outputLimit: outputLimit(params.outputByteLimit),
+            exitStatus: null,
+            output: "",
+            truncated: false,
+        };
+        terminals.set(terminalId, state);
+        stdout.on("data", (chunk) => {
+            appendOutput(state, state.stdoutDecoder.write(Buffer.from(chunk)));
+        });
+        stderr.on("data", (chunk) => {
+            appendOutput(state, state.stderrDecoder.write(Buffer.from(chunk)));
+        });
+        const finish = (status) => {
+            if (state.exitStatus !== null) {
+                return;
+            }
+            appendOutput(state, state.stdoutDecoder.end());
+            appendOutput(state, state.stderrDecoder.end());
+            state.exitStatus = status;
+            resolveExited(status);
+        };
+        child.once("spawn", resolveSpawned);
+        child.once("close", (exitCode, signal) => {
+            finish({ exitCode, signal });
+        });
+        child.once("error", (error) => {
+            rejectSpawned(error);
+            finish({ exitCode: null, signal: null });
+        });
+        try {
+            await spawned;
+        }
+        catch (error) {
+            terminals.delete(terminalId);
+            throw RequestError.internalError(undefined, error instanceof Error ? error.message : "Failed to create ACP terminal");
+        }
+        return { terminalId };
+    };
+    const output = (params) => {
+        const state = terminalFor(terminals, params);
+        return {
+            output: state.output,
+            truncated: state.truncated,
+            ...(state.exitStatus === null ? {} : { exitStatus: state.exitStatus }),
+        };
+    };
+    const waitForExit = async (params) => ({
+        ...await terminalFor(terminals, params).exited,
+    });
+    const kill = (params) => {
+        const state = terminalFor(terminals, params);
+        if (state.exitStatus === null) {
+            state.child.kill("SIGTERM");
+        }
+        return {};
+    };
+    const release = async (params) => {
+        const state = terminalFor(terminals, params);
+        terminals.delete(state.terminalId);
+        await stopTerminal(state);
+        return {};
+    };
+    return {
+        create,
+        output,
+        waitForExit,
+        kill,
+        release,
+        async dispose() {
+            const active = [...terminals.values()];
+            terminals.clear();
+            await Promise.all(active.map(async (state) => {
+                await stopTerminal(state);
+            }));
+        },
+    };
+}
+//# sourceMappingURL=terminal.js.map

package/dist/shared/acp/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../../src/shared/acp/terminal.ts"],"names":[],"mappings":"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"}

package/dist/shared/executable/index.d.ts

@@ -1,4 +1,3 @@
-export type { ExecFileSyncLike, ExecutableResolveOptions } from "./resolve.js";
 export { resolveExecutable } from "./resolve.js";
 export type { ExecutableResult, ExecutableRunner, ExecutableRunOptions } from "./run.js";
 export { runExecutable } from "./run.js";

package/dist/shared/executable/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared/executable/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/executable/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/executable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared/executable/process.d.ts

@@ -1,27 +1,28 @@
-/**
- * A long-lived child process spoken to line-by-line — the transport shape both
- * session adapters use (JSONL protocols over stdio). Owns the details raw
- * spawn callers keep re-implementing: stdio wiring, line buffering with a
- * trailing partial buffer, exit fan-out, teardown, and the Windows quirk that
- * npm-installed CLIs are .cmd shims which modern Node refuses to spawn without
- * a shell (EINVAL). Windows handling follows Node's documented `shell` option
- * and is honest about being untested here (no Windows machine in the loop).
- */
+import type { Readable, Writable } from "node:stream";
+interface ProcessOptions {
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+/** A long-lived child whose raw streams can also be observed line-by-line. */
 export interface LineProcess {
     /** Resolves once the OS process exists; rejects when it cannot be spawned. */
     readonly spawned: Promise<void>;
-    /** Resolves when the process is truly gone — the release point for any state it held (locks, sockets). */
+    /** Resolves when the process is truly gone and its state has been released. */
     readonly exited: Promise<number | null>;
+    readonly stdin: Writable;
+    readonly stdout: Readable;
     write(text: string): void;
     onLine(handler: (line: string) => void): void;
     /** Fires exactly once, for exit or spawn-level error alike. */
     onExit(handler: (code: number | null) => void): void;
     kill(): void;
 }
-/** Windows npm shims are .cmd/.bat files, which modern Node refuses to spawn without a shell (EINVAL). Line processes go through cross-spawn instead (correct cmd arg quoting); this predicate remains for one-shot execFile calls, whose args must stay SINGLE-WORD on Windows because shell:true does not quote. */
+/** Windows npm shims need a shell for one-shot execFile calls. */
 export declare function requiresShell(command: string, platform: NodeJS.Platform): boolean;
-export declare function spawnLineProcess(command: string, args: readonly string[], options?: {
-    readonly cwd?: string;
-    readonly env?: NodeJS.ProcessEnv;
-}): LineProcess;
+/**
+ * Spawn through cross-spawn so Windows .cmd shims preserve multi-word args.
+ * Line parsing is attached lazily; protocol SDKs can consume the raw streams.
+ */
+export declare function spawnLineProcess(command: string, args: readonly string[], options?: ProcessOptions): LineProcess;
+export {};
 //# sourceMappingURL=process.d.ts.map

package/dist/shared/executable/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/process.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9C,+DAA+D;IAC/D,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,IAAI,IAAI,IAAI,CAAC;CACd;AAED,sTAAsT;AACtT,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,CAEjF;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxE,WAAW,CAwEb"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/process.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,UAAU,cAAc;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9C,+DAA+D;IAC/D,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,IAAI,IAAI,IAAI,CAAC;CACd;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,CAEjF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,cAAmB,GAC3B,WAAW,CAiFb"}