@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/modes/rpc/rpc-client.d.ts

@@ -0,0 +1,50 @@
+import { RpcClientBase } from "./rpc-client-base.ts";
+import type { RpcCommand, RpcExtensionUIResponse, RpcHostActionResponse } from "./rpc-types.ts";
+export type { ModelInfo, RpcClientEvent, RpcEventListener, RpcExtensionErrorEvent, RpcSubagentEndEvent, RpcSubagentEvent, } from "./rpc-client-base.ts";
+export type { RpcWorkflowEvent, RpcWorkflowToolEvent } from "./rpc-types.ts";
+export interface RpcClientOptions {
+    /** Path to the CLI entry point (default: searches for dist/cli.js) */
+    cliPath?: string;
+    /** Working directory for the agent */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Provider to use */
+    provider?: string;
+    /** Model ID to use */
+    model?: string;
+    /** Additional CLI arguments */
+    args?: string[];
+    /** Milliseconds to wait for a command response. Defaults to 30 seconds. */
+    requestTimeoutMs?: number;
+}
+/**
+ * RPC client for programmatic access to the coding agent.
+ *
+ * This subprocess adapter spawns the Volt CLI in RPC mode and exchanges strict
+ * JSONL over stdin/stdout. Use RpcTransportClient when the RPC transport already
+ * exists in-process or over another transport such as Iroh.
+ */
+export declare class RpcClient extends RpcClientBase {
+    private process;
+    private stopReadingStdout;
+    private stderr;
+    private options;
+    constructor(options?: RpcClientOptions);
+    /** Start the RPC agent process. */
+    start(): Promise<void>;
+    /** Stop the RPC agent process. */
+    stop(): Promise<void>;
+    /** Get collected stderr output. */
+    getStderr(): string;
+    protected assertCanSend(): void;
+    protected writeMessage(message: RpcCommand | RpcExtensionUIResponse | RpcHostActionResponse): void;
+    protected getErrorContext(): string;
+    private createProcessExitError;
+    private createReadinessError;
+    private cleanupFailedStart;
+    private terminateChildProcess;
+    private hasProcessExited;
+    private handleProcessFailure;
+}
+//# sourceMappingURL=rpc-client.d.ts.map

package/dist/modes/rpc/rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/rpc-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEhG,YAAY,EACX,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC3C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAmB;IAElC,YAAY,OAAO,GAAE,gBAAqB,EAGzC;IAED,mCAAmC;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAqE3B;IAED,kCAAkC;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1B;IAED,mCAAmC;IACnC,SAAS,IAAI,MAAM,CAElB;IAED,SAAS,CAAC,aAAa,IAAI,IAAI,CAiB9B;IAED,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,IAAI,CAMjG;IAED,SAAS,CAAC,eAAe,IAAI,MAAM,CAElC;IAED,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,oBAAoB;YAMd,kBAAkB;YAYlB,qBAAqB;IAmCnC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,oBAAoB;CAI5B","sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.ts\";\nimport { RpcClientBase } from \"./rpc-client-base.ts\";\nimport type { RpcCommand, RpcExtensionUIResponse, RpcHostActionResponse } from \"./rpc-types.ts\";\n\nexport type {\n\tModelInfo,\n\tRpcClientEvent,\n\tRpcEventListener,\n\tRpcExtensionErrorEvent,\n\tRpcSubagentEndEvent,\n\tRpcSubagentEvent,\n} from \"./rpc-client-base.ts\";\nexport type { RpcWorkflowEvent, RpcWorkflowToolEvent } from \"./rpc-types.ts\";\n\nexport interface RpcClientOptions {\n\t/** Path to the CLI entry point (default: searches for dist/cli.js) */\n\tcliPath?: string;\n\t/** Working directory for the agent */\n\tcwd?: string;\n\t/** Environment variables */\n\tenv?: Record<string, string>;\n\t/** Provider to use */\n\tprovider?: string;\n\t/** Model ID to use */\n\tmodel?: string;\n\t/** Additional CLI arguments */\n\targs?: string[];\n\t/** Milliseconds to wait for a command response. Defaults to 30 seconds. */\n\trequestTimeoutMs?: number;\n}\n\n/**\n * RPC client for programmatic access to the coding agent.\n *\n * This subprocess adapter spawns the Volt CLI in RPC mode and exchanges strict\n * JSONL over stdin/stdout. Use RpcTransportClient when the RPC transport already\n * exists in-process or over another transport such as Iroh.\n */\nexport class RpcClient extends RpcClientBase {\n\tprivate process: ChildProcess | null = null;\n\tprivate stopReadingStdout: (() => void) | null = null;\n\tprivate stderr = \"\";\n\tprivate options: RpcClientOptions;\n\n\tconstructor(options: RpcClientOptions = {}) {\n\t\tsuper({ requestTimeoutMs: options.requestTimeoutMs });\n\t\tthis.options = options;\n\t}\n\n\t/** Start the RPC agent process. */\n\tasync start(): Promise<void> {\n\t\tif (this.process) {\n\t\t\tthrow new Error(\"Client already started\");\n\t\t}\n\n\t\tthis.clearFailureError();\n\t\tthis.stderr = \"\";\n\n\t\tconst cliPath = this.options.cliPath ?? \"dist/cli.js\";\n\t\tconst args = [\"--mode\", \"rpc\"];\n\n\t\tif (this.options.provider) {\n\t\t\targs.push(\"--provider\", this.options.provider);\n\t\t}\n\t\tif (this.options.model) {\n\t\t\targs.push(\"--model\", this.options.model);\n\t\t}\n\t\tif (this.options.args) {\n\t\t\targs.push(...this.options.args);\n\t\t}\n\n\t\tconst childProcess = spawn(\"node\", [cliPath, ...args], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: { ...process.env, ...this.options.env },\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\t\tthis.process = childProcess;\n\n\t\tchildProcess.stderr?.on(\"data\", (data: Buffer) => {\n\t\t\tthis.stderr += data.toString();\n\t\t\tprocess.stderr.write(data);\n\t\t});\n\n\t\tchildProcess.once(\"exit\", (code, signal) => {\n\t\t\tif (this.process !== childProcess) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.handleProcessFailure(this.createProcessExitError(code, signal));\n\t\t});\n\t\tchildProcess.once(\"error\", (error) => {\n\t\t\tif (this.process !== childProcess) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.handleProcessFailure(new Error(`Agent process error: ${error.message}. ${this.getErrorContext()}`));\n\t\t});\n\t\tchildProcess.stdin?.on(\"error\", (error) => {\n\t\t\tif (this.process !== childProcess) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.handleProcessFailure(new Error(`Agent process stdin error: ${error.message}. ${this.getErrorContext()}`));\n\t\t});\n\n\t\tthis.stopReadingStdout = attachJsonlLineReader(childProcess.stdout!, (line) => {\n\t\t\tthis.handleLine(line);\n\t\t});\n\n\t\ttry {\n\t\t\tawait this.getState();\n\t\t} catch (error: unknown) {\n\t\t\tconst readinessError = this.createReadinessError(toError(error));\n\t\t\ttry {\n\t\t\t\tawait this.cleanupFailedStart(childProcess);\n\t\t\t} catch (cleanupError: unknown) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`${readinessError.message}; additionally failed to clean up child process: ${toError(cleanupError).message}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow readinessError;\n\t\t}\n\t}\n\n\t/** Stop the RPC agent process. */\n\tasync stop(): Promise<void> {\n\t\tconst childProcess = this.process;\n\t\tif (!childProcess) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.stopReadingStdout?.();\n\t\tthis.stopReadingStdout = null;\n\t\tthis.rejectPendingRequests(new Error(\"RPC client stopped\"));\n\t\tawait this.terminateChildProcess(childProcess);\n\n\t\tif (this.process === childProcess) {\n\t\t\tthis.process = null;\n\t\t}\n\t}\n\n\t/** Get collected stderr output. */\n\tgetStderr(): string {\n\t\treturn this.stderr;\n\t}\n\n\tprotected assertCanSend(): void {\n\t\tconst childProcess = this.process;\n\t\tconst stdin = childProcess?.stdin;\n\t\tif (!childProcess || !stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tsuper.assertCanSend();\n\t\tif (this.hasProcessExited(childProcess)) {\n\t\t\tconst error = this.createProcessExitError(childProcess.exitCode, childProcess.signalCode);\n\t\t\tthis.handleProcessFailure(error);\n\t\t\tthrow error;\n\t\t}\n\t\tif (stdin.destroyed || !stdin.writable) {\n\t\t\tconst error = new Error(`Agent process stdin is not writable. ${this.getErrorContext()}`);\n\t\t\tthis.handleProcessFailure(error);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprotected writeMessage(message: RpcCommand | RpcExtensionUIResponse | RpcHostActionResponse): void {\n\t\tconst stdin = this.process?.stdin;\n\t\tif (!stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tstdin.write(serializeJsonLine(message));\n\t}\n\n\tprotected getErrorContext(): string {\n\t\treturn `Stderr: ${this.stderr}`;\n\t}\n\n\tprivate createProcessExitError(code: number | null, signal: NodeJS.Signals | null): Error {\n\t\treturn new Error(`Agent process exited (code=${code} signal=${signal}). ${this.getErrorContext()}`);\n\t}\n\n\tprivate createReadinessError(error: Error): Error {\n\t\tconst context = this.getErrorContext();\n\t\tconst contextSuffix = context && !error.message.includes(context) ? `. ${context}` : \"\";\n\t\treturn new Error(`RPC readiness probe failed: ${error.message}${contextSuffix}`);\n\t}\n\n\tprivate async cleanupFailedStart(childProcess: ChildProcess): Promise<void> {\n\t\tif (this.process !== childProcess) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.stopReadingStdout?.();\n\t\tthis.stopReadingStdout = null;\n\t\tthis.rejectPendingRequests(new Error(\"RPC client startup failed\"));\n\t\tthis.process = null;\n\t\tawait this.terminateChildProcess(childProcess);\n\t}\n\n\tprivate async terminateChildProcess(childProcess: ChildProcess): Promise<void> {\n\t\tif (childProcess.pid === undefined || this.hasProcessExited(childProcess)) {\n\t\t\treturn;\n\t\t}\n\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tlet settled = false;\n\t\t\tlet timeout: ReturnType<typeof setTimeout> | undefined;\n\t\t\tconst finish = (): void => {\n\t\t\t\tif (settled) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tsettled = true;\n\t\t\t\tif (timeout) {\n\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t}\n\t\t\t\tchildProcess.off(\"exit\", finish);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\ttimeout = setTimeout(() => {\n\t\t\t\tif (!this.hasProcessExited(childProcess)) {\n\t\t\t\t\tchildProcess.kill(\"SIGKILL\");\n\t\t\t\t}\n\t\t\t\tfinish();\n\t\t\t}, 1000);\n\t\t\tchildProcess.once(\"exit\", finish);\n\n\t\t\tif (this.hasProcessExited(childProcess)) {\n\t\t\t\tfinish();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tchildProcess.kill(\"SIGTERM\");\n\t\t});\n\t}\n\n\tprivate hasProcessExited(childProcess: ChildProcess): boolean {\n\t\treturn childProcess.exitCode !== null || childProcess.signalCode !== null;\n\t}\n\n\tprivate handleProcessFailure(error: Error): void {\n\t\tthis.setFailureError(error);\n\t\tthis.rejectPendingRequests(error);\n\t}\n}\n\nfunction toError(value: unknown): Error {\n\treturn value instanceof Error ? value : new Error(String(value));\n}\n"]}

