@openadapter/koda 1.0.0-beta.3

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

@@ -0,0 +1,226 @@
+/**
+ * RPC Client for programmatic access to the coding agent.
+ *
+ * Spawns the agent in RPC mode and provides a typed API for all operations.
+ */
+import type { AgentEvent, AgentMessage, ThinkingLevel } from "@openadapter/koda-agent-core";
+import type { ImageContent } from "@openadapter/koda-ai";
+import type { SessionStats } from "../../core/agent-session.ts";
+import type { BashResult } from "../../core/bash-executor.ts";
+import type { CompactionResult } from "../../core/compaction/index.ts";
+import type { RpcSessionState, RpcSlashCommand } from "./rpc-types.ts";
+export interface RpcClientOptions {
+    /** Path to the CLI entry point (default: searches for dist/cli.js) */
+    cliPath?: string;
+    /** Working directory for the agent */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Provider to use */
+    provider?: string;
+    /** Model ID to use */
+    model?: string;
+    /** Additional CLI arguments */
+    args?: string[];
+}
+export interface ModelInfo {
+    provider: string;
+    id: string;
+    contextWindow: number;
+    reasoning: boolean;
+}
+export type RpcEventListener = (event: AgentEvent) => void;
+export declare class RpcClient {
+    private process;
+    private stopReadingStdout;
+    private eventListeners;
+    private pendingRequests;
+    private requestId;
+    private stderr;
+    private exitError;
+    private options;
+    constructor(options?: RpcClientOptions);
+    /**
+     * Start the RPC agent process.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the RPC agent process.
+     */
+    stop(): Promise<void>;
+    /**
+     * Subscribe to agent events.
+     */
+    onEvent(listener: RpcEventListener): () => void;
+    /**
+     * Get collected stderr output (useful for debugging).
+     */
+    getStderr(): string;
+    /**
+     * Send a prompt to the agent.
+     * Returns immediately after sending; use onEvent() to receive streaming events.
+     * Use waitForIdle() to wait for completion.
+     */
+    prompt(message: string, images?: ImageContent[]): Promise<void>;
+    /**
+     * Queue a steering message to interrupt the agent mid-run.
+     */
+    steer(message: string, images?: ImageContent[]): Promise<void>;
+    /**
+     * Queue a follow-up message to be processed after the agent finishes.
+     */
+    followUp(message: string, images?: ImageContent[]): Promise<void>;
+    /**
+     * Abort current operation.
+     */
+    abort(): Promise<void>;
+    /**
+     * Start a new session, optionally with parent tracking.
+     * @param parentSession - Optional parent session path for lineage tracking
+     * @returns Object with `cancelled: true` if an extension cancelled the new session
+     */
+    newSession(parentSession?: string): Promise<{
+        cancelled: boolean;
+    }>;
+    /**
+     * Get current session state.
+     */
+    getState(): Promise<RpcSessionState>;
+    /**
+     * Set model by provider and ID.
+     */
+    setModel(provider: string, modelId: string): Promise<{
+        provider: string;
+        id: string;
+    }>;
+    /**
+     * Cycle to next model.
+     */
+    cycleModel(): Promise<{
+        model: {
+            provider: string;
+            id: string;
+        };
+        thinkingLevel: ThinkingLevel;
+        isScoped: boolean;
+    } | null>;
+    /**
+     * Get list of available models.
+     */
+    getAvailableModels(): Promise<ModelInfo[]>;
+    /**
+     * Set thinking level.
+     */
+    setThinkingLevel(level: ThinkingLevel): Promise<void>;
+    /**
+     * Cycle thinking level.
+     */
+    cycleThinkingLevel(): Promise<{
+        level: ThinkingLevel;
+    } | null>;
+    /**
+     * Set steering mode.
+     */
+    setSteeringMode(mode: "all" | "one-at-a-time"): Promise<void>;
+    /**
+     * Set follow-up mode.
+     */
+    setFollowUpMode(mode: "all" | "one-at-a-time"): Promise<void>;
+    /**
+     * Compact session context.
+     */
+    compact(customInstructions?: string): Promise<CompactionResult>;
+    /**
+     * Set auto-compaction enabled/disabled.
+     */
+    setAutoCompaction(enabled: boolean): Promise<void>;
+    /**
+     * Set auto-retry enabled/disabled.
+     */
+    setAutoRetry(enabled: boolean): Promise<void>;
+    /**
+     * Abort in-progress retry.
+     */
+    abortRetry(): Promise<void>;
+    /**
+     * Execute a bash command.
+     */
+    bash(command: string): Promise<BashResult>;
+    /**
+     * Abort running bash command.
+     */
+    abortBash(): Promise<void>;
+    /**
+     * Get session statistics.
+     */
+    getSessionStats(): Promise<SessionStats>;
+    /**
+     * Export session to HTML.
+     */
+    exportHtml(outputPath?: string): Promise<{
+        path: string;
+    }>;
+    /**
+     * Switch to a different session file.
+     * @returns Object with `cancelled: true` if an extension cancelled the switch
+     */
+    switchSession(sessionPath: string): Promise<{
+        cancelled: boolean;
+    }>;
+    /**
+     * Fork from a specific message.
+     * @returns Object with `text` (the message text) and `cancelled` (if extension cancelled)
+     */
+    fork(entryId: string): Promise<{
+        text: string;
+        cancelled: boolean;
+    }>;
+    /**
+     * Clone the current active branch into a new session.
+     * @returns Object with `cancelled: true` if an extension cancelled the clone
+     */
+    clone(): Promise<{
+        cancelled: boolean;
+    }>;
+    /**
+     * Get messages available for forking.
+     */
+    getForkMessages(): Promise<Array<{
+        entryId: string;
+        text: string;
+    }>>;
+    /**
+     * Get text of last assistant message.
+     */
+    getLastAssistantText(): Promise<string | null>;
+    /**
+     * Set the session display name.
+     */
+    setSessionName(name: string): Promise<void>;
+    /**
+     * Get all messages in the session.
+     */
+    getMessages(): Promise<AgentMessage[]>;
+    /**
+     * Get available commands (extension commands, prompt templates, skills).
+     */
+    getCommands(): Promise<RpcSlashCommand[]>;
+    /**
+     * Wait for agent to become idle (no streaming).
+     * Resolves when agent_end event is received.
+     */
+    waitForIdle(timeout?: number): Promise<void>;
+    /**
+     * Collect events until agent becomes idle.
+     */
+    collectEvents(timeout?: number): Promise<AgentEvent[]>;
+    /**
+     * Send prompt and wait for completion, returning all events.
+     */
+    promptAndWait(message: string, images?: ImageContent[], timeout?: number): Promise<AgentEvent[]>;
+    private handleLine;
+    private createProcessExitError;
+    private rejectPendingRequests;
+    private send;
+    private getData;
+}

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

