@q9labsai/chalk-client 5.2.3 → 5.2.5

package/README.md

@@ -311,7 +311,7 @@ SpaceClient negotiates `collaboration_v2` for the 24-emoji set and per-message r
 
 `await client.media.setScreenShareEnabled(true, { surface: "browser", audio: true })` requests tab audio. The browser picker remains authoritative: selecting a window or declining audio still shares video normally. Audio is published separately as `screen_audio`; it starts, stops, and is revoked with the share, never with the microphone. `media.screenShare.hasAudio` reports local live audio; `participants.roster[].media.screenShareHasAudio` reports the remote publication. `media.remote` contains the received track.
 
-The sharer keeps local playback (`suppressLocalAudioPlayback: false`). Display audio disables echo cancellation, noise suppression and automatic gain control to preserve music; microphone capture and its processing are unchanged. System audio is excluded to avoid sending the call back to itself. Headphones avoid acoustic doubling through the microphone; local playback cannot be preserved while guaranteeing that loudspeakers never leak into it. Chrome documents [local playback control](https://developer.chrome.com/blog/screen-sharing-improvements-in-chrome-109) and [system-audio feedback](https://developer.chrome.com/docs/web-platform/screen-sharing-controls). [Meet documents the same “Also share tab audio” picker control](https://support.google.com/meet/answer/9308856?hl=en). No public X documentation establishing its echo default was found.
+The sharer keeps local playback (`suppressLocalAudioPlayback: false`). Display audio disables echo cancellation, noise suppression and automatic gain control to preserve music; microphone capture and its processing are unchanged. System audio is excluded to avoid sending the call back to itself. Headphones avoid acoustic doubling through the microphone; local playback cannot be preserved while guaranteeing that loudspeakers never leak into it. Chrome documents [local playback control](https://developer.chrome.com/blog/screen-sharing-improvements-in-chrome-109) and [system-audio feedback](https://developer.chrome.com/docs/web-platform/screen-sharing-controls). [Meet documents the same “Also share tab audio” picker control](https://support.google.com/meet/answer/9308856?hl=en).
 
 Shared tab audio is excluded from recordings until the recording format supports it. React Native display capture behavior is unchanged.
 

package/dist/access/grant.d.ts

@@ -39,8 +39,9 @@ export type AccessGrant = {
 };
 export type AccessGrantProvider = () => ParsedAccessGrant | Promise<ParsedAccessGrant>;
 export declare class AccessGrantError extends TypeError {
+    readonly reason?: "connection_superseded" | undefined;
     readonly code: "access.invalid";
-    constructor(message?: string);
+    constructor(message?: string, reason?: "connection_superseded" | undefined);
 }
 export declare function parseParsedAccessGrant(value: unknown): ParsedAccessGrant;
 export declare function parseAccessGrant(value: unknown): AccessGrant;

package/dist/access/manager.d.ts

@@ -23,6 +23,7 @@ export type ConnectionAccessEffectService = {
     readonly subscribeAutomaticMediaReplacement: (listener: AutomaticMediaReplacementListener) => Effect.Effect<() => void>;
     readonly requiresRefresh: Effect.Effect<boolean>;
     readonly millisecondsUntilRefresh: Effect.Effect<number | null>;
+    readonly holdMediaBinding: (binding: string) => Effect.Effect<Effect.Effect<void>>;
     readonly clear: Effect.Effect<void>;
 };
 declare const ConnectionAccessService_base: Context.ServiceClass<ConnectionAccessService, "@chalk/client/ConnectionAccess", ConnectionAccessEffectService>;

package/dist/{chunk-IMMT22US.js → chunk-5YPQNMJE.js}

@@ -3303,6 +3303,7 @@ var V1SyncClient = class {
     this.#phase = { phase: "connecting" };
     this.#connectAttemptCount += 1;
     this.#connectStartedAt = this.#clock().now();
+    const socketStartedAt = this.#connectStartedAt;
     this.#opened = false;
     if (this.#connectFailure?.opened) this.#connectFailure = void 0;
     this.#emit();
@@ -3331,6 +3332,7 @@ var V1SyncClient = class {
       if (socket !== this.#socket) return;
       this.#clearDial();
       this.#opened = true;
+      this.#diagnostic({ event: "sync_socket_open", attempt: this.#connectAttemptCount, duration_ms: this.#clock().now() - socketStartedAt });
       this.#connectFailure = void 0;
       void this.#authenticate(socket);
     };
@@ -3338,6 +3340,7 @@ var V1SyncClient = class {
       this.#inbound = this.#inbound.then(() => this.#receive(socket, event.data));
     };
     socket.onclose = (event) => {
+      this.#diagnostic({ event: "sync_socket_close", close_code: event.code, duration_ms: this.#clock().now() - socketStartedAt, ...this.#lastHeartbeatReplyAt === null ? {} : { heartbeat_gap_ms: this.#now() - this.#lastHeartbeatReplyAt } });
       if (this.#started) {
         this.#socketCloses.push({ code: event.code, wasClean: event.wasClean ?? null });
         if (this.#socketCloses.length > 50) {
@@ -3376,6 +3379,7 @@ var V1SyncClient = class {
       const hello = {
         type: "hello",
         protocol: 1,
+        ...this.#options.traceparent ? { traceparent: this.#options.traceparent } : {},
         token,
         streams: {
           control: { cursor: this.#control && { revision: this.#control.revision, state_schema_version: this.#control.stateSchemaVersion, state_digest: this.#control.stateDigest } },
@@ -3829,12 +3833,19 @@ var V1SyncClient = class {
   #updateLocalMediaStates() {
     this.#liveTargets.updateFromPublications(this.#localPublications);
   }
+  #diagnostic(event) {
+    try {
+      this.#options.onDiagnostic?.(event);
+    } catch {
+    }
+  }
   #startHeartbeat() {
     this.#clearHeartbeat();
     this.#heartbeatTimer = this.#clock().setTimeout(() => {
       this.#heartbeatTimer = void 0;
       if (this.#phase.phase !== "live") return;
       this.#missedHeartbeats += 1;
+      if (this.#missedHeartbeats > 1) this.#diagnostic({ event: "sync_heartbeat_gap", duration_ms: this.#missedHeartbeats * 2e4, ...this.#lastHeartbeatReplyAt === null ? {} : { heartbeat_gap_ms: this.#now() - this.#lastHeartbeatReplyAt } });
       if (this.#missedHeartbeats > 2) {
         this.#socket?.close(CLIENT_RESTART_CLOSE_CODE, "heartbeat timeout");
         return;