@robota-sdk/agent-transport 3.0.0-beta.65 → 3.0.0-beta.67

package/dist/node/ws/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../ws-XRTSFZOK.cjs`);exports.WsTransport=e.t,exports.createWsHandler=e.r,exports.createWsTransport=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../ws-tCjj2gPu.cjs`);exports.WsTransport=e.t,exports.createWsHandler=e.r,exports.createWsTransport=e.n;

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

@@ -1,2 +1,2 @@
-import { a as IWsTransportConfig, c as createWsTransport, d as TClientMessage, f as TServerMessage, i as TExecutionWorkspaceStatus, l as IWsHandlerOptions, n as IExecutionWorkspaceSnapshot, o as WsTransport, r as TExecutionAttention, s as IWsTransportOptions, t as IExecutionWorkspaceEntry, u as createWsHandler } from "../index-CvXLpjJO.js";
+import { a as IWsTransportConfig, c as createWsTransport, d as TClientMessage, f as TServerMessage, i as TExecutionWorkspaceStatus, l as IWsHandlerOptions, n as IExecutionWorkspaceSnapshot, o as WsTransport, r as TExecutionAttention, s as IWsTransportOptions, t as IExecutionWorkspaceEntry, u as createWsHandler } from "../index-yvGShbDx.js";
 export { type IExecutionWorkspaceEntry, type IExecutionWorkspaceSnapshot, type IWsHandlerOptions, type IWsTransportConfig, type IWsTransportOptions, type TClientMessage, type TExecutionAttention, type TExecutionWorkspaceStatus, type TServerMessage, WsTransport, createWsHandler, createWsTransport };

package/dist/node/ws/index.js

@@ -1 +1 @@
-import{n as e,r as t,t as n}from"../ws-B-oRccFl.js";export{n as WsTransport,t as createWsHandler,e as createWsTransport};
+import{n as e,r as t,t as n}from"../ws-BWel8nzl.js";export{n as WsTransport,t as createWsHandler,e as createWsTransport};

package/dist/node/{ws-B-oRccFl.js → ws-BWel8nzl.js}

@@ -1,2 +1,2 @@
 import{createServer as e}from"node:http";import{WebSocket as t,WebSocketServer as n}from"ws";function r(e,t,n){if(n.type===`get-background-tasks`){t({type:`background_tasks`,tasks:e.listBackgroundTasks(n.filter)});return}if(n.type===`get-background-task`){a(e,t,n);return}if(n.type===`get-background-job-groups`){t({type:`background_job_groups`,groups:e.listBackgroundJobGroups()});return}if(n.type===`get-background-job-group`){s(e,t,n);return}if(n.type===`wait-background-job-group`){c(e,t,n);return}o(e,t,n)}function i(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}if(n.type===`cancel-background-task`){u(t,`cancel`,n.taskId,e.cancelBackgroundTask(n.taskId,n.reason));return}if(n.type===`close-background-task`){u(t,`close`,n.taskId,e.closeBackgroundTask(n.taskId));return}l(e,t,n)}function a(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}t({type:`background_task`,taskId:n.taskId,task:e.getBackgroundTask(n.taskId)??null})}function o(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}e.readBackgroundTaskLog(n.taskId,n.cursor).then(e=>t({type:`background_task_log`,taskId:n.taskId,page:e}),e=>t({type:`protocol_error`,message:e.message}))}function s(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}t({type:`background_job_group`,groupId:n.groupId,group:e.getBackgroundJobGroup(n.groupId)??null})}function c(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}e.waitBackgroundJobGroup(n.groupId).then(e=>t({type:`background_job_group`,groupId:n.groupId,group:e}),e=>t({type:`protocol_error`,message:e.message}))}function l(e,t,n){if(!n.input){t({type:`protocol_error`,message:`input is required`});return}u(t,`send`,n.taskId,e.sendBackgroundTask(n.taskId,n.input))}function u(e,t,n,r){r.then(()=>e({type:`background_task_control_result`,action:t,taskId:n,success:!0}),r=>e({type:`background_task_control_result`,action:t,taskId:n,success:!1,message:r.message}))}function d(e){let t=f(e.session,e.send);return{onMessage:p(e.session,e.send),cleanup:t}}function f(e,t){let n=e=>t({type:`user_message`,content:e}),r=e=>t({type:`text_delta`,delta:e}),i=e=>t({type:`tool_start`,state:e}),a=e=>t({type:`tool_end`,state:e}),o=e=>t({type:`thinking`,isThinking:e}),s=e=>t({type:`complete`,result:e}),c=e=>t({type:`interrupted`,result:e}),l=e=>t({type:`error`,message:e.message}),u=e=>t({type:`background_task_event`,event:e}),d=e=>t({type:`background_job_group_event`,event:e}),f=e=>t({type:`execution_workspace_event`,snapshot:e.snapshot});return e.on(`user_message`,n),e.on(`text_delta`,r),e.on(`tool_start`,i),e.on(`tool_end`,a),e.on(`thinking`,o),e.on(`complete`,s),e.on(`interrupted`,c),e.on(`error`,l),e.on(`background_task_event`,u),e.on(`background_job_group_event`,d),e.on(`execution_workspace_event`,f),()=>{e.off(`user_message`,n),e.off(`text_delta`,r),e.off(`tool_start`,i),e.off(`tool_end`,a),e.off(`thinking`,o),e.off(`complete`,s),e.off(`interrupted`,c),e.off(`error`,l),e.off(`background_task_event`,u),e.off(`background_job_group_event`,d),e.off(`execution_workspace_event`,f)}}function p(e,t){return n=>{let r=m(n,t);r&&h(e,t,r)}}function m(e,t){try{return JSON.parse(e)}catch{return t({type:`protocol_error`,message:`Invalid JSON`}),null}}function h(e,t,n){if(_(n)){x(e,t,n);return}if(v(n)){S(e,t,n);return}if(y(n)){r(e,t,n);return}if(b(n)){i(e,t,n);return}t({type:`protocol_error`,message:`Unknown message type: ${g(n)}`})}function g(e){return e.type}function _(e){return e.type===`submit`||e.type===`command`||e.type===`abort`||e.type===`cancel-queue`}function v(e){return e.type===`get-messages`||e.type===`get-context`||e.type===`get-executing`||e.type===`get-pending`||e.type===`get-execution-workspace`}function y(e){return e.type===`get-background-tasks`||e.type===`get-background-task`||e.type===`read-background-task-log`||e.type===`get-background-job-groups`||e.type===`get-background-job-group`||e.type===`wait-background-job-group`}function b(e){return e.type===`cancel-background-task`||e.type===`close-background-task`||e.type===`send-background-task`}function x(e,t,n){if(n.type===`submit`){if(!n.prompt){t({type:`protocol_error`,message:`prompt is required`});return}e.submit(n.prompt)}else if(n.type===`command`){if(!n.name){t({type:`protocol_error`,message:`name is required`});return}e.executeCommand(n.name,n.args??``).then(e=>{t({type:`command_result`,name:n.name,message:e?.message??`Unknown command: ${n.name}`,success:e?.success??!1,data:e?.data})})}else n.type===`abort`?e.abort():e.cancelQueue()}function S(e,t,n){n.type===`get-messages`?t({type:`messages`,messages:e.getMessages()}):n.type===`get-context`?t({type:`context`,state:e.getContextState()}):n.type===`get-executing`?t({type:`executing`,executing:e.isExecuting()}):n.type===`get-execution-workspace`?t({type:`execution_workspace_event`,snapshot:e.getExecutionWorkspaceSnapshot()}):t({type:`pending`,pending:e.getPendingPrompt()})}function C(e){let t=null,n=null;return{name:`ws`,onMessage:null,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);let r=d({session:t,send:e.send});n=r.cleanup,this.onMessage=r.onMessage},async stop(){n?.(),n=null,this.onMessage=null}}}const w=7070;var T=class{name=`ws`;defaultEnabled=!0;optionsSchema={port:{type:`number`,description:`WebSocket server port`,default:w},maxRetries:{type:`number`,description:`Port retry attempts when port is occupied`,default:20}};session=null;stopFn=null;port;maxRetries;constructor(e={}){this.port=e.port??w,this.maxRetries=e.maxRetries??20}attach(e){this.session=e}async start(){if(!this.session)throw Error(`WsTransport: attach() must be called before start()`);let e=await this.bindWithRetry(this.session,this.port,this.maxRetries);this.stopFn=e.stop}async stop(){await this.stopFn?.(),this.stopFn=null}validateOptions(e){let{port:t,maxRetries:n}=e;return!(t!==void 0&&(typeof t!=`number`||t<1||t>65535)||n!==void 0&&(typeof n!=`number`||n<0))}bindWithRetry(e,t,n){return this.tryBind(e,t).catch(r=>{if(r.code===`EADDRINUSE`&&n>0)return this.bindWithRetry(e,t+1,n-1);throw r})}tryBind(r,i){return new Promise((a,o)=>{let s=e((e,t)=>{t.writeHead(400).end(`WebSocket endpoint`)});s.on(`error`,e=>{s.close(),o(e)}),s.listen(i,`127.0.0.1`,()=>{let e=new n({server:s});e.on(`connection`,e=>{let n=n=>{e.readyState===t.OPEN&&e.send(JSON.stringify(n))},{onMessage:i,cleanup:a}=d({session:r,send:n});e.on(`message`,e=>i(String(e))),e.on(`close`,a),e.on(`error`,a),n({type:`messages`,messages:r.getMessages()}),n({type:`execution_workspace_event`,snapshot:r.getExecutionWorkspaceSnapshot()})}),a({stop:()=>new Promise(t=>{e.close(()=>s.close(()=>t()))})})})})}};export{C as n,d as r,T as t};