@@ -0,0 +1 @@
+var u=Object.defineProperty;var c=(h,t)=>u(h,"name",{value:t,configurable:!0});import{spawn as g}from"node:child_process";import{attachJsonlLineReader as y,serializeJsonLine as w}from"./jsonl.js";class f{static{c(this,"RpcClient")}process=null;stopReadingStdout=null;eventListeners=[];pendingRequests=new Map;requestId=0;stderr="";exitError=null;options;constructor(t={}){this.options=t}async start(){if(this.process)throw new Error("Client already started");this.exitError=null;const t=this.options.cliPath??"dist/cli.js",e=["--mode","rpc"];this.options.provider&&e.push("--provider",this.options.provider),this.options.model&&e.push("--model",this.options.model),this.options.args&&e.push(...this.options.args);const s=g("node",[t,...e],{cwd:this.options.cwd,env:{...process.env,...this.options.env},stdio:["pipe","pipe","pipe"]});if(this.process=s,s.stderr?.on("data",r=>{this.stderr+=r.toString(),process.stderr.write(r)}),s.once("exit",(r,n)=>{if(this.process!==s)return;const i=this.createProcessExitError(r,n);this.exitError=i,this.rejectPendingRequests(i)}),s.once("error",r=>{if(this.process!==s)return;const n=new Error(`Agent process error: ${r.message}. Stderr: ${this.stderr}`);this.exitError=n,this.rejectPendingRequests(n)}),s.stdin?.on("error",r=>{if(this.process!==s)return;const n=this.exitError??new Error(`Agent process stdin error: ${r.message}. Stderr: ${this.stderr}`);this.exitError=n,this.rejectPendingRequests(n)}),this.stopReadingStdout=y(s.stdout,r=>{this.handleLine(r)}),await new Promise(r=>setTimeout(r,100)),this.process.exitCode!==null){const r=this.exitError??this.createProcessExitError(this.process.exitCode,this.process.signalCode);throw this.exitError=r,r}}async stop(){this.process&&(this.stopReadingStdout?.(),this.stopReadingStdout=null,this.process.kill("SIGTERM"),await new Promise(t=>{const e=setTimeout(()=>{this.process?.kill("SIGKILL"),t()},1e3);this.process?.on("exit",()=>{clearTimeout(e),t()})}),this.process=null,this.pendingRequests.clear())}onEvent(t){return this.eventListeners.push(t),()=>{const e=this.eventListeners.indexOf(t);e!==-1&&this.eventListeners.splice(e,1)}}getStderr(){return this.stderr}async prompt(t,e){await this.send({type:"prompt",message:t,images:e})}async steer(t,e){await this.send({type:"steer",message:t,images:e})}async followUp(t,e){await this.send({type:"follow_up",message:t,images:e})}async abort(){await this.send({type:"abort"})}async newSession(t){const e=await this.send({type:"new_session",parentSession:t});return this.getData(e)}async getState(){const t=await this.send({type:"get_state"});return this.getData(t)}async setModel(t,e){const s=await this.send({type:"set_model",provider:t,modelId:e});return this.getData(s)}async cycleModel(){const t=await this.send({type:"cycle_model"});return this.getData(t)}async getAvailableModels(){const t=await this.send({type:"get_available_models"});return this.getData(t).models}async setThinkingLevel(t){await this.send({type:"set_thinking_level",level:t})}async cycleThinkingLevel(){const t=await this.send({type:"cycle_thinking_level"});return this.getData(t)}async setSteeringMode(t){await this.send({type:"set_steering_mode",mode:t})}async setFollowUpMode(t){await this.send({type:"set_follow_up_mode",mode:t})}async compact(t){const e=await this.send({type:"compact",customInstructions:t});return this.getData(e)}async setAutoCompaction(t){await this.send({type:"set_auto_compaction",enabled:t})}async setAutoRetry(t){await this.send({type:"set_auto_retry",enabled:t})}async abortRetry(){await this.send({type:"abort_retry"})}async bash(t){const e=await this.send({type:"bash",command:t});return this.getData(e)}async abortBash(){await this.send({type:"abort_bash"})}async getSessionStats(){const t=await this.send({type:"get_session_stats"});return this.getData(t)}async exportHtml(t){const e=await this.send({type:"export_html",outputPath:t});return this.getData(e)}async switchSession(t){const e=await this.send({type:"switch_session",sessionPath:t});return this.getData(e)}async fork(t){const e=await this.send({type:"fork",entryId:t});return this.getData(e)}async clone(){const t=await this.send({type:"clone"});return this.getData(t)}async getForkMessages(){const t=await this.send({type:"get_fork_messages"});return this.getData(t).messages}async getLastAssistantText(){const t=await this.send({type:"get_last_assistant_text"});return this.getData(t).text}async setSessionName(t){await this.send({type:"set_session_name",name:t})}async getMessages(){const t=await this.send({type:"get_messages"});return this.getData(t).messages}async getCommands(){const t=await this.send({type:"get_commands"});return this.getData(t).commands}waitForIdle(t=6e4){return new Promise((e,s)=>{const r=setTimeout(()=>{n(),s(new Error(`Timeout waiting for agent to become idle. Stderr: ${this.stderr}`))},t),n=this.onEvent(i=>{i.type==="agent_end"&&(clearTimeout(r),n(),e())})})}collectEvents(t=6e4){return new Promise((e,s)=>{const r=[],n=setTimeout(()=>{i(),s(new Error(`Timeout collecting events. Stderr: ${this.stderr}`))},t),i=this.onEvent(a=>{r.push(a),a.type==="agent_end"&&(clearTimeout(n),i(),e(r))})})}async promptAndWait(t,e,s=6e4){const r=this.collectEvents(s);return await this.prompt(t,e),r}handleLine(t){try{const e=JSON.parse(t);if(e.type==="response"&&e.id&&this.pendingRequests.has(e.id)){const s=this.pendingRequests.get(e.id);this.pendingRequests.delete(e.id),s.resolve(e);return}for(const s of this.eventListeners)s(e)}catch{}}createProcessExitError(t,e){return new Error(`Agent process exited (code=${t} signal=${e}). Stderr: ${this.stderr}`)}rejectPendingRequests(t){for(const e of this.pendingRequests.values())e.reject(t);this.pendingRequests.clear()}async send(t){const e=this.process,s=e?.stdin;if(!e||!s)throw new Error("Client not started");if(this.exitError)throw this.exitError;if(e.exitCode!==null){const i=this.createProcessExitError(e.exitCode,e.signalCode);throw this.exitError=i,i}if(s.destroyed||!s.writable){const i=new Error(`Agent process stdin is not writable. Stderr: ${this.stderr}`);throw this.exitError=i,i}const r=`req_${++this.requestId}`,n={...t,id:r};return new Promise((i,a)=>{const d=setTimeout(()=>{this.pendingRequests.delete(r),a(new Error(`Timeout waiting for response to ${t.type}. Stderr: ${this.stderr}`))},3e4);this.pendingRequests.set(r,{resolve:c(o=>{clearTimeout(d),i(o)},"resolve"),reject:c(o=>{clearTimeout(d),a(o)},"reject")});try{s.write(w(n))}catch(o){const p=o instanceof Error?o:new Error(String(o)),l=this.pendingRequests.get(r);this.pendingRequests.delete(r),l?.reject(p)}})}getData(t){if(!t.success){const s=t;throw new Error(s.error)}return t.data}}export{f as RpcClient};

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

