@ariaflowagents/livekit-plugin-transport-ws 0.9.0

package/dist/transport_adapter.d.ts

@@ -0,0 +1,34 @@
+import { TransportAdapter, type TransportAdapterConfig, type AudioEncoding } from '@ariaflow/livekit-plugin';
+import type { WebSocket } from 'ws';
+import { WebSocketAudioInput } from './audio_input.js';
+import { WebSocketAudioOutput } from './audio_output.js';
+import { WebSocketTextOutput } from './text_output.js';
+/**
+ * Bundles WebSocket I/O implementations into a single TransportAdapter.
+ */
+export declare class WebSocketTransportAdapter extends TransportAdapter {
+    private ws;
+    readonly id: string;
+    readonly audioInput: WebSocketAudioInput;
+    readonly audioOutput: WebSocketAudioOutput;
+    readonly textOutput: WebSocketTextOutput;
+    readonly config: TransportAdapterConfig;
+    private _isOpen;
+    /**
+     * Access the underlying WebSocket for raw I/O operations.
+     *
+     * Used by the realtime bridge (realtime_bridge.ts) and
+     * startNativeSession() to attach binary audio listeners
+     * directly on the socket without going through AudioInput/AudioOutput.
+     */
+    get rawSocket(): WebSocket;
+    constructor(ws: WebSocket, options?: {
+        id?: string;
+        sampleRate?: number;
+        numChannels?: number;
+        encoding?: AudioEncoding;
+    });
+    get isOpen(): boolean;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=transport_adapter.d.ts.map

package/dist/transport_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport_adapter.d.ts","sourceRoot":"","sources":["../src/transport_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;IAqB3D,OAAO,CAAC,EAAE;IApBZ,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAExC,OAAO,CAAC,OAAO,CAAiB;IAEhC;;;;;;OAMG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;gBAGS,EAAE,EAAE,SAAS,EACrB,OAAO,GAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,aAAa,CAAC;KACrB;IAoCR,IAAI,MAAM,IAAI,OAAO,CAEpB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY7B"}

package/dist/transport_adapter.js

@@ -0,0 +1,72 @@
+import { TransportAdapter, } from '@ariaflow/livekit-plugin';
+import { WebSocketAudioInput } from './audio_input.js';
+import { WebSocketAudioOutput } from './audio_output.js';
+import { WebSocketTextOutput } from './text_output.js';
+import { randomUUID } from 'node:crypto';
+/**
+ * Bundles WebSocket I/O implementations into a single TransportAdapter.
+ */
+export class WebSocketTransportAdapter extends TransportAdapter {
+    ws;
+    id;
+    audioInput;
+    audioOutput;
+    textOutput;
+    config;
+    _isOpen = true;
+    /**
+     * Access the underlying WebSocket for raw I/O operations.
+     *
+     * Used by the realtime bridge (realtime_bridge.ts) and
+     * startNativeSession() to attach binary audio listeners
+     * directly on the socket without going through AudioInput/AudioOutput.
+     */
+    get rawSocket() {
+        return this.ws;
+    }
+    constructor(ws, options = {}) {
+        super();
+        this.ws = ws;
+        this.id = options.id ?? randomUUID();
+        const sampleRate = options.sampleRate ?? 24000;
+        const numChannels = options.numChannels ?? 1;
+        const encoding = options.encoding ?? 'pcm_s16le';
+        this.config = {
+            sampleRate,
+            numChannels,
+            encoding,
+            samplesPerChannel: null,
+        };
+        this.audioInput = new WebSocketAudioInput(ws, sampleRate, numChannels);
+        this.audioOutput = new WebSocketAudioOutput(ws, this.id, sampleRate);
+        this.textOutput = new WebSocketTextOutput(ws, this.id);
+        ws.on('close', () => {
+            if (this._isOpen) {
+                this._isOpen = false;
+                void this.close();
+            }
+        });
+        ws.on('error', (err) => {
+            console.error('[WebSocketTransport] WebSocket error:', err.message);
+            if (this._isOpen) {
+                this._isOpen = false;
+                void this.close();
+            }
+        });
+    }
+    get isOpen() {
+        return this._isOpen;
+    }
+    async close() {
+        if (!this._isOpen)
+            return;
+        this._isOpen = false;
+        await this.audioInput.close();
+        await this.audioOutput.close();
+        await this.textOutput.close();
+        if (this.ws.readyState === this.ws.OPEN) {
+            this.ws.close(1000, 'Session ended');
+        }
+    }
+}
+//# sourceMappingURL=transport_adapter.js.map

package/dist/transport_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport_adapter.js","sourceRoot":"","sources":["../src/transport_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAqBnD;IApBD,EAAE,CAAS;IACX,UAAU,CAAsB;IAChC,WAAW,CAAuB;IAClC,UAAU,CAAsB;IAChC,MAAM,CAAyB;IAEhC,OAAO,GAAY,IAAI,CAAC;IAEhC;;;;;;OAMG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,YACU,EAAa,EACrB,UAKI,EAAE;QAEN,KAAK,EAAE,CAAC;QARA,OAAE,GAAF,EAAE,CAAW;QAUrB,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,UAAU,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;QAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAC;QAEjD,IAAI,CAAC,MAAM,GAAG;YACZ,UAAU;YACV,WAAW;YACX,QAAQ;YACR,iBAAiB,EAAE,IAAI;SACxB,CAAC;QAEF,IAAI,CAAC,UAAU,GAAG,IAAI,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACvE,IAAI,CAAC,WAAW,GAAG,IAAI,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,GAAG,IAAI,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAEvD,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;gBACrB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACrB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACpE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;gBACrB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAE9B,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+import type { IncomingMessage } from 'node:http';
+export interface WebSocketServerOptions {
+    /** Port to listen on. Default: 8080. */
+    port?: number;
+    /** Host to bind to. Default: '0.0.0.0'. */
+    host?: string;
+    /** Default audio sample rate. Default: 24000. */
+    defaultSampleRate?: number;
+    /** Default number of audio channels. Default: 1 (mono). */
+    defaultNumChannels?: number;
+    /** Optional authentication function. Return true to accept, false to reject. */
+    authenticate?: (req: IncomingMessage) => boolean | Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ariaflowagents/livekit-plugin-transport-ws",
+  "version": "0.9.0",
+  "description": "WebSocket transport adapter for LiveKit Agents. Run voice and text agents over plain WebSocket without a LiveKit server.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "preexample": "tsc",
+    "example:basic": "tsx examples/basic_ws_agent.ts",
+    "example:text": "tsx examples/text_only_ws_agent.ts",
+    "test": "bun test test",
+    "test:e2e:ws-native": "npx tsx test/e2e/ws-native-e2e.ts",
+    "test:e2e:ws-cascaded": "npx tsx test/e2e/ws-cascaded-e2e.ts",
+    "test:e2e:ws-native:debug": "NODE_DEBUG=* npx tsx test/e2e/ws-native-e2e.ts",
+    "test:e2e:ws-cascaded:debug": "NODE_DEBUG=* npx tsx test/e2e/ws-cascaded-e2e.ts"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "peerDependencies": {
+    "@ariaflowagents/livekit-plugin": "workspace:*",
+    "@ariaflowagents/core": "workspace:*",
+    "@livekit/agents": ">=1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/ws": "^8.5.0",
+    "tsx": "^4.19.0",
+    "ai": "^6.0.0",
+    "zod": "^3.23.0",
+    "@google/genai": "1.43.0",
+    "@ariaflowagents/gemini-native-audio": "workspace:*",
+    "@livekit/agents-plugin-silero": "^1.0.48"
+  },
+  "license": "Apache-2.0"
+}