@ponythewhite/base-context 1.0.0 → 1.0.2

package/dist/modes/interactive/onboarding.d.ts

@@ -1,19 +1,16 @@
 import type { Api, Model } from "@ponythewhite/base-context-ai";
-import type { AuthStatus } from "../../core/auth-storage.js";
 export interface OnboardingSettingsReader {
     getOnboardingShown(): boolean;
 }
 export interface OnboardingModelRegistryReader {
     refresh(): void;
     hasConfiguredAuth(model: Model<Api>): boolean;
-    getProviderAuthStatus(provider: string): AuthStatus;
 }
 export interface OnboardingStartupState {
     settingsManager: OnboardingSettingsReader;
     modelRegistry: OnboardingModelRegistryReader;
     model: Model<Api> | undefined;
 }
-export declare function shouldRunPrimeCliOnboardingSplash(state: OnboardingStartupState): boolean;
 export declare function isOnboardingModelReady(state: OnboardingStartupState): boolean;
 export declare function shouldRunOnboarding(state: OnboardingStartupState): boolean;
 //# sourceMappingURL=onboarding.d.ts.map

package/dist/modes/interactive/onboarding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,MAAM,WAAW,wBAAwB;IACxC,kBAAkB,IAAI,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,6BAA6B;IAC7C,OAAO,IAAI,IAAI,CAAC;IAChB,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IAC9C,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;CACpD;AAED,MAAM,WAAW,sBAAsB;IACtC,eAAe,EAAE,wBAAwB,CAAC;IAC1C,aAAa,EAAE,6BAA6B,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC9B;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CASxF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAE7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAS1E","sourcesContent":["import type { Api, Model } from \"@ponythewhite/base-context-ai\";\nimport type { AuthStatus } from \"../../core/auth-storage.js\";\nimport { PRIME_INFERENCE_PROVIDER_ID } from \"../../core/prime-inference-auth.js\";\n\nexport interface OnboardingSettingsReader {\n\tgetOnboardingShown(): boolean;\n}\n\nexport interface OnboardingModelRegistryReader {\n\trefresh(): void;\n\thasConfiguredAuth(model: Model<Api>): boolean;\n\tgetProviderAuthStatus(provider: string): AuthStatus;\n}\n\nexport interface OnboardingStartupState {\n\tsettingsManager: OnboardingSettingsReader;\n\tmodelRegistry: OnboardingModelRegistryReader;\n\tmodel: Model<Api> | undefined;\n}\n\nexport function shouldRunPrimeCliOnboardingSplash(state: OnboardingStartupState): boolean {\n\tif (state.settingsManager.getOnboardingShown()) {\n\t\treturn false;\n\t}\n\tif (!state.model || state.model.provider !== PRIME_INFERENCE_PROVIDER_ID) {\n\t\treturn false;\n\t}\n\tconst authStatus = state.modelRegistry.getProviderAuthStatus(PRIME_INFERENCE_PROVIDER_ID);\n\treturn authStatus.source === \"prime_cli\";\n}\n\nexport function isOnboardingModelReady(state: OnboardingStartupState): boolean {\n\treturn state.model !== undefined && state.modelRegistry.hasConfiguredAuth(state.model);\n}\n\nexport function shouldRunOnboarding(state: OnboardingStartupState): boolean {\n\tif (state.settingsManager.getOnboardingShown()) {\n\t\treturn false;\n\t}\n\tstate.modelRegistry.refresh();\n\tif (shouldRunPrimeCliOnboardingSplash(state)) {\n\t\treturn true;\n\t}\n\treturn !isOnboardingModelReady(state);\n}\n"]}
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC,kBAAkB,IAAI,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,6BAA6B;IAC7C,OAAO,IAAI,IAAI,CAAC;IAChB,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACtC,eAAe,EAAE,wBAAwB,CAAC;IAC1C,aAAa,EAAE,6BAA6B,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAE7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAG1E","sourcesContent":["import type { Api, Model } from \"@ponythewhite/base-context-ai\";\n\nexport interface OnboardingSettingsReader {\n\tgetOnboardingShown(): boolean;\n}\n\nexport interface OnboardingModelRegistryReader {\n\trefresh(): void;\n\thasConfiguredAuth(model: Model<Api>): boolean;\n}\n\nexport interface OnboardingStartupState {\n\tsettingsManager: OnboardingSettingsReader;\n\tmodelRegistry: OnboardingModelRegistryReader;\n\tmodel: Model<Api> | undefined;\n}\n\nexport function isOnboardingModelReady(state: OnboardingStartupState): boolean {\n\treturn state.model !== undefined && state.modelRegistry.hasConfiguredAuth(state.model);\n}\n\nexport function shouldRunOnboarding(state: OnboardingStartupState): boolean {\n\tstate.modelRegistry.refresh();\n\treturn !isOnboardingModelReady(state);\n}\n"]}

package/dist/modes/interactive/onboarding.js

@@ -1,25 +1,8 @@
-import { PRIME_INFERENCE_PROVIDER_ID } from "../../core/prime-inference-auth.js";
-export function shouldRunPrimeCliOnboardingSplash(state) {
-    if (state.settingsManager.getOnboardingShown()) {
-        return false;
-    }
-    if (!state.model || state.model.provider !== PRIME_INFERENCE_PROVIDER_ID) {
-        return false;
-    }
-    const authStatus = state.modelRegistry.getProviderAuthStatus(PRIME_INFERENCE_PROVIDER_ID);
-    return authStatus.source === "prime_cli";
-}
 export function isOnboardingModelReady(state) {
     return state.model !== undefined && state.modelRegistry.hasConfiguredAuth(state.model);
 }
 export function shouldRunOnboarding(state) {
-    if (state.settingsManager.getOnboardingShown()) {
-        return false;
-    }
     state.modelRegistry.refresh();
-    if (shouldRunPrimeCliOnboardingSplash(state)) {
-        return true;
-    }
     return !isOnboardingModelReady(state);
 }
 //# sourceMappingURL=onboarding.js.map