@@ -0,0 +1,19 @@
+/**
+ * RPC mode: Headless operation with JSON stdin/stdout protocol.
+ *
+ * Used for embedding the agent in other applications.
+ * Receives commands as JSON on stdin, outputs events and responses as JSON on stdout.
+ *
+ * Protocol:
+ * - Commands: JSON objects with `type` field, optional `id` for correlation
+ * - Responses: JSON objects with `type: "response"`, `command`, `success`, and optional `data`/`error`
+ * - Events: AgentSessionEvent objects streamed as they occur
+ * - Extension UI: Extension UI requests are emitted, client responds with extension_ui_response
+ */
+import type { AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
+export type { RpcCommand, RpcExtensionUIRequest, RpcExtensionUIResponse, RpcResponse, RpcSessionState, } from "./rpc-types.ts";
+/**
+ * Run in RPC mode.
+ * Listens for JSON commands on stdin, outputs events and responses on stdout.
+ */
+export declare function runRpcMode(runtimeHost: AgentSessionRuntime): Promise<never>;

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

@@ -0,0 +1 @@
+var A=Object.defineProperty;var r=(c,o)=>A(c,"name",{value:o,configurable:!0});import*as p from"node:crypto";import{flushRawStdout as q,takeOverStdout as D,waitForRawStdoutBackpressure as g,writeRawStdout as B}from"../../core/output-guard.js";import{killTrackedDetachedChildren as N}from"../../utils/shell.js";import{theme as W}from"../interactive/theme/theme.js";import{attachJsonlLineReader as $,serializeJsonLine as G}from"./jsonl.js";async function Q(c){D();let o=c.session,_,h;const a=r(e=>{B(G(e))},"output"),i=r((e,t,s)=>s===void 0?{id:e,type:"response",command:t,success:!0}:{id:e,type:"response",command:t,success:!0,data:s},"success"),d=r((e,t,s)=>({id:e,type:"response",command:t,success:!1,error:s}),"error"),f=new Map;let v=!1,I=!1;const k=[];function w(e,t,s,n){if(e?.signal?.aborted)return Promise.resolve(t);const l=p.randomUUID();return new Promise((u,P)=>{let b;const x=r(()=>{b&&clearTimeout(b),e?.signal?.removeEventListener("abort",E),f.delete(l)},"cleanup"),E=r(()=>{x(),u(t)},"onAbort");e?.signal?.addEventListener("abort",E,{once:!0}),e?.timeout&&(b=setTimeout(()=>{x(),u(t)},e.timeout)),f.set(l,{resolve:r(F=>{x(),u(n(F))},"resolve"),reject:P}),a({type:"extension_ui_request",id:l,...s})})}r(w,"createDialogPromise");const U=r(()=>({select:r((e,t,s)=>w(s,void 0,{method:"select",title:e,options:t,timeout:s?.timeout},n=>"cancelled"in n&&n.cancelled?void 0:"value"in n?n.value:void 0),"select"),confirm:r((e,t,s)=>w(s,!1,{method:"confirm",title:e,message:t,timeout:s?.timeout},n=>"cancelled"in n&&n.cancelled?!1:"confirmed"in n?n.confirmed:!1),"confirm"),input:r((e,t,s)=>w(s,void 0,{method:"input",title:e,placeholder:t,timeout:s?.timeout},n=>"cancelled"in n&&n.cancelled?void 0:"value"in n?n.value:void 0),"input"),notify(e,t){a({type:"extension_ui_request",id:p.randomUUID(),method:"notify",message:e,notifyType:t})},onTerminalInput(){return()=>{}},setStatus(e,t){a({type:"extension_ui_request",id:p.randomUUID(),method:"setStatus",statusKey:e,statusText:t})},setWorkingMessage(e){},setWorkingVisible(e){},setWorkingIndicator(e){},setHiddenThinkingLabel(e){},setWidget(e,t,s){(t===void 0||Array.isArray(t))&&a({type:"extension_ui_request",id:p.randomUUID(),method:"setWidget",widgetKey:e,widgetLines:t,widgetPlacement:s?.placement})},setFooter(e){},setHeader(e){},setTitle(e){a({type:"extension_ui_request",id:p.randomUUID(),method:"setTitle",title:e})},async custom(){},pasteToEditor(e){this.setEditorText(e)},setEditorText(e){a({type:"extension_ui_request",id:p.randomUUID(),method:"set_editor_text",text:e})},getEditorText(){return""},async editor(e,t){const s=p.randomUUID();return new Promise((n,l)=>{f.set(s,{resolve:r(u=>{"cancelled"in u&&u.cancelled?n(void 0):"value"in u?n(u.value):n(void 0)},"resolve"),reject:l}),a({type:"extension_ui_request",id:s,method:"editor",title:e,prefill:t})})},addAutocompleteProvider(){},setEditorComponent(){},getEditorComponent(){},get theme(){return W},getAllThemes(){return[]},getTheme(e){},setTheme(e){return{success:!1,error:"Theme switching not supported in RPC mode"}},getToolsExpanded(){return!1},setToolsExpanded(e){}}),"createExtensionUIContext");c.setRebindSession(async()=>{await m()});const m=r(async()=>{o=c.session,await o.bindExtensions({uiContext:U(),mode:"rpc",commandContextActions:{waitForIdle:r(()=>o.agent.waitForIdle(),"waitForIdle"),newSession:r(async e=>c.newSession(e),"newSession"),fork:r(async(e,t)=>({cancelled:(await c.fork(e,t)).cancelled}),"fork"),navigateTree:r(async(e,t)=>({cancelled:(await o.navigateTree(e,{summarize:t?.summarize,customInstructions:t?.customInstructions,replaceInstructions:t?.replaceInstructions,label:t?.label})).cancelled}),"navigateTree"),switchSession:r(async(e,t)=>c.switchSession(e,t),"switchSession"),reload:r(async()=>{await o.reload()},"reload")},shutdownHandler:r(()=>{v=!0},"shutdownHandler"),onError:r(e=>{a({type:"extension_error",extensionPath:e.extensionPath,event:e.event,error:e.error})},"onError")}),_?.(),h?.(),_=o.subscribe(e=>{a(e)}),h=o.agent.subscribe(async()=>{await g()})},"rebindSession"),C=r(()=>{const e=["SIGTERM"];process.platform!=="win32"&&e.push("SIGHUP");for(const t of e){const s=r(()=>{N(),y(t==="SIGHUP"?129:143,t)},"handler");process.on(t,s),k.push(()=>process.off(t,s))}},"registerSignalHandlers");await m(),C();const R=r(async e=>{const t=e.id;switch(e.type){case"prompt":{let s=!1;o.prompt(e.message,{images:e.images,streamingBehavior:e.streamingBehavior,source:"rpc",preflightResult:r(n=>{n&&(s=!0,a(i(t,"prompt")))},"preflightResult")}).catch(n=>{s||a(d(t,"prompt",n.message))});return}case"steer":return await o.steer(e.message,e.images),i(t,"steer");case"follow_up":return await o.followUp(e.message,e.images),i(t,"follow_up");case"abort":return await o.abort(),i(t,"abort");case"new_session":{const s=e.parentSession?{parentSession:e.parentSession}:void 0,n=await c.newSession(s);return n.cancelled||await m(),i(t,"new_session",n)}case"get_state":{const s={model:o.model,thinkingLevel:o.thinkingLevel,isStreaming:o.isStreaming,isCompacting:o.isCompacting,steeringMode:o.steeringMode,followUpMode:o.followUpMode,sessionFile:o.sessionFile,sessionId:o.sessionId,sessionName:o.sessionName,autoCompactionEnabled:o.autoCompactionEnabled,messageCount:o.messages.length,pendingMessageCount:o.pendingMessageCount};return i(t,"get_state",s)}case"set_model":{const n=(await o.modelRegistry.getAvailable()).find(l=>l.provider===e.provider&&l.id===e.modelId);return n?(await o.setModel(n),i(t,"set_model",n)):d(t,"set_model",`Model not found: ${e.provider}/${e.modelId}`)}case"cycle_model":{const s=await o.cycleModel();return s?i(t,"cycle_model",s):i(t,"cycle_model",null)}case"get_available_models":{const s=await o.modelRegistry.getAvailable();return i(t,"get_available_models",{models:s})}case"set_thinking_level":return o.setThinkingLevel(e.level),i(t,"set_thinking_level");case"cycle_thinking_level":{const s=o.cycleThinkingLevel();return s?i(t,"cycle_thinking_level",{level:s}):i(t,"cycle_thinking_level",null)}case"set_steering_mode":return o.setSteeringMode(e.mode),i(t,"set_steering_mode");case"set_follow_up_mode":return o.setFollowUpMode(e.mode),i(t,"set_follow_up_mode");case"compact":{const s=await o.compact(e.customInstructions);return i(t,"compact",s)}case"set_auto_compaction":return o.setAutoCompactionEnabled(e.enabled),i(t,"set_auto_compaction");case"set_auto_retry":return o.setAutoRetryEnabled(e.enabled),i(t,"set_auto_retry");case"abort_retry":return o.abortRetry(),i(t,"abort_retry");case"bash":{const s=await o.executeBash(e.command,void 0,{excludeFromContext:e.excludeFromContext});return i(t,"bash",s)}case"abort_bash":return o.abortBash(),i(t,"abort_bash");case"get_session_stats":{const s=o.getSessionStats();return i(t,"get_session_stats",s)}case"export_html":{const s=await o.exportToHtml(e.outputPath);return i(t,"export_html",{path:s})}case"switch_session":{const s=await c.switchSession(e.sessionPath);return s.cancelled||await m(),i(t,"switch_session",s)}case"fork":{const s=await c.fork(e.entryId);return s.cancelled||await m(),i(t,"fork",{text:s.selectedText,cancelled:s.cancelled})}case"clone":{const s=o.sessionManager.getLeafId();if(!s)return d(t,"clone","Cannot clone session: no current entry selected");const n=await c.fork(s,{position:"at"});return n.cancelled||await m(),i(t,"clone",{cancelled:n.cancelled})}case"get_fork_messages":{const s=o.getUserMessagesForForking();return i(t,"get_fork_messages",{messages:s})}case"get_last_assistant_text":{const s=o.getLastAssistantText();return i(t,"get_last_assistant_text",{text:s})}case"set_session_name":{const s=e.name.trim();return s?(o.setSessionName(s),i(t,"set_session_name")):d(t,"set_session_name","Session name cannot be empty")}case"get_messages":return i(t,"get_messages",{messages:o.messages});case"get_commands":{const s=[];for(const n of o.extensionRunner.getRegisteredCommands())s.push({name:n.invocationName,description:n.description,source:"extension",sourceInfo:n.sourceInfo});for(const n of o.promptTemplates)s.push({name:n.name,description:n.description,source:"prompt",sourceInfo:n.sourceInfo});for(const n of o.resourceLoader.getSkills().skills)s.push({name:`skill:${n.name}`,description:n.description,source:"skill",sourceInfo:n.sourceInfo});return i(t,"get_commands",{commands:s})}default:{const s=e;return d(void 0,s.type,`Unknown command: ${s.type}`)}}},"handleCommand");let S=r(()=>{},"detachInput");async function y(e=0,t){I&&process.exit(e),I=!0;for(const s of k)s();_?.(),h?.(),await c.dispose(),S(),process.stdin.pause(),t!=="SIGTERM"&&await q(),process.exit(e)}r(y,"shutdown");async function M(){v&&await y()}r(M,"checkShutdownRequested");const L=r(async e=>{let t;try{t=JSON.parse(e)}catch(n){a(d(void 0,"parse",`Failed to parse command: ${n instanceof Error?n.message:String(n)}`)),await g();return}if(typeof t=="object"&&t!==null&&"type"in t&&t.type==="extension_ui_response"){const n=t,l=f.get(n.id);l&&(f.delete(n.id),l.resolve(n));return}const s=t;try{const n=await R(s);n&&(a(n),await g()),await M()}catch(n){a(d(s.id,s.type,n instanceof Error?n.message:String(n))),await g()}},"handleInputLine"),T=r(()=>{y()},"onInputEnd");return process.stdin.on("end",T),S=(()=>{const e=$(process.stdin,t=>{L(t)});return()=>{e(),process.stdin.off("end",T)}})(),new Promise(()=>{})}r(Q,"runRpcMode");export{Q as runRpcMode};

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

@@ -0,0 +1,419 @@
+/**
+ * RPC protocol types for headless operation.
+ *
+ * Commands are sent as JSON lines on stdin.
+ * Responses and events are emitted as JSON lines on stdout.
+ */
+import type { AgentMessage, ThinkingLevel } from "@openadapter/koda-agent-core";
+import type { ImageContent, Model } from "@openadapter/koda-ai";
+import type { SessionStats } from "../../core/agent-session.ts";
+import type { BashResult } from "../../core/bash-executor.ts";
+import type { CompactionResult } from "../../core/compaction/index.ts";
+import type { SourceInfo } from "../../core/source-info.ts";
+export type RpcCommand = {
+    id?: string;
+    type: "prompt";
+    message: string;
+    images?: ImageContent[];
+    streamingBehavior?: "steer" | "followUp";
+} | {
+    id?: string;
+    type: "steer";
+    message: string;
+    images?: ImageContent[];
+} | {
+    id?: string;
+    type: "follow_up";
+    message: string;
+    images?: ImageContent[];
+} | {
+    id?: string;
+    type: "abort";
+} | {
+    id?: string;
+    type: "new_session";
+    parentSession?: string;
+} | {
+    id?: string;
+    type: "get_state";
+} | {
+    id?: string;
+    type: "set_model";
+    provider: string;
+    modelId: string;
+} | {
+    id?: string;
+    type: "cycle_model";
+} | {
+    id?: string;
+    type: "get_available_models";
+} | {
+    id?: string;
+    type: "set_thinking_level";
+    level: ThinkingLevel;
+} | {
+    id?: string;
+    type: "cycle_thinking_level";
+} | {
+    id?: string;
+    type: "set_steering_mode";
+    mode: "all" | "one-at-a-time";
+} | {
+    id?: string;
+    type: "set_follow_up_mode";
+    mode: "all" | "one-at-a-time";
+} | {
+    id?: string;
+    type: "compact";
+    customInstructions?: string;
+} | {
+    id?: string;
+    type: "set_auto_compaction";
+    enabled: boolean;
+} | {
+    id?: string;
+    type: "set_auto_retry";
+    enabled: boolean;
+} | {
+    id?: string;
+    type: "abort_retry";
+} | {
+    id?: string;
+    type: "bash";
+    command: string;
+    excludeFromContext?: boolean;
+} | {
+    id?: string;
+    type: "abort_bash";
+} | {
+    id?: string;
+    type: "get_session_stats";
+} | {
+    id?: string;
+    type: "export_html";
+    outputPath?: string;
+} | {
+    id?: string;
+    type: "switch_session";
+    sessionPath: string;
+} | {
+    id?: string;
+    type: "fork";
+    entryId: string;
+} | {
+    id?: string;
+    type: "clone";
+} | {
+    id?: string;
+    type: "get_fork_messages";
+} | {
+    id?: string;
+    type: "get_last_assistant_text";
+} | {
+    id?: string;
+    type: "set_session_name";
+    name: string;
+} | {
+    id?: string;
+    type: "get_messages";
+} | {
+    id?: string;
+    type: "get_commands";
+};
+/** A command available for invocation via prompt */
+export interface RpcSlashCommand {
+    /** Command name (without leading slash) */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** What kind of command this is */
+    source: "extension" | "prompt" | "skill";
+    /** Source metadata for the owning resource */
+    sourceInfo: SourceInfo;
+}
+export interface RpcSessionState {
+    model?: Model<any>;
+    thinkingLevel: ThinkingLevel;
+    isStreaming: boolean;
+    isCompacting: boolean;
+    steeringMode: "all" | "one-at-a-time";
+    followUpMode: "all" | "one-at-a-time";
+    sessionFile?: string;
+    sessionId: string;
+    sessionName?: string;
+    autoCompactionEnabled: boolean;
+    messageCount: number;
+    pendingMessageCount: number;
+}
+export type RpcResponse = {
+    id?: string;
+    type: "response";
+    command: "prompt";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "steer";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "follow_up";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "abort";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "new_session";
+    success: true;
+    data: {
+        cancelled: boolean;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_state";
+    success: true;
+    data: RpcSessionState;
+} | {
+    id?: string;
+    type: "response";
+    command: "set_model";
+    success: true;
+    data: Model<any>;
+} | {
+    id?: string;
+    type: "response";
+    command: "cycle_model";
+    success: true;
+    data: {
+        model: Model<any>;
+        thinkingLevel: ThinkingLevel;
+        isScoped: boolean;
+    } | null;
+} | {
+    id?: string;
+    type: "response";
+    command: "get_available_models";
+    success: true;
+    data: {
+        models: Model<any>[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "set_thinking_level";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "cycle_thinking_level";
+    success: true;
+    data: {
+        level: ThinkingLevel;
+    } | null;
+} | {
+    id?: string;
+    type: "response";
+    command: "set_steering_mode";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "set_follow_up_mode";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "compact";
+    success: true;
+    data: CompactionResult;
+} | {
+    id?: string;
+    type: "response";
+    command: "set_auto_compaction";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "set_auto_retry";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "abort_retry";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "bash";
+    success: true;
+    data: BashResult;
+} | {
+    id?: string;
+    type: "response";
+    command: "abort_bash";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "get_session_stats";
+    success: true;
+    data: SessionStats;
+} | {
+    id?: string;
+    type: "response";
+    command: "export_html";
+    success: true;
+    data: {
+        path: string;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "switch_session";
+    success: true;
+    data: {
+        cancelled: boolean;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "fork";
+    success: true;
+    data: {
+        text: string;
+        cancelled: boolean;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "clone";
+    success: true;
+    data: {
+        cancelled: boolean;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_fork_messages";
+    success: true;
+    data: {
+        messages: Array<{
+            entryId: string;
+            text: string;
+        }>;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_last_assistant_text";
+    success: true;
+    data: {
+        text: string | null;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "set_session_name";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "get_messages";
+    success: true;
+    data: {
+        messages: AgentMessage[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_commands";
+    success: true;
+    data: {
+        commands: RpcSlashCommand[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: string;
+    success: false;
+    error: string;
+};
+/** Emitted when an extension needs user input */
+export type RpcExtensionUIRequest = {
+    type: "extension_ui_request";
+    id: string;
+    method: "select";
+    title: string;
+    options: string[];
+    timeout?: number;
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "confirm";
+    title: string;
+    message: string;
+    timeout?: number;
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "input";
+    title: string;
+    placeholder?: string;
+    timeout?: number;
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "editor";
+    title: string;
+    prefill?: string;
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "notify";
+    message: string;
+    notifyType?: "info" | "warning" | "error";
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "setStatus";
+    statusKey: string;
+    statusText: string | undefined;
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "setWidget";
+    widgetKey: string;
+    widgetLines: string[] | undefined;
+    widgetPlacement?: "aboveEditor" | "belowEditor";
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "setTitle";
+    title: string;
+} | {
+    type: "extension_ui_request";
+    id: string;
+    method: "set_editor_text";
+    text: string;
+};
+/** Response to an extension UI request */
+export type RpcExtensionUIResponse = {
+    type: "extension_ui_response";
+    id: string;
+    value: string;
+} | {
+    type: "extension_ui_response";
+    id: string;
+    confirmed: boolean;
+} | {
+    type: "extension_ui_response";
+    id: string;
+    cancelled: true;
+};
+export type RpcCommandType = RpcCommand["type"];