@robota-sdk/agent-transport-ws 3.0.0-beta.79 → 3.0.0-beta.82

package/README.md

@@ -1,11 +1,21 @@
 # @robota-sdk/agent-transport-ws
 
-WebSocket transport and wire protocol for the Robota SDK. Consumers that only need the WS message
-types (e.g. browser monitors) depend on this package without pulling React/Ink/Hono.
+WebSocket carrier for the Robota SDK. The transport-neutral wire protocol, message types, and shared
+session handler belong to `@robota-sdk/agent-transport`; this package adapts them to WebSocket
+connections without pulling React, Ink, or Hono.
 
 ```typescript
-import { WsTransport, createWsHandler } from '@robota-sdk/agent-transport-ws';
-import type { TServerMessage, TClientMessage } from '@robota-sdk/agent-transport-ws';
+import { WsTransport } from '@robota-sdk/agent-transport-ws';
+import { createSessionMessageHandler } from '@robota-sdk/agent-transport';
+import type { TServerMessage, TClientMessage } from '@robota-sdk/agent-transport';
 ```
 
 See [docs/SPEC.md](./docs/SPEC.md) for the full contract.
+
+The carrier forwards plan, context-refresh, and branch events using the shared serializable event types.
+If a socket is not open or `send` fails asynchronously, the carrier runs one idempotent connection cleanup
+path and reports the delivery failure without throwing back through the committed session operation.
+
+Hosts may inject personal, stored-session, and current-session usage reporters when constructing the
+transport. Each admitted connection receives those capabilities through the shared protocol handler;
+the WebSocket transport itself never reads session stores or performs analytics.

