@ai-agent-forge/agent-forge 0.85.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-mode.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/rpc-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,KAAK,EAEX,iBAAiB,EAEjB,oBAAoB,EACpB,MAAM,gCAAgC,CAAC;AASxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAM3G,OAAO,KAAK,EAGX,sBAAsB,EAItB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACX,UAAU,EACV,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,eAAe,GACf,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,sBAAsB,GAAG,oBAAoB,CAKpG;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,YAAY,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC;IACvE;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,2BAA2B,KAAK,iBAAiB,GAAG,SAAS,CAAC;IACtF;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;QACjC,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;KACvD,CAAC;CACF;AAED,wBAAsB,UAAU,CAAC,WAAW,EAAE,mBAAmB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,KAAK,CAAC,CAgnB/G","sourcesContent":["/**\n * RPC mode: Headless operation with JSON stdin/stdout protocol.\n *\n * Used for embedding the agent in other applications.\n * Receives commands as JSON on stdin, outputs events and responses as JSON on stdout.\n *\n * Protocol:\n * - Commands: JSON objects with `type` field, optional `id` for correlation\n * - Responses: JSON objects with `type: \"response\"`, `command`, `success`, and optional `data`/`error`\n * - Events: AgentSessionEvent objects streamed as they occur\n * - Extension UI: Extension UI requests are emitted, client responds with extension_ui_response\n */\n\nimport * as crypto from \"node:crypto\";\nimport type { AgentSessionRuntime } from \"../../core/agent-session-runtime.ts\";\nimport type { CapabilityRuntime } from \"../../core/extensions/capability-runtime.ts\";\nimport type {\n\tInteractionDialogOptions,\n\tInteractionHostV1,\n\tInteractionNotifyLevel,\n\tInteractionOutcomeV1,\n} from \"../../core/extensions/index.ts\";\nimport { createCodingAgentFacade, createCodingAgentRuntimeFacade } from \"../../core/facade/index.ts\";\nimport {\n\tflushRawStdout,\n\ttakeOverStdout,\n\twaitForRawStdoutBackpressure,\n\twriteRawStdout,\n} from \"../../core/output-guard.ts\";\nimport { createSyntheticSourceInfo } from \"../../core/source-info.ts\";\nimport type { MetricsSnapshotV1, ObservabilityMetricsOptions } from \"../../plugins/observability-types.ts\";\n\nimport { readSessionSuiteId } from \"../../profiles/suite-loader.ts\";\nimport { killTrackedDetachedChildren } from \"../../utils/shell.ts\";\nimport { toJsonEvent } from \"../json-event.ts\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.ts\";\nimport type {\n\tRpcCommand,\n\tRpcExtensionUIRequest,\n\tRpcExtensionUIResponse,\n\tRpcResponse,\n\tRpcSessionState,\n\tRpcSlashCommand,\n} from \"./rpc-types.ts\";\n\n// Re-export types for consumers\nexport type {\n\tRpcCommand,\n\tRpcExtensionUIRequest,\n\tRpcExtensionUIResponse,\n\tRpcResponse,\n\tRpcSessionState,\n} from \"./rpc-types.ts\";\n\n/**\n * Map an RPC extension_ui_response onto the frozen interaction outcome\n * (1A.8): {value} and {confirmed} are answers; {cancelled:true} — or an\n * unrecognized response — yields \"cancelled\".\n */\nexport function mapRpcDialogResponseToOutcome(response: RpcExtensionUIResponse): InteractionOutcomeV1 {\n\tif (\"cancelled\" in response && response.cancelled) return { status: \"cancelled\" };\n\tif (\"confirmed\" in response) return { status: \"answered\", value: response.confirmed };\n\tif (\"value\" in response) return { status: \"answered\", value: response.value };\n\treturn { status: \"cancelled\" };\n}\n\n/**\n * Run in RPC mode.\n * Listens for JSON commands on stdin, outputs events and responses as JSON on stdout.\n */\nexport interface RpcModeOptions {\n\tcapabilities?: Pick<CapabilityRuntime, \"dispatchRpc\" | \"hasRpcMethod\">;\n\t/**\n\t * Observability metrics source for the `get_metrics` command, wired from the\n\t * session's mounted observability plugin (`plugin.getMetrics`). Resolved\n\t * lazily at command time — the plugin's factory runs at mount, which can\n\t * happen after host construction, so a host must pass a closure reading the\n\t * shared ref rather than capture `ref.current` eagerly. Omitted, or\n\t * returning undefined, when the plugin is not mounted; `get_metrics` then\n\t * answers with an error.\n\t */\n\tgetMetrics?: (options?: ObservabilityMetricsOptions) => MetricsSnapshotV1 | undefined;\n\t/**\n\t * Late-bound interaction host slot (1A.8): sessions are created by the\n\t * runtime factory before RPC mode owns its dialog machinery, so the host is\n\t * installed into the slot here and session creation receives the slot's\n\t * forwarding host.\n\t */\n\tinteractionHostSlot?: {\n\t\treadonly host: InteractionHostV1;\n\t\tsetTarget(target: InteractionHostV1 | undefined): void;\n\t};\n}\n\nexport async function runRpcMode(runtimeHost: AgentSessionRuntime, options: RpcModeOptions = {}): Promise<never> {\n\ttakeOverStdout();\n\tlet session = runtimeHost.session;\n\t// Stable facade (阶段 3): RPC session consumption goes through\n\t// CodingAgentFacadeV1; runtime lifecycle orchestration goes through\n\t// CodingAgentRuntimeFacadeV1 (阶段 4 slice 3) and session lifecycle startup\n\t// (startSession) stays on AgentSession. The stdout backpressure gate\n\t// subscribes through the facade's subscribeRawEventGate (D-046); no\n\t// session.agent direct access remains in this mode\n\t// (docs/design/稳定门面统一入口设计.md §2.9).\n\tlet facade = createCodingAgentFacade(session);\n\t// Stable runtime facade: derived once; rebinds are picked up automatically.\n\tconst runtimeFacade = createCodingAgentRuntimeFacade(runtimeHost);\n\tlet unsubscribe: (() => void) | undefined;\n\tlet unsubscribeBackpressure: (() => void) | undefined;\n\n\tconst output = (obj: RpcResponse | RpcExtensionUIRequest | object) => {\n\t\twriteRawStdout(serializeJsonLine(obj));\n\t};\n\n\tconst success = <T extends RpcCommand[\"type\"]>(\n\t\tid: string | undefined,\n\t\tcommand: T,\n\t\tdata?: object | null,\n\t): RpcResponse => {\n\t\tif (data === undefined) {\n\t\t\treturn { id, type: \"response\", command, success: true } as RpcResponse;\n\t\t}\n\t\treturn { id, type: \"response\", command, success: true, data } as RpcResponse;\n\t};\n\n\tconst error = (id: string | undefined, command: string, message: string): RpcResponse => {\n\t\treturn { id, type: \"response\", command, success: false, error: message };\n\t};\n\n\t// Pending extension UI requests waiting for response\n\tconst pendingExtensionRequests = new Map<\n\t\tstring,\n\t\t{ resolve: (value: RpcExtensionUIResponse) => void; reject: (error: Error) => void }\n\t>();\n\n\tlet shuttingDown = false;\n\tconst signalCleanupHandlers: Array<() => void> = [];\n\n\t/** Helper for dialog methods with signal/timeout support */\n\tfunction createDialogPromise<T>(\n\t\topts: InteractionDialogOptions | undefined,\n\t\tdefaultValue: T,\n\t\trequest: Record<string, unknown>,\n\t\tparseResponse: (response: RpcExtensionUIResponse) => T,\n\t): Promise<T> {\n\t\tif (opts?.signal?.aborted) return Promise.resolve(defaultValue);\n\n\t\tconst id = crypto.randomUUID();\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tlet timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n\t\t\tconst cleanup = () => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\topts?.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tpendingExtensionRequests.delete(id);\n\t\t\t};\n\n\t\t\tconst onAbort = () => {\n\t\t\t\tcleanup();\n\t\t\t\tresolve(defaultValue);\n\t\t\t};\n\t\t\topts?.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n\t\t\tif (opts?.timeout) {\n\t\t\t\ttimeoutId = setTimeout(() => {\n\t\t\t\t\tcleanup();\n\t\t\t\t\tresolve(defaultValue);\n\t\t\t\t}, opts.timeout);\n\t\t\t}\n\n\t\t\tpendingExtensionRequests.set(id, {\n\t\t\t\tresolve: (response: RpcExtensionUIResponse) => {\n\t\t\t\t\tcleanup();\n\t\t\t\t\tresolve(parseResponse(response));\n\t\t\t\t},\n\t\t\t\treject,\n\t\t\t});\n\t\t\toutput({ type: \"extension_ui_request\", id, ...request } as RpcExtensionUIRequest);\n\t\t});\n\t}\n\n\tconst emitInteractionNotify = (request: { message: string; level?: InteractionNotifyLevel }): void => {\n\t\toutput({\n\t\t\ttype: \"extension_ui_request\",\n\t\t\tid: crypto.randomUUID(),\n\t\t\tmethod: \"notify\",\n\t\t\tmessage: request.message,\n\t\t\tnotifyType: request.level ?? \"info\",\n\t\t} as RpcExtensionUIRequest);\n\t};\n\n\t/**\n\t * Interaction host for the versioned capability surface (1A.8): maps the\n\t * frozen InteractionHostV1 contract onto the RPC extension_ui_request\n\t * dialog protocol. Cancellation rides the dialog signal support; the\n\t * capability-runtime wrapper owns timeoutMs, so dialogs here only answer or\n\t * cancel.\n\t */\n\tconst createInteractionHostV1 = (): InteractionHostV1 => ({\n\t\tnotify: emitInteractionNotify,\n\t\tprompt: (request, context) => {\n\t\t\tconst opts: InteractionDialogOptions = { signal: context.signal };\n\t\t\tswitch (request.kind) {\n\t\t\t\tcase \"notify\":\n\t\t\t\t\temitInteractionNotify(request);\n\t\t\t\t\treturn Promise.resolve({ status: \"delivered\" });\n\t\t\t\tcase \"select\":\n\t\t\t\t\treturn createDialogPromise<InteractionOutcomeV1>(\n\t\t\t\t\t\topts,\n\t\t\t\t\t\t{ status: \"cancelled\" },\n\t\t\t\t\t\t{ method: \"select\", title: request.title, options: [...request.options] },\n\t\t\t\t\t\tmapRpcDialogResponseToOutcome,\n\t\t\t\t\t);\n\t\t\t\tcase \"confirm\":\n\t\t\t\t\treturn createDialogPromise<InteractionOutcomeV1>(\n\t\t\t\t\t\topts,\n\t\t\t\t\t\t{ status: \"cancelled\" },\n\t\t\t\t\t\t{ method: \"confirm\", title: request.title, message: request.message },\n\t\t\t\t\t\tmapRpcDialogResponseToOutcome,\n\t\t\t\t\t);\n\t\t\t\tcase \"input\":\n\t\t\t\t\treturn createDialogPromise<InteractionOutcomeV1>(\n\t\t\t\t\t\topts,\n\t\t\t\t\t\t{ status: \"cancelled\" },\n\t\t\t\t\t\t// The RPC input protocol has no prefill field, so defaultValue is ignored.\n\t\t\t\t\t\t{ method: \"input\", title: request.title, placeholder: request.placeholder },\n\t\t\t\t\t\tmapRpcDialogResponseToOutcome,\n\t\t\t\t\t);\n\t\t\t}\n\t\t},\n\t});\n\n\t// Install the interaction host (1A.8) once the dialog machinery exists; the\n\t// runtime factory's sessions already hold the slot's forwarding host.\n\toptions.interactionHostSlot?.setTarget(createInteractionHostV1());\n\n\truntimeFacade.setRebindSession(async () => {\n\t\tawait rebindSession();\n\t});\n\n\tconst rebindSession = async (): Promise<void> => {\n\t\tsession = runtimeHost.session;\n\t\tfacade = createCodingAgentFacade(session);\n\t\tawait session.startSession();\n\n\t\tunsubscribe?.();\n\t\tunsubscribeBackpressure?.();\n\t\tunsubscribe = facade.subscribe((event) => {\n\t\t\toutput(toJsonEvent(event));\n\t\t});\n\t\tunsubscribeBackpressure = facade.subscribeRawEventGate(async () => {\n\t\t\tawait waitForRawStdoutBackpressure();\n\t\t});\n\t};\n\n\tconst registerSignalHandlers = (): void => {\n\t\tconst signals: NodeJS.Signals[] = [\"SIGTERM\"];\n\t\tif (process.platform !== \"win32\") {\n\t\t\tsignals.push(\"SIGHUP\");\n\t\t}\n\n\t\tfor (const signal of signals) {\n\t\t\tconst handler = () => {\n\t\t\t\tkillTrackedDetachedChildren();\n\t\t\t\tvoid shutdown(signal === \"SIGHUP\" ? 129 : 143, signal);\n\t\t\t};\n\t\t\tprocess.on(signal, handler);\n\t\t\tsignalCleanupHandlers.push(() => process.off(signal, handler));\n\t\t}\n\t};\n\n\tawait rebindSession();\n\tregisterSignalHandlers();\n\n\t// Handle a single command\n\tconst handleCommand = async (command: RpcCommand): Promise<RpcResponse | undefined> => {\n\t\tconst id = command.id;\n\n\t\tswitch (command.type) {\n\t\t\t// =================================================================\n\t\t\t// Prompting\n\t\t\t// =================================================================\n\n\t\t\tcase \"prompt\": {\n\t\t\t\t// Start prompt handling immediately, but emit the authoritative response only after\n\t\t\t\t// prompt preflight succeeds. Queued and immediately handled prompts also count as success.\n\t\t\t\tlet preflightSucceeded = false;\n\t\t\t\tvoid facade\n\t\t\t\t\t.prompt(command.message, {\n\t\t\t\t\t\timages: command.images,\n\t\t\t\t\t\tstreamingBehavior: command.streamingBehavior,\n\t\t\t\t\t\tsource: \"rpc\",\n\t\t\t\t\t\tpreflightResult: (didSucceed) => {\n\t\t\t\t\t\t\tif (didSucceed) {\n\t\t\t\t\t\t\t\tpreflightSucceeded = true;\n\t\t\t\t\t\t\t\toutput(success(id, \"prompt\"));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t},\n\t\t\t\t\t})\n\t\t\t\t\t.catch((e) => {\n\t\t\t\t\t\tif (!preflightSucceeded) {\n\t\t\t\t\t\t\toutput(error(id, \"prompt\", e.message));\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\treturn undefined;\n\t\t\t}\n\n\t\t\tcase \"steer\": {\n\t\t\t\tawait facade.steer(command.message, command.images, { source: \"rpc\" });\n\t\t\t\treturn success(id, \"steer\");\n\t\t\t}\n\n\t\t\tcase \"follow_up\": {\n\t\t\t\tawait facade.followUp(command.message, command.images, { source: \"rpc\" });\n\t\t\t\treturn success(id, \"follow_up\");\n\t\t\t}\n\n\t\t\tcase \"abort\": {\n\t\t\t\tawait facade.abort();\n\t\t\t\treturn success(id, \"abort\");\n\t\t\t}\n\n\t\t\tcase \"clear_queue\": {\n\t\t\t\treturn success(id, \"clear_queue\", facade.clearQueue());\n\t\t\t}\n\n\t\t\tcase \"new_session\": {\n\t\t\t\tconst options = command.parentSession ? { parentSession: command.parentSession } : undefined;\n\t\t\t\tconst result = await runtimeFacade.newSession(options);\n\t\t\t\tif (!result.cancelled) {\n\t\t\t\t\tawait rebindSession();\n\t\t\t\t}\n\t\t\t\treturn success(id, \"new_session\", result);\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// State\n\t\t\t// =================================================================\n\n\t\t\tcase \"get_state\": {\n\t\t\t\t// Session-suite binding (设计 §10.1, 统一修复轮 B): read from the\n\t\t\t\t// session protocol entries; absent when the session carries none.\n\t\t\t\tconst suiteId = readSessionSuiteId(facade.getEntries());\n\t\t\t\tconst state: RpcSessionState = {\n\t\t\t\t\tmodel: facade.getModel(),\n\t\t\t\t\tthinkingLevel: facade.getThinkingLevel(),\n\t\t\t\t\tisStreaming: facade.isStreaming(),\n\t\t\t\t\tisCompacting: facade.isCompacting(),\n\t\t\t\t\tsteeringMode: facade.getSteeringMode(),\n\t\t\t\t\tfollowUpMode: facade.getFollowUpMode(),\n\t\t\t\t\tsessionFile: facade.getSessionFile(),\n\t\t\t\t\tsessionId: facade.getSessionId(),\n\t\t\t\t\tsessionName: facade.getSessionName(),\n\t\t\t\t\t...(suiteId === undefined ? {} : { suiteId }),\n\t\t\t\t\tautoCompactionEnabled: facade.isAutoCompactionEnabled(),\n\t\t\t\t\tmessageCount: facade.getState().messages.length,\n\t\t\t\t\tpendingMessageCount: facade.getPendingMessageCount(),\n\t\t\t\t};\n\t\t\t\treturn success(id, \"get_state\", state);\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Model\n\t\t\t// =================================================================\n\n\t\t\tcase \"set_model\": {\n\t\t\t\tconst models = facade.getAvailableModels();\n\t\t\t\tconst model = models.find((m) => m.provider === command.provider && m.id === command.modelId);\n\t\t\t\tif (!model) {\n\t\t\t\t\treturn error(id, \"set_model\", `Model not found: ${command.provider}/${command.modelId}`);\n\t\t\t\t}\n\t\t\t\tawait facade.setModel(model);\n\t\t\t\treturn success(id, \"set_model\", model);\n\t\t\t}\n\n\t\t\tcase \"cycle_model\": {\n\t\t\t\tconst result = await facade.cycleModel();\n\t\t\t\tif (!result) {\n\t\t\t\t\treturn success(id, \"cycle_model\", null);\n\t\t\t\t}\n\t\t\t\treturn success(id, \"cycle_model\", result);\n\t\t\t}\n\n\t\t\tcase \"get_available_models\": {\n\t\t\t\tconst models = facade.getAvailableModels();\n\t\t\t\treturn success(id, \"get_available_models\", { models });\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Thinking\n\t\t\t// =================================================================\n\n\t\t\tcase \"set_thinking_level\": {\n\t\t\t\tfacade.setThinkingLevel(command.level);\n\t\t\t\treturn success(id, \"set_thinking_level\");\n\t\t\t}\n\n\t\t\tcase \"cycle_thinking_level\": {\n\t\t\t\tconst level = facade.cycleThinkingLevel();\n\t\t\t\tif (!level) {\n\t\t\t\t\treturn success(id, \"cycle_thinking_level\", null);\n\t\t\t\t}\n\t\t\t\treturn success(id, \"cycle_thinking_level\", { level });\n\t\t\t}\n\n\t\t\tcase \"get_available_thinking_levels\": {\n\t\t\t\tconst levels = facade.getAvailableThinkingLevels();\n\t\t\t\treturn success(id, \"get_available_thinking_levels\", { levels });\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Queue Modes\n\t\t\t// =================================================================\n\n\t\t\tcase \"set_steering_mode\": {\n\t\t\t\tfacade.setSteeringMode(command.mode);\n\t\t\t\treturn success(id, \"set_steering_mode\");\n\t\t\t}\n\n\t\t\tcase \"set_follow_up_mode\": {\n\t\t\t\tfacade.setFollowUpMode(command.mode);\n\t\t\t\treturn success(id, \"set_follow_up_mode\");\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Compaction\n\t\t\t// =================================================================\n\n\t\t\tcase \"compact\": {\n\t\t\t\tconst result = await facade.compact(command.customInstructions);\n\t\t\t\treturn success(id, \"compact\", result);\n\t\t\t}\n\n\t\t\tcase \"set_auto_compaction\": {\n\t\t\t\tfacade.setAutoCompactionEnabled(command.enabled);\n\t\t\t\treturn success(id, \"set_auto_compaction\");\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Retry\n\t\t\t// =================================================================\n\n\t\t\tcase \"set_auto_retry\": {\n\t\t\t\tfacade.setAutoRetryEnabled(command.enabled);\n\t\t\t\treturn success(id, \"set_auto_retry\");\n\t\t\t}\n\n\t\t\tcase \"abort_retry\": {\n\t\t\t\tfacade.abortRetry();\n\t\t\t\treturn success(id, \"abort_retry\");\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Bash\n\t\t\t// =================================================================\n\n\t\t\tcase \"bash\": {\n\t\t\t\t// Dispatch the user.bash lifecycle facts, then execute locally.\n\t\t\t\tfacade.emitUserBash(command.excludeFromContext ?? false);\n\t\t\t\tconst result = await facade.executeBash(command.command, undefined, {\n\t\t\t\t\texcludeFromContext: command.excludeFromContext,\n\t\t\t\t\tid,\n\t\t\t\t});\n\t\t\t\treturn success(id, \"bash\", result);\n\t\t\t}\n\n\t\t\tcase \"abort_bash\": {\n\t\t\t\tfacade.abortBash();\n\t\t\t\treturn success(id, \"abort_bash\");\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Session\n\t\t\t// =================================================================\n\n\t\t\tcase \"get_session_stats\": {\n\t\t\t\tconst stats = facade.getSessionStats();\n\t\t\t\treturn success(id, \"get_session_stats\", stats);\n\t\t\t}\n\n\t\t\tcase \"export_html\": {\n\t\t\t\tconst path = await facade.exportToHtml(command.outputPath);\n\t\t\t\treturn success(id, \"export_html\", { path });\n\t\t\t}\n\n\t\t\tcase \"switch_session\": {\n\t\t\t\tconst result = await runtimeFacade.switchSession(command.sessionPath);\n\t\t\t\tif (!result.cancelled) {\n\t\t\t\t\tawait rebindSession();\n\t\t\t\t}\n\t\t\t\treturn success(id, \"switch_session\", result);\n\t\t\t}\n\n\t\t\tcase \"fork\": {\n\t\t\t\tconst result = await runtimeFacade.fork(command.entryId);\n\t\t\t\tif (!result.cancelled) {\n\t\t\t\t\tawait rebindSession();\n\t\t\t\t}\n\t\t\t\treturn success(id, \"fork\", { text: result.selectedText, cancelled: result.cancelled });\n\t\t\t}\n\n\t\t\tcase \"clone\": {\n\t\t\t\tconst leafId = facade.getLeafId();\n\t\t\t\tif (!leafId) {\n\t\t\t\t\treturn error(id, \"clone\", \"Cannot clone session: no current entry selected\");\n\t\t\t\t}\n\t\t\t\tconst result = await runtimeFacade.fork(leafId, { position: \"at\" });\n\t\t\t\tif (!result.cancelled) {\n\t\t\t\t\tawait rebindSession();\n\t\t\t\t}\n\t\t\t\treturn success(id, \"clone\", { cancelled: result.cancelled });\n\t\t\t}\n\n\t\t\tcase \"get_fork_messages\": {\n\t\t\t\tconst messages = facade.getUserMessagesForForking();\n\t\t\t\treturn success(id, \"get_fork_messages\", { messages });\n\t\t\t}\n\n\t\t\tcase \"get_entries\": {\n\t\t\t\tlet entries = facade.getEntries();\n\t\t\t\tif (command.since !== undefined) {\n\t\t\t\t\tconst sinceIndex = entries.findIndex((e) => e.id === command.since);\n\t\t\t\t\tif (sinceIndex === -1) {\n\t\t\t\t\t\treturn error(id, \"get_entries\", `Entry not found: ${command.since}`);\n\t\t\t\t\t}\n\t\t\t\t\tentries = entries.slice(sinceIndex + 1);\n\t\t\t\t}\n\t\t\t\treturn success(id, \"get_entries\", { entries, leafId: facade.getLeafId() });\n\t\t\t}\n\n\t\t\tcase \"get_tree\": {\n\t\t\t\treturn success(id, \"get_tree\", { tree: facade.getTree(), leafId: facade.getLeafId() });\n\t\t\t}\n\n\t\t\tcase \"get_last_assistant_text\": {\n\t\t\t\tconst text = facade.getLastAssistantText();\n\t\t\t\treturn success(id, \"get_last_assistant_text\", { text });\n\t\t\t}\n\n\t\t\tcase \"set_session_name\": {\n\t\t\t\tconst name = command.name.trim();\n\t\t\t\tif (!name) {\n\t\t\t\t\treturn error(id, \"set_session_name\", \"Session name cannot be empty\");\n\t\t\t\t}\n\t\t\t\tfacade.setSessionName(name);\n\t\t\t\treturn success(id, \"set_session_name\");\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Messages\n\t\t\t// =================================================================\n\n\t\t\tcase \"get_messages\": {\n\t\t\t\treturn success(id, \"get_messages\", { messages: facade.getState().messages });\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Metrics\n\t\t\t// =================================================================\n\n\t\t\tcase \"get_metrics\": {\n\t\t\t\tconst snapshot = options.getMetrics?.(\n\t\t\t\t\tcommand.windowTurns === undefined ? undefined : { windowTurns: command.windowTurns },\n\t\t\t\t);\n\t\t\t\tif (!snapshot) {\n\t\t\t\t\treturn error(\n\t\t\t\t\t\tid,\n\t\t\t\t\t\t\"get_metrics\",\n\t\t\t\t\t\t\"Metrics are not available: the observability plugin is not mounted in this session\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn success(id, \"get_metrics\", snapshot);\n\t\t\t}\n\n\t\t\t// =================================================================\n\t\t\t// Commands (available for invocation via prompt)\n\t\t\t// =================================================================\n\n\t\t\tcase \"get_commands\": {\n\t\t\t\tconst commands: RpcSlashCommand[] = [];\n\n\t\t\t\tfor (const template of facade.getPromptTemplates()) {\n\t\t\t\t\tcommands.push({\n\t\t\t\t\t\tname: template.name,\n\t\t\t\t\t\tdescription: template.description,\n\t\t\t\t\t\tsource: \"prompt\",\n\t\t\t\t\t\tsourceInfo: template.sourceInfo,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tfor (const skill of facade.getSkills().skills) {\n\t\t\t\t\tcommands.push({\n\t\t\t\t\t\tname: `skill:${skill.name}`,\n\t\t\t\t\t\tdescription: skill.description,\n\t\t\t\t\t\tsource: \"skill\",\n\t\t\t\t\t\tsourceInfo: skill.sourceInfo,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst capabilityRuntime = session.getCapabilityRuntime();\n\t\t\t\tfor (const { definition, source } of capabilityRuntime.listCommands()) {\n\t\t\t\t\tif (commands.some((command) => command.name === definition.name)) continue;\n\t\t\t\t\tcommands.push({\n\t\t\t\t\t\tname: definition.name,\n\t\t\t\t\t\tdescription: definition.description,\n\t\t\t\t\t\tsource: \"capability\",\n\t\t\t\t\t\tsourceInfo: createSyntheticSourceInfo(`<plugin:${source}:${definition.name}>`, { source }),\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\treturn success(id, \"get_commands\", { commands });\n\t\t\t}\n\n\t\t\tdefault: {\n\t\t\t\tconst unknownCommand = command as { type: string };\n\t\t\t\tif (options.capabilities?.hasRpcMethod(unknownCommand.type)) {\n\t\t\t\t\tconst data = await options.capabilities.dispatchRpc(unknownCommand.type, command);\n\t\t\t\t\treturn { id, type: \"response\", command: unknownCommand.type, success: true, data } as RpcResponse;\n\t\t\t\t}\n\t\t\t\treturn error(id, unknownCommand.type, `Unknown command: ${unknownCommand.type}`);\n\t\t\t}\n\t\t}\n\t};\n\n\t/**\n\t * Check if shutdown was requested and perform shutdown if so.\n\t * Called after handling each command when waiting for the next command.\n\t */\n\tlet detachInput = () => {};\n\n\tasync function shutdown(exitCode = 0, signal?: NodeJS.Signals): Promise<never> {\n\t\tif (shuttingDown) {\n\t\t\tprocess.exit(exitCode);\n\t\t}\n\t\tshuttingDown = true;\n\t\tfor (const cleanup of signalCleanupHandlers) {\n\t\t\tcleanup();\n\t\t}\n\t\tunsubscribe?.();\n\t\tunsubscribeBackpressure?.();\n\t\tawait runtimeHost.dispose();\n\t\tdetachInput();\n\t\tprocess.stdin.pause();\n\t\tif (signal !== \"SIGTERM\") {\n\t\t\tawait flushRawStdout();\n\t\t}\n\t\tprocess.exit(exitCode);\n\t}\n\n\tconst handleInputLine = async (line: string) => {\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(line);\n\t\t} catch (parseError: unknown) {\n\t\t\toutput(\n\t\t\t\terror(\n\t\t\t\t\tundefined,\n\t\t\t\t\t\"parse\",\n\t\t\t\t\t// v8 ignore next -- JSON.parse rejections are always SyntaxError instances\n\t\t\t\t\t`Failed to parse command: ${parseError instanceof Error ? parseError.message : String(parseError)}`,\n\t\t\t\t),\n\t\t\t);\n\t\t\tawait waitForRawStdoutBackpressure();\n\t\t\treturn;\n\t\t}\n\n\t\t// Handle extension UI responses\n\t\tif (\n\t\t\ttypeof parsed === \"object\" &&\n\t\t\tparsed !== null &&\n\t\t\t\"type\" in parsed &&\n\t\t\tparsed.type === \"extension_ui_response\"\n\t\t) {\n\t\t\tconst response = parsed as RpcExtensionUIResponse;\n\t\t\tconst pending = pendingExtensionRequests.get(response.id);\n\t\t\tif (pending) {\n\t\t\t\tpendingExtensionRequests.delete(response.id);\n\t\t\t\tpending.resolve(response);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tconst command = parsed as RpcCommand;\n\t\ttry {\n\t\t\tconst response = await handleCommand(command);\n\t\t\tif (response) {\n\t\t\t\toutput(response);\n\t\t\t\tawait waitForRawStdoutBackpressure();\n\t\t\t}\n\t\t} catch (commandError: unknown) {\n\t\t\toutput(\n\t\t\t\terror(\n\t\t\t\t\tcommand.id,\n\t\t\t\t\tcommand.type,\n\t\t\t\t\tcommandError instanceof Error ? commandError.message : String(commandError),\n\t\t\t\t),\n\t\t\t);\n\t\t\tawait waitForRawStdoutBackpressure();\n\t\t}\n\t};\n\n\tconst onInputEnd = () => {\n\t\tvoid shutdown();\n\t};\n\tprocess.stdin.on(\"end\", onInputEnd);\n\n\tdetachInput = (() => {\n\t\tconst detachJsonl = attachJsonlLineReader(process.stdin, (line) => {\n\t\t\tvoid handleInputLine(line);\n\t\t});\n\t\treturn () => {\n\t\t\tdetachJsonl();\n\t\t\tprocess.stdin.off(\"end\", onInputEnd);\n\t\t};\n\t})();\n\n\t// Keep process alive forever\n\treturn new Promise(() => {});\n}\n"]}

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

