@dyyz1993/pi-coding-agent 0.70.6 → 0.74.5

package/dist/modes/interactive/theme/dark.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://raw.githubusercontent.com/badlogic/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"$schema": "https://raw.githubusercontent.com/dyyz1993/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
 	"name": "dark",
 	"vars": {
 		"cyan": "#00d7ff",

package/dist/modes/interactive/theme/light.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://raw.githubusercontent.com/badlogic/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"$schema": "https://raw.githubusercontent.com/dyyz1993/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
 	"name": "light",
 	"vars": {
 		"teal": "#5a8080",

package/dist/modes/print-mode.d.ts

@@ -6,6 +6,7 @@
  * - `pi --mode json "prompt"` - JSON event stream
  */
 import type { ImageContent } from "@dyyz1993/pi-ai";
+import type { TSchema } from "typebox";
 import type { AgentSessionRuntime } from "../core/agent-session-runtime.js";
 /**
  * Options for print mode.
@@ -21,6 +22,8 @@ export interface PrintModeOptions {
     initialImages?: ImageContent[];
     /** Maximum number of agent turns before aborting (0 = unlimited) */
     maxTurns?: number;
+    /** JSON schema for structured output validation (print mode only) */
+    outputSchema?: TSchema;
 }
 /**
  * Run in print (single-shot) mode.

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

@@ -1 +1 @@
-{"version":3,"file":"print-mode.d.ts","sourceRoot":"","sources":["../../src/modes/print-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAI5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqI/G","sourcesContent":["/**\n * Print mode (single-shot): Send prompts, output result, exit.\n *\n * Used for:\n * - `pi -p \"prompt\"` - text output\n * - `pi --mode json \"prompt\"` - JSON event stream\n */\n\nimport type { AssistantMessage, ImageContent } from \"@dyyz1993/pi-ai\";\nimport type { AgentSessionRuntime } from \"../core/agent-session-runtime.js\";\nimport { flushRawStdout, writeRawStdout } from \"../core/output-guard.js\";\nimport { killTrackedDetachedChildren } from \"../utils/shell.js\";\n\n/**\n * Options for print mode.\n */\nexport interface PrintModeOptions {\n\t/** Output mode: \"text\" for final response only, \"json\" for all events */\n\tmode: \"text\" | \"json\";\n\t/** Array of additional prompts to send after initialMessage */\n\tmessages?: string[];\n\t/** First message to send (may contain @file content) */\n\tinitialMessage?: string;\n\t/** Images to attach to the initial message */\n\tinitialImages?: ImageContent[];\n\t/** Maximum number of agent turns before aborting (0 = unlimited) */\n\tmaxTurns?: number;\n}\n\n/**\n * Run in print (single-shot) mode.\n * Sends prompts to the agent and outputs the result.\n */\nexport async function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number> {\n\tconst { mode, messages = [], initialMessage, initialImages, maxTurns } = options;\n\tlet exitCode = 0;\n\tlet session = runtimeHost.session;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet disposed = false;\n\tconst signalCleanupHandlers: Array<() => void> = [];\n\tlet turnCount = 0;\n\n\tconst disposeRuntime = async (): Promise<void> => {\n\t\tif (disposed) return;\n\t\tdisposed = true;\n\t\tunsubscribe?.();\n\t\tawait runtimeHost.dispose();\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 disposeRuntime().finally(() => {\n\t\t\t\t\tprocess.exit(signal === \"SIGHUP\" ? 129 : 143);\n\t\t\t\t});\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\tregisterSignalHandlers();\n\n\truntimeHost.setRebindSession(async () => {\n\t\tawait rebindSession();\n\t});\n\n\tconst rebindSession = async (): Promise<void> => {\n\t\tsession = runtimeHost.session;\n\t\tawait session.bindExtensions({\n\t\t\tcommandContextActions: {\n\t\t\t\twaitForIdle: () => session.agent.waitForIdle(),\n\t\t\t\tnewSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions),\n\t\t\t\tfork: async (entryId, forkOptions) => {\n\t\t\t\t\tconst result = await runtimeHost.fork(entryId, forkOptions);\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tnavigateTree: async (targetId, navigateOptions) => {\n\t\t\t\t\tconst result = await session.navigateTree(targetId, {\n\t\t\t\t\t\tsummarize: navigateOptions?.summarize,\n\t\t\t\t\t\tcustomInstructions: navigateOptions?.customInstructions,\n\t\t\t\t\t\treplaceInstructions: navigateOptions?.replaceInstructions,\n\t\t\t\t\t\tlabel: navigateOptions?.label,\n\t\t\t\t\t});\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tswitchSession: async (sessionPath, switchOptions) => {\n\t\t\t\t\treturn runtimeHost.switchSession(sessionPath, switchOptions);\n\t\t\t\t},\n\t\t\t\treload: async () => {\n\t\t\t\t\tawait session.reload();\n\t\t\t\t},\n\t\t\t},\n\t\t\tonError: (err) => {\n\t\t\t\tconsole.error(`Extension error (${err.extensionPath}): ${err.error}`);\n\t\t\t},\n\t\t});\n\n\t\tunsubscribe?.();\n\t\tunsubscribe = session.subscribe((event) => {\n\t\t\tif (mode === \"json\") {\n\t\t\t\twriteRawStdout(`${JSON.stringify(event)}\\n`);\n\t\t\t}\n\t\t\tif (event.type === \"turn_end\") {\n\t\t\t\tturnCount++;\n\t\t\t\tif (maxTurns && maxTurns > 0 && turnCount >= maxTurns) {\n\t\t\t\t\tsession.agent.abort();\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t};\n\n\ttry {\n\t\tif (mode === \"json\") {\n\t\t\tconst header = session.sessionManager.getHeader();\n\t\t\tif (header) {\n\t\t\t\twriteRawStdout(`${JSON.stringify(header)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\tawait rebindSession();\n\n\t\tif (initialMessage) {\n\t\t\tawait session.prompt(initialMessage, { images: initialImages });\n\t\t}\n\n\t\tfor (const message of messages) {\n\t\t\tawait session.prompt(message);\n\t\t}\n\n\t\tif (mode === \"text\") {\n\t\t\tconst state = session.state;\n\t\t\tconst lastMessage = state.messages[state.messages.length - 1];\n\n\t\t\tif (lastMessage?.role === \"assistant\") {\n\t\t\t\tconst assistantMsg = lastMessage as AssistantMessage;\n\t\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\t\tconsole.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);\n\t\t\t\t\texitCode = 1;\n\t\t\t\t} else {\n\t\t\t\t\tfor (const content of assistantMsg.content) {\n\t\t\t\t\t\tif (content.type === \"text\") {\n\t\t\t\t\t\t\twriteRawStdout(`${content.text}\\n`);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn exitCode;\n\t} catch (error: unknown) {\n\t\tconsole.error(error instanceof Error ? error.message : String(error));\n\t\treturn 1;\n\t} finally {\n\t\tfor (const cleanup of signalCleanupHandlers) {\n\t\t\tcleanup();\n\t\t}\n\t\tawait disposeRuntime();\n\t\tawait flushRawStdout();\n\t}\n}\n"]}
+{"version":3,"file":"print-mode.d.ts","sourceRoot":"","sources":["../../src/modes/print-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAK5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AA4DD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyI/G","sourcesContent":["/**\n * Print mode (single-shot): Send prompts, output result, exit.\n *\n * Used for:\n * - `pi -p \"prompt\"` - text output\n * - `pi --mode json \"prompt\"` - JSON event stream\n */\n\nimport type { AgentMessage } from \"@dyyz1993/pi-agent-core\";\nimport type { AssistantMessage, ImageContent } from \"@dyyz1993/pi-ai\";\nimport type { TSchema } from \"typebox\";\nimport type { AgentSessionRuntime } from \"../core/agent-session-runtime.js\";\nimport { flushRawStdout, writeRawStdout } from \"../core/output-guard.js\";\nimport { killTrackedDetachedChildren } from \"../utils/shell.js\";\nimport { validateStructuredOutput } from \"../utils/structured-output.js\";\n\n/**\n * Options for print mode.\n */\nexport interface PrintModeOptions {\n\t/** Output mode: \"text\" for final response only, \"json\" for all events */\n\tmode: \"text\" | \"json\";\n\t/** Array of additional prompts to send after initialMessage */\n\tmessages?: string[];\n\t/** First message to send (may contain @file content) */\n\tinitialMessage?: string;\n\t/** Images to attach to the initial message */\n\tinitialImages?: ImageContent[];\n\t/** Maximum number of agent turns before aborting (0 = unlimited) */\n\tmaxTurns?: number;\n\t/** JSON schema for structured output validation (print mode only) */\n\toutputSchema?: TSchema;\n}\n\nconst MAX_STRUCTURED_RETRIES = 3;\n\nfunction getLastAssistantText(messages: AgentMessage[]): string {\n\tconst lastMessage = messages[messages.length - 1];\n\tif (lastMessage?.role !== \"assistant\") return \"\";\n\tlet text = \"\";\n\tfor (const content of (lastMessage as AssistantMessage).content) {\n\t\tif (content.type === \"text\") {\n\t\t\ttext += content.text;\n\t\t}\n\t}\n\treturn text;\n}\n\nasync function runStructuredOutput(\n\tsession: {\n\t\tprompt: (text: string, opts?: { images?: ImageContent[] }) => Promise<void>;\n\t\tstate: { messages: AgentMessage[] };\n\t\tagent: { waitForIdle: () => Promise<void> };\n\t},\n\tschema: TSchema,\n\tinitialMessage?: string,\n\tinitialImages?: ImageContent[],\n\textraMessages?: string[],\n): Promise<number> {\n\tconst schemaPrompt = `\\n\\nYou must respond with valid JSON matching this schema:\\n${JSON.stringify(schema)}\\n\\nRespond with JSON only, no markdown code blocks.`;\n\n\tconst firstPrompt = (initialMessage ?? \"\") + schemaPrompt;\n\tawait session.prompt(firstPrompt, { images: initialImages });\n\n\tfor (const message of extraMessages ?? []) {\n\t\tawait session.prompt(message);\n\t}\n\n\tfor (let attempt = 0; attempt <= MAX_STRUCTURED_RETRIES; attempt++) {\n\t\tconst raw = getLastAssistantText(session.state.messages);\n\t\tconst result = validateStructuredOutput(raw, schema);\n\n\t\tif (result.success) {\n\t\t\twriteRawStdout(`${JSON.stringify(result.data)}\\n`);\n\t\t\treturn 0;\n\t\t}\n\n\t\tif (attempt < MAX_STRUCTURED_RETRIES) {\n\t\t\tawait session.prompt(\n\t\t\t\t`Your previous response was invalid: ${result.error}. Please respond with valid JSON matching the schema.`,\n\t\t\t);\n\t\t} else {\n\t\t\tconsole.error(\n\t\t\t\t`Structured output validation failed after ${MAX_STRUCTURED_RETRIES + 1} attempts: ${result.error}`,\n\t\t\t);\n\t\t\treturn 1;\n\t\t}\n\t}\n\n\treturn 1;\n}\n\n/**\n * Run in print (single-shot) mode.\n * Sends prompts to the agent and outputs the result.\n */\nexport async function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number> {\n\tconst { mode, messages = [], initialMessage, initialImages, maxTurns, outputSchema } = options;\n\tlet exitCode = 0;\n\tlet session = runtimeHost.session;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet disposed = false;\n\tconst signalCleanupHandlers: Array<() => void> = [];\n\tlet turnCount = 0;\n\n\tconst disposeRuntime = async (): Promise<void> => {\n\t\tif (disposed) return;\n\t\tdisposed = true;\n\t\tunsubscribe?.();\n\t\tawait runtimeHost.dispose();\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 disposeRuntime().finally(() => {\n\t\t\t\t\tprocess.exit(signal === \"SIGHUP\" ? 129 : 143);\n\t\t\t\t});\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\tregisterSignalHandlers();\n\n\truntimeHost.setRebindSession(async () => {\n\t\tawait rebindSession();\n\t});\n\n\tconst rebindSession = async (): Promise<void> => {\n\t\tsession = runtimeHost.session;\n\t\tawait session.bindExtensions({\n\t\t\tcommandContextActions: {\n\t\t\t\twaitForIdle: () => session.agent.waitForIdle(),\n\t\t\t\tnewSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions),\n\t\t\t\tfork: async (entryId, forkOptions) => {\n\t\t\t\t\tconst result = await runtimeHost.fork(entryId, forkOptions);\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tnavigateTree: async (targetId, navigateOptions) => {\n\t\t\t\t\tconst result = await session.navigateTree(targetId, {\n\t\t\t\t\t\tsummarize: navigateOptions?.summarize,\n\t\t\t\t\t\tcustomInstructions: navigateOptions?.customInstructions,\n\t\t\t\t\t\treplaceInstructions: navigateOptions?.replaceInstructions,\n\t\t\t\t\t\tlabel: navigateOptions?.label,\n\t\t\t\t\t});\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tswitchSession: async (sessionPath, switchOptions) => {\n\t\t\t\t\treturn runtimeHost.switchSession(sessionPath, switchOptions);\n\t\t\t\t},\n\t\t\t\treload: async () => {\n\t\t\t\t\tawait session.reload();\n\t\t\t\t},\n\t\t\t},\n\t\t\tonError: (err) => {\n\t\t\t\tconsole.error(`Extension error (${err.extensionPath}): ${err.error}`);\n\t\t\t},\n\t\t});\n\n\t\tunsubscribe?.();\n\t\tunsubscribe = session.subscribe((event) => {\n\t\t\tif (mode === \"json\") {\n\t\t\t\twriteRawStdout(`${JSON.stringify(event)}\\n`);\n\t\t\t}\n\t\t\tif (event.type === \"turn_end\") {\n\t\t\t\tturnCount++;\n\t\t\t\tif (maxTurns && maxTurns > 0 && turnCount >= maxTurns) {\n\t\t\t\t\tsession.agent.abort();\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t};\n\n\ttry {\n\t\tif (mode === \"json\") {\n\t\t\tconst header = session.sessionManager.getHeader();\n\t\t\tif (header) {\n\t\t\t\twriteRawStdout(`${JSON.stringify(header)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\tawait rebindSession();\n\n\t\tif (outputSchema) {\n\t\t\texitCode = await runStructuredOutput(session, outputSchema, initialMessage, initialImages, messages);\n\t\t} else {\n\t\t\tif (initialMessage) {\n\t\t\t\tawait session.prompt(initialMessage, { images: initialImages });\n\t\t\t}\n\n\t\t\tfor (const message of messages) {\n\t\t\t\tawait session.prompt(message);\n\t\t\t}\n\n\t\t\tif (mode === \"text\") {\n\t\t\t\tconst state = session.state;\n\t\t\t\tconst lastMessage = state.messages[state.messages.length - 1];\n\n\t\t\t\tif (lastMessage?.role === \"assistant\") {\n\t\t\t\t\tconst assistantMsg = lastMessage as AssistantMessage;\n\t\t\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\t\t\tconsole.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);\n\t\t\t\t\t\texitCode = 1;\n\t\t\t\t\t} else {\n\t\t\t\t\t\tfor (const content of assistantMsg.content) {\n\t\t\t\t\t\t\tif (content.type === \"text\") {\n\t\t\t\t\t\t\t\twriteRawStdout(`${content.text}\\n`);\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}\n\t\t\t}\n\t\t}\n\n\t\treturn exitCode;\n\t} catch (error: unknown) {\n\t\tconsole.error(error instanceof Error ? error.message : String(error));\n\t\treturn 1;\n\t} finally {\n\t\tfor (const cleanup of signalCleanupHandlers) {\n\t\t\tcleanup();\n\t\t}\n\t\tawait disposeRuntime();\n\t\tawait flushRawStdout();\n\t}\n}\n"]}

package/dist/modes/print-mode.js

@@ -7,12 +7,50 @@
  */
 import { flushRawStdout, writeRawStdout } from "../core/output-guard.js";
 import { killTrackedDetachedChildren } from "../utils/shell.js";
+import { validateStructuredOutput } from "../utils/structured-output.js";
+const MAX_STRUCTURED_RETRIES = 3;
+function getLastAssistantText(messages) {
+    const lastMessage = messages[messages.length - 1];
+    if (lastMessage?.role !== "assistant")
+        return "";
+    let text = "";
+    for (const content of lastMessage.content) {
+        if (content.type === "text") {
+            text += content.text;
+        }
+    }
+    return text;
+}
+async function runStructuredOutput(session, schema, initialMessage, initialImages, extraMessages) {
+    const schemaPrompt = `\n\nYou must respond with valid JSON matching this schema:\n${JSON.stringify(schema)}\n\nRespond with JSON only, no markdown code blocks.`;
+    const firstPrompt = (initialMessage ?? "") + schemaPrompt;
+    await session.prompt(firstPrompt, { images: initialImages });
+    for (const message of extraMessages ?? []) {
+        await session.prompt(message);
+    }
+    for (let attempt = 0; attempt <= MAX_STRUCTURED_RETRIES; attempt++) {
+        const raw = getLastAssistantText(session.state.messages);
+        const result = validateStructuredOutput(raw, schema);
+        if (result.success) {
+            writeRawStdout(`${JSON.stringify(result.data)}\n`);
+            return 0;
+        }
+        if (attempt < MAX_STRUCTURED_RETRIES) {
+            await session.prompt(`Your previous response was invalid: ${result.error}. Please respond with valid JSON matching the schema.`);
+        }
+        else {
+            console.error(`Structured output validation failed after ${MAX_STRUCTURED_RETRIES + 1} attempts: ${result.error}`);
+            return 1;
+        }
+    }
+    return 1;
+}
 /**
  * Run in print (single-shot) mode.
  * Sends prompts to the agent and outputs the result.
  */
 export async function runPrintMode(runtimeHost, options) {
-    const { mode, messages = [], initialMessage, initialImages, maxTurns } = options;
+    const { mode, messages = [], initialMessage, initialImages, maxTurns, outputSchema } = options;
     let exitCode = 0;
     let session = runtimeHost.session;
     let unsubscribe;
@@ -97,25 +135,30 @@ export async function runPrintMode(runtimeHost, options) {
             }
         }
         await rebindSession();
-        if (initialMessage) {
-            await session.prompt(initialMessage, { images: initialImages });
+        if (outputSchema) {
+            exitCode = await runStructuredOutput(session, outputSchema, initialMessage, initialImages, messages);
         }
-        for (const message of messages) {
-            await session.prompt(message);
-        }
-        if (mode === "text") {
-            const state = session.state;
-            const lastMessage = state.messages[state.messages.length - 1];
-            if (lastMessage?.role === "assistant") {
-                const assistantMsg = lastMessage;
-                if (assistantMsg.stopReason === "error" || assistantMsg.stopReason === "aborted") {
-                    console.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);
-                    exitCode = 1;
-                }
-                else {
-                    for (const content of assistantMsg.content) {
-                        if (content.type === "text") {
-                            writeRawStdout(`${content.text}\n`);
+        else {
+            if (initialMessage) {
+                await session.prompt(initialMessage, { images: initialImages });
+            }
+            for (const message of messages) {
+                await session.prompt(message);
+            }
+            if (mode === "text") {
+                const state = session.state;
+                const lastMessage = state.messages[state.messages.length - 1];
+                if (lastMessage?.role === "assistant") {
+                    const assistantMsg = lastMessage;
+                    if (assistantMsg.stopReason === "error" || assistantMsg.stopReason === "aborted") {
+                        console.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);
+                        exitCode = 1;
+                    }
+                    else {
+                        for (const content of assistantMsg.content) {
+                            if (content.type === "text") {
+                                writeRawStdout(`${content.text}\n`);
+                            }
                         }
                     }
                 }

package/dist/modes/print-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"print-mode.js","sourceRoot":"","sources":["../../src/modes/print-mode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Print mode (single-shot): Send prompts, output result, exit.\n *\n * Used for:\n * - `pi -p \"prompt\"` - text output\n * - `pi --mode json \"prompt\"` - JSON event stream\n */\n\nimport type { AssistantMessage, ImageContent } from \"@dyyz1993/pi-ai\";\nimport type { AgentSessionRuntime } from \"../core/agent-session-runtime.js\";\nimport { flushRawStdout, writeRawStdout } from \"../core/output-guard.js\";\nimport { killTrackedDetachedChildren } from \"../utils/shell.js\";\n\n/**\n * Options for print mode.\n */\nexport interface PrintModeOptions {\n\t/** Output mode: \"text\" for final response only, \"json\" for all events */\n\tmode: \"text\" | \"json\";\n\t/** Array of additional prompts to send after initialMessage */\n\tmessages?: string[];\n\t/** First message to send (may contain @file content) */\n\tinitialMessage?: string;\n\t/** Images to attach to the initial message */\n\tinitialImages?: ImageContent[];\n\t/** Maximum number of agent turns before aborting (0 = unlimited) */\n\tmaxTurns?: number;\n}\n\n/**\n * Run in print (single-shot) mode.\n * Sends prompts to the agent and outputs the result.\n */\nexport async function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number> {\n\tconst { mode, messages = [], initialMessage, initialImages, maxTurns } = options;\n\tlet exitCode = 0;\n\tlet session = runtimeHost.session;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet disposed = false;\n\tconst signalCleanupHandlers: Array<() => void> = [];\n\tlet turnCount = 0;\n\n\tconst disposeRuntime = async (): Promise<void> => {\n\t\tif (disposed) return;\n\t\tdisposed = true;\n\t\tunsubscribe?.();\n\t\tawait runtimeHost.dispose();\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 disposeRuntime().finally(() => {\n\t\t\t\t\tprocess.exit(signal === \"SIGHUP\" ? 129 : 143);\n\t\t\t\t});\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\tregisterSignalHandlers();\n\n\truntimeHost.setRebindSession(async () => {\n\t\tawait rebindSession();\n\t});\n\n\tconst rebindSession = async (): Promise<void> => {\n\t\tsession = runtimeHost.session;\n\t\tawait session.bindExtensions({\n\t\t\tcommandContextActions: {\n\t\t\t\twaitForIdle: () => session.agent.waitForIdle(),\n\t\t\t\tnewSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions),\n\t\t\t\tfork: async (entryId, forkOptions) => {\n\t\t\t\t\tconst result = await runtimeHost.fork(entryId, forkOptions);\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tnavigateTree: async (targetId, navigateOptions) => {\n\t\t\t\t\tconst result = await session.navigateTree(targetId, {\n\t\t\t\t\t\tsummarize: navigateOptions?.summarize,\n\t\t\t\t\t\tcustomInstructions: navigateOptions?.customInstructions,\n\t\t\t\t\t\treplaceInstructions: navigateOptions?.replaceInstructions,\n\t\t\t\t\t\tlabel: navigateOptions?.label,\n\t\t\t\t\t});\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tswitchSession: async (sessionPath, switchOptions) => {\n\t\t\t\t\treturn runtimeHost.switchSession(sessionPath, switchOptions);\n\t\t\t\t},\n\t\t\t\treload: async () => {\n\t\t\t\t\tawait session.reload();\n\t\t\t\t},\n\t\t\t},\n\t\t\tonError: (err) => {\n\t\t\t\tconsole.error(`Extension error (${err.extensionPath}): ${err.error}`);\n\t\t\t},\n\t\t});\n\n\t\tunsubscribe?.();\n\t\tunsubscribe = session.subscribe((event) => {\n\t\t\tif (mode === \"json\") {\n\t\t\t\twriteRawStdout(`${JSON.stringify(event)}\\n`);\n\t\t\t}\n\t\t\tif (event.type === \"turn_end\") {\n\t\t\t\tturnCount++;\n\t\t\t\tif (maxTurns && maxTurns > 0 && turnCount >= maxTurns) {\n\t\t\t\t\tsession.agent.abort();\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t};\n\n\ttry {\n\t\tif (mode === \"json\") {\n\t\t\tconst header = session.sessionManager.getHeader();\n\t\t\tif (header) {\n\t\t\t\twriteRawStdout(`${JSON.stringify(header)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\tawait rebindSession();\n\n\t\tif (initialMessage) {\n\t\t\tawait session.prompt(initialMessage, { images: initialImages });\n\t\t}\n\n\t\tfor (const message of messages) {\n\t\t\tawait session.prompt(message);\n\t\t}\n\n\t\tif (mode === \"text\") {\n\t\t\tconst state = session.state;\n\t\t\tconst lastMessage = state.messages[state.messages.length - 1];\n\n\t\t\tif (lastMessage?.role === \"assistant\") {\n\t\t\t\tconst assistantMsg = lastMessage as AssistantMessage;\n\t\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\t\tconsole.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);\n\t\t\t\t\texitCode = 1;\n\t\t\t\t} else {\n\t\t\t\t\tfor (const content of assistantMsg.content) {\n\t\t\t\t\t\tif (content.type === \"text\") {\n\t\t\t\t\t\t\twriteRawStdout(`${content.text}\\n`);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn exitCode;\n\t} catch (error: unknown) {\n\t\tconsole.error(error instanceof Error ? error.message : String(error));\n\t\treturn 1;\n\t} finally {\n\t\tfor (const cleanup of signalCleanupHandlers) {\n\t\t\tcleanup();\n\t\t}\n\t\tawait disposeRuntime();\n\t\tawait flushRawStdout();\n\t}\n}\n"]}
+{"version":3,"file":"print-mode.js","sourceRoot":"","sources":["../../src/modes/print-mode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Print mode (single-shot): Send prompts, output result, exit.\n *\n * Used for:\n * - `pi -p \"prompt\"` - text output\n * - `pi --mode json \"prompt\"` - JSON event stream\n */\n\nimport type { AgentMessage } from \"@dyyz1993/pi-agent-core\";\nimport type { AssistantMessage, ImageContent } from \"@dyyz1993/pi-ai\";\nimport type { TSchema } from \"typebox\";\nimport type { AgentSessionRuntime } from \"../core/agent-session-runtime.js\";\nimport { flushRawStdout, writeRawStdout } from \"../core/output-guard.js\";\nimport { killTrackedDetachedChildren } from \"../utils/shell.js\";\nimport { validateStructuredOutput } from \"../utils/structured-output.js\";\n\n/**\n * Options for print mode.\n */\nexport interface PrintModeOptions {\n\t/** Output mode: \"text\" for final response only, \"json\" for all events */\n\tmode: \"text\" | \"json\";\n\t/** Array of additional prompts to send after initialMessage */\n\tmessages?: string[];\n\t/** First message to send (may contain @file content) */\n\tinitialMessage?: string;\n\t/** Images to attach to the initial message */\n\tinitialImages?: ImageContent[];\n\t/** Maximum number of agent turns before aborting (0 = unlimited) */\n\tmaxTurns?: number;\n\t/** JSON schema for structured output validation (print mode only) */\n\toutputSchema?: TSchema;\n}\n\nconst MAX_STRUCTURED_RETRIES = 3;\n\nfunction getLastAssistantText(messages: AgentMessage[]): string {\n\tconst lastMessage = messages[messages.length - 1];\n\tif (lastMessage?.role !== \"assistant\") return \"\";\n\tlet text = \"\";\n\tfor (const content of (lastMessage as AssistantMessage).content) {\n\t\tif (content.type === \"text\") {\n\t\t\ttext += content.text;\n\t\t}\n\t}\n\treturn text;\n}\n\nasync function runStructuredOutput(\n\tsession: {\n\t\tprompt: (text: string, opts?: { images?: ImageContent[] }) => Promise<void>;\n\t\tstate: { messages: AgentMessage[] };\n\t\tagent: { waitForIdle: () => Promise<void> };\n\t},\n\tschema: TSchema,\n\tinitialMessage?: string,\n\tinitialImages?: ImageContent[],\n\textraMessages?: string[],\n): Promise<number> {\n\tconst schemaPrompt = `\\n\\nYou must respond with valid JSON matching this schema:\\n${JSON.stringify(schema)}\\n\\nRespond with JSON only, no markdown code blocks.`;\n\n\tconst firstPrompt = (initialMessage ?? \"\") + schemaPrompt;\n\tawait session.prompt(firstPrompt, { images: initialImages });\n\n\tfor (const message of extraMessages ?? []) {\n\t\tawait session.prompt(message);\n\t}\n\n\tfor (let attempt = 0; attempt <= MAX_STRUCTURED_RETRIES; attempt++) {\n\t\tconst raw = getLastAssistantText(session.state.messages);\n\t\tconst result = validateStructuredOutput(raw, schema);\n\n\t\tif (result.success) {\n\t\t\twriteRawStdout(`${JSON.stringify(result.data)}\\n`);\n\t\t\treturn 0;\n\t\t}\n\n\t\tif (attempt < MAX_STRUCTURED_RETRIES) {\n\t\t\tawait session.prompt(\n\t\t\t\t`Your previous response was invalid: ${result.error}. Please respond with valid JSON matching the schema.`,\n\t\t\t);\n\t\t} else {\n\t\t\tconsole.error(\n\t\t\t\t`Structured output validation failed after ${MAX_STRUCTURED_RETRIES + 1} attempts: ${result.error}`,\n\t\t\t);\n\t\t\treturn 1;\n\t\t}\n\t}\n\n\treturn 1;\n}\n\n/**\n * Run in print (single-shot) mode.\n * Sends prompts to the agent and outputs the result.\n */\nexport async function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number> {\n\tconst { mode, messages = [], initialMessage, initialImages, maxTurns, outputSchema } = options;\n\tlet exitCode = 0;\n\tlet session = runtimeHost.session;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet disposed = false;\n\tconst signalCleanupHandlers: Array<() => void> = [];\n\tlet turnCount = 0;\n\n\tconst disposeRuntime = async (): Promise<void> => {\n\t\tif (disposed) return;\n\t\tdisposed = true;\n\t\tunsubscribe?.();\n\t\tawait runtimeHost.dispose();\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 disposeRuntime().finally(() => {\n\t\t\t\t\tprocess.exit(signal === \"SIGHUP\" ? 129 : 143);\n\t\t\t\t});\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\tregisterSignalHandlers();\n\n\truntimeHost.setRebindSession(async () => {\n\t\tawait rebindSession();\n\t});\n\n\tconst rebindSession = async (): Promise<void> => {\n\t\tsession = runtimeHost.session;\n\t\tawait session.bindExtensions({\n\t\t\tcommandContextActions: {\n\t\t\t\twaitForIdle: () => session.agent.waitForIdle(),\n\t\t\t\tnewSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions),\n\t\t\t\tfork: async (entryId, forkOptions) => {\n\t\t\t\t\tconst result = await runtimeHost.fork(entryId, forkOptions);\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tnavigateTree: async (targetId, navigateOptions) => {\n\t\t\t\t\tconst result = await session.navigateTree(targetId, {\n\t\t\t\t\t\tsummarize: navigateOptions?.summarize,\n\t\t\t\t\t\tcustomInstructions: navigateOptions?.customInstructions,\n\t\t\t\t\t\treplaceInstructions: navigateOptions?.replaceInstructions,\n\t\t\t\t\t\tlabel: navigateOptions?.label,\n\t\t\t\t\t});\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tswitchSession: async (sessionPath, switchOptions) => {\n\t\t\t\t\treturn runtimeHost.switchSession(sessionPath, switchOptions);\n\t\t\t\t},\n\t\t\t\treload: async () => {\n\t\t\t\t\tawait session.reload();\n\t\t\t\t},\n\t\t\t},\n\t\t\tonError: (err) => {\n\t\t\t\tconsole.error(`Extension error (${err.extensionPath}): ${err.error}`);\n\t\t\t},\n\t\t});\n\n\t\tunsubscribe?.();\n\t\tunsubscribe = session.subscribe((event) => {\n\t\t\tif (mode === \"json\") {\n\t\t\t\twriteRawStdout(`${JSON.stringify(event)}\\n`);\n\t\t\t}\n\t\t\tif (event.type === \"turn_end\") {\n\t\t\t\tturnCount++;\n\t\t\t\tif (maxTurns && maxTurns > 0 && turnCount >= maxTurns) {\n\t\t\t\t\tsession.agent.abort();\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t};\n\n\ttry {\n\t\tif (mode === \"json\") {\n\t\t\tconst header = session.sessionManager.getHeader();\n\t\t\tif (header) {\n\t\t\t\twriteRawStdout(`${JSON.stringify(header)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\tawait rebindSession();\n\n\t\tif (outputSchema) {\n\t\t\texitCode = await runStructuredOutput(session, outputSchema, initialMessage, initialImages, messages);\n\t\t} else {\n\t\t\tif (initialMessage) {\n\t\t\t\tawait session.prompt(initialMessage, { images: initialImages });\n\t\t\t}\n\n\t\t\tfor (const message of messages) {\n\t\t\t\tawait session.prompt(message);\n\t\t\t}\n\n\t\t\tif (mode === \"text\") {\n\t\t\t\tconst state = session.state;\n\t\t\t\tconst lastMessage = state.messages[state.messages.length - 1];\n\n\t\t\t\tif (lastMessage?.role === \"assistant\") {\n\t\t\t\t\tconst assistantMsg = lastMessage as AssistantMessage;\n\t\t\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\t\t\tconsole.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);\n\t\t\t\t\t\texitCode = 1;\n\t\t\t\t\t} else {\n\t\t\t\t\t\tfor (const content of assistantMsg.content) {\n\t\t\t\t\t\t\tif (content.type === \"text\") {\n\t\t\t\t\t\t\t\twriteRawStdout(`${content.text}\\n`);\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}\n\t\t\t}\n\t\t}\n\n\t\treturn exitCode;\n\t} catch (error: unknown) {\n\t\tconsole.error(error instanceof Error ? error.message : String(error));\n\t\treturn 1;\n\t} finally {\n\t\tfor (const cleanup of signalCleanupHandlers) {\n\t\t\tcleanup();\n\t\t}\n\t\tawait disposeRuntime();\n\t\tawait flushRawStdout();\n\t}\n}\n"]}

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

@@ -9,8 +9,7 @@ import type { SessionStats } from "../../core/agent-session.js";
 import type { BashResult } from "../../core/bash-executor.js";
 import type { CompactionResult } from "../../core/compaction/index.js";
 import type { Channel } from "../../core/extensions/channel-types.js";
-import type { Settings } from "../../core/settings-manager.js";
-import type { RpcContextUsage, RpcExtension, RpcExtensionFlag, RpcSessionState, RpcSkill, RpcSlashCommand, RpcTool, TreeEntry } from "./rpc-types.js";
+import type { RpcExtension, RpcSessionState, RpcSkill, RpcSlashCommand, RpcTool } from "./rpc-types.js";
 export interface RpcClientOptions {
     /** Path to the CLI entry point (default: searches for dist/cli.js) */
     cliPath?: string;
@@ -34,10 +33,6 @@ export interface ModelInfo {
     reasoning: boolean;
 }
 export type RpcEventListener = (event: AgentEvent) => void;
-/**
- * Entry in the session tree.
- */
-export type { TreeEntry } from "./rpc-types.js";
 export declare class RpcClient {
     private options;
     private process;
@@ -181,23 +176,9 @@ export declare class RpcClient {
      * Fork from a specific message.
      * @returns Object with `text` (the message text) and `cancelled` (if extension cancelled)
      */
-    fork(entryId: string, options?: {
-        position?: "before" | "at";
-    }): Promise<{
+    fork(entryId: string): Promise<{
         text: string;
         cancelled: boolean;
-        newSessionFile?: string;
-        newSessionId?: string;
-    }>;
-    navigateTree(targetId: string, options?: {
-        summarize?: boolean;
-        skipFiles?: boolean;
-    }): Promise<{
-        cancelled: boolean;
-    }>;
-    previewRollback(targetId: string): Promise<{
-        restored: string[];
-        deleted: string[];
     }>;
     /**
      * Clone the current active branch into a new session.
@@ -225,20 +206,6 @@ export declare class RpcClient {
      * Get all messages in the session.
      */
     getMessages(): Promise<AgentMessage[]>;
-    getFullMessages(options?: {
-        afterEntryId?: string;
-        limit?: number;
-    }): Promise<{
-        messages: AgentMessage[];
-        hasMore: boolean;
-        totalCount: number;
-        nextCursor: string | null;
-    }>;
-    getTree(): Promise<TreeEntry[]>;
-    getTreeWithLeaf(): Promise<{
-        entries: TreeEntry[];
-        leafId: string | null;
-    }>;
     /**
      * Get available commands (extension commands, prompt templates, skills).
      */
@@ -246,38 +213,96 @@ export declare class RpcClient {
     getSkills(): Promise<RpcSkill[]>;
     getExtensions(): Promise<RpcExtension[]>;
     getTools(): Promise<RpcTool[]>;
-    getSettings(scope?: "global" | "project"): Promise<Settings>;
-    setSettings(settings: Partial<Settings>, scope?: "global" | "project"): Promise<void>;
-    getContextUsage(): Promise<RpcContextUsage>;
+    getSettings(scope?: "global" | "project"): Promise<Record<string, unknown>>;
+    setSettings(settings: Record<string, unknown>, scope?: "global" | "project"): Promise<void>;
+    getContextUsage(): Promise<Record<string, unknown>>;
     getSystemPrompt(): Promise<{
         systemPrompt: string;
-        appendSystemPrompt: string[];
+        appendSystemPrompt?: string;
     }>;
     getActiveTools(): Promise<string[]>;
     setActiveTools(toolNames: string[]): Promise<void>;
     getQueue(): Promise<{
-        steering: string[];
-        followUp: string[];
+        steering: unknown[];
+        followUp: unknown[];
     }>;
     clearQueue(): Promise<{
-        steering: string[];
-        followUp: string[];
+        steering: unknown[];
+        followUp: unknown[];
     }>;
-    getFlags(): Promise<RpcExtensionFlag[]>;
-    getFlagValues(): Promise<Record<string, boolean | string>>;
-    setFlag(name: string, value: boolean | string): Promise<void>;
+    getFlags(): Promise<Record<string, unknown>>;
+    getFlagValues(): Promise<Record<string, unknown>>;
+    setFlag(name: string, value: string | boolean): Promise<void>;
     reload(): Promise<void>;
+    getAgentsFiles(): Promise<string[]>;
     setCwd(cwd: string): Promise<void>;
-    getAgentsFiles(): Promise<Array<{
+    getFullMessages(options?: {
+        limit?: number;
+        afterEntryId?: string;
+        includeUserMessages?: boolean;
+        direction?: "asc" | "desc";
+    }): Promise<Record<string, unknown>>;
+    getTree(): Promise<{
+        entries: unknown[];
+        leafId: string;
+    }>;
+    getModifiedFiles(options?: {
+        fromEntryId?: string;
+        toEntryId?: string;
+    }): Promise<Array<{
         path: string;
-        content: string;
+        status: "added" | "modified" | "deleted";
+        turnIndex: number;
+        entryId: string;
     }>>;
-    registerRemoteTool(tool: {
-        name: string;
-        description: string;
-        parameters: object;
-    }): Promise<void>;
-    unregisterRemoteTool(name: string): Promise<void>;
+    getFileDiff(options: {
+        filePath: string;
+        fromEntryId?: string;
+        toEntryId?: string;
+    }): Promise<{
+        path: string;
+        oldContent: string | null;
+        newContent: string | null;
+        unifiedDiff: string;
+    } | null>;
+    getBatchDiffs(options?: {
+        fromEntryId?: string;
+        toEntryId?: string;
+    }): Promise<{
+        files: Array<{
+            path: string;
+            status: "added" | "modified" | "deleted";
+            diff: {
+                path: string;
+                oldContent: string | null;
+                newContent: string | null;
+                unifiedDiff: string;
+            } | null;
+        }>;
+        summary: {
+            totalFiles: number;
+            added: number;
+            modified: number;
+            deleted: number;
+        };
+    }>;
+    getFileHistory(options: {
+        filePath: string;
+    }): Promise<{
+        history: Array<{
+            entryId: string;
+            turnIndex: number;
+            timestamp: string;
+            status: "added" | "modified" | "deleted";
+            snapshotHash: string;
+            previousHash: string | null;
+        }>;
+    }>;
+    onRemoteToolCall(handler: (call: {
+        toolCallId: string;
+        toolName: string;
+        args: Record<string, unknown>;
+    }) => void): () => void;
     sendRemoteToolResult(toolCallId: string, result: {
         content: Array<{
             type: string;
@@ -286,11 +311,7 @@ export declare class RpcClient {
         isError: boolean;
     }): void;
     respondUI(requestId: string, response: Record<string, unknown>): void;
-    onRemoteToolCall(handler: (call: {
-        toolCallId: string;
-        toolName: string;
-        args: Record<string, unknown>;
-    }) => void): () => void;
+    channel(name: string): Pick<Channel, "name" | "send" | "onReceive" | "invoke" | "call">;
     /**
      * Wait for agent to become idle (no streaming).
      * Resolves when agent_end event is received.
@@ -304,7 +325,6 @@ export declare class RpcClient {
      * Send prompt and wait for completion, returning all events.
      */
     promptAndWait(message: string, images?: ImageContent[], timeout?: number): Promise<AgentEvent[]>;
-    channel(name: string): Pick<Channel, "name" | "send" | "onReceive" | "invoke" | "call">;
     private handleLine;
     private send;
     private getData;

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

@@ -1 +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 { randomUUID } from \"node:crypto\";\nimport type { AgentEvent, AgentMessage, ThinkingLevel } from \"@dyyz1993/pi-agent-core\";\nimport type { ImageContent } from \"@dyyz1993/pi-ai\";\nimport type { SessionStats } from \"../../core/agent-session.js\";\nimport type { BashResult } from \"../../core/bash-executor.js\";\nimport type { CompactionResult } from \"../../core/compaction/index.js\";\nimport type { Channel, ChannelDataMessage } from \"../../core/extensions/channel-types.js\";\nimport type { Settings } from \"../../core/settings-manager.js\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.js\";\nimport type {\n\tRpcCommand,\n\tRpcContextUsage,\n\tRpcExtension,\n\tRpcExtensionFlag,\n\tRpcResponse,\n\tRpcSessionState,\n\tRpcSkill,\n\tRpcSlashCommand,\n\tRpcTool,\n\tTreeEntry,\n} from \"./rpc-types.js\";\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) */\ntype RpcCommandBody = DistributiveOmit<RpcCommand, \"id\">;\n\nexport interface RpcClientOptions {\n\t/** Path to the CLI entry point (default: searches for dist/cli.js) */\n\tcliPath?: string;\n\t/** Working directory for the agent */\n\tcwd?: string;\n\t/** Environment variables */\n\tenv?: Record<string, string>;\n\t/** Provider to use */\n\tprovider?: string;\n\t/** Model ID to use */\n\tmodel?: string;\n\t/** Additional CLI arguments */\n\targs?: string[];\n\t/** Session-scoped variables passed to extensions via ctx.variables */\n\tvariables?: Record<string, string>;\n}\n\nexport interface ModelInfo {\n\tprovider: string;\n\tid: string;\n\tcontextWindow: number;\n\treasoning: boolean;\n}\n\nexport type RpcEventListener = (event: AgentEvent) => void;\n\n// ============================================================================\n// Type exports\n// ============================================================================\n\n/**\n * Entry in the session tree.\n */\nexport type { TreeEntry } from \"./rpc-types.js\";\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 pendingRequests: Map<string, { resolve: (response: RpcResponse) => void; reject: (error: Error) => void }> =\n\t\tnew Map();\n\tprivate requestId = 0;\n\tprivate channelHandlers = new Map<string, Set<(data: unknown) => void>>();\n\tprivate remoteToolCallHandlers: Array<\n\t\t(call: { toolCallId: string; toolName: string; args: Record<string, unknown> }) => void\n\t> = [];\n\tprivate stderr = \"\";\n\tprivate readyResolve: (() => void) | null = null;\n\n\tconstructor(private options: RpcClientOptions = {}) {}\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\tconst cliPath = this.options.cliPath ?? \"dist/cli.js\";\n\t\tconst args = [\"--mode\", \"rpc\"];\n\n\t\tif (this.options.provider) {\n\t\t\targs.push(\"--provider\", this.options.provider);\n\t\t}\n\t\tif (this.options.model) {\n\t\t\targs.push(\"--model\", this.options.model);\n\t\t}\n\t\tif (this.options.args) {\n\t\t\targs.push(...this.options.args);\n\t\t}\n\n\t\tconst mergedEnv: Record<string, string> = { ...process.env, ...this.options.env } as Record<string, string>;\n\t\tif (this.options.variables) {\n\t\t\tfor (const [key, value] of Object.entries(this.options.variables)) {\n\t\t\t\tmergedEnv[`PI_VARIABLE_${key.toUpperCase()}`] = value;\n\t\t\t}\n\t\t}\n\n\t\tthis.process = spawn(\"node\", [cliPath, ...args], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: mergedEnv,\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\t// Collect stderr for debugging\n\t\tthis.process.stderr?.on(\"data\", (data) => {\n\t\t\tthis.stderr += data.toString();\n\t\t\tprocess.stderr.write(data);\n\t\t});\n\n\t\t// Set up strict JSONL reader for stdout.\n\t\tthis.stopReadingStdout = attachJsonlLineReader(this.process.stdout!, (line) => {\n\t\t\tthis.handleLine(line);\n\t\t});\n\n\t\t// Wait for first stdout line (agent ready)\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tthis.readyResolve = resolve;\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tthis.readyResolve = null;\n\t\t\t\treject(new Error(`Agent process did not become ready. Stderr: ${this.stderr}`));\n\t\t\t}, 15000);\n\t\t\tthis.readyResolve = () => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t});\n\n\t\tif (this.process.exitCode !== null) {\n\t\t\tthrow new Error(`Agent process exited immediately with code ${this.process.exitCode}. Stderr: ${this.stderr}`);\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}\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 * 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 parent tracking.\n\t * @param parentSession - Optional parent session path for lineage tracking\n\t * @returns Object with `cancelled: true` if an extension cancelled the new session\n\t */\n\tasync newSession(parentSession?: string): Promise<{ cancelled: boolean }> {\n\t\tconst response = await this.send({ type: \"new_session\", parentSession });\n\t\treturn this.getData(response);\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<{ provider: string; id: string }> {\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<{\n\t\tmodel: { provider: string; id: string };\n\t\tthinkingLevel: ThinkingLevel;\n\t\tisScoped: boolean;\n\t} | 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<{ level: ThinkingLevel } | 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: \"all\" | \"one-at-a-time\"): 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: \"all\" | \"one-at-a-time\"): 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 */\n\tasync bash(command: string): Promise<BashResult> {\n\t\tconst response = await this.send({ type: \"bash\", command });\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 * 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<{ path: string }> {\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<{ cancelled: boolean }> {\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(\n\t\tentryId: string,\n\t\toptions?: { position?: \"before\" | \"at\" },\n\t): Promise<{ text: string; cancelled: boolean; newSessionFile?: string; newSessionId?: string }> {\n\t\tconst response = await this.send({ type: \"fork\", entryId, position: options?.position });\n\t\treturn this.getData(response);\n\t}\n\n\tasync navigateTree(\n\t\ttargetId: string,\n\t\toptions?: { summarize?: boolean; skipFiles?: boolean },\n\t): Promise<{ cancelled: boolean }> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"navigate_tree\",\n\t\t\ttargetId,\n\t\t\tsummarize: options?.summarize,\n\t\t\tskipFiles: options?.skipFiles,\n\t\t});\n\t\treturn this.getData(response);\n\t}\n\n\tasync previewRollback(targetId: string): Promise<{ restored: string[]; deleted: string[] }> {\n\t\tconst response = await this.send({ type: \"rollback_preview\", targetId });\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<{ cancelled: boolean }> {\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<Array<{ entryId: string; text: string }>> {\n\t\tconst response = await this.send({ type: \"get_fork_messages\" });\n\t\treturn this.getData<{ messages: Array<{ entryId: string; text: string }> }>(response).messages;\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\tasync getFullMessages(options?: { afterEntryId?: string; limit?: number }): Promise<{\n\t\tmessages: AgentMessage[];\n\t\thasMore: boolean;\n\t\ttotalCount: number;\n\t\tnextCursor: string | null;\n\t}> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"get_full_messages\",\n\t\t\tafterEntryId: options?.afterEntryId,\n\t\t\tlimit: options?.limit,\n\t\t});\n\t\treturn this.getData<{\n\t\t\tmessages: AgentMessage[];\n\t\t\thasMore: boolean;\n\t\t\ttotalCount: number;\n\t\t\tnextCursor: string | null;\n\t\t}>(response);\n\t}\n\n\tasync getTree(): Promise<TreeEntry[]> {\n\t\tconst response = await this.send({ type: \"get_tree\" });\n\t\tconst data = this.getData<{\n\t\t\tentries: TreeEntry[];\n\t\t\tleafId?: string | null;\n\t\t}>(response);\n\t\treturn data.entries;\n\t}\n\n\tasync getTreeWithLeaf(): Promise<{\n\t\tentries: TreeEntry[];\n\t\tleafId: string | null;\n\t}> {\n\t\tconst response = await this.send({ type: \"get_tree\" });\n\t\tconst data = this.getData<{\n\t\t\tentries: TreeEntry[];\n\t\t\tleafId?: string | null;\n\t\t}>(response);\n\t\treturn { entries: data.entries, leafId: data.leafId ?? null };\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\tasync getSkills(): Promise<RpcSkill[]> {\n\t\tconst response = await this.send({ type: \"get_skills\" });\n\t\treturn this.getData<{ skills: RpcSkill[] }>(response).skills;\n\t}\n\n\tasync getExtensions(): Promise<RpcExtension[]> {\n\t\tconst response = await this.send({ type: \"get_extensions\" });\n\t\treturn this.getData<{ extensions: RpcExtension[] }>(response).extensions;\n\t}\n\n\tasync getTools(): Promise<RpcTool[]> {\n\t\tconst response = await this.send({ type: \"get_tools\" });\n\t\treturn this.getData<{ tools: RpcTool[] }>(response).tools;\n\t}\n\n\tasync getSettings(scope?: \"global\" | \"project\"): Promise<Settings> {\n\t\tconst response = await this.send({ type: \"get_settings\", scope });\n\t\treturn this.getData<Settings>(response);\n\t}\n\n\tasync setSettings(settings: Partial<Settings>, scope?: \"global\" | \"project\"): Promise<void> {\n\t\tawait this.send({ type: \"set_settings\", settings, scope });\n\t}\n\n\tasync getContextUsage(): Promise<RpcContextUsage> {\n\t\tconst response = await this.send({ type: \"get_context_usage\" });\n\t\treturn this.getData<RpcContextUsage>(response);\n\t}\n\n\tasync getSystemPrompt(): Promise<{ systemPrompt: string; appendSystemPrompt: string[] }> {\n\t\tconst response = await this.send({ type: \"get_system_prompt\" });\n\t\treturn this.getData<{ systemPrompt: string; appendSystemPrompt: string[] }>(response);\n\t}\n\n\tasync getActiveTools(): Promise<string[]> {\n\t\tconst response = await this.send({ type: \"get_active_tools\" });\n\t\treturn this.getData<{ toolNames: string[] }>(response).toolNames;\n\t}\n\n\tasync setActiveTools(toolNames: string[]): Promise<void> {\n\t\tawait this.send({ type: \"set_active_tools\", toolNames });\n\t}\n\n\tasync getQueue(): Promise<{ steering: string[]; followUp: string[] }> {\n\t\tconst response = await this.send({ type: \"get_queue\" });\n\t\treturn this.getData<{ steering: string[]; followUp: string[] }>(response);\n\t}\n\n\tasync clearQueue(): Promise<{ steering: string[]; followUp: string[] }> {\n\t\tconst response = await this.send({ type: \"clear_queue\" });\n\t\treturn this.getData<{ steering: string[]; followUp: string[] }>(response);\n\t}\n\n\tasync getFlags(): Promise<RpcExtensionFlag[]> {\n\t\tconst response = await this.send({ type: \"get_flags\" });\n\t\treturn this.getData<{ flags: RpcExtensionFlag[] }>(response).flags;\n\t}\n\n\tasync getFlagValues(): Promise<Record<string, boolean | string>> {\n\t\tconst response = await this.send({ type: \"get_flag_values\" });\n\t\treturn this.getData<{ values: Record<string, boolean | string> }>(response).values;\n\t}\n\n\tasync setFlag(name: string, value: boolean | string): Promise<void> {\n\t\tawait this.send({ type: \"set_flag\", name, value });\n\t}\n\n\tasync reload(): Promise<void> {\n\t\tawait this.send({ type: \"reload\" });\n\t}\n\n\tasync setCwd(cwd: string): Promise<void> {\n\t\tawait this.send({ type: \"set_cwd\", cwd });\n\t}\n\n\tasync getAgentsFiles(): Promise<Array<{ path: string; content: string }>> {\n\t\tconst response = await this.send({ type: \"get_agents_files\" });\n\t\treturn this.getData<{ agentsFiles: Array<{ path: string; content: string }> }>(response).agentsFiles;\n\t}\n\n\tasync registerRemoteTool(tool: { name: string; description: string; parameters: object }): Promise<void> {\n\t\tawait this.send({ type: \"register_remote_tool\", tool });\n\t}\n\n\tasync unregisterRemoteTool(name: string): Promise<void> {\n\t\tawait this.send({ type: \"unregister_remote_tool\", name });\n\t}\n\n\tsendRemoteToolResult(\n\t\ttoolCallId: string,\n\t\tresult: { content: Array<{ type: string; text: string }>; isError: boolean },\n\t): void {\n\t\tthis.writeLine({ type: \"remote_tool_result\", toolCallId, result });\n\t}\n\n\trespondUI(requestId: string, response: Record<string, unknown>): void {\n\t\tthis.writeLine({ type: \"extension_ui_response\", id: requestId, ...response });\n\t}\n\n\tonRemoteToolCall(\n\t\thandler: (call: { toolCallId: string; toolName: string; args: Record<string, unknown> }) => void,\n\t): () => void {\n\t\tthis.remoteToolCallHandlers.push(handler);\n\t\treturn () => {\n\t\t\tconst index = this.remoteToolCallHandlers.indexOf(handler);\n\t\t\tif (index !== -1) this.remoteToolCallHandlers.splice(index, 1);\n\t\t};\n\t}\n\n\t// =========================================================================\n\t// Helpers\n\t// =========================================================================\n\n\t/**\n\t * Wait for agent to become idle (no streaming).\n\t * Resolves when agent_end event is received.\n\t */\n\twaitForIdle(timeout = 60000): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tunsubscribe();\n\t\t\t\treject(new Error(`Timeout waiting for agent to become idle. Stderr: ${this.stderr}`));\n\t\t\t}, timeout);\n\n\t\t\tconst unsubscribe = this.onEvent((event) => {\n\t\t\t\tif (event.type === \"agent_end\") {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tunsubscribe();\n\t\t\t\t\tresolve();\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Collect events until agent becomes idle.\n\t */\n\tcollectEvents(timeout = 60000): Promise<AgentEvent[]> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst events: AgentEvent[] = [];\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tunsubscribe();\n\t\t\t\treject(new Error(`Timeout collecting events. Stderr: ${this.stderr}`));\n\t\t\t}, timeout);\n\n\t\t\tconst unsubscribe = this.onEvent((event) => {\n\t\t\t\tevents.push(event);\n\t\t\t\tif (event.type === \"agent_end\") {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tunsubscribe();\n\t\t\t\t\tresolve(events);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Send prompt and wait for completion, returning all events.\n\t */\n\tasync promptAndWait(message: string, images?: ImageContent[], timeout = 60000): Promise<AgentEvent[]> {\n\t\tconst eventsPromise = this.collectEvents(timeout);\n\t\tawait this.prompt(message, images);\n\t\treturn eventsPromise;\n\t}\n\n\tchannel(name: string): Pick<Channel, \"name\" | \"send\" | \"onReceive\" | \"invoke\" | \"call\"> {\n\t\tconst invokeImpl = (data: unknown, timeoutMs: number = 30_000): Promise<unknown> => {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tconst invokeId = `inv_${randomUUID().slice(0, 8)}`;\n\t\t\t\tconst timer = setTimeout(() => {\n\t\t\t\t\treject(new Error(`Channel invoke \"${name}\" timed out after ${timeoutMs}ms`));\n\t\t\t\t}, timeoutMs);\n\n\t\t\t\tconst handler = (responseData: unknown) => {\n\t\t\t\t\tconst d = responseData as Record<string, unknown>;\n\t\t\t\t\tif (d && d.invokeId === invokeId) {\n\t\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\t\tconst handlers = this.channelHandlers.get(name);\n\t\t\t\t\t\tif (handlers) handlers.delete(handler);\n\t\t\t\t\t\tresolve(responseData);\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tlet handlers = this.channelHandlers.get(name);\n\t\t\t\tif (!handlers) {\n\t\t\t\t\thandlers = new Set();\n\t\t\t\t\tthis.channelHandlers.set(name, handlers);\n\t\t\t\t}\n\t\t\t\thandlers.add(handler);\n\n\t\t\t\tthis.writeLine({\n\t\t\t\t\ttype: \"channel_data\",\n\t\t\t\t\tname,\n\t\t\t\t\tdata: { ...((data as Record<string, unknown>) ?? {}), invokeId },\n\t\t\t\t} as ChannelDataMessage);\n\t\t\t});\n\t\t};\n\n\t\treturn {\n\t\t\tname,\n\t\t\tsend: (data: unknown) => {\n\t\t\t\tthis.writeLine({ type: \"channel_data\", name, data } as ChannelDataMessage);\n\t\t\t},\n\t\t\tonReceive: (handler: (data: unknown) => void) => {\n\t\t\t\tlet handlers = this.channelHandlers.get(name);\n\t\t\t\tif (!handlers) {\n\t\t\t\t\thandlers = new Set();\n\t\t\t\t\tthis.channelHandlers.set(name, handlers);\n\t\t\t\t}\n\t\t\t\thandlers.add(handler);\n\t\t\t\treturn () => {\n\t\t\t\t\thandlers!.delete(handler);\n\t\t\t\t\tif (handlers!.size === 0) this.channelHandlers.delete(name);\n\t\t\t\t};\n\t\t\t},\n\t\t\tinvoke: invokeImpl,\n\t\t\tcall: (method: string, params: Record<string, unknown>, timeoutMs?: number) => {\n\t\t\t\tconst payload = { ...params, __call: method };\n\t\t\t\treturn invokeImpl(payload, timeoutMs ?? 30_000);\n\t\t\t},\n\t\t};\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 (this.readyResolve && data.type === \"ready\") {\n\t\t\t\tconst resolve = this.readyResolve;\n\t\t\t\tthis.readyResolve = null;\n\t\t\t\tresolve();\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// Check if it's channel data\n\t\t\tif (data.type === \"channel_data\" && data.name) {\n\t\t\t\tconst handlers = this.channelHandlers.get(data.name as string);\n\t\t\t\tif (handlers) {\n\t\t\t\t\tconst payload = data.data as Record<string, unknown> | undefined;\n\t\t\t\t\tconst invokeId = payload?.invokeId as string | undefined;\n\n\t\t\t\t\tfor (const handler of handlers) {\n\t\t\t\t\t\tconst result = handler(data.data);\n\t\t\t\t\t\tif (invokeId && result !== undefined) {\n\t\t\t\t\t\t\tthis.writeLine({\n\t\t\t\t\t\t\t\ttype: \"channel_data\",\n\t\t\t\t\t\t\t\tname: data.name,\n\t\t\t\t\t\t\t\tdata: { ...(typeof result === \"object\" ? result : { value: result }), invokeId },\n\t\t\t\t\t\t\t} as ChannelDataMessage);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Check if it's a remote tool call\n\t\t\tif (data.type === \"remote_tool_call\" && data.toolCallId && data.toolName) {\n\t\t\t\tfor (const handler of this.remoteToolCallHandlers) {\n\t\t\t\t\thandler({ toolCallId: data.toolCallId, toolName: data.toolName, args: data.args ?? {} });\n\t\t\t\t}\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 AgentEvent);\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 send(command: RpcCommandBody): Promise<RpcResponse> {\n\t\tif (!this.process?.stdin) {\n\t\t\tthrow new Error(\"Client not started\");\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\tthis.pendingRequests.set(id, { resolve, reject });\n\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\tthis.process!.stdin!.write(serializeJsonLine(fullCommand));\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\tconst successResponse = response as Extract<RpcResponse, { success: true; data: unknown }>;\n\t\treturn successResponse.data as T;\n\t}\n\n\tprivate writeLine(obj: object): void {\n\t\tif (!this.process?.stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tthis.process.stdin.write(serializeJsonLine(obj));\n\t}\n}\n"]}
+{"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 { randomUUID } from \"node:crypto\";\nimport type { AgentEvent, AgentMessage, ThinkingLevel } from \"@dyyz1993/pi-agent-core\";\nimport type { ImageContent } from \"@dyyz1993/pi-ai\";\nimport type { SessionStats } from \"../../core/agent-session.js\";\nimport type { BashResult } from \"../../core/bash-executor.js\";\nimport type { CompactionResult } from \"../../core/compaction/index.js\";\nimport type { Channel, ChannelDataMessage } from \"../../core/extensions/channel-types.js\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.js\";\nimport type {\n\tRpcCommand,\n\tRpcExtension,\n\tRpcResponse,\n\tRpcSessionState,\n\tRpcSkill,\n\tRpcSlashCommand,\n\tRpcTool,\n\tTreeEntry,\n} from \"./rpc-types.js\";\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) */\ntype RpcCommandBody = DistributiveOmit<RpcCommand, \"id\">;\n\nexport interface RpcClientOptions {\n\t/** Path to the CLI entry point (default: searches for dist/cli.js) */\n\tcliPath?: string;\n\t/** Working directory for the agent */\n\tcwd?: string;\n\t/** Environment variables */\n\tenv?: Record<string, string>;\n\t/** Provider to use */\n\tprovider?: string;\n\t/** Model ID to use */\n\tmodel?: string;\n\t/** Additional CLI arguments */\n\targs?: string[];\n\t/** Session-scoped variables passed to extensions via ctx.variables */\n\tvariables?: Record<string, string>;\n}\n\nexport interface ModelInfo {\n\tprovider: string;\n\tid: string;\n\tcontextWindow: number;\n\treasoning: boolean;\n}\n\nexport type RpcEventListener = (event: AgentEvent) => void;\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 pendingRequests: Map<string, { resolve: (response: RpcResponse) => void; reject: (error: Error) => void }> =\n\t\tnew Map();\n\tprivate requestId = 0;\n\tprivate channelHandlers = new Map<string, Set<(data: unknown) => void>>();\n\tprivate remoteToolCallHandlers: Array<\n\t\t(call: { toolCallId: string; toolName: string; args: Record<string, unknown> }) => void\n\t> = [];\n\tprivate stderr = \"\";\n\tprivate readyResolve: (() => void) | null = null;\n\n\tconstructor(private options: RpcClientOptions = {}) {}\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\tconst cliPath = this.options.cliPath ?? \"dist/cli.js\";\n\t\tconst args = [\"--mode\", \"rpc\"];\n\n\t\tif (this.options.provider) {\n\t\t\targs.push(\"--provider\", this.options.provider);\n\t\t}\n\t\tif (this.options.model) {\n\t\t\targs.push(\"--model\", this.options.model);\n\t\t}\n\t\tif (this.options.args) {\n\t\t\targs.push(...this.options.args);\n\t\t}\n\n\t\tconst mergedEnv: Record<string, string> = { ...process.env, ...this.options.env } as Record<string, string>;\n\t\tif (this.options.variables) {\n\t\t\tfor (const [key, value] of Object.entries(this.options.variables)) {\n\t\t\t\tmergedEnv[`PI_VARIABLE_${key.toUpperCase()}`] = value;\n\t\t\t}\n\t\t}\n\n\t\tthis.process = spawn(\"node\", [cliPath, ...args], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: mergedEnv,\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\t// Collect stderr for debugging\n\t\tthis.process.stderr?.on(\"data\", (data) => {\n\t\t\tthis.stderr += data.toString();\n\t\t\tprocess.stderr.write(data);\n\t\t});\n\n\t\t// Set up strict JSONL reader for stdout.\n\t\tthis.stopReadingStdout = attachJsonlLineReader(this.process.stdout!, (line) => {\n\t\t\tthis.handleLine(line);\n\t\t});\n\n\t\t// Wait for first stdout line (agent ready)\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tthis.readyResolve = resolve;\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tthis.readyResolve = null;\n\t\t\t\treject(new Error(`Agent process did not become ready. Stderr: ${this.stderr}`));\n\t\t\t}, 15000);\n\t\t\tthis.readyResolve = () => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t});\n\n\t\tif (this.process.exitCode !== null) {\n\t\t\tthrow new Error(`Agent process exited immediately with code ${this.process.exitCode}. Stderr: ${this.stderr}`);\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}\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 * 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 parent tracking.\n\t * @param parentSession - Optional parent session path for lineage tracking\n\t * @returns Object with `cancelled: true` if an extension cancelled the new session\n\t */\n\tasync newSession(parentSession?: string): Promise<{ cancelled: boolean }> {\n\t\tconst response = await this.send({ type: \"new_session\", parentSession });\n\t\treturn this.getData(response);\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<{ provider: string; id: string }> {\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<{\n\t\tmodel: { provider: string; id: string };\n\t\tthinkingLevel: ThinkingLevel;\n\t\tisScoped: boolean;\n\t} | 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<{ level: ThinkingLevel } | 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: \"all\" | \"one-at-a-time\"): 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: \"all\" | \"one-at-a-time\"): 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 */\n\tasync bash(command: string): Promise<BashResult> {\n\t\tconst response = await this.send({ type: \"bash\", command });\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 * 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<{ path: string }> {\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<{ cancelled: boolean }> {\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<{ text: string; cancelled: boolean }> {\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<{ cancelled: boolean }> {\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<Array<{ entryId: string; text: string }>> {\n\t\tconst response = await this.send({ type: \"get_fork_messages\" });\n\t\treturn this.getData<{ messages: Array<{ entryId: string; text: string }> }>(response).messages;\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\tasync getSkills(): Promise<RpcSkill[]> {\n\t\tconst response = await this.send({ type: \"get_skills\" });\n\t\treturn this.getData<{ skills: RpcSkill[] }>(response).skills;\n\t}\n\n\tasync getExtensions(): Promise<RpcExtension[]> {\n\t\tconst response = await this.send({ type: \"get_extensions\" });\n\t\treturn this.getData<{ extensions: RpcExtension[] }>(response).extensions;\n\t}\n\n\tasync getTools(): Promise<RpcTool[]> {\n\t\tconst response = await this.send({ type: \"get_tools\" });\n\t\treturn this.getData<{ tools: RpcTool[] }>(response).tools;\n\t}\n\n\tasync getSettings(scope?: \"global\" | \"project\"): Promise<Record<string, unknown>> {\n\t\tconst command: Record<string, unknown> = { type: \"get_settings\" };\n\t\tif (scope) command.scope = scope;\n\t\tconst response = await this.send(command as RpcCommandBody);\n\t\treturn this.getData<Record<string, unknown>>(response);\n\t}\n\n\tasync setSettings(settings: Record<string, unknown>, scope?: \"global\" | \"project\"): Promise<void> {\n\t\tconst command: Record<string, unknown> = { type: \"set_settings\", settings };\n\t\tif (scope) command.scope = scope;\n\t\tawait this.send(command as RpcCommandBody);\n\t}\n\n\tasync getContextUsage(): Promise<Record<string, unknown>> {\n\t\tconst response = await this.send({ type: \"get_context_usage\" });\n\t\treturn this.getData<Record<string, unknown>>(response);\n\t}\n\n\tasync getSystemPrompt(): Promise<{ systemPrompt: string; appendSystemPrompt?: string }> {\n\t\tconst response = await this.send({ type: \"get_system_prompt\" });\n\t\treturn this.getData<{ systemPrompt: string; appendSystemPrompt?: string }>(response);\n\t}\n\n\tasync getActiveTools(): Promise<string[]> {\n\t\tconst response = await this.send({ type: \"get_active_tools\" });\n\t\treturn this.getData<{ toolNames: string[] }>(response).toolNames;\n\t}\n\n\tasync setActiveTools(toolNames: string[]): Promise<void> {\n\t\tawait this.send({ type: \"set_active_tools\", toolNames });\n\t}\n\n\tasync getQueue(): Promise<{ steering: unknown[]; followUp: unknown[] }> {\n\t\tconst response = await this.send({ type: \"get_queue\" });\n\t\treturn this.getData<{ steering: unknown[]; followUp: unknown[] }>(response);\n\t}\n\n\tasync clearQueue(): Promise<{ steering: unknown[]; followUp: unknown[] }> {\n\t\tconst response = await this.send({ type: \"clear_queue\" });\n\t\treturn this.getData<{ steering: unknown[]; followUp: unknown[] }>(response);\n\t}\n\n\tasync getFlags(): Promise<Record<string, unknown>> {\n\t\tconst response = await this.send({ type: \"get_flags\" });\n\t\treturn this.getData<{ flags: Record<string, unknown> }>(response).flags;\n\t}\n\n\tasync getFlagValues(): Promise<Record<string, unknown>> {\n\t\tconst response = await this.send({ type: \"get_flag_values\" });\n\t\treturn this.getData<{ values: Record<string, unknown> }>(response).values;\n\t}\n\n\tasync setFlag(name: string, value: string | boolean): Promise<void> {\n\t\tawait this.send({ type: \"set_flag\", name, value });\n\t}\n\n\tasync reload(): Promise<void> {\n\t\tawait this.send({ type: \"reload\" });\n\t}\n\n\tasync getAgentsFiles(): Promise<string[]> {\n\t\tconst response = await this.send({ type: \"get_agents_files\" });\n\t\treturn this.getData<{ agentsFiles: string[] }>(response).agentsFiles;\n\t}\n\n\tasync setCwd(cwd: string): Promise<void> {\n\t\tawait this.send({ type: \"set_cwd\", cwd });\n\t}\n\n\tasync getFullMessages(options?: {\n\t\tlimit?: number;\n\t\tafterEntryId?: string;\n\t\tincludeUserMessages?: boolean;\n\t\tdirection?: \"asc\" | \"desc\";\n\t}): Promise<Record<string, unknown>> {\n\t\tconst command: Record<string, unknown> = { type: \"get_full_messages\" };\n\t\tif (options) Object.assign(command, options);\n\t\tconst response = await this.send(command as RpcCommandBody);\n\t\treturn this.getData<Record<string, unknown>>(response);\n\t}\n\n\tasync getTree(): Promise<{ entries: unknown[]; leafId: string }> {\n\t\tconst response = await this.send({ type: \"get_tree\" });\n\t\treturn this.getData<{ entries: unknown[]; leafId: string }>(response);\n\t}\n\n\tasync getModifiedFiles(options?: {\n\t\tfromEntryId?: string;\n\t\ttoEntryId?: string;\n\t}): Promise<Array<{ path: string; status: \"added\" | \"modified\" | \"deleted\"; turnIndex: number; entryId: string }>> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"get_modified_files\",\n\t\t\tfromEntryId: options?.fromEntryId,\n\t\t\ttoEntryId: options?.toEntryId,\n\t\t});\n\t\treturn this.getData<{\n\t\t\tfiles: Array<{\n\t\t\t\tpath: string;\n\t\t\t\tstatus: \"added\" | \"modified\" | \"deleted\";\n\t\t\t\tturnIndex: number;\n\t\t\t\tentryId: string;\n\t\t\t}>;\n\t\t}>(response).files;\n\t}\n\n\tasync getFileDiff(options: { filePath: string; fromEntryId?: string; toEntryId?: string }): Promise<{\n\t\tpath: string;\n\t\toldContent: string | null;\n\t\tnewContent: string | null;\n\t\tunifiedDiff: string;\n\t} | null> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"get_file_diff\",\n\t\t\tfilePath: options.filePath,\n\t\t\tfromEntryId: options.fromEntryId,\n\t\t\ttoEntryId: options.toEntryId,\n\t\t});\n\t\tconst data = this.getData<{\n\t\t\tpath: string;\n\t\t\toldContent: string | null;\n\t\t\tnewContent: string | null;\n\t\t\tunifiedDiff: string;\n\t\t} | null>(response);\n\t\treturn data;\n\t}\n\n\tasync getBatchDiffs(options?: { fromEntryId?: string; toEntryId?: string }): Promise<{\n\t\tfiles: Array<{\n\t\t\tpath: string;\n\t\t\tstatus: \"added\" | \"modified\" | \"deleted\";\n\t\t\tdiff: {\n\t\t\t\tpath: string;\n\t\t\t\toldContent: string | null;\n\t\t\t\tnewContent: string | null;\n\t\t\t\tunifiedDiff: string;\n\t\t\t} | null;\n\t\t}>;\n\t\tsummary: { totalFiles: number; added: number; modified: number; deleted: number };\n\t}> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"get_batch_diffs\",\n\t\t\tfromEntryId: options?.fromEntryId,\n\t\t\ttoEntryId: options?.toEntryId,\n\t\t});\n\t\treturn this.getData<{\n\t\t\tfiles: Array<{\n\t\t\t\tpath: string;\n\t\t\t\tstatus: \"added\" | \"modified\" | \"deleted\";\n\t\t\t\tdiff: {\n\t\t\t\t\tpath: string;\n\t\t\t\t\toldContent: string | null;\n\t\t\t\t\tnewContent: string | null;\n\t\t\t\t\tunifiedDiff: string;\n\t\t\t\t} | null;\n\t\t\t}>;\n\t\t\tsummary: { totalFiles: number; added: number; modified: number; deleted: number };\n\t\t}>(response);\n\t}\n\n\tasync getFileHistory(options: { filePath: string }): Promise<{\n\t\thistory: Array<{\n\t\t\tentryId: string;\n\t\t\tturnIndex: number;\n\t\t\ttimestamp: string;\n\t\t\tstatus: \"added\" | \"modified\" | \"deleted\";\n\t\t\tsnapshotHash: string;\n\t\t\tpreviousHash: string | null;\n\t\t}>;\n\t}> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"get_file_history\",\n\t\t\tfilePath: options.filePath,\n\t\t});\n\t\treturn this.getData<{\n\t\t\thistory: Array<{\n\t\t\t\tentryId: string;\n\t\t\t\tturnIndex: number;\n\t\t\t\ttimestamp: string;\n\t\t\t\tstatus: \"added\" | \"modified\" | \"deleted\";\n\t\t\t\tsnapshotHash: string;\n\t\t\t\tpreviousHash: string | null;\n\t\t\t}>;\n\t\t}>(response);\n\t}\n\n\tonRemoteToolCall(\n\t\thandler: (call: { toolCallId: string; toolName: string; args: Record<string, unknown> }) => void,\n\t): () => void {\n\t\tthis.remoteToolCallHandlers.push(handler);\n\t\treturn () => {\n\t\t\tconst index = this.remoteToolCallHandlers.indexOf(handler);\n\t\t\tif (index !== -1) this.remoteToolCallHandlers.splice(index, 1);\n\t\t};\n\t}\n\n\tsendRemoteToolResult(\n\t\ttoolCallId: string,\n\t\tresult: { content: Array<{ type: string; text: string }>; isError: boolean },\n\t): void {\n\t\tthis.writeLine({ type: \"remote_tool_result\", toolCallId, result });\n\t}\n\n\trespondUI(requestId: string, response: Record<string, unknown>): void {\n\t\tthis.writeLine({ type: \"extension_ui_response\", id: requestId, ...response });\n\t}\n\n\t// =========================================================================\n\t// Helpers\n\t// =========================================================================\n\n\tchannel(name: string): Pick<Channel, \"name\" | \"send\" | \"onReceive\" | \"invoke\" | \"call\"> {\n\t\tconst invokeImpl = (data: unknown, timeoutMs: number = 30_000): Promise<unknown> => {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tconst invokeId = `inv_${randomUUID().slice(0, 8)}`;\n\t\t\t\tconst timer = setTimeout(() => {\n\t\t\t\t\treject(new Error(`Channel invoke \"${name}\" timed out after ${timeoutMs}ms`));\n\t\t\t\t}, timeoutMs);\n\n\t\t\t\tconst handler = (responseData: unknown) => {\n\t\t\t\t\tconst d = responseData as Record<string, unknown>;\n\t\t\t\t\tif (d && d.invokeId === invokeId) {\n\t\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\t\tconst handlers = this.channelHandlers.get(name);\n\t\t\t\t\t\tif (handlers) handlers.delete(handler);\n\t\t\t\t\t\tresolve(responseData);\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tlet handlers = this.channelHandlers.get(name);\n\t\t\t\tif (!handlers) {\n\t\t\t\t\thandlers = new Set();\n\t\t\t\t\tthis.channelHandlers.set(name, handlers);\n\t\t\t\t}\n\t\t\t\thandlers.add(handler);\n\n\t\t\t\tthis.writeLine({\n\t\t\t\t\ttype: \"channel_data\",\n\t\t\t\t\tname,\n\t\t\t\t\tdata: { ...((data as Record<string, unknown>) ?? {}), invokeId },\n\t\t\t\t} as ChannelDataMessage);\n\t\t\t});\n\t\t};\n\n\t\treturn {\n\t\t\tname,\n\t\t\tsend: (data: unknown) => {\n\t\t\t\tthis.writeLine({ type: \"channel_data\", name, data } as ChannelDataMessage);\n\t\t\t},\n\t\t\tonReceive: (handler: (data: unknown) => void) => {\n\t\t\t\tlet handlers = this.channelHandlers.get(name);\n\t\t\t\tif (!handlers) {\n\t\t\t\t\thandlers = new Set();\n\t\t\t\t\tthis.channelHandlers.set(name, handlers);\n\t\t\t\t}\n\t\t\t\thandlers.add(handler);\n\t\t\t\treturn () => {\n\t\t\t\t\thandlers!.delete(handler);\n\t\t\t\t\tif (handlers!.size === 0) this.channelHandlers.delete(name);\n\t\t\t\t};\n\t\t\t},\n\t\t\tinvoke: invokeImpl,\n\t\t\tcall: (method: string, params: Record<string, unknown>, timeoutMs?: number) => {\n\t\t\t\tconst payload = { ...params, __call: method };\n\t\t\t\treturn invokeImpl(payload, timeoutMs ?? 30_000);\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * Wait for agent to become idle (no streaming).\n\t * Resolves when agent_end event is received.\n\t */\n\twaitForIdle(timeout = 60000): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tunsubscribe();\n\t\t\t\treject(new Error(`Timeout waiting for agent to become idle. Stderr: ${this.stderr}`));\n\t\t\t}, timeout);\n\n\t\t\tconst unsubscribe = this.onEvent((event) => {\n\t\t\t\tif (event.type === \"agent_end\") {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tunsubscribe();\n\t\t\t\t\tresolve();\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Collect events until agent becomes idle.\n\t */\n\tcollectEvents(timeout = 60000): Promise<AgentEvent[]> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst events: AgentEvent[] = [];\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tunsubscribe();\n\t\t\t\treject(new Error(`Timeout collecting events. Stderr: ${this.stderr}`));\n\t\t\t}, timeout);\n\n\t\t\tconst unsubscribe = this.onEvent((event) => {\n\t\t\t\tevents.push(event);\n\t\t\t\tif (event.type === \"agent_end\") {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tunsubscribe();\n\t\t\t\t\tresolve(events);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Send prompt and wait for completion, returning all events.\n\t */\n\tasync promptAndWait(message: string, images?: ImageContent[], timeout = 60000): Promise<AgentEvent[]> {\n\t\tconst eventsPromise = this.collectEvents(timeout);\n\t\tawait this.prompt(message, images);\n\t\treturn eventsPromise;\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 (this.readyResolve && data.type === \"ready\") {\n\t\t\t\tconst resolve = this.readyResolve;\n\t\t\t\tthis.readyResolve = null;\n\t\t\t\tresolve();\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// Check if it's channel data\n\t\t\tif (data.type === \"channel_data\" && data.name) {\n\t\t\t\tconst handlers = this.channelHandlers.get(data.name as string);\n\t\t\t\tif (handlers) {\n\t\t\t\t\tconst payload = data.data as Record<string, unknown> | undefined;\n\t\t\t\t\tconst invokeId = payload?.invokeId as string | undefined;\n\n\t\t\t\t\tfor (const handler of handlers) {\n\t\t\t\t\t\tconst result = handler(data.data);\n\t\t\t\t\t\tif (invokeId && result !== undefined) {\n\t\t\t\t\t\t\tthis.writeLine({\n\t\t\t\t\t\t\t\ttype: \"channel_data\",\n\t\t\t\t\t\t\t\tname: data.name,\n\t\t\t\t\t\t\t\tdata: { ...(typeof result === \"object\" ? result : { value: result }), invokeId },\n\t\t\t\t\t\t\t} as ChannelDataMessage);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Check if it's a remote tool call\n\t\t\tif (data.type === \"remote_tool_call\" && data.toolCallId && data.toolName) {\n\t\t\t\tfor (const handler of this.remoteToolCallHandlers) {\n\t\t\t\t\thandler({ toolCallId: data.toolCallId, toolName: data.toolName, args: data.args ?? {} });\n\t\t\t\t}\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 AgentEvent);\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 send(command: RpcCommandBody): Promise<RpcResponse> {\n\t\tif (!this.process?.stdin) {\n\t\t\tthrow new Error(\"Client not started\");\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\tthis.pendingRequests.set(id, { resolve, reject });\n\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\tthis.process!.stdin!.write(serializeJsonLine(fullCommand));\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\tprivate writeLine(obj: object): void {\n\t\tif (!this.process?.stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tthis.process.stdin.write(serializeJsonLine(obj));\n\t}\n}\n"]}