@relaymessenger/cli 0.3.0

package/dist/engine/acp.js

@@ -0,0 +1,402 @@
+import { createRequire } from "node:module";
+import { Readable, Writable } from "node:stream";
+import crossSpawn from "cross-spawn";
+import { client, ndJsonStream, PROTOCOL_VERSION, } from "@agentclientprotocol/sdk";
+import { terminateProcessTree } from "./process.js";
+import { EXTERNAL_ENGINE_SPECS, engineDisplayName, } from "./catalog.js";
+export const ADAPTER_PACKAGES = {
+    claude: "@agentclientprotocol/claude-agent-acp",
+    codex: "@agentclientprotocol/codex-acp",
+};
+/** Versions must exactly match package.json; tests enforce the lock. */
+export const ADAPTER_VERSIONS = {
+    claude: "0.59.0",
+    codex: "1.1.4",
+};
+const require = createRequire(import.meta.url);
+/** Resolve the installed, lockfile-pinned executable without invoking npm. */
+export function adapterEntrypoint(engine) {
+    if (engine === "claude") {
+        return require.resolve("@agentclientprotocol/claude-agent-acp/dist/index.js");
+    }
+    return require.resolve("@agentclientprotocol/codex-acp");
+}
+/** Shell-free, deterministic process descriptor for one ACP runtime. */
+export function engineProcessSpec(engine) {
+    if (engine === "claude" || engine === "codex") {
+        return {
+            command: process.execPath,
+            args: [adapterEntrypoint(engine)],
+            display: `${ADAPTER_PACKAGES[engine]}@${ADAPTER_VERSIONS[engine]}`,
+        };
+    }
+    const spec = EXTERNAL_ENGINE_SPECS[engine];
+    return {
+        command: spec.command,
+        args: [...spec.args],
+        display: `${spec.displayName} (${spec.command} ${spec.args.join(" ")})`,
+    };
+}
+/**
+ * Minimized environment for the adapter subprocess. The full parent env can
+ * carry unrelated cloud/deploy/CI secrets; the adapter (and the agent it
+ * execs) only needs the platform basics plus its own provider credentials.
+ * Extend with RELAYMESSENGER_ENGINE_ENV="VAR1,VAR2,MYPREFIX_*". Deliberately no
+ * "inherit" escape hatch exists: unrelated deploy and cloud credentials must
+ * never be handed wholesale to a coding-agent subprocess.
+ */
+const ENGINE_ENV_EXACT = new Set([
+    "PATH",
+    "HOME",
+    "USER",
+    "LOGNAME",
+    "SHELL",
+    "TMPDIR",
+    "TMP",
+    "TEMP",
+    "LANG",
+    "TZ",
+    "TERM",
+    "COLORTERM",
+    "HTTP_PROXY",
+    "HTTPS_PROXY",
+    "NO_PROXY",
+    "http_proxy",
+    "https_proxy",
+    "no_proxy",
+    // Windows process basics.
+    "SYSTEMROOT",
+    "SYSTEMDRIVE",
+    "COMSPEC",
+    "PATHEXT",
+    "APPDATA",
+    "LOCALAPPDATA",
+    "USERPROFILE",
+    "HOMEDRIVE",
+    "HOMEPATH",
+    "USERNAME",
+    "PROGRAMFILES",
+    "PROGRAMDATA",
+    "OS",
+    "WINDIR",
+]);
+const ENGINE_ENV_PREFIXES = [
+    "LC_",
+    "XDG_",
+    // Engine/provider credentials and settings for supported local runtimes.
+    "ANTHROPIC_",
+    "CLAUDE_",
+    "OPENAI_",
+    "CODEX_",
+    "HERMES_",
+];
+export function engineEnv(parent = process.env) {
+    const extra = (parent.RELAYMESSENGER_ENGINE_ENV ?? "").trim();
+    const extraExact = new Set();
+    const extraPrefixes = [];
+    for (const raw of extra.split(",")) {
+        const entry = raw.trim();
+        if (entry.length === 0)
+            continue;
+        if (entry.endsWith("*"))
+            extraPrefixes.push(entry.slice(0, -1));
+        else
+            extraExact.add(entry);
+    }
+    const allowed = (key) => {
+        if (ENGINE_ENV_EXACT.has(key) || ENGINE_ENV_EXACT.has(key.toUpperCase()))
+            return true;
+        if (extraExact.has(key))
+            return true;
+        return [...ENGINE_ENV_PREFIXES, ...extraPrefixes].some((prefix) => key.startsWith(prefix));
+    };
+    const env = {};
+    for (const [key, value] of Object.entries(parent)) {
+        if (value !== undefined && allowed(key))
+            env[key] = value;
+    }
+    return env;
+}
+/**
+ * Accumulates one turn's streamed assistant text. Chunks stream into the
+ * current message segment; a tool-call boundary ends the segment, so the next
+ * chunk starts a distinct message. Distinct segments join with a blank line —
+ * a plain "" join would fuse back-to-back messages into one word
+ * ("…the file." + "Created…" → "file.Created").
+ */
+export class AgentTextBuffer {
+    segments = [];
+    open = false;
+    append(chunk) {
+        if (!this.open) {
+            this.segments.push("");
+            this.open = true;
+        }
+        this.segments[this.segments.length - 1] += chunk;
+    }
+    /** Mark a message boundary: the next appended chunk starts a new segment. */
+    endSegment() {
+        this.open = false;
+    }
+    /** Segments trimmed (no doubled blank lines), empty segments dropped. */
+    toString() {
+        return this.segments
+            .map((segment) => segment.trim())
+            .filter((segment) => segment.length > 0)
+            .join("\n\n");
+    }
+}
+/** Merge a sparse ACP tool-call update without erasing previously known fields. */
+export function mergeToolCall(previous, incoming) {
+    const merged = { ...(previous ?? {}) };
+    for (const [key, value] of Object.entries(incoming)) {
+        if (value !== undefined)
+            merged[key] = value;
+    }
+    merged.toolCallId = incoming.toolCallId;
+    return merged;
+}
+/**
+ * Flatten the security-relevant parts of an ACP tool call — raw input,
+ * affected locations, content — into one preview string for the approval
+ * card. Length is clamped downstream (head + tail) by the card builder.
+ */
+export function permissionDetail(toolCall) {
+    const parts = [];
+    if (toolCall.rawInput !== undefined && toolCall.rawInput !== null) {
+        try {
+            parts.push(JSON.stringify(toolCall.rawInput));
+        }
+        catch {
+            parts.push(String(toolCall.rawInput));
+        }
+    }
+    if (Array.isArray(toolCall.locations) && toolCall.locations.length > 0) {
+        parts.push(`paths: ${toolCall.locations.map((location) => location.path).join(", ")}`);
+    }
+    for (const content of toolCall.content ?? []) {
+        if (content.type === "content" && content.content.type === "text") {
+            parts.push(content.content.text);
+        }
+        else if (content.type === "diff") {
+            parts.push([
+                `diff ${content.path}`,
+                "--- before",
+                content.oldText ?? "(new file)",
+                "+++ after",
+                content.newText,
+            ].join("\n"));
+        }
+        else if (content.type === "terminal") {
+            parts.push(`terminal ${content.terminalId}`);
+        }
+    }
+    const joined = parts.filter((part) => part && part.length > 0).join("\n");
+    return joined.length > 0 ? joined : undefined;
+}
+/** True only when the phone can display the full operation being approved. */
+export function permissionInputComplete(toolCall) {
+    if (toolCall.rawInput !== undefined && toolCall.rawInput !== null)
+        return true;
+    return (toolCall.content ?? []).some((content) => content.type === "diff" &&
+        typeof content.path === "string" &&
+        typeof content.newText === "string");
+}
+export class AcpEngine {
+    engine;
+    sessions;
+    log;
+    child;
+    connection;
+    ctx;
+    initialization;
+    loadSessionSupported = false;
+    /** Live turn state keyed by ACP session id. */
+    turns = new Map();
+    /** conversation_id → ACP session + repository for the live process. */
+    liveSessions = new Map();
+    permissionSeq = 0;
+    constructor(engine, sessions, log = () => { }) {
+        this.engine = engine;
+        this.sessions = sessions;
+        this.log = log;
+    }
+    async ensureConnected() {
+        if (this.ctx && this.child && this.child.exitCode === null)
+            return this.ctx;
+        if (!this.initialization) {
+            this.initialization = this.connect();
+            // A failed connect must not poison future attempts: clear the cached
+            // promise on rejection so the next turn re-spawns.
+            this.initialization.catch(() => {
+                this.initialization = undefined;
+            });
+        }
+        await this.initialization;
+        return this.ctx;
+    }
+    async connect() {
+        const processSpec = engineProcessSpec(this.engine);
+        this.log(`spawning ${processSpec.display}`);
+        const child = crossSpawn(processSpec.command, processSpec.args, {
+            stdio: ["pipe", "pipe", "inherit"],
+            env: engineEnv(),
+            // POSIX: own process group so dispose() reaches adapter descendants.
+            detached: process.platform !== "win32",
+            windowsHide: true,
+        });
+        this.child = child;
+        child.on("error", (error) => {
+            this.log(`${processSpec.display} spawn error: ${error.message}`);
+            this.resetConnection();
+        });
+        child.on("exit", (code) => {
+            this.log(`${processSpec.display} exited with code ${code}`);
+            this.resetConnection();
+        });
+        const stream = ndJsonStream(Writable.toWeb(child.stdin), Readable.toWeb(child.stdout));
+        const app = client({ name: "relaymessenger" })
+            .onRequest("session/request_permission", async (c) => this.handlePermission(c.params))
+            .onNotification("session/update", (c) => {
+            this.handleUpdate(c.params);
+        });
+        const connection = app.connect(stream);
+        this.connection = connection;
+        this.ctx = connection.agent;
+        const init = await this.ctx.request("initialize", {
+            protocolVersion: PROTOCOL_VERSION,
+            clientInfo: { name: "relaymessenger", version: "0.2.0" },
+            clientCapabilities: {},
+        });
+        if (init.protocolVersion !== PROTOCOL_VERSION) {
+            throw new Error(`${engineDisplayName(this.engine)} returned unsupported ACP protocol ` +
+                `${init.protocolVersion}; relaymessenger requires ${PROTOCOL_VERSION}`);
+        }
+        this.loadSessionSupported = init.agentCapabilities?.loadSession === true;
+        this.log(`initialized ${processSpec.display} (protocol v${init.protocolVersion})`);
+    }
+    resetConnection() {
+        this.connection?.close();
+        this.connection = undefined;
+        this.ctx = undefined;
+        this.initialization = undefined;
+        this.liveSessions.clear();
+        this.turns.clear();
+    }
+    handleUpdate(notification) {
+        const turn = this.turns.get(notification.sessionId);
+        if (!turn)
+            return;
+        const update = notification.update;
+        if (update.sessionUpdate === "agent_message_chunk" && update.content.type === "text") {
+            turn.text.append(update.content.text);
+            turn.callbacks.onDelta?.(update.content.text);
+        }
+        else if (update.sessionUpdate === "tool_call" || update.sessionUpdate === "tool_call_update") {
+            // A tool call between text chunks means the next text is a new message.
+            turn.text.endSegment();
+            const { sessionUpdate: _sessionUpdate, ...incoming } = update;
+            turn.toolCalls.set(incoming.toolCallId, mergeToolCall(turn.toolCalls.get(incoming.toolCallId), incoming));
+            turn.callbacks.onToolEvent?.({
+                kind: update.sessionUpdate,
+                title: "title" in update ? (update.title ?? undefined) : undefined,
+            });
+        }
+    }
+    async handlePermission(params) {
+        const turn = this.turns.get(params.sessionId);
+        if (!turn) {
+            // No live turn owns this session (e.g. restart race) — safest is refusal.
+            return { outcome: { outcome: "cancelled" } };
+        }
+        this.permissionSeq += 1;
+        const toolCall = mergeToolCall(turn.toolCalls.get(params.toolCall.toolCallId), params.toolCall);
+        turn.toolCalls.set(toolCall.toolCallId, toolCall);
+        const ask = {
+            requestId: `perm_${Date.now().toString(36)}_${this.permissionSeq}`,
+            toolName: toolCall.title ?? toolCall.toolCallId,
+            title: toolCall.title ?? undefined,
+            // The card must show WHAT is being approved, not just a tool title: a
+            // generic "Bash" with the command hidden turns Allow into a blind grant.
+            inputPreview: permissionDetail(toolCall),
+            inputComplete: permissionInputComplete(toolCall),
+            options: params.options.map((option) => ({
+                optionId: option.optionId,
+                label: option.name,
+                kind: option.kind,
+            })),
+        };
+        const decision = await turn.callbacks.onPermissionAsk(ask);
+        if (decision.behavior === "selected") {
+            return { outcome: { outcome: "selected", optionId: decision.optionId } };
+        }
+        return { outcome: { outcome: "cancelled" } };
+    }
+    async openSession(ctx, ref) {
+        const live = this.liveSessions.get(ref.conversationId);
+        if (live?.cwd === ref.cwd)
+            return live.sessionId;
+        if (live)
+            this.liveSessions.delete(ref.conversationId);
+        const stored = this.sessions.get(ref.conversationId);
+        // Reuse only bindings from the same engine AND the same working
+        // directory: reloading another repository's session would leak its
+        // history/instructions into this tree and act against the wrong files.
+        if (stored && stored.engine === this.engine && stored.cwd === ref.cwd && this.loadSessionSupported) {
+            try {
+                await ctx.request("session/load", {
+                    sessionId: stored.session_id,
+                    cwd: ref.cwd,
+                    mcpServers: [],
+                });
+                this.liveSessions.set(ref.conversationId, { sessionId: stored.session_id, cwd: ref.cwd });
+                return stored.session_id;
+            }
+            catch (error) {
+                this.log(`session/load failed for ${ref.conversationId}, creating fresh: ${error}`);
+                this.sessions.delete(ref.conversationId);
+            }
+        }
+        const created = await ctx.request("session/new", { cwd: ref.cwd, mcpServers: [] });
+        this.liveSessions.set(ref.conversationId, { sessionId: created.sessionId, cwd: ref.cwd });
+        this.sessions.set(ref.conversationId, {
+            engine: this.engine,
+            session_id: created.sessionId,
+            cwd: ref.cwd,
+            created_at: new Date().toISOString(),
+        });
+        return created.sessionId;
+    }
+    async startTurn(ref, promptText, callbacks) {
+        const ctx = await this.ensureConnected();
+        const sessionId = await this.openSession(ctx, ref);
+        const turn = { callbacks, text: new AgentTextBuffer(), toolCalls: new Map() };
+        this.turns.set(sessionId, turn);
+        try {
+            // No request timeout: a coding-agent turn can legitimately run for a
+            // long time, and the JSON-RPC layer settles when the peer responds.
+            const response = await ctx.request("session/prompt", {
+                sessionId,
+                prompt: [{ type: "text", text: promptText }],
+            });
+            return { text: turn.text.toString(), stopReason: response.stopReason };
+        }
+        finally {
+            this.turns.delete(sessionId);
+        }
+    }
+    async abort(ref) {
+        const live = this.liveSessions.get(ref.conversationId);
+        if (!live || live.cwd !== ref.cwd || !this.ctx)
+            return;
+        await this.ctx.notify("session/cancel", { sessionId: live.sessionId });
+    }
+    async dispose() {
+        const child = this.child;
+        this.resetConnection();
+        this.child = undefined;
+        if (child)
+            await terminateProcessTree(child);
+    }
+}
+//# sourceMappingURL=acp.js.map