package/dist/modes/rpc/rpc-client.js

@@ -0,0 +1,190 @@
+import { spawn } from "node:child_process";
+import { attachJsonlLineReader, serializeJsonLine } from "./jsonl.js";
+import { RpcClientBase } from "./rpc-client-base.js";
+/**
+ * RPC client for programmatic access to the coding agent.
+ *
+ * This subprocess adapter spawns the Volt CLI in RPC mode and exchanges strict
+ * JSONL over stdin/stdout. Use RpcTransportClient when the RPC transport already
+ * exists in-process or over another transport such as Iroh.
+ */
+export class RpcClient extends RpcClientBase {
+    process = null;
+    stopReadingStdout = null;
+    stderr = "";
+    options;
+    constructor(options = {}) {
+        super({ requestTimeoutMs: options.requestTimeoutMs });
+        this.options = options;
+    }
+    /** Start the RPC agent process. */
+    async start() {
+        if (this.process) {
+            throw new Error("Client already started");
+        }
+        this.clearFailureError();
+        this.stderr = "";
+        const cliPath = this.options.cliPath ?? "dist/cli.js";
+        const args = ["--mode", "rpc"];
+        if (this.options.provider) {
+            args.push("--provider", this.options.provider);
+        }
+        if (this.options.model) {
+            args.push("--model", this.options.model);
+        }
+        if (this.options.args) {
+            args.push(...this.options.args);
+        }
+        const childProcess = spawn("node", [cliPath, ...args], {
+            cwd: this.options.cwd,
+            env: { ...process.env, ...this.options.env },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.process = childProcess;
+        childProcess.stderr?.on("data", (data) => {
+            this.stderr += data.toString();
+            process.stderr.write(data);
+        });
+        childProcess.once("exit", (code, signal) => {
+            if (this.process !== childProcess) {
+                return;
+            }
+            this.handleProcessFailure(this.createProcessExitError(code, signal));
+        });
+        childProcess.once("error", (error) => {
+            if (this.process !== childProcess) {
+                return;
+            }
+            this.handleProcessFailure(new Error(`Agent process error: ${error.message}. ${this.getErrorContext()}`));
+        });
+        childProcess.stdin?.on("error", (error) => {
+            if (this.process !== childProcess) {
+                return;
+            }
+            this.handleProcessFailure(new Error(`Agent process stdin error: ${error.message}. ${this.getErrorContext()}`));
+        });
+        this.stopReadingStdout = attachJsonlLineReader(childProcess.stdout, (line) => {
+            this.handleLine(line);
+        });
+        try {
+            await this.getState();
+        }
+        catch (error) {
+            const readinessError = this.createReadinessError(toError(error));
+            try {
+                await this.cleanupFailedStart(childProcess);
+            }
+            catch (cleanupError) {
+                throw new Error(`${readinessError.message}; additionally failed to clean up child process: ${toError(cleanupError).message}`);
+            }
+            throw readinessError;
+        }
+    }
+    /** Stop the RPC agent process. */
+    async stop() {
+        const childProcess = this.process;
+        if (!childProcess) {
+            return;
+        }
+        this.stopReadingStdout?.();
+        this.stopReadingStdout = null;
+        this.rejectPendingRequests(new Error("RPC client stopped"));
+        await this.terminateChildProcess(childProcess);
+        if (this.process === childProcess) {
+            this.process = null;
+        }
+    }
+    /** Get collected stderr output. */
+    getStderr() {
+        return this.stderr;
+    }
+    assertCanSend() {
+        const childProcess = this.process;
+        const stdin = childProcess?.stdin;
+        if (!childProcess || !stdin) {
+            throw new Error("Client not started");
+        }
+        super.assertCanSend();
+        if (this.hasProcessExited(childProcess)) {
+            const error = this.createProcessExitError(childProcess.exitCode, childProcess.signalCode);
+            this.handleProcessFailure(error);
+            throw error;
+        }
+        if (stdin.destroyed || !stdin.writable) {
+            const error = new Error(`Agent process stdin is not writable. ${this.getErrorContext()}`);
+            this.handleProcessFailure(error);
+            throw error;
+        }
+    }
+    writeMessage(message) {
+        const stdin = this.process?.stdin;
+        if (!stdin) {
+            throw new Error("Client not started");
+        }
+        stdin.write(serializeJsonLine(message));
+    }
+    getErrorContext() {
+        return `Stderr: ${this.stderr}`;
+    }
+    createProcessExitError(code, signal) {
+        return new Error(`Agent process exited (code=${code} signal=${signal}). ${this.getErrorContext()}`);
+    }
+    createReadinessError(error) {
+        const context = this.getErrorContext();
+        const contextSuffix = context && !error.message.includes(context) ? `. ${context}` : "";
+        return new Error(`RPC readiness probe failed: ${error.message}${contextSuffix}`);
+    }
+    async cleanupFailedStart(childProcess) {
+        if (this.process !== childProcess) {
+            return;
+        }
+        this.stopReadingStdout?.();
+        this.stopReadingStdout = null;
+        this.rejectPendingRequests(new Error("RPC client startup failed"));
+        this.process = null;
+        await this.terminateChildProcess(childProcess);
+    }
+    async terminateChildProcess(childProcess) {
+        if (childProcess.pid === undefined || this.hasProcessExited(childProcess)) {
+            return;
+        }
+        await new Promise((resolve) => {
+            let settled = false;
+            let timeout;
+            const finish = () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                if (timeout) {
+                    clearTimeout(timeout);
+                }
+                childProcess.off("exit", finish);
+                resolve();
+            };
+            timeout = setTimeout(() => {
+                if (!this.hasProcessExited(childProcess)) {
+                    childProcess.kill("SIGKILL");
+                }
+                finish();
+            }, 1000);
+            childProcess.once("exit", finish);
+            if (this.hasProcessExited(childProcess)) {
+                finish();
+                return;
+            }
+            childProcess.kill("SIGTERM");
+        });
+    }
+    hasProcessExited(childProcess) {
+        return childProcess.exitCode !== null || childProcess.signalCode !== null;
+    }
+    handleProcessFailure(error) {
+        this.setFailureError(error);
+        this.rejectPendingRequests(error);
+    }
+}
+function toError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+//# sourceMappingURL=rpc-client.js.map

package/dist/modes/rpc/rpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.js","sourceRoot":"","sources":["../../../src/modes/rpc/rpc-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.ts\";\nimport { RpcClientBase } from \"./rpc-client-base.ts\";\nimport type { RpcCommand, RpcExtensionUIResponse, RpcHostActionResponse } from \"./rpc-types.ts\";\n\nexport type {\n\tModelInfo,\n\tRpcClientEvent,\n\tRpcEventListener,\n\tRpcExtensionErrorEvent,\n\tRpcSubagentEndEvent,\n\tRpcSubagentEvent,\n} from \"./rpc-client-base.ts\";\nexport type { RpcWorkflowEvent, RpcWorkflowToolEvent } from \"./rpc-types.ts\";\n\nexport interface RpcClientOptions {\n\t/** Path to the CLI entry point (default: searches for dist/cli.js) */\n\tcliPath?: string;\n\t/** Working directory for the agent */\n\tcwd?: string;\n\t/** Environment variables */\n\tenv?: Record<string, string>;\n\t/** Provider to use */\n\tprovider?: string;\n\t/** Model ID to use */\n\tmodel?: string;\n\t/** Additional CLI arguments */\n\targs?: string[];\n\t/** Milliseconds to wait for a command response. Defaults to 30 seconds. */\n\trequestTimeoutMs?: number;\n}\n\n/**\n * RPC client for programmatic access to the coding agent.\n *\n * This subprocess adapter spawns the Volt CLI in RPC mode and exchanges strict\n * JSONL over stdin/stdout. Use RpcTransportClient when the RPC transport already\n * exists in-process or over another transport such as Iroh.\n */\nexport class RpcClient extends RpcClientBase {\n\tprivate process: ChildProcess | null = null;\n\tprivate stopReadingStdout: (() => void) | null = null;\n\tprivate stderr = \"\";\n\tprivate options: RpcClientOptions;\n\n\tconstructor(options: RpcClientOptions = {}) {\n\t\tsuper({ requestTimeoutMs: options.requestTimeoutMs });\n\t\tthis.options = options;\n\t}\n\n\t/** Start the RPC agent process. */\n\tasync start(): Promise<void> {\n\t\tif (this.process) {\n\t\t\tthrow new Error(\"Client already started\");\n\t\t}\n\n\t\tthis.clearFailureError();\n\t\tthis.stderr = \"\";\n\n\t\tconst cliPath = this.options.cliPath ?? \"dist/cli.js\";\n\t\tconst args = [\"--mode\", \"rpc\"];\n\n\t\tif (this.options.provider) {\n\t\t\targs.push(\"--provider\", this.options.provider);\n\t\t}\n\t\tif (this.options.model) {\n\t\t\targs.push(\"--model\", this.options.model);\n\t\t}\n\t\tif (this.options.args) {\n\t\t\targs.push(...this.options.args);\n\t\t}\n\n\t\tconst childProcess = spawn(\"node\", [cliPath, ...args], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: { ...process.env, ...this.options.env },\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\t\tthis.process = childProcess;\n\n\t\tchildProcess.stderr?.on(\"data\", (data: Buffer) => {\n\t\t\tthis.stderr += data.toString();\n\t\t\tprocess.stderr.write(data);\n\t\t});\n\n\t\tchildProcess.once(\"exit\", (code, signal) => {\n\t\t\tif (this.process !== childProcess) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.handleProcessFailure(this.createProcessExitError(code, signal));\n\t\t});\n\t\tchildProcess.once(\"error\", (error) => {\n\t\t\tif (this.process !== childProcess) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.handleProcessFailure(new Error(`Agent process error: ${error.message}. ${this.getErrorContext()}`));\n\t\t});\n\t\tchildProcess.stdin?.on(\"error\", (error) => {\n\t\t\tif (this.process !== childProcess) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.handleProcessFailure(new Error(`Agent process stdin error: ${error.message}. ${this.getErrorContext()}`));\n\t\t});\n\n\t\tthis.stopReadingStdout = attachJsonlLineReader(childProcess.stdout!, (line) => {\n\t\t\tthis.handleLine(line);\n\t\t});\n\n\t\ttry {\n\t\t\tawait this.getState();\n\t\t} catch (error: unknown) {\n\t\t\tconst readinessError = this.createReadinessError(toError(error));\n\t\t\ttry {\n\t\t\t\tawait this.cleanupFailedStart(childProcess);\n\t\t\t} catch (cleanupError: unknown) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`${readinessError.message}; additionally failed to clean up child process: ${toError(cleanupError).message}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow readinessError;\n\t\t}\n\t}\n\n\t/** Stop the RPC agent process. */\n\tasync stop(): Promise<void> {\n\t\tconst childProcess = this.process;\n\t\tif (!childProcess) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.stopReadingStdout?.();\n\t\tthis.stopReadingStdout = null;\n\t\tthis.rejectPendingRequests(new Error(\"RPC client stopped\"));\n\t\tawait this.terminateChildProcess(childProcess);\n\n\t\tif (this.process === childProcess) {\n\t\t\tthis.process = null;\n\t\t}\n\t}\n\n\t/** Get collected stderr output. */\n\tgetStderr(): string {\n\t\treturn this.stderr;\n\t}\n\n\tprotected assertCanSend(): void {\n\t\tconst childProcess = this.process;\n\t\tconst stdin = childProcess?.stdin;\n\t\tif (!childProcess || !stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tsuper.assertCanSend();\n\t\tif (this.hasProcessExited(childProcess)) {\n\t\t\tconst error = this.createProcessExitError(childProcess.exitCode, childProcess.signalCode);\n\t\t\tthis.handleProcessFailure(error);\n\t\t\tthrow error;\n\t\t}\n\t\tif (stdin.destroyed || !stdin.writable) {\n\t\t\tconst error = new Error(`Agent process stdin is not writable. ${this.getErrorContext()}`);\n\t\t\tthis.handleProcessFailure(error);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprotected writeMessage(message: RpcCommand | RpcExtensionUIResponse | RpcHostActionResponse): void {\n\t\tconst stdin = this.process?.stdin;\n\t\tif (!stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tstdin.write(serializeJsonLine(message));\n\t}\n\n\tprotected getErrorContext(): string {\n\t\treturn `Stderr: ${this.stderr}`;\n\t}\n\n\tprivate createProcessExitError(code: number | null, signal: NodeJS.Signals | null): Error {\n\t\treturn new Error(`Agent process exited (code=${code} signal=${signal}). ${this.getErrorContext()}`);\n\t}\n\n\tprivate createReadinessError(error: Error): Error {\n\t\tconst context = this.getErrorContext();\n\t\tconst contextSuffix = context && !error.message.includes(context) ? `. ${context}` : \"\";\n\t\treturn new Error(`RPC readiness probe failed: ${error.message}${contextSuffix}`);\n\t}\n\n\tprivate async cleanupFailedStart(childProcess: ChildProcess): Promise<void> {\n\t\tif (this.process !== childProcess) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.stopReadingStdout?.();\n\t\tthis.stopReadingStdout = null;\n\t\tthis.rejectPendingRequests(new Error(\"RPC client startup failed\"));\n\t\tthis.process = null;\n\t\tawait this.terminateChildProcess(childProcess);\n\t}\n\n\tprivate async terminateChildProcess(childProcess: ChildProcess): Promise<void> {\n\t\tif (childProcess.pid === undefined || this.hasProcessExited(childProcess)) {\n\t\t\treturn;\n\t\t}\n\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tlet settled = false;\n\t\t\tlet timeout: ReturnType<typeof setTimeout> | undefined;\n\t\t\tconst finish = (): void => {\n\t\t\t\tif (settled) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tsettled = true;\n\t\t\t\tif (timeout) {\n\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t}\n\t\t\t\tchildProcess.off(\"exit\", finish);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\ttimeout = setTimeout(() => {\n\t\t\t\tif (!this.hasProcessExited(childProcess)) {\n\t\t\t\t\tchildProcess.kill(\"SIGKILL\");\n\t\t\t\t}\n\t\t\t\tfinish();\n\t\t\t}, 1000);\n\t\t\tchildProcess.once(\"exit\", finish);\n\n\t\t\tif (this.hasProcessExited(childProcess)) {\n\t\t\t\tfinish();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tchildProcess.kill(\"SIGTERM\");\n\t\t});\n\t}\n\n\tprivate hasProcessExited(childProcess: ChildProcess): boolean {\n\t\treturn childProcess.exitCode !== null || childProcess.signalCode !== null;\n\t}\n\n\tprivate handleProcessFailure(error: Error): void {\n\t\tthis.setFailureError(error);\n\t\tthis.rejectPendingRequests(error);\n\t}\n}\n\nfunction toError(value: unknown): Error {\n\treturn value instanceof Error ? value : new Error(String(value));\n}\n"]}

