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

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

@@ -0,0 +1,63 @@
+import { createLoopbackRpcTransportPair } from "../../core/rpc/index.js";
+import { runRpcMode } from "./rpc-mode.js";
+import { RpcTransportClient } from "./rpc-transport-client.js";
+/**
+ * RPC client backed by runRpcMode in the same Node.js process.
+ *
+ * stop() closes the client transport and waits for RPC mode shutdown. By default
+ * shutdown also disposes the supplied AgentSessionRuntime.
+ */
+export class InProcessRpcClient extends RpcTransportClient {
+    modeClosed;
+    modeReady;
+    constructor(options) {
+        const pair = createLoopbackRpcTransportPair();
+        super({ transport: pair.client, requestTimeoutMs: options.requestTimeoutMs });
+        const initialEventListener = options.onEvent;
+        if (initialEventListener) {
+            this.onEvent((event) => {
+                initialEventListener(event, this);
+            });
+        }
+        let readySettled = false;
+        let resolveReady = () => { };
+        let rejectReady = () => { };
+        this.modeReady = new Promise((resolve, reject) => {
+            resolveReady = () => {
+                readySettled = true;
+                resolve();
+            };
+            rejectReady = (error) => {
+                readySettled = true;
+                reject(error);
+            };
+        });
+        void this.modeReady.catch(() => { });
+        this.modeClosed = runRpcMode(options.runtimeHost, {
+            transport: pair.server,
+            disposeRuntimeOnClose: options.disposeRuntimeOnClose,
+            exitProcess: false,
+            onReady: resolveReady,
+        });
+        void this.modeClosed.catch((error) => {
+            if (!readySettled) {
+                rejectReady(error);
+            }
+            void pair.server.close();
+        });
+    }
+    async start() {
+        await super.start();
+        await this.modeReady;
+    }
+    async stop() {
+        await super.stop();
+        await this.modeClosed;
+    }
+}
+export async function createInProcessRpcClient(runtimeHost, options = {}) {
+    const client = new InProcessRpcClient({ runtimeHost, ...options });
+    await client.start();
+    return client;
+}
+//# sourceMappingURL=in-process-rpc-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-rpc-client.js","sourceRoot":"","sources":["../../../src/modes/rpc/in-process-rpc-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAiB/D;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,kBAAkB;IACxC,UAAU,CAAgB;IAC1B,SAAS,CAAgB;IAE1C,YAAY,OAA6C,EAAE;QAC1D,MAAM,IAAI,GAAG,8BAA8B,EAAE,CAAC;QAC9C,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAE9E,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;QAC7C,IAAI,oBAAoB,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;gBACvB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAAA,CAClC,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,YAAY,GAAe,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC;QACxC,IAAI,WAAW,GAA6B,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YACvD,YAAY,GAAG,GAAG,EAAE,CAAC;gBACpB,YAAY,GAAG,IAAI,CAAC;gBACpB,OAAO,EAAE,CAAC;YAAA,CACV,CAAC;YACF,WAAW,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;gBACxB,YAAY,GAAG,IAAI,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,CAAC;YAAA,CACd,CAAC;QAAA,CACF,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC;QAEpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE;YACjD,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;YACpD,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,YAAY;SACrB,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;gBACnB,WAAW,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YACD,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAAA,CACzB,CAAC,CAAC;IAAA,CACH;IAED,KAAK,CAAC,KAAK,GAAkB;QAC5B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,SAAS,CAAC;IAAA,CACrB;IAED,KAAK,CAAC,IAAI,GAAkB;QAC3B,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,UAAU,CAAC;IAAA,CACtB;CACD;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,WAAgC,EAChC,OAAO,GAA8B,EAAE,EACT;IAC9B,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAAA,CACd","sourcesContent":["import type { AgentSessionRuntime } from \"../../core/agent-session-runtime.ts\";\nimport { createLoopbackRpcTransportPair } from \"../../core/rpc/index.ts\";\nimport type { RpcClientEvent } from \"./rpc-client-base.ts\";\nimport { runRpcMode } from \"./rpc-mode.ts\";\nimport { RpcTransportClient } from \"./rpc-transport-client.ts\";\n\nexport type InProcessRpcClientEventListener = (event: RpcClientEvent, client: InProcessRpcClient) => void;\n\nexport interface InProcessRpcClientOptions {\n\t/** Milliseconds to wait for a command response. Defaults to 30 seconds. */\n\trequestTimeoutMs?: number;\n\t/** Defaults to true. Set false when another owner retains the runtime after this loopback client stops. */\n\tdisposeRuntimeOnClose?: boolean;\n\t/** Initial event listener registered before startup completes. */\n\tonEvent?: InProcessRpcClientEventListener;\n}\n\ninterface InProcessRpcClientConstructorOptions extends InProcessRpcClientOptions {\n\truntimeHost: AgentSessionRuntime;\n}\n\n/**\n * RPC client backed by runRpcMode in the same Node.js process.\n *\n * stop() closes the client transport and waits for RPC mode shutdown. By default\n * shutdown also disposes the supplied AgentSessionRuntime.\n */\nexport class InProcessRpcClient extends RpcTransportClient {\n\tprivate readonly modeClosed: Promise<void>;\n\tprivate readonly modeReady: Promise<void>;\n\n\tconstructor(options: InProcessRpcClientConstructorOptions) {\n\t\tconst pair = createLoopbackRpcTransportPair();\n\t\tsuper({ transport: pair.client, requestTimeoutMs: options.requestTimeoutMs });\n\n\t\tconst initialEventListener = options.onEvent;\n\t\tif (initialEventListener) {\n\t\t\tthis.onEvent((event) => {\n\t\t\t\tinitialEventListener(event, this);\n\t\t\t});\n\t\t}\n\n\t\tlet readySettled = false;\n\t\tlet resolveReady: () => void = () => {};\n\t\tlet rejectReady: (error: unknown) => void = () => {};\n\t\tthis.modeReady = new Promise<void>((resolve, reject) => {\n\t\t\tresolveReady = () => {\n\t\t\t\treadySettled = true;\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\trejectReady = (error) => {\n\t\t\t\treadySettled = true;\n\t\t\t\treject(error);\n\t\t\t};\n\t\t});\n\t\tvoid this.modeReady.catch(() => {});\n\n\t\tthis.modeClosed = runRpcMode(options.runtimeHost, {\n\t\t\ttransport: pair.server,\n\t\t\tdisposeRuntimeOnClose: options.disposeRuntimeOnClose,\n\t\t\texitProcess: false,\n\t\t\tonReady: resolveReady,\n\t\t});\n\t\tvoid this.modeClosed.catch((error: unknown) => {\n\t\t\tif (!readySettled) {\n\t\t\t\trejectReady(error);\n\t\t\t}\n\t\t\tvoid pair.server.close();\n\t\t});\n\t}\n\n\tasync start(): Promise<void> {\n\t\tawait super.start();\n\t\tawait this.modeReady;\n\t}\n\n\tasync stop(): Promise<void> {\n\t\tawait super.stop();\n\t\tawait this.modeClosed;\n\t}\n}\n\nexport async function createInProcessRpcClient(\n\truntimeHost: AgentSessionRuntime,\n\toptions: InProcessRpcClientOptions = {},\n): Promise<InProcessRpcClient> {\n\tconst client = new InProcessRpcClient({ runtimeHost, ...options });\n\tawait client.start();\n\treturn client;\n}\n"]}

package/dist/modes/rpc/iroh-remote-agent-runtime.d.ts

