@agentex/agent 0.0.16 → 0.0.19

package/dist/providers/acp/parse.js

@@ -0,0 +1,122 @@
+function str(v) {
+    return typeof v === "string" && v.length > 0 ? v : null;
+}
+/** Extract text from an ACP `ContentBlock` (a chunk update's `content`). */
+export function extractContentText(content) {
+    if (!content || typeof content !== "object")
+        return null;
+    const c = content;
+    if (c["type"] === "text" && typeof c["text"] === "string")
+        return c["text"];
+    return null;
+}
+/** Extract displayable text from a tool call's `content` (ToolCallContent[]). */
+export function extractToolContentText(content) {
+    if (!Array.isArray(content))
+        return null;
+    const parts = [];
+    for (const item of content) {
+        if (!item || typeof item !== "object")
+            continue;
+        const c = item;
+        if (c["type"] === "content") {
+            const inner = extractContentText(c["content"]);
+            if (inner)
+                parts.push(inner);
+        }
+        else if (c["type"] === "diff") {
+            const nd = c["newText"] ?? c["new_text"];
+            if (typeof nd === "string")
+                parts.push(nd);
+        }
+        // Note: a "terminal" ToolCallContent carries only a `terminalId` (its output
+        // must be fetched via the ACP terminal/* methods, which we don't implement),
+        // so there's no inline text to extract here.
+    }
+    return parts.length ? parts.join("\n") : null;
+}
+function makeBase(update, info) {
+    // ACP doesn't expose per-event/message/turn ids, so those stay null; the
+    // tool callId IS available, so tool_call/tool_result correlate properly.
+    return {
+        timestamp: info.timestamp,
+        providerType: info.provider,
+        sessionId: info.sessionId,
+        messageId: null,
+        eventId: null,
+        turnId: null,
+        parentToolCallId: null,
+        raw: update,
+    };
+}
+/**
+ * Map an ACP `session/update` payload (`params.update`) to an agentex
+ * `StreamEvent`. Returns null for updates with no agentex equivalent (user
+ * echoes, in-progress tool ticks). Unknown update kinds surface as
+ * `type: "unknown"` for forward-compat.
+ */
+export function mapAcpUpdate(update, info) {
+    const kind = update["sessionUpdate"];
+    const base = makeBase(update, info);
+    switch (kind) {
+        case "agent_message_chunk": {
+            const text = extractContentText(update["content"]);
+            return text != null ? { type: "assistant", text, ...base } : null;
+        }
+        case "agent_thought_chunk": {
+            const text = extractContentText(update["content"]);
+            return text != null ? { type: "thinking", text, ...base } : null;
+        }
+        case "user_message_chunk":
+            return null;
+        case "tool_call":
+            return {
+                type: "tool_call",
+                toolCallId: str(update["toolCallId"]),
+                name: str(update["title"]) ?? str(update["kind"]) ?? "tool",
+                input: update["rawInput"] ?? null,
+                ...base,
+            };
+        case "tool_call_update": {
+            const status = str(update["status"]);
+            // Only emit a result once the tool reaches a terminal state.
+            if (status === "completed" || status === "failed") {
+                const content = extractToolContentText(update["content"]) ??
+                    (typeof update["rawOutput"] === "string" ? update["rawOutput"] : "");
+                return {
+                    type: "tool_result",
+                    toolCallId: str(update["toolCallId"]),
+                    toolName: str(update["title"]),
+                    content,
+                    isError: status === "failed",
+                    exitCode: null,
+                    ...base,
+                };
+            }
+            return null;
+        }
+        default:
+            return { type: "unknown", subtype: str(kind) ?? "unknown", ...base };
+    }
+}
+// NOTE: ACP's `usage_update` reports context-window `{ size, used }` rather than
+// the input/output token split agentex's `TokenUsage` models, so we intentionally
+// don't synthesize usage from ACP — `TurnResult.usage` stays undefined.
+/** Map an ACP `stopReason` to an agentex TurnResult status. */
+export function mapAcpStopReason(stopReason) {
+    switch (stopReason) {
+        case "end_turn":
+            return "completed";
+        case "cancelled":
+            return "aborted";
+        case "refusal":
+            return "failed";
+        case "max_tokens":
+            return "max_budget";
+        case "max_turn_requests":
+            return "max_turns";
+        default:
+            return "completed";
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/providers/acp/parse.js.map

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

package/dist/providers/acp/session.d.ts

@@ -0,0 +1,36 @@
+import type { AgentSession, AgentMode, SessionContext } from "../../types.js";
+/**
+ * Optional hooks to absorb a specific ACP agent's quirks without forking the
+ * base — Paseo's pattern (e.g. Copilot hides a deprecated "autopilot" mode and
+ * exposes a synthetic "allow-all"). Keep the base generic; put weirdness here.
+ */
+export interface AcpTransformers {
+    /** Rewrite the discovered mode list (filter, rename, add synthetic modes). */
+    modes?: (modes: AgentMode[]) => AgentMode[];
+    /** Map a requested mode id to the protocol mode id before `setSessionMode`. */
+    modeId?: (modeId: string) => string;
+}
+/** What `acpProvider` hands a session: how to spawn + drive the agent. */
+export interface AcpSessionDeps {
+    /** Provider id (used for event `providerType`). */
+    provider: string;
+    /** Command to spawn: [binary, ...args]. e.g. ["gemini", "--acp"]. */
+    command: string[];
+    /** Environment overlay. */
+    env?: Record<string, string>;
+    /** Default mode id applied on session creation. */
+    modeId?: string;
+    /** Per-agent quirk transformers. */
+    transformers?: AcpTransformers;
+}
+/** Spawn the agent, run the ACP handshake, and return a connected session. */
+export declare function createAcpSession(deps: AcpSessionDeps, ctx: SessionContext): Promise<AgentSession>;
+/**
+ * Discover an ACP agent's available modes by spawning it, running the
+ * handshake, creating a throwaway session, reading the advertised modes, and
+ * closing. Returns [] on any failure (modes are advisory).
+ */
+export declare function listAcpModes(deps: AcpSessionDeps, ctx?: SessionContext): Promise<AgentMode[]>;
+/** Parse an ACP `SessionModeState` (`{ currentModeId, availableModes }`) into AgentMode[]. */
+export declare function parseAcpModes(modeState: unknown): AgentMode[];
+//# sourceMappingURL=session.d.ts.map

package/dist/providers/acp/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/providers/acp/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EAIT,cAAc,EAGf,MAAM,gBAAgB,CAAC;AAcxB;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,CAAC;IAC5C,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AA6CD,8EAA8E;AAC9E,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAIvB;AAmaD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAoDnG;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,EAAE,CAiB7D"}

package/dist/providers/acp/session.js

@@ -0,0 +1,487 @@
+import { spawn } from "node:child_process";
+import { Readable, Writable } from "node:stream";
+import { readFile, writeFile } from "node:fs/promises";
+import { buildEnv, ensurePathInEnv } from "../../utils/env.js";
+import { uuidv7 } from "../../utils/uuid.js";
+import { extractContentText, mapAcpStopReason, mapAcpUpdate } from "./parse.js";
+/** Reject if `p` doesn't settle within `ms` — bounds the handshake so a hung
+ *  agent binary can't hang connect()/listModes() indefinitely. */
+function withTimeout(p, ms, label) {
+    return Promise.race([
+        p,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms)),
+    ]);
+}
+/** Resume session id from sessionParams (sessionId / session_id), or null. */
+function readAcpResumeId(sp) {
+    if (!sp)
+        return null;
+    const id = sp["sessionId"] ?? sp["session_id"];
+    return typeof id === "string" && id.length > 0 ? id : null;
+}
+const ACP_HANDSHAKE_TIMEOUT_MS = 30_000;
+/** Spawn the agent, run the ACP handshake, and return a connected session. */
+export async function createAcpSession(deps, ctx) {
+    const session = new AcpSession(deps, ctx);
+    await session.connect();
+    return session;
+}
+class AcpSession {
+    deps;
+    ctx;
+    _state = "idle";
+    _sessionId = null;
+    proc = null;
+    connection = null;
+    /** A turn is in flight (ACP runs one prompt at a time). */
+    _turnActive = false;
+    /** Accumulated assistant text for the current turn → TurnResult.summary. */
+    _turnText = "";
+    _inFlight = null;
+    _draining = false;
+    /** toolCallId → tool name, so tool_call_update can report a name. Cleared per turn. */
+    _toolNames = new Map();
+    constructor(deps, ctx) {
+        this.deps = deps;
+        this.ctx = ctx;
+    }
+    get sessionId() {
+        return this._sessionId;
+    }
+    get state() {
+        return this._state;
+    }
+    // -------------------------------------------------------------------------
+    // Connect — spawn + initialize + newSession
+    // -------------------------------------------------------------------------
+    async connect() {
+        const acp = (await import("@agentclientprotocol/sdk"));
+        const binary = this.ctx.config?.command ?? this.deps.command[0];
+        const args = this.deps.command.slice(1);
+        const env = buildEnv({ ...this.deps.env, ...this.ctx.env });
+        ensurePathInEnv(env);
+        const proc = spawn(binary, args, {
+            cwd: this.ctx.cwd ?? process.cwd(),
+            env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.proc = proc;
+        proc.stderr?.setEncoding("utf-8");
+        proc.stderr?.on("data", (chunk) => {
+            if (this.ctx.onOutput) {
+                try {
+                    void this.ctx.onOutput("stderr", chunk);
+                }
+                catch {
+                    /* swallow */
+                }
+            }
+        });
+        proc.on("exit", () => {
+            if (this._state !== "closed")
+                this._state = "closed";
+        });
+        // Catch spawn failures (ENOENT, EACCES) — an unhandled 'error' event would
+        // otherwise crash the host process.
+        proc.on("error", () => {
+            if (this._state !== "closed")
+                this._state = "closed";
+        });
+        if (!proc.stdin || !proc.stdout)
+            throw new Error("Failed to open stdio on ACP agent process");
+        // fs callbacks do unconfined disk I/O on agent-supplied paths — equivalent to
+        // the agent's own filesystem access (it's a local subprocess with the user's
+        // privileges), so this isn't a sandbox escape, just coordination.
+        try {
+            const writable = Writable.toWeb(proc.stdin);
+            const readable = Readable.toWeb(proc.stdout);
+            const stream = acp.ndJsonStream(writable, readable);
+            const client = {
+                requestPermission: (params) => this.handlePermission(params),
+                sessionUpdate: (params) => this.handleSessionUpdate(params),
+                readTextFile: async (params) => {
+                    const content = await readFile(params.path, "utf-8");
+                    return { content };
+                },
+                writeTextFile: async (params) => {
+                    await writeFile(params.path, params.content, "utf-8");
+                    return {};
+                },
+            };
+            this.connection = new acp.ClientSideConnection(() => client, stream);
+            const initResult = await withTimeout(this.connection.initialize({
+                protocolVersion: acp.PROTOCOL_VERSION,
+                clientCapabilities: { fs: { readTextFile: true, writeTextFile: true } },
+            }), ACP_HANDSHAKE_TIMEOUT_MS, "acp initialize");
+            const agentCaps = initResult.agentCapabilities;
+            const cwd = this.ctx.cwd ?? process.cwd();
+            // Resume an existing session when the caller supplied one AND the agent
+            // advertises `loadSession`; otherwise start fresh. (ACP `session/load`
+            // replays history via notifications, which our turn-isolation gate drops —
+            // we want continuity, not a re-emit.) When resume isn't possible the new
+            // session id supersedes the caller's, so saved params naturally roll over.
+            const resumeId = readAcpResumeId(this.ctx.sessionParams);
+            let loaded = false;
+            if (resumeId && agentCaps?.loadSession && this.connection.loadSession) {
+                try {
+                    await withTimeout(this.connection.loadSession({ sessionId: resumeId, cwd, mcpServers: [] }), ACP_HANDSHAKE_TIMEOUT_MS, "acp loadSession");
+                    this._sessionId = resumeId;
+                    loaded = true;
+                }
+                catch (err) {
+                    if (this.ctx.onOutput) {
+                        const reason = err instanceof Error ? err.message : String(err);
+                        try {
+                            void this.ctx.onOutput("stderr", `agentex: acp session/load failed for ${resumeId}, starting fresh: ${reason}\n`);
+                        }
+                        catch { /* swallow */ }
+                    }
+                }
+            }
+            if (!loaded) {
+                const res = await withTimeout(this.connection.newSession({ cwd, mcpServers: [] }), ACP_HANDSHAKE_TIMEOUT_MS, "acp newSession");
+                this._sessionId = typeof res.sessionId === "string" ? res.sessionId : null;
+            }
+            const requested = this.ctx.config?.modeId ?? this.deps.modeId;
+            if (requested && this._sessionId && this.connection.setSessionMode) {
+                const modeId = this.deps.transformers?.modeId
+                    ? this.deps.transformers.modeId(requested)
+                    : requested;
+                try {
+                    await this.connection.setSessionMode({ sessionId: this._sessionId, modeId });
+                }
+                catch {
+                    /* mode application is best-effort */
+                }
+            }
+        }
+        catch (err) {
+            // Spawn/handshake failed — tear down so we don't leak the child process.
+            this._state = "closed";
+            try {
+                proc.kill();
+            }
+            catch {
+                /* ignore */
+            }
+            throw err;
+        }
+        // Wire AbortSignal → close.
+        if (this.ctx.signal) {
+            if (this.ctx.signal.aborted)
+                void this.close();
+            else
+                this.ctx.signal.addEventListener("abort", () => void this.close(), { once: true });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Client callbacks (agent → us)
+    // -------------------------------------------------------------------------
+    async handleSessionUpdate(params) {
+        const update = params.update;
+        if (!update)
+            return;
+        // Drop stragglers from a finished/aborted turn (ACP events aren't turn-tagged,
+        // so a late update would otherwise be attributed to the next turn).
+        if (!this._turnActive)
+            return;
+        const kind = update["sessionUpdate"];
+        if (kind === "agent_message_chunk") {
+            const text = extractContentText(update["content"]);
+            if (text)
+                this._turnText += text;
+        }
+        // Cache tool names from the initial tool_call so tool_call_update (which often
+        // omits `title`) can still report a toolName.
+        if (kind === "tool_call") {
+            const id = update["toolCallId"];
+            const title = update["title"];
+            if (typeof id === "string" && typeof title === "string" && title) {
+                this._toolNames.set(id, title);
+            }
+        }
+        const event = mapAcpUpdate(update, {
+            provider: this.deps.provider,
+            sessionId: this._sessionId,
+            timestamp: new Date().toISOString(),
+        });
+        if (event) {
+            if (event.type === "tool_result" && !event.toolName && event.toolCallId) {
+                const cached = this._toolNames.get(event.toolCallId);
+                if (cached)
+                    event.toolName = cached;
+            }
+            if (this.ctx.onEvent) {
+                try {
+                    await this.ctx.onEvent(event);
+                }
+                catch {
+                    /* a throwing handler must not break the stream */
+                }
+            }
+        }
+    }
+    async handlePermission(params) {
+        const toolCall = (params.toolCall ?? {});
+        const options = (params.options ?? []);
+        const select = (allow) => {
+            const want = allow ? ["allow_once", "allow_always"] : ["reject_once", "reject_always"];
+            const opt = options.find((o) => want.includes(String(o["kind"]))) ?? options[0];
+            if (!opt)
+                return { outcome: { outcome: "cancelled" } };
+            return {
+                outcome: { outcome: "selected", optionId: String(opt["optionId"]) },
+            };
+        };
+        this._state = "waiting_for_approval";
+        const restore = () => {
+            if (this._state === "waiting_for_approval")
+                this._state = this._turnActive ? "thinking" : "idle";
+        };
+        if (!this.ctx.onUserInputRequest) {
+            const r = select(true);
+            restore();
+            return r;
+        }
+        try {
+            const result = await this.ctx.onUserInputRequest({
+                toolName: String(toolCall["title"] ?? toolCall["kind"] ?? "tool"),
+                input: toolCall["rawInput"] ?? toolCall,
+                toolUseId: String(toolCall["toolCallId"] ?? ""),
+                ...(typeof toolCall["title"] === "string" ? { title: toolCall["title"] } : {}),
+            });
+            const r = select(result.allow);
+            restore();
+            return r;
+        }
+        catch {
+            const r = select(false);
+            restore();
+            return r;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    async send(message, options) {
+        if (this._state === "closed")
+            throw new Error("Session is closed");
+        if (this._draining)
+            throw new Error("Session is draining — no new sends accepted");
+        if (this._turnActive) {
+            throw new Error("ACP session is busy — a turn is already in progress (concurrentSend not supported)");
+        }
+        const uuid = uuidv7();
+        this._turnActive = true;
+        this._turnText = "";
+        this._toolNames.clear();
+        this._state = "thinking";
+        const result = this.runPrompt(message, options);
+        this._inFlight = result;
+        return { uuid, result };
+    }
+    finishTurn() {
+        this._turnActive = false;
+        this._inFlight = null;
+        if (this._state !== "closed")
+            this._state = "idle";
+    }
+    async runPrompt(message, options) {
+        const sessionId = this._sessionId;
+        if (!this.connection || !sessionId) {
+            this.finishTurn();
+            return {
+                summary: null,
+                costUsd: null,
+                status: "failed",
+                errorCode: "not_initialized",
+                errorMessage: "ACP session is not initialized",
+            };
+        }
+        const timeoutSec = options?.timeoutSec ?? this.ctx.config?.timeoutSec;
+        let timer = null;
+        const promptP = this.connection
+            .prompt({ sessionId, prompt: [{ type: "text", text: message }] })
+            .then((res) => ({ ok: true, res }))
+            .catch((err) => ({
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        }));
+        const guards = [];
+        if (timeoutSec && timeoutSec > 0) {
+            guards.push(new Promise((resolve) => {
+                timer = setTimeout(() => resolve("timeout"), timeoutSec * 1000);
+            }));
+        }
+        if (options?.signal) {
+            if (options.signal.aborted)
+                guards.push(Promise.resolve("aborted"));
+            else
+                guards.push(new Promise((resolve) => options.signal.addEventListener("abort", () => resolve("aborted"), { once: true })));
+        }
+        const outcome = await Promise.race([promptP.then(() => "prompt"), ...guards]);
+        if (timer)
+            clearTimeout(timer);
+        if (outcome === "timeout" || outcome === "aborted") {
+            try {
+                await this.interrupt();
+            }
+            catch {
+                /* best effort */
+            }
+            // Drain the cancelled turn before finishing: ACP guarantees the agent
+            // flushes any pending session/update notifications and then resolves the
+            // prompt as cancelled. Awaiting it (bounded) keeps those stragglers inside
+            // THIS turn's window so they can't bleed into the next turn's text/events.
+            const summaryBeforeDrain = this._turnText;
+            await Promise.race([
+                promptP,
+                new Promise((resolve) => setTimeout(resolve, 2000)),
+            ]);
+            this.finishTurn();
+            return {
+                summary: (this._turnText || summaryBeforeDrain) || null,
+                costUsd: null,
+                status: outcome,
+                errorCode: outcome,
+                errorMessage: outcome === "timeout" ? "Turn exceeded its timeout" : "Turn aborted",
+            };
+        }
+        const settled = await promptP;
+        this.finishTurn();
+        if (!settled.ok) {
+            return {
+                summary: this._turnText || null,
+                costUsd: null,
+                status: "failed",
+                errorCode: "prompt_error",
+                errorMessage: settled.error,
+            };
+        }
+        return {
+            summary: this._turnText || null,
+            costUsd: null,
+            status: mapAcpStopReason(settled.res?.stopReason),
+            errorCode: null,
+            errorMessage: null,
+        };
+    }
+    async cancel(_uuid) {
+        // ACP has no per-queued-message cancel — only whole-turn cancel via interrupt().
+        return { cancelled: false };
+    }
+    async interrupt() {
+        if (this.connection && this._sessionId) {
+            try {
+                await this.connection.cancel({ sessionId: this._sessionId });
+            }
+            catch {
+                /* best effort */
+            }
+        }
+    }
+    async drain() {
+        this._draining = true;
+        const inFlight = this._inFlight;
+        if (inFlight) {
+            try {
+                await inFlight;
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        await this.close();
+    }
+    async close() {
+        this._state = "closed";
+        const proc = this.proc;
+        this.proc = null;
+        if (proc && !proc.killed) {
+            try {
+                proc.kill();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+/**
+ * Discover an ACP agent's available modes by spawning it, running the
+ * handshake, creating a throwaway session, reading the advertised modes, and
+ * closing. Returns [] on any failure (modes are advisory).
+ */
+export async function listAcpModes(deps, ctx) {
+    let proc = null;
+    try {
+        const acp = (await import("@agentclientprotocol/sdk"));
+        const binary = ctx?.config?.command ?? deps.command[0];
+        const args = deps.command.slice(1);
+        const env = buildEnv({ ...deps.env, ...ctx?.env });
+        ensurePathInEnv(env);
+        proc = spawn(binary, args, {
+            cwd: ctx?.cwd ?? process.cwd(),
+            env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        // Swallow spawn errors so they don't surface as an unhandled 'error' crash.
+        proc.on("error", () => { });
+        if (!proc.stdin || !proc.stdout)
+            return [];
+        const writable = Writable.toWeb(proc.stdin);
+        const readable = Readable.toWeb(proc.stdout);
+        const stream = acp.ndJsonStream(writable, readable);
+        const client = {
+            requestPermission: async () => ({ outcome: { outcome: "cancelled" } }),
+            sessionUpdate: async () => { },
+        };
+        const connection = new acp.ClientSideConnection(() => client, stream);
+        await withTimeout(connection.initialize({
+            protocolVersion: acp.PROTOCOL_VERSION,
+            clientCapabilities: { fs: { readTextFile: false, writeTextFile: false } },
+        }), ACP_HANDSHAKE_TIMEOUT_MS, "acp initialize (listModes)");
+        const res = await withTimeout(connection.newSession({ cwd: ctx?.cwd ?? process.cwd(), mcpServers: [] }), ACP_HANDSHAKE_TIMEOUT_MS, "acp newSession (listModes)");
+        const modes = parseAcpModes(res.modes);
+        return deps.transformers?.modes ? deps.transformers.modes(modes) : modes;
+    }
+    catch {
+        return [];
+    }
+    finally {
+        // Always tear down the throwaway process — initialize/newSession can throw
+        // (agent doesn't speak ACP, handshake mismatch) and would otherwise leak it.
+        if (proc && !proc.killed) {
+            try {
+                proc.kill();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+/** Parse an ACP `SessionModeState` (`{ currentModeId, availableModes }`) into AgentMode[]. */
+export function parseAcpModes(modeState) {
+    if (!modeState || typeof modeState !== "object")
+        return [];
+    const available = modeState["availableModes"];
+    if (!Array.isArray(available))
+        return [];
+    const out = [];
+    for (const m of available) {
+        if (!m || typeof m !== "object")
+            continue;
+        const r = m;
+        const id = typeof r["id"] === "string" ? r["id"] : "";
+        if (!id)
+            continue;
+        out.push({
+            id,
+            name: typeof r["name"] === "string" ? r["name"] : id,
+            ...(typeof r["description"] === "string" ? { description: r["description"] } : {}),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=session.js.map