package/dist/modes/interactive/onboarding.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../../src/modes/interactive/onboarding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAkBjF,MAAM,UAAU,iCAAiC,CAAC,KAA6B,EAAW;IACzF,IAAI,KAAK,CAAC,eAAe,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,KAAK,2BAA2B,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,2BAA2B,CAAC,CAAC;IAC1F,OAAO,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC;AAAA,CACzC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA6B,EAAW;IAC9E,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAAA,CACvF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA6B,EAAW;IAC3E,IAAI,KAAK,CAAC,eAAe,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,iCAAiC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;AAAA,CACtC","sourcesContent":["import type { Api, Model } from \"@ponythewhite/base-context-ai\";\nimport type { AuthStatus } from \"../../core/auth-storage.js\";\nimport { PRIME_INFERENCE_PROVIDER_ID } from \"../../core/prime-inference-auth.js\";\n\nexport interface OnboardingSettingsReader {\n\tgetOnboardingShown(): boolean;\n}\n\nexport interface OnboardingModelRegistryReader {\n\trefresh(): void;\n\thasConfiguredAuth(model: Model<Api>): boolean;\n\tgetProviderAuthStatus(provider: string): AuthStatus;\n}\n\nexport interface OnboardingStartupState {\n\tsettingsManager: OnboardingSettingsReader;\n\tmodelRegistry: OnboardingModelRegistryReader;\n\tmodel: Model<Api> | undefined;\n}\n\nexport function shouldRunPrimeCliOnboardingSplash(state: OnboardingStartupState): boolean {\n\tif (state.settingsManager.getOnboardingShown()) {\n\t\treturn false;\n\t}\n\tif (!state.model || state.model.provider !== PRIME_INFERENCE_PROVIDER_ID) {\n\t\treturn false;\n\t}\n\tconst authStatus = state.modelRegistry.getProviderAuthStatus(PRIME_INFERENCE_PROVIDER_ID);\n\treturn authStatus.source === \"prime_cli\";\n}\n\nexport function isOnboardingModelReady(state: OnboardingStartupState): boolean {\n\treturn state.model !== undefined && state.modelRegistry.hasConfiguredAuth(state.model);\n}\n\nexport function shouldRunOnboarding(state: OnboardingStartupState): boolean {\n\tif (state.settingsManager.getOnboardingShown()) {\n\t\treturn false;\n\t}\n\tstate.modelRegistry.refresh();\n\tif (shouldRunPrimeCliOnboardingSplash(state)) {\n\t\treturn true;\n\t}\n\treturn !isOnboardingModelReady(state);\n}\n"]}
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../../src/modes/interactive/onboarding.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,sBAAsB,CAAC,KAA6B,EAAW;IAC9E,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAAA,CACvF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA6B,EAAW;IAC3E,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;IAC9B,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;AAAA,CACtC","sourcesContent":["import type { Api, Model } from \"@ponythewhite/base-context-ai\";\n\nexport interface OnboardingSettingsReader {\n\tgetOnboardingShown(): boolean;\n}\n\nexport interface OnboardingModelRegistryReader {\n\trefresh(): void;\n\thasConfiguredAuth(model: Model<Api>): boolean;\n}\n\nexport interface OnboardingStartupState {\n\tsettingsManager: OnboardingSettingsReader;\n\tmodelRegistry: OnboardingModelRegistryReader;\n\tmodel: Model<Api> | undefined;\n}\n\nexport function isOnboardingModelReady(state: OnboardingStartupState): boolean {\n\treturn state.model !== undefined && state.modelRegistry.hasConfiguredAuth(state.model);\n}\n\nexport function shouldRunOnboarding(state: OnboardingStartupState): boolean {\n\tstate.modelRegistry.refresh();\n\treturn !isOnboardingModelReady(state);\n}\n"]}

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