@@ -0,0 +1,540 @@
+/**
+ * RPC mode: Headless operation with JSON stdin/stdout protocol.
+ *
+ * Used for embedding the agent in other applications.
+ * Receives commands as JSON on stdin, outputs events and responses as JSON on stdout.
+ *
+ * Protocol:
+ * - Commands: JSON objects with `type` field, optional `id` for correlation
+ * - Responses: JSON objects with `type: "response"`, `command`, `success`, and optional `data`/`error`
+ * - Events: AgentSessionEvent objects streamed as they occur
+ * - Extension UI: Extension UI requests are emitted, client responds with extension_ui_response
+ */
+import * as crypto from "node:crypto";
+import { createCodingAgentFacade, createCodingAgentRuntimeFacade } from "../../core/facade/index.js";
+import { flushRawStdout, takeOverStdout, waitForRawStdoutBackpressure, writeRawStdout, } from "../../core/output-guard.js";
+import { createSyntheticSourceInfo } from "../../core/source-info.js";
+import { readSessionSuiteId } from "../../profiles/suite-loader.js";
+import { killTrackedDetachedChildren } from "../../utils/shell.js";
+import { toJsonEvent } from "../json-event.js";
+import { attachJsonlLineReader, serializeJsonLine } from "./jsonl.js";
+/**
+ * Map an RPC extension_ui_response onto the frozen interaction outcome
+ * (1A.8): {value} and {confirmed} are answers; {cancelled:true} — or an
+ * unrecognized response — yields "cancelled".
+ */
+export function mapRpcDialogResponseToOutcome(response) {
+    if ("cancelled" in response && response.cancelled)
+        return { status: "cancelled" };
+    if ("confirmed" in response)
+        return { status: "answered", value: response.confirmed };
+    if ("value" in response)
+        return { status: "answered", value: response.value };
+    return { status: "cancelled" };
+}
+export async function runRpcMode(runtimeHost, options = {}) {
+    takeOverStdout();
+    let session = runtimeHost.session;
+    // Stable facade (阶段 3): RPC session consumption goes through
+    // CodingAgentFacadeV1; runtime lifecycle orchestration goes through
+    // CodingAgentRuntimeFacadeV1 (阶段 4 slice 3) and session lifecycle startup
+    // (startSession) stays on AgentSession. The stdout backpressure gate
+    // subscribes through the facade's subscribeRawEventGate (D-046); no
+    // session.agent direct access remains in this mode
+    // (docs/design/稳定门面统一入口设计.md §2.9).
+    let facade = createCodingAgentFacade(session);
+    // Stable runtime facade: derived once; rebinds are picked up automatically.
+    const runtimeFacade = createCodingAgentRuntimeFacade(runtimeHost);
+    let unsubscribe;
+    let unsubscribeBackpressure;
+    const output = (obj) => {
+        writeRawStdout(serializeJsonLine(obj));
+    };
+    const success = (id, command, data) => {
+        if (data === undefined) {
+            return { id, type: "response", command, success: true };
+        }
+        return { id, type: "response", command, success: true, data };
+    };
+    const error = (id, command, message) => {
+        return { id, type: "response", command, success: false, error: message };
+    };
+    // Pending extension UI requests waiting for response
+    const pendingExtensionRequests = new Map();
+    let shuttingDown = false;
+    const signalCleanupHandlers = [];
+    /** Helper for dialog methods with signal/timeout support */
+    function createDialogPromise(opts, defaultValue, request, parseResponse) {
+        if (opts?.signal?.aborted)
+            return Promise.resolve(defaultValue);
+        const id = crypto.randomUUID();
+        return new Promise((resolve, reject) => {
+            let timeoutId;
+            const cleanup = () => {
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                opts?.signal?.removeEventListener("abort", onAbort);
+                pendingExtensionRequests.delete(id);
+            };
+            const onAbort = () => {
+                cleanup();
+                resolve(defaultValue);
+            };
+            opts?.signal?.addEventListener("abort", onAbort, { once: true });
+            if (opts?.timeout) {
+                timeoutId = setTimeout(() => {
+                    cleanup();
+                    resolve(defaultValue);
+                }, opts.timeout);
+            }
+            pendingExtensionRequests.set(id, {
+                resolve: (response) => {
+                    cleanup();
+                    resolve(parseResponse(response));
+                },
+                reject,
+            });
+            output({ type: "extension_ui_request", id, ...request });
+        });
+    }
+    const emitInteractionNotify = (request) => {
+        output({
+            type: "extension_ui_request",
+            id: crypto.randomUUID(),
+            method: "notify",
+            message: request.message,
+            notifyType: request.level ?? "info",
+        });
+    };
+    /**
+     * Interaction host for the versioned capability surface (1A.8): maps the
+     * frozen InteractionHostV1 contract onto the RPC extension_ui_request
+     * dialog protocol. Cancellation rides the dialog signal support; the
+     * capability-runtime wrapper owns timeoutMs, so dialogs here only answer or
+     * cancel.
+     */
+    const createInteractionHostV1 = () => ({
+        notify: emitInteractionNotify,
+        prompt: (request, context) => {
+            const opts = { signal: context.signal };
+            switch (request.kind) {
+                case "notify":
+                    emitInteractionNotify(request);
+                    return Promise.resolve({ status: "delivered" });
+                case "select":
+                    return createDialogPromise(opts, { status: "cancelled" }, { method: "select", title: request.title, options: [...request.options] }, mapRpcDialogResponseToOutcome);
+                case "confirm":
+                    return createDialogPromise(opts, { status: "cancelled" }, { method: "confirm", title: request.title, message: request.message }, mapRpcDialogResponseToOutcome);
+                case "input":
+                    return createDialogPromise(opts, { status: "cancelled" }, 
+                    // The RPC input protocol has no prefill field, so defaultValue is ignored.
+                    { method: "input", title: request.title, placeholder: request.placeholder }, mapRpcDialogResponseToOutcome);
+            }
+        },
+    });
+    // Install the interaction host (1A.8) once the dialog machinery exists; the
+    // runtime factory's sessions already hold the slot's forwarding host.
+    options.interactionHostSlot?.setTarget(createInteractionHostV1());
+    runtimeFacade.setRebindSession(async () => {
+        await rebindSession();
+    });
+    const rebindSession = async () => {
+        session = runtimeHost.session;
+        facade = createCodingAgentFacade(session);
+        await session.startSession();
+        unsubscribe?.();
+        unsubscribeBackpressure?.();
+        unsubscribe = facade.subscribe((event) => {
+            output(toJsonEvent(event));
+        });
+        unsubscribeBackpressure = facade.subscribeRawEventGate(async () => {
+            await waitForRawStdoutBackpressure();
+        });
+    };
+    const registerSignalHandlers = () => {
+        const signals = ["SIGTERM"];
+        if (process.platform !== "win32") {
+            signals.push("SIGHUP");
+        }
+        for (const signal of signals) {
+            const handler = () => {
+                killTrackedDetachedChildren();
+                void shutdown(signal === "SIGHUP" ? 129 : 143, signal);
+            };
+            process.on(signal, handler);
+            signalCleanupHandlers.push(() => process.off(signal, handler));
+        }
+    };
+    await rebindSession();
+    registerSignalHandlers();
+    // Handle a single command
+    const handleCommand = async (command) => {
+        const id = command.id;
+        switch (command.type) {
+            // =================================================================
+            // Prompting
+            // =================================================================
+            case "prompt": {
+                // Start prompt handling immediately, but emit the authoritative response only after
+                // prompt preflight succeeds. Queued and immediately handled prompts also count as success.
+                let preflightSucceeded = false;
+                void facade
+                    .prompt(command.message, {
+                    images: command.images,
+                    streamingBehavior: command.streamingBehavior,
+                    source: "rpc",
+                    preflightResult: (didSucceed) => {
+                        if (didSucceed) {
+                            preflightSucceeded = true;
+                            output(success(id, "prompt"));
+                        }
+                    },
+                })
+                    .catch((e) => {
+                    if (!preflightSucceeded) {
+                        output(error(id, "prompt", e.message));
+                    }
+                });
+                return undefined;
+            }
+            case "steer": {
+                await facade.steer(command.message, command.images, { source: "rpc" });
+                return success(id, "steer");
+            }
+            case "follow_up": {
+                await facade.followUp(command.message, command.images, { source: "rpc" });
+                return success(id, "follow_up");
+            }
+            case "abort": {
+                await facade.abort();
+                return success(id, "abort");
+            }
+            case "clear_queue": {
+                return success(id, "clear_queue", facade.clearQueue());
+            }
+            case "new_session": {
+                const options = command.parentSession ? { parentSession: command.parentSession } : undefined;
+                const result = await runtimeFacade.newSession(options);
+                if (!result.cancelled) {
+                    await rebindSession();
+                }
+                return success(id, "new_session", result);
+            }
+            // =================================================================
+            // State
+            // =================================================================
+            case "get_state": {
+                // Session-suite binding (设计 §10.1, 统一修复轮 B): read from the
+                // session protocol entries; absent when the session carries none.
+                const suiteId = readSessionSuiteId(facade.getEntries());
+                const state = {
+                    model: facade.getModel(),
+                    thinkingLevel: facade.getThinkingLevel(),
+                    isStreaming: facade.isStreaming(),
+                    isCompacting: facade.isCompacting(),
+                    steeringMode: facade.getSteeringMode(),
+                    followUpMode: facade.getFollowUpMode(),
+                    sessionFile: facade.getSessionFile(),
+                    sessionId: facade.getSessionId(),
+                    sessionName: facade.getSessionName(),
+                    ...(suiteId === undefined ? {} : { suiteId }),
+                    autoCompactionEnabled: facade.isAutoCompactionEnabled(),
+                    messageCount: facade.getState().messages.length,
+                    pendingMessageCount: facade.getPendingMessageCount(),
+                };
+                return success(id, "get_state", state);
+            }
+            // =================================================================
+            // Model
+            // =================================================================
+            case "set_model": {
+                const models = facade.getAvailableModels();
+                const model = models.find((m) => m.provider === command.provider && m.id === command.modelId);
+                if (!model) {
+                    return error(id, "set_model", `Model not found: ${command.provider}/${command.modelId}`);
+                }
+                await facade.setModel(model);
+                return success(id, "set_model", model);
+            }
+            case "cycle_model": {
+                const result = await facade.cycleModel();
+                if (!result) {
+                    return success(id, "cycle_model", null);
+                }
+                return success(id, "cycle_model", result);
+            }
+            case "get_available_models": {
+                const models = facade.getAvailableModels();
+                return success(id, "get_available_models", { models });
+            }
+            // =================================================================
+            // Thinking
+            // =================================================================
+            case "set_thinking_level": {
+                facade.setThinkingLevel(command.level);
+                return success(id, "set_thinking_level");
+            }
+            case "cycle_thinking_level": {
+                const level = facade.cycleThinkingLevel();
+                if (!level) {
+                    return success(id, "cycle_thinking_level", null);
+                }
+                return success(id, "cycle_thinking_level", { level });
+            }
+            case "get_available_thinking_levels": {
+                const levels = facade.getAvailableThinkingLevels();
+                return success(id, "get_available_thinking_levels", { levels });
+            }
+            // =================================================================
+            // Queue Modes
+            // =================================================================
+            case "set_steering_mode": {
+                facade.setSteeringMode(command.mode);
+                return success(id, "set_steering_mode");
+            }
+            case "set_follow_up_mode": {
+                facade.setFollowUpMode(command.mode);
+                return success(id, "set_follow_up_mode");
+            }
+            // =================================================================
+            // Compaction
+            // =================================================================
+            case "compact": {
+                const result = await facade.compact(command.customInstructions);
+                return success(id, "compact", result);
+            }
+            case "set_auto_compaction": {
+                facade.setAutoCompactionEnabled(command.enabled);
+                return success(id, "set_auto_compaction");
+            }
+            // =================================================================
+            // Retry
+            // =================================================================
+            case "set_auto_retry": {
+                facade.setAutoRetryEnabled(command.enabled);
+                return success(id, "set_auto_retry");
+            }
+            case "abort_retry": {
+                facade.abortRetry();
+                return success(id, "abort_retry");
+            }
+            // =================================================================
+            // Bash
+            // =================================================================
+            case "bash": {
+                // Dispatch the user.bash lifecycle facts, then execute locally.
+                facade.emitUserBash(command.excludeFromContext ?? false);
+                const result = await facade.executeBash(command.command, undefined, {
+                    excludeFromContext: command.excludeFromContext,
+                    id,
+                });
+                return success(id, "bash", result);
+            }
+            case "abort_bash": {
+                facade.abortBash();
+                return success(id, "abort_bash");
+            }
+            // =================================================================
+            // Session
+            // =================================================================
+            case "get_session_stats": {
+                const stats = facade.getSessionStats();
+                return success(id, "get_session_stats", stats);
+            }
+            case "export_html": {
+                const path = await facade.exportToHtml(command.outputPath);
+                return success(id, "export_html", { path });
+            }
+            case "switch_session": {
+                const result = await runtimeFacade.switchSession(command.sessionPath);
+                if (!result.cancelled) {
+                    await rebindSession();
+                }
+                return success(id, "switch_session", result);
+            }
+            case "fork": {
+                const result = await runtimeFacade.fork(command.entryId);
+                if (!result.cancelled) {
+                    await rebindSession();
+                }
+                return success(id, "fork", { text: result.selectedText, cancelled: result.cancelled });
+            }
+            case "clone": {
+                const leafId = facade.getLeafId();
+                if (!leafId) {
+                    return error(id, "clone", "Cannot clone session: no current entry selected");
+                }
+                const result = await runtimeFacade.fork(leafId, { position: "at" });
+                if (!result.cancelled) {
+                    await rebindSession();
+                }
+                return success(id, "clone", { cancelled: result.cancelled });
+            }
+            case "get_fork_messages": {
+                const messages = facade.getUserMessagesForForking();
+                return success(id, "get_fork_messages", { messages });
+            }
+            case "get_entries": {
+                let entries = facade.getEntries();
+                if (command.since !== undefined) {
+                    const sinceIndex = entries.findIndex((e) => e.id === command.since);
+                    if (sinceIndex === -1) {
+                        return error(id, "get_entries", `Entry not found: ${command.since}`);
+                    }
+                    entries = entries.slice(sinceIndex + 1);
+                }
+                return success(id, "get_entries", { entries, leafId: facade.getLeafId() });
+            }
+            case "get_tree": {
+                return success(id, "get_tree", { tree: facade.getTree(), leafId: facade.getLeafId() });
+            }
+            case "get_last_assistant_text": {
+                const text = facade.getLastAssistantText();
+                return success(id, "get_last_assistant_text", { text });
+            }
+            case "set_session_name": {
+                const name = command.name.trim();
+                if (!name) {
+                    return error(id, "set_session_name", "Session name cannot be empty");
+                }
+                facade.setSessionName(name);
+                return success(id, "set_session_name");
+            }
+            // =================================================================
+            // Messages
+            // =================================================================
+            case "get_messages": {
+                return success(id, "get_messages", { messages: facade.getState().messages });
+            }
+            // =================================================================
+            // Metrics
+            // =================================================================
+            case "get_metrics": {
+                const snapshot = options.getMetrics?.(command.windowTurns === undefined ? undefined : { windowTurns: command.windowTurns });
+                if (!snapshot) {
+                    return error(id, "get_metrics", "Metrics are not available: the observability plugin is not mounted in this session");
+                }
+                return success(id, "get_metrics", snapshot);
+            }
+            // =================================================================
+            // Commands (available for invocation via prompt)
+            // =================================================================
+            case "get_commands": {
+                const commands = [];
+                for (const template of facade.getPromptTemplates()) {
+                    commands.push({
+                        name: template.name,
+                        description: template.description,
+                        source: "prompt",
+                        sourceInfo: template.sourceInfo,
+                    });
+                }
+                for (const skill of facade.getSkills().skills) {
+                    commands.push({
+                        name: `skill:${skill.name}`,
+                        description: skill.description,
+                        source: "skill",
+                        sourceInfo: skill.sourceInfo,
+                    });
+                }
+                const capabilityRuntime = session.getCapabilityRuntime();
+                for (const { definition, source } of capabilityRuntime.listCommands()) {
+                    if (commands.some((command) => command.name === definition.name))
+                        continue;
+                    commands.push({
+                        name: definition.name,
+                        description: definition.description,
+                        source: "capability",
+                        sourceInfo: createSyntheticSourceInfo(`<plugin:${source}:${definition.name}>`, { source }),
+                    });
+                }
+                return success(id, "get_commands", { commands });
+            }
+            default: {
+                const unknownCommand = command;
+                if (options.capabilities?.hasRpcMethod(unknownCommand.type)) {
+                    const data = await options.capabilities.dispatchRpc(unknownCommand.type, command);
+                    return { id, type: "response", command: unknownCommand.type, success: true, data };
+                }
+                return error(id, unknownCommand.type, `Unknown command: ${unknownCommand.type}`);
+            }
+        }
+    };
+    /**
+     * Check if shutdown was requested and perform shutdown if so.
+     * Called after handling each command when waiting for the next command.
+     */
+    let detachInput = () => { };
+    async function shutdown(exitCode = 0, signal) {
+        if (shuttingDown) {
+            process.exit(exitCode);
+        }
+        shuttingDown = true;
+        for (const cleanup of signalCleanupHandlers) {
+            cleanup();
+        }
+        unsubscribe?.();
+        unsubscribeBackpressure?.();
+        await runtimeHost.dispose();
+        detachInput();
+        process.stdin.pause();
+        if (signal !== "SIGTERM") {
+            await flushRawStdout();
+        }
+        process.exit(exitCode);
+    }
+    const handleInputLine = async (line) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (parseError) {
+            output(error(undefined, "parse", 
+            // v8 ignore next -- JSON.parse rejections are always SyntaxError instances
+            `Failed to parse command: ${parseError instanceof Error ? parseError.message : String(parseError)}`));
+            await waitForRawStdoutBackpressure();
+            return;
+        }
+        // Handle extension UI responses
+        if (typeof parsed === "object" &&
+            parsed !== null &&
+            "type" in parsed &&
+            parsed.type === "extension_ui_response") {
+            const response = parsed;
+            const pending = pendingExtensionRequests.get(response.id);
+            if (pending) {
+                pendingExtensionRequests.delete(response.id);
+                pending.resolve(response);
+            }
+            return;
+        }
+        const command = parsed;
+        try {
+            const response = await handleCommand(command);
+            if (response) {
+                output(response);
+                await waitForRawStdoutBackpressure();
+            }
+        }
+        catch (commandError) {
+            output(error(command.id, command.type, commandError instanceof Error ? commandError.message : String(commandError)));
+            await waitForRawStdoutBackpressure();
+        }
+    };
+    const onInputEnd = () => {
+        void shutdown();
+    };
+    process.stdin.on("end", onInputEnd);
+    detachInput = (() => {
+        const detachJsonl = attachJsonlLineReader(process.stdin, (line) => {
+            void handleInputLine(line);
+        });
+        return () => {
+            detachJsonl();
+            process.stdin.off("end", onInputEnd);
+        };
+    })();
+    // Keep process alive forever
+    return new Promise(() => { });
+}
+//# sourceMappingURL=rpc-mode.js.map