@voxevolv/client 0.3.15 → 0.3.17

package/dist/presentations.d.ts

@@ -0,0 +1,20 @@
+type SendRpc = (request: {
+    destinationIdentity: string;
+    method: string;
+    payload: string;
+    responseTimeout: number;
+}) => Promise<string>;
+/** Keeps concurrent and later deliveries of one presentation on the same promise. */
+export declare class Presentations {
+    private readonly send;
+    private readonly isClosed;
+    private readonly receiptFailed;
+    private readonly results;
+    constructor(send: SendRpc, isClosed: () => boolean, receiptFailed: () => void);
+    invoke(id: string, worker: string, execute: () => Promise<string>): Promise<string>;
+    private execute;
+    private complete;
+    private request;
+}
+export {};
+//# sourceMappingURL=presentations.d.ts.map

package/dist/presentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.d.ts","sourceRoot":"","sources":["../src/presentations.ts"],"names":[],"mappings":"AAMA,KAAK,OAAO,GAAG,CAAC,OAAO,EAAE;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAItB,qFAAqF;AACrF,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa;IALhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,YACmB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,OAAO,EACvB,aAAa,EAAE,MAAM,IAAI,EACxC;IAEJ,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlF;YAEa,OAAO;IAuCrB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,OAAO;CAMhB"}

package/dist/presentations.js