@@ -66,7 +66,7 @@ export declare class RpcClient {
     getStderr(): string;
     /**
      * Send a prompt to the agent.
-     * Returns immediately after sending; use onEvent() to receive streaming events.
+     * Resolves after admission succeeds; use onEvent() to receive streaming events.
      * Use waitForIdle() to wait for completion.
      */
     prompt(message: string, images?: ImageContent[]): Promise<void>;
@@ -245,10 +245,13 @@ export declare class RpcClient {
      * Collect events until agent becomes idle.
      */
     collectEvents(timeout?: number): Promise<AgentEvent[]>;
+    private createEventCollection;
     /**
      * Send prompt and wait for completion, returning all events.
      */
     promptAndWait(message: string, images?: ImageContent[], timeout?: number): Promise<AgentEvent[]>;
+    private processExitError;
+    private rejectPendingRequests;
     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 {\n\ttype AgentEvent,\n\ttype AgentMessage,\n\tAgentOutputLimitError,\n\ttype ThinkingLevel,\n} from \"@ponythewhite/base-context-agent\";\nimport type { ImageContent } from \"@ponythewhite/base-context-ai\";\nimport type { AgentSessionMessageReceipt, AgentSessionMessageSafetyStatus } from \"../../core/agent-messages.js\";\nimport type { BashResult } from \"../../core/bash-executor.js\";\nimport type { CompactionResult } from \"../../core/compaction/index.js\";\nimport type {\n\tAgentCronJob,\n\tAgentHeartbeatDeliveryMode,\n\tAgentHeartbeatManagementAction,\n\tAgentHeartbeatUpdateAction,\n} from \"../../core/cron-jobs.js\";\nimport type { RefinementResult } from \"../../core/refinement/index.js\";\nimport type { SessionStats } from \"../../core/session-stats.js\";\nimport type { AgentConnectionHeartbeat } from \"../agent-connection/types.js\";\nimport { CANONICAL_SESSION_OWNERSHIP_COMPATIBILITY, DAEMON_PROTOCOL_VERSION } from \"../daemon/daemon-protocol.js\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.js\";\nimport type {\n\tRpcCommand,\n\tRpcObservedSessionEvent,\n\tRpcPromptCompletionError,\n\tRpcResponse,\n\tRpcSessionState,\n\tRpcSlashCommand,\n} from \"./rpc-types.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nfunction promptCompletionError(event: AgentEvent): string | undefined {\n\tconst output = event as AgentEvent | RpcPromptCompletionError;\n\tif (\n\t\toutput.type === \"extension_error\" &&\n\t\toutput.extensionPath === \"<session-input>\" &&\n\t\toutput.event === \"prompt_completion\"\n\t)\n\t\treturn output.error;\n\treturn undefined;\n}\n\n/** Extended response timeout for refine requests, which run an LLM pass. */\nexport const REFINE_REQUEST_TIMEOUT_MS = 10 * 60 * 1000;\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}\n\nexport interface ModelInfo {\n\tprovider: string;\n\tid: string;\n\tcontextWindow: number;\n\treasoning: boolean;\n}\n\nexport type RpcEventListener = (event: AgentEvent) => void;\nexport type RpcObservedSessionListener = (event: RpcObservedSessionEvent) => 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 observedSessionListeners: RpcObservedSessionListener[] = [];\n\tprivate pendingRequests: Map<string, { resolve: (response: RpcResponse) => void; reject: (error: Error) => void }> =\n\t\tnew Map();\n\tprivate requestId = 0;\n\tprivate stderr = \"\";\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\", \"--rpc-protocol-version\", String(DAEMON_PROTOCOL_VERSION)];\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\tthis.process = spawn(\"node\", [cliPath, ...args], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: { ...process.env, ...this.options.env },\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\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 a moment for process to initialize\n\t\tawait new Promise((resolve) => setTimeout(resolve, 100));\n\n\t\tif (this.process.exitCode !== null) {\n\t\t\tthrow new Error(`Agent process exited immediately with code ${this.process.exitCode}. Stderr: ${this.stderr}`);\n\t\t}\n\t\ttry {\n\t\t\tconst state = await this.getState();\n\t\t\tif (state.protocolVersion !== DAEMON_PROTOCOL_VERSION)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Incompatible RPC protocol: expected ${DAEMON_PROTOCOL_VERSION}, got ${state.protocolVersion ?? \"unversioned\"}`,\n\t\t\t\t);\n\t\t\tconst minimumSchema = CANONICAL_SESSION_OWNERSHIP_COMPATIBILITY.minSchemaRevision;\n\t\t\tif (!Number.isSafeInteger(state.schemaRevision) || (state.schemaRevision ?? 0) < minimumSchema)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Incompatible RPC schema: expected at least ${minimumSchema}, got ${state.schemaRevision ?? \"unversioned\"}`,\n\t\t\t\t);\n\t\t} catch (error) {\n\t\t\ttry {\n\t\t\t\tawait this.stop();\n\t\t\t} catch (cleanupError) {\n\t\t\t\tthrow new AggregateError([error, cleanupError], \"RPC startup and cleanup failed\", { cause: error });\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\t/**\n\t * Stop the RPC agent process.\n\t */\n\tasync stop(): Promise<void> {\n\t\tif (!this.process) return;\n\n\t\tthis.stopReadingStdout?.();\n\t\tthis.stopReadingStdout = null;\n\t\tthis.process.kill(\"SIGTERM\");\n\n\t\t// Wait for process to exit\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tthis.process?.kill(\"SIGKILL\");\n\t\t\t\tresolve();\n\t\t\t}, 1000);\n\n\t\t\tthis.process?.on(\"exit\", () => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tresolve();\n\t\t\t});\n\t\t});\n\n\t\tthis.process = null;\n\t\tthis.pendingRequests.clear();\n\t}\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\tonObservedSessionEvent(listener: RpcObservedSessionListener): () => void {\n\t\tthis.observedSessionListeners.push(listener);\n\t\treturn () => {\n\t\t\tconst index = this.observedSessionListeners.indexOf(listener);\n\t\t\tif (index !== -1) {\n\t\t\t\tthis.observedSessionListeners.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 * Refine editable continual harness state.\n\t */\n\tasync refine(\n\t\toptions: { instructions?: string; rollbackId?: string; global?: boolean } = {},\n\t): Promise<RefinementResult> {\n\t\t// Refinement runs an LLM pass that routinely exceeds the default 30s response\n\t\t// timeout, so use the same extended window as the daemon refine path.\n\t\tconst command = { type: \"refine\", instructions: options.instructions, rollbackId: options.rollbackId } as {\n\t\t\ttype: \"refine\";\n\t\t\tinstructions?: string;\n\t\t\trollbackId?: string;\n\t\t\tglobal?: boolean;\n\t\t};\n\t\tif (options.global !== undefined) {\n\t\t\tcommand.global = options.global;\n\t\t}\n\t\tconst response = await this.send(command, REFINE_REQUEST_TIMEOUT_MS);\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\tasync sendAgentMessage(targetActiveSessionId: string, message: string): Promise<AgentSessionMessageReceipt> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"send_message\",\n\t\t\ttargetActiveSessionId,\n\t\t\tmessage,\n\t\t});\n\t\treturn this.getData(response);\n\t}\n\n\tasync getAgentMessageStatus(): Promise<AgentSessionMessageSafetyStatus> {\n\t\treturn this.getData(await this.send({ type: \"agent_messages_status\" }));\n\t}\n\n\tasync pauseAgentMessages(): Promise<AgentSessionMessageSafetyStatus> {\n\t\treturn this.getData(await this.send({ type: \"agent_messages_pause\" }));\n\t}\n\n\tasync resumeAgentMessages(): Promise<AgentSessionMessageSafetyStatus> {\n\t\treturn this.getData(await this.send({ type: \"agent_messages_resume\" }));\n\t}\n\n\tasync clearAgentMessages(): Promise<number> {\n\t\tconst response = await this.send({ type: \"agent_messages_clear\" });\n\t\treturn this.getData<{ cleared: number }>(response).cleared;\n\t}\n\n\tasync listSchedules(includeInactive?: boolean): Promise<AgentCronJob[]> {\n\t\tconst response = await this.send({ type: \"list_schedules\", includeInactive });\n\t\treturn this.getData<{ jobs: AgentCronJob[] }>(response).jobs;\n\t}\n\n\tasync addSchedule(schedule: string, prompt: string): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"add_schedule\", schedule, prompt });\n\t\treturn this.getData<{ job: AgentCronJob }>(response).job;\n\t}\n\n\tasync cancelSchedule(jobId: string): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"cancel_schedule\", jobId });\n\t\treturn this.getData<{ job: AgentCronJob }>(response).job;\n\t}\n\n\tasync listHeartbeats(): Promise<AgentConnectionHeartbeat[]> {\n\t\tconst response = await this.send({ type: \"list_heartbeats\" });\n\t\treturn this.getData<{ heartbeats: AgentConnectionHeartbeat[] }>(response).heartbeats;\n\t}\n\n\tasync getHeartbeat(): Promise<AgentCronJob | null> {\n\t\tconst response = await this.send({ type: \"get_heartbeat\" });\n\t\treturn this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t}\n\n\tasync setHeartbeat(\n\t\tschedule: string,\n\t\tprompt: string,\n\t\tdeliveryMode?: AgentHeartbeatDeliveryMode,\n\t): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"set_heartbeat\", schedule, prompt, deliveryMode });\n\t\tconst heartbeat = this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t\tif (!heartbeat) {\n\t\t\tthrow new Error(\"Daemon did not return the created heartbeat\");\n\t\t}\n\t\treturn heartbeat;\n\t}\n\n\tasync updateHeartbeat(action: AgentHeartbeatUpdateAction): Promise<AgentCronJob | null> {\n\t\tconst response = await this.send({ type: \"update_heartbeat\", action });\n\t\treturn this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t}\n\n\tasync manageHeartbeat(\n\t\tactiveSessionId: string,\n\t\tjobId: string,\n\t\taction: AgentHeartbeatManagementAction,\n\t): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"manage_heartbeat\", activeSessionId, jobId, action });\n\t\tconst heartbeat = this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t\tif (!heartbeat) {\n\t\t\tthrow new Error(\"Daemon did not return the managed heartbeat\");\n\t\t}\n\t\treturn heartbeat;\n\t}\n\n\tasync observe(activeSessionId: string): Promise<AgentMessage[]> {\n\t\tconst response = await this.send({ type: \"observe\", activeSessionId });\n\t\treturn this.getData<{ messages: AgentMessage[] }>(response).messages;\n\t}\n\n\tasync unobserve(activeSessionId: string): Promise<void> {\n\t\tawait this.send({ type: \"unobserve\", activeSessionId });\n\t}\n\n\t/**\n\t * Get available commands (extension commands, prompt templates, skills).\n\t */\n\tasync getCommands(): Promise<RpcSlashCommand[]> {\n\t\tconst response = await this.send({ type: \"get_commands\" });\n\t\treturn this.getData<{ commands: RpcSlashCommand[] }>(response).commands;\n\t}\n\n\t// =========================================================================\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\tconst error = promptCompletionError(event);\n\t\t\t\tif (error !== undefined) {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tunsubscribe();\n\t\t\t\t\treject(new Error(error));\n\t\t\t\t} else if (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\tconst error = promptCompletionError(event);\n\t\t\t\tif (error !== undefined) {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tunsubscribe();\n\t\t\t\t\treject(new Error(error));\n\t\t\t\t\treturn;\n\t\t\t\t}\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\tconst events = await eventsPromise;\n\t\tconst terminal = events.find((event) => event.type === \"agent_end\");\n\t\tif (terminal?.type === \"agent_end\" && terminal.refusal) throw new AgentOutputLimitError(terminal.refusal);\n\t\treturn events;\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\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\t\t\tif (data.type === \"observed_session_event\" || data.type === \"observed_session_closed\") {\n\t\t\t\tfor (const listener of [...this.observedSessionListeners]) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tlistener(data as RpcObservedSessionEvent);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Listener failures must not block other RPC subscribers.\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// Otherwise it's an event\n\t\t\tfor (const listener of [...this.eventListeners]) {\n\t\t\t\ttry {\n\t\t\t\t\tlistener(data as AgentEvent);\n\t\t\t\t} catch {\n\t\t\t\t\t// Listener failures must not block other RPC subscribers.\n\t\t\t\t}\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, timeoutMs = 30000): 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}, timeoutMs);\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"]}
