@robota-sdk/agent-transport 3.0.0-beta.76 → 3.0.0-beta.77

package/README.md

@@ -25,7 +25,7 @@ npm install @robota-sdk/agent-transport
 ```typescript
 import { createHeadlessTransport } from '@robota-sdk/agent-transport/headless';
 
-const transport = createHeadlessTransport({ format: 'text' });
+const transport = createHeadlessTransport({ outputFormat: 'text', prompt: 'Hello!' });
 ```
 
 ### WebSocket
@@ -41,7 +41,7 @@ const transport = new WsTransport({ port: 3001 });
 ```typescript
 import { createHttpTransport } from '@robota-sdk/agent-transport-http';
 
-const transport = createHttpTransport({ port: 8080 });
+const transport = createHttpTransport({ basePath: '/agent' }); // mount on your own server
 ```
 
 ### MCP
@@ -49,16 +49,17 @@ const transport = createHttpTransport({ port: 8080 });
 ```typescript
 import { createMcpTransport } from '@robota-sdk/agent-transport-mcp';
 
-const transport = createMcpTransport({ name: 'my-agent' });
+const transport = createMcpTransport({ name: 'my-agent', version: '1.0.0' });
 ```
 
 ### TUI (Ink/React)
 
 ```typescript
 import { TuiTransport } from '@robota-sdk/agent-transport-tui';
-import type { ITuiCliAdapter } from '@robota-sdk/agent-transport-tui';
+import type { IRenderOptions } from '@robota-sdk/agent-transport-tui';
 
-const transport = new TuiTransport(adapter);
+declare const options: IRenderOptions;
+const transport = new TuiTransport(options);
 ```
 
 > React and Ink dependencies are confined to the `./tui` sub-path. Importing from
@@ -79,6 +80,8 @@ import { TuiTransport } from '@robota-sdk/agent-transport-tui';
 
 Root import re-exports all transports:
 
+<!-- doc-example-skip: intentional ellipsis fragment (import surface overview, not runnable) -->
+
 ```typescript
 import { createHeadlessTransport, WsTransport, TuiTransport, ... } from '@robota-sdk/agent-transport';
 ```

package/dist/node/headless/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../headless-OnpVk4-k.cjs");exports.HeadlessInteractionChannel=e.t,exports.PrintTerminal=e.a,exports.createHeadlessRunner=e.r,exports.createHeadlessTransport=e.n,exports.promptInput=e.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../headless-xq77JBq0.cjs");exports.HeadlessInteractionChannel=e.t,exports.PrintTerminal=e.a,exports.createHeadlessRunner=e.r,exports.createHeadlessTransport=e.n,exports.promptInput=e.i;

package/dist/node/headless/index.d.ts

@@ -1,2 +1,2 @@
-import { a as IHeadlessRunnerOptions, c as promptInput, i as createHeadlessTransport, l as PrintTerminal, n as IHeadlessInteractionChannelOptions, o as TOutputFormat, r as IHeadlessTransportOptions, s as createHeadlessRunner, t as HeadlessInteractionChannel } from "../index-E8Gx4-lc.js";
+import { a as IHeadlessRunnerOptions, c as promptInput, i as createHeadlessTransport, l as PrintTerminal, n as IHeadlessInteractionChannelOptions, o as TOutputFormat, r as IHeadlessTransportOptions, s as createHeadlessRunner, t as HeadlessInteractionChannel } from "../index-JTD_xtEQ.js";
 export { HeadlessInteractionChannel, type IHeadlessInteractionChannelOptions, type IHeadlessRunnerOptions, type IHeadlessTransportOptions, PrintTerminal, type TOutputFormat, createHeadlessRunner, createHeadlessTransport, promptInput };

package/dist/node/headless/index.js

@@ -1 +1 @@
-import{a as e,i as t,n,r,t as i}from"../headless-mRYilLfC.js";export{i as HeadlessInteractionChannel,e as PrintTerminal,r as createHeadlessRunner,n as createHeadlessTransport,t as promptInput};
+import{a as e,i as t,n,r,t as i}from"../headless-DG_MEbf0.js";export{i as HeadlessInteractionChannel,e as PrintTerminal,r as createHeadlessRunner,n as createHeadlessTransport,t as promptInput};

package/dist/node/{headless-mRYilLfC.js → headless-DG_MEbf0.js}

@@ -7,10 +7,13 @@ Set your API key via environment variable instead:
 `){a.removeListener(`data`,s),a.setRawMode(o??!1),a.pause(),process.stdout.write(`
 `),n(i.trim());return}else r===``||r===`\b`?i.length>0&&(i=i.slice(0,-1),process.stdout.write(`\b \b`)):r===``?(a.removeListener(`data`,s),a.setRawMode(o??!1),a.pause(),process.stdout.write(`
 `),process.exit(0)):r.charCodeAt(0)>=32&&(i+=r,process.stdout.write(t?`*`:r))};a.on(`data`,s)});function o(e){let t=e.trimStart();if(!t.startsWith(`/`))return null;let[n=``,...r]=t.slice(1).split(/\s+/);return n.length===0?null:{name:n,args:r.join(` `)}}async function s(e,t){let n=o(t);if(!n)return{kind:`not-slash`};let r=await e.executeCommand(n.name,n.args);return r?r.effects?.some(e=>e.type===`session-execution-started`)?{kind:`session-execution`}:{kind:`command-result`,result:r}:{kind:`command-result`,result:{message:`Unknown command "/${n.name}".`,success:!1}}}function c(e,n,r){let i=JSON.stringify({type:`stream_event`,event:r,session_id:n(e),uuid:t()});process.stdout.write(i+`
-`)}function l(e,t,n,r){let i=n=>c(e,t,n),a=e=>i({type:`content_block_delta`,delta:{type:`text_delta`,text:e}}),o=e=>i({type:`background_task_event`,background_task_event:e}),s=e=>i({type:`background_job_group_event`,background_job_group_event:e}),l=()=>u(e,{onTextDelta:a,onBackgroundTaskEvent:o,onBackgroundJobGroupEvent:s,onComplete:d,onInterrupted:f,onError:p}),d=i=>{l(),n(t(e),i.response,`success`),r(0)},f=i=>{l(),n(t(e),i.response,`success`),r(0)},p=i=>{l(),n(t(e),``,`error`,i),r(1)};return e.on(`text_delta`,a),e.on(`background_task_event`,o),e.on(`background_job_group_event`,s),e.on(`complete`,d),e.on(`interrupted`,f),e.on(`error`,p),l}function u(e,t){e.off(`text_delta`,t.onTextDelta),e.off(`background_task_event`,t.onBackgroundTaskEvent),e.off(`background_job_group_event`,t.onBackgroundJobGroupEvent),e.off(`complete`,t.onComplete),e.off(`interrupted`,t.onInterrupted),e.off(`error`,t.onError)}function d(e){let{session:t,outputFormat:n}=e;return{run:e=>n===`text`?h(t,e):n===`json`?g(t,e):_(t,e)}}function f(e){let t=e.message.toLowerCase();return t.includes(`api key`)||t.includes(`no provider`)||t.includes(`provider`)?`config_error`:t.includes(`tool`)||t.includes(`execution`)?`tool_error`:`api_error`}function p(e,t,n,r){let i={type:`result`,result:t,session_id:e,subtype:n};n===`error`&&r!==void 0&&(i.error_code=f(r));let a=JSON.stringify(i);process.stdout.write(a+`
-`)}function m(e){try{return e.getSession().getSessionId()}catch{return``}}function h(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=e=>{r(),process.stdout.write(e.response+`
+`)}function l(e,t,n,r){let i=n=>c(e,t,n),a=e=>i({type:`content_block_delta`,delta:{type:`text_delta`,text:e}}),o=e=>i({type:`background_task_event`,background_task_event:e}),s=e=>i({type:`background_job_group_event`,background_job_group_event:e}),l=()=>u(e,{onTextDelta:a,onBackgroundTaskEvent:o,onBackgroundJobGroupEvent:s,onComplete:d,onInterrupted:f,onError:p}),d=i=>{l(),n(t(e),i.response,`success`),r(0)},f=i=>{l(),n(t(e),i.response,`success`),r(0)},p=i=>{l(),n(t(e),``,`error`,i),r(1)};return e.on(`text_delta`,a),e.on(`background_task_event`,o),e.on(`background_job_group_event`,s),e.on(`complete`,d),e.on(`interrupted`,f),e.on(`error`,p),l}function u(e,t){e.off(`text_delta`,t.onTextDelta),e.off(`background_task_event`,t.onBackgroundTaskEvent),e.off(`background_job_group_event`,t.onBackgroundJobGroupEvent),e.off(`complete`,t.onComplete),e.off(`interrupted`,t.onInterrupted),e.off(`error`,t.onError)}function d(e){let{session:t,outputFormat:n}=e;return{run:e=>n===`text`?g(t,e):n===`json`?_(t,e):v(t,e),runGoal:(e,r={})=>f(t,e,r,n)}}function f(e,t,n,r){return new Promise(i=>{let a=()=>{e.off(`complete`,o),e.off(`error`,s),e.off(`goal_event`,c)},o=e=>{e.response&&process.stdout.write(e.response+`
+`)},s=t=>{a(),r===`text`?process.stderr.write(t.message+`
+`):m(h(e),``,`error`,t),i(1)},c=t=>{if(t.type!==`goal_stopped`)return;a();let n=t.goal,o=n.stopReason===`satisfied`,s=o?`Goal satisfied after ${n.iterations} iteration(s).`:`Goal stopped: ${n.stopReason} (after ${n.iterations} iteration(s)).`;r===`text`?(o?process.stdout:process.stderr).write(s+`
+`):m(h(e),s,o?`success`:`error`),i(o?0:2)};e.on(`complete`,o),e.on(`error`,s),e.on(`goal_event`,c),e.setGoal(t,n.maxIterations?{maxIterations:n.maxIterations}:{})})}function p(e){let t=e.message.toLowerCase();return t.includes(`api key`)||t.includes(`no provider`)||t.includes(`provider`)?`config_error`:t.includes(`tool`)||t.includes(`execution`)?`tool_error`:`api_error`}function m(e,t,n,r){let i={type:`result`,result:t,session_id:e,subtype:n};n===`error`&&r!==void 0&&(i.error_code=p(r));let a=JSON.stringify(i);process.stdout.write(a+`
+`)}function h(e){try{return e.getSession().getSessionId()}catch{return``}}function g(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=e=>{r(),process.stdout.write(e.response+`
 `),n(0)},a=e=>{r(),e.response&&process.stdout.write(e.response+`
 `),n(0)},o=e=>{r(),process.stderr.write(e.message+`
 `),n(1)};e.on(`complete`,i),e.on(`interrupted`,a),e.on(`error`,o),s(e,t).then(i=>{if(i.kind===`command-result`){r(),process.stdout.write(i.result.message+`