package/dist/node/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});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).catch(e=>{t({type:`protocol_error`,message:e.message})})}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})},e=>{t({type:`protocol_error`,message:e.message})})}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()))})})})})}};exports.WsTransport=w,exports.createWsHandler=u,exports.createWsTransport=S;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@robota-sdk/agent-transport"),t=require("node:http"),n=require("ws"),r=require("node:crypto"),i=require("@robota-sdk/agent-transport/node");function a(t){let n=null,r=null,i=e=>Object.assign(Error(`WebSocket transport ${e}.`),{name:`TransportLifecycleError`,code:e,transportName:`ws`}),a={name:`ws`,lifecycle:Object.freeze({kind:`service`}),onMessage:null,attach(e){n=e},async start(){if(!n)throw i(`not-attached`);if(r)throw i(`already-started`);let o=(0,e.createOutboundDelivery)(t.send,(e,n)=>{s.cleanup(),r=null,a.onMessage=null,t.onDeliveryError?.(e,n)}),s=(0,e.createSessionMessageHandler)({session:n,deliver:o,...t.driverId?{driverId:t.driverId}:{},...t.surface?{surface:t.surface}:{},...t.personalUsageReporter?{personalUsageReporter:t.personalUsageReporter}:{},...t.usageReporter?{usageReporter:t.usageReporter}:{},...t.storedSessionUsageReporter?{storedSessionUsageReporter:t.storedSessionUsageReporter}:{}});r=s.cleanup,this.onMessage=s.onMessage},async stop(){r?.(),r=null,this.onMessage=null,n=null}};return a}var o=class t{channels=new Map;sinks=new Set;addSink(e){return this.sinks.add(e),()=>{this.sinks.delete(e)}}registerChannel(e){if(this.channels.has(e.name))throw Error(`Channel "${e.name}" is already registered on this transport`);let t={descriptor:e,declaredEvents:new Set(e.events),eventHandlers:new Map,binaryHandlers:new Set,seq:0,open:!0};return this.channels.set(e.name,t),this.createHandle(e,t)}receive(t){let n=(0,e.decodeChannelFrame)(t);if(!n.ok)return n;let{frame:r}=n,i=this.channels.get(r.channel);if(!i||!i.open)return{ok:!1,error:`No channel registered for "${r.channel}"`};if(r.kind===`binary`){if(i.descriptor.binary!==!0)return{ok:!1,error:`Channel "${r.channel}" did not declare binary payload support`};for(let e of[...i.binaryHandlers])e(r);return{ok:!0,frame:r}}if(!i.declaredEvents.has(r.event))return{ok:!1,error:`Channel "${r.channel}" did not declare event "${r.event}"`};let a=i.eventHandlers.get(r.event);if(a)for(let e of[...a])e(r.payload,r);return{ok:!0,frame:r}}broadcast(e){for(let t of[...this.sinks])t(e)}static assertOpen(e){if(!e.open)throw Error(`Channel "${e.descriptor.name}" is closed`)}createHandle(n,r){return{descriptor:n,sendEvent:(i,a)=>{if(t.assertOpen(r),!r.declaredEvents.has(i))throw Error(`Channel "${n.name}" did not declare event "${i}"`);let o=r.seq;r.seq+=1,this.broadcast((0,e.encodeChannelEventFrame)({kind:`event`,channel:n.name,seq:o,event:i,payload:a}))},sendBinary:i=>{if(t.assertOpen(r),n.binary!==!0)throw Error(`Channel "${n.name}" did not declare binary payload support`);let a=r.seq;r.seq+=1,this.broadcast((0,e.encodeBinaryFrame)({kind:`binary`,channel:n.name,seq:a,payload:i}))},onEvent:(e,i)=>{if(t.assertOpen(r),!r.declaredEvents.has(e))throw Error(`Channel "${n.name}" did not declare event "${e}"`);let a=r.eventHandlers.get(e)??new Set,o=i;return a.add(o),r.eventHandlers.set(e,a),()=>{a.delete(o)}},onBinary:e=>(t.assertOpen(r),r.binaryHandlers.add(e),()=>{r.binaryHandlers.delete(e)}),close:()=>{r.open=!1,r.eventHandlers.clear(),r.binaryHandlers.clear(),this.channels.delete(n.name)}}}};const s=new Set([`localhost`,`127.0.0.1`,`::1`,`[::1]`]);function c(e){if(!e)return null;if(e.startsWith(`[`))return e.slice(0,e.indexOf(`]`)+1)||null;let t=e.lastIndexOf(`:`);return t===-1?e:e.slice(0,t)}function l(e,t){let n=c(e.headers.host);return n===null?!1:s.has(n)||t.has(n)}function u(e,t){let n=e.headers.origin;if(n===void 0||t.has(n))return!0;try{return s.has(new URL(n).hostname)}catch{return!1}}function d(e,t){if(!t)return!1;let n=Buffer.from(e),i=Buffer.from(t);return n.length===i.length&&(0,r.timingSafeEqual)(n,i)}function f(e){try{let t=new URL(e.url??``,`ws://127.0.0.1`).searchParams.get(`token`);if(t)return t}catch{}let t=e.headers[`sec-websocket-protocol`];return typeof t==`string`&&t.split(`,`)[0]?.trim()||null}function p(e){return(0,i.resolveAdmission)({...e.token===void 0?{}:{token:e.token},...e.open===!0?{open:!0}:{},...e.openReason===void 0?{}:{openReason:e.openReason}})}function m(e){return Array.isArray(e)?new Uint8Array(Buffer.concat(e)):e instanceof ArrayBuffer?new Uint8Array(e):new Uint8Array(e.buffer,e.byteOffset,e.byteLength)}var h=class{socket;cleanupProtocol=()=>void 0;detachSink=()=>void 0;closed=!1;stallClock=(0,e.createPendingStallClock)();deliver;constructor(t){this.socket=t,this.deliver=(0,e.createOutboundDelivery)(e=>this.rawSend(e),()=>this.close(),()=>this.socket.bufferedAmount,e.DEFAULT_MAX_PENDING_BYTES,this.stallClock)}deliverBinary=t=>{if(!this.closed&&this.socket.readyState===n.WebSocket.OPEN){if((0,e.isOverPendingBudget)(this.socket.bufferedAmount)||this.stallClock.observe(this.socket.bufferedAmount)!==void 0){this.close();return}this.socket.send(t,{binary:!0},e=>{e&&this.close()})}};rawSend(e){if(this.socket.readyState!==n.WebSocket.OPEN)throw Error(`WebSocket is not open`);this.socket.send(JSON.stringify(e),e=>{e&&this.close()})}bindProtocolCleanup(e){this.cleanupProtocol=e}bindSinkDetach(e){this.detachSink=e}close=()=>{this.closed||(this.closed=!0,this.detachSink(),this.cleanupProtocol(),(this.socket.readyState===n.WebSocket.OPEN||this.socket.readyState===n.WebSocket.CONNECTING)&&this.socket.close(1011,`session event delivery failed`))}};function g(e){return{...e.personalUsageReporter?{personalUsageReporter:e.personalUsageReporter}:{},...e.usageReporter?{usageReporter:e.usageReporter}:{},...e.storedSessionUsageReporter?{storedSessionUsageReporter:e.storedSessionUsageReporter}:{}}}function _(e){return{...e.driverId?{driverId:e.driverId}:{},...e.surface?{surface:e.surface}:{},...g(e)}}function v(e){let{port:t,maxRetries:n}=e;return t!==void 0&&(typeof t!=`number`||t<1||t>65535)?!1:n===void 0||typeof n==`number`&&n>=0}function y(e,t){return Object.assign(Error(`${e} ${t}.`),{name:`TransportLifecycleError`,code:t,transportName:e})}var b=class{name=`ws`;lifecycle=Object.freeze({kind:`service`});defaultEnabled=!0;optionsSchema={port:{type:`number`,description:`WebSocket server port`,default:7070},maxRetries:{type:`number`,description:`Port retry attempts when port is occupied`,default:20}};session=null;stopFn=null;state=`detached`;startOperation;startCancelled=!1;port;maxRetries;token;allowedHosts;allowedOrigins;handlerOptions;channels=new o;resolvedPort;constructor(e={}){this.port=e.port??7070,this.maxRetries=e.maxRetries??20;let t=p(e);t.token!==null&&(this.token=t.token),this.allowedHosts=new Set(e.allowedHosts??[]),this.allowedOrigins=new Set(e.allowedOrigins??[]),this.handlerOptions=_(e)}attach(e){this.session=e,this.state=`attached`}registerChannel(e){return this.channels.registerChannel(e)}get boundPort(){return this.resolvedPort}get resolvedToken(){return this.token}async start(){if(!this.session)throw y(this.name,`not-attached`);if(this.state===`starting`||this.state===`ready`||this.state===`stopping`)throw y(this.name,`already-started`);this.state=`starting`,this.startCancelled=!1;let e=this.bindWithRetry(this.session,this.port,this.maxRetries);this.startOperation=e;let t;try{t=await e}catch(t){throw this.state===`starting`&&this.startOperation===e&&(this.startOperation=void 0,this.state=this.session?`attached`:`detached`),t}if(this.startCancelled||this.startOperation!==e)throw await t.stop(),this.state=this.session?`attached`:`detached`,Error(`WsTransport startup was stopped.`);this.stopFn=t.stop,this.resolvedPort=t.port,this.startOperation=void 0,this.state=`ready`}async stop(){if(this.state===`starting`){this.state=`stopping`,this.startCancelled=!0;try{await this.startOperation}catch{}}await this.stopFn?.(),this.stopFn=null,this.startOperation=void 0,this.resolvedPort=void 0,this.session=null,this.state=`detached`}configure(e){if(this.state!==`detached`&&this.state!==`attached`)throw y(this.name,`already-started`);if(!this.validateOptions(e))throw TypeError(`WsTransport options are invalid (port 1-65535, maxRetries >= 0).`);typeof e.port==`number`&&(this.port=e.port),typeof e.maxRetries==`number`&&(this.maxRetries=e.maxRetries)}validateOptions(e){return v(e)}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=(0,t.createServer)((e,t)=>{t.writeHead(400).end(`WebSocket endpoint`)});s.on(`error`,e=>{s.close(),o(e)});let c=this.token,p=this.allowedHosts,g=this.allowedOrigins,_=this.channels;s.listen(i,`127.0.0.1`,()=>{let t=new n.WebSocketServer({server:s,verifyClient:(e,t)=>{if(!l(e.req,p)){t(!1,403,`Forbidden host`);return}if(!u(e.req,g)){t(!1,403,`Forbidden origin`);return}t(!0)}});t.on(`connection`,(t,n)=>{if(c!==void 0&&!d(c,f(n))){t.close(1008,`unauthorized`);return}let i=new h(t),a=(0,e.createSessionMessageHandler)({session:r,deliver:i.deliver,...this.handlerOptions});i.bindProtocolCleanup(a.cleanup),i.bindSinkDetach(_.addSink(e=>i.deliverBinary(e))),t.on(`message`,(e,t)=>{if(!t){a.onMessage(String(e));return}let n=_.receive(m(e));n.ok||i.deliver({type:`protocol_error`,message:n.error})}),t.on(`close`,i.close),t.on(`error`,i.close),i.deliver({type:`messages`,messages:r.getMessages()}),i.deliver({type:`execution_workspace_event`,snapshot:r.getExecutionWorkspaceSnapshot()})}),a({port:i,stop:()=>new Promise(e=>{for(let e of t.clients)e.close(1001,`server shutting down`);let n=setTimeout(()=>{for(let e of t.clients)e.terminate()},5e3);t.close(()=>{clearTimeout(n),s.close(()=>e())})})})})})}};exports.PayloadChannelRegistry=o,exports.WsTransport=b,exports.createWsTransport=a;

