@voxevolv/client 0.3.16 → 0.3.18

package/dist/presentations.d.ts

@@ -1,3 +1,4 @@
+import type { ClientDiagnosticInput } from "./diagnostics.js";
 type SendRpc = (request: {
     destinationIdentity: string;
     method: string;
@@ -9,8 +10,9 @@ export declare class Presentations {
     private readonly send;
     private readonly isClosed;
     private readonly receiptFailed;
+    private readonly observe?;
     private readonly results;
-    constructor(send: SendRpc, isClosed: () => boolean, receiptFailed: () => void);
+    constructor(send: SendRpc, isClosed: () => boolean, receiptFailed: () => void, observe?: ((entry: ClientDiagnosticInput) => void) | undefined);
     invoke(id: string, worker: string, execute: () => Promise<string>): Promise<string>;
     private execute;
     private complete;

package/dist/presentations.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"presentations.d.ts","sourceRoot":"","sources":["../src/presentations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAM9D,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;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAN3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,YACmB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,OAAO,EACvB,aAAa,EAAE,MAAM,IAAI,EACzB,OAAO,CAAC,GAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,aAAA,EAC/D;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;YAQF,OAAO;CA+BtB"}

package/dist/presentations.js

@@ -7,11 +7,13 @@ export class Presentations {
     send;
     isClosed;
     receiptFailed;
+    observe;
     results = new Map();
-    constructor(send, isClosed, receiptFailed) {
+    constructor(send, isClosed, receiptFailed, observe) {
         this.send = send;
         this.isClosed = isClosed;
         this.receiptFailed = receiptFailed;
+        this.observe = observe;
     }
     invoke(id, worker, execute) {
         const key = JSON.stringify([worker, id]);
@@ -81,11 +83,38 @@ export class Presentations {
             this.receiptFailed();
         });
     }
-    request(id, worker, payload) {
-        return this.send({
-            destinationIdentity: worker, method: PRESENTATION_METHOD,
-            payload: JSON.stringify({ operation_id: id, ...payload }), responseTimeout: 2_000,
-        });
+    async request(id, worker, payload) {
+        const startedAt = performance.now();
+        const record = (entry) => {
+            try {
+                this.observe?.({
+                    operation: "tool_rpc", status: "started", tool_name: "present_attachment",
+                    presentation_id: id, timeout_ms: 2_000,
+                    reason: payload.action === "claim" ? "presentation_claim" : "presentation_complete",
+                    duration_ms: performance.now() - startedAt, ...entry,
+                });
+            }
+            catch {
+                // Optional diagnostics must not change authorization or display behavior.
+            }
+        };
+        record({ stage: "publish_started" });
+        try {
+            const response = await this.send({
+                destinationIdentity: worker, method: PRESENTATION_METHOD,
+                payload: JSON.stringify({ operation_id: id, ...payload }), responseTimeout: 2_000,
+            });
+            record({ stage: "received", status: "succeeded" });
+            return response;
+        }
+        catch (error) {
+            // npm's patched transport and this module can load distinct RpcError
+            // classes. Read the numeric code without relying on constructor identity.
+            const rpcErrorCode = error && typeof error === "object" && "code" in error
+                && typeof error.code === "number" ? error.code : undefined;
+            record({ status: "failed", rpc_error_code: rpcErrorCode });
+            throw error;
+        }
     }
 }
 //# sourceMappingURL=presentations.js.map

package/dist/presentations.js.map

@@ -1 +1 @@
-{"version":3,"file":"presentations.js","sourceRoot":"","sources":["../src/presentations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"presentations.js","sourceRoot":"","sources":["../src/presentations.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);
@@ -16347,7 +16348,7 @@ class SignalClient {
       }();
     });
   }
-  reconnect(url, token, sid, reason) {
+  reconnect(url, token, sid, reason, abortSignal) {
     return __awaiter(this, void 0, void 0, function* () {
       if (!this.options) {
         this.log.warn('attempted to reconnect without signal options being set, ignoring');
@@ -16360,7 +16361,7 @@ class SignalClient {
         reconnect: true,
         sid,
         reconnectReason: reason
-      }), undefined, this.useV0SignalPath);
+      }), abortSignal, this.useV0SignalPath);
       return res;
     });
   }
@@ -16424,10 +16425,21 @@ class SignalClient {
               reconnect: opts.reconnect,
               reconnectReason: opts.reconnectReason
             });
+            if (abortSignal?.aborted) {
+              yield abortHandler(abortSignal);
+              return;
+            }
             this.ws = new WebSocketStream(rtcUrl);
             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 +16456,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)));
                 }
@@ -16462,6 +16475,10 @@ class SignalClient {
                 return;
               }));
               clearTimeout(wsTimeout);