+{"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 {\n\ttype AgentEvent,\n\ttype AgentMessage,\n\tAgentOutputLimitError,\n\ttype ThinkingLevel,\n} from \"@ponythewhite/base-context-agent\";\nimport type { ImageContent } from \"@ponythewhite/base-context-ai\";\nimport type { AgentSessionMessageReceipt, AgentSessionMessageSafetyStatus } from \"../../core/agent-messages.js\";\nimport type { BashResult } from \"../../core/bash-executor.js\";\nimport type { CompactionResult } from \"../../core/compaction/index.js\";\nimport type {\n\tAgentCronJob,\n\tAgentHeartbeatDeliveryMode,\n\tAgentHeartbeatManagementAction,\n\tAgentHeartbeatUpdateAction,\n} from \"../../core/cron-jobs.js\";\nimport type { RefinementResult } from \"../../core/refinement/index.js\";\nimport type { SessionStats } from \"../../core/session-stats.js\";\nimport type { AgentConnectionHeartbeat } from \"../agent-connection/types.js\";\nimport { CANONICAL_SESSION_OWNERSHIP_COMPATIBILITY, DAEMON_PROTOCOL_VERSION } from \"../daemon/daemon-protocol.js\";\nimport { attachJsonlLineReader, serializeJsonLine } from \"./jsonl.js\";\nimport type {\n\tRpcCommand,\n\tRpcObservedSessionEvent,\n\tRpcPromptCompletionError,\n\tRpcResponse,\n\tRpcSessionState,\n\tRpcSlashCommand,\n} from \"./rpc-types.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nfunction promptCompletionError(event: AgentEvent): string | undefined {\n\tconst output = event as AgentEvent | RpcPromptCompletionError;\n\tif (\n\t\toutput.type === \"extension_error\" &&\n\t\toutput.extensionPath === \"<session-input>\" &&\n\t\toutput.event === \"prompt_completion\"\n\t)\n\t\treturn output.error;\n\treturn undefined;\n}\n\n/** Extended response timeout for refine requests, which run an LLM pass. */\nexport const REFINE_REQUEST_TIMEOUT_MS = 10 * 60 * 1000;\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}\n\nexport interface ModelInfo {\n\tprovider: string;\n\tid: string;\n\tcontextWindow: number;\n\treasoning: boolean;\n}\n\nexport type RpcEventListener = (event: AgentEvent) => void;\nexport type RpcObservedSessionListener = (event: RpcObservedSessionEvent) => 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 observedSessionListeners: RpcObservedSessionListener[] = [];\n\tprivate pendingRequests: Map<string, { resolve: (response: RpcResponse) => void; reject: (error: Error) => void }> =\n\t\tnew Map();\n\tprivate requestId = 0;\n\tprivate stderr = \"\";\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\", \"--rpc-protocol-version\", String(DAEMON_PROTOCOL_VERSION)];\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 child = spawn(\"node\", [cliPath, ...args], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: { ...process.env, ...this.options.env },\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\t\tthis.process = child;\n\t\tthis.stderr = \"\";\n\n\t\t// Collect stderr for debugging\n\t\tchild.stderr?.on(\"data\", (data) => {\n\t\t\tif (this.process !== child) return;\n\t\t\tthis.stderr += data.toString();\n\t\t\tprocess.stderr.write(data);\n\t\t});\n\t\tchild.once(\"error\", (error) => {\n\t\t\tif (this.process === child) this.rejectPendingRequests(error);\n\t\t});\n\t\t// Drain final stdout/stderr before rejecting requests that received no response.\n\t\tchild.once(\"close\", () => {\n\t\t\tif (this.process === child) this.rejectPendingRequests(this.processExitError(child));\n\t\t});\n\n\t\t// Set up strict JSONL reader for stdout.\n\t\tthis.stopReadingStdout = attachJsonlLineReader(child.stdout!, (line) => {\n\t\t\tif (this.process === child) this.handleLine(line);\n\t\t});\n\n\t\ttry {\n\t\t\tconst state = await this.getState();\n\t\t\tif (state.protocolVersion !== DAEMON_PROTOCOL_VERSION)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Incompatible RPC protocol: expected ${DAEMON_PROTOCOL_VERSION}, got ${state.protocolVersion ?? \"unversioned\"}`,\n\t\t\t\t);\n\t\t\tconst minimumSchema = CANONICAL_SESSION_OWNERSHIP_COMPATIBILITY.minSchemaRevision;\n\t\t\tif (!Number.isSafeInteger(state.schemaRevision) || (state.schemaRevision ?? 0) < minimumSchema)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Incompatible RPC schema: expected at least ${minimumSchema}, got ${state.schemaRevision ?? \"unversioned\"}`,\n\t\t\t\t);\n\t\t} catch (error) {\n\t\t\tif (this.process === child) {\n\t\t\t\ttry {\n\t\t\t\t\tawait this.stop();\n\t\t\t\t} catch (cleanupError) {\n\t\t\t\t\tthrow new AggregateError([error, cleanupError], \"RPC startup and cleanup failed\", { cause: error });\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\t/**\n\t * Stop the RPC agent process.\n\t */\n\tasync stop(): Promise<void> {\n\t\tconst child = this.process;\n\t\tif (!child) return;\n\n\t\tthis.stopReadingStdout?.();\n\t\tthis.stopReadingStdout = null;\n\n\t\tif (child.exitCode === null && child.signalCode === null) {\n\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\t\tchild.kill(\"SIGKILL\");\n\t\t\t\t\tresolve();\n\t\t\t\t}, 1000);\n\n\t\t\t\tchild.once(\"exit\", () => {\n\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\tresolve();\n\t\t\t\t});\n\t\t\t\tchild.kill(\"SIGTERM\");\n\t\t\t});\n\t\t}\n\n\t\tif (this.process === child) {\n\t\t\tthis.process = null;\n\t\t\tthis.rejectPendingRequests(new Error(\"RPC client stopped\"));\n\t\t}\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\tonObservedSessionEvent(listener: RpcObservedSessionListener): () => void {\n\t\tthis.observedSessionListeners.push(listener);\n\t\treturn () => {\n\t\t\tconst index = this.observedSessionListeners.indexOf(listener);\n\t\t\tif (index !== -1) {\n\t\t\t\tthis.observedSessionListeners.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 * Resolves after admission succeeds; 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\tthis.getData(await 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 * Refine editable continual harness state.\n\t */\n\tasync refine(\n\t\toptions: { instructions?: string; rollbackId?: string; global?: boolean } = {},\n\t): Promise<RefinementResult> {\n\t\t// Refinement runs an LLM pass that routinely exceeds the default 30s response\n\t\t// timeout, so use the same extended window as the daemon refine path.\n\t\tconst command = { type: \"refine\", instructions: options.instructions, rollbackId: options.rollbackId } as {\n\t\t\ttype: \"refine\";\n\t\t\tinstructions?: string;\n\t\t\trollbackId?: string;\n\t\t\tglobal?: boolean;\n\t\t};\n\t\tif (options.global !== undefined) {\n\t\t\tcommand.global = options.global;\n\t\t}\n\t\tconst response = await this.send(command, REFINE_REQUEST_TIMEOUT_MS);\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\tasync sendAgentMessage(targetActiveSessionId: string, message: string): Promise<AgentSessionMessageReceipt> {\n\t\tconst response = await this.send({\n\t\t\ttype: \"send_message\",\n\t\t\ttargetActiveSessionId,\n\t\t\tmessage,\n\t\t});\n\t\treturn this.getData(response);\n\t}\n\n\tasync getAgentMessageStatus(): Promise<AgentSessionMessageSafetyStatus> {\n\t\treturn this.getData(await this.send({ type: \"agent_messages_status\" }));\n\t}\n\n\tasync pauseAgentMessages(): Promise<AgentSessionMessageSafetyStatus> {\n\t\treturn this.getData(await this.send({ type: \"agent_messages_pause\" }));\n\t}\n\n\tasync resumeAgentMessages(): Promise<AgentSessionMessageSafetyStatus> {\n\t\treturn this.getData(await this.send({ type: \"agent_messages_resume\" }));\n\t}\n\n\tasync clearAgentMessages(): Promise<number> {\n\t\tconst response = await this.send({ type: \"agent_messages_clear\" });\n\t\treturn this.getData<{ cleared: number }>(response).cleared;\n\t}\n\n\tasync listSchedules(includeInactive?: boolean): Promise<AgentCronJob[]> {\n\t\tconst response = await this.send({ type: \"list_schedules\", includeInactive });\n\t\treturn this.getData<{ jobs: AgentCronJob[] }>(response).jobs;\n\t}\n\n\tasync addSchedule(schedule: string, prompt: string): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"add_schedule\", schedule, prompt });\n\t\treturn this.getData<{ job: AgentCronJob }>(response).job;\n\t}\n\n\tasync cancelSchedule(jobId: string): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"cancel_schedule\", jobId });\n\t\treturn this.getData<{ job: AgentCronJob }>(response).job;\n\t}\n\n\tasync listHeartbeats(): Promise<AgentConnectionHeartbeat[]> {\n\t\tconst response = await this.send({ type: \"list_heartbeats\" });\n\t\treturn this.getData<{ heartbeats: AgentConnectionHeartbeat[] }>(response).heartbeats;\n\t}\n\n\tasync getHeartbeat(): Promise<AgentCronJob | null> {\n\t\tconst response = await this.send({ type: \"get_heartbeat\" });\n\t\treturn this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t}\n\n\tasync setHeartbeat(\n\t\tschedule: string,\n\t\tprompt: string,\n\t\tdeliveryMode?: AgentHeartbeatDeliveryMode,\n\t): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"set_heartbeat\", schedule, prompt, deliveryMode });\n\t\tconst heartbeat = this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t\tif (!heartbeat) {\n\t\t\tthrow new Error(\"Daemon did not return the created heartbeat\");\n\t\t}\n\t\treturn heartbeat;\n\t}\n\n\tasync updateHeartbeat(action: AgentHeartbeatUpdateAction): Promise<AgentCronJob | null> {\n\t\tconst response = await this.send({ type: \"update_heartbeat\", action });\n\t\treturn this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t}\n\n\tasync manageHeartbeat(\n\t\tactiveSessionId: string,\n\t\tjobId: string,\n\t\taction: AgentHeartbeatManagementAction,\n\t): Promise<AgentCronJob> {\n\t\tconst response = await this.send({ type: \"manage_heartbeat\", activeSessionId, jobId, action });\n\t\tconst heartbeat = this.getData<{ heartbeat: AgentCronJob | null }>(response).heartbeat;\n\t\tif (!heartbeat) {\n\t\t\tthrow new Error(\"Daemon did not return the managed heartbeat\");\n\t\t}\n\t\treturn heartbeat;\n\t}\n\n\tasync observe(activeSessionId: string): Promise<AgentMessage[]> {\n\t\tconst response = await this.send({ type: \"observe\", activeSessionId });\n\t\treturn this.getData<{ messages: AgentMessage[] }>(response).messages;\n\t}\n\n\tasync unobserve(activeSessionId: string): Promise<void> {\n\t\tawait this.send({ type: \"unobserve\", activeSessionId });\n\t}\n\n\t/**\n\t * Get available commands (extension commands, prompt templates, skills).\n\t */\n\tasync getCommands(): Promise<RpcSlashCommand[]> {\n\t\tconst response = await this.send({ type: \"get_commands\" });\n\t\treturn this.getData<{ commands: RpcSlashCommand[] }>(response).commands;\n\t}\n\n\t// =========================================================================\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\tconst error = promptCompletionError(event);\n\t\t\t\tif (error !== undefined) {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tunsubscribe();\n\t\t\t\t\treject(new Error(error));\n\t\t\t\t} else if (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 this.createEventCollection(timeout).result;\n\t}\n\n\tprivate createEventCollection(timeout: number): { result: Promise<AgentEvent[]>; cancel: () => void } {\n\t\tlet cancel = () => {};\n\t\tconst result = new Promise<AgentEvent[]>((resolve, reject) => {\n\t\t\tconst events: AgentEvent[] = [];\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tcancel();\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\tconst error = promptCompletionError(event);\n\t\t\t\tif (error !== undefined) {\n\t\t\t\t\tcancel();\n\t\t\t\t\treject(new Error(error));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (event.type === \"agent_end\") {\n\t\t\t\t\tcancel();\n\t\t\t\t\tresolve(events);\n\t\t\t\t}\n\t\t\t});\n\t\t\tcancel = () => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tunsubscribe();\n\t\t\t\tcancel = () => {};\n\t\t\t};\n\t\t});\n\t\treturn { result, cancel: () => cancel() };\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 collection = this.createEventCollection(timeout);\n\t\tlet events: AgentEvent[];\n\t\ttry {\n\t\t\t[, events] = await Promise.all([this.prompt(message, images), collection.result]);\n\t\t} finally {\n\t\t\tcollection.cancel();\n\t\t}\n\t\tconst terminal = events.find((event) => event.type === \"agent_end\");\n\t\tif (terminal?.type === \"agent_end\" && terminal.refusal) throw new AgentOutputLimitError(terminal.refusal);\n\t\treturn events;\n\t}\n\n\t// =========================================================================\n\t// Internal\n\t// =========================================================================\n\n\tprivate processExitError(child: ChildProcess): Error {\n\t\tconst reason = child.signalCode ? `signal ${child.signalCode}` : `code ${child.exitCode}`;\n\t\treturn new Error(`Agent process exited with ${reason}. Stderr: ${this.stderr}`);\n\t}\n\n\tprivate rejectPendingRequests(error: Error): void {\n\t\tfor (const pending of this.pendingRequests.values()) pending.reject(error);\n\t\tthis.pendingRequests.clear();\n\t}\n\n\tprivate handleLine(line: string): void {\n\t\ttry {\n\t\t\tconst data = JSON.parse(line);\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\t\t\tif (data.type === \"observed_session_event\" || data.type === \"observed_session_closed\") {\n\t\t\t\tfor (const listener of [...this.observedSessionListeners]) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tlistener(data as RpcObservedSessionEvent);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Listener failures must not block other RPC subscribers.\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// Otherwise it's an event\n\t\t\tfor (const listener of [...this.eventListeners]) {\n\t\t\t\ttry {\n\t\t\t\t\tlistener(data as AgentEvent);\n\t\t\t\t} catch {\n\t\t\t\t\t// Listener failures must not block other RPC subscribers.\n\t\t\t\t}\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, timeoutMs = 30000): Promise<RpcResponse> {\n\t\tconst child = this.process;\n\t\tif (!child?.stdin) {\n\t\t\tthrow new Error(\"Client not started\");\n\t\t}\n\t\tif (child.exitCode !== null || child.signalCode !== null) {\n\t\t\tthrow this.processExitError(child);\n\t\t}\n\n\t\tconst id = `req_${++this.requestId}`;\n\t\tconst fullCommand = { ...command, id } as RpcCommand;\n\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tthis.pendingRequests.delete(id);\n\t\t\t\treject(new Error(`Timeout waiting for response to ${command.type}. Stderr: ${this.stderr}`));\n\t\t\t}, timeoutMs);\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\tchild.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"]}

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