package/dist/engine/acp.js.map

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

package/dist/engine/catalog.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ACP runtime presets supported by relaymessenger.
+ *
+ * Bundled adapters are exact npm dependencies resolved by acp.ts. External
+ * runtimes are always user-installed binaries: relaymessenger never downloads a
+ * mutable CLI at startup and never passes a command through a shell.
+ */
+export declare const ENGINE_NAMES: readonly ["claude", "codex", "hermes"];
+export type EngineName = (typeof ENGINE_NAMES)[number];
+export interface ExternalEngineSpec {
+    displayName: string;
+    command: string;
+    args: string[];
+    versionArgs: string[];
+    docsUrl: string;
+    /** Runtime-specific readiness check that does not reveal credentials. */
+    checkArgs?: string[];
+    /** Some ACP servers impose a shorter requestPermission deadline. */
+    permissionTimeoutMs?: number;
+}
+export declare const EXTERNAL_ENGINE_SPECS: Record<Exclude<EngineName, "claude" | "codex">, ExternalEngineSpec>;
+export declare function isEngineName(value: unknown): value is EngineName;
+export declare function engineDisplayName(engine: EngineName | string): string;
+export declare function enginePermissionTimeoutMs(engine: EngineName): number | undefined;
+export declare const ENGINE_HELP: string;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/engine/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/engine/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,wCAIf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,EAAE,kBAAkB,CAWrG,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAIrE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAGhF;AAED,eAAO,MAAM,WAAW,QAAyB,CAAC"}