package/dist/node/index.d.cts

@@ -0,0 +1,161 @@
+import { TUsageSurface } from "@robota-sdk/agent-interface-analytics";
+import { TDriverId } from "@robota-sdk/agent-interface-session";
+import { IChannelDescriptor, IConfigurableTransport, IPayloadChannel, IPayloadChannelHost, ITransportAdapter, TChannelEventMap, TChannelReceiveResult } from "@robota-sdk/agent-interface-transport";
+import { IProtocolSession, ISessionMessageHandlerOptions, TServerMessage } from "@robota-sdk/agent-transport";
+import { TUniversalValue } from "@robota-sdk/agent-core";
+//#region src/ws-transport.d.ts
+interface IWsTransportOptions {
+  /** Send a JSON message to the connected WebSocket client. */
+  send: (message: TServerMessage) => void;
+  /** Owning socket lifecycle callback for outbound session-event delivery failures. */
+  onDeliveryError?: (error: Error, event: string) => void;
+  personalUsageReporter?: ISessionMessageHandlerOptions['personalUsageReporter'];
+  usageReporter?: ISessionMessageHandlerOptions['usageReporter'];
+  storedSessionUsageReporter?: ISessionMessageHandlerOptions['storedSessionUsageReporter'];
+  driverId?: TDriverId;
+  surface?: TUsageSurface;
+}
+interface IWsTransport extends ITransportAdapter<IProtocolSession> {
+  onMessage: ((data: string) => void) | null;
+}
+declare function createWsTransport(options: IWsTransportOptions): IWsTransport;
+//#endregion
+//#region src/ws-transport-config.d.ts
+interface IWsTransportConfig {
+  /** Trusted server-assigned identity for turns submitted over this product surface. */
+  driverId?: TDriverId;
+  /** Trusted product surface, independent from the connection's driver identity. */
+  surface?: TUsageSurface;
+  /** Host-owned cross-session usage read model, forwarded unchanged to the protocol handler. */
+  personalUsageReporter?: ISessionMessageHandlerOptions['personalUsageReporter'];
+  /** Host-owned current-session trace/cost producer, forwarded unchanged to the protocol handler. */
+  usageReporter?: ISessionMessageHandlerOptions['usageReporter'];
+  /** Host-owned stored-session trace/cost producer for personal-usage drill-down. */
+  storedSessionUsageReporter?: ISessionMessageHandlerOptions['storedSessionUsageReporter'];
+  port?: number;
+  maxRetries?: number;
+  /**
+   * OPTIONAL explicit loopback auth token. When set, every connection MUST present a matching token
+   * (query param `?token=` or the `Sec-WebSocket-Protocol` subprotocol) or the socket is closed BEFORE any
+   * session data is emitted (GUI-002; the GUI sidecar sets `ROBOTA_WS_TOKEN`). SEC-001: when this is unset
+   * AND `open` is not `true`, the transport AUTO-MINTS a random per-launch token (secure by default) —
+   * `resolvedToken` exposes it so the surface can deliver it to the co-located client (a `0600` connection
+   * file / the served monitor's injected `ws-url`). An explicit token here wins over the auto-mint — but NOT
+   * over `open`: SEC-008 makes a token together with `open: true` a contradiction that throws, rather
+   * than a precedence one side quietly wins.
+   */
+  token?: string;
+  /**
+   * SEC-001 discouraged opt-out: when `true`, run WITHOUT auth (no token, no auto-mint) — the pre-SEC-001
+   * open loopback behavior. NOT RECOMMENDED (any local process or browser page can then drive+authorize the
+   * session); mirrors Jupyter's `c.ServerApp.token = ''`.
+   *
+   * SEC-008: `open: true` together with a non-empty `token` is REJECTED, not resolved by precedence. The
+   * two ask for opposite things, and picking a winner silently is how a caller ends up with the admission
+   * it did not choose. `resolveAdmission` decides that for every transport, so they cannot differ.
+   */
+  open?: boolean;
+  /** SEC-008: why running with no credential is correct here. Required when `open` is true. */
+  openReason?: string;
+  /**
+   * SEC-001 defense-in-depth: extra host names (beyond `localhost`/`127.0.0.1`/`::1`) accepted in the
+   * upgrade `Host` header. The `Host` allow-list closes DNS-rebinding independently of the token.
+   */
+  allowedHosts?: readonly string[];
+  /**
+   * SEC-001 defense-in-depth: extra browser `Origin`s (beyond loopback) accepted on the upgrade — e.g. the
+   * `apps/agent-web` app origin. A browser sends an unforgeable `Origin`; a non-browser client omits it (and
+   * is gated by the token instead). Closes the "any web page in any browser" hole before history is emitted.
+   */
+  allowedOrigins?: readonly string[];
+}
+//#endregion
+//#region src/ws-transport-configurable.d.ts
+/**
+ * TRANS-001: the WS transport is a payload-agnostic CARRIER that routes by WebSocket frame opcode —
+ * TEXT frames go to the text-agent protocol profile (`createSessionMessageHandler`), BINARY frames go to the
+ * consumer-declared channels. The two profiles share one connection and never constrain each other.
+ */
+declare class WsTransport implements IConfigurableTransport<IProtocolSession>, IPayloadChannelHost {
+  readonly name = "ws";
+  readonly lifecycle: Readonly<{
+    kind: "service";
+  }>;
+  readonly defaultEnabled = true;
+  readonly optionsSchema: {
+    port: {
+      type: string;
+      description: string;
+      default: number;
+    };
+    maxRetries: {
+      type: string;
+      description: string;
+      default: number;
+    };
+  };
+  private session;
+  private stopFn;
+  private state;
+  private startOperation;
+  private startCancelled;
+  private port;
+  private maxRetries;
+  private readonly token?;
+  private readonly allowedHosts;
+  private readonly allowedOrigins;
+  private readonly handlerOptions;
+  private readonly channels;
+  private resolvedPort?;
+  constructor(config?: IWsTransportConfig);
+  attach(session: IProtocolSession): void;
+  /**
+   * TRANS-001: declare an app-level channel carried on this transport's connections. The channel's
+   * events and opaque binary frames ride alongside the text-agent protocol on the SAME socket — the
+   * transport never inspects the payloads. Register before or after `start()`; a channel opened
+   * later is served by every already-connected client.
+   */
+  registerChannel<TEvents extends TChannelEventMap>(descriptor: IChannelDescriptor<TEvents>): IPayloadChannel<TEvents>;
+  /** Actually-bound port after start; undefined before start. */
+  get boundPort(): number | undefined;
+  /**
+   * SEC-001: the resolved auth token (explicit or auto-minted), or `undefined` in the discouraged `open`
+   * mode. The surface reads this to deliver the token to the co-located client (a `0600` connection file /
+   * the served monitor's injected `ws-url`). Never logged by the transport itself.
+   */
+  get resolvedToken(): string | undefined;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  /** TRANS-002 (issue #2480): persisted `port`/`maxRetries` reach the server through here, before start. */
+  configure(options: Record<string, TUniversalValue>): void;
+  validateOptions(options: Record<string, TUniversalValue>): boolean;
+  private bindWithRetry;
+  private tryBind;
+}
+//#endregion
+//#region src/payload-channels.d.ts
+/** Delivers an encoded frame to one attached connection. */
+type TChannelSink = (frame: Uint8Array) => void;
+declare class PayloadChannelRegistry implements IPayloadChannelHost {
+  private readonly channels;
+  private readonly sinks;
+  /**
+   * Attach a connection. Every frame a channel sends is fanned out to all attached sinks; the
+   * returned function detaches (call it on socket close).
+   */
+  addSink(sink: TChannelSink): () => void;
+  registerChannel<TEvents extends TChannelEventMap>(descriptor: IChannelDescriptor<TEvents>): IPayloadChannel<TEvents>;
+  /**
+   * Route one inbound encoded frame to its channel's handlers. The result states exactly what
+   * happened so the carrier can answer the peer (a `protocol_error`) instead of dropping it.
+   */
+  receive(bytes: Uint8Array): TChannelReceiveResult;
+  /** Fan one encoded frame out to every attached connection. */
+  private broadcast;
+  /** Assert the channel is still open before any send/subscribe. */
+  private static assertOpen;
+  private createHandle;
+}
+//#endregion
+export { type IWsTransport, type IWsTransportConfig, type IWsTransportOptions, PayloadChannelRegistry, type TChannelSink, WsTransport, createWsTransport };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/ws-transport.ts","../../src/ws-transport-config.ts","../../src/ws-transport-configurable.ts","../../src/payload-channels.ts"],"mappings":";;;;;;UAqBiB;;EAEf,OAAO,SAAS;;EAEhB,mBAAmB,OAAO,OAAO;EACjC,wBAAwB;EACxB,gBAAgB;EAChB,6BAA6B;EAC7B,WAAW;EACX,UAAU;;UAGK,qBAAqB,kBAAkB;EACtD,aAAa;;iBAGC,kBAAkB,SAAS,sBAAsB;;;UCpBhD;;EAEf,WAAW;;EAEX,UAAU;;EAEV,wBAAwB;;EAExB,gBAAgB;;EAEhB,6BAA6B;EAC7B;EACA;;;;;;;;;;;EAWA;;;;;;;;;;EAUA;;EAEA;;;;;EAKA;;;;;;EAMA;;;;;;;;;cCVW,uBACA,uBAAuB,mBAAmB;WAE5C;WACA,WAAS;;;WACT;WACA;;;;;;;;;;;;UASD;UACA;UACA;UACA;UACA;UACA;UACA;mBACS;mBACA;mBACA;mBACA;mBACA;UACT;EAEI,YAAA,SAAQ;EAYpB,OAAO,SAAS;;;;;;;EAWhB,gBAAgB,gBAAgB,kBAC9B,YAAY,mBAAmB,WAC9B,gBAAgB;;MAKf;;;;;;MASA;EAIE,SAAS;EA8BT,QAAQ;;EAmBd,UAAU,SAAS,eAAe;EAWlC,gBAAgB,SAAS,eAAe;UAIhC;UAYA;;;;;KC1KE,gBAAgB,OAAO;cAqBtB,kCAAkC;mBAC5B;mBACA;;;;;EAMjB,QAAQ,MAAM;EAOd,gBAAgB,gBAAgB,kBAC9B,YAAY,mBAAmB,WAC9B,gBAAgB;;;;;EAoBnB,QAAQ,OAAO,aAAa;;UAmCpB;;iBAKO;UAIP"}