-//# sourceMappingURL=ws-B-oRccFl.js.map
+//# sourceMappingURL=ws-BWel8nzl.js.map

package/dist/node/ws-BWel8nzl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-BWel8nzl.js","names":[],"sources":["../../src/ws/ws-background-messages.ts","../../src/ws/ws-handler.ts","../../src/ws/ws-transport.ts","../../src/ws/ws-transport-configurable.ts"],"sourcesContent":["import type { TBackgroundControlAction, TClientMessage, TServerMessage } from './ws-protocol.js';\nimport type { IInteractiveSession } from '@robota-sdk/agent-framework';\n\nexport function handleBackgroundQueryMessage(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<\n    TClientMessage,\n    | { type: 'get-background-tasks' | 'get-background-task' | 'read-background-task-log' }\n    | {\n        type:\n          | 'get-background-job-groups'\n          | 'get-background-job-group'\n          | 'wait-background-job-group';\n      }\n  >,\n): void {\n  if (msg.type === 'get-background-tasks') {\n    send({ type: 'background_tasks', tasks: session.listBackgroundTasks(msg.filter) });\n    return;\n  }\n  if (msg.type === 'get-background-task') {\n    sendBackgroundTaskSnapshot(session, send, msg);\n    return;\n  }\n  if (msg.type === 'get-background-job-groups') {\n    send({ type: 'background_job_groups', groups: session.listBackgroundJobGroups() });\n    return;\n  }\n  if (msg.type === 'get-background-job-group') {\n    sendBackgroundJobGroupSnapshot(session, send, msg);\n    return;\n  }\n  if (msg.type === 'wait-background-job-group') {\n    sendBackgroundJobGroupWaitResult(session, send, msg);\n    return;\n  }\n  sendBackgroundTaskLogPage(session, send, msg);\n}\n\nexport function handleBackgroundControlMessage(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<\n    TClientMessage,\n    { type: 'cancel-background-task' | 'close-background-task' | 'send-background-task' }\n  >,\n): void {\n  if (!msg.taskId) {\n    send({ type: 'protocol_error', message: 'taskId is required' });\n    return;\n  }\n  if (msg.type === 'cancel-background-task') {\n    sendBackgroundTaskControlResult(\n      send,\n      'cancel',\n      msg.taskId,\n      session.cancelBackgroundTask(msg.taskId, msg.reason),\n    );\n    return;\n  }\n  if (msg.type === 'close-background-task') {\n    sendBackgroundTaskControlResult(\n      send,\n      'close',\n      msg.taskId,\n      session.closeBackgroundTask(msg.taskId),\n    );\n    return;\n  }\n  sendBackgroundTaskInput(session, send, msg);\n}\n\nfunction sendBackgroundTaskSnapshot(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<TClientMessage, { type: 'get-background-task' }>,\n): void {\n  if (!msg.taskId) {\n    send({ type: 'protocol_error', message: 'taskId is required' });\n    return;\n  }\n  send({\n    type: 'background_task',\n    taskId: msg.taskId,\n    task: session.getBackgroundTask(msg.taskId) ?? null,\n  });\n}\n\nfunction sendBackgroundTaskLogPage(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<TClientMessage, { type: 'read-background-task-log' }>,\n): void {\n  if (!msg.taskId) {\n    send({ type: 'protocol_error', message: 'taskId is required' });\n    return;\n  }\n  session.readBackgroundTaskLog(msg.taskId, msg.cursor).then(\n    (page) => send({ type: 'background_task_log', taskId: msg.taskId, page }),\n    (error: Error) => send({ type: 'protocol_error', message: error.message }),\n  );\n}\n\nfunction sendBackgroundJobGroupSnapshot(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<TClientMessage, { type: 'get-background-job-group' }>,\n): void {\n  if (!msg.groupId) {\n    send({ type: 'protocol_error', message: 'groupId is required' });\n    return;\n  }\n  send({\n    type: 'background_job_group',\n    groupId: msg.groupId,\n    group: session.getBackgroundJobGroup(msg.groupId) ?? null,\n  });\n}\n\nfunction sendBackgroundJobGroupWaitResult(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<TClientMessage, { type: 'wait-background-job-group' }>,\n): void {\n  if (!msg.groupId) {\n    send({ type: 'protocol_error', message: 'groupId is required' });\n    return;\n  }\n  session.waitBackgroundJobGroup(msg.groupId).then(\n    (group) => send({ type: 'background_job_group', groupId: msg.groupId, group }),\n    (error: Error) => send({ type: 'protocol_error', message: error.message }),\n  );\n}\n\nfunction sendBackgroundTaskInput(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<TClientMessage, { type: 'send-background-task' }>,\n): void {\n  if (!msg.input) {\n    send({ type: 'protocol_error', message: 'input is required' });\n    return;\n  }\n  sendBackgroundTaskControlResult(\n    send,\n    'send',\n    msg.taskId,\n    session.sendBackgroundTask(msg.taskId, msg.input),\n  );\n}\n\nfunction sendBackgroundTaskControlResult(\n  send: (message: TServerMessage) => void,\n  action: TBackgroundControlAction,\n  taskId: string,\n  operation: Promise<void>,\n): void {\n  operation.then(\n    () => send({ type: 'background_task_control_result', action, taskId, success: true }),\n    (error: Error) =>\n      send({\n        type: 'background_task_control_result',\n        action,\n        taskId,\n        success: false,\n        message: error.message,\n      }),\n  );\n}\n","/**\n * WebSocket transport adapter — exposes IInteractiveSession over WebSocket.\n *\n * Framework-agnostic: works with any WebSocket implementation via\n * send/onMessage callbacks. No dependency on ws, uWebSockets, etc.\n *\n * Protocol: JSON messages with { type, ...payload } structure.\n * Server pushes IInteractiveSession events to client in real-time.\n */\n\nimport {\n  handleBackgroundControlMessage,\n  handleBackgroundQueryMessage,\n} from './ws-background-messages.js';\n\nimport type { TClientMessage, TServerMessage } from './ws-protocol.js';\nimport type {\n  IInteractiveSession,\n  IExecutionResult,\n  IExecutionWorkspaceEvent,\n  TBackgroundJobGroupEvent,\n  TBackgroundTaskEvent,\n  IToolState,\n} from '@robota-sdk/agent-framework';\n\nexport interface IWsHandlerOptions {\n  /** IInteractiveSession to expose. */\n  session: IInteractiveSession;\n  /** Send a JSON message to the client. */\n  send: (message: TServerMessage) => void;\n}\n\n/**\n * Create a WebSocket message handler for an IInteractiveSession.\n *\n * Returns:\n * - `onMessage(data)`: call this when the WebSocket receives a message\n * - `cleanup()`: call this when the WebSocket disconnects\n *\n * Usage:\n * ```typescript\n * const { onMessage, cleanup } = createWsHandler({\n *   session: interactiveSession,\n *   send: (msg) => ws.send(JSON.stringify(msg)),\n * });\n *\n * ws.on('message', (data) => onMessage(String(data)));\n * ws.on('close', cleanup);\n * ```\n */\nexport function createWsHandler(options: IWsHandlerOptions): {\n  onMessage: (data: string) => void;\n  cleanup: () => void;\n} {\n  const cleanup = subscribeSessionEvents(options.session, options.send);\n  const onMessage = createWsMessageHandler(options.session, options.send);\n\n  return { onMessage, cleanup };\n}\n\nfunction subscribeSessionEvents(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n): () => void {\n  const onUserMessage = (content: string): void => send({ type: 'user_message', content });\n  const onTextDelta = (delta: string): void => send({ type: 'text_delta', delta });\n  const onToolStart = (state: IToolState): void => send({ type: 'tool_start', state });\n  const onToolEnd = (state: IToolState): void => send({ type: 'tool_end', state });\n  const onThinking = (isThinking: boolean): void => send({ type: 'thinking', isThinking });\n  const onComplete = (result: IExecutionResult): void => send({ type: 'complete', result });\n  const onInterrupted = (result: IExecutionResult): void => send({ type: 'interrupted', result });\n  const onError = (error: Error): void => send({ type: 'error', message: error.message });\n  const onBackgroundTaskEvent = (event: TBackgroundTaskEvent): void =>\n    send({ type: 'background_task_event', event });\n  const onBackgroundJobGroupEvent = (event: TBackgroundJobGroupEvent): void =>\n    send({ type: 'background_job_group_event', event });\n  const onExecutionWorkspace = (event: IExecutionWorkspaceEvent): void =>\n    send({ type: 'execution_workspace_event', snapshot: event.snapshot });\n\n  session.on('user_message', onUserMessage);\n  session.on('text_delta', onTextDelta);\n  session.on('tool_start', onToolStart);\n  session.on('tool_end', onToolEnd);\n  session.on('thinking', onThinking);\n  session.on('complete', onComplete);\n  session.on('interrupted', onInterrupted);\n  session.on('error', onError);\n  session.on('background_task_event', onBackgroundTaskEvent);\n  session.on('background_job_group_event', onBackgroundJobGroupEvent);\n  session.on('execution_workspace_event', onExecutionWorkspace);\n\n  return (): void => {\n    session.off('user_message', onUserMessage);\n    session.off('text_delta', onTextDelta);\n    session.off('tool_start', onToolStart);\n    session.off('tool_end', onToolEnd);\n    session.off('thinking', onThinking);\n    session.off('complete', onComplete);\n    session.off('interrupted', onInterrupted);\n    session.off('error', onError);\n    session.off('background_task_event', onBackgroundTaskEvent);\n    session.off('background_job_group_event', onBackgroundJobGroupEvent);\n    session.off('execution_workspace_event', onExecutionWorkspace);\n  };\n}\n\nfunction createWsMessageHandler(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n): (data: string) => void {\n  return (data: string): void => {\n    const msg = parseClientMessage(data, send);\n    if (!msg) return;\n    handleClientMessage(session, send, msg);\n  };\n}\n\nfunction parseClientMessage(\n  data: string,\n  send: (message: TServerMessage) => void,\n): TClientMessage | null {\n  try {\n    return JSON.parse(data) as TClientMessage;\n  } catch {\n    send({ type: 'protocol_error', message: 'Invalid JSON' });\n    return null;\n  }\n}\n\nfunction handleClientMessage(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: TClientMessage,\n): void {\n  if (isSessionControlMessage(msg)) {\n    handleSessionControlMessage(session, send, msg);\n    return;\n  }\n  if (isSessionQueryMessage(msg)) {\n    handleSessionQueryMessage(session, send, msg);\n    return;\n  }\n  if (isBackgroundQueryMessage(msg)) {\n    handleBackgroundQueryMessage(session, send, msg);\n    return;\n  }\n  if (isBackgroundControlMessage(msg)) {\n    handleBackgroundControlMessage(session, send, msg);\n    return;\n  }\n  send({ type: 'protocol_error', message: `Unknown message type: ${getMessageType(msg)}` });\n}\n\nfunction getMessageType(msg: TClientMessage): string {\n  return (msg as { type: string }).type;\n}\n\nfunction isSessionControlMessage(\n  msg: TClientMessage,\n): msg is Extract<TClientMessage, { type: 'submit' | 'command' | 'abort' | 'cancel-queue' }> {\n  return (\n    msg.type === 'submit' ||\n    msg.type === 'command' ||\n    msg.type === 'abort' ||\n    msg.type === 'cancel-queue'\n  );\n}\n\nfunction isSessionQueryMessage(msg: TClientMessage): msg is Extract<\n  TClientMessage,\n  {\n    type:\n      | 'get-messages'\n      | 'get-context'\n      | 'get-executing'\n      | 'get-pending'\n      | 'get-execution-workspace';\n  }\n> {\n  return (\n    msg.type === 'get-messages' ||\n    msg.type === 'get-context' ||\n    msg.type === 'get-executing' ||\n    msg.type === 'get-pending' ||\n    msg.type === 'get-execution-workspace'\n  );\n}\n\nfunction isBackgroundQueryMessage(\n  msg: TClientMessage,\n): msg is Extract<\n  TClientMessage,\n  | { type: 'get-background-tasks' | 'get-background-task' | 'read-background-task-log' }\n  | { type: 'get-background-job-groups' | 'get-background-job-group' | 'wait-background-job-group' }\n> {\n  return (\n    msg.type === 'get-background-tasks' ||\n    msg.type === 'get-background-task' ||\n    msg.type === 'read-background-task-log' ||\n    msg.type === 'get-background-job-groups' ||\n    msg.type === 'get-background-job-group' ||\n    msg.type === 'wait-background-job-group'\n  );\n}\n\nfunction isBackgroundControlMessage(\n  msg: TClientMessage,\n): msg is Extract<\n  TClientMessage,\n  { type: 'cancel-background-task' | 'close-background-task' | 'send-background-task' }\n> {\n  return (\n    msg.type === 'cancel-background-task' ||\n    msg.type === 'close-background-task' ||\n    msg.type === 'send-background-task'\n  );\n}\n\nfunction handleSessionControlMessage(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<TClientMessage, { type: 'submit' | 'command' | 'abort' | 'cancel-queue' }>,\n): void {\n  if (msg.type === 'submit') {\n    if (!msg.prompt) {\n      send({ type: 'protocol_error', message: 'prompt is required' });\n      return;\n    }\n    session.submit(msg.prompt);\n  } else if (msg.type === 'command') {\n    if (!msg.name) {\n      send({ type: 'protocol_error', message: 'name is required' });\n      return;\n    }\n    session.executeCommand(msg.name, msg.args ?? '').then((result) => {\n      send({\n        type: 'command_result',\n        name: msg.name,\n        message: result?.message ?? `Unknown command: ${msg.name}`,\n        success: result?.success ?? false,\n        data: result?.data,\n      });\n    });\n  } else if (msg.type === 'abort') {\n    session.abort();\n  } else {\n    session.cancelQueue();\n  }\n}\n\nfunction handleSessionQueryMessage(\n  session: IInteractiveSession,\n  send: (message: TServerMessage) => void,\n  msg: Extract<\n    TClientMessage,\n    {\n      type:\n        | 'get-messages'\n        | 'get-context'\n        | 'get-executing'\n        | 'get-pending'\n        | 'get-execution-workspace';\n    }\n  >,\n): void {\n  if (msg.type === 'get-messages') {\n    send({ type: 'messages', messages: session.getMessages() });\n  } else if (msg.type === 'get-context') {\n    send({ type: 'context', state: session.getContextState() });\n  } else if (msg.type === 'get-executing') {\n    send({ type: 'executing', executing: session.isExecuting() });\n  } else if (msg.type === 'get-execution-workspace') {\n    send({\n      type: 'execution_workspace_event',\n      snapshot: session.getExecutionWorkspaceSnapshot(),\n    });\n  } else {\n    send({ type: 'pending', pending: session.getPendingPrompt() });\n  }\n}\n","/**\n * ITransportAdapter implementation for WebSocket transport.\n *\n * Wraps createWsHandler into the unified ITransportAdapter interface.\n * After start(), the consumer must wire onMessage to their WebSocket.\n */\n\nimport { createWsHandler } from './ws-handler.js';\n\nimport type { TServerMessage } from './ws-protocol.js';\nimport type { IInteractiveSession } from '@robota-sdk/agent-framework';\nimport type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';\n\nexport interface IWsTransportOptions {\n  /** Send a JSON message to the connected WebSocket client. */\n  send: (message: TServerMessage) => void;\n}\n\nexport function createWsTransport(\n  options: IWsTransportOptions,\n): ITransportAdapter<IInteractiveSession> & { onMessage: ((data: string) => void) | null } {\n  let session: IInteractiveSession | null = null;\n  let cleanup: (() => void) | null = null;\n\n  return {\n    name: 'ws',\n    onMessage: null,\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 handler = createWsHandler({ session, send: options.send });\n      cleanup = handler.cleanup;\n      this.onMessage = handler.onMessage;\n    },\n    async stop() {\n      cleanup?.();\n      cleanup = null;\n      this.onMessage = null;\n    },\n  };\n}\n","/**\n * Self-contained WS transport implementing IConfigurableTransport.\n * Owns the WebSocket server lifecycle (ws package), started/stopped via the transport registry.\n */\n\nimport { createServer, type Server } from 'node:http';\n\nimport { WebSocketServer, WebSocket } from 'ws';\n\nimport { createWsHandler } from './ws-handler.js';\n\nimport type { TServerMessage } from './ws-protocol.js';\nimport type { TUniversalValue } from '@robota-sdk/agent-core';\nimport type { IInteractiveSession } from '@robota-sdk/agent-framework';\nimport type { IConfigurableTransport } from '@robota-sdk/agent-interface-transport';\n\nconst DEFAULT_PORT = 7070;\nconst DEFAULT_MAX_RETRIES = 20;\n\nexport interface IWsTransportConfig {\n  port?: number;\n  maxRetries?: number;\n}\n\nexport class WsTransport implements IConfigurableTransport<IInteractiveSession> {\n  readonly name = 'ws';\n  readonly defaultEnabled = true;\n  readonly optionsSchema = {\n    port: { type: 'number', description: 'WebSocket server port', default: DEFAULT_PORT },\n    maxRetries: {\n      type: 'number',\n      description: 'Port retry attempts when port is occupied',\n      default: DEFAULT_MAX_RETRIES,\n    },\n  };\n\n  private session: IInteractiveSession | null = null;\n  private stopFn: (() => Promise<void>) | null = null;\n  private readonly port: number;\n  private readonly maxRetries: number;\n\n  constructor(config: IWsTransportConfig = {}) {\n    this.port = config.port ?? DEFAULT_PORT;\n    this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;\n  }\n\n  attach(session: IInteractiveSession): void {\n    this.session = session;\n  }\n\n  async start(): Promise<void> {\n    if (!this.session) throw new Error('WsTransport: attach() must be called before start()');\n    const handle = await this.bindWithRetry(this.session, this.port, this.maxRetries);\n    this.stopFn = handle.stop;\n  }\n\n  async stop(): Promise<void> {\n    await this.stopFn?.();\n    this.stopFn = null;\n  }\n\n  validateOptions(options: Record<string, TUniversalValue>): boolean {\n    const { port, maxRetries } = options;\n    if (port !== undefined && (typeof port !== 'number' || port < 1 || port > 65535)) return false;\n    if (maxRetries !== undefined && (typeof maxRetries !== 'number' || maxRetries < 0))\n      return false;\n    return true;\n  }\n\n  private bindWithRetry(\n    session: IInteractiveSession,\n    port: number,\n    retriesLeft: number,\n  ): Promise<{ stop: () => Promise<void> }> {\n    return this.tryBind(session, port).catch((err: NodeJS.ErrnoException) => {\n      if (err.code === 'EADDRINUSE' && retriesLeft > 0)\n        return this.bindWithRetry(session, port + 1, retriesLeft - 1);\n      throw err;\n    });\n  }\n\n  private tryBind(\n    session: IInteractiveSession,\n    port: number,\n  ): Promise<{ stop: () => Promise<void> }> {\n    return new Promise((resolve, reject) => {\n      const httpServer: Server = createServer((_, res) => {\n        res.writeHead(400).end('WebSocket endpoint');\n      });\n\n      httpServer.on('error', (err: NodeJS.ErrnoException) => {\n        httpServer.close();\n        reject(err);\n      });\n\n      httpServer.listen(port, '127.0.0.1', () => {\n        const wss = new WebSocketServer({ server: httpServer });\n\n        wss.on('connection', (ws: WebSocket) => {\n          const send = (message: TServerMessage): void => {\n            if (ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify(message));\n          };\n\n          const { onMessage, cleanup } = createWsHandler({ session, send });\n\n          ws.on('message', (data) => onMessage(String(data)));\n          ws.on('close', cleanup);\n          ws.on('error', cleanup);\n\n          send({ type: 'messages', messages: session.getMessages() });\n          send({\n            type: 'execution_workspace_event',\n            snapshot: session.getExecutionWorkspaceSnapshot(),\n          });\n        });\n\n        resolve({\n          stop: () =>\n            new Promise<void>((res) => {\n              wss.close(() => httpServer.close(() => res()));\n            }),\n        });\n      });\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/node/ws-tCjj2gPu.cjs