package/dist/engine/catalog.js

@@ -0,0 +1,41 @@
+/**
+ * ACP runtime presets supported by relaymessenger.
+ *
+ * Bundled adapters are exact npm dependencies resolved by acp.ts. External
+ * runtimes are always user-installed binaries: relaymessenger never downloads a
+ * mutable CLI at startup and never passes a command through a shell.
+ */
+export const ENGINE_NAMES = [
+    "claude",
+    "codex",
+    "hermes",
+];
+export const EXTERNAL_ENGINE_SPECS = {
+    hermes: {
+        displayName: "Hermes Agent",
+        command: "hermes",
+        args: ["acp"],
+        versionArgs: ["--version"],
+        checkArgs: ["acp", "--check"],
+        docsUrl: "https://hermes-agent.nousresearch.com/docs/user-guide/features/acp",
+        // Hermes currently waits 60 seconds for an ACP permission decision.
+        permissionTimeoutMs: 55_000,
+    },
+};
+export function isEngineName(value) {
+    return typeof value === "string" && ENGINE_NAMES.includes(value);
+}
+export function engineDisplayName(engine) {
+    if (engine === "claude")
+        return "Claude Code";
+    if (engine === "codex")
+        return "Codex";
+    return EXTERNAL_ENGINE_SPECS[engine]?.displayName ?? engine;
+}
+export function enginePermissionTimeoutMs(engine) {
+    if (engine === "claude" || engine === "codex")
+        return undefined;
+    return EXTERNAL_ENGINE_SPECS[engine].permissionTimeoutMs;
+}
+export const ENGINE_HELP = ENGINE_NAMES.join("|");
+//# sourceMappingURL=catalog.js.map