package/dist/node/index.d.ts

@@ -1,187 +1,86 @@
-import { IBackgroundJobGroupState, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, IBackgroundTaskLogPage, IBackgroundTaskState, ICommandResult, IConfigurableTransport, IExecutionResult, IExecutionWorkspaceSnapshot, IInteractiveSession, IToolState, ITransportAdapter, TBackgroundJobGroupEvent, TBackgroundTaskEvent } from "@robota-sdk/agent-interface-transport";
+import { IProtocolSession, ISessionMessageHandlerOptions, TServerMessage } from "@robota-sdk/agent-transport";
+import { TUsageSurface } from "@robota-sdk/agent-interface-analytics";
+import { TDriverId } from "@robota-sdk/agent-interface-session";
+import { IChannelDescriptor, IConfigurableTransport, IPayloadChannel, IPayloadChannelHost, ITransportAdapter, TChannelEventMap, TChannelReceiveResult } from "@robota-sdk/agent-interface-transport";
 import { TUniversalValue } from "@robota-sdk/agent-core";
-
-//#region src/ws-protocol.d.ts
-type TBackgroundControlAction = 'cancel' | 'close' | 'send';
-/** Inbound message from client to server. */
-type TClientMessage = {
-  type: 'submit';
-  prompt: string;
-} | {
-  type: 'command';
-  name: string;
-  args?: string;
-} | {
-  type: 'abort';
-} | {
-  type: 'cancel-queue';
-} | {
-  type: 'get-messages';
-} | {
-  type: 'get-context';
-} | {
-  type: 'get-executing';
-} | {
-  type: 'get-pending';
-} | {
-  type: 'get-execution-workspace';
-} | {
-  type: 'get-background-tasks';
-  filter?: IBackgroundTaskListFilter;
-} | {
-  type: 'get-background-task';
-  taskId: string;
-} | {
-  type: 'get-background-job-groups';
-} | {
-  type: 'get-background-job-group';
-  groupId: string;
-} | {
-  type: 'wait-background-job-group';
-  groupId: string;
-} | {
-  type: 'cancel-background-task';
-  taskId: string;
-  reason?: string;
-} | {
-  type: 'close-background-task';
-  taskId: string;
-} | {
-  type: 'send-background-task';
-  taskId: string;
-  input: IBackgroundTaskInput;
-} | {
-  type: 'read-background-task-log';
-  taskId: string;
-  cursor?: IBackgroundTaskLogCursor;
-};
-/** Outbound message from server to client. */
-type TServerMessage = {
-  type: 'text_delta';
-  delta: string;
-} | {
-  type: 'user_message';
-  content: string;
-} | {
-  type: 'tool_start';
-  state: IToolState;
-} | {
-  type: 'tool_end';
-  state: IToolState;
-} | {
-  type: 'thinking';
-  isThinking: boolean;
-} | {
-  type: 'complete';
-  result: IExecutionResult;
-} | {
-  type: 'interrupted';
-  result: IExecutionResult;
-} | {
-  type: 'error';
-  message: string;
-} | {
-  type: 'command_result';
-  name: string;
-  message: string;
-  success: boolean;
-  data?: ICommandResult['data'];
-} | {
-  type: 'messages';
-  messages: ReturnType<IInteractiveSession['getMessages']>;
-} | {
-  type: 'context';
-  state: ReturnType<IInteractiveSession['getContextState']>;
-} | {
-  type: 'executing';
-  executing: boolean;
-} | {
-  type: 'pending';
-  pending: string | null;
-} | {
-  type: 'execution_workspace_event';
-  snapshot: IExecutionWorkspaceSnapshot;
-} | {
-  type: 'background_task_event';
-  event: TBackgroundTaskEvent;
-} | {
-  type: 'background_job_group_event';
-  event: TBackgroundJobGroupEvent;
-} | {
-  type: 'background_tasks';
-  tasks: IBackgroundTaskState[];
-} | {
-  type: 'background_task';
-  taskId: string;
-  task: IBackgroundTaskState | null;
-} | {
-  type: 'background_job_groups';
-  groups: IBackgroundJobGroupState[];
-} | {
-  type: 'background_job_group';
-  groupId: string;
-  group: IBackgroundJobGroupState | null;
-} | {
-  type: 'background_task_log';
-  taskId: string;
-  page: IBackgroundTaskLogPage;
-} | {
-  type: 'background_task_control_result';
-  action: TBackgroundControlAction;
-  taskId: string;
-  success: boolean;
-  message?: string;
-} | {
-  type: 'protocol_error';
-  message: string;
-};
-//#endregion
-//#region src/ws-handler.d.ts
-interface IWsHandlerOptions {
-  /** IInteractiveSession to expose. */
-  session: IInteractiveSession;
-  /** Send a JSON message to the client. */
-  send: (message: TServerMessage) => void;
-}
-/**
- * Create a WebSocket message handler for an IInteractiveSession.
- *
- * Returns:
- * - `onMessage(data)`: call this when the WebSocket receives a message
- * - `cleanup()`: call this when the WebSocket disconnects
- *
- * Usage:
- * ```typescript
- * const { onMessage, cleanup } = createWsHandler({
- *   session: interactiveSession,
- *   send: (msg) => ws.send(JSON.stringify(msg)),
- * });
- *
- * ws.on('message', (data) => onMessage(String(data)));
- * ws.on('close', cleanup);
- * ```
- */
-declare function createWsHandler(options: IWsHandlerOptions): {
-  onMessage: (data: string) => void;
-  cleanup: () => void;
-};
-//#endregion
 //#region src/ws-transport.d.ts
 interface IWsTransportOptions {
   /** Send a JSON message to the connected WebSocket client. */
   send: (message: TServerMessage) => void;
+  /** Owning socket lifecycle callback for outbound session-event delivery failures. */
+  onDeliveryError?: (error: Error, event: string) => void;
+  personalUsageReporter?: ISessionMessageHandlerOptions['personalUsageReporter'];
+  usageReporter?: ISessionMessageHandlerOptions['usageReporter'];
+  storedSessionUsageReporter?: ISessionMessageHandlerOptions['storedSessionUsageReporter'];
+  driverId?: TDriverId;
+  surface?: TUsageSurface;
 }