@@ -0,0 +1,61 @@
+import { type AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
+import { type IrohRemoteRuntimeToolPolicy } from "../../core/remote/iroh/index.ts";
+import { type SessionManager } from "../../core/session-manager.ts";
+import { type SubagentRuntimeCreatedEvent } from "../../core/subagents/index.ts";
+import { type ResolvedSessionTargetWithManager } from "../../daemon/session-target.ts";
+export interface IrohRemoteAgentRuntimeOptions {
+    /** Legacy unresolved grant used by direct callers. Daemon runtimes pass toolPolicy instead. */
+    allowTools?: string;
+    /** Pre-composed client/workspace/daemon policy. Preserves an explicit deny-all. */
+    toolPolicy?: IrohRemoteRuntimeToolPolicy;
+    agentDir?: string;
+    conversationTarget?: IrohRemoteAgentRuntimeConversationTarget;
+    /** Runtime working directory for tools/session state. */
+    cwd: string;
+    /** Project/config root for .volt resources. Defaults to cwd. */
+    projectCwd?: string;
+    onSubagentRuntimeCreated?: (event: IrohRemoteSubagentRuntimeCreatedEvent) => void | Promise<void>;
+    profile?: string;
+    projectTrusted?: boolean;
+    /** Pre-resolved session target (daemon path); skips internal target resolution. */
+    resolvedSessionTarget?: ResolvedSessionTargetWithManager<SessionManager>;
+    resumeSessionId?: string;
+    sessionDir?: string;
+    /** Validate the resolved session cwd before services/tools are created. */
+    validateCwd?: (cwd: string) => Promise<void> | void;
+}
+export interface IrohRemoteSubagentRuntimeCreatedEvent extends SubagentRuntimeCreatedEvent {
+    parentSessionId: string;
+    parentSessionFile?: string;
+}
+export type IrohRemoteAgentRuntimeConversationTarget = {
+    target: "last";
+    resumeSessionId?: string;
+} | {
+    target: "new";
+} | {
+    target: "session";
+    sessionId: string;
+};
+export type IrohRemoteAgentRuntimeSessionSelection = {
+    kind: "created";
+    sessionFile?: string;
+    sessionId: string;
+} | {
+    kind: "created_after_missing";
+    requestedSessionId: string;
+    sessionFile?: string;
+    sessionId: string;
+} | {
+    kind: "resumed";
+    requestedSessionId: string;
+    sessionFile?: string;
+    sessionId: string;
+};
+export interface IrohRemoteAgentRuntimeResult {
+    runtime: AgentSessionRuntime;
+    sessionSelection: IrohRemoteAgentRuntimeSessionSelection;
+}
+export declare function createIrohRemoteAgentRuntime(options: IrohRemoteAgentRuntimeOptions): Promise<AgentSessionRuntime>;
+export declare function createIrohRemoteAgentRuntimeWithSessionSelection(options: IrohRemoteAgentRuntimeOptions): Promise<IrohRemoteAgentRuntimeResult>;
+//# sourceMappingURL=iroh-remote-agent-runtime.d.ts.map

package/dist/modes/rpc/iroh-remote-agent-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iroh-remote-agent-runtime.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/iroh-remote-agent-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,mBAAmB,EAGxB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EACN,KAAK,2BAA2B,EAGhC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE1F,OAAO,EAAmB,KAAK,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAGN,KAAK,gCAAgC,EAErC,MAAM,gCAAgC,CAAC;AAIxC,MAAM,WAAW,6BAA6B;IAC7C,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,wCAAwC,CAAC;IAC9D,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,gCAAgC,CAAC,cAAc,CAAC,CAAC;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,qCAAsC,SAAQ,2BAA2B;IACzF,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,wCAAwC,GACjD;IACA,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CACxB,GACD;IACA,MAAM,EAAE,KAAK,CAAC;CACb,GACD;IACA,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACjB,CAAC;AAEL,MAAM,MAAM,sCAAsC,GAC/C;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACjB,GACD;IACA,IAAI,EAAE,uBAAuB,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACjB,GACD;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACjB,CAAC;AAEL,MAAM,WAAW,4BAA4B;IAC5C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,EAAE,sCAAsC,CAAC;CACzD;AAED,wBAAsB,4BAA4B,CACjD,OAAO,EAAE,6BAA6B,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED,wBAAsB,gDAAgD,CACrE,OAAO,EAAE,6BAA6B,GACpC,OAAO,CAAC,4BAA4B,CAAC,CA6EvC","sourcesContent":["import { join } from \"node:path\";\nimport { ENV_AGENT_DIR, getAgentDir } from \"../../config.ts\";\nimport {\n\ttype AgentSessionRuntime,\n\ttype CreateAgentSessionRuntimeFactory,\n\tcreateAgentSessionRuntime,\n} from \"../../core/agent-session-runtime.ts\";\nimport { createAgentSessionFromServices, createAgentSessionServices } from \"../../core/agent-session-services.ts\";\nimport { formatNoModelsAvailableMessage } from \"../../core/auth-guidance.ts\";\nimport { AuthStorage } from \"../../core/auth-storage.ts\";\nimport { applyHttpProxySettings, configureHttpDispatcher } from \"../../core/http-dispatcher.ts\";\nimport {\n\ttype IrohRemoteRuntimeToolPolicy,\n\tparseIrohRemoteAllowTools,\n\tusesDefaultIrohRemoteAllowTools,\n} from \"../../core/remote/iroh/index.ts\";\nimport { getDefaultSessionDir, type SessionManager } from \"../../core/session-manager.ts\";\nimport { SettingsManager } from \"../../core/settings-manager.ts\";\nimport { SubagentManager, type SubagentRuntimeCreatedEvent } from \"../../core/subagents/index.ts\";\nimport {\n\tcreateSessionManagerTargetStore,\n\ttype IrohRemoteSessionTarget,\n\ttype ResolvedSessionTargetWithManager,\n\tresolveIrohRemoteSessionTarget,\n} from \"../../daemon/session-target.ts\";\nimport { runMigrations } from \"../../migrations.ts\";\nimport { resolvePath } from \"../../utils/paths.ts\";\n\nexport interface IrohRemoteAgentRuntimeOptions {\n\t/** Legacy unresolved grant used by direct callers. Daemon runtimes pass toolPolicy instead. */\n\tallowTools?: string;\n\t/** Pre-composed client/workspace/daemon policy. Preserves an explicit deny-all. */\n\ttoolPolicy?: IrohRemoteRuntimeToolPolicy;\n\tagentDir?: string;\n\tconversationTarget?: IrohRemoteAgentRuntimeConversationTarget;\n\t/** Runtime working directory for tools/session state. */\n\tcwd: string;\n\t/** Project/config root for .volt resources. Defaults to cwd. */\n\tprojectCwd?: string;\n\tonSubagentRuntimeCreated?: (event: IrohRemoteSubagentRuntimeCreatedEvent) => void | Promise<void>;\n\tprofile?: string;\n\tprojectTrusted?: boolean;\n\t/** Pre-resolved session target (daemon path); skips internal target resolution. */\n\tresolvedSessionTarget?: ResolvedSessionTargetWithManager<SessionManager>;\n\tresumeSessionId?: string;\n\tsessionDir?: string;\n\t/** Validate the resolved session cwd before services/tools are created. */\n\tvalidateCwd?: (cwd: string) => Promise<void> | void;\n}\n\nexport interface IrohRemoteSubagentRuntimeCreatedEvent extends SubagentRuntimeCreatedEvent {\n\tparentSessionId: string;\n\tparentSessionFile?: string;\n}\n\nexport type IrohRemoteAgentRuntimeConversationTarget =\n\t| {\n\t\t\ttarget: \"last\";\n\t\t\tresumeSessionId?: string;\n\t  }\n\t| {\n\t\t\ttarget: \"new\";\n\t  }\n\t| {\n\t\t\ttarget: \"session\";\n\t\t\tsessionId: string;\n\t  };\n\nexport type IrohRemoteAgentRuntimeSessionSelection =\n\t| {\n\t\t\tkind: \"created\";\n\t\t\tsessionFile?: string;\n\t\t\tsessionId: string;\n\t  }\n\t| {\n\t\t\tkind: \"created_after_missing\";\n\t\t\trequestedSessionId: string;\n\t\t\tsessionFile?: string;\n\t\t\tsessionId: string;\n\t  }\n\t| {\n\t\t\tkind: \"resumed\";\n\t\t\trequestedSessionId: string;\n\t\t\tsessionFile?: string;\n\t\t\tsessionId: string;\n\t  };\n\nexport interface IrohRemoteAgentRuntimeResult {\n\truntime: AgentSessionRuntime;\n\tsessionSelection: IrohRemoteAgentRuntimeSessionSelection;\n}\n\nexport async function createIrohRemoteAgentRuntime(\n\toptions: IrohRemoteAgentRuntimeOptions,\n): Promise<AgentSessionRuntime> {\n\treturn (await createIrohRemoteAgentRuntimeWithSessionSelection(options)).runtime;\n}\n\nexport async function createIrohRemoteAgentRuntimeWithSessionSelection(\n\toptions: IrohRemoteAgentRuntimeOptions,\n): Promise<IrohRemoteAgentRuntimeResult> {\n\tconst agentDir = resolvePath(options.agentDir ?? getAgentDir());\n\tconst projectCwd = resolvePath(options.projectCwd ?? options.cwd);\n\trunIrohRemoteStartupMigrations(projectCwd, agentDir);\n\tconst authStorage = AuthStorage.create(join(agentDir, \"auth.json\"));\n\tconst tools = options.toolPolicy ? [...options.toolPolicy.tools] : parseIrohRemoteAllowTools(options.allowTools);\n\tconst allowUnlistedExtensionTools =\n\t\toptions.toolPolicy?.allowUnlistedExtensionTools ?? usesDefaultIrohRemoteAllowTools(options.allowTools);\n\tconst projectTrusted = options.projectTrusted ?? false;\n\n\tconst createRuntime: CreateAgentSessionRuntimeFactory = async (runtimeOptions) => {\n\t\tconst profile = Object.hasOwn(runtimeOptions, \"profile\") ? runtimeOptions.profile : options.profile;\n\t\tconst settingsManager = SettingsManager.create(projectCwd, runtimeOptions.agentDir, {\n\t\t\tprofile,\n\t\t\tprojectTrusted,\n\t\t});\n\t\tapplyHttpProxySettings(settingsManager.getGlobalSettings().httpProxy);\n\t\tconfigureHttpDispatcher(settingsManager.getHttpIdleTimeoutMs());\n\t\tconst services = await createAgentSessionServices({\n\t\t\tauthStorage,\n\t\t\tcwd: runtimeOptions.cwd,\n\t\t\tprojectCwd,\n\t\t\tagentDir: runtimeOptions.agentDir,\n\t\t\tsettingsManager,\n\t\t});\n\t\tconst subagentManager = new SubagentManager({\n\t\t\tcreateRuntime,\n\t\t\tcwd: runtimeOptions.cwd,\n\t\t\tagentDir: runtimeOptions.agentDir,\n\t\t\tresourceLoader: services.resourceLoader,\n\t\t\tparentSessionManager: runtimeOptions.sessionManager,\n\t\t\t...(runtimeOptions.subagentContext ? { subagentContext: runtimeOptions.subagentContext } : {}),\n\t\t\tretainRuntimeOnDispose: options.onSubagentRuntimeCreated !== undefined,\n\t\t\tonRuntimeCreated: options.onSubagentRuntimeCreated\n\t\t\t\t? (event) =>\n\t\t\t\t\t\toptions.onSubagentRuntimeCreated?.({\n\t\t\t\t\t\t\t...event,\n\t\t\t\t\t\t\tparentSessionId: runtimeOptions.sessionManager.getSessionId(),\n\t\t\t\t\t\t\t...(runtimeOptions.sessionManager.getSessionFile()\n\t\t\t\t\t\t\t\t? { parentSessionFile: runtimeOptions.sessionManager.getSessionFile() }\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t})\n\t\t\t\t: undefined,\n\t\t});\n\t\tconst created = await createAgentSessionFromServices({\n\t\t\tservices,\n\t\t\tsessionManager: runtimeOptions.sessionManager,\n\t\t\tsessionStartEvent: runtimeOptions.sessionStartEvent,\n\t\t\ttools,\n\t\t\tallowUnlistedExtensionTools,\n\t\t\tsubagentToolManager: subagentManager,\n\t\t});\n\t\treturn {\n\t\t\t...created,\n\t\t\tservices,\n\t\t\tdiagnostics: services.diagnostics,\n\t\t};\n\t};\n\n\tconst sessionTarget = await createIrohRemoteSessionManager(options, agentDir);\n\tawait options.validateCwd?.(sessionTarget.sessionManager.getCwd());\n\tconst runtime = await createAgentSessionRuntime(createRuntime, {\n\t\tcwd: sessionTarget.sessionManager.getCwd(),\n\t\tagentDir,\n\t\tsessionManager: sessionTarget.sessionManager,\n\t\tprofile: options.profile,\n\t});\n\tconst errors = runtime.diagnostics.filter((diagnostic) => diagnostic.type === \"error\");\n\tif (errors.length > 0) {\n\t\tawait runtime.dispose();\n\t\tthrow new Error(errors.map((diagnostic) => diagnostic.message).join(\"\\n\"));\n\t}\n\tif (!runtime.session.model) {\n\t\tawait runtime.dispose();\n\t\tthrow new Error(formatNoModelsAvailableMessage());\n\t}\n\treturn { runtime, sessionSelection: sessionTarget.selection };\n}\n\nasync function createIrohRemoteSessionManager(\n\toptions: IrohRemoteAgentRuntimeOptions,\n\tagentDir: string,\n): Promise<{ sessionManager: SessionManager; selection: IrohRemoteAgentRuntimeSessionSelection }> {\n\tconst resolved =\n\t\toptions.resolvedSessionTarget ??\n\t\t(await resolveIrohRemoteSessionTarget(\n\t\t\tgetSessionTarget(options),\n\t\t\t{ name: \"\", path: options.cwd },\n\t\t\tcreateSessionManagerTargetStore(\n\t\t\t\toptions.cwd,\n\t\t\t\toptions.sessionDir ?? getDefaultSessionDir(options.projectCwd ?? options.cwd, agentDir),\n\t\t\t\t{ listAll: true, preserveSessionCwd: true },\n\t\t\t),\n\t\t));\n\treturn {\n\t\tsessionManager: resolved.sessionManager,\n\t\tselection: toSessionSelection(resolved),\n\t};\n}\n\nfunction toSessionSelection(\n\tresolved: ResolvedSessionTargetWithManager<SessionManager>,\n): IrohRemoteAgentRuntimeSessionSelection {\n\tconst sessionFile = resolved.sessionManager.getSessionFile();\n\tif (resolved.selection === \"created\") {\n\t\treturn {\n\t\t\tkind: \"created\",\n\t\t\tsessionFile,\n\t\t\tsessionId: resolved.sessionId,\n\t\t};\n\t}\n\treturn {\n\t\tkind: resolved.selection,\n\t\trequestedSessionId: resolved.requestedSessionId ?? resolved.sessionId,\n\t\tsessionFile,\n\t\tsessionId: resolved.sessionId,\n\t};\n}\n\nfunction getSessionTarget(options: IrohRemoteAgentRuntimeOptions): IrohRemoteSessionTarget {\n\tconst target = getConversationTarget(options);\n\tif (target.target === \"last\") {\n\t\treturn target.resumeSessionId === undefined\n\t\t\t? { kind: \"last\" }\n\t\t\t: { kind: \"last\", resumeSessionId: target.resumeSessionId };\n\t}\n\tif (target.target === \"session\") {\n\t\treturn { kind: \"session\", sessionId: target.sessionId };\n\t}\n\treturn { kind: \"new\" };\n}\n\nfunction getConversationTarget(options: IrohRemoteAgentRuntimeOptions): IrohRemoteAgentRuntimeConversationTarget {\n\tif (options.conversationTarget !== undefined) {\n\t\treturn options.conversationTarget;\n\t}\n\tif (options.resumeSessionId !== undefined) {\n\t\treturn { target: \"last\", resumeSessionId: options.resumeSessionId };\n\t}\n\treturn { target: \"new\" };\n}\n\nfunction runIrohRemoteStartupMigrations(cwd: string, agentDir: string): void {\n\tconst previousAgentDir = process.env[ENV_AGENT_DIR];\n\tconst previousLog = console.log;\n\ttry {\n\t\tprocess.env[ENV_AGENT_DIR] = agentDir;\n\t\tconsole.log = (...data: Parameters<typeof console.log>) => console.error(...data);\n\t\trunMigrations(cwd);\n\t} finally {\n\t\tconsole.log = previousLog;\n\t\tif (previousAgentDir === undefined) {\n\t\t\tdelete process.env[ENV_AGENT_DIR];\n\t\t} else {\n\t\t\tprocess.env[ENV_AGENT_DIR] = previousAgentDir;\n\t\t}\n\t}\n}\n"]}

package/dist/modes/rpc/iroh-remote-agent-runtime.js

@@ -0,0 +1,155 @@
+import { join } from "node:path";
+import { ENV_AGENT_DIR, getAgentDir } from "../../config.js";
+import { createAgentSessionRuntime, } from "../../core/agent-session-runtime.js";
+import { createAgentSessionFromServices, createAgentSessionServices } from "../../core/agent-session-services.js";
+import { formatNoModelsAvailableMessage } from "../../core/auth-guidance.js";
+import { AuthStorage } from "../../core/auth-storage.js";
+import { applyHttpProxySettings, configureHttpDispatcher } from "../../core/http-dispatcher.js";
+import { parseIrohRemoteAllowTools, usesDefaultIrohRemoteAllowTools, } from "../../core/remote/iroh/index.js";
+import { getDefaultSessionDir } from "../../core/session-manager.js";
+import { SettingsManager } from "../../core/settings-manager.js";
+import { SubagentManager } from "../../core/subagents/index.js";
+import { createSessionManagerTargetStore, resolveIrohRemoteSessionTarget, } from "../../daemon/session-target.js";
+import { runMigrations } from "../../migrations.js";
+import { resolvePath } from "../../utils/paths.js";
+export async function createIrohRemoteAgentRuntime(options) {
+    return (await createIrohRemoteAgentRuntimeWithSessionSelection(options)).runtime;
+}
+export async function createIrohRemoteAgentRuntimeWithSessionSelection(options) {
+    const agentDir = resolvePath(options.agentDir ?? getAgentDir());
+    const projectCwd = resolvePath(options.projectCwd ?? options.cwd);
+    runIrohRemoteStartupMigrations(projectCwd, agentDir);
+    const authStorage = AuthStorage.create(join(agentDir, "auth.json"));
+    const tools = options.toolPolicy ? [...options.toolPolicy.tools] : parseIrohRemoteAllowTools(options.allowTools);
+    const allowUnlistedExtensionTools = options.toolPolicy?.allowUnlistedExtensionTools ?? usesDefaultIrohRemoteAllowTools(options.allowTools);
+    const projectTrusted = options.projectTrusted ?? false;
+    const createRuntime = async (runtimeOptions) => {
+        const profile = Object.hasOwn(runtimeOptions, "profile") ? runtimeOptions.profile : options.profile;
+        const settingsManager = SettingsManager.create(projectCwd, runtimeOptions.agentDir, {
+            profile,
+            projectTrusted,
+        });
+        applyHttpProxySettings(settingsManager.getGlobalSettings().httpProxy);
+        configureHttpDispatcher(settingsManager.getHttpIdleTimeoutMs());
+        const services = await createAgentSessionServices({
+            authStorage,
+            cwd: runtimeOptions.cwd,
+            projectCwd,
+            agentDir: runtimeOptions.agentDir,
+            settingsManager,
+        });
+        const subagentManager = new SubagentManager({
+            createRuntime,
+            cwd: runtimeOptions.cwd,
+            agentDir: runtimeOptions.agentDir,
+            resourceLoader: services.resourceLoader,
+            parentSessionManager: runtimeOptions.sessionManager,
+            ...(runtimeOptions.subagentContext ? { subagentContext: runtimeOptions.subagentContext } : {}),
+            retainRuntimeOnDispose: options.onSubagentRuntimeCreated !== undefined,
+            onRuntimeCreated: options.onSubagentRuntimeCreated
+                ? (event) => options.onSubagentRuntimeCreated?.({
+                    ...event,
+                    parentSessionId: runtimeOptions.sessionManager.getSessionId(),
+                    ...(runtimeOptions.sessionManager.getSessionFile()
+                        ? { parentSessionFile: runtimeOptions.sessionManager.getSessionFile() }
+                        : {}),
+                })
+                : undefined,
+        });
+        const created = await createAgentSessionFromServices({
+            services,
+            sessionManager: runtimeOptions.sessionManager,
+            sessionStartEvent: runtimeOptions.sessionStartEvent,
+            tools,
+            allowUnlistedExtensionTools,
+            subagentToolManager: subagentManager,
+        });
+        return {
+            ...created,
+            services,
+            diagnostics: services.diagnostics,
+        };
+    };
+    const sessionTarget = await createIrohRemoteSessionManager(options, agentDir);
+    await options.validateCwd?.(sessionTarget.sessionManager.getCwd());
+    const runtime = await createAgentSessionRuntime(createRuntime, {
+        cwd: sessionTarget.sessionManager.getCwd(),
+        agentDir,
+        sessionManager: sessionTarget.sessionManager,
+        profile: options.profile,
+    });
+    const errors = runtime.diagnostics.filter((diagnostic) => diagnostic.type === "error");
+    if (errors.length > 0) {
+        await runtime.dispose();
+        throw new Error(errors.map((diagnostic) => diagnostic.message).join("\n"));
+    }
+    if (!runtime.session.model) {
+        await runtime.dispose();
+        throw new Error(formatNoModelsAvailableMessage());
+    }
+    return { runtime, sessionSelection: sessionTarget.selection };
+}
+async function createIrohRemoteSessionManager(options, agentDir) {
+    const resolved = options.resolvedSessionTarget ??
+        (await resolveIrohRemoteSessionTarget(getSessionTarget(options), { name: "", path: options.cwd }, createSessionManagerTargetStore(options.cwd, options.sessionDir ?? getDefaultSessionDir(options.projectCwd ?? options.cwd, agentDir), { listAll: true, preserveSessionCwd: true })));
+    return {
+        sessionManager: resolved.sessionManager,
+        selection: toSessionSelection(resolved),
+    };
+}
+function toSessionSelection(resolved) {
+    const sessionFile = resolved.sessionManager.getSessionFile();
+    if (resolved.selection === "created") {
+        return {
+            kind: "created",
+            sessionFile,
+            sessionId: resolved.sessionId,
+        };
+    }
+    return {
+        kind: resolved.selection,
+        requestedSessionId: resolved.requestedSessionId ?? resolved.sessionId,
+        sessionFile,
+        sessionId: resolved.sessionId,
+    };
+}
+function getSessionTarget(options) {
+    const target = getConversationTarget(options);
+    if (target.target === "last") {
+        return target.resumeSessionId === undefined
+            ? { kind: "last" }
+            : { kind: "last", resumeSessionId: target.resumeSessionId };
+    }
+    if (target.target === "session") {
+        return { kind: "session", sessionId: target.sessionId };
+    }
+    return { kind: "new" };
+}
+function getConversationTarget(options) {
+    if (options.conversationTarget !== undefined) {
+        return options.conversationTarget;
+    }
+    if (options.resumeSessionId !== undefined) {
+        return { target: "last", resumeSessionId: options.resumeSessionId };
+    }
+    return { target: "new" };
+}
+function runIrohRemoteStartupMigrations(cwd, agentDir) {
+    const previousAgentDir = process.env[ENV_AGENT_DIR];
+    const previousLog = console.log;
+    try {
+        process.env[ENV_AGENT_DIR] = agentDir;
+        console.log = (...data) => console.error(...data);
+        runMigrations(cwd);
+    }
+    finally {
+        console.log = previousLog;
+        if (previousAgentDir === undefined) {
+            delete process.env[ENV_AGENT_DIR];
+        }
+        else {
+            process.env[ENV_AGENT_DIR] = previousAgentDir;
+        }
+    }
+}
+//# sourceMappingURL=iroh-remote-agent-runtime.js.map

