agent-relay 2.1.4 → 2.1.6

package/packages/sdk/dist/transports/websocket-transport.js

@@ -0,0 +1,180 @@
+/**
+ * WebSocket Transport for browser and Node.js environments.
+ * @agent-relay/sdk
+ *
+ * Uses native WebSocket in browsers and 'ws' package in Node.js.
+ * The transport expects the daemon to have a WebSocket endpoint (e.g., /ws).
+ */
+/**
+ * WebSocket-based transport for browser and Node.js.
+ *
+ * In browsers, uses native WebSocket.
+ * In Node.js, requires 'ws' package (optional dependency).
+ */
+export class WebSocketTransport {
+    ws;
+    config;
+    events = {};
+    _state = 'disconnected';
+    WebSocketImpl;
+    constructor(config) {
+        this.config = {
+            connectTimeout: 5000,
+            ...config,
+        };
+    }
+    get state() {
+        return this._state;
+    }
+    setEvents(events) {
+        this.events = events;
+    }
+    /**
+     * Get WebSocket implementation (native or 'ws' package).
+     */
+    async getWebSocketImpl() {
+        if (this.WebSocketImpl) {
+            return this.WebSocketImpl;
+        }
+        // Check for browser environment
+        if (typeof globalThis !== 'undefined' && 'WebSocket' in globalThis) {
+            this.WebSocketImpl = globalThis.WebSocket;
+            return this.WebSocketImpl;
+        }
+        // Node.js environment - try to load 'ws' package
+        try {
+            // Dynamic import of 'ws' for Node.js
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const wsModule = await import('ws');
+            const impl = wsModule.default || wsModule.WebSocket || wsModule;
+            if (!impl) {
+                throw new Error('ws module loaded but WebSocket constructor not found');
+            }
+            this.WebSocketImpl = impl;
+            return this.WebSocketImpl;
+        }
+        catch {
+            throw new Error('WebSocket not available. In Node.js, install the "ws" package:\n' +
+                '  npm install ws\n\n' +
+                'In browsers, native WebSocket should be available.');
+        }
+    }
+    async connect() {
+        if (this._state !== 'disconnected') {
+            return;
+        }
+        const WebSocketImpl = await this.getWebSocketImpl();
+        return new Promise((resolve, reject) => {
+            this._state = 'connecting';
+            const timeout = setTimeout(() => {
+                if (this._state === 'connecting') {
+                    this.ws?.close();
+                    this._state = 'disconnected';
+                    reject(new Error('Connection timeout'));
+                }
+            }, this.config.connectTimeout);
+            try {
+                this.ws = new WebSocketImpl(this.config.url, this.config.protocols);
+                this.ws.binaryType = 'arraybuffer';
+                this.ws.onopen = () => {
+                    clearTimeout(timeout);
+                    this._state = 'connected';
+                    this.events.onConnect?.();
+                    resolve();
+                };
+                this.ws.onmessage = (event) => {
+                    // Handle binary data
+                    if (event.data instanceof ArrayBuffer) {
+                        this.events.onData?.(new Uint8Array(event.data));
+                    }
+                    else if (typeof event.data === 'string') {
+                        // Convert string to Uint8Array (shouldn't happen with binaryType = 'arraybuffer')
+                        const encoder = new TextEncoder();
+                        this.events.onData?.(encoder.encode(event.data));
+                    }
+                    else if (event.data && typeof event.data.buffer !== 'undefined') {
+                        // Handle Node.js Buffer
+                        const buf = event.data;
+                        this.events.onData?.(new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
+                    }
+                };
+                this.ws.onclose = () => {
+                    clearTimeout(timeout);
+                    this._state = 'disconnected';
+                    this.events.onClose?.();
+                };
+                this.ws.onerror = (event) => {
+                    clearTimeout(timeout);
+                    const error = event instanceof Error
+                        ? event
+                        : new Error('WebSocket error');
+                    if (this._state === 'connecting') {
+                        this._state = 'disconnected';
+                        reject(error);
+                    }
+                    this.events.onError?.(error);
+                };
+            }
+            catch (err) {
+                clearTimeout(timeout);
+                this._state = 'disconnected';
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    disconnect() {
+        if (!this.ws || this._state === 'disconnected') {
+            return;
+        }
+        this._state = 'closing';
+        this.ws.close();
+        this.ws = undefined;
+        this._state = 'disconnected';
+    }
+    send(data) {
+        if (!this.ws || this._state !== 'connected') {
+            return false;
+        }
+        try {
+            // WebSocket send accepts ArrayBuffer or Uint8Array
+            // Convert Buffer to Uint8Array for browser compatibility
+            let bytes;
+            if (data instanceof Uint8Array) {
+                bytes = data;
+            }
+            else {
+                // Handle Buffer (Node.js)
+                const buf = data;
+                bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+            }
+            this.ws.send(bytes);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Create a WebSocket transport.
+ *
+ * @param url - WebSocket URL (e.g., ws://localhost:3888/ws)
+ * @param config - Additional configuration options
+ */
+export function createWebSocketTransport(url, config) {
+    return new WebSocketTransport({ url, ...config });
+}
+/**
+ * Convert a socket path to WebSocket URL.
+ * Useful when daemon provides both Unix socket and WebSocket endpoints.
+ *
+ * @param host - Host address (default: localhost)
+ * @param port - Port number (default: 3888)
+ * @param path - WebSocket path (default: /ws)
+ * @param secure - Use wss:// instead of ws:// (default: false)
+ */
+export function socketPathToWsUrl(host = 'localhost', port = 3888, path = '/ws', secure = false) {
+    const protocol = secure ? 'wss' : 'ws';
+    return `${protocol}://${host}:${port}${path}`;
+}
+//# sourceMappingURL=websocket-transport.js.map

package/packages/sdk/dist/transports/websocket-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.js","sourceRoot":"","sources":["../../src/transports/websocket-transport.ts"],"names":[],"mappings":"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"}

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -24,6 +24,26 @@
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js",
       "default": "./dist/client.js"
+    },
+    "./browser": {
+      "types": "./dist/browser-client.d.ts",
+      "import": "./dist/browser-client.js",
+      "default": "./dist/browser-client.js"
+    },
+    "./transports": {
+      "types": "./dist/transports/index.d.ts",
+      "import": "./dist/transports/index.js",
+      "default": "./dist/transports/index.js"
+    },
+    "./discovery": {
+      "types": "./dist/discovery.d.ts",
+      "import": "./dist/discovery.js",
+      "default": "./dist/discovery.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js",
+      "default": "./dist/errors.js"
     }
   },
   "files": [
@@ -42,7 +62,9 @@
     "agent",
     "ai",
     "communication",
-    "sdk"
+    "sdk",
+    "websocket",
+    "browser"
   ],
   "author": "Khaliq Gant",
   "license": "Apache-2.0",
@@ -55,7 +77,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.1.4"
+    "@agent-relay/protocol": "2.1.6",
+    "@agent-relay/utils": "2.1.6"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -69,7 +92,8 @@
     }
   },
   "optionalDependencies": {
-    "@msgpack/msgpack": "^3.0.0"
+    "@msgpack/msgpack": "^3.0.0",
+    "ws": "^8.0.0"
   },
   "devDependencies": {
     "@agent-relay/daemon": "*",