@@ -0,0 +1 @@
+require(`./chunk-Bmb41Sf3.cjs`);let e=require(`node:http`),t=require(`ws`);function n(e,t,n){if(n.type===`get-background-tasks`){t({type:`background_tasks`,tasks:e.listBackgroundTasks(n.filter)});return}if(n.type===`get-background-task`){i(e,t,n);return}if(n.type===`get-background-job-groups`){t({type:`background_job_groups`,groups:e.listBackgroundJobGroups()});return}if(n.type===`get-background-job-group`){o(e,t,n);return}if(n.type===`wait-background-job-group`){s(e,t,n);return}a(e,t,n)}function r(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}if(n.type===`cancel-background-task`){l(t,`cancel`,n.taskId,e.cancelBackgroundTask(n.taskId,n.reason));return}if(n.type===`close-background-task`){l(t,`close`,n.taskId,e.closeBackgroundTask(n.taskId));return}c(e,t,n)}function i(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}t({type:`background_task`,taskId:n.taskId,task:e.getBackgroundTask(n.taskId)??null})}function a(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}e.readBackgroundTaskLog(n.taskId,n.cursor).then(e=>t({type:`background_task_log`,taskId:n.taskId,page:e}),e=>t({type:`protocol_error`,message:e.message}))}function o(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}t({type:`background_job_group`,groupId:n.groupId,group:e.getBackgroundJobGroup(n.groupId)??null})}function s(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}e.waitBackgroundJobGroup(n.groupId).then(e=>t({type:`background_job_group`,groupId:n.groupId,group:e}),e=>t({type:`protocol_error`,message:e.message}))}function c(e,t,n){if(!n.input){t({type:`protocol_error`,message:`input is required`});return}l(t,`send`,n.taskId,e.sendBackgroundTask(n.taskId,n.input))}function l(e,t,n,r){r.then(()=>e({type:`background_task_control_result`,action:t,taskId:n,success:!0}),r=>e({type:`background_task_control_result`,action:t,taskId:n,success:!1,message:r.message}))}function u(e){let t=d(e.session,e.send);return{onMessage:f(e.session,e.send),cleanup:t}}function d(e,t){let n=e=>t({type:`user_message`,content:e}),r=e=>t({type:`text_delta`,delta:e}),i=e=>t({type:`tool_start`,state:e}),a=e=>t({type:`tool_end`,state:e}),o=e=>t({type:`thinking`,isThinking:e}),s=e=>t({type:`complete`,result:e}),c=e=>t({type:`interrupted`,result:e}),l=e=>t({type:`error`,message:e.message}),u=e=>t({type:`background_task_event`,event:e}),d=e=>t({type:`background_job_group_event`,event:e}),f=e=>t({type:`execution_workspace_event`,snapshot:e.snapshot});return e.on(`user_message`,n),e.on(`text_delta`,r),e.on(`tool_start`,i),e.on(`tool_end`,a),e.on(`thinking`,o),e.on(`complete`,s),e.on(`interrupted`,c),e.on(`error`,l),e.on(`background_task_event`,u),e.on(`background_job_group_event`,d),e.on(`execution_workspace_event`,f),()=>{e.off(`user_message`,n),e.off(`text_delta`,r),e.off(`tool_start`,i),e.off(`tool_end`,a),e.off(`thinking`,o),e.off(`complete`,s),e.off(`interrupted`,c),e.off(`error`,l),e.off(`background_task_event`,u),e.off(`background_job_group_event`,d),e.off(`execution_workspace_event`,f)}}function f(e,t){return n=>{let r=p(n,t);r&&m(e,t,r)}}function p(e,t){try{return JSON.parse(e)}catch{return t({type:`protocol_error`,message:`Invalid JSON`}),null}}function m(e,t,i){if(g(i)){b(e,t,i);return}if(_(i)){x(e,t,i);return}if(v(i)){n(e,t,i);return}if(y(i)){r(e,t,i);return}t({type:`protocol_error`,message:`Unknown message type: ${h(i)}`})}function h(e){return e.type}function g(e){return e.type===`submit`||e.type===`command`||e.type===`abort`||e.type===`cancel-queue`}function _(e){return e.type===`get-messages`||e.type===`get-context`||e.type===`get-executing`||e.type===`get-pending`||e.type===`get-execution-workspace`}function v(e){return e.type===`get-background-tasks`||e.type===`get-background-task`||e.type===`read-background-task-log`||e.type===`get-background-job-groups`||e.type===`get-background-job-group`||e.type===`wait-background-job-group`}function y(e){return e.type===`cancel-background-task`||e.type===`close-background-task`||e.type===`send-background-task`}function b(e,t,n){if(n.type===`submit`){if(!n.prompt){t({type:`protocol_error`,message:`prompt is required`});return}e.submit(n.prompt)}else if(n.type===`command`){if(!n.name){t({type:`protocol_error`,message:`name is required`});return}e.executeCommand(n.name,n.args??``).then(e=>{t({type:`command_result`,name:n.name,message:e?.message??`Unknown command: ${n.name}`,success:e?.success??!1,data:e?.data})})}else n.type===`abort`?e.abort():e.cancelQueue()}function x(e,t,n){n.type===`get-messages`?t({type:`messages`,messages:e.getMessages()}):n.type===`get-context`?t({type:`context`,state:e.getContextState()}):n.type===`get-executing`?t({type:`executing`,executing:e.isExecuting()}):n.type===`get-execution-workspace`?t({type:`execution_workspace_event`,snapshot:e.getExecutionWorkspaceSnapshot()}):t({type:`pending`,pending:e.getPendingPrompt()})}function S(e){let t=null,n=null;return{name:`ws`,onMessage:null,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);let r=u({session:t,send:e.send});n=r.cleanup,this.onMessage=r.onMessage},async stop(){n?.(),n=null,this.onMessage=null}}}const C=7070;var w=class{name=`ws`;defaultEnabled=!0;optionsSchema={port:{type:`number`,description:`WebSocket server port`,default:C},maxRetries:{type:`number`,description:`Port retry attempts when port is occupied`,default:20}};session=null;stopFn=null;port;maxRetries;constructor(e={}){this.port=e.port??C,this.maxRetries=e.maxRetries??20}attach(e){this.session=e}async start(){if(!this.session)throw Error(`WsTransport: attach() must be called before start()`);let e=await this.bindWithRetry(this.session,this.port,this.maxRetries);this.stopFn=e.stop}async stop(){await this.stopFn?.(),this.stopFn=null}validateOptions(e){let{port:t,maxRetries:n}=e;return!(t!==void 0&&(typeof t!=`number`||t<1||t>65535)||n!==void 0&&(typeof n!=`number`||n<0))}bindWithRetry(e,t,n){return this.tryBind(e,t).catch(r=>{if(r.code===`EADDRINUSE`&&n>0)return this.bindWithRetry(e,t+1,n-1);throw r})}tryBind(n,r){return new Promise((i,a)=>{let o=(0,e.createServer)((e,t)=>{t.writeHead(400).end(`WebSocket endpoint`)});o.on(`error`,e=>{o.close(),a(e)}),o.listen(r,`127.0.0.1`,()=>{let e=new t.WebSocketServer({server:o});e.on(`connection`,e=>{let r=n=>{e.readyState===t.WebSocket.OPEN&&e.send(JSON.stringify(n))},{onMessage:i,cleanup:a}=u({session:n,send:r});e.on(`message`,e=>i(String(e))),e.on(`close`,a),e.on(`error`,a),r({type:`messages`,messages:n.getMessages()}),r({type:`execution_workspace_event`,snapshot:n.getExecutionWorkspaceSnapshot()})}),i({stop:()=>new Promise(t=>{e.close(()=>o.close(()=>t()))})})})})}};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return w}});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@robota-sdk/agent-transport",
-  "version": "3.0.0-beta.65",
-  "description": "Consolidated transport package for Robota SDK — TUI, headless, HTTP, WebSocket, and MCP adapters",
+  "version": "3.0.0-beta.67",
+  "description": "Consolidated transport package for Robota SDK — headless, HTTP, WebSocket, and MCP adapters",
   "type": "module",
   "main": "dist/node/index.js",
   "types": "dist/node/index.d.ts",