package/dist/engine/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/engine/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,OAAO;IACP,QAAQ;CACA,CAAC;AAgBX,MAAM,CAAC,MAAM,qBAAqB,GAAwE;IACxG,MAAM,EAAE;QACN,WAAW,EAAE,cAAc;QAC3B,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,WAAW,EAAE,CAAC,WAAW,CAAC;QAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;QAC7B,OAAO,EAAE,oEAAoE;QAC7E,oEAAoE;QACpE,mBAAmB,EAAE,MAAM;KAC5B;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAA2B;IAC3D,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC;IAC9C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,OAAO,qBAAqB,CAAC,MAA4C,CAAC,EAAE,WAAW,IAAI,MAAM,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAkB;IAC1D,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAChE,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/engine/process.d.ts

@@ -0,0 +1,12 @@
+import { type ChildProcess } from "node:child_process";
+/**
+ * Terminates the complete subprocess tree owned by an engine adapter.
+ *
+ * POSIX children are spawned as process-group leaders, so a negative PID
+ * reaches the adapter and every agent process below it. Windows has no
+ * equivalent signalable process group; taskkill /T /F is the supported tree
+ * termination path there. The bounded wait prevents shutdown from hanging on
+ * a child that ignores SIGTERM.
+ */
+export declare function terminateProcessTree(child: ChildProcess, graceMs?: number): Promise<void>;
+//# sourceMappingURL=process.d.ts.map