+              if (abortSignal?.aborted) {
+                yield abortHandler(abortSignal);
+                return;
+              }
               if (!connection) {
                 return;
               }
@@ -16469,6 +16486,10 @@ class SignalClient {
               this.streamWriter = connection.writable.getWriter();
               const firstMessage = yield signalReader.read();
               signalReader.releaseLock();
+              if (abortSignal?.aborted) {
+                yield abortHandler(abortSignal);
+                return;
+              }
               if (!firstMessage.value) {
                 throw ConnectionError.internal('no message received as first message');
               }
@@ -16918,6 +16939,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 +16964,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');
@@ -21078,6 +21105,38 @@ var DataChannelKind;
 // `0` means "no limit".
 const DEFAULT_MAX_MESSAGE_SIZE = 64000;
 /** @internal */
+
+function voxevolvAssertEngineOpen(engine) {
+  if (engine.voxevolvCloseController.signal.aborted) {
+    throw new UnexpectedConnectionState('Engine was discarded');
+  }
+}
+
+async function voxevolvUntilEngineClosed(engine, callerSignal, operation) {
+  voxevolvAssertEngineOpen(engine);
+  if (callerSignal?.aborted) throw ConnectionError.cancelled('Connection aborted');
+  const lifetime = engine.voxevolvCloseController.signal;
+  const controller = new AbortController();
+  let cancel;
+  const cancelled = new Promise((_, reject) => {
+    cancel = () => {
+      controller.abort();
+      reject(lifetime.aborted
+        ? new UnexpectedConnectionState('Engine was discarded')
+        : ConnectionError.cancelled('Connection aborted'));
+    };
+    lifetime.addEventListener('abort', cancel, { once: true });
+    callerSignal?.addEventListener('abort', cancel, { once: true });
+  });
+  try {
+    // Abort the transport and stop waiting even if it returns a late response.
+    return await Promise.race([operation(controller.signal), cancelled]);
+  } finally {
+    lifetime.removeEventListener('abort', cancel);
+    callerSignal?.removeEventListener('abort', cancel);
+  }
+}
+
 class RTCEngine extends eventsExports.EventEmitter {
   get isClosed() {
     return this._isClosed;
@@ -21103,6 +21162,7 @@ class RTCEngine extends eventsExports.EventEmitter {
     this.pcState = PCState.New;
     this._isClosed = true;
     this._isNewlyCreated = true;
+    this.voxevolvCloseController = new AbortController();
     this.pendingTrackResolvers = {};
     this.reconnectAttempts = 0;
     this.reconnectStart = 0;
@@ -21259,9 +21319,12 @@ class RTCEngine extends eventsExports.EventEmitter {
     // continues to work, we can reconnect to websocket to continue the session
     // after a number of retries, we'll close and give up permanently
     this.handleDisconnect = (connection, disconnectReason) => {
-      if (this._isClosed) {
+      if (this._isClosed || this.voxevolvCloseController.signal.aborted) {
         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
@@ -21423,6 +21486,7 @@ class RTCEngine extends eventsExports.EventEmitter {
       let useV0Path = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
       return function* () {
         var _a, _b, _c;
+        voxevolvAssertEngineOpen(_this2);
         _this2._isNewlyCreated = false;
         _this2.url = url;
         _this2.token = token;
@@ -21444,6 +21508,7 @@ class RTCEngine extends eventsExports.EventEmitter {
               // createInitialOffer() defers setLocalDescription (via pendingInitialOffer) until the
               // answer is applied, after updateConfiguration() has set the server's TURN servers.
               yield _this2.configure();
+              voxevolvAssertEngineOpen(_this2);
               _this2.applyInitialPublisherLayout();
             }
             const offer = yield (_a = _this2.pcManager) === null || _a === void 0 ? void 0 : _a.publisher.createInitialOffer();
@@ -21458,7 +21523,9 @@ class RTCEngine extends eventsExports.EventEmitter {
             _this2.shouldFailOnV1Path = false;
             throw ConnectionError.serviceNotFound('Simulated v1 path failure', 'v0-rtc');
           }
-          const joinResponse = yield _this2.client.join(url, token, opts, abortSignal, useV0Path, offerProto);
+          const joinResponse = yield voxevolvUntilEngineClosed(_this2, abortSignal,
+            signal => _this2.client.join(url, token, opts, signal, useV0Path, offerProto));
+          voxevolvAssertEngineOpen(_this2);
           _this2._isClosed = false;
           _this2.latestJoinResponse = joinResponse;
           _this2.participantSid = (_b = joinResponse.participant) === null || _b === void 0 ? void 0 : _b.sid;
@@ -21471,6 +21538,7 @@ class RTCEngine extends eventsExports.EventEmitter {
               // the server's ICE servers and topology, then negotiate separately rather than bundling
               // the offer with the join.
               yield _this2.configure(joinResponse, !useV0Path);
+              voxevolvAssertEngineOpen(_this2);
               if (!useV0Path) {
                 // The V1 first offer must carry the media layout so Firefox binds receive decoders for
                 // subscribed tracks — without it, subscribed audio/video arrive as RTP but
@@ -21485,6 +21553,7 @@ class RTCEngine extends eventsExports.EventEmitter {
               });
             }
           }
+          voxevolvAssertEngineOpen(_this2);
           _this2.registerOnLineListener();
           _this2.clientConfiguration = joinResponse.clientConfiguration;
           _this2.emit(EngineEvent.SignalConnected, joinResponse);
@@ -21527,9 +21596,12 @@ class RTCEngine extends eventsExports.EventEmitter {
     });
   }
   close() {
+    const alreadyClosing = this.voxevolvCloseController.signal.aborted;
+    // Discard synchronously, before cleanup waits for its lock.
+    this.voxevolvCloseController.abort();
     return __awaiter(this, void 0, void 0, function* () {
       const unlock = yield this.closingLock.lock();
-      if (this.isClosed) {
+      if (this.isClosed && alreadyClosing) {
         unlock();
         return;
       }
@@ -22115,7 +22187,7 @@ class RTCEngine extends eventsExports.EventEmitter {
   attemptReconnect(reason) {
     return __awaiter(this, void 0, void 0, function* () {
       var _a, _b, _c;
-      if (this._isClosed) {
+      if (this._isClosed || this.voxevolvCloseController.signal.aborted) {
         return;
       }
       // guard for attempting reconnection multiple times while one attempt is still not finished
@@ -22189,6 +22261,7 @@ class RTCEngine extends eventsExports.EventEmitter {
         }
         yield this.cleanupPeerConnections();
         yield this.cleanupClient();
+        voxevolvAssertEngineOpen(this);
         let joinResponse;
         try {
           if (!this.signalOpts) {
@@ -22207,9 +22280,11 @@ class RTCEngine extends eventsExports.EventEmitter {
           this.shouldFailNext = false;
           throw new Error('simulated failure');
         }
+        voxevolvAssertEngineOpen(this);
         this.client.setReconnected();
         this.emit(EngineEvent.SignalRestarted, joinResponse);
-        yield this.waitForPCReconnected();
+        yield voxevolvUntilEngineClosed(this, undefined, () => this.waitForPCReconnected());
+      voxevolvAssertEngineOpen(this);
         // re-check signal connection state before setting engine as resumed
         if (this.client.currentState !== SignalConnectionState.CONNECTED) {
           throw new SignalReconnectError('Signal connection got severed during reconnect');
@@ -22218,7 +22293,9 @@ class RTCEngine extends eventsExports.EventEmitter {
         // reconnect success
         this.emit(EngineEvent.Restarted);
       } catch (error) {
+        voxevolvAssertEngineOpen(this);
         const nextRegionUrl = yield (_b = this.regionStrategy) === null || _b === void 0 ? void 0 : _b.getNextUrl();
+        voxevolvAssertEngineOpen(this);
         if (nextRegionUrl) {
           yield this.restartConnection(nextRegionUrl);
           return;
@@ -22246,7 +22323,8 @@ class RTCEngine extends eventsExports.EventEmitter {
       let res;
       try {
         this.setupSignalClientCallbacks();
-        res = yield this.client.reconnect(this.url, this.token, this.participantSid, reason);
+        res = yield voxevolvUntilEngineClosed(this, undefined,
+          signal => this.client.reconnect(this.url, this.token, this.participantSid, reason, signal));
       } catch (error) {
         let message = '';
         if (error instanceof Error) {
@@ -22263,6 +22341,7 @@ class RTCEngine extends eventsExports.EventEmitter {
         }
         throw new SignalReconnectError(message);
       }
+      voxevolvAssertEngineOpen(this);
       this.emit(EngineEvent.SignalResumed);
       if (res) {
         const rtcConfig = this.makeRTCConfiguration(res);
@@ -22278,7 +22357,8 @@ class RTCEngine extends eventsExports.EventEmitter {
         throw new Error('simulated failure');
       }
       yield this.pcManager.triggerIceRestart();
-      yield this.waitForPCReconnected();
+      yield voxevolvUntilEngineClosed(this, undefined, () => this.waitForPCReconnected());
+      voxevolvAssertEngineOpen(this);
       // re-check signal connection state before setting engine as resumed
       if (this.client.currentState !== SignalConnectionState.CONNECTED) {
         throw new SignalReconnectError('Signal connection got severed during reconnect');
@@ -30817,6 +30897,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.16",
+  "version": "0.3.18",
   "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/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",
+    "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/reconnect-cancellation.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"
   }
 }