@robota-sdk/agent-transport-ws 3.0.0-beta.46 → 3.0.0-beta.47

package/README.md

@@ -63,6 +63,26 @@ All messages are JSON-encoded objects with a `type` field.
 | `pending`        | `{ pending: string\|null }`         | get-pending response     |
 | `protocol_error` | `{ message: string }`               | invalid client message   |
 
+## ITransportAdapter
+
+The WebSocket transport implements the `ITransportAdapter` interface from `@robota-sdk/agent-sdk`:
+
+```typescript
+import { createWsTransport } from '@robota-sdk/agent-transport-ws';
+import type { ITransportAdapter } from '@robota-sdk/agent-sdk';
+
+const transport: ITransportAdapter = createWsTransport({
+  send: (msg) => ws.send(JSON.stringify(msg)),
+});
+
+transport.attach(interactiveSession);
+await transport.start();
+
+// Wire incoming messages
+ws.on('message', (data) => transport.onMessage(String(data)));
+ws.on('close', () => transport.stop());
+```
+
 ## Dependencies
 
 - `@robota-sdk/agent-sdk` — `InteractiveSession`

package/dist/node/index.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  createWsHandler: () => createWsHandler
+  createWsHandler: () => createWsHandler,
+  createWsTransport: () => createWsTransport
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -108,7 +109,32 @@ function createWsHandler(options) {
   };
   return { onMessage, cleanup };
 }
+
+// src/ws-transport.ts
+function createWsTransport(options) {
+  let session = null;
+  let cleanup = null;
+  return {
+    name: "ws",
+    onMessage: null,
+    attach(s) {
+      session = s;
+    },
+    async start() {
+      if (!session) throw new Error("No session attached. Call attach() first.");
+      const handler = createWsHandler({ session, send: options.send });
+      cleanup = handler.cleanup;
+      this.onMessage = handler.onMessage;
+    },
+    async stop() {
+      cleanup?.();
+      cleanup = null;
+      this.onMessage = null;
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createWsHandler
+  createWsHandler,
+  createWsTransport
 });

package/dist/node/index.d.cts

@@ -1,4 +1,4 @@
-import { InteractiveSession, IToolState, IExecutionResult } from '@robota-sdk/agent-sdk';
+import { InteractiveSession, IToolState, IExecutionResult, ITransportAdapter } from '@robota-sdk/agent-sdk';
 
 /**
  * WebSocket transport adapter — exposes InteractiveSession over WebSocket.
@@ -104,4 +104,19 @@ declare function createWsHandler(options: IWsHandlerOptions): {
     cleanup: () => void;
 };
 
-export { type IWsHandlerOptions, type TClientMessage, type TServerMessage, createWsHandler };
+/**
+ * ITransportAdapter implementation for WebSocket transport.
+ *
+ * Wraps createWsHandler into the unified ITransportAdapter interface.
+ * After start(), the consumer must wire onMessage to their WebSocket.
+ */
+
+interface IWsTransportOptions {
+    /** Send a JSON message to the connected WebSocket client. */
+    send: (message: TServerMessage) => void;
+}
+declare function createWsTransport(options: IWsTransportOptions): ITransportAdapter & {
+    onMessage: ((data: string) => void) | null;
+};
+
+export { type IWsHandlerOptions, type IWsTransportOptions, type TClientMessage, type TServerMessage, createWsHandler, createWsTransport };

package/dist/node/index.d.ts

@@ -1,4 +1,4 @@
-import { InteractiveSession, IToolState, IExecutionResult } from '@robota-sdk/agent-sdk';
+import { InteractiveSession, IToolState, IExecutionResult, ITransportAdapter } from '@robota-sdk/agent-sdk';
 
 /**
  * WebSocket transport adapter — exposes InteractiveSession over WebSocket.
@@ -104,4 +104,19 @@ declare function createWsHandler(options: IWsHandlerOptions): {
     cleanup: () => void;
 };
 
-export { type IWsHandlerOptions, type TClientMessage, type TServerMessage, createWsHandler };
+/**
+ * ITransportAdapter implementation for WebSocket transport.
+ *
+ * Wraps createWsHandler into the unified ITransportAdapter interface.
+ * After start(), the consumer must wire onMessage to their WebSocket.
+ */
+
+interface IWsTransportOptions {
+    /** Send a JSON message to the connected WebSocket client. */
+    send: (message: TServerMessage) => void;
+}
+declare function createWsTransport(options: IWsTransportOptions): ITransportAdapter & {
+    onMessage: ((data: string) => void) | null;
+};
+
+export { type IWsHandlerOptions, type IWsTransportOptions, type TClientMessage, type TServerMessage, createWsHandler, createWsTransport };

package/dist/node/index.js

@@ -82,6 +82,31 @@ function createWsHandler(options) {
   };
   return { onMessage, cleanup };
 }
+
+// src/ws-transport.ts
+function createWsTransport(options) {
+  let session = null;
+  let cleanup = null;
+  return {
+    name: "ws",
+    onMessage: null,
+    attach(s) {
+      session = s;
+    },
+    async start() {
+      if (!session) throw new Error("No session attached. Call attach() first.");
+      const handler = createWsHandler({ session, send: options.send });
+      cleanup = handler.cleanup;
+      this.onMessage = handler.onMessage;
+    },
+    async stop() {
+      cleanup?.();
+      cleanup = null;
+      this.onMessage = null;
+    }
+  };
+}
 export {
-  createWsHandler
+  createWsHandler,
+  createWsTransport
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-transport-ws",
-  "version": "3.0.0-beta.46",
+  "version": "3.0.0-beta.47",
   "description": "WebSocket transport adapter for exposing InteractiveSession over real-time connections",
   "type": "module",
   "main": "dist/node/index.js",
@@ -22,7 +22,7 @@
     "dist"
   ],
   "dependencies": {
-    "@robota-sdk/agent-sdk": "3.0.0-beta.46"
+    "@robota-sdk/agent-sdk": "3.0.0-beta.47"
   },
   "devDependencies": {
     "rimraf": "^5.0.5",