@greppleai/grip 0.0.0-stage → 0.1.3

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

@@ -0,0 +1,321 @@
+/**
+ * RPC Client for programmatic access to the coding agent.
+ *
+ * Spawns the agent in RPC mode and provides a typed API for all operations.
+ */
+import type { AgentMessage, AgentToolResult, QueueMode, ThinkingLevel } from "@greppleai/grip-agent-core";
+import type { ImageContent } from "@greppleai/grip-ai";
+import type { Static, TSchema } from "typebox";
+import type { ForkableUserMessage, SessionStats, StructuredResponse, StructuredResponseOptions } from "../../core/agent-session.ts";
+import type { BashResult } from "../../core/bash-executor.ts";
+import type { CompactionResult } from "../../core/compaction/compaction.ts";
+import type { ToolInfo } from "../../core/extensions/types.ts";
+import type { ToolBackendInfo } from "../../core/tools/operations.ts";
+import type { JsonAgentSessionEvent } from "../json-event.ts";
+import type { RpcClientListSessionsResponse, RpcCommand, RpcEntriesResponseData, RpcInstructionDefinition, RpcListSessionsOptions, RpcSessionState, RpcSlashCommand, RpcToolDefinition, RpcTreeResponseData } from "./rpc-types.ts";
+/** Distributive Omit that works with union types */
+type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;
+/** RpcCommand without the id field (for internal send) */
+export type RpcCommandBody = DistributiveOmit<RpcCommand, "id">;
+export interface RpcClientStartCommand {
+    /** Executable to spawn. */
+    command: string;
+    /** Arguments passed to the executable. */
+    args: string[];
+}
+export interface RpcClientOptions {
+    /** Path to the CLI entry point (default: searches for dist/cli.js) */
+    cliPath?: string;
+    /** Override the process command used to start the RPC agent. */
+    startCommand?: RpcClientStartCommand | ((defaultCommand: RpcClientStartCommand) => RpcClientStartCommand);
+    /** Working directory for the agent */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Provider to use */
+    provider?: string;
+    /** Model ID to use */
+    model?: string;
+    /** Additional CLI arguments */
+    args?: string[];
+}
+export interface ModelInfo {
+    provider: string;
+    id: string;
+    contextWindow: number;
+    reasoning: boolean;
+}
+export type RpcEventListener = (event: JsonAgentSessionEvent) => void;
+export interface RpcToolHandlerContext {
+    toolName: string;
+    toolCallId: string;
+    signal: AbortSignal;
+}
+export interface RpcNewSessionOptions {
+    sessionId?: string;
+    parentSession?: string;
+}
+export interface RpcSessionActionResult {
+    cancelled: boolean;
+}
+export interface RpcModelReference {
+    provider: string;
+    id: string;
+}
+export interface RpcModelCycleResult {
+    model: RpcModelReference;
+    thinkingLevel: ThinkingLevel;
+    isScoped: boolean;
+}
+export interface RpcThinkingLevelCycleResult {
+    level: ThinkingLevel;
+}
+export interface RpcBashOptions {
+    record?: boolean;
+    truncate?: boolean;
+    excludeFromContext?: boolean;
+}
+export interface RpcDaemonSandboxOptions {
+    backend: "daemon";
+    url: string;
+    token?: string;
+}
+export interface RpcFileTransferResult {
+    bytes: number;
+}
+export interface RpcExportHtmlResult {
+    path: string;
+}
+export interface RpcForkResult extends RpcSessionActionResult {
+    text: string;
+}
+export type RpcEntriesResult = RpcEntriesResponseData;
+export type RpcTreeResult = RpcTreeResponseData;
+export interface RpcUnregisterResult {
+    unregistered: boolean;
+}
+export type RpcToolHandler = (args: unknown, context: RpcToolHandlerContext) => Promise<AgentToolResult<unknown>> | AgentToolResult<unknown>;
+export declare class RpcClient {
+    private process;
+    private stopReadingStdout;
+    private eventListeners;
+    private terminationListeners;
+    private pendingRequests;
+    private toolHandlers;
+    private activeToolCalls;
+    private requestId;
+    private stderr;
+    private exitError;
+    private options;
+    constructor(options?: RpcClientOptions);
+    /**
+     * Start the RPC agent process.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the RPC agent process.
+     */
+    stop(): Promise<void>;
+    /**
+     * Subscribe to agent events.
+     */
+    onEvent(listener: RpcEventListener): () => void;
+    /**
+     * Get collected stderr output (useful for debugging).
+     */
+    getStderr(): string;
+    /**
+     * Send a prompt to the agent.
+     * Returns immediately after sending; use onEvent() to receive streaming events.
+     * Use waitForIdle() to wait for completion.
+     */
+    prompt(message: string, images?: ImageContent[]): Promise<void>;
+    /**
+     * Extract a structured response from the latest assistant response.
+     */
+    getStructuredResponse<TSchemaValue extends TSchema>(options: StructuredResponseOptions<TSchemaValue>): Promise<StructuredResponse<Static<TSchemaValue>>>;
+    /**
+     * Queue a steering message to interrupt the agent mid-run.
+     */
+    steer(message: string, images?: ImageContent[]): Promise<void>;
+    /**
+     * Queue a follow-up message to be processed after the agent finishes.
+     */
+    followUp(message: string, images?: ImageContent[]): Promise<void>;
+    /**
+     * Abort current operation.
+     */
+    abort(): Promise<void>;
+    /**
+     * Start a new session, optionally with an explicit id and parent tracking.
+     * @returns Object with `cancelled: true` if an extension cancelled the new session
+     */
+    newSession(options?: string | RpcNewSessionOptions): Promise<RpcSessionActionResult>;
+    /**
+     * List sessions visible to this runtime. Results are paginated to avoid large RPC responses.
+     */
+    listSessions(options?: RpcListSessionsOptions): Promise<RpcClientListSessionsResponse>;
+    /**
+     * Get current session state.
+     */
+    getState(): Promise<RpcSessionState>;
+    /**
+     * Set model by provider and ID.
+     */
+    setModel(provider: string, modelId: string): Promise<RpcModelReference>;
+    /**
+     * Cycle to next model.
+     */
+    cycleModel(): Promise<RpcModelCycleResult | null>;
+    /**
+     * Get list of available models.
+     */
+    getAvailableModels(): Promise<ModelInfo[]>;
+    /**
+     * Set thinking level.
+     */
+    setThinkingLevel(level: ThinkingLevel): Promise<void>;
+    /**
+     * Cycle thinking level.
+     */
+    cycleThinkingLevel(): Promise<RpcThinkingLevelCycleResult | null>;
+    /**
+     * Set steering mode.
+     */
+    setSteeringMode(mode: QueueMode): Promise<void>;
+    /**
+     * Set follow-up mode.
+     */
+    setFollowUpMode(mode: QueueMode): Promise<void>;
+    /**
+     * Compact session context.
+     */
+    compact(customInstructions?: string): Promise<CompactionResult>;
+    /**
+     * Set auto-compaction enabled/disabled.
+     */
+    setAutoCompaction(enabled: boolean): Promise<void>;
+    /**
+     * Set auto-retry enabled/disabled.
+     */
+    setAutoRetry(enabled: boolean): Promise<void>;
+    /**
+     * Abort in-progress retry.
+     */
+    abortRetry(): Promise<void>;
+    /**
+     * Execute a bash command.
+     * Set options.record to false to avoid adding the result to session history.
+     * Set options.truncate to false to return complete output.
+     */
+    bash(command: string, options?: RpcBashOptions): Promise<BashResult>;
+    /**
+     * Abort running bash command.
+     */
+    abortBash(): Promise<void>;
+    /**
+     * Configure or reconfigure the deferred remote sandbox.
+     */
+    setRemoteSandbox(options: RpcDaemonSandboxOptions): Promise<ToolBackendInfo>;
+    /**
+     * Clear the deferred remote sandbox configuration.
+     */
+    clearRemoteSandbox(): Promise<ToolBackendInfo>;
+    /**
+     * Upload a file from the RPC process filesystem to the active sandbox backend.
+     */
+    uploadFile(sourcePath: string, destinationPath: string): Promise<RpcFileTransferResult>;
+    /**
+     * Download a file from the active sandbox backend to the RPC process filesystem.
+     */
+    downloadFile(sourcePath: string, destinationPath: string): Promise<RpcFileTransferResult>;
+    /**
+     * Get session statistics.
+     */
+    getSessionStats(): Promise<SessionStats>;
+    /**
+     * Export session to HTML.
+     */
+    exportHtml(outputPath?: string): Promise<RpcExportHtmlResult>;
+    /**
+     * Switch to a different session file.
+     * @returns Object with `cancelled: true` if an extension cancelled the switch
+     */
+    switchSession(sessionPath: string): Promise<RpcSessionActionResult>;
+    /**
+     * Fork from a specific message.
+     * @returns Object with `text` (the message text) and `cancelled` (if extension cancelled)
+     */
+    fork(entryId: string): Promise<RpcForkResult>;
+    /**
+     * Clone the current active branch into a new session.
+     * @returns Object with `cancelled: true` if an extension cancelled the clone
+     */
+    clone(): Promise<RpcSessionActionResult>;
+    /**
+     * Get messages available for forking.
+     */
+    getForkMessages(): Promise<ForkableUserMessage[]>;
+    /**
+     * Get session entries in append order, optionally only those after the `since` entry id.
+     */
+    getEntries(since?: string): Promise<RpcEntriesResult>;
+    /**
+     * Get the session entry tree.
+     */
+    getTree(): Promise<RpcTreeResult>;
+    /**
+     * Get text of last assistant message.
+     */
+    getLastAssistantText(): Promise<string | null>;
+    /**
+     * Set the session display name.
+     */
+    setSessionName(name: string): Promise<void>;
+    /**
+     * Get all messages in the session.
+     */
+    getMessages(): Promise<AgentMessage[]>;
+    /**
+     * Get available commands (extension commands, prompt templates, skills).
+     */
+    getCommands(): Promise<RpcSlashCommand[]>;
+    /** Register a session-scoped skill in the active RPC agent session. */
+    registerSkill(skill: RpcInstructionDefinition): Promise<void>;
+    /** Remove a session-scoped skill from the active RPC agent session. */
+    unregisterSkill(name: string): Promise<RpcUnregisterResult>;
+    /** Register a session-scoped rule in the active RPC agent session. */
+    registerRule(rule: RpcInstructionDefinition): Promise<void>;
+    /** Remove a session-scoped rule from the active RPC agent session. */
+    unregisterRule(name: string): Promise<RpcUnregisterResult>;
+    /**
+     * Register a session-scoped RPC-hosted tool. Lazy tools are advertised in the
+     * system prompt and become active only after the agent calls load_tool.
+     */
+    registerTool(tool: RpcToolDefinition, handler: RpcToolHandler): Promise<void>;
+    /** Remove a session-scoped RPC-hosted tool from the active RPC agent session. */
+    unregisterTool(name: string): Promise<RpcUnregisterResult>;
+    /** List session-scoped RPC-hosted tools registered with the active session. */
+    getAvailableTools(): Promise<ToolInfo[]>;
+    /** Wait for the full session lifecycle to settle. */
+    waitForIdle(timeout?: number): Promise<void>;
+    /**
+     * Collect events until agent becomes idle.
+     * The timeout is an inactivity timeout that resets each time an event is received.
+     */
+    collectEvents(timeout?: number): Promise<JsonAgentSessionEvent[]>;
+    /**
+     * Send prompt and wait for completion, returning all events.
+     */
+    promptAndWait(message: string, images?: ImageContent[], timeout?: number): Promise<JsonAgentSessionEvent[]>;
+    private handleLine;
+    private handleRpcToolCall;
+    private createProcessExitError;
+    private rejectPendingRequests;
+    private onTermination;
+    private writeFireAndForget;
+    private send;
+    private getData;
+}
+export {};
+//# sourceMappingURL=rpc-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/rpc-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RPC Client for programmatic access to the coding agent.\n *\n * Spawns the agent in RPC mode and provides a typed API for all operations.\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport type { AgentMessage, AgentToolResult, QueueMode, ThinkingLevel } from \"@greppleai/grip-agent-core\";\nimport type { ImageContent } from \"@greppleai/grip-ai\";\nimport type { Static, TSchema } from \"typebox\";\nimport type {\n\tForkableUserMessage,\n\tSessionStats,\n\tStructuredResponse,\n\tStructuredResponseOptions,\n} from \"../../core/agent-session.ts\";\nimport type { BashResult } from \"../../core/bash-executor.ts\";\nimport type { CompactionResult } from \"../../core/compaction/compaction.ts\";\nimport type { ToolInfo } from \"../../core/extensions/types.ts\";\nimport type { SessionEntry, SessionInfo, SessionTreeNode } from \"../../core/session/types.ts\";\nimport type { ToolBackendInfo } from \"../../core/tools/operations.ts\";\nimport type { JsonAgentSessionEvent } from \"../json-event.ts\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.ts\";\nimport type {\n\tRpcClientListSessionsResponse,\n\tRpcCommand,\n\tRpcEntriesResponseData,\n\tRpcForkMessagesResponseData,\n\tRpcInstructionDefinition,\n\tRpcListSessionsOptions,\n\tRpcListSessionsResponse,\n\tRpcResponse,\n\tRpcSessionState,\n\tRpcSlashCommand,\n\tRpcToolCallRequest,\n\tRpcToolDefinition,\n\tRpcTreeResponseData,\n} from \"./rpc-types.ts\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** Distributive Omit that works with union types */\ntype DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;\n\n/** RpcCommand without the id field (for internal send) */\nexport type RpcCommandBody = DistributiveOmit<RpcCommand, \"id\">;\n\nexport interface RpcClientStartCommand {\n\t/** Executable to spawn. */\n\tcommand: string;\n\t/** Arguments passed to the executable. */\n\targs: string[];\n}\n\nexport interface RpcClientOptions {\n\t/** Path to the CLI entry point (default: searches for dist/cli.js) */\n\tcliPath?: string;\n\t/** Override the process command used to start the RPC agent. */\n\tstartCommand?: RpcClientStartCommand | ((defaultCommand: RpcClientStartCommand) => RpcClientStartCommand);\n\t/** Working directory for the agent */\n\tcwd?: string;\n\t/** Environment variables */\n\tenv?: Record<string, string>;\n\t/** Provider to use */\n\tprovider?: string;\n\t/** Model ID to use */\n\tmodel?: string;\n\t/** Additional CLI arguments */\n\targs?: string[];\n}\n\nexport interface ModelInfo {\n\tprovider: string;\n\tid: string;\n\tcontextWindow: number;\n\treasoning: boolean;\n}\nexport type RpcEventListener = (event: JsonAgentSessionEvent) => void;\n\nexport interface RpcToolHandlerContext {\n\ttoolName: string;\n\ttoolCallId: string;\n\tsignal: AbortSignal;\n}\n\nexport interface RpcNewSessionOptions {\n\tsessionId?: string;\n\tparentSession?: string;\n}\n\nexport interface RpcSessionActionResult {\n\tcancelled: boolean;\n}\n\n// grip-ignore noNearIdenticalDataStructures: RPC wire model selection and faux-provider test response overrides evolve under separate protocol and fixture ownership.\nexport interface RpcModelReference {\n\tprovider: string;\n\tid: string;\n}\n\nexport interface RpcModelCycleResult {\n\tmodel: RpcModelReference;\n\tthinkingLevel: ThinkingLevel;\n\tisScoped: boolean;\n}\n\nexport interface RpcThinkingLevelCycleResult {\n\tlevel: ThinkingLevel;\n}\n\nexport interface RpcBashOptions {\n\trecord?: boolean;\n\ttruncate?: boolean;\n\texcludeFromContext?: boolean;\n}\n\nexport interface RpcDaemonSandboxOptions {\n\tbackend: \"daemon\";\n\turl: string;\n\ttoken?: string;\n}\n\nexport interface RpcFileTransferResult {\n\tbytes: number;\n}\n\nexport interface RpcExportHtmlResult {\n\tpath: string;\n}\n\nexport interface RpcForkResult extends RpcSessionActionResult {\n\ttext: string;\n}\n\nexport type RpcEntriesResult = RpcEntriesResponseData;\n\nexport type RpcTreeResult = RpcTreeResponseData;\n\nexport interface RpcUnregisterResult {\n\tunregistered: boolean;\n}\n\nexport type RpcToolHandler = (\n\targs: unknown,\n\tcontext: RpcToolHandlerContext,\n) => Promise<AgentToolResult<unknown>> | AgentToolResult<unknown>;\n\n// ============================================================================\n// RPC Client\n// ============================================================================\n\nexport class RpcClient {\n\tprivate process: ChildProcess | null = null;\n\tprivate stopReadingStdout: (() => void) | null = null;\n\tprivate eventListeners: RpcEventListener[] = [];\n\tprivate terminationListeners = new Set<(error: Error) => void>();\n\tprivate pendingRequests: Map<string, { resolve: (response: RpcResponse) => void; reject: (error: Error) => void }> =\n\t\tnew Map();\n\tprivate toolHandlers: Map<string, RpcToolHandler> = new Map();\n\tprivate activeToolCalls: Map<string, AbortController> = new Map();\n\tprivate requestId = 0;\n\tprivate stderr = \"\";\n\tprivate exitError: Error | null = null;\n\tprivate options: RpcClientOptions;\n\n\tconstructor(options: RpcClientOptions = {}) {\n\t\tthis.options = options;\n\t}\n\n\t/**\n\t * Start the RPC agent process.\n\t */\n\tasync start(): Promise<void> {\n\t\tif (this.process) {\n\t\t\tthrow new Error(\"Client already started\");\n\t\t}\n\n\t\tthis.exitError = null;\n\n\t\tconst cliPath = this.options.cliPath ?? \"dist/cli.ts\";\n\t\tconst args = [\"--mode\", \"rpc\"];\n\n\t\tif (this.options.provider) {\n\t\t\targs.push(\"--provider\", this.options.provider);\n\t\t}\n\t\tif (this.options.model) {\n\t\t\targs.push(\"--model\", this.options.model);\n\t\t}\n\t\tif (this.options.args) {\n\t\t\targs.push(...this.options.args);\n\t\t}\n\n\t\tconst defaultStartCommand: RpcClientStartCommand = { command: \"node\", args: [cliPath, ...args] };\n\t\tconst startCommand =\n\t\t\ttypeof this.options.startCommand === \"function\"\n\t\t\t\t? this.options.startCommand(defaultStartCommand)\n\t\t\t\t: (this.options.startCommand ?? defaultStartCommand);\n\n\t\tconst childProcess = spawn(startCommand.command, startCommand.args, {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: { ...process.env, ...this.options.env },\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\t\tthis.process = childProcess;\n\n\t\t// Collect stderr for debugging\n\t\tchildProcess.stderr?.on(\"data\", (data) => {\n\t\t\tthis.stderr += data.toString();\n\t\t\tprocess.stderr.write(data);\n\t\t});\n\n\t\tchildProcess.once(\"exit\", (code, signal) => {\n\t\t\tif (this.process !== childProcess) return;\n\t\t\tconst error = this.createProcessExitError(code, signal);\n\t\t\tthis.exitError = error;\n\t\t\tthis.rejectPendingRequests(error);\n\t\t});\n\t\tchildProcess.once(\"error\", (error) => {\n\t\t\tif (this.process !== childProcess) return;\n\t\t\tconst processError = new Error(`Agent process error: ${error.message}. Stderr: ${this.stderr}`);\n\t\t\tthis.exitError = processError;\n\t\t\tthis.rejectPendingRequests(processError);\n\t\t});\n\t\tchildProcess.stdin?.on(\"error\", (error) => {\n\t\t\tif (this.process !== childProcess) return;\n\t\t\tconst stdinError =\n\t\t\t\tthis.exitError ?? new Error(`Agent process stdin error: ${error.message}. Stderr: ${this.stderr}`);\n\t\t\tthis.exitError = stdinError;\n\t\t\tthis.rejectPendingRequests(stdinError);\n\t\t});\n\n\t\t// Set up strict JSONL reader for stdout.\n\t\tthis.stopReadingStdout = attachJsonlLineReader(childProcess.stdout!, (line) => {\n\t\t\tthis.handleLine(line);\n\t\t});\n\n\t\t// Wait a moment for process to initialize\n\t\tawait new Promise((resolve) => setTimeout(resolve, 100));\n\n\t\tif (this.process.exitCode !== null) {\n\t\t\tconst error = this.exitError ?? this.createProcessExitError(this.process.exitCode, this.process.signalCode);\n\t\t\tthis.exitError = error;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\t/**\n\t * Stop the RPC agent process.\n\t */\n\tasync stop(): Promise<void> {\n\t\tif (!this.process) return;\n\n\t\tthis.stopReadingStdout?.();\n\t\tthis.stopReadingStdout = null;\n\t\tthis.process.kill(\"SIGTERM\");\n\n\t\t// Wait for process to exit\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tthis.process?.kill(\"SIGKILL\");\n\t\t\t\tresolve();\n\t\t\t}, 1000);\n\n\t\t\tthis.process?.on(\"exit\", () => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tresolve();\n\t\t\t});\n\t\t});\n\n\t\tthis.process = null;\n\t\tthis.pendingRequests.clear();\n\t\tfor (const controller of this.activeToolCalls.values()) {\n\t\t\tcontroller.abort();\n\t\t}\n\t\tthis.activeToolCalls.clear();\n\t}\n\n\t/**\n\t * Subscribe to agent events.\n\t */\n\tonEvent(listener: RpcEventListener): () => void {\n\t\tthis.eventListeners.push(listener);\n\t\treturn () => {\n\t\t\tconst index = this.eventListeners.indexOf(listener);\n\t\t\tif (index !== -1) {\n\t\t\t\tthis.eventListeners.splice(index, 1);\n\t\t\t}\n\t\t};\n\t}\n\n\t/**\n\t * Get collected stderr output (useful for debugging).\n\t */\n\tgetStderr(): string {\n\t\treturn this.stderr;\n\t}\n\n\t// =========================================================================\n\t// Command Methods\n\t// =========================================================================\n\n\t/**\n\t * Send a prompt to the agent.\n\t * Returns immediately after sending; use onEvent() to receive streaming events.\n\t * Use waitForIdle() to wait for completion.\n\t */\n\tasync prompt(message: string, images?: ImageContent[]): Promise<void> {\n\t\tawait this.send({ type: \"prompt\", message, images });\n\t}\n\n\t/**\n\t * Extract a structured response from the latest assistant response.\n\t */\n\tasync getStructuredResponse<TSchemaValue extends TSchema>(\n\t\toptions: StructuredResponseOptions<TSchemaValue>,\n\t): Promise<StructuredResponse<Static<TSchemaValue>>> {\n\t\tconst response = await this.send({ type: \"get_structured_response\", ...options });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Queue a steering message to interrupt the agent mid-run.\n\t */\n\tasync steer(message: string, images?: ImageContent[]): Promise<void> {\n\t\tawait this.send({ type: \"steer\", message, images });\n\t}\n\n\t/**\n\t * Queue a follow-up message to be processed after the agent finishes.\n\t */\n\tasync followUp(message: string, images?: ImageContent[]): Promise<void> {\n\t\tawait this.send({ type: \"follow_up\", message, images });\n\t}\n\n\t/**\n\t * Abort current operation.\n\t */\n\tasync abort(): Promise<void> {\n\t\tawait this.send({ type: \"abort\" });\n\t}\n\n\t/**\n\t * Start a new session, optionally with an explicit id and parent tracking.\n\t * @returns Object with `cancelled: true` if an extension cancelled the new session\n\t */\n\tasync newSession(options?: string | RpcNewSessionOptions): Promise<RpcSessionActionResult> {\n\t\tconst sessionOptions = typeof options === \"string\" ? { parentSession: options } : options;\n\t\tconst response = await this.send({\n\t\t\ttype: \"new_session\",\n\t\t\tsessionId: sessionOptions?.sessionId,\n\t\t\tparentSession: sessionOptions?.parentSession,\n\t\t});\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * List sessions visible to this runtime. Results are paginated to avoid large RPC responses.\n\t */\n\tasync listSessions(options: RpcListSessionsOptions = {}): Promise<RpcClientListSessionsResponse> {\n\t\tconst response = await this.send({ type: \"list_sessions\", cursor: options.cursor, limit: options.limit });\n\t\tconst data = this.getData<RpcListSessionsResponse>(response);\n\t\treturn {\n\t\t\tsessions: data.sessions.map((session) => reviveSessionInfo(session)),\n\t\t\tnextCursor: data.nextCursor,\n\t\t};\n\t}\n\n\t/**\n\t * Get current session state.\n\t */\n\tasync getState(): Promise<RpcSessionState> {\n\t\tconst response = await this.send({ type: \"get_state\" });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Set model by provider and ID.\n\t */\n\tasync setModel(provider: string, modelId: string): Promise<RpcModelReference> {\n\t\tconst response = await this.send({ type: \"set_model\", provider, modelId });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Cycle to next model.\n\t */\n\tasync cycleModel(): Promise<RpcModelCycleResult | null> {\n\t\tconst response = await this.send({ type: \"cycle_model\" });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Get list of available models.\n\t */\n\tasync getAvailableModels(): Promise<ModelInfo[]> {\n\t\tconst response = await this.send({ type: \"get_available_models\" });\n\t\treturn this.getData<{ models: ModelInfo[] }>(response).models;\n\t}\n\n\t/**\n\t * Set thinking level.\n\t */\n\tasync setThinkingLevel(level: ThinkingLevel): Promise<void> {\n\t\tawait this.send({ type: \"set_thinking_level\", level });\n\t}\n\n\t/**\n\t * Cycle thinking level.\n\t */\n\tasync cycleThinkingLevel(): Promise<RpcThinkingLevelCycleResult | null> {\n\t\tconst response = await this.send({ type: \"cycle_thinking_level\" });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Set steering mode.\n\t */\n\tasync setSteeringMode(mode: QueueMode): Promise<void> {\n\t\tawait this.send({ type: \"set_steering_mode\", mode });\n\t}\n\n\t/**\n\t * Set follow-up mode.\n\t */\n\tasync setFollowUpMode(mode: QueueMode): Promise<void> {\n\t\tawait this.send({ type: \"set_follow_up_mode\", mode });\n\t}\n\n\t/**\n\t * Compact session context.\n\t */\n\tasync compact(customInstructions?: string): Promise<CompactionResult> {\n\t\tconst response = await this.send({ type: \"compact\", customInstructions });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Set auto-compaction enabled/disabled.\n\t */\n\tasync setAutoCompaction(enabled: boolean): Promise<void> {\n\t\tawait this.send({ type: \"set_auto_compaction\", enabled });\n\t}\n\n\t/**\n\t * Set auto-retry enabled/disabled.\n\t */\n\tasync setAutoRetry(enabled: boolean): Promise<void> {\n\t\tawait this.send({ type: \"set_auto_retry\", enabled });\n\t}\n\n\t/**\n\t * Abort in-progress retry.\n\t */\n\tasync abortRetry(): Promise<void> {\n\t\tawait this.send({ type: \"abort_retry\" });\n\t}\n\n\t/**\n\t * Execute a bash command.\n\t * Set options.record to false to avoid adding the result to session history.\n\t * Set options.truncate to false to return complete output.\n\t */\n\tasync bash(command: string, options: RpcBashOptions = {}): Promise<BashResult> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"bash\",\n\t\t\tcommand,\n\t\t\trecord: options.record,\n\t\t\ttruncate: options.truncate,\n\t\t\texcludeFromContext: options.excludeFromContext,\n\t\t});\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Abort running bash command.\n\t */\n\tasync abortBash(): Promise<void> {\n\t\tawait this.send({ type: \"abort_bash\" });\n\t}\n\n\t/**\n\t * Configure or reconfigure the deferred remote sandbox.\n\t */\n\tasync setRemoteSandbox(options: RpcDaemonSandboxOptions): Promise<ToolBackendInfo> {\n\t\tconst response = await this.send({ type: \"set_remote_sandbox\", ...options });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Clear the deferred remote sandbox configuration.\n\t */\n\tasync clearRemoteSandbox(): Promise<ToolBackendInfo> {\n\t\tconst response = await this.send({ type: \"clear_remote_sandbox\" });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Upload a file from the RPC process filesystem to the active sandbox backend.\n\t */\n\tasync uploadFile(sourcePath: string, destinationPath: string): Promise<RpcFileTransferResult> {\n\t\tconst response = await this.send({ type: \"upload_file\", sourcePath, destinationPath });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Download a file from the active sandbox backend to the RPC process filesystem.\n\t */\n\tasync downloadFile(sourcePath: string, destinationPath: string): Promise<RpcFileTransferResult> {\n\t\tconst response = await this.send({ type: \"download_file\", sourcePath, destinationPath });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Get session statistics.\n\t */\n\tasync getSessionStats(): Promise<SessionStats> {\n\t\tconst response = await this.send({ type: \"get_session_stats\" });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Export session to HTML.\n\t */\n\tasync exportHtml(outputPath?: string): Promise<RpcExportHtmlResult> {\n\t\tconst response = await this.send({ type: \"export_html\", outputPath });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Switch to a different session file.\n\t * @returns Object with `cancelled: true` if an extension cancelled the switch\n\t */\n\tasync switchSession(sessionPath: string): Promise<RpcSessionActionResult> {\n\t\tconst response = await this.send({ type: \"switch_session\", sessionPath });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Fork from a specific message.\n\t * @returns Object with `text` (the message text) and `cancelled` (if extension cancelled)\n\t */\n\tasync fork(entryId: string): Promise<RpcForkResult> {\n\t\tconst response = await this.send({ type: \"fork\", entryId });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Clone the current active branch into a new session.\n\t * @returns Object with `cancelled: true` if an extension cancelled the clone\n\t */\n\tasync clone(): Promise<RpcSessionActionResult> {\n\t\tconst response = await this.send({ type: \"clone\" });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Get messages available for forking.\n\t */\n\tasync getForkMessages(): Promise<ForkableUserMessage[]> {\n\t\tconst response = await this.send({ type: \"get_fork_messages\" });\n\t\treturn this.getData<RpcForkMessagesResponseData>(response).messages;\n\t}\n\n\t/**\n\t * Get session entries in append order, optionally only those after the `since` entry id.\n\t */\n\tasync getEntries(since?: string): Promise<RpcEntriesResult> {\n\t\tconst response = await this.send({ type: \"get_entries\", since });\n\t\treturn this.getData<{ entries: SessionEntry[]; leafId: string | null }>(response);\n\t}\n\n\t/**\n\t * Get the session entry tree.\n\t */\n\tasync getTree(): Promise<RpcTreeResult> {\n\t\tconst response = await this.send({ type: \"get_tree\" });\n\t\treturn this.getData<{ tree: SessionTreeNode[]; leafId: string | null }>(response);\n\t}\n\n\t/**\n\t * Get text of last assistant message.\n\t */\n\tasync getLastAssistantText(): Promise<string | null> {\n\t\tconst response = await this.send({ type: \"get_last_assistant_text\" });\n\t\treturn this.getData<{ text: string | null }>(response).text;\n\t}\n\n\t/**\n\t * Set the session display name.\n\t */\n\tasync setSessionName(name: string): Promise<void> {\n\t\tawait this.send({ type: \"set_session_name\", name });\n\t}\n\n\t/**\n\t * Get all messages in the session.\n\t */\n\tasync getMessages(): Promise<AgentMessage[]> {\n\t\tconst response = await this.send({ type: \"get_messages\" });\n\t\treturn this.getData<{ messages: AgentMessage[] }>(response).messages;\n\t}\n\n\t/**\n\t * Get available commands (extension commands, prompt templates, skills).\n\t */\n\tasync getCommands(): Promise<RpcSlashCommand[]> {\n\t\tconst response = await this.send({ type: \"get_commands\" });\n\t\treturn this.getData<{ commands: RpcSlashCommand[] }>(response).commands;\n\t}\n\n\t/** Register a session-scoped skill in the active RPC agent session. */\n\tasync registerSkill(skill: RpcInstructionDefinition): Promise<void> {\n\t\tawait this.send({ type: \"register_skill\", skill });\n\t}\n\n\t/** Remove a session-scoped skill from the active RPC agent session. */\n\tasync unregisterSkill(name: string): Promise<RpcUnregisterResult> {\n\t\tconst response = await this.send({ type: \"unregister_skill\", name });\n\t\treturn this.getData(response);\n\t}\n\n\t/** Register a session-scoped rule in the active RPC agent session. */\n\tasync registerRule(rule: RpcInstructionDefinition): Promise<void> {\n\t\tawait this.send({ type: \"register_rule\", rule });\n\t}\n\n\t/** Remove a session-scoped rule from the active RPC agent session. */\n\tasync unregisterRule(name: string): Promise<RpcUnregisterResult> {\n\t\tconst response = await this.send({ type: \"unregister_rule\", name });\n\t\treturn this.getData(response);\n\t}\n\n\t/**\n\t * Register a session-scoped RPC-hosted tool. Lazy tools are advertised in the\n\t * system prompt and become active only after the agent calls load_tool.\n\t */\n\tasync registerTool(tool: RpcToolDefinition, handler: RpcToolHandler): Promise<void> {\n\t\tthis.toolHandlers.set(tool.name, handler);\n\t\ttry {\n\t\t\tawait this.send({ type: \"register_tool\", tool });\n\t\t} catch (error) {\n\t\t\tthis.toolHandlers.delete(tool.name);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\t/** Remove a session-scoped RPC-hosted tool from the active RPC agent session. */\n\tasync unregisterTool(name: string): Promise<RpcUnregisterResult> {\n\t\tthis.toolHandlers.delete(name);\n\t\tconst response = await this.send({ type: \"unregister_tool\", name });\n\t\treturn this.getData(response);\n\t}\n\n\t/** List session-scoped RPC-hosted tools registered with the active session. */\n\tasync getAvailableTools(): Promise<ToolInfo[]> {\n\t\tconst response = await this.send({ type: \"get_available_tools\" });\n\t\treturn this.getData<{ tools: ToolInfo[] }>(response).tools;\n\t}\n\n\t// =========================================================================\n\t// Helpers\n\t// =========================================================================\n\n\t/** Wait for the full session lifecycle to settle. */\n\twaitForIdle(timeout = 5 * 60 * 1000): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\t\t\tlet finished = false;\n\t\t\tlet unsubscribe = () => {};\n\t\t\tlet unsubscribeTermination = () => {};\n\t\t\tconst finish = (error?: Error) => {\n\t\t\t\tif (finished) return;\n\t\t\t\tfinished = true;\n\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\tunsubscribe();\n\t\t\t\tunsubscribeTermination();\n\t\t\t\tif (error) reject(error);\n\t\t\t\telse resolve();\n\t\t\t};\n\t\t\tconst resetTimer = () => {\n\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\ttimer = setTimeout(\n\t\t\t\t\t() => finish(new Error(`Timeout waiting for agent to become idle. Stderr: ${this.stderr}`)),\n\t\t\t\t\ttimeout,\n\t\t\t\t);\n\t\t\t};\n\t\t\tunsubscribe = this.onEvent((event) => {\n\t\t\t\tresetTimer();\n\t\t\t\tif (event.type === \"agent_settled\") finish();\n\t\t\t});\n\t\t\tunsubscribeTermination = this.onTermination((error) => finish(error));\n\t\t\tresetTimer();\n\t\t\tvoid this.getState().then(\n\t\t\t\t(state) => {\n\t\t\t\t\tif (state.isIdle) finish();\n\t\t\t\t},\n\t\t\t\t(error: unknown) => finish(error instanceof Error ? error : new Error(String(error))),\n\t\t\t);\n\t\t});\n\t}\n\n\t/**\n\t * Collect events until agent becomes idle.\n\t * The timeout is an inactivity timeout that resets each time an event is received.\n\t */\n\tcollectEvents(timeout = 5 * 60 * 1000): Promise<JsonAgentSessionEvent[]> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst events: JsonAgentSessionEvent[] = [];\n\t\t\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\t\t\tlet finished = false;\n\t\t\tlet unsubscribe = () => {};\n\t\t\tlet unsubscribeTermination = () => {};\n\t\t\tconst finish = (error?: Error) => {\n\t\t\t\tif (finished) return;\n\t\t\t\tfinished = true;\n\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\tunsubscribe();\n\t\t\t\tunsubscribeTermination();\n\t\t\t\tif (error) reject(error);\n\t\t\t\telse resolve(events);\n\t\t\t};\n\t\t\tconst resetTimer = () => {\n\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\ttimer = setTimeout(() => finish(new Error(`Timeout collecting events. Stderr: ${this.stderr}`)), timeout);\n\t\t\t};\n\n\t\t\tunsubscribe = this.onEvent((event) => {\n\t\t\t\tevents.push(event);\n\t\t\t\tresetTimer();\n\t\t\t\tif (event.type === \"agent_settled\") finish();\n\t\t\t});\n\t\t\tunsubscribeTermination = this.onTermination((error) => finish(error));\n\t\t\tresetTimer();\n\t\t});\n\t}\n\n\t/**\n\t * Send prompt and wait for completion, returning all events.\n\t */\n\tasync promptAndWait(\n\t\tmessage: string,\n\t\timages?: ImageContent[],\n\t\ttimeout = 5 * 60 * 1000,\n\t): Promise<JsonAgentSessionEvent[]> {\n\t\tconst events: JsonAgentSessionEvent[] = [];\n\t\tlet accepted = false;\n\t\tlet sawAgentStart = false;\n\t\tlet settledAfterStart = false;\n\t\tlet finished = false;\n\t\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\t\tlet unsubscribe = () => {};\n\t\tlet unsubscribeTermination = () => {};\n\t\tlet resolveCompletion = (_events: JsonAgentSessionEvent[]) => {};\n\t\tlet rejectCompletion = (_error: Error) => {};\n\t\tconst completion = new Promise<JsonAgentSessionEvent[]>((resolve, reject) => {\n\t\t\tresolveCompletion = resolve;\n\t\t\trejectCompletion = reject;\n\t\t});\n\t\tconst finish = (error?: Error) => {\n\t\t\tif (finished) return;\n\t\t\tfinished = true;\n\t\t\tif (timer) clearTimeout(timer);\n\t\t\tunsubscribe();\n\t\t\tunsubscribeTermination();\n\t\t\tif (error) rejectCompletion(error);\n\t\t\telse resolveCompletion(events);\n\t\t};\n\t\tconst resetTimer = () => {\n\t\t\tif (timer) clearTimeout(timer);\n\t\t\ttimer = setTimeout(() => finish(new Error(`Timeout collecting events. Stderr: ${this.stderr}`)), timeout);\n\t\t};\n\t\tunsubscribe = this.onEvent((event) => {\n\t\t\tresetTimer();\n\t\t\tif (!sawAgentStart) {\n\t\t\t\tif (event.type !== \"agent_start\") return;\n\t\t\t\tsawAgentStart = true;\n\t\t\t}\n\t\t\tevents.push(event);\n\t\t\tif (event.type === \"agent_settled\") {\n\t\t\t\tsettledAfterStart = true;\n\t\t\t\tif (accepted) finish();\n\t\t\t}\n\t\t});\n\t\tresetTimer();\n\n\t\ttry {\n\t\t\tawait this.prompt(message, images);\n\t\t} catch (error) {\n\t\t\tfinished = true;\n\t\t\tif (timer) clearTimeout(timer);\n\t\t\tunsubscribe();\n\t\t\tthrow error;\n\t\t}\n\t\taccepted = true;\n\t\tunsubscribeTermination = this.onTermination((error) => finish(error));\n\t\tif (settledAfterStart) finish();\n\t\telse {\n\t\t\tvoid this.getState().then(\n\t\t\t\t(state) => {\n\t\t\t\t\tif (state.isIdle && !sawAgentStart) finish();\n\t\t\t\t},\n\t\t\t\t(error: unknown) => finish(error instanceof Error ? error : new Error(String(error))),\n\t\t\t);\n\t\t}\n\t\treturn completion;\n\t}\n\n\t// =========================================================================\n\t// Internal\n\t// =========================================================================\n\n\tprivate handleLine(line: string): void {\n\t\ttry {\n\t\t\tconst data = JSON.parse(line);\n\n\t\t\tif (data.type === \"rpc_tool_call\") {\n\t\t\t\tvoid this.handleRpcToolCall(data as RpcToolCallRequest);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Check if it's a response to a pending request\n\t\t\tif (data.type === \"response\" && data.id && this.pendingRequests.has(data.id)) {\n\t\t\t\tconst pending = this.pendingRequests.get(data.id)!;\n\t\t\t\tthis.pendingRequests.delete(data.id);\n\t\t\t\tpending.resolve(data as RpcResponse);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Otherwise it's an event\n\t\t\tfor (const listener of this.eventListeners) {\n\t\t\t\tlistener(data as JsonAgentSessionEvent);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Ignore non-JSON lines\n\t\t}\n\t}\n\n\tprivate async handleRpcToolCall(request: RpcToolCallRequest): Promise<void> {\n\t\tconst handler = this.toolHandlers.get(request.toolName);\n\t\tif (!handler) {\n\t\t\tthis.writeFireAndForget({\n\t\t\t\ttype: \"rpc_tool_error\",\n\t\t\t\trequestId: request.requestId,\n\t\t\t\terror: `No RPC tool handler registered for ${request.toolName}`,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tconst abortController = new AbortController();\n\t\tthis.activeToolCalls.set(request.requestId, abortController);\n\t\ttry {\n\t\t\tconst result = await handler(request.args, {\n\t\t\t\ttoolName: request.toolName,\n\t\t\t\ttoolCallId: request.toolCallId,\n\t\t\t\tsignal: abortController.signal,\n\t\t\t});\n\t\t\tthis.writeFireAndForget({ type: \"rpc_tool_result\", requestId: request.requestId, result });\n\t\t} catch (error: unknown) {\n\t\t\tthis.writeFireAndForget({\n\t\t\t\ttype: \"rpc_tool_error\",\n\t\t\t\trequestId: request.requestId,\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t});\n\t\t} finally {\n\t\t\tthis.activeToolCalls.delete(request.requestId);\n\t\t}\n\t}\n\n\tprivate createProcessExitError(code: number | null, signal: NodeJS.Signals | null): Error {\n\t\treturn new Error(`Agent process exited (code=${code} signal=${signal}). Stderr: ${this.stderr}`);\n\t}\n\n\tprivate rejectPendingRequests(error: Error): void {\n\t\tfor (const pending of this.pendingRequests.values()) {\n\t\t\tpending.reject(error);\n\t\t}\n\t\tthis.pendingRequests.clear();\n\t\tfor (const listener of [...this.terminationListeners]) listener(error);\n\t}\n\n\tprivate onTermination(listener: (error: Error) => void): () => void {\n\t\tif (this.exitError) {\n\t\t\tlistener(this.exitError);\n\t\t\treturn () => {};\n\t\t}\n\t\tthis.terminationListeners.add(listener);\n\t\treturn () => this.terminationListeners.delete(listener);\n\t}\n\n\tprivate writeFireAndForget(command: RpcCommandBody): void {\n\t\tconst stdin = this.process?.stdin;\n\t\tif (!stdin || stdin.destroyed || !stdin.writable) {\n\t\t\treturn;\n\t\t}\n\t\tstdin.write(serializeJsonLine(command));\n\t}\n\n\tprivate async send(command: RpcCommandBody): Promise<RpcResponse> {\n\t\tconst childProcess = this.process;\n\t\tconst stdin = childProcess?.stdin;\n\t\tif (!childProcess || !stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tif (this.exitError) {\n\t\t\tthrow this.exitError;\n\t\t}\n\t\tif (childProcess.exitCode !== null) {\n\t\t\tconst error = this.createProcessExitError(childProcess.exitCode, childProcess.signalCode);\n\t\t\tthis.exitError = error;\n\t\t\tthrow error;\n\t\t}\n\t\tif (stdin.destroyed || !stdin.writable) {\n\t\t\tconst error = new Error(`Agent process stdin is not writable. Stderr: ${this.stderr}`);\n\t\t\tthis.exitError = error;\n\t\t\tthrow error;\n\t\t}\n\n\t\tconst id = `req_${++this.requestId}`;\n\t\tconst fullCommand = { ...command, id } as RpcCommand;\n\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tthis.pendingRequests.delete(id);\n\t\t\t\treject(new Error(`Timeout waiting for response to ${command.type}. Stderr: ${this.stderr}`));\n\t\t\t}, 30000);\n\n\t\t\tthis.pendingRequests.set(id, {\n\t\t\t\tresolve: (response) => {\n\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\tresolve(response);\n\t\t\t\t},\n\t\t\t\treject: (error) => {\n\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\treject(error);\n\t\t\t\t},\n\t\t\t});\n\n\t\t\ttry {\n\t\t\t\tstdin.write(serializeJsonLine(fullCommand));\n\t\t\t} catch (error: unknown) {\n\t\t\t\tconst writeError = error instanceof Error ? error : new Error(String(error));\n\t\t\t\tconst pending = this.pendingRequests.get(id);\n\t\t\t\tthis.pendingRequests.delete(id);\n\t\t\t\tpending?.reject(writeError);\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate getData<T>(response: RpcResponse): T {\n\t\tif (!response.success) {\n\t\t\tconst errorResponse = response as Extract<RpcResponse, { success: false }>;\n\t\t\tthrow new Error(errorResponse.error);\n\t\t}\n\t\t// Type assertion: we trust response.data matches T based on the command sent.\n\t\t// This is safe because each public method specifies the correct T for its command.\n\t\tconst successResponse = response as Extract<RpcResponse, { success: true; data: unknown }>;\n\t\treturn successResponse.data as T;\n\t}\n}\n\nfunction reviveSessionInfo(session: SessionInfo): SessionInfo {\n\treturn {\n\t\t...session,\n\t\tcreated: new Date(session.created),\n\t\tmodified: new Date(session.modified),\n\t};\n}\n"]}