/** * Print mode (single-shot): Send prompts, output result, exit. * * Used for: * - `pi -p "prompt"` - text output * - `pi --mode json "prompt"` - JSON event stream */ import type { AssistantMessage, ImageContent } from "@earendil-works/pi-ai"; import type { AgentSessionRuntime } from "../core/agent-session-runtime.ts"; import { flushRawStdout, writeRawStdout } from "../core/output-guard.ts"; import { killTrackedDetachedChildren } from "../utils/shell.ts"; /** * Options for print mode. */ export interface PrintModeOptions { /** Output mode: "text" for final response only, "json" for all events */ mode: "text" | "json"; /** Array of additional prompts to send after initialMessage */ messages?: string[]; /** First message to send (may contain @file content) */ initialMessage?: string; /** Images to attach to the initial message */ initialImages?: ImageContent[]; } /** * Run in print (single-shot) mode. * Sends prompts to the agent and outputs the result. */ export async function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise { const { mode, messages = [], initialMessage, initialImages } = options; let exitCode = 0; let session = runtimeHost.session; let unsubscribe: (() => void) | undefined; let disposed = false; const signalCleanupHandlers: Array<() => void> = []; const disposeRuntime = async (): Promise => { if (disposed) return; disposed = true; unsubscribe?.(); await runtimeHost.dispose(); }; const registerSignalHandlers = (): void => { const signals: NodeJS.Signals[] = ["SIGTERM"]; if (process.platform !== "win32") { signals.push("SIGHUP"); } for (const signal of signals) { const handler = () => { killTrackedDetachedChildren(); void disposeRuntime().finally(() => { process.exit(signal === "SIGHUP" ? 129 : 143); }); }; process.on(signal, handler); signalCleanupHandlers.push(() => process.off(signal, handler)); } }; registerSignalHandlers(); runtimeHost.setRebindSession(async () => { await rebindSession(); }); const rebindSession = async (): Promise => { session = runtimeHost.session; await session.bindExtensions({ commandContextActions: { waitForIdle: () => session.agent.waitForIdle(), newSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions), fork: async (entryId, forkOptions) => { const result = await runtimeHost.fork(entryId, forkOptions); return { cancelled: result.cancelled }; }, navigateTree: async (targetId, navigateOptions) => { const result = await session.navigateTree(targetId, { summarize: navigateOptions?.summarize, customInstructions: navigateOptions?.customInstructions, replaceInstructions: navigateOptions?.replaceInstructions, label: navigateOptions?.label, }); return { cancelled: result.cancelled }; }, switchSession: async (sessionPath, switchOptions) => { return runtimeHost.switchSession(sessionPath, switchOptions); }, reload: async () => { await session.reload(); }, }, onError: (err) => { console.error(`Extension error (${err.extensionPath}): ${err.error}`); }, }); unsubscribe?.(); unsubscribe = session.subscribe((event) => { if (mode === "json") { writeRawStdout(`${JSON.stringify(event)}\n`); } }); }; try { if (mode === "json") { const header = session.sessionManager.getHeader(); if (header) { writeRawStdout(`${JSON.stringify(header)}\n`); } } await rebindSession(); 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 as AssistantMessage; 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`); } } } } } return exitCode; } catch (error: unknown) { console.error(error instanceof Error ? error.message : String(error)); return 1; } finally { for (const cleanup of signalCleanupHandlers) { cleanup(); } await disposeRuntime(); await flushRawStdout(); } }