@@ -0,0 +1,91 @@
+import { RpcError } from "livekit-client";
+const PRESENTATION_METHOD = "voxevolv.presentation";
+const MAX_CACHED_PRESENTATIONS = 64;
+const MAX_RESULT_BYTES = 65_536;
+/** Keeps concurrent and later deliveries of one presentation on the same promise. */
+export class Presentations {
+    send;
+    isClosed;
+    receiptFailed;
+    results = new Map();
+    constructor(send, isClosed, receiptFailed) {
+        this.send = send;
+        this.isClosed = isClosed;
+        this.receiptFailed = receiptFailed;
+    }
+    invoke(id, worker, execute) {
+        const key = JSON.stringify([worker, id]);
+        const existing = this.results.get(key);
+        if (existing)
+            return existing.response;
+        if (this.results.size >= MAX_CACHED_PRESENTATIONS) {
+            const settled = [...this.results].find(([, item]) => item.settled);
+            if (!settled)
+                return Promise.reject(new RpcError(1500, "Too many pending presentations"));
+            this.results.delete(settled[0]);
+        }
+        // Defer execution until after insertion so reentrant calls also share ownership.
+        const cached = {
+            response: Promise.resolve().then(() => this.execute(id, worker, execute)),
+            settled: false,
+        };
+        this.results.set(key, cached);
+        void cached.response.then(() => { cached.settled = true; }, () => { cached.settled = true; });
+        return cached.response;
+    }
+    async execute(id, worker, execute) {
+        if (this.isClosed())
+            throw new RpcError(1500, "Session has ended");
+        const startedAt = performance.now();
+        let grant;
+        try {
+            grant = JSON.parse(await this.request(id, worker, { action: "claim" }));
+        }
+        catch (error) {
+            // No handler ran. A later delivery may retry authorization; the worker
+            // still rejects a second claim if the first response was merely lost.
+            // This pending entry cannot have been evicted or replaced in the cache.
+            this.results.delete(JSON.stringify([worker, id]));
+            throw error;
+        }
+        if (typeof grant.response === "string")
+            return grant.response;
+        if (typeof grant.error === "string")
+            throw new RpcError(1500, grant.error);
+        // Deduct the entire round trip, conservatively, without comparing wall clocks.
+        // A frozen tab must not execute a grant that sat waiting in its event queue.
+        if (this.isClosed() || typeof grant.remaining_ms !== "number"
+            || !Number.isFinite(grant.remaining_ms)
+            || performance.now() - startedAt >= grant.remaining_ms) {
+            throw new RpcError(1500, "Presentation authorization expired");
+        }
+        let response;
+        try {
+            response = await execute();
+            if (new TextEncoder().encode(response).byteLength > MAX_RESULT_BYTES) {
+                throw new RpcError(1500, "Presentation result is too large");
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Presentation failed";
+            this.complete(id, worker, { error: message.slice(0, 1000) });
+            throw error;
+        }
+        this.complete(id, worker, { response });
+        return response;
+    }
+    complete(id, worker, result) {
+        // Do not delay the original RPC response. This independent receipt can reconcile
+        // an outcome after its original caller has already stopped waiting.
+        void this.request(id, worker, { action: "complete", ...result }).catch(() => {
+            this.receiptFailed();
+        });
+    }
+    request(id, worker, payload) {
+        return this.send({
+            destinationIdentity: worker, method: PRESENTATION_METHOD,
+            payload: JSON.stringify({ operation_id: id, ...payload }), responseTimeout: 2_000,
+        });
+    }
+}
+//# sourceMappingURL=presentations.js.map

package/dist/presentations.js.map

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

package/dist/rpc-transport-diagnostics.d.ts

@@ -0,0 +1,6 @@
+import type { ClientDiagnosticInput } from "./diagnostics.js";
+/** Observe the pinned LiveKit build; never inspect or retain RPC arguments/results.
+ * A channel_send means RTCDataChannel.send returned, not remote receipt.
+ */
+export declare function observeRpcTransport(engineValue: unknown, record: (entry: ClientDiagnosticInput) => void): () => void;
+//# sourceMappingURL=rpc-transport-diagnostics.d.ts.map

package/dist/rpc-transport-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-transport-diagnostics.d.ts","sourceRoot":"","sources":["../src/rpc-transport-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAwB9D;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAC7C,MAAM,IAAI,CAuEZ"}

package/dist/rpc-transport-diagnostics.js

@@ -0,0 +1,84 @@
+/** Observe the pinned LiveKit build; never inspect or retain RPC arguments/results.
+ * A channel_send means RTCDataChannel.send returned, not remote receipt.
+ */
+export function observeRpcTransport(engineValue, record) {
+    const engine = engineValue;
+    const streams = new Map();
+    function metadata(packet, incoming) {
+        const value = packet.value?.value;
+        if (!value)
+            return;
+        const kind = packet.value?.case;
+        if (kind === "rpcRequest" || kind === "rpcAck" || kind === "rpcResponse") {
+            // Inline requests call their identifier `id`; ACKs/responses use requestId.
+            const requestId = kind === "rpcRequest" ? value.id : value.requestId;
+            if (!requestId)
+                return;
+            const packetKinds = { rpcRequest: "request", rpcAck: "ack", rpcResponse: "response" };
+            return { rpc_request_id: requestId, rpc_packet: packetKinds[kind] };
+        }
+        const key = `${incoming ? "in" : "out"}:${value.streamId}`;
+        if (kind === "streamHeader" && value.streamId
+            && (value.topic === "lk.rpc_request" || value.topic === "lk.rpc_response")) {
+            const requestId = value.attributes?.["lk.rpc_request_id"];
+            if (!requestId)
+                return;
+            const now = performance.now();
+            for (const [id, stream] of streams) {
+                if (now - stream.at >= 300_000)
+                    streams.delete(id);
+            }
+            if (streams.size >= 128)
+                streams.delete(streams.keys().next().value);
+            const rpcKind = value.topic === "lk.rpc_request" ? "request" : "response";
+            streams.set(key, { requestId, kind: rpcKind, at: now });
+            return { rpc_request_id: requestId, rpc_packet: `${rpcKind}_header` };
+        }
+        if (kind === "streamTrailer") {
+            const stream = streams.get(key);
+            streams.delete(key);
+            if (stream)
+                return { rpc_request_id: stream.requestId, rpc_packet: `${stream.kind}_end` };
+        }
+    }
+    function observer(packet, incoming) {
+        const info = metadata(packet, incoming);
+        if (!info)
+            return;
+        const started = performance.now();
+        return (stage) => {
+            try {
+                const channel = engine.dataChannelForKind(0, incoming);
+                record({
+                    operation: "rpc_transport", ...info, stage,
+                    status: stage === "publish_failed" || stage === "channel_unavailable" ? "failed" : "started",
+                    duration_ms: performance.now() - started,
+                    channel_state: channel?.readyState,
+                    buffered_bytes: channel?.bufferedAmount,
+                });
+            }
+            catch {
+                // Observers must never alter a packet's delivery or exception.
+            }
+        };
+    }
+    const outgoing = (packet) => observer(packet, false);
+    const incoming = (packet) => {
+        try {
+            observer(packet, true)?.("transport_received");
+        }
+        catch {
+            // A malformed diagnostic observation must not interrupt Room's listener.
+        }
+    };
+    engine.voxevolvObserveRpcPacket = outgoing;
+    // Observe decoded receipt before Room starts ACK publication or the handler.
+    engine.prependListener("dataPacketReceived", incoming);
+    return () => {
+        if (engine.voxevolvObserveRpcPacket === outgoing)
+            delete engine.voxevolvObserveRpcPacket;
+        engine.off("dataPacketReceived", incoming);
+        streams.clear();
+    };
+}
+//# sourceMappingURL=rpc-transport-diagnostics.js.map

package/dist/rpc-transport-diagnostics.js.map

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

package/dist/vendor/livekit-client.esm.mjs

@@ -16249,6 +16249,7 @@ class WebSocketStream {
           reason = _ref3.reason;
         resolve({
           closeCode: code,
+          wasClean: _ref3.wasClean,
           reason
         });
         ws.removeEventListener('error', rejectHandler);
@@ -16428,6 +16429,13 @@ class SignalClient {
             try {
               this.ws.closed.then(closeInfo => {
                 var _a;
+                if (this.state === SignalConnectionState.CONNECTED) {
+                  try { this.voxevolvObserveConnection?.({
+                    reason: "websocket_closed",
+                    ws_close_code: closeInfo.closeCode ?? closeInfo.code,
+                    ws_close_clean: closeInfo.wasClean
+                  }); } catch {}
+                }
                 if (this.isEstablishingConnection) {
                   reject(ConnectionError.internal("Websocket got closed during a (re)connection attempt: ".concat(closeInfo.reason)));
                 }
@@ -16444,6 +16452,7 @@ class SignalClient {
                 }
                 return;
               }).catch(reason => {
+                try { this.voxevolvObserveConnection?.({ reason: "websocket_error" }); } catch {}
                 if (this.isEstablishingConnection) {
                   reject(ConnectionError.internal("Websocket error during a (re)connection attempt: ".concat(reason)));
                 }
@@ -16918,6 +16927,11 @@ class SignalClient {
   handleOnClose(reason) {
     return __awaiter(this, void 0, void 0, function* () {
       if (this.state === SignalConnectionState.DISCONNECTED) return;
+      try { this.voxevolvObserveConnection?.({
+        reason: reason === "ping timeout" ? "signal_ping_timeout" : "signal_closed",
+        signal_timeout_ms: this.pingTimeoutDuration * 1000,
+        signal_idle_ms: this.voxevolvLastSignalAt === undefined ? undefined : performance.now() - this.voxevolvLastSignalAt
+      }); } catch {}
       const onCloseCallback = this.onClose;
       yield this.close(undefined, reason);
       this.log.info("websocket connection closed: ".concat(reason), {
@@ -16938,6 +16952,7 @@ class SignalClient {
    * Call this after receiving a pong message
    */
   resetPingTimeout() {
+    this.voxevolvLastSignalAt = performance.now();
     this.clearPingTimeout();
     if (!this.pingTimeoutDuration) {
       this.log.warn('ping timeout duration not set');
@@ -21262,6 +21277,9 @@ class RTCEngine extends eventsExports.EventEmitter {
       if (this._isClosed) {
         return;
       }
+      try { this.voxevolvObserveConnection?.({
+        reason: "livekit_reconnect_requested", reconnect_reason: disconnectReason ?? 0
+      }); } catch {}
       this.log.warn("".concat(connection, " disconnected"));
       if (this.reconnectAttempts === 0) {
         // only reset start time on the first try
@@ -22342,6 +22360,11 @@ class RTCEngine extends eventsExports.EventEmitter {
   sendDataPacket(packet, kind, signal) {
     return __awaiter(this, void 0, void 0, function* () {
       var _a, _b;
+      let rpcObserver;
+      try { rpcObserver = this.voxevolvObserveRpcPacket?.(packet); } catch {}
+      const observeRpc = (stage) => { try { rpcObserver?.(stage); } catch {} };
+      observeRpc("publish_started");
+      try {
       signal?.throwIfAborted();
       // make sure we do have a data connection
       yield this.ensurePublisherConnected(kind);
@@ -22391,13 +22414,21 @@ class RTCEngine extends eventsExports.EventEmitter {
               sequence: packet.sequence
             });
             if (this.attemptingReconnect) {
+              observeRpc("reconnect_buffered");
               return;
             }
             dc.send(msg);
+            observeRpc("channel_send");
+          } else {
+            observeRpc("channel_unavailable");
           }
           this.updateAndEmitDCBufferStatus(kind);
           break;
       }
+      } catch (error) {
+        observeRpc("publish_failed");
+        throw error;
+      }
     });
   }
   /* @internal */
@@ -30804,6 +30835,7 @@ class Room extends eventsExports.EventEmitter {
     }
     this.engine = new RTCEngine(this.options);
     this.engine.e2eeManager = this.e2eeManager;
+    try { this.voxevolvObserveEngine?.(); } catch {}
     this.engine.on(EngineEvent.ParticipantUpdate, this.handleParticipantUpdates).on(EngineEvent.RoomUpdate, this.handleRoomUpdate).on(EngineEvent.SpeakersChanged, this.handleSpeakersChanged).on(EngineEvent.StreamStateChanged, this.handleStreamStateUpdate).on(EngineEvent.ConnectionQualityUpdate, this.handleConnectionQualityUpdate).on(EngineEvent.SubscriptionError, this.handleSubscriptionError).on(EngineEvent.SubscriptionPermissionUpdate, this.handleSubscriptionPermissionUpdate).on(EngineEvent.MediaTrackAdded, (mediaTrack, stream, receiver) => {
       this.onTrackAdded(mediaTrack, stream, receiver);
     }).on(EngineEvent.Disconnected, reason => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxevolv/client",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "description": "Browser SDK for VoxEvolv multimodal realtime sessions",
   "license": "MIT",
   "repository": {
@@ -42,14 +42,14 @@
   "scripts": {
     "build": "tsc -p tsconfig.json && node scripts/build-browser.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build && node scripts/protocol-smoke.mjs && node --test scripts/context-delivery.test.mjs scripts/context-cancellation.test.mjs scripts/diagnostic-delivery.test.mjs scripts/startup-recovery.test.mjs scripts/connection-lifecycle.test.mjs scripts/audio-recovery.test.mjs scripts/recovery-progress.test.mjs scripts/reliable-sequence.test.mjs && node scripts/transcript-smoke.mjs",
+    "test": "npm run build && node scripts/protocol-smoke.mjs && node --test scripts/context-delivery.test.mjs scripts/context-cancellation.test.mjs scripts/diagnostic-delivery.test.mjs scripts/connection-diagnostics.test.mjs scripts/presentations.test.mjs scripts/startup-recovery.test.mjs scripts/connection-lifecycle.test.mjs scripts/audio-recovery.test.mjs scripts/recovery-progress.test.mjs scripts/reliable-sequence.test.mjs && node scripts/transcript-smoke.mjs",
     "pack:check": "npm run build && npm pack --dry-run"
   },
   "dependencies": {
     "livekit-client": "2.20.0"
   },
   "devDependencies": {
-    "esbuild": "0.27.0",
+    "esbuild": "0.28.2",
     "typescript": "7.0.2"
   }
 }