package/dist/modes/rpc/rpc-command-dispatcher.d.ts

@@ -0,0 +1,43 @@
+import type { AgentSession } from "../../core/agent-session.ts";
+import type { AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
+import { type HostActionInvocationContext } from "../../core/host-actions.ts";
+import type { RpcClientCapabilityFeature, RpcCommand, RpcHostActionRequest, RpcListSubagentsResponse, RpcRegisterPushTargetResponse, RpcResponse, RpcSessionState, RpcSubagentStartResponse, RpcTranscriptResponse } from "./rpc-types.ts";
+export declare const HOST_ACTION_REQUESTS_CAPABILITY: RpcClientCapabilityFeature;
+export interface RpcCommandDispatcherOptions {
+    allowUiActionInvocation: boolean;
+    requireRemoteSafeUiActions: boolean;
+    registerPushTarget: ((args: unknown) => Promise<RpcRegisterPushTargetResponse>) | undefined;
+}
+export interface RpcSubagentLifecycleController {
+    list(): RpcListSubagentsResponse;
+    start(agent: string, prompt: string): Promise<RpcSubagentStartResponse>;
+    abort(subagentId: string): Promise<void>;
+    getState(subagentId: string): Promise<RpcSessionState>;
+    getTranscript(options: {
+        subagentId: string;
+        limit?: number;
+        beforeEntryId?: string;
+    }): Promise<RpcTranscriptResponse>;
+    dispose(subagentId: string): Promise<void>;
+    disposeAll(): Promise<void>;
+}
+export interface RpcCommandDispatcherContext {
+    session: AgentSession;
+    runtimeHost: AgentSessionRuntime;
+    options: RpcCommandDispatcherOptions;
+    output(response: RpcResponse): void;
+    rebindSession(): Promise<void>;
+    createHostActionContext(): HostActionInvocationContext;
+    setClientCapabilities(features: RpcClientCapabilityFeature[]): void;
+    getPendingHostActionRequests(): RpcHostActionRequest[];
+    cancelPendingHostActionRequests(message?: string): void;
+    subagents: RpcSubagentLifecycleController;
+}
+export declare function createRpcSuccessResponse<T extends RpcCommand["type"]>(id: string | undefined, command: T, data?: object | null): RpcResponse;
+export declare function createRpcErrorResponse(id: string | undefined, command: string, message: string): RpcResponse;
+export declare function getRpcErrorResponseTarget(value: unknown): {
+    id: string | undefined;
+    command: string;
+};
+export declare function handleRpcCommand(command: RpcCommand, context: RpcCommandDispatcherContext): Promise<RpcResponse | undefined>;
+//# sourceMappingURL=rpc-command-dispatcher.d.ts.map

package/dist/modes/rpc/rpc-command-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-command-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/rpc-command-dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAEN,KAAK,2BAA2B,EAKhC,MAAM,4BAA4B,CAAC;AASpC,OAAO,KAAK,EAGX,0BAA0B,EAC1B,UAAU,EACV,oBAAoB,EACpB,wBAAwB,EAGxB,6BAA6B,EAC7B,WAAW,EAEX,eAAe,EAEf,wBAAwB,EACxB,qBAAqB,EAErB,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,+BAA+B,EAAE,0BAAsD,CAAC;AAErG,MAAM,WAAW,2BAA2B;IAC3C,uBAAuB,EAAE,OAAO,CAAC;IACjC,0BAA0B,EAAE,OAAO,CAAC;IACpC,kBAAkB,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,6BAA6B,CAAC,CAAC,GAAG,SAAS,CAAC;CAC5F;AAED,MAAM,WAAW,8BAA8B;IAC9C,IAAI,IAAI,wBAAwB,CAAC;IACjC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACxE,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvD,aAAa,CAAC,OAAO,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE,2BAA2B,CAAC;IACrC,MAAM,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,uBAAuB,IAAI,2BAA2B,CAAC;IACvD,qBAAqB,CAAC,QAAQ,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAAC;IACpE,4BAA4B,IAAI,oBAAoB,EAAE,CAAC;IACvD,+BAA+B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,SAAS,EAAE,8BAA8B,CAAC;CAC1C;AAiCD,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EACpE,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,OAAO,EAAE,CAAC,EACV,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAClB,WAAW,CAKb;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAE5G;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CASrG;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,GAClC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA6rBlC","sourcesContent":["import type { ThinkingLevel } from \"@hansjm10/volt-agent-core\";\nimport { getSupportedThinkingLevels } from \"@hansjm10/volt-ai\";\nimport type { AgentSession } from \"../../core/agent-session.ts\";\nimport type { AgentSessionRuntime } from \"../../core/agent-session-runtime.ts\";\nimport {\n\tBUILTIN_HOST_ACTION_REGISTRY,\n\ttype HostActionInvocationContext,\n\trunCancelHostAction,\n\trunContextCompactHostAction,\n\trunSessionNewHostAction,\n\trunSessionRenameHostAction,\n} from \"../../core/host-actions.ts\";\nimport { getMcpRpcCapabilities, listMcpRpcServers } from \"../../core/mcp/rpc.ts\";\nimport type { McpGatewayExecutionContext } from \"../../core/mcp/types.ts\";\nimport { projectMessageImages, projectSessionTranscript, projectSubagentDetails } from \"../../core/rpc/transcript.ts\";\nimport {\n\tcreateUiActionInvocationPlan,\n\tgetUiActionCompletions,\n\tgetUiActionDescriptors,\n} from \"../../core/rpc/ui-actions.ts\";\nimport type {\n\tRpcActiveToolExecution,\n\tRpcCatalogModel,\n\tRpcClientCapabilityFeature,\n\tRpcCommand,\n\tRpcHostActionRequest,\n\tRpcListSubagentsResponse,\n\tRpcModel,\n\tRpcPendingHostActionsResponse,\n\tRpcRegisterPushTargetResponse,\n\tRpcResponse,\n\tRpcSessionListItem,\n\tRpcSessionState,\n\tRpcSlashCommand,\n\tRpcSubagentStartResponse,\n\tRpcTranscriptResponse,\n\tUiActionCapabilities,\n} from \"./rpc-types.ts\";\n\nexport const HOST_ACTION_REQUESTS_CAPABILITY: RpcClientCapabilityFeature = \"host_action_requests.v1\";\n\nexport interface RpcCommandDispatcherOptions {\n\tallowUiActionInvocation: boolean;\n\trequireRemoteSafeUiActions: boolean;\n\tregisterPushTarget: ((args: unknown) => Promise<RpcRegisterPushTargetResponse>) | undefined;\n}\n\nexport interface RpcSubagentLifecycleController {\n\tlist(): RpcListSubagentsResponse;\n\tstart(agent: string, prompt: string): Promise<RpcSubagentStartResponse>;\n\tabort(subagentId: string): Promise<void>;\n\tgetState(subagentId: string): Promise<RpcSessionState>;\n\tgetTranscript(options: {\n\t\tsubagentId: string;\n\t\tlimit?: number;\n\t\tbeforeEntryId?: string;\n\t}): Promise<RpcTranscriptResponse>;\n\tdispose(subagentId: string): Promise<void>;\n\tdisposeAll(): Promise<void>;\n}\n\nexport interface RpcCommandDispatcherContext {\n\tsession: AgentSession;\n\truntimeHost: AgentSessionRuntime;\n\toptions: RpcCommandDispatcherOptions;\n\toutput(response: RpcResponse): void;\n\trebindSession(): Promise<void>;\n\tcreateHostActionContext(): HostActionInvocationContext;\n\tsetClientCapabilities(features: RpcClientCapabilityFeature[]): void;\n\tgetPendingHostActionRequests(): RpcHostActionRequest[];\n\tcancelPendingHostActionRequests(message?: string): void;\n\tsubagents: RpcSubagentLifecycleController;\n}\n\nfunction createRpcMcpExecutionContext(): McpGatewayExecutionContext {\n\treturn {\n\t\tmode: \"rpc\",\n\t\tcaller: \"user\",\n\t};\n}\n\nfunction getUiActionCapabilities(invocationEnabled: boolean): UiActionCapabilities {\n\treturn {\n\t\tprotocolVersion: 1,\n\t\tfeatures: invocationEnabled\n\t\t\t? [\"ui_actions.v1\", \"ui_action_invocation.v1\", \"ui_action_completions.v1\"]\n\t\t\t: [\"ui_actions.v1\", \"ui_action_completions.v1\"],\n\t\tmaxActions: 200,\n\t\tmaxDescriptorBytes: 65_536,\n\t};\n}\n\nfunction toCatalogModel(model: RpcModel): RpcCatalogModel {\n\treturn { ...model, availableThinkingLevels: getSupportedThinkingLevels(model) as ThinkingLevel[] };\n}\n\nfunction getPromptExtensionCommandName(message: string): string | undefined {\n\tif (!message.startsWith(\"/\")) {\n\t\treturn undefined;\n\t}\n\tconst spaceIndex = message.indexOf(\" \");\n\tconst name = spaceIndex === -1 ? message.slice(1) : message.slice(1, spaceIndex);\n\treturn name.length > 0 ? name : undefined;\n}\n\nexport function createRpcSuccessResponse<T extends RpcCommand[\"type\"]>(\n\tid: string | undefined,\n\tcommand: T,\n\tdata?: object | null,\n): RpcResponse {\n\tif (data === undefined) {\n\t\treturn { id, type: \"response\", command, success: true } as RpcResponse;\n\t}\n\treturn { id, type: \"response\", command, success: true, data } as RpcResponse;\n}\n\nexport function createRpcErrorResponse(id: string | undefined, command: string, message: string): RpcResponse {\n\treturn { id, type: \"response\", command, success: false, error: message };\n}\n\nexport function getRpcErrorResponseTarget(value: unknown): { id: string | undefined; command: string } {\n\tif (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n\t\treturn { id: undefined, command: \"unknown\" };\n\t}\n\tconst command = value as Record<string, unknown>;\n\treturn {\n\t\tid: typeof command.id === \"string\" ? command.id : undefined,\n\t\tcommand: typeof command.type === \"string\" ? command.type : \"unknown\",\n\t};\n}\n\nexport async function handleRpcCommand(\n\tcommand: RpcCommand,\n\tcontext: RpcCommandDispatcherContext,\n): Promise<RpcResponse | undefined> {\n\tconst { options, runtimeHost, session } = context;\n\tconst id = typeof command.id === \"string\" ? command.id : undefined;\n\n\tswitch (command.type) {\n\t\t// =================================================================\n\t\t// Prompting\n\t\t// =================================================================\n\n\t\tcase \"prompt\": {\n\t\t\tif (options.requireRemoteSafeUiActions) {\n\t\t\t\tconst commandName = getPromptExtensionCommandName(command.message);\n\t\t\t\tconst extensionCommand = commandName ? session.extensionRunner.getCommand(commandName) : undefined;\n\t\t\t\tif (extensionCommand && extensionCommand.remoteSafe !== true) {\n\t\t\t\t\treturn createRpcErrorResponse(\n\t\t\t\t\t\tid,\n\t\t\t\t\t\t\"prompt\",\n\t\t\t\t\t\t`Extension command is not available over remote host: /${commandName}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Start prompt handling immediately, but emit the authoritative response only after\n\t\t\t// prompt preflight succeeds. Queued and immediately handled prompts also count as success.\n\t\t\tlet preflightSucceeded = false;\n\t\t\tvoid session\n\t\t\t\t.prompt(command.message, {\n\t\t\t\t\timages: command.images,\n\t\t\t\t\tstreamingBehavior: command.streamingBehavior,\n\t\t\t\t\tsource: \"rpc\",\n\t\t\t\t\tpreflightResult: (didSucceed) => {\n\t\t\t\t\t\tif (didSucceed) {\n\t\t\t\t\t\t\tpreflightSucceeded = true;\n\t\t\t\t\t\t\tcontext.output(createRpcSuccessResponse(id, \"prompt\"));\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t})\n\t\t\t\t.catch((e) => {\n\t\t\t\t\tif (!preflightSucceeded) {\n\t\t\t\t\t\tcontext.output(createRpcErrorResponse(id, \"prompt\", e.message));\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\treturn undefined;\n\t\t}\n\n\t\tcase \"steer\": {\n\t\t\tawait session.steer(command.message, command.images);\n\t\t\treturn createRpcSuccessResponse(id, \"steer\");\n\t\t}\n\n\t\tcase \"follow_up\": {\n\t\t\tawait session.followUp(command.message, command.images);\n\t\t\treturn createRpcSuccessResponse(id, \"follow_up\");\n\t\t}\n\n\t\tcase \"abort\": {\n\t\t\tawait runCancelHostAction(context.createHostActionContext());\n\t\t\treturn createRpcSuccessResponse(id, \"abort\");\n\t\t}\n\n\t\tcase \"new_session\": {\n\t\t\tconst newSessionOptions = command.parentSession ? { parentSession: command.parentSession } : undefined;\n\t\t\tconst result = await runSessionNewHostAction(context.createHostActionContext(), newSessionOptions);\n\t\t\treturn createRpcSuccessResponse(id, \"new_session\", result);\n\t\t}\n\n\t\t// =================================================================\n\t\t// Client capabilities and host-initiated actions\n\t\t// =================================================================\n\n\t\tcase \"set_client_capabilities\": {\n\t\t\tcontext.setClientCapabilities(command.features);\n\t\t\tif (!command.features.includes(HOST_ACTION_REQUESTS_CAPABILITY)) {\n\t\t\t\tcontext.cancelPendingHostActionRequests(\"Host action capability disabled\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"set_client_capabilities\");\n\t\t}\n\n\t\tcase \"get_pending_host_actions\": {\n\t\t\tconst data: RpcPendingHostActionsResponse = {\n\t\t\t\tactions: context.getPendingHostActionRequests(),\n\t\t\t};\n\t\t\treturn createRpcSuccessResponse(id, \"get_pending_host_actions\", data);\n\t\t}\n\n\t\t// =================================================================\n\t\t// Native UI Actions\n\t\t// =================================================================\n\n\t\tcase \"get_ui_capabilities\": {\n\t\t\treturn createRpcSuccessResponse(\n\t\t\t\tid,\n\t\t\t\t\"get_ui_capabilities\",\n\t\t\t\tgetUiActionCapabilities(options.allowUiActionInvocation),\n\t\t\t);\n\t\t}\n\n\t\tcase \"get_ui_actions\": {\n\t\t\treturn createRpcSuccessResponse(id, \"get_ui_actions\", {\n\t\t\t\tactions: getUiActionDescriptors(session, command.scope, {\n\t\t\t\t\tremoteSafeOnly: options.requireRemoteSafeUiActions,\n\t\t\t\t}),\n\t\t\t});\n\t\t}\n\n\t\tcase \"get_ui_action_completions\": {\n\t\t\treturn createRpcSuccessResponse(id, \"get_ui_action_completions\", {\n\t\t\t\tcompletions: await getUiActionCompletions(session, {\n\t\t\t\t\taction: command.action,\n\t\t\t\t\targument: command.argument,\n\t\t\t\t\tprefix: command.prefix,\n\t\t\t\t\trequireRemoteSafe: options.requireRemoteSafeUiActions,\n\t\t\t\t}),\n\t\t\t});\n\t\t}\n\n\t\tcase \"invoke_ui_action\": {\n\t\t\tif (!options.allowUiActionInvocation) {\n\t\t\t\treturn createRpcErrorResponse(\n\t\t\t\t\tid,\n\t\t\t\t\t\"invoke_ui_action\",\n\t\t\t\t\t\"UI action invocation is not available over this RPC transport\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (BUILTIN_HOST_ACTION_REGISTRY.get(command.action)) {\n\t\t\t\tconst response = await BUILTIN_HOST_ACTION_REGISTRY.invoke(\n\t\t\t\t\tcommand.action,\n\t\t\t\t\tcontext.createHostActionContext(),\n\t\t\t\t\tcommand.args,\n\t\t\t\t\t{ requireRemoteSafe: options.requireRemoteSafeUiActions },\n\t\t\t\t);\n\t\t\t\treturn createRpcSuccessResponse(id, \"invoke_ui_action\", response);\n\t\t\t}\n\t\t\tconst invocation = createUiActionInvocationPlan(session, {\n\t\t\t\taction: command.action,\n\t\t\t\targs: command.args,\n\t\t\t\trequireRemoteSafe: options.requireRemoteSafeUiActions,\n\t\t\t\tstreamingBehavior: command.streamingBehavior,\n\t\t\t});\n\t\t\tlet preflightSucceeded = false;\n\t\t\tvoid session\n\t\t\t\t.prompt(invocation.promptText, {\n\t\t\t\t\tstreamingBehavior: invocation.promptStreamingBehavior,\n\t\t\t\t\tsource: \"rpc\",\n\t\t\t\t\tpreflightResult: (didSucceed) => {\n\t\t\t\t\t\tif (didSucceed) {\n\t\t\t\t\t\t\tpreflightSucceeded = true;\n\t\t\t\t\t\t\tcontext.output(createRpcSuccessResponse(id, \"invoke_ui_action\", invocation.response));\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t})\n\t\t\t\t.catch((e) => {\n\t\t\t\t\tif (!preflightSucceeded) {\n\t\t\t\t\t\tcontext.output(createRpcErrorResponse(id, \"invoke_ui_action\", e.message));\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\treturn undefined;\n\t\t}\n\n\t\t// =================================================================\n\t\t// Push notifications\n\t\t// =================================================================\n\n\t\tcase \"register_push_target\": {\n\t\t\tif (!options.registerPushTarget) {\n\t\t\t\treturn createRpcErrorResponse(\n\t\t\t\t\tid,\n\t\t\t\t\t\"register_push_target\",\n\t\t\t\t\t\"Push target registration is not available over this RPC transport\",\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"register_push_target\", await options.registerPushTarget(command.args));\n\t\t}\n\n\t\t// =================================================================\n\t\t// MCP management\n\t\t// =================================================================\n\n\t\tcase \"get_mcp_capabilities\": {\n\t\t\treturn createRpcSuccessResponse(id, \"get_mcp_capabilities\", getMcpRpcCapabilities());\n\t\t}\n\n\t\tcase \"list_mcp_servers\": {\n\t\t\treturn createRpcSuccessResponse(id, \"list_mcp_servers\", listMcpRpcServers(session.getMcpManager()));\n\t\t}\n\n\t\tcase \"get_mcp_server\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"get_mcp_server\", \"MCP is not configured\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"get_mcp_server\", { server: manager.getServer(command.server) });\n\t\t}\n\n\t\tcase \"connect_mcp_server\":\n\t\tcase \"refresh_mcp_server\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, command.type, \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst result = await manager.connectServer(command.server);\n\t\t\treturn createRpcSuccessResponse(id, command.type, { server: result.server });\n\t\t}\n\n\t\tcase \"disconnect_mcp_server\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"disconnect_mcp_server\", \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst result = await manager.disconnectServer(command.server);\n\t\t\treturn createRpcSuccessResponse(id, \"disconnect_mcp_server\", { server: result.server });\n\t\t}\n\n\t\tcase \"start_mcp_server_auth\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"start_mcp_server_auth\", \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst result = await manager.startServerAuth(command.server, {\n\t\t\t\tflow: command.flow,\n\t\t\t\tredirectUrl: command.redirectUrl,\n\t\t\t});\n\t\t\treturn createRpcSuccessResponse(id, \"start_mcp_server_auth\", result as object);\n\t\t}\n\n\t\tcase \"complete_mcp_server_auth\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"complete_mcp_server_auth\", \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst result = await manager.completeServerBrowserAuth(command.server, {\n\t\t\t\tredirectUrl: command.redirectUrl,\n\t\t\t\tcode: command.code,\n\t\t\t\tstate: command.state,\n\t\t\t});\n\t\t\treturn createRpcSuccessResponse(id, \"complete_mcp_server_auth\", result as object);\n\t\t}\n\n\t\tcase \"poll_mcp_server_auth\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"poll_mcp_server_auth\", \"MCP is not configured\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(\n\t\t\t\tid,\n\t\t\t\t\"poll_mcp_server_auth\",\n\t\t\t\t(await manager.pollServerAuth(command.server)) as object,\n\t\t\t);\n\t\t}\n\n\t\tcase \"cancel_mcp_server_auth\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"cancel_mcp_server_auth\", \"MCP is not configured\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"cancel_mcp_server_auth\", manager.cancelServerAuth(command.server));\n\t\t}\n\n\t\tcase \"logout_mcp_server\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"logout_mcp_server\", \"MCP is not configured\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"logout_mcp_server\", await manager.logoutServer(command.server));\n\t\t}\n\n\t\tcase \"set_mcp_server_enabled\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"set_mcp_server_enabled\", \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst result = await manager.setServerEnabled(command.server, command.enabled);\n\t\t\treturn createRpcSuccessResponse(id, \"set_mcp_server_enabled\", {\n\t\t\t\tserver: result.server,\n\t\t\t\t...(result.persisted ? { persisted: result.persisted } : {}),\n\t\t\t});\n\t\t}\n\n\t\tcase \"list_mcp_tools\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"list_mcp_tools\", \"MCP is not configured\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"list_mcp_tools\", await manager.listTools(command.server));\n\t\t}\n\n\t\tcase \"get_mcp_tool\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"get_mcp_tool\", \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst tools = await manager.listTools(command.server);\n\t\t\tconst tool = tools.tools.find((entry) => entry.name === command.tool);\n\t\t\tif (!tool) {\n\t\t\t\treturn createRpcErrorResponse(id, \"get_mcp_tool\", `MCP tool not found: ${command.server}.${command.tool}`);\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"get_mcp_tool\", { tool });\n\t\t}\n\n\t\tcase \"list_mcp_resources\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"list_mcp_resources\", \"MCP is not configured\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(\n\t\t\t\tid,\n\t\t\t\t\"list_mcp_resources\",\n\t\t\t\tawait manager.listResources(command.server, command.cursor),\n\t\t\t);\n\t\t}\n\n\t\tcase \"read_mcp_resource\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"read_mcp_resource\", \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst result = await manager.readResource(command.server, command.resourceUri, createRpcMcpExecutionContext());\n\t\t\treturn createRpcSuccessResponse(id, \"read_mcp_resource\", { result });\n\t\t}\n\n\t\tcase \"list_mcp_prompts\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"list_mcp_prompts\", \"MCP is not configured\");\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(\n\t\t\t\tid,\n\t\t\t\t\"list_mcp_prompts\",\n\t\t\t\tawait manager.listPrompts(command.server, command.cursor),\n\t\t\t);\n\t\t}\n\n\t\tcase \"get_mcp_prompt\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcErrorResponse(id, \"get_mcp_prompt\", \"MCP is not configured\");\n\t\t\t}\n\t\t\tconst result = await manager.getPrompt(\n\t\t\t\tcommand.server,\n\t\t\t\tcommand.prompt,\n\t\t\t\t{ action: \"get_prompt\", arguments: command.arguments, argumentsJson: command.argumentsJson },\n\t\t\t\tcreateRpcMcpExecutionContext(),\n\t\t\t);\n\t\t\treturn createRpcSuccessResponse(id, \"get_mcp_prompt\", { result });\n\t\t}\n\n\t\tcase \"list_mcp_recent_calls\": {\n\t\t\tconst manager = session.getMcpManager();\n\t\t\tif (!manager) {\n\t\t\t\treturn createRpcSuccessResponse(id, \"list_mcp_recent_calls\", { calls: [] });\n\t\t\t}\n\t\t\tconst calls = command.server\n\t\t\t\t? manager.getServer(command.server).recentCalls\n\t\t\t\t: manager.listServers().flatMap((server) => server.recentCalls);\n\t\t\treturn createRpcSuccessResponse(id, \"list_mcp_recent_calls\", { calls });\n\t\t}\n\n\t\t// =================================================================\n\t\t// State\n\t\t// =================================================================\n\n\t\tcase \"get_state\": {\n\t\t\tconst activeCompaction = session.activeCompaction;\n\t\t\tconst activeTools = [...session.agent.state.pendingToolExecutions.values()].map(\n\t\t\t\t(execution): RpcActiveToolExecution => {\n\t\t\t\t\t// Ship the newest subagent tree snapshot so a client attaching\n\t\t\t\t\t// mid-turn paints live delegation state without waiting for the\n\t\t\t\t\t// next tool_execution_update.\n\t\t\t\t\tconst details =\n\t\t\t\t\t\texecution.toolName === \"subagent\" && isRecord(execution.latestDetails)\n\t\t\t\t\t\t\t? projectSubagentDetails(execution.latestDetails)\n\t\t\t\t\t\t\t: undefined;\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttoolCallId: execution.toolCallId,\n\t\t\t\t\t\ttoolName: execution.toolName,\n\t\t\t\t\t\tstatus: \"started\",\n\t\t\t\t\t\targs: { ...execution.args },\n\t\t\t\t\t\t...(details ? { details } : {}),\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t);\n\t\t\tconst state: RpcSessionState = {\n\t\t\t\tmodel: session.model,\n\t\t\t\tthinkingLevel: session.thinkingLevel,\n\t\t\t\tavailableThinkingLevels: session.getAvailableThinkingLevels(),\n\t\t\t\tisStreaming: session.isStreaming,\n\t\t\t\tisBusy: session.isBusy,\n\t\t\t\tisCompacting: session.isCompacting,\n\t\t\t\tsteeringMode: session.steeringMode,\n\t\t\t\tfollowUpMode: session.followUpMode,\n\t\t\t\tsessionFile: session.sessionFile,\n\t\t\t\tsessionId: session.sessionId,\n\t\t\t\tsessionName: session.sessionName,\n\t\t\t\tautoCompactionEnabled: session.autoCompactionEnabled,\n\t\t\t\tmessageCount: session.messages.length,\n\t\t\t\tpendingMessageCount: session.pendingMessageCount,\n\t\t\t\t...(activeTools.length === 0 ? {} : { activeTools }),\n\t\t\t\t...(activeCompaction ? { activeCompaction } : {}),\n\t\t\t};\n\t\t\treturn createRpcSuccessResponse(id, \"get_state\", state);\n\t\t}\n\n\t\tcase \"get_transcript\": {\n\t\t\tconst transcript = projectSessionTranscript(session.sessionManager, {\n\t\t\t\tbeforeEntryId: command.beforeEntryId,\n\t\t\t\tlimit: command.limit,\n\t\t\t});\n\t\t\treturn createRpcSuccessResponse(id, \"get_transcript\", transcript);\n\t\t}\n\n\t\tcase \"get_message_images\": {\n\t\t\tconst result = projectMessageImages(\n\t\t\t\tsession.sessionManager.getBranch(),\n\t\t\t\tcommand.entryId,\n\t\t\t\tcommand.startImageIndex,\n\t\t\t);\n\t\t\tif (!result.ok) {\n\t\t\t\treturn createRpcErrorResponse(id, \"get_message_images\", result.error);\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"get_message_images\", {\n\t\t\t\tsessionId: session.sessionManager.getSessionId(),\n\t\t\t\tentryId: result.entryId,\n\t\t\t\ttotalImages: result.totalImages,\n\t\t\t\timages: result.images,\n\t\t\t\tnextImageIndex: result.nextImageIndex,\n\t\t\t});\n\t\t}\n\n\t\t// =================================================================\n\t\t// Subagents (local RPC only)\n\t\t// =================================================================\n\n\t\tcase \"list_subagents\": {\n\t\t\treturn createRpcSuccessResponse(id, \"list_subagents\", context.subagents.list());\n\t\t}\n\n\t\tcase \"subagent_start\": {\n\t\t\treturn createRpcSuccessResponse(\n\t\t\t\tid,\n\t\t\t\t\"subagent_start\",\n\t\t\t\tawait context.subagents.start(command.agent, command.prompt),\n\t\t\t);\n\t\t}\n\n\t\tcase \"subagent_abort\": {\n\t\t\tawait context.subagents.abort(command.subagentId);\n\t\t\treturn createRpcSuccessResponse(id, \"subagent_abort\");\n\t\t}\n\n\t\tcase \"subagent_get_state\": {\n\t\t\treturn createRpcSuccessResponse(\n\t\t\t\tid,\n\t\t\t\t\"subagent_get_state\",\n\t\t\t\tawait context.subagents.getState(command.subagentId),\n\t\t\t);\n\t\t}\n\n\t\tcase \"subagent_get_transcript\": {\n\t\t\treturn createRpcSuccessResponse(\n\t\t\t\tid,\n\t\t\t\t\"subagent_get_transcript\",\n\t\t\t\tawait context.subagents.getTranscript({\n\t\t\t\t\tsubagentId: command.subagentId,\n\t\t\t\t\tlimit: command.limit,\n\t\t\t\t\tbeforeEntryId: command.beforeEntryId,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tcase \"subagent_dispose\": {\n\t\t\tawait context.subagents.dispose(command.subagentId);\n\t\t\treturn createRpcSuccessResponse(id, \"subagent_dispose\");\n\t\t}\n\n\t\t// =================================================================\n\t\t// Model\n\t\t// =================================================================\n\n\t\tcase \"set_model\": {\n\t\t\tconst models = await session.modelRegistry.getAvailable();\n\t\t\tconst model = models.find((m) => m.provider === command.provider && m.id === command.modelId);\n\t\t\tif (!model) {\n\t\t\t\treturn createRpcErrorResponse(id, \"set_model\", `Model not found: ${command.provider}/${command.modelId}`);\n\t\t\t}\n\t\t\tawait session.setModel(model, { persistDefault: command.persistDefault });\n\t\t\treturn createRpcSuccessResponse(id, \"set_model\", toCatalogModel(model));\n\t\t}\n\n\t\tcase \"cycle_model\": {\n\t\t\tconst result = await session.cycleModel();\n\t\t\tif (!result) {\n\t\t\t\treturn createRpcSuccessResponse(id, \"cycle_model\", null);\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"cycle_model\", result);\n\t\t}\n\n\t\tcase \"get_available_models\": {\n\t\t\t// Reload credentials and models from disk so logins, logouts, and API keys\n\t\t\t// saved by other volt processes become selectable without a host restart.\n\t\t\tsession.modelRegistry.refreshFromDisk();\n\t\t\tconst models = await session.modelRegistry.getAvailable();\n\t\t\treturn createRpcSuccessResponse(id, \"get_available_models\", { models: models.map(toCatalogModel) });\n\t\t}\n\n\t\t// =================================================================\n\t\t// Thinking\n\t\t// =================================================================\n\n\t\tcase \"set_thinking_level\": {\n\t\t\tsession.setThinkingLevel(command.level, { persistDefault: command.persistDefault });\n\t\t\treturn createRpcSuccessResponse(id, \"set_thinking_level\", { level: session.thinkingLevel });\n\t\t}\n\n\t\tcase \"cycle_thinking_level\": {\n\t\t\tconst level = session.cycleThinkingLevel();\n\t\t\tif (!level) {\n\t\t\t\treturn createRpcSuccessResponse(id, \"cycle_thinking_level\", null);\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"cycle_thinking_level\", { level });\n\t\t}\n\n\t\t// =================================================================\n\t\t// Queue Modes\n\t\t// =================================================================\n\n\t\tcase \"set_steering_mode\": {\n\t\t\tsession.setSteeringMode(command.mode);\n\t\t\treturn createRpcSuccessResponse(id, \"set_steering_mode\");\n\t\t}\n\n\t\tcase \"set_follow_up_mode\": {\n\t\t\tsession.setFollowUpMode(command.mode);\n\t\t\treturn createRpcSuccessResponse(id, \"set_follow_up_mode\");\n\t\t}\n\n\t\t// =================================================================\n\t\t// Compaction\n\t\t// =================================================================\n\n\t\tcase \"compact\": {\n\t\t\tconst result = await runContextCompactHostAction(\n\t\t\t\tcontext.createHostActionContext(),\n\t\t\t\tcommand.customInstructions,\n\t\t\t);\n\t\t\treturn createRpcSuccessResponse(id, \"compact\", result);\n\t\t}\n\n\t\tcase \"set_auto_compaction\": {\n\t\t\tsession.setAutoCompactionEnabled(command.enabled);\n\t\t\treturn createRpcSuccessResponse(id, \"set_auto_compaction\");\n\t\t}\n\n\t\t// =================================================================\n\t\t// Retry\n\t\t// =================================================================\n\n\t\tcase \"set_auto_retry\": {\n\t\t\tsession.setAutoRetryEnabled(command.enabled);\n\t\t\treturn createRpcSuccessResponse(id, \"set_auto_retry\");\n\t\t}\n\n\t\tcase \"abort_retry\": {\n\t\t\tsession.abortRetry();\n\t\t\treturn createRpcSuccessResponse(id, \"abort_retry\");\n\t\t}\n\n\t\t// =================================================================\n\t\t// Bash\n\t\t// =================================================================\n\n\t\tcase \"bash\": {\n\t\t\tconst result = await session.executeBash(command.command, undefined, {\n\t\t\t\texcludeFromContext: command.excludeFromContext,\n\t\t\t});\n\t\t\treturn createRpcSuccessResponse(id, \"bash\", result);\n\t\t}\n\n\t\tcase \"abort_bash\": {\n\t\t\tsession.abortBash();\n\t\t\treturn createRpcSuccessResponse(id, \"abort_bash\");\n\t\t}\n\n\t\t// =================================================================\n\t\t// Session\n\t\t// =================================================================\n\n\t\tcase \"get_session_stats\": {\n\t\t\tconst stats = session.getSessionStats();\n\t\t\treturn createRpcSuccessResponse(id, \"get_session_stats\", stats);\n\t\t}\n\n\t\tcase \"list_sessions\": {\n\t\t\tconst sessions: RpcSessionListItem[] = await runtimeHost.listSessions();\n\t\t\treturn createRpcSuccessResponse(id, \"list_sessions\", { sessions });\n\t\t}\n\n\t\tcase \"export_html\": {\n\t\t\tconst path = await session.exportToHtml(command.outputPath);\n\t\t\treturn createRpcSuccessResponse(id, \"export_html\", { path });\n\t\t}\n\n\t\tcase \"switch_session\": {\n\t\t\tconst result = await runtimeHost.switchSession(command.sessionPath);\n\t\t\tif (!result.cancelled) {\n\t\t\t\tawait context.rebindSession();\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"switch_session\", result);\n\t\t}\n\n\t\tcase \"switch_session_by_id\": {\n\t\t\tconst result = await runtimeHost.switchSessionById(command.sessionId);\n\t\t\tif (!result.cancelled) {\n\t\t\t\tawait context.rebindSession();\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"switch_session_by_id\", result);\n\t\t}\n\n\t\tcase \"fork\": {\n\t\t\tconst result = await runtimeHost.fork(command.entryId);\n\t\t\tif (!result.cancelled) {\n\t\t\t\tawait context.rebindSession();\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"fork\", { text: result.selectedText, cancelled: result.cancelled });\n\t\t}\n\n\t\tcase \"clone\": {\n\t\t\tconst leafId = session.sessionManager.getLeafId();\n\t\t\tif (!leafId) {\n\t\t\t\treturn createRpcErrorResponse(id, \"clone\", \"Cannot clone session: no current entry selected\");\n\t\t\t}\n\t\t\tconst result = await runtimeHost.fork(leafId, { position: \"at\" });\n\t\t\tif (!result.cancelled) {\n\t\t\t\tawait context.rebindSession();\n\t\t\t}\n\t\t\treturn createRpcSuccessResponse(id, \"clone\", { cancelled: result.cancelled });\n\t\t}\n\n\t\tcase \"get_fork_messages\": {\n\t\t\tconst messages = session.getUserMessagesForForking();\n\t\t\treturn createRpcSuccessResponse(id, \"get_fork_messages\", { messages });\n\t\t}\n\n\t\tcase \"get_last_assistant_text\": {\n\t\t\tconst text = session.getLastAssistantText();\n\t\t\treturn createRpcSuccessResponse(id, \"get_last_assistant_text\", { text });\n\t\t}\n\n\t\tcase \"set_session_name\": {\n\t\t\trunSessionRenameHostAction(context.createHostActionContext(), command.name);\n\t\t\treturn createRpcSuccessResponse(id, \"set_session_name\");\n\t\t}\n\n\t\t// =================================================================\n\t\t// Messages\n\t\t// =================================================================\n\n\t\tcase \"get_messages\": {\n\t\t\treturn createRpcSuccessResponse(id, \"get_messages\", { messages: session.messages });\n\t\t}\n\n\t\t// =================================================================\n\t\t// Commands (available for invocation via prompt)\n\t\t// =================================================================\n\n\t\tcase \"get_commands\": {\n\t\t\tconst commands: RpcSlashCommand[] = [];\n\n\t\t\tfor (const command of session.extensionRunner.getRegisteredCommands()) {\n\t\t\t\tcommands.push({\n\t\t\t\t\tname: command.invocationName,\n\t\t\t\t\tdescription: command.description,\n\t\t\t\t\tsource: \"extension\",\n\t\t\t\t\tsourceInfo: command.sourceInfo,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tfor (const template of session.promptTemplates) {\n\t\t\t\tcommands.push({\n\t\t\t\t\tname: template.name,\n\t\t\t\t\tdescription: template.description,\n\t\t\t\t\tsource: \"prompt\",\n\t\t\t\t\tsourceInfo: template.sourceInfo,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tfor (const skill of session.resourceLoader.getSkills().skills) {\n\t\t\t\tcommands.push({\n\t\t\t\t\tname: `skill:${skill.name}`,\n\t\t\t\t\tdescription: skill.description,\n\t\t\t\t\tsource: \"skill\",\n\t\t\t\t\tsourceInfo: skill.sourceInfo,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\treturn createRpcSuccessResponse(id, \"get_commands\", { commands });\n\t\t}\n\n\t\tdefault: {\n\t\t\tconst target = getRpcErrorResponseTarget(command);\n\t\t\treturn createRpcErrorResponse(target.id, target.command, `Unknown command: ${target.command}`);\n\t\t}\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}