-declare function createWsTransport(options: IWsTransportOptions): ITransportAdapter<IInteractiveSession> & {
+interface IWsTransport extends ITransportAdapter<IProtocolSession> {
   onMessage: ((data: string) => void) | null;
-};
+}
+declare function createWsTransport(options: IWsTransportOptions): IWsTransport;
 //#endregion
-//#region src/ws-transport-configurable.d.ts
+//#region src/ws-transport-config.d.ts
 interface IWsTransportConfig {
+  /** Trusted server-assigned identity for turns submitted over this product surface. */
+  driverId?: TDriverId;
+  /** Trusted product surface, independent from the connection's driver identity. */
+  surface?: TUsageSurface;
+  /** Host-owned cross-session usage read model, forwarded unchanged to the protocol handler. */
+  personalUsageReporter?: ISessionMessageHandlerOptions['personalUsageReporter'];
+  /** Host-owned current-session trace/cost producer, forwarded unchanged to the protocol handler. */
+  usageReporter?: ISessionMessageHandlerOptions['usageReporter'];
+  /** Host-owned stored-session trace/cost producer for personal-usage drill-down. */
+  storedSessionUsageReporter?: ISessionMessageHandlerOptions['storedSessionUsageReporter'];
   port?: number;
   maxRetries?: number;
+  /**
+   * OPTIONAL explicit loopback auth token. When set, every connection MUST present a matching token
+   * (query param `?token=` or the `Sec-WebSocket-Protocol` subprotocol) or the socket is closed BEFORE any
+   * session data is emitted (GUI-002; the GUI sidecar sets `ROBOTA_WS_TOKEN`). SEC-001: when this is unset
+   * AND `open` is not `true`, the transport AUTO-MINTS a random per-launch token (secure by default) —
+   * `resolvedToken` exposes it so the surface can deliver it to the co-located client (a `0600` connection
+   * file / the served monitor's injected `ws-url`). An explicit token here wins over the auto-mint — but NOT
+   * over `open`: SEC-008 makes a token together with `open: true` a contradiction that throws, rather
+   * than a precedence one side quietly wins.
+   */
+  token?: string;
+  /**
+   * SEC-001 discouraged opt-out: when `true`, run WITHOUT auth (no token, no auto-mint) — the pre-SEC-001
+   * open loopback behavior. NOT RECOMMENDED (any local process or browser page can then drive+authorize the
+   * session); mirrors Jupyter's `c.ServerApp.token = ''`.
+   *
+   * SEC-008: `open: true` together with a non-empty `token` is REJECTED, not resolved by precedence. The
+   * two ask for opposite things, and picking a winner silently is how a caller ends up with the admission
+   * it did not choose. `resolveAdmission` decides that for every transport, so they cannot differ.
+   */
+  open?: boolean;
+  /** SEC-008: why running with no credential is correct here. Required when `open` is true. */
+  openReason?: string;
+  /**
+   * SEC-001 defense-in-depth: extra host names (beyond `localhost`/`127.0.0.1`/`::1`) accepted in the
+   * upgrade `Host` header. The `Host` allow-list closes DNS-rebinding independently of the token.
+   */
+  allowedHosts?: readonly string[];
+  /**
+   * SEC-001 defense-in-depth: extra browser `Origin`s (beyond loopback) accepted on the upgrade — e.g. the
+   * `apps/agent-web` app origin. A browser sends an unforgeable `Origin`; a non-browser client omits it (and
+   * is gated by the token instead). Closes the "any web page in any browser" hole before history is emitted.
+   */
+  allowedOrigins?: readonly string[];
 }