package/dist/modes/rpc/iroh-remote-agent-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iroh-remote-agent-runtime.js","sourceRoot":"","sources":["../../../src/modes/rpc/iroh-remote-agent-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { ENV_AGENT_DIR, getAgentDir } from \"../../config.ts\";\nimport {\n\ttype AgentSessionRuntime,\n\ttype CreateAgentSessionRuntimeFactory,\n\tcreateAgentSessionRuntime,\n} from \"../../core/agent-session-runtime.ts\";\nimport { createAgentSessionFromServices, createAgentSessionServices } from \"../../core/agent-session-services.ts\";\nimport { formatNoModelsAvailableMessage } from \"../../core/auth-guidance.ts\";\nimport { AuthStorage } from \"../../core/auth-storage.ts\";\nimport { applyHttpProxySettings, configureHttpDispatcher } from \"../../core/http-dispatcher.ts\";\nimport {\n\ttype IrohRemoteRuntimeToolPolicy,\n\tparseIrohRemoteAllowTools,\n\tusesDefaultIrohRemoteAllowTools,\n} from \"../../core/remote/iroh/index.ts\";\nimport { getDefaultSessionDir, type SessionManager } from \"../../core/session-manager.ts\";\nimport { SettingsManager } from \"../../core/settings-manager.ts\";\nimport { SubagentManager, type SubagentRuntimeCreatedEvent } from \"../../core/subagents/index.ts\";\nimport {\n\tcreateSessionManagerTargetStore,\n\ttype IrohRemoteSessionTarget,\n\ttype ResolvedSessionTargetWithManager,\n\tresolveIrohRemoteSessionTarget,\n} from \"../../daemon/session-target.ts\";\nimport { runMigrations } from \"../../migrations.ts\";\nimport { resolvePath } from \"../../utils/paths.ts\";\n\nexport interface IrohRemoteAgentRuntimeOptions {\n\t/** Legacy unresolved grant used by direct callers. Daemon runtimes pass toolPolicy instead. */\n\tallowTools?: string;\n\t/** Pre-composed client/workspace/daemon policy. Preserves an explicit deny-all. */\n\ttoolPolicy?: IrohRemoteRuntimeToolPolicy;\n\tagentDir?: string;\n\tconversationTarget?: IrohRemoteAgentRuntimeConversationTarget;\n\t/** Runtime working directory for tools/session state. */\n\tcwd: string;\n\t/** Project/config root for .volt resources. Defaults to cwd. */\n\tprojectCwd?: string;\n\tonSubagentRuntimeCreated?: (event: IrohRemoteSubagentRuntimeCreatedEvent) => void | Promise<void>;\n\tprofile?: string;\n\tprojectTrusted?: boolean;\n\t/** Pre-resolved session target (daemon path); skips internal target resolution. */\n\tresolvedSessionTarget?: ResolvedSessionTargetWithManager<SessionManager>;\n\tresumeSessionId?: string;\n\tsessionDir?: string;\n\t/** Validate the resolved session cwd before services/tools are created. */\n\tvalidateCwd?: (cwd: string) => Promise<void> | void;\n}\n\nexport interface IrohRemoteSubagentRuntimeCreatedEvent extends SubagentRuntimeCreatedEvent {\n\tparentSessionId: string;\n\tparentSessionFile?: string;\n}\n\nexport type IrohRemoteAgentRuntimeConversationTarget =\n\t| {\n\t\t\ttarget: \"last\";\n\t\t\tresumeSessionId?: string;\n\t  }\n\t| {\n\t\t\ttarget: \"new\";\n\t  }\n\t| {\n\t\t\ttarget: \"session\";\n\t\t\tsessionId: string;\n\t  };\n\nexport type IrohRemoteAgentRuntimeSessionSelection =\n\t| {\n\t\t\tkind: \"created\";\n\t\t\tsessionFile?: string;\n\t\t\tsessionId: string;\n\t  }\n\t| {\n\t\t\tkind: \"created_after_missing\";\n\t\t\trequestedSessionId: string;\n\t\t\tsessionFile?: string;\n\t\t\tsessionId: string;\n\t  }\n\t| {\n\t\t\tkind: \"resumed\";\n\t\t\trequestedSessionId: string;\n\t\t\tsessionFile?: string;\n\t\t\tsessionId: string;\n\t  };\n\nexport interface IrohRemoteAgentRuntimeResult {\n\truntime: AgentSessionRuntime;\n\tsessionSelection: IrohRemoteAgentRuntimeSessionSelection;\n}\n\nexport async function createIrohRemoteAgentRuntime(\n\toptions: IrohRemoteAgentRuntimeOptions,\n): Promise<AgentSessionRuntime> {\n\treturn (await createIrohRemoteAgentRuntimeWithSessionSelection(options)).runtime;\n}\n\nexport async function createIrohRemoteAgentRuntimeWithSessionSelection(\n\toptions: IrohRemoteAgentRuntimeOptions,\n): Promise<IrohRemoteAgentRuntimeResult> {\n\tconst agentDir = resolvePath(options.agentDir ?? getAgentDir());\n\tconst projectCwd = resolvePath(options.projectCwd ?? options.cwd);\n\trunIrohRemoteStartupMigrations(projectCwd, agentDir);\n\tconst authStorage = AuthStorage.create(join(agentDir, \"auth.json\"));\n\tconst tools = options.toolPolicy ? [...options.toolPolicy.tools] : parseIrohRemoteAllowTools(options.allowTools);\n\tconst allowUnlistedExtensionTools =\n\t\toptions.toolPolicy?.allowUnlistedExtensionTools ?? usesDefaultIrohRemoteAllowTools(options.allowTools);\n\tconst projectTrusted = options.projectTrusted ?? false;\n\n\tconst createRuntime: CreateAgentSessionRuntimeFactory = async (runtimeOptions) => {\n\t\tconst profile = Object.hasOwn(runtimeOptions, \"profile\") ? runtimeOptions.profile : options.profile;\n\t\tconst settingsManager = SettingsManager.create(projectCwd, runtimeOptions.agentDir, {\n\t\t\tprofile,\n\t\t\tprojectTrusted,\n\t\t});\n\t\tapplyHttpProxySettings(settingsManager.getGlobalSettings().httpProxy);\n\t\tconfigureHttpDispatcher(settingsManager.getHttpIdleTimeoutMs());\n\t\tconst services = await createAgentSessionServices({\n\t\t\tauthStorage,\n\t\t\tcwd: runtimeOptions.cwd,\n\t\t\tprojectCwd,\n\t\t\tagentDir: runtimeOptions.agentDir,\n\t\t\tsettingsManager,\n\t\t});\n\t\tconst subagentManager = new SubagentManager({\n\t\t\tcreateRuntime,\n\t\t\tcwd: runtimeOptions.cwd,\n\t\t\tagentDir: runtimeOptions.agentDir,\n\t\t\tresourceLoader: services.resourceLoader,\n\t\t\tparentSessionManager: runtimeOptions.sessionManager,\n\t\t\t...(runtimeOptions.subagentContext ? { subagentContext: runtimeOptions.subagentContext } : {}),\n\t\t\tretainRuntimeOnDispose: options.onSubagentRuntimeCreated !== undefined,\n\t\t\tonRuntimeCreated: options.onSubagentRuntimeCreated\n\t\t\t\t? (event) =>\n\t\t\t\t\t\toptions.onSubagentRuntimeCreated?.({\n\t\t\t\t\t\t\t...event,\n\t\t\t\t\t\t\tparentSessionId: runtimeOptions.sessionManager.getSessionId(),\n\t\t\t\t\t\t\t...(runtimeOptions.sessionManager.getSessionFile()\n\t\t\t\t\t\t\t\t? { parentSessionFile: runtimeOptions.sessionManager.getSessionFile() }\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t})\n\t\t\t\t: undefined,\n\t\t});\n\t\tconst created = await createAgentSessionFromServices({\n\t\t\tservices,\n\t\t\tsessionManager: runtimeOptions.sessionManager,\n\t\t\tsessionStartEvent: runtimeOptions.sessionStartEvent,\n\t\t\ttools,\n\t\t\tallowUnlistedExtensionTools,\n\t\t\tsubagentToolManager: subagentManager,\n\t\t});\n\t\treturn {\n\t\t\t...created,\n\t\t\tservices,\n\t\t\tdiagnostics: services.diagnostics,\n\t\t};\n\t};\n\n\tconst sessionTarget = await createIrohRemoteSessionManager(options, agentDir);\n\tawait options.validateCwd?.(sessionTarget.sessionManager.getCwd());\n\tconst runtime = await createAgentSessionRuntime(createRuntime, {\n\t\tcwd: sessionTarget.sessionManager.getCwd(),\n\t\tagentDir,\n\t\tsessionManager: sessionTarget.sessionManager,\n\t\tprofile: options.profile,\n\t});\n\tconst errors = runtime.diagnostics.filter((diagnostic) => diagnostic.type === \"error\");\n\tif (errors.length > 0) {\n\t\tawait runtime.dispose();\n\t\tthrow new Error(errors.map((diagnostic) => diagnostic.message).join(\"\\n\"));\n\t}\n\tif (!runtime.session.model) {\n\t\tawait runtime.dispose();\n\t\tthrow new Error(formatNoModelsAvailableMessage());\n\t}\n\treturn { runtime, sessionSelection: sessionTarget.selection };\n}\n\nasync function createIrohRemoteSessionManager(\n\toptions: IrohRemoteAgentRuntimeOptions,\n\tagentDir: string,\n): Promise<{ sessionManager: SessionManager; selection: IrohRemoteAgentRuntimeSessionSelection }> {\n\tconst resolved =\n\t\toptions.resolvedSessionTarget ??\n\t\t(await resolveIrohRemoteSessionTarget(\n\t\t\tgetSessionTarget(options),\n\t\t\t{ name: \"\", path: options.cwd },\n\t\t\tcreateSessionManagerTargetStore(\n\t\t\t\toptions.cwd,\n\t\t\t\toptions.sessionDir ?? getDefaultSessionDir(options.projectCwd ?? options.cwd, agentDir),\n\t\t\t\t{ listAll: true, preserveSessionCwd: true },\n\t\t\t),\n\t\t));\n\treturn {\n\t\tsessionManager: resolved.sessionManager,\n\t\tselection: toSessionSelection(resolved),\n\t};\n}\n\nfunction toSessionSelection(\n\tresolved: ResolvedSessionTargetWithManager<SessionManager>,\n): IrohRemoteAgentRuntimeSessionSelection {\n\tconst sessionFile = resolved.sessionManager.getSessionFile();\n\tif (resolved.selection === \"created\") {\n\t\treturn {\n\t\t\tkind: \"created\",\n\t\t\tsessionFile,\n\t\t\tsessionId: resolved.sessionId,\n\t\t};\n\t}\n\treturn {\n\t\tkind: resolved.selection,\n\t\trequestedSessionId: resolved.requestedSessionId ?? resolved.sessionId,\n\t\tsessionFile,\n\t\tsessionId: resolved.sessionId,\n\t};\n}\n\nfunction getSessionTarget(options: IrohRemoteAgentRuntimeOptions): IrohRemoteSessionTarget {\n\tconst target = getConversationTarget(options);\n\tif (target.target === \"last\") {\n\t\treturn target.resumeSessionId === undefined\n\t\t\t? { kind: \"last\" }\n\t\t\t: { kind: \"last\", resumeSessionId: target.resumeSessionId };\n\t}\n\tif (target.target === \"session\") {\n\t\treturn { kind: \"session\", sessionId: target.sessionId };\n\t}\n\treturn { kind: \"new\" };\n}\n\nfunction getConversationTarget(options: IrohRemoteAgentRuntimeOptions): IrohRemoteAgentRuntimeConversationTarget {\n\tif (options.conversationTarget !== undefined) {\n\t\treturn options.conversationTarget;\n\t}\n\tif (options.resumeSessionId !== undefined) {\n\t\treturn { target: \"last\", resumeSessionId: options.resumeSessionId };\n\t}\n\treturn { target: \"new\" };\n}\n\nfunction runIrohRemoteStartupMigrations(cwd: string, agentDir: string): void {\n\tconst previousAgentDir = process.env[ENV_AGENT_DIR];\n\tconst previousLog = console.log;\n\ttry {\n\t\tprocess.env[ENV_AGENT_DIR] = agentDir;\n\t\tconsole.log = (...data: Parameters<typeof console.log>) => console.error(...data);\n\t\trunMigrations(cwd);\n\t} finally {\n\t\tconsole.log = previousLog;\n\t\tif (previousAgentDir === undefined) {\n\t\t\tdelete process.env[ENV_AGENT_DIR];\n\t\t} else {\n\t\t\tprocess.env[ENV_AGENT_DIR] = previousAgentDir;\n\t\t}\n\t}\n}\n"]}