package/dist/engine/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/engine/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlE;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC9F"}

package/dist/engine/process.js

@@ -0,0 +1,54 @@
+import { spawnSync } from "node:child_process";
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Terminates the complete subprocess tree owned by an engine adapter.
+ *
+ * POSIX children are spawned as process-group leaders, so a negative PID
+ * reaches the adapter and every agent process below it. Windows has no
+ * equivalent signalable process group; taskkill /T /F is the supported tree
+ * termination path there. The bounded wait prevents shutdown from hanging on
+ * a child that ignores SIGTERM.
+ */
+export async function terminateProcessTree(child, graceMs = 2_000) {
+    const pid = child.pid;
+    if (!pid || child.exitCode !== null || child.signalCode !== null)
+        return;
+    let exited = false;
+    const exit = new Promise((resolve) => {
+        child.once("exit", () => {
+            exited = true;
+            resolve();
+        });
+    });
+    if (process.platform === "win32") {
+        // /T includes descendants; /F is necessary for console processes that do
+        // not participate in a shared console control group.
+        spawnSync("taskkill", ["/PID", String(pid), "/T", "/F"], {
+            stdio: "ignore",
+            windowsHide: true,
+        });
+        if (!exited)
+            child.kill();
+        await Promise.race([exit, delay(graceMs)]);
+        return;
+    }
+    try {
+        process.kill(-pid, "SIGTERM");
+    }
+    catch {
+        child.kill("SIGTERM");
+    }
+    await Promise.race([exit, delay(graceMs)]);
+    if (exited)
+        return;
+    try {
+        process.kill(-pid, "SIGKILL");
+    }
+    catch {
+        child.kill("SIGKILL");
+    }
+    await Promise.race([exit, delay(1_000)]);
+}
+//# sourceMappingURL=process.js.map