-declare class WsTransport implements IConfigurableTransport<IInteractiveSession> {
+//#endregion
+//#region src/ws-transport-configurable.d.ts
+/**
+ * TRANS-001: the WS transport is a payload-agnostic CARRIER that routes by WebSocket frame opcode —
+ * TEXT frames go to the text-agent protocol profile (`createSessionMessageHandler`), BINARY frames go to the
+ * consumer-declared channels. The two profiles share one connection and never constrain each other.
+ */
+declare class WsTransport implements IConfigurableTransport<IProtocolSession>, IPayloadChannelHost {
   readonly name = "ws";
+  readonly lifecycle: Readonly<{
+    kind: "service";
+  }>;
   readonly defaultEnabled = true;
   readonly optionsSchema: {
     port: {
@@ -197,16 +96,66 @@ declare class WsTransport implements IConfigurableTransport<IInteractiveSession>
   };
   private session;
   private stopFn;
-  private readonly port;
-  private readonly maxRetries;
+  private state;
+  private startOperation;
+  private startCancelled;
+  private port;
+  private maxRetries;
+  private readonly token?;
+  private readonly allowedHosts;
+  private readonly allowedOrigins;
+  private readonly handlerOptions;
+  private readonly channels;
+  private resolvedPort?;
   constructor(config?: IWsTransportConfig);
-  attach(session: IInteractiveSession): void;
+  attach(session: IProtocolSession): void;
+  /**
+   * TRANS-001: declare an app-level channel carried on this transport's connections. The channel's
+   * events and opaque binary frames ride alongside the text-agent protocol on the SAME socket — the
+   * transport never inspects the payloads. Register before or after `start()`; a channel opened
+   * later is served by every already-connected client.
+   */
+  registerChannel<TEvents extends TChannelEventMap>(descriptor: IChannelDescriptor<TEvents>): IPayloadChannel<TEvents>;
+  /** Actually-bound port after start; undefined before start. */
+  get boundPort(): number | undefined;
+  /**
+   * SEC-001: the resolved auth token (explicit or auto-minted), or `undefined` in the discouraged `open`
+   * mode. The surface reads this to deliver the token to the co-located client (a `0600` connection file /
+   * the served monitor's injected `ws-url`). Never logged by the transport itself.
+   */
+  get resolvedToken(): string | undefined;
   start(): Promise<void>;
   stop(): Promise<void>;
+  /** TRANS-002 (issue #2480): persisted `port`/`maxRetries` reach the server through here, before start. */
+  configure(options: Record<string, TUniversalValue>): void;
   validateOptions(options: Record<string, TUniversalValue>): boolean;
   private bindWithRetry;
   private tryBind;
 }
 //#endregion
-export { type IWsHandlerOptions, type IWsTransportConfig, type IWsTransportOptions, type TClientMessage, type TServerMessage, WsTransport, createWsHandler, createWsTransport };
+//#region src/payload-channels.d.ts
+/** Delivers an encoded frame to one attached connection. */
+type TChannelSink = (frame: Uint8Array) => void;
+declare class PayloadChannelRegistry implements IPayloadChannelHost {
+  private readonly channels;
+  private readonly sinks;
+  /**
+   * Attach a connection. Every frame a channel sends is fanned out to all attached sinks; the
+   * returned function detaches (call it on socket close).
+   */
+  addSink(sink: TChannelSink): () => void;
+  registerChannel<TEvents extends TChannelEventMap>(descriptor: IChannelDescriptor<TEvents>): IPayloadChannel<TEvents>;
+  /**
+   * Route one inbound encoded frame to its channel's handlers. The result states exactly what
+   * happened so the carrier can answer the peer (a `protocol_error`) instead of dropping it.
+   */
+  receive(bytes: Uint8Array): TChannelReceiveResult;
+  /** Fan one encoded frame out to every attached connection. */
+  private broadcast;
+  /** Assert the channel is still open before any send/subscribe. */
+  private static assertOpen;
+  private createHandle;
+}
+//#endregion
+export { type IWsTransport, type IWsTransportConfig, type IWsTransportOptions, PayloadChannelRegistry, type TChannelSink, WsTransport, createWsTransport };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ws-protocol.ts","../../src/ws-handler.ts","../../src/ws-transport.ts","../../src/ws-transport-configurable.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ws-transport.ts","../../src/ws-transport-config.ts","../../src/ws-transport-configurable.ts","../../src/payload-channels.ts"],"mappings":";;;;;;UAqBiB;;EAEf,OAAO,SAAS;;EAEhB,mBAAmB,OAAO,OAAO;EACjC,wBAAwB;EACxB,gBAAgB;EAChB,6BAA6B;EAC7B,WAAW;EACX,UAAU;;UAGK,qBAAqB,kBAAkB;EACtD,aAAa;;iBAGC,kBAAkB,SAAS,sBAAsB;;;UCpBhD;;EAEf,WAAW;;EAEX,UAAU;;EAEV,wBAAwB;;EAExB,gBAAgB;;EAEhB,6BAA6B;EAC7B;EACA;;;;;;;;;;;EAWA;;;;;;;;;;EAUA;;EAEA;;;;;EAKA;;;;;;EAMA;;;;;;;;;cCVW,uBACA,uBAAuB,mBAAmB;WAE5C;WACA,WAAS;;;WACT;WACA;;;;;;;;;;;;UASD;UACA;UACA;UACA;UACA;UACA;UACA;mBACS;mBACA;mBACA;mBACA;mBACA;UACT;EAEI,YAAA,SAAQ;EAYpB,OAAO,SAAS;;;;;;;EAWhB,gBAAgB,gBAAgB,kBAC9B,YAAY,mBAAmB,WAC9B,gBAAgB;;MAKf;;;;;;MASA;EAIE,SAAS;EA8BT,QAAQ;;EAmBd,UAAU,SAAS,eAAe;EAWlC,gBAAgB,SAAS,eAAe;UAIhC;UAYA;;;;;KC1KE,gBAAgB,OAAO;cAqBtB,kCAAkC;mBAC5B;mBACA;;;;;EAMjB,QAAQ,MAAM;EAOd,gBAAgB,gBAAgB,kBAC9B,YAAY,mBAAmB,WAC9B,gBAAgB;;;;;EAoBnB,QAAQ,OAAO,aAAa;;UAmCpB;;iBAKO;UAIP"}