package/dist/modes/rpc/iroh-remote-rpc-mode.d.ts

@@ -0,0 +1,69 @@
+import type { AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
+import { type IrohRemoteOutboundValueDecorator, type IrohRemotePushNotificationDelivery, type IrohRemoteRpcGrant } from "../../core/remote/iroh/index.ts";
+import { type IrohRpcTransportOptions, type RpcTransport } from "../../core/rpc/index.ts";
+import { type RpcModeOptions, type RpcSessionChange } from "./rpc-mode.ts";
+import type { RpcRegisterPushTargetResponse } from "./rpc-types.ts";
+export interface IrohRemoteRpcModeOptions extends IrohRpcTransportOptions {
+    rpcGrant: IrohRemoteRpcGrant;
+    /** Recheck persisted authority at each command boundary when the host owns grant state. */
+    isRpcGrantCurrent?: () => boolean | Promise<boolean>;
+    decorateOutbound?: IrohRemoteOutboundValueDecorator;
+    disposeRuntimeOnClose?: boolean;
+    notificationDelivery?: IrohRemotePushNotificationDelivery;
+    onClientCapabilitiesChanged?: (features: string[]) => void;
+    onResponseWritten?: (response: Record<string, unknown>) => void | Promise<void>;
+    onSessionChanged?: (session: RpcSessionChange) => void | Promise<void>;
+    onWorkflowEvent?: RpcModeOptions["onWorkflowEvent"];
+    registerPushTarget?: (args: unknown) => Promise<RpcRegisterPushTargetResponse>;
+    remoteCommandHandler?: (command: Record<string, unknown>) => object | Promise<object | undefined> | undefined;
+    remoteWorkspacePath?: string;
+    /** Drop extension_ui_request frames (relayed streams: dialogs are answered in the owning TUI). */
+    suppressExtensionUiRequests?: boolean;
+    workspaceName?: string;
+    workspacePath: string;
+    /** Extra roots (worktree parent checkout, worktrees root) redacted on every outbound frame. */
+    additionalRedactedPaths?: string[];
+}
+export type IrohRemoteNotificationKind = "conversation_completed" | "review_completed" | "action_completed" | "host_notice";
+export interface IrohRemoteNotificationRequest {
+    type: "notification_request";
+    eventId: string;
+    kind: IrohRemoteNotificationKind;
+    title: string;
+    body: string;
+    sessionId?: string;
+    workspace?: string;
+}
+type IrohRemoteRunTerminalOutcome = "completed" | "failed" | "aborted";
+export interface IrohRemoteCompletionState {
+    sessionId: string;
+    runId?: string;
+    terminalOutcome?: IrohRemoteRunTerminalOutcome;
+}
+export interface IrohRemoteCompletedCommand {
+    command: string;
+    id: string | undefined;
+    initialState: IrohRemoteCompletionState | undefined;
+    finalState: IrohRemoteCompletionState | undefined;
+    response?: Record<string, unknown>;
+}
+interface IrohRemoteCloseDeferringRpcTransportOptions {
+    transport: RpcTransport;
+    getCompletionState?: () => IrohRemoteCompletionState;
+    onCommandCompleted?: (completion: IrohRemoteCompletedCommand) => void | Promise<void>;
+    onResponseWritten?: (response: Record<string, unknown>) => void | Promise<void>;
+    waitForPromptCompletion(): Promise<void>;
+}
+interface IrohRemoteHostCommandRpcTransportOptions {
+    handleCommand?: (command: Record<string, unknown>) => object | Promise<object | undefined> | undefined;
+    isRpcGrantCurrent?: () => boolean | Promise<boolean>;
+    transport: RpcTransport;
+}
+/** Run Volt RPC in-process over an authorized Iroh bidirectional stream. */
+export declare function runIrohRemoteRpcMode(runtimeHost: AgentSessionRuntime, options: IrohRemoteRpcModeOptions): Promise<void>;
+export declare function createIrohRemoteHostCommandRpcTransport(options: IrohRemoteHostCommandRpcTransportOptions): RpcTransport & {
+    setRpcModeStartupComplete?(startupComplete: boolean): void;
+};
+export declare function createIrohRemoteCloseDeferringRpcTransport(options: IrohRemoteCloseDeferringRpcTransportOptions): RpcTransport;
+export {};
+//# sourceMappingURL=iroh-remote-rpc-mode.d.ts.map

package/dist/modes/rpc/iroh-remote-rpc-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iroh-remote-rpc-mode.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/iroh-remote-rpc-mode.ts"],"names":[],"mappings":"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","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { randomUUID } from \"node:crypto\";\nimport type { AgentMessage } from \"@hansjm10/volt-agent-core\";\nimport type { AgentSessionEvent } from \"../../core/agent-session.ts\";\nimport type { AgentSessionRuntime } from \"../../core/agent-session-runtime.ts\";\nimport { REVIEW_BRANCH_ACTION_ID, REVIEW_UNCOMMITTED_ACTION_ID } from \"../../core/host-actions.ts\";\nimport { type CustomMessage, extractVisibleTextContent } from \"../../core/messages.ts\";\nimport {\n\tcreateIrohRemoteFilteredRpcTransport,\n\tcreateIrohRemoteOutboundFilteredRpcTransport,\n\tcreateIrohRemoteRpcErrorResponse,\n\ttype IrohRemoteLiveActivityContentState,\n\ttype IrohRemoteLiveActivityToolGlyph,\n\ttype IrohRemoteLiveActivityUpdateIntent,\n\ttype IrohRemoteOutboundValueDecorator,\n\ttype IrohRemotePushNotificationDelivery,\n\ttype IrohRemoteRpcGrant,\n\tsanitizeIrohRemoteTranscriptText,\n} from \"../../core/remote/iroh/index.ts\";\nimport {\n\tcreateIrohRpcTransport,\n\ttype IrohRpcTransportOptions,\n\ttype RpcCloseHandler,\n\ttype RpcLineHandler,\n\ttype RpcTranscriptItem,\n\ttype RpcTransport,\n} from \"../../core/rpc/index.ts\";\nimport { extractMessageImages, projectSessionTranscript } from \"../../core/rpc/transcript.ts\";\nimport type { CustomMessageEntry, SessionEntry, SessionMessageEntry } from \"../../core/session-manager.ts\";\nimport { type RpcModeOptions, type RpcSessionChange, runRpcMode } from \"./rpc-mode.ts\";\nimport type { RpcRegisterPushTargetResponse } from \"./rpc-types.ts\";\n\nexport interface IrohRemoteRpcModeOptions extends IrohRpcTransportOptions {\n\trpcGrant: IrohRemoteRpcGrant;\n\t/** Recheck persisted authority at each command boundary when the host owns grant state. */\n\tisRpcGrantCurrent?: () => boolean | Promise<boolean>;\n\tdecorateOutbound?: IrohRemoteOutboundValueDecorator;\n\tdisposeRuntimeOnClose?: boolean;\n\tnotificationDelivery?: IrohRemotePushNotificationDelivery;\n\tonClientCapabilitiesChanged?: (features: string[]) => void;\n\tonResponseWritten?: (response: Record<string, unknown>) => void | Promise<void>;\n\tonSessionChanged?: (session: RpcSessionChange) => void | Promise<void>;\n\tonWorkflowEvent?: RpcModeOptions[\"onWorkflowEvent\"];\n\tregisterPushTarget?: (args: unknown) => Promise<RpcRegisterPushTargetResponse>;\n\tremoteCommandHandler?: (command: Record<string, unknown>) => object | Promise<object | undefined> | undefined;\n\tremoteWorkspacePath?: string;\n\t/** Drop extension_ui_request frames (relayed streams: dialogs are answered in the owning TUI). */\n\tsuppressExtensionUiRequests?: boolean;\n\tworkspaceName?: string;\n\tworkspacePath: string;\n\t/** Extra roots (worktree parent checkout, worktrees root) redacted on every outbound frame. */\n\tadditionalRedactedPaths?: string[];\n}\n\nexport type IrohRemoteNotificationKind =\n\t| \"conversation_completed\"\n\t| \"review_completed\"\n\t| \"action_completed\"\n\t| \"host_notice\";\n\nexport interface IrohRemoteNotificationRequest {\n\ttype: \"notification_request\";\n\teventId: string;\n\tkind: IrohRemoteNotificationKind;\n\ttitle: string;\n\tbody: string;\n\tsessionId?: string;\n\tworkspace?: string;\n}\n\ntype IrohRemoteRunTerminalOutcome = \"completed\" | \"failed\" | \"aborted\";\n\nexport interface IrohRemoteCompletionState {\n\tsessionId: string;\n\trunId?: string;\n\tterminalOutcome?: IrohRemoteRunTerminalOutcome;\n}\n\nexport interface IrohRemoteCompletedCommand {\n\tcommand: string;\n\tid: string | undefined;\n\tinitialState: IrohRemoteCompletionState | undefined;\n\tfinalState: IrohRemoteCompletionState | undefined;\n\tresponse?: Record<string, unknown>;\n}\n\ninterface PendingIrohRemoteCommand {\n\tcommand: string;\n\tid: string | undefined;\n\tinitialState: IrohRemoteCompletionState | undefined;\n\tdone: Promise<void>;\n\tresponseMatched: boolean;\n\tfinish(): void;\n}\n\ninterface IrohRemoteCloseDeferringRpcTransportOptions {\n\ttransport: RpcTransport;\n\tgetCompletionState?: () => IrohRemoteCompletionState;\n\tonCommandCompleted?: (completion: IrohRemoteCompletedCommand) => void | Promise<void>;\n\tonResponseWritten?: (response: Record<string, unknown>) => void | Promise<void>;\n\twaitForPromptCompletion(): Promise<void>;\n}\n\ninterface IrohRemoteCloseDeferringRpcTransport extends RpcTransport {\n\tsetRpcModeStartupComplete(startupComplete: boolean): void;\n}\n\ninterface IrohRemoteHostCommandRpcTransportOptions {\n\thandleCommand?: (command: Record<string, unknown>) => object | Promise<object | undefined> | undefined;\n\tisRpcGrantCurrent?: () => boolean | Promise<boolean>;\n\ttransport: RpcTransport;\n}\n\n/**\n * Cap on the per-stream completion-notification dedup set. Duplicate suppression\n * only needs recent history, so a very long-lived relay stream doing thousands of\n * turns evicts oldest-first rather than growing the set without bound.\n */\nconst MAX_SENT_NOTIFICATION_EVENT_IDS = 512;\n\n/**\n * Scalar cap for tool result text shipped to remote clients (transcript entries\n * and tool_execution_end frames). Mirrors REMOTE_TOOL_OUTPUT_MAX_SCALARS in\n * daemon/conversation-commands.ts so live events and fetched history agree.\n */\nconst IROH_REMOTE_TOOL_OUTPUT_MAX_SCALARS = 8_000;\n\n/** Run Volt RPC in-process over an authorized Iroh bidirectional stream. */\nexport function runIrohRemoteRpcMode(\n\truntimeHost: AgentSessionRuntime,\n\toptions: IrohRemoteRpcModeOptions,\n): Promise<void> {\n\tconst sentNotificationEventIds = new Set<string>();\n\tlet detachLiveActivityUpdates: (() => void) | undefined;\n\tlet detachTranscriptEntryEvents: (() => void) | undefined;\n\tlet transportClosed = false;\n\tconst attachLiveActivityUpdates = () => {\n\t\tdetachLiveActivityUpdates?.();\n\t\tdetachLiveActivityUpdates = attachIrohRemoteLiveActivityUpdates(\n\t\t\truntimeHost,\n\t\t\toptions.notificationDelivery,\n\t\t\toptions.workspaceName,\n\t\t);\n\t};\n\tconst filteredOutboundTransport = createIrohRemoteOutboundFilteredRpcTransport({\n\t\tdecorate: options.decorateOutbound,\n\t\tremoteWorkspacePath: options.remoteWorkspacePath,\n\t\ttransport: createIrohRpcTransport(options),\n\t\tworkspacePath: options.workspacePath,\n\t\tadditionalRedactedPaths: options.additionalRedactedPaths,\n\t});\n\tconst suppressingTransport: RpcTransport = options.suppressExtensionUiRequests\n\t\t? {\n\t\t\t\t...filteredOutboundTransport,\n\t\t\t\twrite: (value) => {\n\t\t\t\t\tif (\n\t\t\t\t\t\ttypeof value === \"object\" &&\n\t\t\t\t\t\tvalue !== null &&\n\t\t\t\t\t\t(value as { type?: unknown }).type === \"extension_ui_request\"\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn Promise.resolve();\n\t\t\t\t\t}\n\t\t\t\t\treturn filteredOutboundTransport.write(value);\n\t\t\t\t},\n\t\t\t}\n\t\t: filteredOutboundTransport;\n\t// Attach bounded, sanitized tool result text to live tool_execution_end\n\t// frames so remote clients can show real output in tool details.\n\tconst outboundTransport: RpcTransport = {\n\t\t...suppressingTransport,\n\t\twrite: (value) =>\n\t\t\tsuppressingTransport.write(\n\t\t\t\tdecorateIrohRemoteToolExecutionEnd(value, {\n\t\t\t\t\tremoteWorkspacePath: options.remoteWorkspacePath,\n\t\t\t\t\tworkspacePath: options.workspacePath,\n\t\t\t\t}),\n\t\t\t),\n\t};\n\tconst attachTranscriptEntryEvents = () => {\n\t\tdetachTranscriptEntryEvents?.();\n\t\tdetachTranscriptEntryEvents = attachIrohRemoteTranscriptEntryEvents(runtimeHost, outboundTransport, {\n\t\t\tremoteWorkspacePath: options.remoteWorkspacePath,\n\t\t\tworkspacePath: options.workspacePath,\n\t\t});\n\t};\n\tattachTranscriptEntryEvents();\n\tconst deliverCompletionNotification = async (notification: IrohRemoteNotificationRequest): Promise<void> => {\n\t\tif (options.notificationDelivery) {\n\t\t\tconst deliveryStatus = await options.notificationDelivery.deliverNotification(notification);\n\t\t\tif (deliveryStatus === \"sent\" || deliveryStatus === \"duplicate\") {\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tawait outboundTransport.write(notification);\n\t};\n\tconst closeDeferringTransport = createIrohRemoteCloseDeferringRpcTransport({\n\t\ttransport: outboundTransport,\n\t\tgetCompletionState: () => getIrohRemoteCompletionState(runtimeHost),\n\t\tonCommandCompleted: async (completion) => {\n\t\t\tconst notification = createIrohRemoteCompletionNotification(completion, options.workspaceName);\n\t\t\tif (!notification || sentNotificationEventIds.has(notification.eventId)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (sentNotificationEventIds.size >= MAX_SENT_NOTIFICATION_EVENT_IDS) {\n\t\t\t\t// Set preserves insertion order, so the first value is the oldest.\n\t\t\t\tconst oldest = sentNotificationEventIds.values().next().value;\n\t\t\t\tif (oldest !== undefined) {\n\t\t\t\t\tsentNotificationEventIds.delete(oldest);\n\t\t\t\t}\n\t\t\t}\n\t\t\tsentNotificationEventIds.add(notification.eventId);\n\t\t\ttry {\n\t\t\t\tawait deliverCompletionNotification(notification);\n\t\t\t} catch (error: unknown) {\n\t\t\t\tsentNotificationEventIds.delete(notification.eventId);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tonResponseWritten: options.onResponseWritten,\n\t\twaitForPromptCompletion: () => runtimeHost.session.waitForIdle(),\n\t});\n\n\tconst filteredTransport = createIrohRemoteFilteredRpcTransport({\n\t\ttransport: closeDeferringTransport,\n\t\trpcGrant: options.rpcGrant,\n\t});\n\tconst remoteHostCommandTransport =\n\t\toptions.remoteCommandHandler || options.isRpcGrantCurrent\n\t\t\t? createIrohRemoteHostCommandRpcTransport({\n\t\t\t\t\thandleCommand: options.remoteCommandHandler,\n\t\t\t\t\tisRpcGrantCurrent: options.isRpcGrantCurrent,\n\t\t\t\t\ttransport: filteredTransport,\n\t\t\t\t})\n\t\t\t: filteredTransport;\n\n\treturn runRpcMode(runtimeHost, {\n\t\tallowUiActionInvocation: true,\n\t\tdisposeRuntimeOnClose: options.disposeRuntimeOnClose,\n\t\tonSessionChanged: async (session) => {\n\t\t\tawait options.onSessionChanged?.(session);\n\t\t\tif (!transportClosed) {\n\t\t\t\tattachLiveActivityUpdates();\n\t\t\t\tattachTranscriptEntryEvents();\n\t\t\t}\n\t\t},\n\t\tonClientCapabilitiesChanged: options.onClientCapabilitiesChanged,\n\t\tonWorkflowEvent: options.onWorkflowEvent,\n\t\trequireRemoteSafeUiActions: true,\n\t\ttransport: remoteHostCommandTransport,\n\t\texitProcess: false,\n\t\tregisterPushTarget: options.registerPushTarget,\n\t}).finally(() => {\n\t\ttransportClosed = true;\n\t\tdetachTranscriptEntryEvents?.();\n\t\tdetachLiveActivityUpdates?.();\n\t});\n}\n\ninterface IrohRemoteTranscriptEventOptions {\n\tremoteWorkspacePath?: string;\n\tworkspacePath: string;\n}\n\nfunction attachIrohRemoteTranscriptEntryEvents(\n\truntimeHost: AgentSessionRuntime,\n\ttransport: RpcTransport,\n\toptions: IrohRemoteTranscriptEventOptions,\n): () => void {\n\tconst emittedFinalEntryIds = new Set<string>();\n\treturn runtimeHost.session.subscribe((event) => {\n\t\tif (event.type !== \"message_end\") {\n\t\t\treturn;\n\t\t}\n\t\tconst message = event.message;\n\t\tqueueMicrotask(() => {\n\t\t\tconst entry = findPersistedMessageEntry(runtimeHost, message);\n\t\t\tif (!entry || emittedFinalEntryIds.has(entry.id)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst transcriptEvent = createIrohRemoteTranscriptEntryEvent(entry, runtimeHost, options);\n\t\t\tif (!transcriptEvent) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\temittedFinalEntryIds.add(entry.id);\n\t\t\tvoid Promise.resolve(transport.write(transcriptEvent)).catch(() => {});\n\t\t});\n\t});\n}\n\ntype IrohRemoteTranscriptSourceEntry = SessionMessageEntry | CustomMessageEntry;\n\ninterface IrohRemoteStoredToolCall {\n\tid: string;\n\tname: string;\n\targuments: Record<string, unknown>;\n}\n\nfunction findPersistedMessageEntry(\n\truntimeHost: AgentSessionRuntime,\n\tmessage: unknown,\n): IrohRemoteTranscriptSourceEntry | undefined {\n\tconst branch = runtimeHost.session.sessionManager.getBranch();\n\tfor (let index = branch.length - 1; index >= 0; index--) {\n\t\tconst entry = branch[index];\n\t\tif (entry.type === \"message\" && entry.message === message) {\n\t\t\treturn entry;\n\t\t}\n\t\tif (entry.type === \"custom_message\" && isMatchingReviewCustomMessageEntry(entry, message)) {\n\t\t\treturn entry;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction isMatchingReviewCustomMessageEntry(entry: CustomMessageEntry, message: unknown): message is CustomMessage {\n\tif (entry.customType !== \"review\" || entry.display !== true || !isReviewCustomMessage(message)) {\n\t\treturn false;\n\t}\n\treturn customMessageContentMatches(entry.content, message.content);\n}\n\nfunction isReviewCustomMessage(message: unknown): message is CustomMessage {\n\tif (typeof message !== \"object\" || message === null || Array.isArray(message)) {\n\t\treturn false;\n\t}\n\tconst candidate = message as Partial<CustomMessage>;\n\treturn candidate.role === \"custom\" && candidate.customType === \"review\" && candidate.display === true;\n}\n\nfunction customMessageContentMatches(left: CustomMessageEntry[\"content\"], right: CustomMessage[\"content\"]): boolean {\n\tif (typeof left === \"string\" || typeof right === \"string\") {\n\t\treturn left === right;\n\t}\n\ttry {\n\t\treturn JSON.stringify(left) === JSON.stringify(right);\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction createIrohRemoteTranscriptEntryEvent(\n\tentry: IrohRemoteTranscriptSourceEntry,\n\truntimeHost: AgentSessionRuntime,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, unknown> | undefined {\n\tconst projectedEvent = createIrohRemoteProjectedTranscriptEntryEvent(entry, runtimeHost, options);\n\tif (projectedEvent) {\n\t\treturn projectedEvent;\n\t}\n\n\tif (entry.type === \"custom_message\") {\n\t\tif (entry.customType !== \"review\" || entry.display !== true) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst text = extractVisibleTextContent(entry.content);\n\t\treturn text ? createIrohRemoteTranscriptEntryEventValue(entry, \"assistant\", text, options) : undefined;\n\t}\n\tconst message = entry.message;\n\tif (message.role === \"user\" || message.role === \"assistant\") {\n\t\tconst text = extractVisibleTextContent(message.content);\n\t\tconst imageCount = message.role === \"user\" ? extractMessageImages(message.content).length : 0;\n\t\tif (!text && imageCount === 0) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn createIrohRemoteTranscriptEntryEventValue(\n\t\t\tentry,\n\t\t\tmessage.role,\n\t\t\ttext,\n\t\t\toptions,\n\t\t\timageCount > 0 ? { imageCount } : {},\n\t\t);\n\t}\n\tif (message.role === \"toolResult\") {\n\t\tconst status = message.isError ? \"failed\" : \"completed\";\n\t\tconst toolName =\n\t\t\ttypeof message.toolName === \"string\" && message.toolName.trim() ? message.toolName.trim() : \"tool\";\n\t\tconst toolCall = collectIrohRemoteToolCalls(runtimeHost.session.sessionManager.getBranch()).get(\n\t\t\tmessage.toolCallId,\n\t\t);\n\t\tconst imageCount = extractMessageImages(message.content).length;\n\t\treturn createIrohRemoteTranscriptEntryEventValue(entry, \"tool\", `${toolName} ${status}`, options, {\n\t\t\ttoolName,\n\t\t\tstatus,\n\t\t\tsummary: `${toolName} ${status}`,\n\t\t\t...(toolName === \"subagent\"\n\t\t\t\t? {\n\t\t\t\t\t\t...projectIrohRemoteSubagentTranscriptArgs(toolCall?.arguments, options),\n\t\t\t\t\t\t...projectIrohRemoteSubagentTranscriptDetails(message.details, options),\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t\t...sanitizeIrohRemoteToolOutputFields(extractVisibleTextContent(message.content), options),\n\t\t\t...(imageCount > 0 ? { imageCount } : {}),\n\t\t});\n\t}\n\tif (message.role === \"bashExecution\") {\n\t\tconst failed = message.cancelled || (message.exitCode !== undefined && message.exitCode !== 0);\n\t\tconst status = failed ? \"failed\" : \"completed\";\n\t\tconst exit = message.cancelled\n\t\t\t? \"cancelled\"\n\t\t\t: message.exitCode === undefined\n\t\t\t\t? status\n\t\t\t\t: `exit ${message.exitCode}`;\n\t\treturn createIrohRemoteTranscriptEntryEventValue(\n\t\t\tentry,\n\t\t\t\"tool\",\n\t\t\t`bash ${exit}`,\n\t\t\toptions,\n\t\t\tsanitizeIrohRemoteToolOutputFields(message.output, options, message.truncated === true),\n\t\t);\n\t}\n\treturn undefined;\n}\n\nfunction createIrohRemoteProjectedTranscriptEntryEvent(\n\tentry: IrohRemoteTranscriptSourceEntry,\n\truntimeHost: AgentSessionRuntime,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, unknown> | undefined {\n\tconst item = projectSessionTranscript(runtimeHost.session.sessionManager, { limit: 200 }).items.find(\n\t\t(transcriptItem) => transcriptItem.id === entry.id,\n\t);\n\tif (!item) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\ttype: \"transcript_entry\",\n\t\tentry: {\n\t\t\tentryId: item.id,\n\t\t\tcreatedAt: item.timestamp,\n\t\t\t...createIrohRemoteProjectedTranscriptEntryFields(item, options),\n\t\t\t...(item.role === \"tool\" ? getIrohRemoteToolOutputFields(entry, options) : {}),\n\t\t},\n\t\tfinal: true,\n\t};\n}\n\n/** Sanitized, bounded tool result text for a persisted tool transcript entry. */\nfunction getIrohRemoteToolOutputFields(\n\tentry: IrohRemoteTranscriptSourceEntry,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, unknown> {\n\tif (entry.type !== \"message\") {\n\t\treturn {};\n\t}\n\tconst message = entry.message;\n\tif (message.role === \"toolResult\") {\n\t\treturn sanitizeIrohRemoteToolOutputFields(extractVisibleTextContent(message.content), options);\n\t}\n\tif (message.role === \"bashExecution\") {\n\t\treturn sanitizeIrohRemoteToolOutputFields(message.output, options, message.truncated === true);\n\t}\n\treturn {};\n}\n\nfunction sanitizeIrohRemoteToolOutputFields(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n\thostTruncated = false,\n): Record<string, unknown> {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\treturn {};\n\t}\n\tconst sanitized = sanitizeIrohRemoteTranscriptText(value, options, \"preserve\");\n\tconst scalars = Array.from(sanitized.text);\n\tconst truncated = sanitized.truncated || hostTruncated || scalars.length > IROH_REMOTE_TOOL_OUTPUT_MAX_SCALARS;\n\treturn {\n\t\toutput:\n\t\t\tscalars.length > IROH_REMOTE_TOOL_OUTPUT_MAX_SCALARS\n\t\t\t\t? scalars.slice(0, IROH_REMOTE_TOOL_OUTPUT_MAX_SCALARS).join(\"\")\n\t\t\t\t: sanitized.text,\n\t\toutputTruncated: truncated,\n\t};\n}\n\n/**\n * Adds `output`/`outputTruncated` to outbound tool_execution_end frames. The\n * generic outbound filter still sanitizes the whole frame afterwards; the text\n * is pre-sanitized and truncated here so the added field is bounded regardless.\n */\nfunction decorateIrohRemoteToolExecutionEnd(value: object, options: IrohRemoteTranscriptEventOptions): object {\n\tif (!isRecord(value) || value.type !== \"tool_execution_end\" || \"output\" in value) {\n\t\treturn value;\n\t}\n\tconst result = value.result;\n\tif (!isRecord(result)) {\n\t\treturn value;\n\t}\n\tconst outputFields = sanitizeIrohRemoteToolOutputFields(extractVisibleTextContent(result.content), options);\n\treturn Object.keys(outputFields).length > 0 ? { ...value, ...outputFields } : value;\n}\n\nfunction createIrohRemoteProjectedTranscriptEntryFields(\n\titem: RpcTranscriptItem,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, unknown> {\n\tif (item.role === \"tool\") {\n\t\tconst summary = sanitizeIrohRemoteTranscriptText(item.summary, options, \"summary\");\n\t\tconst fields: Record<string, unknown> = {\n\t\t\trole: \"tool\",\n\t\t\ttext: summary.text,\n\t\t\ttruncated: summary.truncated,\n\t\t\ttoolName: item.toolName,\n\t\t\tstatus: item.status,\n\t\t\tsummary: summary.text,\n\t\t};\n\t\tif (item.path) {\n\t\t\tfields.path = item.path;\n\t\t}\n\t\tif (item.args) {\n\t\t\tfields.args = item.args;\n\t\t}\n\t\tif (item.details) {\n\t\t\tfields.details = item.details;\n\t\t}\n\t\tif (item.diffPreview) {\n\t\t\tfields.diffPreview = item.diffPreview;\n\t\t}\n\t\tif (item.patchPreview) {\n\t\t\tfields.patchPreview = item.patchPreview;\n\t\t}\n\t\tif (item.imageCount) {\n\t\t\tfields.imageCount = item.imageCount;\n\t\t}\n\t\treturn fields;\n\t}\n\n\tconst text = sanitizeIrohRemoteTranscriptText(item.text, options);\n\tconst fields: Record<string, unknown> = {\n\t\trole: item.role,\n\t\ttext: text.text,\n\t\ttruncated: text.truncated,\n\t};\n\tif (item.role === \"summary\") {\n\t\tfields.title = item.title;\n\t}\n\tif (item.role === \"user\" && item.imageCount) {\n\t\tfields.imageCount = item.imageCount;\n\t}\n\treturn fields;\n}\n\nfunction createIrohRemoteTranscriptEntryEventValue(\n\tentry: SessionEntry,\n\trole: \"user\" | \"assistant\" | \"system\" | \"tool\",\n\ttext: string,\n\toptions: IrohRemoteTranscriptEventOptions,\n\textraEntryFields: Record<string, unknown> = {},\n): Record<string, unknown> {\n\tconst sanitized = sanitizeIrohRemoteTranscriptText(text, options, role === \"tool\" ? \"summary\" : \"preserve\");\n\treturn {\n\t\ttype: \"transcript_entry\",\n\t\tentry: {\n\t\t\tentryId: entry.id,\n\t\t\tcreatedAt: normalizeIrohRemoteTranscriptTimestamp(entry.timestamp),\n\t\t\trole,\n\t\t\ttext: sanitized.text,\n\t\t\ttruncated: sanitized.truncated,\n\t\t\t...extraEntryFields,\n\t\t},\n\t\tfinal: true,\n\t};\n}\n\nfunction collectIrohRemoteToolCalls(entries: SessionEntry[]): Map<string, IrohRemoteStoredToolCall> {\n\tconst toolCalls = new Map<string, IrohRemoteStoredToolCall>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\" || entry.message.role !== \"assistant\") {\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const block of entry.message.content) {\n\t\t\tif (isIrohRemoteStoredToolCall(block)) {\n\t\t\t\ttoolCalls.set(block.id, block);\n\t\t\t}\n\t\t}\n\t}\n\treturn toolCalls;\n}\n\nfunction isIrohRemoteStoredToolCall(value: unknown): value is IrohRemoteStoredToolCall {\n\treturn (\n\t\tisRecord(value) &&\n\t\tvalue.type === \"toolCall\" &&\n\t\ttypeof value.id === \"string\" &&\n\t\ttypeof value.name === \"string\" &&\n\t\tisRecord(value.arguments)\n\t);\n}\n\nfunction projectIrohRemoteSubagentTranscriptArgs(\n\targs: Record<string, unknown> | undefined,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, unknown> {\n\tif (!args) {\n\t\treturn {};\n\t}\n\tconst projected: Record<string, unknown> = {};\n\tcopyIrohRemoteBoundedString(args, projected, \"agent\", options, 200);\n\tcopyIrohRemoteBoundedString(args, projected, \"task\", options, 1_000);\n\tconst tasks = projectIrohRemoteSubagentInputArray(args.tasks, options);\n\tif (tasks) {\n\t\tprojected.tasks = tasks;\n\t}\n\tconst chain = projectIrohRemoteSubagentInputArray(args.chain, options);\n\tif (chain) {\n\t\tprojected.chain = chain;\n\t}\n\treturn Object.keys(projected).length > 0 ? { args: projected } : {};\n}\n\nfunction projectIrohRemoteSubagentInputArray(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Array<{ agent: string; task: string }> | undefined {\n\tif (!Array.isArray(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected = value\n\t\t.map((item) => {\n\t\t\tif (!isRecord(item)) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tconst agent = getIrohRemoteBoundedString(item.agent, options, 200);\n\t\t\tconst task = getIrohRemoteBoundedString(item.task, options, 1_000);\n\t\t\treturn agent && task ? { agent, task } : undefined;\n\t\t})\n\t\t.filter((item): item is { agent: string; task: string } => item !== undefined);\n\treturn projected.length > 0 ? projected : undefined;\n}\n\nfunction projectIrohRemoteSubagentTranscriptDetails(\n\tdetails: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, unknown> {\n\tif (!isRecord(details)) {\n\t\treturn {};\n\t}\n\tconst projected: Record<string, unknown> = {};\n\tcopyIrohRemoteBoundedString(details, projected, \"mode\", options, 200);\n\tcopyIrohRemoteBoundedString(details, projected, \"status\", options, 200);\n\tcopyIrohRemoteBoundedString(details, projected, \"subagentId\", options, 200);\n\tcopyIrohRemoteBoundedString(details, projected, \"sessionId\", options, 200);\n\tcopyIrohRemoteSubagentNumericDetails(details, projected);\n\tcopyIrohRemoteBoundedString(details, projected, \"currentActivity\", options, 300);\n\tconst summary = projectIrohRemoteSubagentSummary(details.summary);\n\tif (summary) {\n\t\tprojected.summary = summary;\n\t}\n\tconst childSessions = projectIrohRemoteSubagentDetailArray(details.childSessions, options);\n\tif (childSessions) {\n\t\tprojected.childSessions = childSessions;\n\t}\n\tconst agent = projectIrohRemoteSubagentAgent(details.agent, options);\n\tif (agent) {\n\t\tprojected.agent = agent;\n\t}\n\tconst output = projectIrohRemoteSubagentOutput(details.output, options);\n\tif (output) {\n\t\tprojected.output = output;\n\t}\n\tconst error = projectIrohRemoteSubagentError(details.error, options);\n\tif (error) {\n\t\tprojected.error = error;\n\t}\n\tconst children = projectIrohRemoteSubagentDetailArray(details.children, options);\n\tif (children) {\n\t\tprojected.children = children;\n\t}\n\tconst tasks = projectIrohRemoteSubagentDetailArray(details.tasks, options);\n\tif (tasks) {\n\t\tprojected.tasks = tasks;\n\t}\n\tconst steps = projectIrohRemoteSubagentDetailArray(details.steps, options);\n\tif (steps) {\n\t\tprojected.steps = steps;\n\t}\n\treturn Object.keys(projected).length > 0 ? { details: projected } : {};\n}\n\nconst IROH_REMOTE_SUBAGENT_NUMERIC_KEYS = [\"startedAt\", \"durationMs\", \"toolCalls\", \"tokens\"] as const;\nconst IROH_REMOTE_SUBAGENT_TREE_DEPTH_LIMIT = 5;\n\nfunction copyIrohRemoteSubagentNumericDetails(from: Record<string, unknown>, to: Record<string, unknown>): void {\n\tfor (const key of IROH_REMOTE_SUBAGENT_NUMERIC_KEYS) {\n\t\tconst numberValue = getIrohRemoteFiniteNumber(from[key]);\n\t\tif (numberValue !== undefined) {\n\t\t\tto[key] = numberValue;\n\t\t}\n\t}\n}\n\nfunction projectIrohRemoteSubagentSummary(value: unknown): Record<string, number> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, number> = {};\n\tfor (const key of [\n\t\t\"total\",\n\t\t\"completed\",\n\t\t\"failed\",\n\t\t\"aborted\",\n\t\t\"running\",\n\t\t\"maxTasks\",\n\t\t\"maxConcurrency\",\n\t\t\"stoppedAt\",\n\t]) {\n\t\tconst numberValue = getIrohRemoteFiniteNumber(value[key]);\n\t\tif (numberValue !== undefined) {\n\t\t\tprojected[key] = numberValue;\n\t\t}\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectIrohRemoteSubagentDetailArray(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n\tdepth = 0,\n): Array<Record<string, unknown>> | undefined {\n\tif (!Array.isArray(value) || depth >= IROH_REMOTE_SUBAGENT_TREE_DEPTH_LIMIT) {\n\t\treturn undefined;\n\t}\n\tconst projected = value\n\t\t.map((item) => projectIrohRemoteSubagentTask(item, options, depth))\n\t\t.filter((item): item is Record<string, unknown> => item !== undefined);\n\treturn projected.length > 0 ? projected : undefined;\n}\n\nfunction projectIrohRemoteSubagentTask(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n\tdepth = 0,\n): Record<string, unknown> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, unknown> = {};\n\tconst index = getIrohRemoteFiniteNumber(value.index);\n\tif (index !== undefined) {\n\t\tprojected.index = index;\n\t}\n\tcopyIrohRemoteBoundedString(value, projected, \"subagentId\", options, 200);\n\tcopyIrohRemoteBoundedString(value, projected, \"sessionId\", options, 200);\n\tconst agent = projectIrohRemoteSubagentAgent(value.agent, options);\n\tif (agent) {\n\t\tprojected.agent = agent;\n\t}\n\tcopyIrohRemoteBoundedString(value, projected, \"status\", options, 200);\n\tcopyIrohRemoteBoundedString(value, projected, \"task\", options, 1_000);\n\tcopyIrohRemoteSubagentNumericDetails(value, projected);\n\tcopyIrohRemoteBoundedString(value, projected, \"currentActivity\", options, 300);\n\tconst error = projectIrohRemoteSubagentError(value.error, options);\n\tif (error) {\n\t\tprojected.error = error;\n\t}\n\tconst children = projectIrohRemoteSubagentDetailArray(value.children, options, depth + 1);\n\tif (children) {\n\t\tprojected.children = children;\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectIrohRemoteSubagentAgent(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, string> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, string> = {};\n\tcopyIrohRemoteBoundedString(value, projected, \"name\", options, 200);\n\tcopyIrohRemoteBoundedString(value, projected, \"source\", options, 200);\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectIrohRemoteSubagentOutput(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, unknown> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, unknown> = {};\n\tcopyIrohRemoteBoundedString(value, projected, \"text\", options, 1_000);\n\tfor (const key of [\"bytes\", \"omittedBytes\", \"maxBytes\"]) {\n\t\tconst numberValue = getIrohRemoteFiniteNumber(value[key]);\n\t\tif (numberValue !== undefined) {\n\t\t\tprojected[key] = numberValue;\n\t\t}\n\t}\n\tif (typeof value.truncated === \"boolean\") {\n\t\tprojected.truncated = value.truncated;\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectIrohRemoteSubagentError(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n): Record<string, string> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst message = getIrohRemoteBoundedString(value.message, options, 1_000);\n\treturn message ? { message } : undefined;\n}\n\nfunction copyIrohRemoteBoundedString(\n\tfrom: Record<string, unknown>,\n\tto: Record<string, unknown>,\n\tkey: string,\n\toptions: IrohRemoteTranscriptEventOptions,\n\tmaxScalars: number,\n): void {\n\tconst value = getIrohRemoteBoundedString(from[key], options, maxScalars);\n\tif (value) {\n\t\tto[key] = value;\n\t}\n}\n\nfunction getIrohRemoteBoundedString(\n\tvalue: unknown,\n\toptions: IrohRemoteTranscriptEventOptions,\n\tmaxScalars: number,\n): string | undefined {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\treturn undefined;\n\t}\n\treturn truncateUnicodeScalars(sanitizeIrohRemoteTranscriptText(value, options, \"summary\").text, maxScalars);\n}\n\nfunction getIrohRemoteFiniteNumber(value: unknown): number | undefined {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nfunction truncateUnicodeScalars(value: string, maxLength: number): string {\n\tconst scalars = Array.from(value);\n\treturn scalars.length <= maxLength ? value : scalars.slice(0, maxLength).join(\"\");\n}\n\nfunction normalizeIrohRemoteTranscriptTimestamp(timestamp: string): string {\n\tconst date = new Date(timestamp);\n\treturn Number.isNaN(date.getTime()) ? new Date(0).toISOString() : date.toISOString();\n}\n\nfunction attachIrohRemoteLiveActivityUpdates(\n\truntimeHost: AgentSessionRuntime,\n\tdelivery: IrohRemotePushNotificationDelivery | undefined,\n\tworkspaceName: string | undefined,\n): () => void {\n\tif (!delivery?.deliverLiveActivityUpdate) {\n\t\treturn () => {};\n\t}\n\tconst updater = new IrohRemoteLiveActivityUpdater(runtimeHost, delivery, workspaceName);\n\tconst unsubscribe = runtimeHost.session.subscribe((event) => {\n\t\tvoid updater.handle(event).catch(() => {});\n\t});\n\tupdater.start();\n\treturn unsubscribe;\n}\n\nclass IrohRemoteLiveActivityUpdater {\n\tprivate readonly delivery: Required<Pick<IrohRemotePushNotificationDelivery, \"deliverLiveActivityUpdate\">>;\n\tprivate readonly runtimeHost: AgentSessionRuntime;\n\tprivate readonly workspaceName: string | undefined;\n\tprivate readonly toolIndexesByCallId = new Map<string, number>();\n\tprivate readonly instanceId = randomUUID();\n\tprivate deliveryQueue: Promise<void> = Promise.resolve();\n\tprivate recentTools: IrohRemoteLiveActivityToolGlyph[] = [];\n\tprivate sequence = 0;\n\tprivate active = false;\n\tprivate pendingTerminalStatus: \"completed\" | \"failed\" | undefined;\n\n\tconstructor(\n\t\truntimeHost: AgentSessionRuntime,\n\t\tdelivery: IrohRemotePushNotificationDelivery,\n\t\tworkspaceName: string | undefined,\n\t) {\n\t\tif (!delivery.deliverLiveActivityUpdate) {\n\t\t\tthrow new Error(\"live activity delivery is unavailable\");\n\t\t}\n\t\tthis.runtimeHost = runtimeHost;\n\t\tthis.delivery = { deliverLiveActivityUpdate: delivery.deliverLiveActivityUpdate.bind(delivery) };\n\t\tthis.workspaceName = workspaceName;\n\t}\n\n\tstart(): void {\n\t\tif (!this.runtimeHost.session.isStreaming) {\n\t\t\treturn;\n\t\t}\n\t\tthis.active = true;\n\t\tvoid this.sendUpdate(\"running\").catch(() => {});\n\t}\n\n\tasync handle(event: AgentSessionEvent): Promise<void> {\n\t\tswitch (event.type) {\n\t\t\tcase \"agent_start\":\n\t\t\t\tthis.active = true;\n\t\t\t\tthis.pendingTerminalStatus = undefined;\n\t\t\t\tthis.recentTools = [];\n\t\t\t\tthis.toolIndexesByCallId.clear();\n\t\t\t\tawait this.sendUpdate(\"running\");\n\t\t\t\tbreak;\n\t\t\tcase \"tool_execution_start\":\n\t\t\t\tthis.active = true;\n\t\t\t\tif (this.recordTool(event.toolCallId, createLiveActivityToolGlyph(event.toolName, \"started\"))) {\n\t\t\t\t\tawait this.sendUpdate(\"running\");\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\tcase \"tool_execution_end\":\n\t\t\t\tthis.active = true;\n\t\t\t\tif (\n\t\t\t\t\tthis.recordTool(\n\t\t\t\t\t\tevent.toolCallId,\n\t\t\t\t\t\tcreateLiveActivityToolGlyph(event.toolName, event.isError ? \"failed\" : \"completed\"),\n\t\t\t\t\t)\n\t\t\t\t) {\n\t\t\t\t\tawait this.sendUpdate(\"running\");\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\tcase \"agent_end\":\n\t\t\t\tif (!this.active) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.pendingTerminalStatus = getRunTerminalOutcome(event.messages) === \"completed\" ? \"completed\" : \"failed\";\n\t\t\t\tbreak;\n\t\t\tcase \"agent_settled\": {\n\t\t\t\tif (!this.active || this.pendingTerminalStatus === undefined) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst terminalStatus = this.pendingTerminalStatus;\n\t\t\t\t// End the old run synchronously so delayed delivery cannot clear state\n\t\t\t\t// established by a newer agent_start handler.\n\t\t\t\tthis.active = false;\n\t\t\t\tthis.pendingTerminalStatus = undefined;\n\t\t\t\tthis.toolIndexesByCallId.clear();\n\t\t\t\tawait this.sendUpdate(terminalStatus);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\tprivate recordTool(toolCallId: string | undefined, tool: IrohRemoteLiveActivityToolGlyph): boolean {\n\t\tconst normalizedCallId = typeof toolCallId === \"string\" && toolCallId.length > 0 ? toolCallId : undefined;\n\t\tif (normalizedCallId) {\n\t\t\tconst existingIndex = this.toolIndexesByCallId.get(normalizedCallId);\n\t\t\tif (existingIndex !== undefined && existingIndex < this.recentTools.length) {\n\t\t\t\tthis.recentTools[existingIndex] = tool;\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t\tif (this.recentTools.at(-1)?.name === tool.name) {\n\t\t\treturn false;\n\t\t}\n\t\tthis.recentTools.push(tool);\n\t\twhile (this.recentTools.length > 6) {\n\t\t\tthis.recentTools.shift();\n\t\t\tfor (const [callId, index] of this.toolIndexesByCallId) {\n\t\t\t\tif (index === 0) {\n\t\t\t\t\tthis.toolIndexesByCallId.delete(callId);\n\t\t\t\t} else {\n\t\t\t\t\tthis.toolIndexesByCallId.set(callId, index - 1);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (normalizedCallId) {\n\t\t\tthis.toolIndexesByCallId.set(normalizedCallId, this.recentTools.length - 1);\n\t\t}\n\t\treturn true;\n\t}\n\n\tprivate async sendUpdate(\n\t\tstatus: IrohRemoteLiveActivityContentState[\"status\"],\n\t\tactivityEvent: \"update\" | \"end\" = \"update\",\n\t): Promise<void> {\n\t\tconst nowSeconds = Math.floor(Date.now() / 1000);\n\t\tconst currentTool = this.recentTools.at(-1);\n\t\tconst completionState = getIrohRemoteCompletionState(this.runtimeHost);\n\t\tconst contentState: IrohRemoteLiveActivityContentState = {\n\t\t\tstatus,\n\t\t\tstatusText: liveActivityStatusText(status, currentTool),\n\t\t\t...(currentTool === undefined ? {} : { currentTool }),\n\t\t\trecentTools: this.recentTools.slice(-6),\n\t\t\tsessionID: completionState.sessionId,\n\t\t\t...(this.workspaceName === undefined ? {} : { workspaceName: this.workspaceName }),\n\t\t\tupdatedAtEpochSeconds: nowSeconds,\n\t\t};\n\t\tconst update: IrohRemoteLiveActivityUpdateIntent = {\n\t\t\teventId: `live-activity:${completionState.sessionId}:${completionState.runId ?? \"active\"}:${this.instanceId}:${++this.sequence}`,\n\t\t\tkind: activityEvent === \"end\" ? \"live_activity_end\" : \"live_activity_update\",\n\t\t\tactivityEvent,\n\t\t\tcontentState,\n\t\t\t...(activityEvent === \"end\"\n\t\t\t\t? { dismissalDateEpochSeconds: nowSeconds + 45 }\n\t\t\t\t: { staleDateEpochSeconds: nowSeconds + 90 }),\n\t\t};\n\t\tconst delivery = this.deliveryQueue.then(() => this.delivery.deliverLiveActivityUpdate(update));\n\t\tthis.deliveryQueue = delivery.then(\n\t\t\t() => {},\n\t\t\t() => {},\n\t\t);\n\t\tawait delivery;\n\t}\n}\n\nfunction createLiveActivityToolGlyph(\n\ttoolName: string | undefined,\n\tstatus: IrohRemoteLiveActivityToolGlyph[\"status\"],\n): IrohRemoteLiveActivityToolGlyph {\n\tconst name = sanitizeLiveActivityToolName(toolName);\n\treturn {\n\t\tname,\n\t\tsymbolName: liveActivitySymbolNameForTool(name),\n\t\tstatus,\n\t};\n}\n\nfunction sanitizeLiveActivityToolName(toolName: string | undefined): string {\n\tconst trimmed = toolName?.trim();\n\tif (!trimmed) {\n\t\treturn \"tool\";\n\t}\n\treturn trimmed.slice(0, 32);\n}\n\nexport function createIrohRemoteHostCommandRpcTransport(\n\toptions: IrohRemoteHostCommandRpcTransportOptions,\n): RpcTransport & { setRpcModeStartupComplete?(startupComplete: boolean): void } {\n\tlet pendingInboundCommand = Promise.resolve();\n\tconst inboundCommandContext = new AsyncLocalStorage<boolean>();\n\tconst startupAwareTransport = options.transport as {\n\t\tsetRpcModeStartupComplete?: (startupComplete: boolean) => void;\n\t};\n\tconst waitForPendingInboundCommand = async (): Promise<void> => {\n\t\t// Command handlers themselves call transport backpressure/flush/close.\n\t\t// Awaiting their own pending promise would form a cycle; external callers\n\t\t// still wait for the full serialized inbound command chain.\n\t\tif (inboundCommandContext.getStore() === true) {\n\t\t\treturn;\n\t\t}\n\t\tawait pendingInboundCommand;\n\t};\n\n\tconst writeHandlerError = async (line: string, error: unknown): Promise<void> => {\n\t\tconst target = getIrohRemoteRpcErrorTarget(line);\n\t\tawait options.transport.write(\n\t\t\tcreateIrohRemoteRpcErrorResponse(\n\t\t\t\ttarget.id,\n\t\t\t\ttarget.command,\n\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t),\n\t\t);\n\t};\n\n\tconst handleLine = async (line: string, handler: RpcLineHandler): Promise<void> => {\n\t\tconst command = parseIrohRemoteHostCommandLine(line);\n\t\tif (!command) {\n\t\t\tawait handler(line);\n\t\t\treturn;\n\t\t}\n\t\tlet response: object | undefined;\n\t\ttry {\n\t\t\tif (options.isRpcGrantCurrent && !(await options.isRpcGrantCurrent())) {\n\t\t\t\tconst target = getIrohRemoteRpcErrorTarget(line);\n\t\t\t\tresponse = createIrohRemoteRpcErrorResponse(target.id, target.command, \"RPC grant is stale; reconnect\");\n\t\t\t} else {\n\t\t\t\tresponse = await options.handleCommand?.(command);\n\t\t\t}\n\t\t} catch (error: unknown) {\n\t\t\tawait writeHandlerError(line, error);\n\t\t\treturn;\n\t\t}\n\t\tif (response === undefined) {\n\t\t\tawait handler(line);\n\t\t\treturn;\n\t\t}\n\t\tawait options.transport.write(response);\n\t};\n\n\treturn {\n\t\tsetRpcModeStartupComplete(startupComplete: boolean) {\n\t\t\tstartupAwareTransport.setRpcModeStartupComplete?.(startupComplete);\n\t\t},\n\t\twrite(value) {\n\t\t\treturn options.transport.write(value);\n\t\t},\n\t\tonLine(handler: RpcLineHandler): () => void {\n\t\t\treturn options.transport.onLine((line) => {\n\t\t\t\tpendingInboundCommand = pendingInboundCommand.then(\n\t\t\t\t\t() => inboundCommandContext.run(true, () => handleLine(line, handler)),\n\t\t\t\t\t() => inboundCommandContext.run(true, () => handleLine(line, handler)),\n\t\t\t\t);\n\t\t\t\tvoid pendingInboundCommand.catch(() => {});\n\t\t\t\treturn pendingInboundCommand;\n\t\t\t});\n\t\t},\n\t\tonClose(handler: RpcCloseHandler): () => void {\n\t\t\treturn options.transport.onClose?.(handler) ?? (() => {});\n\t\t},\n\t\tasync waitForBackpressure() {\n\t\t\tawait waitForPendingInboundCommand();\n\t\t\tawait options.transport.waitForBackpressure?.();\n\t\t},\n\t\tasync flush() {\n\t\t\tawait waitForPendingInboundCommand();\n\t\t\tawait options.transport.flush?.();\n\t\t},\n\t\tasync close() {\n\t\t\tawait waitForPendingInboundCommand();\n\t\t\tawait options.transport.close();\n\t\t},\n\t};\n}\n\nfunction parseIrohRemoteHostCommandLine(line: string): Record<string, unknown> | undefined {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(line);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!isRecord(parsed) || typeof parsed.type !== \"string\") {\n\t\treturn undefined;\n\t}\n\treturn parsed;\n}\n\nfunction getIrohRemoteRpcErrorTarget(line: string): { id: string | undefined; command: string } {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(line);\n\t\tif (!isRecord(parsed)) {\n\t\t\treturn { id: undefined, command: \"unknown\" };\n\t\t}\n\t\treturn {\n\t\t\tid: typeof parsed.id === \"string\" ? parsed.id : undefined,\n\t\t\tcommand: typeof parsed.type === \"string\" ? parsed.type : \"unknown\",\n\t\t};\n\t} catch {\n\t\treturn { id: undefined, command: \"parse\" };\n\t}\n}\n\nfunction liveActivityStatusText(\n\tstatus: IrohRemoteLiveActivityContentState[\"status\"],\n\tcurrentTool: IrohRemoteLiveActivityToolGlyph | undefined,\n): string {\n\tif (status === \"completed\") {\n\t\treturn \"Volt finished\";\n\t}\n\tif (status === \"failed\") {\n\t\treturn \"Volt needs attention\";\n\t}\n\tif (status === \"waiting\") {\n\t\treturn \"Waiting for input\";\n\t}\n\treturn currentTool ? `Using ${currentTool.name}` : \"Volt is thinking\";\n}\n\nfunction liveActivitySymbolNameForTool(toolName: string): string {\n\tswitch (toolName.toLowerCase()) {\n\t\tcase \"read\":\n\t\t\treturn \"doc.text.magnifyingglass\";\n\t\tcase \"write\":\n\t\t\treturn \"square.and.pencil\";\n\t\tcase \"edit\":\n\t\t\treturn \"pencil.and.outline\";\n\t\tcase \"bash\":\n\t\tcase \"shell\":\n\t\tcase \"terminal\":\n\t\t\treturn \"terminal\";\n\t\tcase \"find\":\n\t\tcase \"grep\":\n\t\tcase \"search\":\n\t\tcase \"rg\":\n\t\t\treturn \"magnifyingglass\";\n\t\tcase \"lsp\":\n\t\t\treturn \"point.3.connected.trianglepath.dotted\";\n\t\tcase \"build\":\n\t\tcase \"build_sim\":\n\t\tcase \"build_run_sim\":\n\t\t\treturn \"hammer\";\n\t\tcase \"test\":\n\t\tcase \"test_sim\":\n\t\t\treturn \"checkmark.seal\";\n\t\tcase \"screenshot\":\n\t\tcase \"snapshot_ui\":\n\t\t\treturn \"camera.viewfinder\";\n\t\tcase \"tap\":\n\t\tcase \"touch\":\n\t\tcase \"gesture\":\n\t\tcase \"swipe\":\n\t\tcase \"drag\":\n\t\t\treturn \"hand.tap\";\n\t\tdefault:\n\t\t\treturn \"sparkles\";\n\t}\n}\n\nexport function createIrohRemoteCloseDeferringRpcTransport(\n\toptions: IrohRemoteCloseDeferringRpcTransportOptions,\n): RpcTransport {\n\tconst pendingCommands = new Set<PendingIrohRemoteCommand>();\n\tlet rpcModeStartupComplete = true;\n\tlet startupCompletedPendingCommand = false;\n\tlet startupCleanClosePending = false;\n\tconst startupCleanCloseHandlers = new Set<() => void>();\n\n\tconst createPendingCommand = (command: string, id: string | undefined): PendingIrohRemoteCommand => {\n\t\tlet finished = false;\n\t\tlet resolveDone = () => {};\n\t\tconst pending: PendingIrohRemoteCommand = {\n\t\t\tcommand,\n\t\t\tid,\n\t\t\tinitialState: options.getCompletionState?.(),\n\t\t\tdone: new Promise<void>((resolve) => {\n\t\t\t\tresolveDone = resolve;\n\t\t\t}),\n\t\t\tresponseMatched: false,\n\t\t\tfinish() {\n\t\t\t\tif (finished) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tfinished = true;\n\t\t\t\tpendingCommands.delete(pending);\n\t\t\t\tif (!rpcModeStartupComplete) {\n\t\t\t\t\tstartupCompletedPendingCommand = true;\n\t\t\t\t}\n\t\t\t\tresolveDone();\n\t\t\t},\n\t\t};\n\t\tpendingCommands.add(pending);\n\t\treturn pending;\n\t};\n\n\tconst waitForPendingCommands = async (): Promise<void> => {\n\t\twhile (pendingCommands.size > 0) {\n\t\t\tawait Promise.allSettled([...pendingCommands].map((pending) => pending.done));\n\t\t}\n\t};\n\n\tconst findPendingCommand = (command: string, id: string | undefined): PendingIrohRemoteCommand | undefined => {\n\t\tfor (const pending of pendingCommands) {\n\t\t\tif (!pending.responseMatched && pending.command === command && pending.id === id) {\n\t\t\t\treturn pending;\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t};\n\n\tconst trackInboundLine = (line: string): PendingIrohRemoteCommand | undefined => {\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(line);\n\t\t} catch {\n\t\t\treturn createPendingCommand(\"parse\", undefined);\n\t\t}\n\t\tif (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n\t\t\treturn createPendingCommand(\"unknown\", undefined);\n\t\t}\n\t\tconst command = parsed as Record<string, unknown>;\n\t\tif (typeof command.type !== \"string\") {\n\t\t\treturn createPendingCommand(\"unknown\", typeof command.id === \"string\" ? command.id : undefined);\n\t\t}\n\t\tif (command.type === \"extension_ui_response\" || command.type === \"host_action_response\") {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn createPendingCommand(command.type, typeof command.id === \"string\" ? command.id : undefined);\n\t};\n\n\tconst notifyCompletedCommand = async (\n\t\tpending: PendingIrohRemoteCommand,\n\t\tresponse?: Record<string, unknown>,\n\t): Promise<void> => {\n\t\tawait options.onCommandCompleted?.({\n\t\t\tcommand: pending.command,\n\t\t\tid: pending.id,\n\t\t\tinitialState: pending.initialState,\n\t\t\tfinalState: options.getCompletionState?.(),\n\t\t\tresponse,\n\t\t});\n\t};\n\n\tconst finishAfterCommandCompletion = async (\n\t\tpending: PendingIrohRemoteCommand,\n\t\tresponse?: Record<string, unknown>,\n\t): Promise<void> => {\n\t\ttry {\n\t\t\tawait notifyCompletedCommand(pending, response);\n\t\t} finally {\n\t\t\tpending.finish();\n\t\t}\n\t};\n\n\tconst finishAfterPromptCompletion = async (pending: PendingIrohRemoteCommand): Promise<void> => {\n\t\ttry {\n\t\t\t// Prompt success is emitted just before AgentSession starts the run.\n\t\t\t// Steer/follow_up success means input was accepted into an active session run.\n\t\t\t// Yield once so waitForIdle observes that run or any accepted queued input.\n\t\t\tawait Promise.resolve();\n\t\t\tawait options.waitForPromptCompletion();\n\t\t\tawait notifyCompletedCommand(pending);\n\t\t} finally {\n\t\t\tpending.finish();\n\t\t}\n\t};\n\n\tconst trackOutboundResponse = (value: object): void => {\n\t\tconst response = value as Record<string, unknown>;\n\t\tif (response.type !== \"response\" || typeof response.command !== \"string\") {\n\t\t\treturn;\n\t\t}\n\t\tconst pending = findPendingCommand(response.command, typeof response.id === \"string\" ? response.id : undefined);\n\t\tif (!pending) {\n\t\t\treturn;\n\t\t}\n\t\tpending.responseMatched = true;\n\t\tif (response.success === true && shouldWaitForRemoteResponseCompletion(pending.command, response)) {\n\t\t\tvoid finishAfterPromptCompletion(pending).catch(() => {});\n\t\t\treturn;\n\t\t}\n\t\tif (response.success === true && isCompletedReviewInvocationResponse(pending.command, response)) {\n\t\t\tvoid finishAfterCommandCompletion(pending, response).catch(() => {});\n\t\t\treturn;\n\t\t}\n\t\tpending.finish();\n\t};\n\n\tconst notifyResponseWritten = async (value: object, writeResult: void | Promise<void>): Promise<void> => {\n\t\tawait writeResult;\n\t\tconst response = value as Record<string, unknown>;\n\t\tif (response.type !== \"response\") {\n\t\t\treturn;\n\t\t}\n\t\tawait options.onResponseWritten?.(response);\n\t};\n\n\tconst transport: IrohRemoteCloseDeferringRpcTransport = {\n\t\tsetRpcModeStartupComplete(startupComplete) {\n\t\t\trpcModeStartupComplete = startupComplete;\n\t\t\tif (!rpcModeStartupComplete || !startupCleanClosePending) {\n\t\t\t\tif (rpcModeStartupComplete) {\n\t\t\t\t\tstartupCompletedPendingCommand = false;\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tstartupCleanClosePending = false;\n\t\t\tstartupCompletedPendingCommand = false;\n\t\t\tfor (const handler of startupCleanCloseHandlers) {\n\t\t\t\thandler();\n\t\t\t}\n\t\t},\n\t\twrite(value) {\n\t\t\ttrackOutboundResponse(value);\n\t\t\tconst result = options.transport.write(value);\n\t\t\tif (options.onResponseWritten && (value as Record<string, unknown>).type === \"response\") {\n\t\t\t\treturn notifyResponseWritten(value, result);\n\t\t\t}\n\t\t\treturn result;\n\t\t},\n\t\tonLine(handler: RpcLineHandler): () => void {\n\t\t\treturn options.transport.onLine(async (line) => {\n\t\t\t\tconst pending = trackInboundLine(line);\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(line);\n\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\tpending?.finish();\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tonClose(handler: RpcCloseHandler): () => void {\n\t\t\tlet active = true;\n\t\t\tconst handleCleanClose = () => {\n\t\t\t\tvoid waitForPendingCommands().then(() => {\n\t\t\t\t\tif (active) {\n\t\t\t\t\t\thandler();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t};\n\t\t\tstartupCleanCloseHandlers.add(handleCleanClose);\n\t\t\tconst detach =\n\t\t\t\toptions.transport.onClose?.((error) => {\n\t\t\t\t\tif (!active) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (error) {\n\t\t\t\t\t\thandler(error);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (!rpcModeStartupComplete && (pendingCommands.size > 0 || startupCompletedPendingCommand)) {\n\t\t\t\t\t\tstartupCleanClosePending = true;\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\thandleCleanClose();\n\t\t\t\t}) ?? (() => {});\n\t\t\treturn () => {\n\t\t\t\tactive = false;\n\t\t\t\tstartupCleanCloseHandlers.delete(handleCleanClose);\n\t\t\t\tdetach();\n\t\t\t};\n\t\t},\n\t\tasync waitForBackpressure() {\n\t\t\tawait options.transport.waitForBackpressure?.();\n\t\t},\n\t\tasync flush() {\n\t\t\tawait options.transport.flush?.();\n\t\t},\n\t\tclose() {\n\t\t\treturn options.transport.close();\n\t\t},\n\t};\n\treturn transport;\n}\n\nfunction getIrohRemoteCompletionState(runtimeHost: AgentSessionRuntime): IrohRemoteCompletionState {\n\treturn {\n\t\tsessionId: runtimeHost.session.sessionId,\n\t\trunId: runtimeHost.session.sessionManager.getLeafId() ?? undefined,\n\t\tterminalOutcome: getRunTerminalOutcome(runtimeHost.session.messages),\n\t};\n}\n\nfunction createIrohRemoteCompletionNotification(\n\tcompletion: IrohRemoteCompletedCommand,\n\tworkspaceName: string | undefined,\n): IrohRemoteNotificationRequest | undefined {\n\tconst finalState = getChangedFinalCompletionState(completion);\n\tif (!finalState) {\n\t\treturn undefined;\n\t}\n\tconst workspace = getSafeNotificationWorkspace(workspaceName);\n\tconst workspaceDetails = workspace === undefined ? {} : { workspace };\n\tif (isConversationCompletionCommand(completion.command)) {\n\t\tswitch (finalState.terminalOutcome) {\n\t\t\tcase \"failed\":\n\t\t\t\treturn {\n\t\t\t\t\ttype: \"notification_request\",\n\t\t\t\t\teventId: `conversation:${finalState.sessionId}:${finalState.runId}:failed`,\n\t\t\t\t\tkind: \"host_notice\",\n\t\t\t\t\ttitle: workspace === undefined ? \"Volt needs attention\" : `Volt needs attention in ${workspace}`,\n\t\t\t\t\tbody: \"Open Volt to view the error.\",\n\t\t\t\t\tsessionId: finalState.sessionId,\n\t\t\t\t\t...workspaceDetails,\n\t\t\t\t};\n\t\t\tcase \"aborted\":\n\t\t\t\treturn undefined;\n\t\t\tcase \"completed\":\n\t\t\t\treturn {\n\t\t\t\t\ttype: \"notification_request\",\n\t\t\t\t\teventId: `conversation:${finalState.sessionId}:${finalState.runId}:completed`,\n\t\t\t\t\tkind: \"conversation_completed\",\n\t\t\t\t\ttitle: workspace === undefined ? \"Volt finished\" : `Volt finished in ${workspace}`,\n\t\t\t\t\tbody: \"Your conversation is ready.\",\n\t\t\t\t\tsessionId: finalState.sessionId,\n\t\t\t\t\t...workspaceDetails,\n\t\t\t\t};\n\t\t}\n\t}\n\tif (isCompletedReviewInvocationResponse(completion.command, completion.response)) {\n\t\treturn {\n\t\t\ttype: \"notification_request\",\n\t\t\teventId: `review:${finalState.sessionId}:${finalState.runId}:completed`,\n\t\t\tkind: \"review_completed\",\n\t\t\ttitle: workspace === undefined ? \"Review complete\" : `Review complete in ${workspace}`,\n\t\t\tbody: \"Open Volt to see the findings.\",\n\t\t\tsessionId: finalState.sessionId,\n\t\t\t...workspaceDetails,\n\t\t};\n\t}\n\treturn undefined;\n}\n\nfunction getSafeNotificationWorkspace(workspaceName: string | undefined): string | undefined {\n\tif (workspaceName === undefined) {\n\t\treturn undefined;\n\t}\n\tconst trimmed = workspaceName.trim();\n\tif (trimmed.length === 0 || trimmed.includes(\"/\") || trimmed.includes(\"\\\\\") || trimmed.includes(\"\\0\")) {\n\t\treturn undefined;\n\t}\n\treturn trimmed;\n}\n\nfunction getChangedFinalCompletionState(\n\tcompletion: IrohRemoteCompletedCommand,\n): { sessionId: string; runId: string; terminalOutcome: IrohRemoteRunTerminalOutcome } | undefined {\n\tconst finalState = completion.finalState;\n\tif (!finalState?.runId) {\n\t\treturn undefined;\n\t}\n\tconst initialState = completion.initialState;\n\tif (initialState?.sessionId === finalState.sessionId && initialState.runId === finalState.runId) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tsessionId: finalState.sessionId,\n\t\trunId: finalState.runId,\n\t\tterminalOutcome: finalState.terminalOutcome ?? \"completed\",\n\t};\n}\n\nfunction getRunTerminalOutcome(messages: readonly AgentMessage[]): IrohRemoteRunTerminalOutcome {\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst message = messages[index];\n\t\tif (message.role !== \"assistant\") {\n\t\t\tcontinue;\n\t\t}\n\t\tif (message.stopReason === \"error\") {\n\t\t\treturn \"failed\";\n\t\t}\n\t\tif (message.stopReason === \"aborted\") {\n\t\t\treturn \"aborted\";\n\t\t}\n\t\treturn \"completed\";\n\t}\n\treturn \"completed\";\n}\n\nfunction isConversationCompletionCommand(command: string): boolean {\n\treturn command === \"prompt\" || command === \"steer\" || command === \"follow_up\";\n}\n\nfunction shouldWaitForRemoteResponseCompletion(command: string, response: Record<string, unknown>): boolean {\n\tif (isConversationCompletionCommand(command)) {\n\t\treturn true;\n\t}\n\tif (command !== \"invoke_ui_action\") {\n\t\treturn false;\n\t}\n\tconst data = response.data;\n\tif (!isRecord(data)) {\n\t\treturn false;\n\t}\n\treturn data.status === \"accepted\" || data.status === \"queued\";\n}\n\nfunction isCompletedReviewInvocationResponse(\n\tcommand: string,\n\tresponse: Record<string, unknown> | undefined,\n): response is Record<string, unknown> & { data: { action: string; status: \"completed\" } } {\n\tif (command !== \"invoke_ui_action\" || !response) {\n\t\treturn false;\n\t}\n\tconst data = response.data;\n\tif (!isRecord(data)) {\n\t\treturn false;\n\t}\n\treturn data.status === \"completed\" && isReviewActionId(data.action);\n}\n\nfunction isReviewActionId(action: unknown): boolean {\n\treturn action === REVIEW_UNCOMMITTED_ACTION_ID || action === REVIEW_BRANCH_ACTION_ID;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}