package/dist/engine/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/engine/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAElE,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAmB,EAAE,OAAO,GAAG,KAAK;IAC7E,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO;IAEzE,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACzC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACtB,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,yEAAyE;QACzE,qDAAqD;QACrD,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;YACvD,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO;IAEnB,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/engine/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Narrow engine-adapter boundary. The receive loop only knows this interface;
+ * AcpEngine drives every supported coding runtime over ACP stdio without the
+ * loop knowing which. `SessionRef` is opaque per engine — adapters own their
+ * own binding from conversation_id to whatever session identity they need.
+ */
+export interface SessionRef {
+    conversationId: string;
+    /** Working directory the engine session should operate in. */
+    cwd: string;
+}
+export interface PermissionAsk {
+    requestId: string;
+    toolName?: string;
+    title?: string;
+    /**
+     * Security-relevant detail of the operation being approved (raw tool input,
+     * affected paths). Rendered on the phone card so the owner sees what they
+     * are allowing, not just a tool title.
+     */
+    inputPreview?: string;
+    /** False when the adapter cannot provide the raw operation being approved. */
+    inputComplete?: boolean;
+    options: Array<{
+        optionId: string;
+        label: string;
+        kind?: string;
+    }>;
+}
+export type PermissionDecision = {
+    behavior: "selected";
+    optionId: string;
+} | {
+    behavior: "cancelled";
+};
+export interface TurnCallbacks {
+    /** Streaming assistant text; the bridge finalizes quietly, so this is informational. */
+    onDelta?(text: string): void;
+    /** Tool activity, surfaced as a typing label. */
+    onToolEvent?(event: {
+        kind: string;
+        title?: string;
+    }): void;
+    /** Blocking permission ask — resolve with the user's decision. */
+    onPermissionAsk(ask: PermissionAsk): Promise<PermissionDecision>;
+}
+export interface TurnResult {
+    text: string;
+    stopReason: string;
+}
+export interface EngineAdapter {
+    readonly engine: string;
+    startTurn(ref: SessionRef, promptText: string, callbacks: TurnCallbacks): Promise<TurnResult>;
+    abort(ref: SessionRef): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iDAAiD;IACjD,WAAW,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,kEAAkE;IAClE,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9F,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/engine/types.js

@@ -0,0 +1,8 @@
+/**
+ * Narrow engine-adapter boundary. The receive loop only knows this interface;
+ * AcpEngine drives every supported coding runtime over ACP stdio without the
+ * loop knowing which. `SessionRef` is opaque per engine — adapters own their
+ * own binding from conversation_id to whatever session identity they need.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}