-`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function g(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=t=>{r(),p(m(e),t.response,`success`),n(0)},a=t=>{r(),p(m(e),t.response,`success`),n(0)},o=t=>{r(),p(m(e),``,`error`,t),n(1)};e.on(`complete`,i),e.on(`interrupted`,a),e.on(`error`,o),s(e,t).then(i=>{if(i.kind===`command-result`){r(),p(m(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function _(e,t){return new Promise(n=>{let r=l(e,m,p,n);s(e,t).then(i=>{if(i.kind===`command-result`){r(),p(m(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function v(e){let t=null,n=0;return{name:`headless`,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);n=await d({session:t,outputFormat:e.outputFormat}).run(e.prompt)},async stop(){},getExitCode(){return n}}}var y=class{opts;exitCode=0;constructor(e){this.opts=e}async run(e){let t=this.opts.shellExec??(e=>n(e,{timeout:5e3,encoding:`utf-8`,stdio:`pipe`}).trimEnd()),i=new r({cwd:this.opts.cwd,provider:this.opts.provider,permissionMode:this.opts.permissionMode??`bypassPermissions`,maxTurns:this.opts.maxTurns,sessionStore:this.opts.sessionStore,resumeSessionId:this.opts.resumeSessionId,forkSession:this.opts.forkSession,sessionName:this.opts.sessionName,bare:this.opts.bare||void 0,allowedTools:this.opts.allowedTools,deniedTools:this.opts.deniedTools,appendSystemPrompt:this.opts.appendSystemPrompt,...this.opts.persona===void 0?{}:{persona:this.opts.persona},...this.opts.systemPrompt?{systemPrompt:this.opts.systemPrompt}:{},backgroundTaskRunners:this.opts.backgroundTaskRunners,subagentRunnerFactory:this.opts.subagentRunnerFactory,commandModules:this.opts.commandModules,commandHostAdapters:this.opts.commandHostAdapters,shellExec:t,agentName:this.opts.agentName,...this.opts.activePresetId===void 0?{}:{activePresetId:this.opts.activePresetId},...this.opts.enableParallelSubagents===void 0?{}:{enableParallelSubagents:this.opts.enableParallelSubagents},...this.opts.selfVerification===void 0?{}:{selfVerification:this.opts.selfVerification}}),a=d({session:i,outputFormat:this.opts.outputFormat});this.exitCode=await a.run(e),await i.shutdown({reason:`prompt_input_exit`,message:`Headless transport complete`})}getExitCode(){return this.exitCode}};export{i as a,a as i,v as n,d as r,y as t};
-//# sourceMappingURL=headless-mRYilLfC.js.map
+`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function _(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=t=>{r(),m(h(e),t.response,`success`),n(0)},a=t=>{r(),m(h(e),t.response,`success`),n(0)},o=t=>{r(),m(h(e),``,`error`,t),n(1)};e.on(`complete`,i),e.on(`interrupted`,a),e.on(`error`,o),s(e,t).then(i=>{if(i.kind===`command-result`){r(),m(h(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function v(e,t){return new Promise(n=>{let r=l(e,h,m,n);s(e,t).then(i=>{if(i.kind===`command-result`){r(),m(h(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function y(e){let t=null,n=0;return{name:`headless`,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);n=await d({session:t,outputFormat:e.outputFormat}).run(e.prompt)},async stop(){},getExitCode(){return n}}}var b=class{opts;exitCode=0;constructor(e){this.opts=e}async run(e){let t=this.createSession(),n=d({session:t,outputFormat:this.opts.outputFormat});this.exitCode=await n.run(e),await t.shutdown({reason:`prompt_input_exit`,message:`Headless transport complete`})}async runGoal(e,t={}){let n=this.createSession(),r=d({session:n,outputFormat:this.opts.outputFormat});this.exitCode=await r.runGoal(e,t),await n.shutdown({reason:`prompt_input_exit`,message:`Headless goal complete`})}createSession(){let e=this.opts.shellExec??(e=>n(e,{timeout:5e3,encoding:`utf-8`,stdio:`pipe`}).trimEnd());return new r({cwd:this.opts.cwd,provider:this.opts.provider,permissionMode:this.opts.permissionMode??`bypassPermissions`,maxTurns:this.opts.maxTurns,sessionStore:this.opts.sessionStore,resumeSessionId:this.opts.resumeSessionId,forkSession:this.opts.forkSession,sessionName:this.opts.sessionName,bare:this.opts.bare||void 0,allowedTools:this.opts.allowedTools,deniedTools:this.opts.deniedTools,appendSystemPrompt:this.opts.appendSystemPrompt,...this.opts.persona===void 0?{}:{persona:this.opts.persona},...this.opts.systemPrompt?{systemPrompt:this.opts.systemPrompt}:{},backgroundTaskRunners:this.opts.backgroundTaskRunners,subagentRunnerFactory:this.opts.subagentRunnerFactory,commandModules:this.opts.commandModules,commandHostAdapters:this.opts.commandHostAdapters,shellExec:e,agentName:this.opts.agentName,...this.opts.activePresetId===void 0?{}:{activePresetId:this.opts.activePresetId},...this.opts.enableParallelSubagents===void 0?{}:{enableParallelSubagents:this.opts.enableParallelSubagents},...this.opts.selfVerification===void 0?{}:{selfVerification:this.opts.selfVerification}})}getExitCode(){return this.exitCode}};export{i as a,a as i,y as n,d as r,b as t};
+//# sourceMappingURL=headless-DG_MEbf0.js.map

package/dist/node/headless-DG_MEbf0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-DG_MEbf0.js","names":[],"sources":["../../src/headless/print-terminal.ts","../../src/headless/cli-input.ts","../../src/headless/headless-stream-json.ts","../../src/headless/headless-runner.ts","../../src/headless/headless-transport.ts","../../src/headless/HeadlessInteractionChannel.ts"],"sourcesContent":["/**\n * ITerminalOutput implementation for print mode (-p).\n *\n * Writes to stdout/stderr directly. The readline-based prompt and select are\n * only invoked if the agent triggers a permission-gated tool, which is rare in\n * one-shot print mode but must still work correctly.\n */\n\nimport * as readline from 'node:readline';\n\nimport type { ITerminalOutput, ISpinner } from '@robota-sdk/agent-core';\n\nexport class PrintTerminal implements ITerminalOutput {\n  write(text: string): void {\n    process.stdout.write(text);\n  }\n  writeLine(text: string): void {\n    process.stdout.write(text + '\\n');\n  }\n  writeMarkdown(md: string): void {\n    process.stdout.write(md);\n  }\n  writeError(text: string): void {\n    process.stderr.write(text + '\\n');\n  }\n  prompt(question: string): Promise<string> {\n    return new Promise<string>((resolve) => {\n      const rl = readline.createInterface({\n        input: process.stdin,\n        output: process.stdout,\n        terminal: false,\n        historySize: 0,\n      });\n      rl.question(question, (answer) => {\n        rl.close();\n        resolve(answer);\n      });\n    });\n  }\n  async select(options: string[], initialIndex = 0): Promise<number> {\n    for (let i = 0; i < options.length; i++) {\n      const marker = i === initialIndex ? '>' : ' ';\n      process.stdout.write(`  ${marker} ${i + 1}) ${options[i]}\\n`);\n    }\n    const answer = await this.prompt(\n      `  Choose [1-${options.length}] (default: ${options[initialIndex]}): `,\n    );\n    const trimmed = answer.trim().toLowerCase();\n    if (trimmed === '') return initialIndex;\n    const num = parseInt(trimmed, 10);\n    if (!isNaN(num) && num >= 1 && num <= options.length) return num - 1;\n    return initialIndex;\n  }\n  spinner(_message: string): ISpinner {\n    return { stop(): void {}, update(): void {} };\n  }\n}\n","const PRINTABLE_ASCII_START = 32;\n\nexport const promptInput = (label: string, masked = false): Promise<string> =>\n  new Promise<string>((resolve, reject) => {\n    process.stdout.write(label);\n    let input = '';\n    const stdin = process.stdin;\n    const wasRaw = stdin.isRaw;\n    if (!stdin.isTTY) {\n      reject(\n        new Error(\n          'Cannot prompt for input: stdin is not a TTY.\\n' +\n            'Set your API key via environment variable instead:\\n' +\n            '  ANTHROPIC_API_KEY=<key> robota\\n' +\n            '  OPENAI_API_KEY=<key> robota',\n        ),\n      );\n      return;\n    }\n    stdin.setRawMode(true);\n    stdin.resume();\n    stdin.setEncoding('utf8');\n    const onData = (data: string): void => {\n      for (const ch of data) {\n        if (ch === '\\r' || ch === '\\n') {\n          stdin.removeListener('data', onData);\n          stdin.setRawMode(wasRaw ?? false);\n          stdin.pause();\n          process.stdout.write('\\n');\n          resolve(input.trim());\n          return;\n        } else if (ch === '\\x7f' || ch === '\\b') {\n          if (input.length > 0) {\n            input = input.slice(0, -1);\n            process.stdout.write('\\b \\b');\n          }\n        } else if (ch === '\\x03') {\n          stdin.removeListener('data', onData);\n          stdin.setRawMode(wasRaw ?? false);\n          stdin.pause();\n          process.stdout.write('\\n');\n          process.exit(0);\n        } else if (ch.charCodeAt(0) >= PRINTABLE_ASCII_START) {\n          input += ch;\n          process.stdout.write(masked ? '*' : ch);\n        }\n      }\n    };\n    stdin.on('data', onData);\n  });\n","import { randomUUID } from 'node:crypto';\n\nimport type {\n  ICommandResult,\n  IExecutionResult,\n  IInteractiveSession,\n  TBackgroundJobGroupEvent,\n} from '@robota-sdk/agent-interface-transport';\nimport type { TBackgroundTaskEvent } from '@robota-sdk/agent-interface-transport';\n\ntype TSlashCommandExecution =\n  | { readonly kind: 'not-slash' }\n  | { readonly kind: 'command-result'; readonly result: ICommandResult }\n  | { readonly kind: 'session-execution' };\n\nfunction parseSlashCommand(prompt: string): { name: string; args: string } | null {\n  const trimmed = prompt.trimStart();\n  if (!trimmed.startsWith('/')) return null;\n  const withoutSlash = trimmed.slice(1);\n  const [name = '', ...args] = withoutSlash.split(/\\s+/);\n  if (name.length === 0) return null;\n  return { name, args: args.join(' ') };\n}\n\nexport async function executeSlashCommandIfPresent(\n  session: IInteractiveSession,\n  prompt: string,\n): Promise<TSlashCommandExecution> {\n  const command = parseSlashCommand(prompt);\n  if (!command) return { kind: 'not-slash' };\n\n  const result = await session.executeCommand(command.name, command.args);\n  if (result) {\n    if (result.effects?.some((effect) => effect.type === 'session-execution-started')) {\n      return { kind: 'session-execution' };\n    }\n    return { kind: 'command-result', result };\n  }\n  return {\n    kind: 'command-result',\n    result: { message: `Unknown command \"/${command.name}\".`, success: false },\n  };\n}\n\ntype TStreamJsonEvent =\n  | {\n      type: 'content_block_delta';\n      delta: { type: 'text_delta'; text: string };\n    }\n  | {\n      type: 'background_task_event';\n      background_task_event: TBackgroundTaskEvent;\n    }\n  | {\n      type: 'background_job_group_event';\n      background_job_group_event: TBackgroundJobGroupEvent;\n    };\n\ninterface IStreamJsonHandlers {\n  onTextDelta: (text: string) => void;\n  onBackgroundTaskEvent: (event: TBackgroundTaskEvent) => void;\n  onBackgroundJobGroupEvent: (event: TBackgroundJobGroupEvent) => void;\n  onComplete: (result: IExecutionResult) => void;\n  onInterrupted: (result: IExecutionResult) => void;\n  onError: (error: Error) => void;\n}\n\nfunction writeStreamJsonEvent(\n  session: IInteractiveSession,\n  getSessionId: (s: IInteractiveSession) => string,\n  event: TStreamJsonEvent,\n): void {\n  const output = JSON.stringify({\n    type: 'stream_event',\n    event,\n    session_id: getSessionId(session),\n    uuid: randomUUID(),\n  });\n  process.stdout.write(output + '\\n');\n}\n\nexport function subscribeStreamJsonEvents(\n  session: IInteractiveSession,\n  getSessionId: (s: IInteractiveSession) => string,\n  writeJsonResult: (\n    sessionId: string,\n    result: string,\n    subtype: 'success' | 'error',\n    error?: Error,\n  ) => void,\n  resolve: (exitCode: number) => void,\n): () => void {\n  const emit = (event: TStreamJsonEvent): void =>\n    writeStreamJsonEvent(session, getSessionId, event);\n\n  const onTextDelta = (text: string): void =>\n    emit({ type: 'content_block_delta', delta: { type: 'text_delta', text } });\n  const onBackgroundTaskEvent = (event: TBackgroundTaskEvent): void =>\n    emit({ type: 'background_task_event', background_task_event: event });\n  const onBackgroundJobGroupEvent = (event: TBackgroundJobGroupEvent): void =>\n    emit({ type: 'background_job_group_event', background_job_group_event: event });\n\n  const cleanup = (): void =>\n    unsubscribeStreamJsonEvents(session, {\n      onTextDelta,\n      onBackgroundTaskEvent,\n      onBackgroundJobGroupEvent,\n      onComplete,\n      onInterrupted,\n      onError,\n    });\n\n  const onComplete = (result: IExecutionResult): void => {\n    cleanup();\n    writeJsonResult(getSessionId(session), result.response, 'success');\n    resolve(0);\n  };\n  const onInterrupted = (result: IExecutionResult): void => {\n    cleanup();\n    writeJsonResult(getSessionId(session), result.response, 'success');\n    resolve(0);\n  };\n  const onError = (error: Error): void => {\n    cleanup();\n    writeJsonResult(getSessionId(session), '', 'error', error);\n    resolve(1);\n  };\n\n  session.on('text_delta', onTextDelta);\n  session.on('background_task_event', onBackgroundTaskEvent);\n  session.on('background_job_group_event', onBackgroundJobGroupEvent);\n  session.on('complete', onComplete);\n  session.on('interrupted', onInterrupted);\n  session.on('error', onError);\n  return cleanup;\n}\n\nfunction unsubscribeStreamJsonEvents(\n  session: IInteractiveSession,\n  handlers: IStreamJsonHandlers,\n): void {\n  session.off('text_delta', handlers.onTextDelta);\n  session.off('background_task_event', handlers.onBackgroundTaskEvent);\n  session.off('background_job_group_event', handlers.onBackgroundJobGroupEvent);\n  session.off('complete', handlers.onComplete);\n  session.off('interrupted', handlers.onInterrupted);\n  session.off('error', handlers.onError);\n}\n","import { executeSlashCommandIfPresent, subscribeStreamJsonEvents } from './headless-stream-json.js';\n\nimport type {\n  IExecutionResult,\n  IGoalEvent,\n  IInteractiveSession,\n} from '@robota-sdk/agent-interface-transport';\n\nexport type TOutputFormat = 'text' | 'json' | 'stream-json';\n\n/** GOAL-001: options for an autonomous headless goal run. */\nexport interface IHeadlessGoalOptions {\n  maxIterations?: number;\n}\n\nexport interface IHeadlessRunnerOptions {\n  session: IInteractiveSession;\n  outputFormat: TOutputFormat;\n}\n\n/** Exit code for a goal that stopped cleanly without being satisfied (bound/convergence/cancel). */\nexport const GOAL_NOT_SATISFIED_EXIT_CODE = 2;\n\nexport function createHeadlessRunner(options: IHeadlessRunnerOptions): {\n  run: (prompt: string) => Promise<number>;\n  runGoal: (objective: string, goalOptions?: IHeadlessGoalOptions) => Promise<number>;\n} {\n  const { session, outputFormat } = options;\n  return {\n    run: (prompt: string): Promise<number> => {\n      if (outputFormat === 'text') return runTextFormat(session, prompt);\n      if (outputFormat === 'json') return runJsonFormat(session, prompt);\n      return runStreamJsonFormat(session, prompt);\n    },\n    runGoal: (objective: string, goalOptions: IHeadlessGoalOptions = {}): Promise<number> =>\n      runGoalFormat(session, objective, goalOptions, outputFormat),\n  };\n}\n\n/**\n * GOAL-001: drive an autonomous goal to completion in headless mode. Streams each turn's response\n * for progress, then resolves when the goal stops: exit 0 if satisfied, {@link GOAL_NOT_SATISFIED_EXIT_CODE}\n * if it stopped at a bound (max-iterations / no-progress / cancelled), or 1 on a turn error.\n */\nfunction runGoalFormat(\n  session: IInteractiveSession,\n  objective: string,\n  goalOptions: IHeadlessGoalOptions,\n  outputFormat: TOutputFormat,\n): Promise<number> {\n  return new Promise<number>((resolve) => {\n    const cleanup = (): void => {\n      session.off('complete', onComplete);\n      session.off('error', onError);\n      session.off('goal_event', onGoal);\n    };\n    const onComplete = (result: IExecutionResult): void => {\n      if (result.response) process.stdout.write(result.response + '\\n');\n    };\n    const onError = (error: Error): void => {\n      cleanup();\n      if (outputFormat === 'text') process.stderr.write(error.message + '\\n');\n      else writeJsonResult(getSessionId(session), '', 'error', error);\n      resolve(1);\n    };\n    const onGoal = (event: IGoalEvent): void => {\n      if (event.type !== 'goal_stopped') return;\n      cleanup();\n      const goal = event.goal;\n      const satisfied = goal.stopReason === 'satisfied';\n      const summary = satisfied\n        ? `Goal satisfied after ${goal.iterations} iteration(s).`\n        : `Goal stopped: ${goal.stopReason} (after ${goal.iterations} iteration(s)).`;\n      if (outputFormat === 'text')\n        (satisfied ? process.stdout : process.stderr).write(summary + '\\n');\n      else writeJsonResult(getSessionId(session), summary, satisfied ? 'success' : 'error');\n      resolve(satisfied ? 0 : GOAL_NOT_SATISFIED_EXIT_CODE);\n    };\n\n    session.on('complete', onComplete);\n    session.on('error', onError);\n    session.on('goal_event', onGoal);\n\n    void session.setGoal(\n      objective,\n      goalOptions.maxIterations ? { maxIterations: goalOptions.maxIterations } : {},\n    );\n  });\n}\n\nexport function resolveErrorCode(error: Error): string {\n  const msg = error.message.toLowerCase();\n  if (msg.includes('api key') || msg.includes('no provider') || msg.includes('provider')) {\n    return 'config_error';\n  }\n  if (msg.includes('tool') || msg.includes('execution')) {\n    return 'tool_error';\n  }\n  return 'api_error';\n}\n\nexport function writeJsonResult(\n  sessionId: string,\n  result: string,\n  subtype: 'success' | 'error',\n  error?: Error,\n): void {\n  const payload: Record<string, unknown> = {\n    type: 'result',\n    result,\n    session_id: sessionId,\n    subtype,\n  };\n  if (subtype === 'error' && error !== undefined) {\n    payload['error_code'] = resolveErrorCode(error);\n  }\n  const output = JSON.stringify(payload);\n  process.stdout.write(output + '\\n');\n}\n\nexport function getSessionId(session: IInteractiveSession): string {\n  try {\n    return session.getSession().getSessionId();\n  } catch {\n    // allow-fallback: session may not be initialized yet\n    return '';\n  }\n}\n\nfunction runTextFormat(session: IInteractiveSession, prompt: string): Promise<number> {\n  return new Promise<number>((resolve) => {\n    const cleanup = (): void => {\n      session.off('complete', onComplete);\n      session.off('interrupted', onInterrupted);\n      session.off('error', onError);\n    };\n    const onComplete = (result: IExecutionResult): void => {\n      cleanup();\n      process.stdout.write(result.response + '\\n');\n      resolve(0);\n    };\n    const onInterrupted = (result: IExecutionResult): void => {\n      cleanup();\n      if (result.response) process.stdout.write(result.response + '\\n');\n      resolve(0);\n    };\n    const onError = (error: Error): void => {\n      cleanup();\n      process.stderr.write(error.message + '\\n');\n      resolve(1);\n    };\n\n    session.on('complete', onComplete);\n    session.on('interrupted', onInterrupted);\n    session.on('error', onError);\n\n    void executeSlashCommandIfPresent(session, prompt).then((cmd) => {\n      if (cmd.kind === 'command-result') {\n        cleanup();\n        process.stdout.write(cmd.result.message + '\\n');\n        resolve(cmd.result.success ? 0 : 1);\n        return;\n      }\n      if (cmd.kind !== 'session-execution') void session.submit(prompt);\n    });\n  });\n}\n\nfunction runJsonFormat(session: IInteractiveSession, prompt: string): Promise<number> {\n  return new Promise<number>((resolve) => {\n    const cleanup = (): void => {\n      session.off('complete', onComplete);\n      session.off('interrupted', onInterrupted);\n      session.off('error', onError);\n    };\n    const onComplete = (result: IExecutionResult): void => {\n      cleanup();\n      writeJsonResult(getSessionId(session), result.response, 'success');\n      resolve(0);\n    };\n    const onInterrupted = (result: IExecutionResult): void => {\n      cleanup();\n      writeJsonResult(getSessionId(session), result.response, 'success');\n      resolve(0);\n    };\n    const onError = (error: Error): void => {\n      cleanup();\n      writeJsonResult(getSessionId(session), '', 'error', error);\n      resolve(1);\n    };\n\n    session.on('complete', onComplete);\n    session.on('interrupted', onInterrupted);\n    session.on('error', onError);\n\n    void executeSlashCommandIfPresent(session, prompt).then((cmd) => {\n      if (cmd.kind === 'command-result') {\n        cleanup();\n        writeJsonResult(\n          getSessionId(session),\n          cmd.result.message,\n          cmd.result.success ? 'success' : 'error',\n        );\n        resolve(cmd.result.success ? 0 : 1);\n        return;\n      }\n      if (cmd.kind !== 'session-execution') void session.submit(prompt);\n    });\n  });\n}\n\nfunction runStreamJsonFormat(session: IInteractiveSession, prompt: string): Promise<number> {\n  return new Promise<number>((resolve) => {\n    const cleanup = subscribeStreamJsonEvents(session, getSessionId, writeJsonResult, resolve);\n\n    void executeSlashCommandIfPresent(session, prompt).then((cmd) => {\n      if (cmd.kind === 'command-result') {\n        cleanup();\n        writeJsonResult(\n          getSessionId(session),\n          cmd.result.message,\n          cmd.result.success ? 'success' : 'error',\n        );\n        resolve(cmd.result.success ? 0 : 1);\n        return;\n      }\n      if (cmd.kind !== 'session-execution') void session.submit(prompt);\n    });\n  });\n}\n","/**\n * ITransportAdapter implementation for headless transport.\n *\n * Wraps createHeadlessRunner into the unified ITransportAdapter interface.\n * After start() completes, getExitCode() returns the runner's exit code.\n */\n\nimport { createHeadlessRunner } from './headless-runner.js';\n\nimport type { TOutputFormat } from './headless-runner.js';\nimport type { IInteractiveSession, ITransportAdapter } from '@robota-sdk/agent-interface-transport';\n\nexport interface IHeadlessTransportOptions {\n  /** Output format: 'text', 'json', or 'stream-json'. */\n  outputFormat: TOutputFormat;\n  /** The prompt to execute. */\n  prompt: string;\n}\n\nexport function createHeadlessTransport(\n  options: IHeadlessTransportOptions,\n): ITransportAdapter<IInteractiveSession> & { getExitCode(): number } {\n  let session: IInteractiveSession | null = null;\n  let exitCode = 0;\n\n  return {\n    name: 'headless',\n    attach(s: IInteractiveSession) {\n      session = s;\n    },\n    async start() {\n      if (!session) throw new Error('No session attached. Call attach() first.');\n      const runner = createHeadlessRunner({ session, outputFormat: options.outputFormat });\n      exitCode = await runner.run(options.prompt);\n    },\n    async stop() {\n      /* no-op: headless runner completes in start() */\n    },\n    getExitCode() {\n      return exitCode;\n    },\n  };\n}\n","/**\n * HeadlessInteractionChannel — owns session lifecycle for non-interactive (print) mode.\n *\n * Mirrors TuiInteractionChannel's ownership pattern: session creation lives here,\n * not in the caller. print-mode.ts constructs this and calls run().\n */\n\nimport { execSync } from 'node:child_process';\n\nimport { InteractiveSession } from '@robota-sdk/agent-framework';\n\nimport { createHeadlessRunner, type TOutputFormat } from './headless-runner.js';\n\nimport type { IAIProvider, TPermissionMode } from '@robota-sdk/agent-core';\nimport type {\n  IBackgroundTaskRunner,\n  ICommandHostAdapters,\n  ICommandModule,\n  TSubagentRunnerFactory,\n  TShellExecFn,\n} from '@robota-sdk/agent-framework';\nimport type { IInteractiveSessionStore } from '@robota-sdk/agent-interface-transport';\n\nexport interface IHeadlessInteractionChannelOptions {\n  cwd: string;\n  provider: IAIProvider;\n  outputFormat: TOutputFormat;\n  permissionMode?: TPermissionMode;\n  maxTurns?: number;\n  sessionStore?: IInteractiveSessionStore;\n  /** Continue/resume an existing session by id (print-mode parity with TUI). */\n  resumeSessionId?: string;\n  /** Fork the resumed session into a new independent session instead of appending. */\n  forkSession?: boolean;\n  sessionName?: string;\n  bare?: boolean;\n  allowedTools?: string[];\n  deniedTools?: string[];\n  appendSystemPrompt?: string;\n  systemPrompt?: string;\n  /** Name reported to the underlying agent config (resolved by the CLI, e.g. preset agentName). */\n  agentName?: string;\n  /** Active preset id selected at startup (PRESET-011 runtime state). Defaults to 'default'. */\n  activePresetId?: string;\n  /** Preset persona block composed as a `source: 'persona'` system-prompt section (priority 5). */\n  persona?: string;\n  /** Preset execution capability: activate agent runtime + subagent/background dispatch. */\n  enableParallelSubagents?: boolean;\n  /** Preset execution capability: run a post-task self-verification step. */\n  selfVerification?: boolean;\n  backgroundTaskRunners?: IBackgroundTaskRunner[];\n  subagentRunnerFactory?: TSubagentRunnerFactory;\n  commandModules?: readonly ICommandModule[];\n  commandHostAdapters?: ICommandHostAdapters;\n  shellExec?: TShellExecFn;\n}\n\nexport class HeadlessInteractionChannel {\n  private readonly opts: IHeadlessInteractionChannelOptions;\n  private exitCode = 0;\n\n  constructor(options: IHeadlessInteractionChannelOptions) {\n    this.opts = options;\n  }\n\n  async run(prompt: string): Promise<void> {\n    const session = this.createSession();\n    const runner = createHeadlessRunner({ session, outputFormat: this.opts.outputFormat });\n    this.exitCode = await runner.run(prompt);\n    await session.shutdown({ reason: 'prompt_input_exit', message: 'Headless transport complete' });\n  }\n\n  /**\n   * GOAL-001: run an autonomous goal to completion (or a stop condition) in headless mode.\n   * Mirrors {@link run} but drives the framework goal loop instead of a single prompt.\n   */\n  async runGoal(objective: string, options: { maxIterations?: number } = {}): Promise<void> {\n    const session = this.createSession();\n    const runner = createHeadlessRunner({ session, outputFormat: this.opts.outputFormat });\n    this.exitCode = await runner.runGoal(objective, options);\n    await session.shutdown({ reason: 'prompt_input_exit', message: 'Headless goal complete' });\n  }\n\n  private createSession(): InteractiveSession {\n    const shellExec: TShellExecFn =\n      this.opts.shellExec ??\n      ((command: string) =>\n        execSync(command, { timeout: 5000, encoding: 'utf-8', stdio: 'pipe' }).trimEnd());\n\n    return new InteractiveSession({\n      cwd: this.opts.cwd,\n      provider: this.opts.provider,\n      permissionMode: this.opts.permissionMode ?? 'bypassPermissions',\n      // CMD-004: headless has no interactive renderer, so it injects no askHandler — the session's\n      // getUserInteraction() returns undefined and each command applies its explicit no-human path\n      // (e.g. /mode reports current, /exit and /clear proceed — never a silent guess).\n      maxTurns: this.opts.maxTurns,\n      sessionStore: this.opts.sessionStore,\n      resumeSessionId: this.opts.resumeSessionId,\n      forkSession: this.opts.forkSession,\n      sessionName: this.opts.sessionName,\n      bare: this.opts.bare || undefined,\n      allowedTools: this.opts.allowedTools,\n      deniedTools: this.opts.deniedTools,\n      appendSystemPrompt: this.opts.appendSystemPrompt,\n      ...(this.opts.persona !== undefined ? { persona: this.opts.persona } : {}),\n      ...(this.opts.systemPrompt ? { systemPrompt: this.opts.systemPrompt } : {}),\n      backgroundTaskRunners: this.opts.backgroundTaskRunners,\n      subagentRunnerFactory: this.opts.subagentRunnerFactory,\n      commandModules: this.opts.commandModules,\n      commandHostAdapters: this.opts.commandHostAdapters,\n      shellExec,\n      agentName: this.opts.agentName,\n      ...(this.opts.activePresetId !== undefined\n        ? { activePresetId: this.opts.activePresetId }\n        : {}),\n      ...(this.opts.enableParallelSubagents !== undefined\n        ? { enableParallelSubagents: this.opts.enableParallelSubagents }\n        : {}),\n      ...(this.opts.selfVerification !== undefined\n        ? { selfVerification: this.opts.selfVerification }\n        : {}),\n    });\n  }\n\n  getExitCode(): number {\n    return this.exitCode;\n  }\n}\n"],"mappings":"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"}

package/dist/node/{headless-OnpVk4-k.cjs → headless-xq77JBq0.cjs}

@@ -7,9 +7,12 @@ Set your API key via environment variable instead:
 `){a.removeListener(`data`,s),a.setRawMode(o??!1),a.pause(),process.stdout.write(`
 `),n(i.trim());return}else r===``||r===`\b`?i.length>0&&(i=i.slice(0,-1),process.stdout.write(`\b \b`)):r===``?(a.removeListener(`data`,s),a.setRawMode(o??!1),a.pause(),process.stdout.write(`
 `),process.exit(0)):r.charCodeAt(0)>=32&&(i+=r,process.stdout.write(t?`*`:r))};a.on(`data`,s)});function m(e){let t=e.trimStart();if(!t.startsWith(`/`))return null;let[n=``,...r]=t.slice(1).split(/\s+/);return n.length===0?null:{name:n,args:r.join(` `)}}async function h(e,t){let n=m(t);if(!n)return{kind:`not-slash`};let r=await e.executeCommand(n.name,n.args);return r?r.effects?.some(e=>e.type===`session-execution-started`)?{kind:`session-execution`}:{kind:`command-result`,result:r}:{kind:`command-result`,result:{message:`Unknown command "/${n.name}".`,success:!1}}}function g(e,t,n){let r=JSON.stringify({type:`stream_event`,event:n,session_id:t(e),uuid:(0,l.randomUUID)()});process.stdout.write(r+`
-`)}function _(e,t,n,r){let i=n=>g(e,t,n),a=e=>i({type:`content_block_delta`,delta:{type:`text_delta`,text:e}}),o=e=>i({type:`background_task_event`,background_task_event:e}),s=e=>i({type:`background_job_group_event`,background_job_group_event:e}),c=()=>v(e,{onTextDelta:a,onBackgroundTaskEvent:o,onBackgroundJobGroupEvent:s,onComplete:l,onInterrupted:u,onError:d}),l=i=>{c(),n(t(e),i.response,`success`),r(0)},u=i=>{c(),n(t(e),i.response,`success`),r(0)},d=i=>{c(),n(t(e),``,`error`,i),r(1)};return e.on(`text_delta`,a),e.on(`background_task_event`,o),e.on(`background_job_group_event`,s),e.on(`complete`,l),e.on(`interrupted`,u),e.on(`error`,d),c}function v(e,t){e.off(`text_delta`,t.onTextDelta),e.off(`background_task_event`,t.onBackgroundTaskEvent),e.off(`background_job_group_event`,t.onBackgroundJobGroupEvent),e.off(`complete`,t.onComplete),e.off(`interrupted`,t.onInterrupted),e.off(`error`,t.onError)}function y(e){let{session:t,outputFormat:n}=e;return{run:e=>n===`text`?C(t,e):n===`json`?w(t,e):T(t,e)}}function b(e){let t=e.message.toLowerCase();return t.includes(`api key`)||t.includes(`no provider`)||t.includes(`provider`)?`config_error`:t.includes(`tool`)||t.includes(`execution`)?`tool_error`:`api_error`}function x(e,t,n,r){let i={type:`result`,result:t,session_id:e,subtype:n};n===`error`&&r!==void 0&&(i.error_code=b(r));let a=JSON.stringify(i);process.stdout.write(a+`
-`)}function S(e){try{return e.getSession().getSessionId()}catch{return``}}function C(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=e=>{r(),process.stdout.write(e.response+`
+`)}function _(e,t,n,r){let i=n=>g(e,t,n),a=e=>i({type:`content_block_delta`,delta:{type:`text_delta`,text:e}}),o=e=>i({type:`background_task_event`,background_task_event:e}),s=e=>i({type:`background_job_group_event`,background_job_group_event:e}),c=()=>v(e,{onTextDelta:a,onBackgroundTaskEvent:o,onBackgroundJobGroupEvent:s,onComplete:l,onInterrupted:u,onError:d}),l=i=>{c(),n(t(e),i.response,`success`),r(0)},u=i=>{c(),n(t(e),i.response,`success`),r(0)},d=i=>{c(),n(t(e),``,`error`,i),r(1)};return e.on(`text_delta`,a),e.on(`background_task_event`,o),e.on(`background_job_group_event`,s),e.on(`complete`,l),e.on(`interrupted`,u),e.on(`error`,d),c}function v(e,t){e.off(`text_delta`,t.onTextDelta),e.off(`background_task_event`,t.onBackgroundTaskEvent),e.off(`background_job_group_event`,t.onBackgroundJobGroupEvent),e.off(`complete`,t.onComplete),e.off(`interrupted`,t.onInterrupted),e.off(`error`,t.onError)}function y(e){let{session:t,outputFormat:n}=e;return{run:e=>n===`text`?w(t,e):n===`json`?T(t,e):E(t,e),runGoal:(e,r={})=>b(t,e,r,n)}}function b(e,t,n,r){return new Promise(i=>{let a=()=>{e.off(`complete`,o),e.off(`error`,s),e.off(`goal_event`,c)},o=e=>{e.response&&process.stdout.write(e.response+`
+`)},s=t=>{a(),r===`text`?process.stderr.write(t.message+`
+`):S(C(e),``,`error`,t),i(1)},c=t=>{if(t.type!==`goal_stopped`)return;a();let n=t.goal,o=n.stopReason===`satisfied`,s=o?`Goal satisfied after ${n.iterations} iteration(s).`:`Goal stopped: ${n.stopReason} (after ${n.iterations} iteration(s)).`;r===`text`?(o?process.stdout:process.stderr).write(s+`
+`):S(C(e),s,o?`success`:`error`),i(o?0:2)};e.on(`complete`,o),e.on(`error`,s),e.on(`goal_event`,c),e.setGoal(t,n.maxIterations?{maxIterations:n.maxIterations}:{})})}function x(e){let t=e.message.toLowerCase();return t.includes(`api key`)||t.includes(`no provider`)||t.includes(`provider`)?`config_error`:t.includes(`tool`)||t.includes(`execution`)?`tool_error`:`api_error`}function S(e,t,n,r){let i={type:`result`,result:t,session_id:e,subtype:n};n===`error`&&r!==void 0&&(i.error_code=x(r));let a=JSON.stringify(i);process.stdout.write(a+`
+`)}function C(e){try{return e.getSession().getSessionId()}catch{return``}}function w(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=e=>{r(),process.stdout.write(e.response+`
 `),n(0)},a=e=>{r(),e.response&&process.stdout.write(e.response+`
 `),n(0)},o=e=>{r(),process.stderr.write(e.message+`
 `),n(1)};e.on(`complete`,i),e.on(`interrupted`,a),e.on(`error`,o),h(e,t).then(i=>{if(i.kind===`command-result`){r(),process.stdout.write(i.result.message+`
-`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function w(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=t=>{r(),x(S(e),t.response,`success`),n(0)},a=t=>{r(),x(S(e),t.response,`success`),n(0)},o=t=>{r(),x(S(e),``,`error`,t),n(1)};e.on(`complete`,i),e.on(`interrupted`,a),e.on(`error`,o),h(e,t).then(i=>{if(i.kind===`command-result`){r(),x(S(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function T(e,t){return new Promise(n=>{let r=_(e,S,x,n);h(e,t).then(i=>{if(i.kind===`command-result`){r(),x(S(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function E(e){let t=null,n=0;return{name:`headless`,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);n=await y({session:t,outputFormat:e.outputFormat}).run(e.prompt)},async stop(){},getExitCode(){return n}}}var D=class{opts;exitCode=0;constructor(e){this.opts=e}async run(e){let t=this.opts.shellExec??(e=>(0,u.execSync)(e,{timeout:5e3,encoding:`utf-8`,stdio:`pipe`}).trimEnd()),n=new d.InteractiveSession({cwd:this.opts.cwd,provider:this.opts.provider,permissionMode:this.opts.permissionMode??`bypassPermissions`,maxTurns:this.opts.maxTurns,sessionStore:this.opts.sessionStore,resumeSessionId:this.opts.resumeSessionId,forkSession:this.opts.forkSession,sessionName:this.opts.sessionName,bare:this.opts.bare||void 0,allowedTools:this.opts.allowedTools,deniedTools:this.opts.deniedTools,appendSystemPrompt:this.opts.appendSystemPrompt,...this.opts.persona===void 0?{}:{persona:this.opts.persona},...this.opts.systemPrompt?{systemPrompt:this.opts.systemPrompt}:{},backgroundTaskRunners:this.opts.backgroundTaskRunners,subagentRunnerFactory:this.opts.subagentRunnerFactory,commandModules:this.opts.commandModules,commandHostAdapters:this.opts.commandHostAdapters,shellExec:t,agentName:this.opts.agentName,...this.opts.activePresetId===void 0?{}:{activePresetId:this.opts.activePresetId},...this.opts.enableParallelSubagents===void 0?{}:{enableParallelSubagents:this.opts.enableParallelSubagents},...this.opts.selfVerification===void 0?{}:{selfVerification:this.opts.selfVerification}}),r=y({session:n,outputFormat:this.opts.outputFormat});this.exitCode=await r.run(e),await n.shutdown({reason:`prompt_input_exit`,message:`Headless transport complete`})}getExitCode(){return this.exitCode}};Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return D}});
+`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function T(e,t){return new Promise(n=>{let r=()=>{e.off(`complete`,i),e.off(`interrupted`,a),e.off(`error`,o)},i=t=>{r(),S(C(e),t.response,`success`),n(0)},a=t=>{r(),S(C(e),t.response,`success`),n(0)},o=t=>{r(),S(C(e),``,`error`,t),n(1)};e.on(`complete`,i),e.on(`interrupted`,a),e.on(`error`,o),h(e,t).then(i=>{if(i.kind===`command-result`){r(),S(C(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function E(e,t){return new Promise(n=>{let r=_(e,C,S,n);h(e,t).then(i=>{if(i.kind===`command-result`){r(),S(C(e),i.result.message,i.result.success?`success`:`error`),n(+!i.result.success);return}i.kind!==`session-execution`&&e.submit(t)})})}function D(e){let t=null,n=0;return{name:`headless`,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);n=await y({session:t,outputFormat:e.outputFormat}).run(e.prompt)},async stop(){},getExitCode(){return n}}}var O=class{opts;exitCode=0;constructor(e){this.opts=e}async run(e){let t=this.createSession(),n=y({session:t,outputFormat:this.opts.outputFormat});this.exitCode=await n.run(e),await t.shutdown({reason:`prompt_input_exit`,message:`Headless transport complete`})}async runGoal(e,t={}){let n=this.createSession(),r=y({session:n,outputFormat:this.opts.outputFormat});this.exitCode=await r.runGoal(e,t),await n.shutdown({reason:`prompt_input_exit`,message:`Headless goal complete`})}createSession(){let e=this.opts.shellExec??(e=>(0,u.execSync)(e,{timeout:5e3,encoding:`utf-8`,stdio:`pipe`}).trimEnd());return new d.InteractiveSession({cwd:this.opts.cwd,provider:this.opts.provider,permissionMode:this.opts.permissionMode??`bypassPermissions`,maxTurns:this.opts.maxTurns,sessionStore:this.opts.sessionStore,resumeSessionId:this.opts.resumeSessionId,forkSession:this.opts.forkSession,sessionName:this.opts.sessionName,bare:this.opts.bare||void 0,allowedTools:this.opts.allowedTools,deniedTools:this.opts.deniedTools,appendSystemPrompt:this.opts.appendSystemPrompt,...this.opts.persona===void 0?{}:{persona:this.opts.persona},...this.opts.systemPrompt?{systemPrompt:this.opts.systemPrompt}:{},backgroundTaskRunners:this.opts.backgroundTaskRunners,subagentRunnerFactory:this.opts.subagentRunnerFactory,commandModules:this.opts.commandModules,commandHostAdapters:this.opts.commandHostAdapters,shellExec:e,agentName:this.opts.agentName,...this.opts.activePresetId===void 0?{}:{activePresetId:this.opts.activePresetId},...this.opts.enableParallelSubagents===void 0?{}:{enableParallelSubagents:this.opts.enableParallelSubagents},...this.opts.selfVerification===void 0?{}:{selfVerification:this.opts.selfVerification}})}getExitCode(){return this.exitCode}};Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return O}});

package/dist/node/{index-E8Gx4-lc.d.ts → index-CrJ2Lhn3.d.ts}

@@ -1,6 +1,6 @@
-import { IAIProvider, ISpinner, ITerminalOutput, TPermissionMode } from "@robota-sdk/agent-core";
-import { IInteractiveSession, IInteractiveSessionStore, ITransportAdapter } from "@robota-sdk/agent-interface-transport";
 import { IBackgroundTaskRunner, ICommandHostAdapters, ICommandModule, TShellExecFn, TSubagentRunnerFactory } from "@robota-sdk/agent-framework";
+import { IInteractiveSession, IInteractiveSessionStore, ITransportAdapter } from "@robota-sdk/agent-interface-transport";
+import { IAIProvider, ISpinner, ITerminalOutput, TPermissionMode } from "@robota-sdk/agent-core";
 
 //#region src/headless/print-terminal.d.ts
 declare class PrintTerminal implements ITerminalOutput {
@@ -18,12 +18,17 @@ declare const promptInput: (label: string, masked?: boolean) => Promise<string>;
 //#endregion
 //#region src/headless/headless-runner.d.ts
 type TOutputFormat = 'text' | 'json' | 'stream-json';
+/** GOAL-001: options for an autonomous headless goal run. */
+interface IHeadlessGoalOptions {
+  maxIterations?: number;
+}
 interface IHeadlessRunnerOptions {
   session: IInteractiveSession;
   outputFormat: TOutputFormat;
 }
 declare function createHeadlessRunner(options: IHeadlessRunnerOptions): {
   run: (prompt: string) => Promise<number>;
+  runGoal: (objective: string, goalOptions?: IHeadlessGoalOptions) => Promise<number>;
 };
 //#endregion
 //#region src/headless/headless-transport.d.ts
@@ -76,8 +81,16 @@ declare class HeadlessInteractionChannel {
   private exitCode;
   constructor(options: IHeadlessInteractionChannelOptions);
   run(prompt: string): Promise<void>;
+  /**
+   * GOAL-001: run an autonomous goal to completion (or a stop condition) in headless mode.
+   * Mirrors {@link run} but drives the framework goal loop instead of a single prompt.
+   */
+  runGoal(objective: string, options?: {
+    maxIterations?: number;
+  }): Promise<void>;
+  private createSession;
   getExitCode(): number;
 }
 //#endregion
 export { IHeadlessRunnerOptions as a, promptInput as c, createHeadlessTransport as i, PrintTerminal as l, IHeadlessInteractionChannelOptions as n, TOutputFormat as o, IHeadlessTransportOptions as r, createHeadlessRunner as s, HeadlessInteractionChannel as t };
-//# sourceMappingURL=index-E8Gx4-lc.d.ts.map
+//# sourceMappingURL=index-CrJ2Lhn3.d.ts.map

package/dist/node/index-CrJ2Lhn3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CrJ2Lhn3.d.ts","names":[],"sources":["../../src/headless/print-terminal.ts","../../src/headless/cli-input.ts","../../src/headless/headless-runner.ts","../../src/headless/headless-transport.ts","../../src/headless/HeadlessInteractionChannel.ts"],"mappings":";;;;;cAYa,aAAA,YAAyB,eAAA;EACpC,KAAA,CAAM,IAAA;EAGN,SAAA,CAAU,IAAA;EAGV,aAAA,CAAc,EAAA;EAGd,UAAA,CAAW,IAAA;EAGX,MAAA,CAAO,QAAA,WAAmB,OAAA;EAcpB,MAAA,CAAO,OAAA,YAAmB,YAAA,YAAmB,OAAA;EAcnD,OAAA,CAAQ,QAAA,WAAmB,QAAA;AAAA;;;cCnDhB,WAAA,GAAe,KAAA,UAAe,MAAA,eAAiB,OAAO;;;KCMvD,aAAA;;UAGK,oBAAA;EACf,aAAa;AAAA;AAAA,UAGE,sBAAA;EACf,OAAA,EAAS,mBAAA;EACT,YAAA,EAAc,aAAa;AAAA;AAAA,iBAMb,oBAAA,CAAqB,OAAA,EAAS,sBAAA;EAC5C,GAAA,GAAM,MAAA,aAAmB,OAAA;EACzB,OAAA,GAAU,SAAA,UAAmB,WAAA,GAAc,oBAAA,KAAyB,OAAA;AAAA;;;UCbrD,yBAAA;EH2BoC;EGzBnD,YAAA,EAAc,aAAa;EHFS;EGIpC,MAAA;AAAA;AAAA,iBAGc,uBAAA,CACd,OAAA,EAAS,yBAAA,GACR,iBAAA,CAAkB,mBAAA;EAAyB,WAAA;AAAA;;;UCE7B,kCAAA;EACf,GAAA;EACA,QAAA,EAAU,WAAA;EACV,YAAA,EAAc,aAAA;EACd,cAAA,GAAiB,eAAA;EACjB,QAAA;EACA,YAAA,GAAe,wBAAA;EJbf;EIeA,eAAA;EJZA;EIcA,WAAA;EACA,WAAA;EACA,IAAA;EACA,YAAA;EACA,WAAA;EACA,kBAAA;EACA,YAAA;EJAa;EIEb,SAAA;EJFmD;EIInD,cAAA;EJUQ;EIRR,OAAA;EJQmC;EINnC,uBAAA;;EAEA,gBAAA;EACA,qBAAA,GAAwB,qBAAA;EACxB,qBAAA,GAAwB,sBAAA;EACxB,cAAA,YAA0B,cAAA;EAC1B,mBAAA,GAAsB,oBAAA;EACtB,SAAA,GAAY,YAAA;AAAA;AAAA,cAGD,0BAAA;EAAA,iBACM,IAAA;EAAA,QACT,QAAA;cAEI,OAAA,EAAS,kCAAA;EAIf,GAAA,CAAI,MAAA,WAAiB,OAAA;;;AFzD7B;;EEoEQ,OAAA,CAAQ,SAAA,UAAmB,OAAA;IAAW,aAAA;EAAA,IAAgC,OAAA;EAAA,QAOpE,aAAA;EA0CR,WAAA;AAAA"}

package/dist/node/index-JIvzrtaA.d.ts

@@ -0,0 +1,52 @@
+import { ICommandModule } from "@robota-sdk/agent-framework";
+import { IAgentDriver, ICommandInfo, IInteractionChannel, IInteractiveSessionStore, InteractionEvent } from "@robota-sdk/agent-interface-transport";
+import { IAIProvider, IActionRequest, TActionResponse, TPermissionMode } from "@robota-sdk/agent-core";
+
+//#region src/programmatic/ProgrammaticInteractionChannel.d.ts
+declare class ProgrammaticInteractionChannel implements IInteractionChannel {
+  /** Full structured event stream pushed by the framework, in order. */
+  readonly events: InteractionEvent[];
+  availableCommands: ICommandInfo[];
+  busy: boolean;
+  started: boolean;
+  stopped: boolean;
+  private submitHandler;
+  private readonly userActionResponses;
+  onSubmit(handler: (text: string) => Promise<void>): void;
+  write(event: InteractionEvent): void;
+  /**
+   * CMD-004 unified ask. Resolves from the pre-supplied queue (FIFO); an empty queue resolves
+   * `{ type: 'cancelled' }` so a programmatic run never blocks on an un-answered question.
+   */
+  askUser(_request: IActionRequest): Promise<TActionResponse>;
+  setAvailableCommands(commands: ICommandInfo[]): void;
+  setBusy(busy: boolean): void;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  /** Push a user submission into the framework (the programmatic "user types and presses enter"). */
+  submit(text: string): Promise<void>;
+  /** Pre-answer the next `askUser` (CMD-004 unified ask). */
+  queueUserAction(response: TActionResponse): void;
+}
+//#endregion
+//#region src/programmatic/createProgrammaticAgent.d.ts
+interface ICreateProgrammaticAgentOptions {
+  /** Provider that answers the agent loop (e.g. a real provider, or the scripted provider in tests). */
+  provider: IAIProvider;
+  /** Working directory for session creation. */
+  cwd: string;
+  /** Slash-command modules to register (defaults to none). */
+  commandModules?: readonly ICommandModule[];
+  /** Optional session store for persistence. */
+  sessionStore?: IInteractiveSessionStore;
+  /** Permission mode for tool execution (e.g. `'bypassPermissions'` for unattended driving). */
+  permissionMode?: TPermissionMode;
+}
+/**
+ * Construct an in-process {@link IAgentDriver} bound to a real `InteractiveSession`. The returned
+ * driver's accessors are the shared `read*` helpers applied to the captured event stream.
+ */
+declare function createProgrammaticAgent(options: ICreateProgrammaticAgentOptions): IAgentDriver;
+//#endregion
+export { createProgrammaticAgent as n, ProgrammaticInteractionChannel as r, ICreateProgrammaticAgentOptions as t };
+//# sourceMappingURL=index-JIvzrtaA.d.ts.map

package/dist/node/index-JIvzrtaA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-JIvzrtaA.d.ts","names":[],"sources":["../../src/programmatic/ProgrammaticInteractionChannel.ts","../../src/programmatic/createProgrammaticAgent.ts"],"mappings":";;;;;cAmBa,8BAAA,YAA0C,mBAAA;EA0BZ;EAAA,SAxBhC,MAAA,EAAQ,gBAAA;EAEjB,iBAAA,EAAmB,YAAA;EACnB,IAAA;EACA,OAAA;EACA,OAAA;EAAA,QAEQ,aAAA;EAAA,iBACS,mBAAA;EAIjB,QAAA,CAAS,OAAA,GAAU,IAAA,aAAiB,OAAA;EAIpC,KAAA,CAAM,KAAA,EAAO,gBAAA;EAhBJ;;;;EAwBH,OAAA,CAAQ,QAAA,EAAU,cAAA,GAAiB,OAAA,CAAQ,eAAA;EAIjD,oBAAA,CAAqB,QAAA,EAAU,YAAA;EAI/B,OAAA,CAAQ,IAAA;EAIF,KAAA,IAAS,OAAA;EAIT,IAAA,IAAQ,OAAA;EA5Bd;EAmCM,MAAA,CAAO,IAAA,WAAe,OAAA;EAnCQ;EA6CpC,eAAA,CAAgB,QAAA,EAAU,eAAA;AAAA;;;UCrDX,+BAAA;EDoB0B;EClBzC,QAAA,EAAU,WAAA;ED8BK;EC5Bf,GAAA;EDuC4B;ECrC5B,cAAA,YAA0B,cAAA;EDZ2B;ECcrD,YAAA,GAAe,wBAAA;EDdyD;ECgBxE,cAAA,GAAiB,eAAA;AAAA;;;;;iBAOH,uBAAA,CAAwB,OAAA,EAAS,+BAAA,GAAkC,YAAY"}

package/dist/node/{index-CYl7ksS6.d.ts → index-JTD_xtEQ.d.ts}

@@ -1,6 +1,6 @@
-import { IBackgroundTaskRunner, ICommandHostAdapters, ICommandModule, TShellExecFn, TSubagentRunnerFactory } from "@robota-sdk/agent-framework";
 import { IAIProvider, ISpinner, ITerminalOutput, TPermissionMode } from "@robota-sdk/agent-core";
 import { IInteractiveSession, IInteractiveSessionStore, ITransportAdapter } from "@robota-sdk/agent-interface-transport";
+import { IBackgroundTaskRunner, ICommandHostAdapters, ICommandModule, TShellExecFn, TSubagentRunnerFactory } from "@robota-sdk/agent-framework";
 
 //#region src/headless/print-terminal.d.ts
 declare class PrintTerminal implements ITerminalOutput {
@@ -18,12 +18,17 @@ declare const promptInput: (label: string, masked?: boolean) => Promise<string>;
 //#endregion
 //#region src/headless/headless-runner.d.ts
 type TOutputFormat = 'text' | 'json' | 'stream-json';
+/** GOAL-001: options for an autonomous headless goal run. */
+interface IHeadlessGoalOptions {
+  maxIterations?: number;
+}
 interface IHeadlessRunnerOptions {
   session: IInteractiveSession;
   outputFormat: TOutputFormat;
 }
 declare function createHeadlessRunner(options: IHeadlessRunnerOptions): {
   run: (prompt: string) => Promise<number>;
+  runGoal: (objective: string, goalOptions?: IHeadlessGoalOptions) => Promise<number>;
 };
 //#endregion
 //#region src/headless/headless-transport.d.ts
@@ -76,8 +81,16 @@ declare class HeadlessInteractionChannel {
   private exitCode;
   constructor(options: IHeadlessInteractionChannelOptions);
   run(prompt: string): Promise<void>;
+  /**
+   * GOAL-001: run an autonomous goal to completion (or a stop condition) in headless mode.
+   * Mirrors {@link run} but drives the framework goal loop instead of a single prompt.
+   */
+  runGoal(objective: string, options?: {
+    maxIterations?: number;
+  }): Promise<void>;
+  private createSession;
   getExitCode(): number;
 }
 //#endregion
 export { IHeadlessRunnerOptions as a, promptInput as c, createHeadlessTransport as i, PrintTerminal as l, IHeadlessInteractionChannelOptions as n, TOutputFormat as o, IHeadlessTransportOptions as r, createHeadlessRunner as s, HeadlessInteractionChannel as t };
-//# sourceMappingURL=index-CYl7ksS6.d.ts.map
+//# sourceMappingURL=index-JTD_xtEQ.d.ts.map

package/dist/node/index-JTD_xtEQ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-JTD_xtEQ.d.ts","names":[],"sources":["../../src/headless/print-terminal.ts","../../src/headless/cli-input.ts","../../src/headless/headless-runner.ts","../../src/headless/headless-transport.ts","../../src/headless/HeadlessInteractionChannel.ts"],"mappings":";;;;;cAYa,aAAA,YAAyB,eAAA;EACpC,KAAA,CAAM,IAAA;EAGN,SAAA,CAAU,IAAA;EAGV,aAAA,CAAc,EAAA;EAGd,UAAA,CAAW,IAAA;EAGX,MAAA,CAAO,QAAA,WAAmB,OAAA;EAcpB,MAAA,CAAO,OAAA,YAAmB,YAAA,YAAmB,OAAA;EAcnD,OAAA,CAAQ,QAAA,WAAmB,QAAA;AAAA;;;cCnDhB,WAAA,GAAe,KAAA,UAAe,MAAA,eAAiB,OAAO;;;KCMvD,aAAA;;UAGK,oBAAA;EACf,aAAa;AAAA;AAAA,UAGE,sBAAA;EACf,OAAA,EAAS,mBAAA;EACT,YAAA,EAAc,aAAa;AAAA;AAAA,iBAMb,oBAAA,CAAqB,OAAA,EAAS,sBAAA;EAC5C,GAAA,GAAM,MAAA,aAAmB,OAAA;EACzB,OAAA,GAAU,SAAA,UAAmB,WAAA,GAAc,oBAAA,KAAyB,OAAA;AAAA;;;UCbrD,yBAAA;EH2BoC;EGzBnD,YAAA,EAAc,aAAa;EHFS;EGIpC,MAAA;AAAA;AAAA,iBAGc,uBAAA,CACd,OAAA,EAAS,yBAAA,GACR,iBAAA,CAAkB,mBAAA;EAAyB,WAAA;AAAA;;;UCE7B,kCAAA;EACf,GAAA;EACA,QAAA,EAAU,WAAA;EACV,YAAA,EAAc,aAAA;EACd,cAAA,GAAiB,eAAA;EACjB,QAAA;EACA,YAAA,GAAe,wBAAA;EJbf;EIeA,eAAA;EJZA;EIcA,WAAA;EACA,WAAA;EACA,IAAA;EACA,YAAA;EACA,WAAA;EACA,kBAAA;EACA,YAAA;EJAa;EIEb,SAAA;EJFmD;EIInD,cAAA;EJUQ;EIRR,OAAA;EJQmC;EINnC,uBAAA;;EAEA,gBAAA;EACA,qBAAA,GAAwB,qBAAA;EACxB,qBAAA,GAAwB,sBAAA;EACxB,cAAA,YAA0B,cAAA;EAC1B,mBAAA,GAAsB,oBAAA;EACtB,SAAA,GAAY,YAAA;AAAA;AAAA,cAGD,0BAAA;EAAA,iBACM,IAAA;EAAA,QACT,QAAA;cAEI,OAAA,EAAS,kCAAA;EAIf,GAAA,CAAI,MAAA,WAAiB,OAAA;;;AFzD7B;;EEoEQ,OAAA,CAAQ,SAAA,UAAmB,OAAA;IAAW,aAAA;EAAA,IAAgC,OAAA;EAAA,QAOpE,aAAA;EA0CR,WAAA;AAAA"}

package/dist/node/index-y_HBOfzO.d.ts

@@ -0,0 +1,52 @@
+import { IAIProvider, IActionRequest, TActionResponse, TPermissionMode } from "@robota-sdk/agent-core";
+import { IAgentDriver, ICommandInfo, IInteractionChannel, IInteractiveSessionStore, InteractionEvent } from "@robota-sdk/agent-interface-transport";
+import { ICommandModule } from "@robota-sdk/agent-framework";
+
+//#region src/programmatic/ProgrammaticInteractionChannel.d.ts
+declare class ProgrammaticInteractionChannel implements IInteractionChannel {
+  /** Full structured event stream pushed by the framework, in order. */
+  readonly events: InteractionEvent[];
+  availableCommands: ICommandInfo[];
+  busy: boolean;
+  started: boolean;
+  stopped: boolean;
+  private submitHandler;
+  private readonly userActionResponses;
+  onSubmit(handler: (text: string) => Promise<void>): void;
+  write(event: InteractionEvent): void;
+  /**
+   * CMD-004 unified ask. Resolves from the pre-supplied queue (FIFO); an empty queue resolves
+   * `{ type: 'cancelled' }` so a programmatic run never blocks on an un-answered question.
+   */
+  askUser(_request: IActionRequest): Promise<TActionResponse>;
+  setAvailableCommands(commands: ICommandInfo[]): void;
+  setBusy(busy: boolean): void;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  /** Push a user submission into the framework (the programmatic "user types and presses enter"). */
+  submit(text: string): Promise<void>;
+  /** Pre-answer the next `askUser` (CMD-004 unified ask). */
+  queueUserAction(response: TActionResponse): void;
+}
+//#endregion
+//#region src/programmatic/createProgrammaticAgent.d.ts
+interface ICreateProgrammaticAgentOptions {
+  /** Provider that answers the agent loop (e.g. a real provider, or the scripted provider in tests). */
+  provider: IAIProvider;
+  /** Working directory for session creation. */
+  cwd: string;
+  /** Slash-command modules to register (defaults to none). */
+  commandModules?: readonly ICommandModule[];
+  /** Optional session store for persistence. */
+  sessionStore?: IInteractiveSessionStore;
+  /** Permission mode for tool execution (e.g. `'bypassPermissions'` for unattended driving). */
+  permissionMode?: TPermissionMode;
+}
+/**
+ * Construct an in-process {@link IAgentDriver} bound to a real `InteractiveSession`. The returned
+ * driver's accessors are the shared `read*` helpers applied to the captured event stream.
+ */
+declare function createProgrammaticAgent(options: ICreateProgrammaticAgentOptions): IAgentDriver;
+//#endregion
+export { createProgrammaticAgent as n, ProgrammaticInteractionChannel as r, ICreateProgrammaticAgentOptions as t };
+//# sourceMappingURL=index-y_HBOfzO.d.ts.map

package/dist/node/index-y_HBOfzO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-y_HBOfzO.d.ts","names":[],"sources":["../../src/programmatic/ProgrammaticInteractionChannel.ts","../../src/programmatic/createProgrammaticAgent.ts"],"mappings":";;;;;cAmBa,8BAAA,YAA0C,mBAAA;EA0BZ;EAAA,SAxBhC,MAAA,EAAQ,gBAAA;EAEjB,iBAAA,EAAmB,YAAA;EACnB,IAAA;EACA,OAAA;EACA,OAAA;EAAA,QAEQ,aAAA;EAAA,iBACS,mBAAA;EAIjB,QAAA,CAAS,OAAA,GAAU,IAAA,aAAiB,OAAA;EAIpC,KAAA,CAAM,KAAA,EAAO,gBAAA;EAhBJ;;;;EAwBH,OAAA,CAAQ,QAAA,EAAU,cAAA,GAAiB,OAAA,CAAQ,eAAA;EAIjD,oBAAA,CAAqB,QAAA,EAAU,YAAA;EAI/B,OAAA,CAAQ,IAAA;EAIF,KAAA,IAAS,OAAA;EAIT,IAAA,IAAQ,OAAA;EA5Bd;EAmCM,MAAA,CAAO,IAAA,WAAe,OAAA;EAnCQ;EA6CpC,eAAA,CAAgB,QAAA,EAAU,eAAA;AAAA;;;UCrDX,+BAAA;EDoB0B;EClBzC,QAAA,EAAU,WAAA;ED8BK;EC5Bf,GAAA;EDuC4B;ECrC5B,cAAA,YAA0B,cAAA;EDZ2B;ECcrD,YAAA,GAAe,wBAAA;EDdyD;ECgBxE,cAAA,GAAiB,eAAA;AAAA;;;;;iBAOH,uBAAA,CAAwB,OAAA,EAAS,+BAAA,GAAkC,YAAY"}

package/dist/node/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./headless-OnpVk4-k.cjs");let t=require("@robota-sdk/agent-framework");var n=class{entries=new Map;settingsPath;constructor(e){this.settingsPath=e}register(e){this.entries.set(e.name,e)}getAll(){let e=this.readTransportSettings();return Array.from(this.entries.values()).map(t=>({transport:t,config:this.resolveConfig(t,e[t.name])}))}getEnabled(){return this.getAll().filter(e=>e.config.enabled).map(e=>e.transport)}async setEnabled(e,n){let r=(0,t.readSettings)(this.settingsPath),i=r.transports??{};i[e]={...i[e]??{},enabled:n},r.transports=i,(0,t.writeSettings)(this.settingsPath,r)}async setOptions(e,n){let r=(0,t.readSettings)(this.settingsPath),i=r.transports??{};i[e]={...i[e]??{},options:n},r.transports=i,(0,t.writeSettings)(this.settingsPath,r)}async startAll(e){let t=this.getEnabled();for(let n of t)n.attach(e),await n.start()}async stopAll(){for(let e of this.entries.values())await e.stop()}resolveConfig(e,t){return{enabled:t?.enabled??e.defaultEnabled,options:t?.options??{}}}readTransportSettings(){let e=(0,t.readSettings)(this.settingsPath).transports;return!e||typeof e!=`object`||Array.isArray(e)?{}:e}};exports.HeadlessInteractionChannel=e.t,exports.PrintTerminal=e.a,exports.TransportRegistry=n,exports.createHeadlessRunner=e.r,exports.createHeadlessTransport=e.n,exports.promptInput=e.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./headless-xq77JBq0.cjs"),t=require("./programmatic-6wLf68qJ.cjs");let n=require("@robota-sdk/agent-framework");var r=class{entries=new Map;settingsPath;constructor(e){this.settingsPath=e}register(e){this.entries.set(e.name,e)}getAll(){let e=this.readTransportSettings();return Array.from(this.entries.values()).map(t=>({transport:t,config:this.resolveConfig(t,e[t.name])}))}getEnabled(){return this.getAll().filter(e=>e.config.enabled).map(e=>e.transport)}async setEnabled(e,t){let r=(0,n.readSettings)(this.settingsPath),i=r.transports??{};i[e]={...i[e]??{},enabled:t},r.transports=i,(0,n.writeSettings)(this.settingsPath,r)}async setOptions(e,t){let r=(0,n.readSettings)(this.settingsPath),i=r.transports??{};i[e]={...i[e]??{},options:t},r.transports=i,(0,n.writeSettings)(this.settingsPath,r)}async startAll(e){let t=this.getEnabled();for(let n of t)n.attach(e),await n.start()}async stopAll(){let e=[];for(let t of this.entries.values())try{await t.stop()}catch(t){e.push(t instanceof Error?t:Error(String(t)))}return{errors:e}}resolveConfig(e,t){return{enabled:t?.enabled??e.defaultEnabled,options:t?.options??{}}}readTransportSettings(){let e=(0,n.readSettings)(this.settingsPath).transports;return!e||typeof e!=`object`||Array.isArray(e)?{}:e}};exports.HeadlessInteractionChannel=e.t,exports.PrintTerminal=e.a,exports.ProgrammaticInteractionChannel=t.n,exports.TransportRegistry=r,exports.createHeadlessRunner=e.r,exports.createHeadlessTransport=e.n,exports.createProgrammaticAgent=t.t,exports.promptInput=e.i;

package/dist/node/index.d.ts

@@ -1,5 +1,6 @@
-import { a as IHeadlessRunnerOptions, c as promptInput, i as createHeadlessTransport, l as PrintTerminal, n as IHeadlessInteractionChannelOptions, o as TOutputFormat, r as IHeadlessTransportOptions, s as createHeadlessRunner, t as HeadlessInteractionChannel } from "./index-E8Gx4-lc.js";
-import { TUniversalValue } from "@robota-sdk/agent-core";
+import { a as IHeadlessRunnerOptions, c as promptInput, i as createHeadlessTransport, l as PrintTerminal, n as IHeadlessInteractionChannelOptions, o as TOutputFormat, r as IHeadlessTransportOptions, s as createHeadlessRunner, t as HeadlessInteractionChannel } from "./index-JTD_xtEQ.js";
+import { n as createProgrammaticAgent, r as ProgrammaticInteractionChannel, t as ICreateProgrammaticAgentOptions } from "./index-y_HBOfzO.js";
+import { IDestroyResult, TUniversalValue } from "@robota-sdk/agent-core";
 import { IConfigurableTransport, IInteractiveSession, ITransportEntry } from "@robota-sdk/agent-interface-transport";
 
 //#region src/transport-registry.d.ts
@@ -13,10 +14,15 @@ declare class TransportRegistry {
   setEnabled(name: string, enabled: boolean): Promise<void>;
   setOptions(name: string, options: Record<string, TUniversalValue>): Promise<void>;
   startAll(session: IInteractiveSession): Promise<void>;
-  stopAll(): Promise<void>;
+  /**
+   * Stop every registered transport — **best-effort** (CORE-013 disposal convention): one
+   * transport's stop failure must not skip the others or reject a fire-and-forget caller.
+   * Failures are collected into the returned result.
+   */
+  stopAll(): Promise<IDestroyResult>;
   private resolveConfig;
   private readTransportSettings;
 }
 //#endregion
-export { HeadlessInteractionChannel, type IHeadlessInteractionChannelOptions, type IHeadlessRunnerOptions, type IHeadlessTransportOptions, PrintTerminal, type TOutputFormat, TransportRegistry, createHeadlessRunner, createHeadlessTransport, promptInput };
+export { HeadlessInteractionChannel, type ICreateProgrammaticAgentOptions, type IHeadlessInteractionChannelOptions, type IHeadlessRunnerOptions, type IHeadlessTransportOptions, PrintTerminal, ProgrammaticInteractionChannel, type TOutputFormat, TransportRegistry, createHeadlessRunner, createHeadlessTransport, createProgrammaticAgent, promptInput };
 //# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/transport-registry.ts"],"mappings":";;;;;cAiBa,iBAAA;EAAA,iBACM,OAAA;EAAA,iBACA,YAAA;cAEL,YAAA;EAIZ,QAAA,CAAS,SAAA,EAAW,sBAAA,CAAuB,mBAAA;EAI3C,MAAA,IAAU,eAAA,CAAgB,mBAAA;EAQ1B,UAAA,IAAc,sBAAA,CAAuB,mBAAA;EAM/B,UAAA,CAAW,IAAA,UAAc,OAAA,YAAmB,OAAA;EAS5C,UAAA,CAAW,IAAA,UAAc,OAAA,EAAS,MAAA,SAAe,eAAA,IAAmB,OAAA;EASpE,QAAA,CAAS,OAAA,EAAS,mBAAA,GAAsB,OAAA;EAQxC,OAAA,IAAW,OAAA;EAAA,QAMT,aAAA;EAAA,QASA,qBAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/transport-registry.ts"],"mappings":";;;;;;cAiBa,iBAAA;EAAA,iBACM,OAAA;EAAA,iBACA,YAAA;cAEL,YAAA;EAIZ,QAAA,CAAS,SAAA,EAAW,sBAAA,CAAuB,mBAAA;EAI3C,MAAA,IAAU,eAAA,CAAgB,mBAAA;EAQ1B,UAAA,IAAc,sBAAA,CAAuB,mBAAA;EAM/B,UAAA,CAAW,IAAA,UAAc,OAAA,YAAmB,OAAA;EAS5C,UAAA,CAAW,IAAA,UAAc,OAAA,EAAS,MAAA,SAAe,eAAA,IAAmB,OAAA;EASpE,QAAA,CAAS,OAAA,EAAS,mBAAA,GAAsB,OAAA;EAT4B;;;;;EAsBpE,OAAA,IAAW,OAAA,CAAQ,cAAA;EAAA,QAajB,aAAA;EAAA,QASA,qBAAA;AAAA"}

package/dist/node/index.js

@@ -1,2 +1,2 @@
-import{a as e,i as t,n,r,t as i}from"./headless-mRYilLfC.js";import{readSettings as a,writeSettings as o}from"@robota-sdk/agent-framework";var s=class{entries=new Map;settingsPath;constructor(e){this.settingsPath=e}register(e){this.entries.set(e.name,e)}getAll(){let e=this.readTransportSettings();return Array.from(this.entries.values()).map(t=>({transport:t,config:this.resolveConfig(t,e[t.name])}))}getEnabled(){return this.getAll().filter(e=>e.config.enabled).map(e=>e.transport)}async setEnabled(e,t){let n=a(this.settingsPath),r=n.transports??{};r[e]={...r[e]??{},enabled:t},n.transports=r,o(this.settingsPath,n)}async setOptions(e,t){let n=a(this.settingsPath),r=n.transports??{};r[e]={...r[e]??{},options:t},n.transports=r,o(this.settingsPath,n)}async startAll(e){let t=this.getEnabled();for(let n of t)n.attach(e),await n.start()}async stopAll(){for(let e of this.entries.values())await e.stop()}resolveConfig(e,t){return{enabled:t?.enabled??e.defaultEnabled,options:t?.options??{}}}readTransportSettings(){let e=a(this.settingsPath).transports;return!e||typeof e!=`object`||Array.isArray(e)?{}:e}};export{i as HeadlessInteractionChannel,e as PrintTerminal,s as TransportRegistry,r as createHeadlessRunner,n as createHeadlessTransport,t as promptInput};
+import{a as e,i as t,n,r,t as i}from"./headless-DG_MEbf0.js";import{n as a,t as o}from"./programmatic-70dxIXtS.js";import{readSettings as s,writeSettings as c}from"@robota-sdk/agent-framework";var l=class{entries=new Map;settingsPath;constructor(e){this.settingsPath=e}register(e){this.entries.set(e.name,e)}getAll(){let e=this.readTransportSettings();return Array.from(this.entries.values()).map(t=>({transport:t,config:this.resolveConfig(t,e[t.name])}))}getEnabled(){return this.getAll().filter(e=>e.config.enabled).map(e=>e.transport)}async setEnabled(e,t){let n=s(this.settingsPath),r=n.transports??{};r[e]={...r[e]??{},enabled:t},n.transports=r,c(this.settingsPath,n)}async setOptions(e,t){let n=s(this.settingsPath),r=n.transports??{};r[e]={...r[e]??{},options:t},n.transports=r,c(this.settingsPath,n)}async startAll(e){let t=this.getEnabled();for(let n of t)n.attach(e),await n.start()}async stopAll(){let e=[];for(let t of this.entries.values())try{await t.stop()}catch(t){e.push(t instanceof Error?t:Error(String(t)))}return{errors:e}}resolveConfig(e,t){return{enabled:t?.enabled??e.defaultEnabled,options:t?.options??{}}}readTransportSettings(){let e=s(this.settingsPath).transports;return!e||typeof e!=`object`||Array.isArray(e)?{}:e}};export{i as HeadlessInteractionChannel,e as PrintTerminal,a as ProgrammaticInteractionChannel,l as TransportRegistry,r as createHeadlessRunner,n as createHeadlessTransport,o as createProgrammaticAgent,t as promptInput};
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/transport-registry.ts"],"sourcesContent":["/**\n * TransportRegistry — manages IConfigurableTransport instances with settings-backed enable/disable.\n *\n * Settings file shape (under `transports` key in settings.json):\n *   { \"ws\": { \"enabled\": true, \"options\": { \"port\": 7070 } } }\n */\n\nimport { readSettings, writeSettings, type TSettingsData } from '@robota-sdk/agent-framework';\n\nimport type { TUniversalValue } from '@robota-sdk/agent-core';\nimport type {\n  IConfigurableTransport,\n  IInteractiveSession,\n  ITransportConfig,\n  ITransportEntry,\n} from '@robota-sdk/agent-interface-transport';\n\nexport class TransportRegistry {\n  private readonly entries = new Map<string, IConfigurableTransport<IInteractiveSession>>();\n  private readonly settingsPath: string;\n\n  constructor(settingsPath: string) {\n    this.settingsPath = settingsPath;\n  }\n\n  register(transport: IConfigurableTransport<IInteractiveSession>): void {\n    this.entries.set(transport.name, transport);\n  }\n\n  getAll(): ITransportEntry<IInteractiveSession>[] {\n    const saved = this.readTransportSettings();\n    return Array.from(this.entries.values()).map((transport) => ({\n      transport,\n      config: this.resolveConfig(transport, saved[transport.name]),\n    }));\n  }\n\n  getEnabled(): IConfigurableTransport<IInteractiveSession>[] {\n    return this.getAll()\n      .filter((e) => e.config.enabled)\n      .map((e) => e.transport);\n  }\n\n  async setEnabled(name: string, enabled: boolean): Promise<void> {\n    const settings = readSettings(this.settingsPath);\n    const transports = (settings.transports ?? {}) as TSettingsData;\n    const entry = (transports[name] ?? {}) as TSettingsData;\n    transports[name] = { ...entry, enabled } as TSettingsData;\n    settings.transports = transports;\n    writeSettings(this.settingsPath, settings);\n  }\n\n  async setOptions(name: string, options: Record<string, TUniversalValue>): Promise<void> {\n    const settings = readSettings(this.settingsPath);\n    const transports = (settings.transports ?? {}) as TSettingsData;\n    const entry = (transports[name] ?? {}) as TSettingsData;\n    transports[name] = { ...entry, options: options as TSettingsData } as TSettingsData;\n    settings.transports = transports;\n    writeSettings(this.settingsPath, settings);\n  }\n\n  async startAll(session: IInteractiveSession): Promise<void> {\n    const enabled = this.getEnabled();\n    for (const transport of enabled) {\n      transport.attach(session);\n      await transport.start();\n    }\n  }\n\n  async stopAll(): Promise<void> {\n    for (const transport of this.entries.values()) {\n      await transport.stop();\n    }\n  }\n\n  private resolveConfig(\n    transport: IConfigurableTransport<IInteractiveSession>,\n    saved?: TSettingsData,\n  ): ITransportConfig {\n    const enabled = (saved?.enabled as boolean | undefined) ?? transport.defaultEnabled;\n    const options = (saved?.options as Record<string, TUniversalValue> | undefined) ?? {};\n    return { enabled, options };\n  }\n\n  private readTransportSettings(): Record<string, TSettingsData> {\n    const settings = readSettings(this.settingsPath);\n    const raw = settings.transports;\n    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return {};\n    return raw as Record<string, TSettingsData>;\n  }\n}\n"],"mappings":"2IAiBA,IAAa,EAAb,KAA+B,CAC7B,QAA2B,IAAI,IAC/B,aAEA,YAAY,EAAsB,CAChC,KAAK,aAAe,CACtB,CAEA,SAAS,EAA8D,CACrE,KAAK,QAAQ,IAAI,EAAU,KAAM,CAAS,CAC5C,CAEA,QAAiD,CAC/C,IAAM,EAAQ,KAAK,sBAAsB,EACzC,OAAO,MAAM,KAAK,KAAK,QAAQ,OAAO,CAAC,CAAC,CAAC,IAAK,IAAe,CAC3D,YACA,OAAQ,KAAK,cAAc,EAAW,EAAM,EAAU,KAAK,CAC7D,EAAE,CACJ,CAEA,YAA4D,CAC1D,OAAO,KAAK,OAAO,CAAC,CACjB,OAAQ,GAAM,EAAE,OAAO,OAAO,CAAC,CAC/B,IAAK,GAAM,EAAE,SAAS,CAC3B,CAEA,MAAM,WAAW,EAAc,EAAiC,CAC9D,IAAM,EAAW,EAAa,KAAK,YAAY,EACzC,EAAc,EAAS,YAAc,CAAC,EAE5C,EAAW,GAAQ,CAAE,GADN,EAAW,IAAS,CAAC,EACL,SAAQ,EACvC,EAAS,WAAa,EACtB,EAAc,KAAK,aAAc,CAAQ,CAC3C,CAEA,MAAM,WAAW,EAAc,EAAyD,CACtF,IAAM,EAAW,EAAa,KAAK,YAAY,EACzC,EAAc,EAAS,YAAc,CAAC,EAE5C,EAAW,GAAQ,CAAE,GADN,EAAW,IAAS,CAAC,EACI,SAAyB,EACjE,EAAS,WAAa,EACtB,EAAc,KAAK,aAAc,CAAQ,CAC3C,CAEA,MAAM,SAAS,EAA6C,CAC1D,IAAM,EAAU,KAAK,WAAW,EAChC,IAAK,IAAM,KAAa,EACtB,EAAU,OAAO,CAAO,EACxB,MAAM,EAAU,MAAM,CAE1B,CAEA,MAAM,SAAyB,CAC7B,IAAK,IAAM,KAAa,KAAK,QAAQ,OAAO,EAC1C,MAAM,EAAU,KAAK,CAEzB,CAEA,cACE,EACA,EACkB,CAGlB,MAAO,CAAE,QAFQ,GAAO,SAAmC,EAAU,eAEnD,QADD,GAAO,SAA2D,CAAC,CAC1D,CAC5B,CAEA,uBAA+D,CAE7D,IAAM,EADW,EAAa,KAAK,YAChB,CAAC,CAAC,WAErB,MADI,CAAC,GAAO,OAAO,GAAQ,UAAY,MAAM,QAAQ,CAAG,EAAU,CAAC,EAC5D,CACT,CACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/transport-registry.ts"],"sourcesContent":["/**\n * TransportRegistry — manages IConfigurableTransport instances with settings-backed enable/disable.\n *\n * Settings file shape (under `transports` key in settings.json):\n *   { \"ws\": { \"enabled\": true, \"options\": { \"port\": 7070 } } }\n */\n\nimport { readSettings, writeSettings, type TSettingsData } from '@robota-sdk/agent-framework';\n\nimport type { IDestroyResult, TUniversalValue } from '@robota-sdk/agent-core';\nimport type {\n  IConfigurableTransport,\n  IInteractiveSession,\n  ITransportConfig,\n  ITransportEntry,\n} from '@robota-sdk/agent-interface-transport';\n\nexport class TransportRegistry {\n  private readonly entries = new Map<string, IConfigurableTransport<IInteractiveSession>>();\n  private readonly settingsPath: string;\n\n  constructor(settingsPath: string) {\n    this.settingsPath = settingsPath;\n  }\n\n  register(transport: IConfigurableTransport<IInteractiveSession>): void {\n    this.entries.set(transport.name, transport);\n  }\n\n  getAll(): ITransportEntry<IInteractiveSession>[] {\n    const saved = this.readTransportSettings();\n    return Array.from(this.entries.values()).map((transport) => ({\n      transport,\n      config: this.resolveConfig(transport, saved[transport.name]),\n    }));\n  }\n\n  getEnabled(): IConfigurableTransport<IInteractiveSession>[] {\n    return this.getAll()\n      .filter((e) => e.config.enabled)\n      .map((e) => e.transport);\n  }\n\n  async setEnabled(name: string, enabled: boolean): Promise<void> {\n    const settings = readSettings(this.settingsPath);\n    const transports = (settings.transports ?? {}) as TSettingsData;\n    const entry = (transports[name] ?? {}) as TSettingsData;\n    transports[name] = { ...entry, enabled } as TSettingsData;\n    settings.transports = transports;\n    writeSettings(this.settingsPath, settings);\n  }\n\n  async setOptions(name: string, options: Record<string, TUniversalValue>): Promise<void> {\n    const settings = readSettings(this.settingsPath);\n    const transports = (settings.transports ?? {}) as TSettingsData;\n    const entry = (transports[name] ?? {}) as TSettingsData;\n    transports[name] = { ...entry, options: options as TSettingsData } as TSettingsData;\n    settings.transports = transports;\n    writeSettings(this.settingsPath, settings);\n  }\n\n  async startAll(session: IInteractiveSession): Promise<void> {\n    const enabled = this.getEnabled();\n    for (const transport of enabled) {\n      transport.attach(session);\n      await transport.start();\n    }\n  }\n\n  /**\n   * Stop every registered transport — **best-effort** (CORE-013 disposal convention): one\n   * transport's stop failure must not skip the others or reject a fire-and-forget caller.\n   * Failures are collected into the returned result.\n   */\n  async stopAll(): Promise<IDestroyResult> {\n    const errors: Error[] = [];\n    for (const transport of this.entries.values()) {\n      try {\n        await transport.stop();\n      } catch (error) {\n        // allow-fallback: best-effort disposal IS the contract — the failure is collected into the returned result and the remaining transports still stop (CORE-013 convention)\n        errors.push(error instanceof Error ? error : new Error(String(error)));\n      }\n    }\n    return { errors };\n  }\n\n  private resolveConfig(\n    transport: IConfigurableTransport<IInteractiveSession>,\n    saved?: TSettingsData,\n  ): ITransportConfig {\n    const enabled = (saved?.enabled as boolean | undefined) ?? transport.defaultEnabled;\n    const options = (saved?.options as Record<string, TUniversalValue> | undefined) ?? {};\n    return { enabled, options };\n  }\n\n  private readTransportSettings(): Record<string, TSettingsData> {\n    const settings = readSettings(this.settingsPath);\n    const raw = settings.transports;\n    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return {};\n    return raw as Record<string, TSettingsData>;\n  }\n}\n"],"mappings":"iMAiBA,IAAa,EAAb,KAA+B,CAC7B,QAA2B,IAAI,IAC/B,aAEA,YAAY,EAAsB,CAChC,KAAK,aAAe,CACtB,CAEA,SAAS,EAA8D,CACrE,KAAK,QAAQ,IAAI,EAAU,KAAM,CAAS,CAC5C,CAEA,QAAiD,CAC/C,IAAM,EAAQ,KAAK,sBAAsB,EACzC,OAAO,MAAM,KAAK,KAAK,QAAQ,OAAO,CAAC,CAAC,CAAC,IAAK,IAAe,CAC3D,YACA,OAAQ,KAAK,cAAc,EAAW,EAAM,EAAU,KAAK,CAC7D,EAAE,CACJ,CAEA,YAA4D,CAC1D,OAAO,KAAK,OAAO,CAAC,CACjB,OAAQ,GAAM,EAAE,OAAO,OAAO,CAAC,CAC/B,IAAK,GAAM,EAAE,SAAS,CAC3B,CAEA,MAAM,WAAW,EAAc,EAAiC,CAC9D,IAAM,EAAW,EAAa,KAAK,YAAY,EACzC,EAAc,EAAS,YAAc,CAAC,EAE5C,EAAW,GAAQ,CAAE,GADN,EAAW,IAAS,CAAC,EACL,SAAQ,EACvC,EAAS,WAAa,EACtB,EAAc,KAAK,aAAc,CAAQ,CAC3C,CAEA,MAAM,WAAW,EAAc,EAAyD,CACtF,IAAM,EAAW,EAAa,KAAK,YAAY,EACzC,EAAc,EAAS,YAAc,CAAC,EAE5C,EAAW,GAAQ,CAAE,GADN,EAAW,IAAS,CAAC,EACI,SAAyB,EACjE,EAAS,WAAa,EACtB,EAAc,KAAK,aAAc,CAAQ,CAC3C,CAEA,MAAM,SAAS,EAA6C,CAC1D,IAAM,EAAU,KAAK,WAAW,EAChC,IAAK,IAAM,KAAa,EACtB,EAAU,OAAO,CAAO,EACxB,MAAM,EAAU,MAAM,CAE1B,CAOA,MAAM,SAAmC,CACvC,IAAM,EAAkB,CAAC,EACzB,IAAK,IAAM,KAAa,KAAK,QAAQ,OAAO,EAC1C,GAAI,CACF,MAAM,EAAU,KAAK,CACvB,OAAS,EAAO,CAEd,EAAO,KAAK,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,CAAC,CACvE,CAEF,MAAO,CAAE,QAAO,CAClB,CAEA,cACE,EACA,EACkB,CAGlB,MAAO,CAAE,QAFQ,GAAO,SAAmC,EAAU,eAEnD,QADD,GAAO,SAA2D,CAAC,CAC1D,CAC5B,CAEA,uBAA+D,CAE7D,IAAM,EADW,EAAa,KAAK,YAChB,CAAC,CAAC,WAErB,MADI,CAAC,GAAO,OAAO,GAAQ,UAAY,MAAM,QAAQ,CAAG,EAAU,CAAC,EAC5D,CACT,CACF"}

package/dist/node/programmatic/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../programmatic-6wLf68qJ.cjs");exports.ProgrammaticInteractionChannel=e.n,exports.createProgrammaticAgent=e.t;

package/dist/node/programmatic/index.d.ts

@@ -0,0 +1,2 @@
+import { n as createProgrammaticAgent, r as ProgrammaticInteractionChannel, t as ICreateProgrammaticAgentOptions } from "../index-y_HBOfzO.js";
+export { type ICreateProgrammaticAgentOptions, ProgrammaticInteractionChannel, createProgrammaticAgent };

package/dist/node/programmatic/index.js

@@ -0,0 +1 @@
+import{n as e,t}from"../programmatic-70dxIXtS.js";export{e as ProgrammaticInteractionChannel,t as createProgrammaticAgent};

package/dist/node/programmatic-6wLf68qJ.cjs

@@ -0,0 +1 @@
+let e=require("@robota-sdk/agent-framework"),t=require("@robota-sdk/agent-interface-transport");var n=class{events=[];availableCommands=[];busy=!1;started=!1;stopped=!1;submitHandler=null;userActionResponses=[];onSubmit(e){this.submitHandler=e}write(e){this.events.push(e)}async askUser(e){return this.userActionResponses.shift()??{type:`cancelled`}}setAvailableCommands(e){this.availableCommands=e}setBusy(e){this.busy=e}async start(){this.started=!0}async stop(){this.stopped=!0}async submit(e){if(!this.submitHandler)throw Error(`ProgrammaticInteractionChannel: no submit handler registered — start the runtime first`);await this.submitHandler(e)}queueUserAction(e){this.userActionResponses.push(e)}};function r(r){let i=new n,a=(0,e.createInteractiveRuntime)({channel:i,commandModules:r.commandModules??[],provider:r.provider,cwd:r.cwd,sessionStore:r.sessionStore,permissionMode:r.permissionMode}),o=!1;return{events:i.events,start:async()=>{o||(o=!0,await a.start())},send:e=>i.submit(e),queueUserAction:e=>i.queueUserAction(e),assistantReplies:()=>(0,t.readAssistantReplies)(i.events),lastAssistantText:()=>(0,t.readLastAssistantText)(i.events),toolCalls:()=>(0,t.readToolCalls)(i.events),errors:()=>(0,t.readErrors)(i.events),stop:()=>a.stop()}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}});

package/dist/node/programmatic-70dxIXtS.js

@@ -0,0 +1,2 @@
+import{createInteractiveRuntime as e}from"@robota-sdk/agent-framework";import{readAssistantReplies as t,readErrors as n,readLastAssistantText as r,readToolCalls as i}from"@robota-sdk/agent-interface-transport";var a=class{events=[];availableCommands=[];busy=!1;started=!1;stopped=!1;submitHandler=null;userActionResponses=[];onSubmit(e){this.submitHandler=e}write(e){this.events.push(e)}async askUser(e){return this.userActionResponses.shift()??{type:`cancelled`}}setAvailableCommands(e){this.availableCommands=e}setBusy(e){this.busy=e}async start(){this.started=!0}async stop(){this.stopped=!0}async submit(e){if(!this.submitHandler)throw Error(`ProgrammaticInteractionChannel: no submit handler registered — start the runtime first`);await this.submitHandler(e)}queueUserAction(e){this.userActionResponses.push(e)}};function o(o){let s=new a,c=e({channel:s,commandModules:o.commandModules??[],provider:o.provider,cwd:o.cwd,sessionStore:o.sessionStore,permissionMode:o.permissionMode}),l=!1;return{events:s.events,start:async()=>{l||(l=!0,await c.start())},send:e=>s.submit(e),queueUserAction:e=>s.queueUserAction(e),assistantReplies:()=>t(s.events),lastAssistantText:()=>r(s.events),toolCalls:()=>i(s.events),errors:()=>n(s.events),stop:()=>c.stop()}}export{a as n,o as t};
+//# sourceMappingURL=programmatic-70dxIXtS.js.map

package/dist/node/programmatic-70dxIXtS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmatic-70dxIXtS.js","names":[],"sources":["../../src/programmatic/ProgrammaticInteractionChannel.ts","../../src/programmatic/createProgrammaticAgent.ts"],"sourcesContent":["/**\n * ProgrammaticInteractionChannel — an in-process IInteractionChannel adapter (INFRA-019).\n *\n * The \"programmatic preset\" adapter slot reserved by the interaction contract: instead of an Ink TUI\n * or a print runner, this channel lets a caller push a message in-process and read back the structured\n * `InteractionEvent` stream the framework already emits. It uses the documented one-way `write()`\n * protocol consumed by `createInteractiveRuntime` (not the TUI's direct-wiring path).\n *\n * Production transport adapter — lives in transport core. Tests and automation consume it; it never\n * depends on test code.\n */\n\nimport type { IActionRequest, TActionResponse } from '@robota-sdk/agent-core';\nimport type {\n  IInteractionChannel,\n  ICommandInfo,\n  InteractionEvent,\n} from '@robota-sdk/agent-interface-transport';\n\nexport class ProgrammaticInteractionChannel implements IInteractionChannel {\n  /** Full structured event stream pushed by the framework, in order. */\n  readonly events: InteractionEvent[] = [];\n\n  availableCommands: ICommandInfo[] = [];\n  busy = false;\n  started = false;\n  stopped = false;\n\n  private submitHandler: ((text: string) => Promise<void>) | null = null;\n  private readonly userActionResponses: TActionResponse[] = [];\n\n  // ── IInteractionChannel ──────────────────────────────────────\n\n  onSubmit(handler: (text: string) => Promise<void>): void {\n    this.submitHandler = handler;\n  }\n\n  write(event: InteractionEvent): void {\n    this.events.push(event);\n  }\n\n  /**\n   * CMD-004 unified ask. Resolves from the pre-supplied queue (FIFO); an empty queue resolves\n   * `{ type: 'cancelled' }` so a programmatic run never blocks on an un-answered question.\n   */\n  async askUser(_request: IActionRequest): Promise<TActionResponse> {\n    return this.userActionResponses.shift() ?? { type: 'cancelled' };\n  }\n\n  setAvailableCommands(commands: ICommandInfo[]): void {\n    this.availableCommands = commands;\n  }\n\n  setBusy(busy: boolean): void {\n    this.busy = busy;\n  }\n\n  async start(): Promise<void> {\n    this.started = true;\n  }\n\n  async stop(): Promise<void> {\n    this.stopped = true;\n  }\n\n  // ── Programmatic driving surface ─────────────────────────────\n\n  /** Push a user submission into the framework (the programmatic \"user types and presses enter\"). */\n  async submit(text: string): Promise<void> {\n    if (!this.submitHandler) {\n      throw new Error(\n        'ProgrammaticInteractionChannel: no submit handler registered — start the runtime first',\n      );\n    }\n    await this.submitHandler(text);\n  }\n\n  /** Pre-answer the next `askUser` (CMD-004 unified ask). */\n  queueUserAction(response: TActionResponse): void {\n    this.userActionResponses.push(response);\n  }\n}\n","/**\n * createProgrammaticAgent — the in-process implementation of the client-side agent contract\n * (`IAgentDriver`, INFRA-020; introduced as the programmatic driver in INFRA-019).\n *\n * Wraps `createInteractiveRuntime` with a {@link ProgrammaticInteractionChannel} so a caller can drive\n * the real agent structurally: `start()`, `send(text)` (awaits the whole turn), then read assistant\n * replies / tool calls / errors as data — no terminal, no PTY, no scraping. The observation accessors\n * delegate to the shared `read*` helpers in `@robota-sdk/agent-interface-transport`, so the\n * filter/derivation logic is not re-implemented here.\n */\n\nimport { createInteractiveRuntime } from '@robota-sdk/agent-framework';\nimport {\n  readAssistantReplies,\n  readErrors,\n  readLastAssistantText,\n  readToolCalls,\n} from '@robota-sdk/agent-interface-transport';\n\nimport { ProgrammaticInteractionChannel } from './ProgrammaticInteractionChannel.js';\n\nimport type { IAIProvider, TActionResponse, TPermissionMode } from '@robota-sdk/agent-core';\nimport type { ICommandModule, IInteractiveRuntime } from '@robota-sdk/agent-framework';\nimport type { IAgentDriver, IInteractiveSessionStore } from '@robota-sdk/agent-interface-transport';\n\nexport interface ICreateProgrammaticAgentOptions {\n  /** Provider that answers the agent loop (e.g. a real provider, or the scripted provider in tests). */\n  provider: IAIProvider;\n  /** Working directory for session creation. */\n  cwd: string;\n  /** Slash-command modules to register (defaults to none). */\n  commandModules?: readonly ICommandModule[];\n  /** Optional session store for persistence. */\n  sessionStore?: IInteractiveSessionStore;\n  /** Permission mode for tool execution (e.g. `'bypassPermissions'` for unattended driving). */\n  permissionMode?: TPermissionMode;\n}\n\n/**\n * Construct an in-process {@link IAgentDriver} bound to a real `InteractiveSession`. The returned\n * driver's accessors are the shared `read*` helpers applied to the captured event stream.\n */\nexport function createProgrammaticAgent(options: ICreateProgrammaticAgentOptions): IAgentDriver {\n  const channel = new ProgrammaticInteractionChannel();\n  const runtime: IInteractiveRuntime = createInteractiveRuntime({\n    channel,\n    commandModules: options.commandModules ?? [],\n    provider: options.provider,\n    cwd: options.cwd,\n    sessionStore: options.sessionStore,\n    permissionMode: options.permissionMode,\n  });\n\n  let started = false;\n\n  return {\n    events: channel.events,\n    start: async (): Promise<void> => {\n      if (started) return;\n      started = true;\n      await runtime.start();\n    },\n    send: (text: string): Promise<void> => channel.submit(text),\n    queueUserAction: (response: TActionResponse): void => channel.queueUserAction(response),\n    assistantReplies: (): string[] => readAssistantReplies(channel.events),\n    lastAssistantText: (): string | undefined => readLastAssistantText(channel.events),\n    toolCalls: () => readToolCalls(channel.events),\n    errors: (): Error[] => readErrors(channel.events),\n    stop: (): Promise<void> => runtime.stop(),\n  };\n}\n"],"mappings":"kNAmBA,IAAa,EAAb,KAA2E,CAEzE,OAAsC,CAAC,EAEvC,kBAAoC,CAAC,EACrC,KAAO,GACP,QAAU,GACV,QAAU,GAEV,cAAkE,KAClE,oBAA0D,CAAC,EAI3D,SAAS,EAAgD,CACvD,KAAK,cAAgB,CACvB,CAEA,MAAM,EAA+B,CACnC,KAAK,OAAO,KAAK,CAAK,CACxB,CAMA,MAAM,QAAQ,EAAoD,CAChE,OAAO,KAAK,oBAAoB,MAAM,GAAK,CAAE,KAAM,WAAY,CACjE,CAEA,qBAAqB,EAAgC,CACnD,KAAK,kBAAoB,CAC3B,CAEA,QAAQ,EAAqB,CAC3B,KAAK,KAAO,CACd,CAEA,MAAM,OAAuB,CAC3B,KAAK,QAAU,EACjB,CAEA,MAAM,MAAsB,CAC1B,KAAK,QAAU,EACjB,CAKA,MAAM,OAAO,EAA6B,CACxC,GAAI,CAAC,KAAK,cACR,MAAU,MACR,wFACF,EAEF,MAAM,KAAK,cAAc,CAAI,CAC/B,CAGA,gBAAgB,EAAiC,CAC/C,KAAK,oBAAoB,KAAK,CAAQ,CACxC,CACF,ECvCA,SAAgB,EAAwB,EAAwD,CAC9F,IAAM,EAAU,IAAI,EACd,EAA+B,EAAyB,CAC5D,UACA,eAAgB,EAAQ,gBAAkB,CAAC,EAC3C,SAAU,EAAQ,SAClB,IAAK,EAAQ,IACb,aAAc,EAAQ,aACtB,eAAgB,EAAQ,cAC1B,CAAC,EAEG,EAAU,GAEd,MAAO,CACL,OAAQ,EAAQ,OAChB,MAAO,SAA2B,CAC5B,IACJ,EAAU,GACV,MAAM,EAAQ,MAAM,EACtB,EACA,KAAO,GAAgC,EAAQ,OAAO,CAAI,EAC1D,gBAAkB,GAAoC,EAAQ,gBAAgB,CAAQ,EACtF,qBAAkC,EAAqB,EAAQ,MAAM,EACrE,sBAA6C,EAAsB,EAAQ,MAAM,EACjF,cAAiB,EAAc,EAAQ,MAAM,EAC7C,WAAuB,EAAW,EAAQ,MAAM,EAChD,SAA2B,EAAQ,KAAK,CAC1C,CACF"}

package/dist/node/testing/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){let t=[],n=0;return{provider:{name:`scripted-test-provider`,version:`test`,async chat(r){t.push([...r]);let i=e[n];if(i===void 0)throw Error(`Scripted provider: script exhausted at call ${n+1} (script declares ${e.length} turn(s)) — extend the script instead of relying on improvised responses`);return n+=1,`text`in i?{id:`scripted-${n}`,role:`assistant`,content:i.text,state:`complete`,timestamp:new Date}:{id:`scripted-${n}`,role:`assistant`,content:null,state:`complete`,timestamp:new Date,toolCalls:i.toolCalls.map((e,t)=>({id:`scripted-call-${n}-${t}`,type:`function`,function:{name:e.name,arguments:JSON.stringify(e.args)}}))}},async generateResponse(){return{content:`scripted provider does not implement raw responses`}},supportsTools(){return!0},validateConfig(){return!0}},requests:t}}exports.createScriptedProvider=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@robota-sdk/agent-core/testing");Object.defineProperty(exports,"createScriptedProvider",{enumerable:!0,get:function(){return e.createScriptedProvider}});