@@ -18,18 +18,6 @@
         "require": "./dist/node/index.cjs"
       }
     },
-    "./tui": {
-      "types": "./dist/node/tui/index.d.ts",
-      "source": "./src/tui/index.ts",
-      "node": {
-        "import": "./dist/node/tui/index.js",
-        "require": "./dist/node/tui/index.cjs"
-      },
-      "default": {
-        "import": "./dist/node/tui/index.js",
-        "require": "./dist/node/tui/index.cjs"
-      }
-    },
     "./headless": {
       "types": "./dist/node/headless/index.d.ts",
       "source": "./src/headless/index.ts",
@@ -77,6 +65,18 @@
         "import": "./dist/node/mcp/index.js",
         "require": "./dist/node/mcp/index.cjs"
       }
+    },
+    "./tui": {
+      "types": "./dist/node/tui/index.d.ts",
+      "source": "./src/tui/index.ts",
+      "node": {
+        "import": "./dist/node/tui/index.js",
+        "require": "./dist/node/tui/index.cjs"
+      },
+      "default": {
+        "import": "./dist/node/tui/index.js",
+        "require": "./dist/node/tui/index.cjs"
+      }
     }
   },
   "repository": {
@@ -108,9 +108,10 @@
     "string-width": "^8.2.0",
     "ws": "^8.18.3",
     "zod": "^3.24.4",
-    "@robota-sdk/agent-core": "3.0.0-beta.65",
-    "@robota-sdk/agent-interface-transport": "3.0.0-beta.65",
-    "@robota-sdk/agent-framework": "3.0.0-beta.65"
+    "@robota-sdk/agent-core": "3.0.0-beta.67",
+    "@robota-sdk/agent-framework": "3.0.0-beta.67",
+    "@robota-sdk/agent-interface-tui": "3.0.0-beta.67",
+    "@robota-sdk/agent-interface-transport": "3.0.0-beta.67"
   },
   "devDependencies": {
     "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
@@ -123,7 +124,7 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
     "vitest": "^1.6.1",
-    "@robota-sdk/agent-command": "3.0.0-beta.65"
+    "@robota-sdk/agent-command": "3.0.0-beta.67"
   },
   "license": "MIT",
   "publishConfig": {

package/src/headless/cli-input.ts

@@ -0,0 +1,50 @@
+const PRINTABLE_ASCII_START = 32;
+
+export const promptInput = (label: string, masked = false): Promise<string> =>
+  new Promise<string>((resolve, reject) => {
+    process.stdout.write(label);
+    let input = '';
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw;
+    if (!stdin.isTTY) {
+      reject(
+        new Error(
+          'Cannot prompt for input: stdin is not a TTY.\n' +
+            'Set your API key via environment variable instead:\n' +
+            '  ANTHROPIC_API_KEY=<key> robota\n' +
+            '  OPENAI_API_KEY=<key> robota',
+        ),
+      );
+      return;
+    }
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding('utf8');
+    const onData = (data: string): void => {
+      for (const ch of data) {
+        if (ch === '\r' || ch === '\n') {
+          stdin.removeListener('data', onData);
+          stdin.setRawMode(wasRaw ?? false);
+          stdin.pause();
+          process.stdout.write('\n');
+          resolve(input.trim());
+          return;
+        } else if (ch === '\x7f' || ch === '\b') {
+          if (input.length > 0) {
+            input = input.slice(0, -1);
+            process.stdout.write('\b \b');
+          }
+        } else if (ch === '\x03') {
+          stdin.removeListener('data', onData);
+          stdin.setRawMode(wasRaw ?? false);
+          stdin.pause();
+          process.stdout.write('\n');
+          process.exit(0);
+        } else if (ch.charCodeAt(0) >= PRINTABLE_ASCII_START) {
+          input += ch;
+          process.stdout.write(masked ? '*' : ch);
+        }
+      }
+    };
+    stdin.on('data', onData);
+  });

package/src/headless/headless-runner.ts

@@ -1,6 +1,7 @@
-import type { IInteractiveSession, IExecutionResult } from '@robota-sdk/agent-framework';
 import { executeSlashCommandIfPresent, subscribeStreamJsonEvents } from './headless-stream-json.js';
 
+import type { IInteractiveSession, IExecutionResult } from '@robota-sdk/agent-framework';
+
 export type TOutputFormat = 'text' | 'json' | 'stream-json';
 
 export interface IHeadlessRunnerOptions {

package/src/headless/headless-stream-json.ts

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+
 import type {
   IInteractiveSession,
   IExecutionResult,

package/src/headless/headless-transport.ts

@@ -5,10 +5,11 @@
  * After start() completes, getExitCode() returns the runner's exit code.
  */
 
-import type { IInteractiveSession } from '@robota-sdk/agent-framework';
-import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
 import { createHeadlessRunner } from './headless-runner.js';
+
 import type { TOutputFormat } from './headless-runner.js';
+import type { IInteractiveSession } from '@robota-sdk/agent-framework';
+import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
 
 export interface IHeadlessTransportOptions {
   /** Output format: 'text', 'json', or 'stream-json'. */

package/src/headless/index.ts

@@ -1,3 +1,5 @@
+export { PrintTerminal } from './print-terminal.js';
+export { promptInput } from './cli-input.js';
 export { createHeadlessRunner } from './headless-runner.js';
 export type { IHeadlessRunnerOptions, TOutputFormat } from './headless-runner.js';
 export { createHeadlessTransport } from './headless-transport.js';

package/src/headless/print-terminal.ts

@@ -0,0 +1,57 @@
+/**
+ * ITerminalOutput implementation for print mode (-p).
+ *
+ * Writes to stdout/stderr directly. The readline-based prompt and select are
+ * only invoked if the agent triggers a permission-gated tool, which is rare in
+ * one-shot print mode but must still work correctly.
+ */
+
+import * as readline from 'node:readline';
+
+import type { ITerminalOutput, ISpinner } from '@robota-sdk/agent-core';
+
+export class PrintTerminal implements ITerminalOutput {
+  write(text: string): void {
+    process.stdout.write(text);
+  }
+  writeLine(text: string): void {
+    process.stdout.write(text + '\n');
+  }
+  writeMarkdown(md: string): void {
+    process.stdout.write(md);
+  }
+  writeError(text: string): void {
+    process.stderr.write(text + '\n');
+  }
+  prompt(question: string): Promise<string> {
+    return new Promise<string>((resolve) => {
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: false,
+        historySize: 0,
+      });
+      rl.question(question, (answer) => {
+        rl.close();
+        resolve(answer);
+      });
+    });
+  }
+  async select(options: string[], initialIndex = 0): Promise<number> {
+    for (let i = 0; i < options.length; i++) {
+      const marker = i === initialIndex ? '>' : ' ';
+      process.stdout.write(`  ${marker} ${i + 1}) ${options[i]}\n`);
+    }
+    const answer = await this.prompt(
+      `  Choose [1-${options.length}] (default: ${options[initialIndex]}): `,
+    );
+    const trimmed = answer.trim().toLowerCase();
+    if (trimmed === '') return initialIndex;
+    const num = parseInt(trimmed, 10);
+    if (!isNaN(num) && num >= 1 && num <= options.length) return num - 1;
+    return initialIndex;
+  }
+  spinner(_message: string): ISpinner {
+    return { stop(): void {}, update(): void {} };
+  }
+}

package/src/http/http-transport.ts

@@ -5,10 +5,10 @@
  * while exposing the underlying Hono app via getApp().
  */
 
-import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
-import type { IInteractiveSession } from '@robota-sdk/agent-framework';
-
 import { createAgentRoutes } from './routes.js';
+
+import type { IInteractiveSession } from '@robota-sdk/agent-framework';
+import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
 import type { Hono } from 'hono';
 
 export interface IHttpTransportOptions {

package/src/http/routes.ts

@@ -7,8 +7,9 @@
 
 import { Hono } from 'hono';
 import { streamSSE } from 'hono/streaming';
-import type { Context } from 'hono';
+
 import type { IInteractiveSession } from '@robota-sdk/agent-framework';
+import type { Context } from 'hono';
 
 /** Callback that resolves an IInteractiveSession from the request context. */
 export type TSessionFactory = (c: Context) => IInteractiveSession | Promise<IInteractiveSession>;

package/src/index.ts

@@ -1,5 +1,6 @@
-export * from './tui/index.js';
 export * from './headless/index.js';
 export * from './http/index.js';
 export * from './ws/index.js';
 export * from './mcp/index.js';
+export * from './tui/index.js';
+export { TransportRegistry, createDefaultTransportRegistry } from './transport-registry.js';

package/src/mcp/mcp-server.ts

@@ -8,6 +8,7 @@
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
 import type { IInteractiveSession, IExecutionResult } from '@robota-sdk/agent-framework';
 
 export interface IAgentMcpOptions {

package/src/mcp/mcp-transport.ts

@@ -5,10 +5,11 @@
  * while exposing the underlying MCP Server via getServer().
  */
 
-import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
-import type { IInteractiveSession } from '@robota-sdk/agent-framework';
 import { createAgentMcpServer } from './mcp-server.js';
+
 import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { IInteractiveSession } from '@robota-sdk/agent-framework';
+import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
 
 export interface IMcpTransportOptions {
   /** Name for the MCP server. */

package/src/transport-registry.ts

@@ -0,0 +1,100 @@
+/**
+ * TransportRegistry — manages IConfigurableTransport instances with settings-backed enable/disable.
+ *
+ * Settings file shape (under `transports` key in settings.json):
+ *   { "ws": { "enabled": true, "options": { "port": 7070 } } }
+ */
+
+import { getUserSettingsPath } from '@robota-sdk/agent-framework';
+import { readSettings, writeSettings, type TSettingsData } from '@robota-sdk/agent-framework';
+
+import { WsTransport } from './ws/index.js';
+
+import type { TUniversalValue } from '@robota-sdk/agent-core';
+import type { IInteractiveSession } from '@robota-sdk/agent-framework';
+import type {
+  IConfigurableTransport,
+  ITransportConfig,
+  ITransportEntry,
+} from '@robota-sdk/agent-interface-transport';
+
+export class TransportRegistry {
+  private readonly entries = new Map<string, IConfigurableTransport<IInteractiveSession>>();
+  private readonly settingsPath: string;
+
+  constructor(settingsPath: string) {
+    this.settingsPath = settingsPath;
+  }
+
+  register(transport: IConfigurableTransport<IInteractiveSession>): void {
+    this.entries.set(transport.name, transport);
+  }
+
+  getAll(): ITransportEntry<IInteractiveSession>[] {
+    const saved = this.readTransportSettings();
+    return Array.from(this.entries.values()).map((transport) => ({
+      transport,
+      config: this.resolveConfig(transport, saved[transport.name]),
+    }));
+  }
+
+  getEnabled(): IConfigurableTransport<IInteractiveSession>[] {
+    return this.getAll()
+      .filter((e) => e.config.enabled)
+      .map((e) => e.transport);
+  }
+
+  async setEnabled(name: string, enabled: boolean): Promise<void> {
+    const settings = readSettings(this.settingsPath);
+    const transports = (settings.transports ?? {}) as TSettingsData;
+    const entry = (transports[name] ?? {}) as TSettingsData;
+    transports[name] = { ...entry, enabled } as TSettingsData;
+    settings.transports = transports;
+    writeSettings(this.settingsPath, settings);
+  }
+
+  async setOptions(name: string, options: Record<string, TUniversalValue>): Promise<void> {
+    const settings = readSettings(this.settingsPath);
+    const transports = (settings.transports ?? {}) as TSettingsData;
+    const entry = (transports[name] ?? {}) as TSettingsData;
+    transports[name] = { ...entry, options: options as TSettingsData } as TSettingsData;
+    settings.transports = transports;
+    writeSettings(this.settingsPath, settings);
+  }
+
+  async startAll(session: IInteractiveSession): Promise<void> {
+    const enabled = this.getEnabled();
+    for (const transport of enabled) {
+      transport.attach(session);
+      await transport.start();
+    }
+  }
+
+  async stopAll(): Promise<void> {
+    for (const transport of this.entries.values()) {
+      await transport.stop();
+    }
+  }
+
+  private resolveConfig(
+    transport: IConfigurableTransport<IInteractiveSession>,
+    saved?: TSettingsData,
+  ): ITransportConfig {
+    const enabled = (saved?.enabled as boolean | undefined) ?? transport.defaultEnabled;
+    const options = (saved?.options as Record<string, TUniversalValue> | undefined) ?? {};
+    return { enabled, options };
+  }
+
+  private readTransportSettings(): Record<string, TSettingsData> {
+    const settings = readSettings(this.settingsPath);
+    const raw = settings.transports;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return {};
+    return raw as Record<string, TSettingsData>;
+  }
+}
+
+export function createDefaultTransportRegistry(): TransportRegistry {
+  const registry = new TransportRegistry(getUserSettingsPath());
+  registry.register(new WsTransport());
+  return registry;
+}

package/src/tui/App.tsx

@@ -1,47 +1,48 @@
-import React, { useState, useEffect, useMemo, useCallback } from 'react';
-import { Box, Text, useApp, useInput } from 'ink';
-import type { IAIProvider } from '@robota-sdk/agent-core';
-import type { TPermissionMode } from '@robota-sdk/agent-core';
-import type {
-  IBackgroundTaskRunner,
-  ICommandHostAdapters,
-  ICommandModule,
-  IInteractiveSession,
-  IInteractiveSessionStore,
-  TSubagentRunnerFactory,
-  TShellExecFn,
-  IExecutionDetailPage,
-} from '@robota-sdk/agent-framework';
-import { listResumableSessionSummaries } from '@robota-sdk/agent-framework';
 import { createSystemMessage, messageToHistoryEntry } from '@robota-sdk/agent-core';
-import type { ITransportRegistryView } from '@robota-sdk/agent-interface-transport';
+import { listResumableSessionSummaries } from '@robota-sdk/agent-framework';
+import { Box, Text, useApp, useInput } from 'ink';
+import React, { useState, useEffect, useMemo, useCallback, useRef } from 'react';
+
+import BackgroundTaskPanel from './BackgroundTaskPanel.js';
+import ConfirmPrompt from './ConfirmPrompt.js';
+import {
+  countActiveBackgroundWorkspaceEntries,
+  getDefaultBackgroundWorkspaceEntries,
+} from './execution-workspace-view-model.js';
+import ExecutionWorkspaceDetailPane from './ExecutionWorkspaceDetailPane.js';
+import ExecutionWorkspaceSwitcher from './ExecutionWorkspaceSwitcher.js';
+import { formatModelChangeConfirmationMessage } from './hooks/model-change-side-effect.js';
 import { useInteractiveSession } from './hooks/useInteractiveSession.js';
 import { usePluginCallbacks } from './hooks/usePluginCallbacks.js';
 import { useSideEffects } from './hooks/useSideEffects.js';
 import { useStatusLineSettings } from './hooks/useStatusLineSettings.js';
-import MessageList from './MessageList.js';
-import SessionStatusBar from './SessionStatusBar.js';
 import InputArea from './InputArea.js';
-import ConfirmPrompt from './ConfirmPrompt.js';
 import InteractivePrompt from './InteractivePrompt.js';
+import MessageList from './MessageList.js';
 import PermissionPrompt from './PermissionPrompt.js';
-import StreamingIndicator from './StreamingIndicator.js';
 import PluginTUI from './PluginTUI.js';
-import TransportTUI from './TransportTUI.js';
 import SessionPicker from './SessionPicker.js';
-import BackgroundTaskPanel from './BackgroundTaskPanel.js';
-import ExecutionWorkspaceSwitcher from './ExecutionWorkspaceSwitcher.js';
-import ExecutionWorkspaceDetailPane from './ExecutionWorkspaceDetailPane.js';
-import UpdateNotice from './UpdateNotice.js';
-import { formatModelChangeConfirmationMessage } from './hooks/model-change-side-effect.js';
-import {
-  countActiveBackgroundWorkspaceEntries,
-  getDefaultBackgroundWorkspaceEntries,
-} from './execution-workspace-view-model.js';
+import SessionStatusBar from './SessionStatusBar.js';
+import StreamingIndicator from './StreamingIndicator.js';
+import TransportTUI from './TransportTUI.js';
 import { TuiCliAdapterProvider } from './tui-cli-adapter-context.js';
+import UpdateNotice from './UpdateNotice.js';
+
 import type { ITuiCliAdapter } from './tui-cli-adapter.js';
+import type { TPermissionMode } from '@robota-sdk/agent-core';
+import type { IAIProvider } from '@robota-sdk/agent-core';
+import type {
+  IBackgroundTaskRunner,
+  ICommandHostAdapters,
+  ICommandModule,
+  IInteractiveSession,
+  IInteractiveSessionStore,
+  TSubagentRunnerFactory,
+  TShellExecFn,
+  IExecutionDetailPage,
+} from '@robota-sdk/agent-framework';
 import type { CommandRegistry } from '@robota-sdk/agent-framework';
-import type { ITuiCommandInteraction } from './command-interaction.js';
+import type { ITransportRegistryView } from '@robota-sdk/agent-interface-transport';
 
 interface IProps {
   cwd: string;
@@ -68,7 +69,6 @@ interface IProps {
   cliAdapter: ITuiCliAdapter;
   reloadPluginCommandSource?: (registry: CommandRegistry) => void;
   agentName?: string;
-  resolveInteraction?: (commandName: string) => ITuiCommandInteraction | undefined;
 }
 
 export default function App(props: IProps): React.ReactElement {
@@ -150,6 +150,7 @@ function AppInner(
   const [executionDetailError, setExecutionDetailError] = useState<string | undefined>();
   const [isExecutionDetailLoading, setIsExecutionDetailLoading] = useState(false);
   const [statusLineSettings, setStatusLineSettings] = useStatusLineSettings();
+  const [gitRefreshToken, setGitRefreshToken] = useState(0);
   const backgroundWorkspaceEntries = useMemo(
     () => getDefaultBackgroundWorkspaceEntries(executionWorkspaceSnapshot),
     [executionWorkspaceSnapshot],
@@ -219,6 +220,23 @@ function AppInner(
     [selectedExecutionEntry, handleSubmit, interactiveSession],
   );
 
+  const handleSubmitWithGitRefresh = useCallback(
+    async (input: string): Promise<void> => {
+      setGitRefreshToken((t) => t + 1);
+      await handleSubmitWithRouting(input);
+    },
+    [handleSubmitWithRouting],
+  );
+
+  // Refresh git branch when AI response completes.
+  const wasThinkingRef = useRef(false);
+  useEffect(() => {
+    if (wasThinkingRef.current && !isThinking) {
+      setGitRefreshToken((t) => t + 1);
+    }
+    wasThinkingRef.current = isThinking;
+  }, [isThinking]);
+
   // Sync session name from InteractiveSession when resuming
   useEffect(() => {
     const name = interactiveSession?.getName?.();
@@ -452,9 +470,10 @@ function AppInner(
         sessionName={sessionName}
         settings={statusLineSettings}
         activeAgentLabel={activeAgentLabel}
+        gitRefreshToken={gitRefreshToken}
       />
       <InputArea
-        onSubmit={handleSubmitWithRouting}
+        onSubmit={handleSubmitWithGitRefresh}
         onCancelQueue={handleCancelQueue}
         isDisabled={
           !!permissionRequest ||
@@ -472,7 +491,6 @@ function AppInner(
         registry={registry}
         sessionName={sessionName}
         history={history}
-        resolveInteraction={props.resolveInteraction}
       />
       {/* Permanent blank line below input — required for Korean IME stability. */}
       <Text> </Text>