@@ -53,25 +53,34 @@ export class RpcClient {
         if (this.options.args) {
             args.push(...this.options.args);
         }
-        this.process = spawn("node", [cliPath, ...args], {
+        const child = spawn("node", [cliPath, ...args], {
             cwd: this.options.cwd,
             env: { ...process.env, ...this.options.env },
             stdio: ["pipe", "pipe", "pipe"],
         });
+        this.process = child;
+        this.stderr = "";
         // Collect stderr for debugging
-        this.process.stderr?.on("data", (data) => {
+        child.stderr?.on("data", (data) => {
+            if (this.process !== child)
+                return;
             this.stderr += data.toString();
             process.stderr.write(data);
         });
+        child.once("error", (error) => {
+            if (this.process === child)
+                this.rejectPendingRequests(error);
+        });
+        // Drain final stdout/stderr before rejecting requests that received no response.
+        child.once("close", () => {
+            if (this.process === child)
+                this.rejectPendingRequests(this.processExitError(child));
+        });
         // Set up strict JSONL reader for stdout.
-        this.stopReadingStdout = attachJsonlLineReader(this.process.stdout, (line) => {
-            this.handleLine(line);
+        this.stopReadingStdout = attachJsonlLineReader(child.stdout, (line) => {
+            if (this.process === child)
+                this.handleLine(line);
         });
-        // Wait a moment for process to initialize
-        await new Promise((resolve) => setTimeout(resolve, 100));
-        if (this.process.exitCode !== null) {
-            throw new Error(`Agent process exited immediately with code ${this.process.exitCode}. Stderr: ${this.stderr}`);
-        }
         try {
             const state = await this.getState();
             if (state.protocolVersion !== DAEMON_PROTOCOL_VERSION)
@@ -81,11 +90,13 @@ export class RpcClient {
                 throw new Error(`Incompatible RPC schema: expected at least ${minimumSchema}, got ${state.schemaRevision ?? "unversioned"}`);
         }
         catch (error) {
-            try {
-                await this.stop();
-            }
-            catch (cleanupError) {
-                throw new AggregateError([error, cleanupError], "RPC startup and cleanup failed", { cause: error });
+            if (this.process === child) {
+                try {
+                    await this.stop();
+                }
+                catch (cleanupError) {
+                    throw new AggregateError([error, cleanupError], "RPC startup and cleanup failed", { cause: error });
+                }
             }
             throw error;
         }
@@ -94,24 +105,28 @@ export class RpcClient {
      * Stop the RPC agent process.
      */
     async stop() {
-        if (!this.process)
+        const child = this.process;
+        if (!child)
             return;
         this.stopReadingStdout?.();
         this.stopReadingStdout = null;
-        this.process.kill("SIGTERM");
-        // Wait for process to exit
-        await new Promise((resolve) => {
-            const timeout = setTimeout(() => {
-                this.process?.kill("SIGKILL");
-                resolve();
-            }, 1000);
-            this.process?.on("exit", () => {
-                clearTimeout(timeout);
-                resolve();
+        if (child.exitCode === null && child.signalCode === null) {
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    child.kill("SIGKILL");
+                    resolve();
+                }, 1000);
+                child.once("exit", () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+                child.kill("SIGTERM");
             });
-        });
-        this.process = null;
-        this.pendingRequests.clear();
+        }
+        if (this.process === child) {
+            this.process = null;
+            this.rejectPendingRequests(new Error("RPC client stopped"));
+        }
     }
     /**
      * Subscribe to agent events.
@@ -145,11 +160,11 @@ export class RpcClient {
     // =========================================================================
     /**
      * Send a prompt to the agent.
-     * Returns immediately after sending; use onEvent() to receive streaming events.
+     * Resolves after admission succeeds; use onEvent() to receive streaming events.
      * Use waitForIdle() to wait for completion.
      */
     async prompt(message, images) {
-        await this.send({ type: "prompt", message, images });
+        this.getData(await this.send({ type: "prompt", message, images }));
     }
     /**
      * Queue a steering message to interrupt the agent mid-run.
@@ -454,36 +469,49 @@ export class RpcClient {
      * Collect events until agent becomes idle.
      */
     collectEvents(timeout = 60000) {
-        return new Promise((resolve, reject) => {
+        return this.createEventCollection(timeout).result;
+    }
+    createEventCollection(timeout) {
+        let cancel = () => { };
+        const result = new Promise((resolve, reject) => {
             const events = [];
             const timer = setTimeout(() => {
-                unsubscribe();
+                cancel();
                 reject(new Error(`Timeout collecting events. Stderr: ${this.stderr}`));
             }, timeout);
             const unsubscribe = this.onEvent((event) => {
                 events.push(event);
                 const error = promptCompletionError(event);
                 if (error !== undefined) {
-                    clearTimeout(timer);
-                    unsubscribe();
+                    cancel();
                     reject(new Error(error));
                     return;
                 }
                 if (event.type === "agent_end") {
-                    clearTimeout(timer);
-                    unsubscribe();
+                    cancel();
                     resolve(events);
                 }
             });
+            cancel = () => {
+                clearTimeout(timer);
+                unsubscribe();
+                cancel = () => { };
+            };
         });
+        return { result, cancel: () => cancel() };
     }
     /**
      * Send prompt and wait for completion, returning all events.
      */
     async promptAndWait(message, images, timeout = 60000) {
-        const eventsPromise = this.collectEvents(timeout);
-        await this.prompt(message, images);
-        const events = await eventsPromise;
+        const collection = this.createEventCollection(timeout);
+        let events;
+        try {
+            [, events] = await Promise.all([this.prompt(message, images), collection.result]);
+        }
+        finally {
+            collection.cancel();
+        }
         const terminal = events.find((event) => event.type === "agent_end");
         if (terminal?.type === "agent_end" && terminal.refusal)
             throw new AgentOutputLimitError(terminal.refusal);
@@ -492,6 +520,15 @@ export class RpcClient {
     // =========================================================================
     // Internal
     // =========================================================================
+    processExitError(child) {
+        const reason = child.signalCode ? `signal ${child.signalCode}` : `code ${child.exitCode}`;
+        return new Error(`Agent process exited with ${reason}. Stderr: ${this.stderr}`);
+    }
+    rejectPendingRequests(error) {
+        for (const pending of this.pendingRequests.values())
+            pending.reject(error);
+        this.pendingRequests.clear();
+    }
     handleLine(line) {
         try {
             const data = JSON.parse(line);
@@ -528,13 +565,16 @@ export class RpcClient {
         }
     }
     async send(command, timeoutMs = 30000) {
-        if (!this.process?.stdin) {
+        const child = this.process;
+        if (!child?.stdin) {
             throw new Error("Client not started");
         }
+        if (child.exitCode !== null || child.signalCode !== null) {
+            throw this.processExitError(child);
+        }
         const id = `req_${++this.requestId}`;
         const fullCommand = { ...command, id };
         return new Promise((resolve, reject) => {
-            this.pendingRequests.set(id, { resolve, reject });
             const timeout = setTimeout(() => {
                 this.pendingRequests.delete(id);
                 reject(new Error(`Timeout waiting for response to ${command.type}. Stderr: ${this.stderr}`));
@@ -549,7 +589,7 @@ export class RpcClient {
                     reject(error);
                 },
             });
-            this.process.stdin.write(serializeJsonLine(fullCommand));
+            child.stdin.write(serializeJsonLine(fullCommand));
         });
     }
     getData(response) {