@q9labsai/chalk-client 5.2.6 → 5.3.0

package/dist/{chunk-I7Y4HR2P.js → chunk-DHUHTIU7.js}

@@ -6,11 +6,11 @@ import {
   describeMediaCaptureError,
   grantedMediaFromStream,
   markMediaFailure
-} from "./chunk-YIDKETOX.js";
+} from "./chunk-3TGVTP6Z.js";
 import {
   AccessGrantError,
   requireParsedAccessGrant
-} from "./chunk-CJVLTSIO.js";
+} from "./chunk-GOSWSXTH.js";
 import {
   ChatAttachmentMimeTypeSchema,
   ChatReactionSetFrameSchema,
@@ -24,7 +24,7 @@ import {
   formatSyncConnectDiagnostic,
   scheduleSyncDialDeadline,
   syncConnectFailureCode
-} from "./chunk-5YPQNMJE.js";
+} from "./chunk-XSB2GDRW.js";
 
 // src/access/manager.ts
 import { Clock, Context, Data, Deferred, Effect, Layer, SynchronizedRef } from "effect";
@@ -2853,7 +2853,7 @@ var ConnectionDiagnostics = class {
 // src/connection/lifecycle.ts
 var MEDIA_RECOVERY_TIMEOUT_MS = 6e4;
 var START_TIMEOUT_MS = 3e4;
-var LEAVE_TIMEOUT_MS = 5e3;
+var LEAVE_TIMEOUT_MS = 4e4;
 var RECOVERY_BUDGET_MS = MEDIA_RECOVERY_TIMEOUT_MS;
 var MAX_RECOVERY_ATTEMPTS = 3;
 var REFRESH_RETRY_MS = 5e3;
@@ -3291,6 +3291,12 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
         if (model.failure) return yield* Effect2.fail(lifecycleFailure("leave_unconfirmed", false, model.failure.message));
         return;
       }
+      yield* Effect2.sync(() => {
+        for (const { track } of model.media?.getSnapshot().localTracks ?? []) {
+          track.enabled = false;
+          track.stop();
+        }
+      });
       yield* transition("leaving");
       const confirmed = yield* leaveIsConfirmed();
       yield* stopPorts();
@@ -4877,6 +4883,20 @@ function chatError(message) {
   return new SpaceClientError({ code: "chat.payload_invalid", recoverable: false, message });
 }
 
+// src/space-client/same-identity.ts
+function otherDevices(participants, participantId, ownIdentityId) {
+  const identityId = ownIdentityId ?? participants.find((item) => item.participantId === participantId)?.identityId;
+  return identityId ? participants.filter((item) => item.participantId !== participantId && item.identityId === identityId) : [];
+}
+function otherDeviceHasMicrophone(snapshot, participants) {
+  if (snapshot.control?.status === "ended") return false;
+  const admitted = snapshot.control ? new Set(snapshot.control.participants.map((item) => item.participantId)) : null;
+  const devices = new Set(
+    otherDevices(participants, snapshot.participantId, snapshot.participantIdentityId).filter((item) => !admitted || admitted.has(item.participantId)).map((item) => item.participantId)
+  );
+  return snapshot.media?.items.some((item) => devices.has(item.participantId) && item.source === "microphone" && item.enabled) ?? false;
+}
+
 // src/space-client/media-controller.ts
 import { Clock as Clock3, Context as Context6, Deferred as Deferred3, Effect as Effect5, Exit as Exit2, Layer as Layer6, Semaphore } from "effect";
 
@@ -5012,6 +5032,7 @@ var MediaControllerRuntime = class {
   #unsubscribePorts = null;
   #microphoneWatch = null;
   #projection;
+  #microphoneMutedByOtherDevice = false;
   constructor(connection, store, selection, gates, now, fork) {
     this.#connection = connection;
     this.#store = store;
@@ -5037,7 +5058,10 @@ var MediaControllerRuntime = class {
     if (intent.microphone !== void 0) this.#recordIntent("microphone", intent.microphone);
     if (intent.camera !== void 0) this.#recordIntent("camera", intent.camera);
   }
-  setMicrophoneEnabled = (enabled) => this.#set("microphone", enabled);
+  setMicrophoneEnabled = (enabled) => Effect5.sync(() => {
+    this.#microphoneMutedByOtherDevice = false;
+    this.#publish();
+  }).pipe(Effect5.andThen(this.#set("microphone", enabled)));
   setCameraEnabled = (enabled) => this.#set("camera", enabled);
   captureCameraPreview = () => this.#cameraSource("preview").pipe(Effect5.mapError(normalizeMediaError));
   setScreenShareEnabled = (enabled, options) => enabled ? this.#mediaAction(true, this.#startScreen(options)) : this.#stopScreen();
@@ -5462,19 +5486,36 @@ var MediaControllerRuntime = class {
     }
   }
   startInitial(media, stream) {
+    const waitForSync = Effect5.callback((resume) => {
+      const sync = this.#ports?.sync;
+      if (!sync) return resume(Effect5.void);
+      const check = () => {
+        if (sync.getSnapshot().connection.phase === "live" || media.getSnapshot().connection.phase === "stopped") resume(Effect5.void);
+      };
+      const unsubscribe = sync.subscribe(check);
+      const unsubscribeMedia = media.subscribe(check);
+      check();
+      return Effect5.sync(() => {
+        unsubscribe();
+        unsubscribeMedia();
+      });
+    });
     const publish = foreign2(async () => {
       const revisions = { microphone: this.#sources.microphone.initialRevision, camera: this.#sources.camera.initialRevision };
-      const tracks = stream.getTracks().filter((track) => {
-        const source = track.kind === "audio" ? "microphone" : "camera";
-        const enabled = this.#hasConsent(source);
-        track.enabled = enabled;
-        if (!enabled) {
-          this.#deleteTrack(source);
-          if (source === "microphone") track.stop();
-        }
-        return enabled;
-      });
-      await media.start(streamFromTracks(tracks));
+      const tracks = this.#consentedTracks(stream.getTracks());
+      await media.start(
+        streamFromTracks(tracks),
+        () => Effect5.runPromise(
+          waitForSync.pipe(
+            Effect5.map(() => {
+              const snapshot = this.#ports?.sync.getSnapshot();
+              this.#microphoneMutedByOtherDevice = Boolean(snapshot && this.#hasConsent("microphone") && otherDeviceHasMicrophone(snapshot, this.#store.getSnapshot().participants.roster));
+              if (this.#microphoneMutedByOtherDevice) this.#recordIntent("microphone", false);
+              return streamFromTracks(this.#consentedTracks(tracks));
+            })
+          )
+        )
+      );
       for (const source of ["microphone", "camera"]) {
         const state = this.#sources[source];
         if (state.desired.revision === revisions[source]) state.result = { revision: revisions[source], status: "confirmed" };
@@ -5482,6 +5523,18 @@ var MediaControllerRuntime = class {
     });
     return this.#serialize("microphone", this.#serialize("camera", publish));
   }
+  #consentedTracks(tracks) {
+    return tracks.filter((track) => {
+      const source = track.kind === "audio" ? "microphone" : "camera";
+      const enabled = this.#hasConsent(source);
+      track.enabled = enabled;
+      if (!enabled) {
+        this.#deleteTrack(source);
+        if (source === "microphone") track.stop();
+      }
+      return enabled;
+    });
+  }
   #send(ports, source, intent, enabled) {
     const command = this.#mediaAction(
       enabled,
@@ -5882,8 +5935,8 @@ var MediaControllerRuntime = class {
     this.#pauseTracks(source);
     if (cause === "capture_cleanup" && source !== "screen" && ports.media.pauseLocalCapture) {
       state.capturePause = "pending";
-      this.#retainPause(state, ports.media.pauseLocalCapture(source));
       this.#notifyCapturePauses(ports);
+      this.#retainPause(state, ports.media.pauseLocalCapture(source));
     } else {
       ports.media.setLocalSourceIntent?.(source, false, cause);
       this.#retainPause(state, this.#beginLocalPause(ports, source, cause));
@@ -6101,6 +6154,7 @@ var MediaControllerRuntime = class {
     const remote = Object.freeze((snapshot?.remoteTracks ?? []).map((track) => Object.freeze({ participantId: track.participantId, source: track.source, publicationId: track.publicationId, track: track.track })));
     const media = Object.freeze({
       ...current.media,
+      microphoneMutedByOtherDevice: this.#microphoneMutedByOtherDevice,
       local,
       remote,
       screenShare: {
@@ -6491,6 +6545,12 @@ var ParticipantsControllerRuntime = class {
   #unsubscribePorts = null;
   #unsubscribe = null;
   #unsubscribeMedia = null;
+  #deviceScope = null;
+  // Retain verified seats while the local Sync replica is recovering, and for older servers
+  // whose negotiated hints disappear with sockets. New servers send every admitted seat.
+  #devices = /* @__PURE__ */ new Map();
+  #presenceCursor = null;
+  #invalidatedDevices = /* @__PURE__ */ new Set();
   constructor(connection, store, offline) {
     this.#offline = offline;
     this.#connection = connection;
@@ -6544,6 +6604,8 @@ var ParticipantsControllerRuntime = class {
     return ({ sync }) => foreign3(() => sync.setDisplayName(displayName));
   });
   dispose() {
+    this.#devices.clear();
+    this.#invalidatedDevices.clear();
     this.#unsubscribePorts?.();
     this.#unsubscribe?.();
     this.#unsubscribeMedia?.();
@@ -6563,6 +6625,10 @@ var ParticipantsControllerRuntime = class {
     this.#unsubscribe = null;
     this.#unsubscribeMedia = null;
     if (!ports) {
+      if (["idle", "leaving", "left", "failed"].includes(this.#connection.getSnapshot().state)) {
+        this.#devices.clear();
+        this.#invalidatedDevices.clear();
+      }
       this.#publish(null, {});
       return;
     }
@@ -6571,11 +6637,57 @@ var ParticipantsControllerRuntime = class {
     this.#unsubscribeMedia = ports.media.subscribe(publish);
     publish();
   }
+  #syncDeviceScope() {
+    const subject = this.#connection.getSnapshot().subject;
+    const scope = subject ? JSON.stringify([subject.tenantId, subject.spaceId, subject.episodeId, subject.participantId, subject.participantGeneration]) : null;
+    if (scope !== this.#deviceScope) {
+      this.#devices.clear();
+      this.#invalidatedDevices.clear();
+    }
+    this.#deviceScope = scope;
+  }
+  #rememberDevices(snapshot) {
+    this.#syncDeviceScope();
+    const control = snapshot?.control;
+    if (!control) return;
+    this.#pruneDevices(control, snapshot.presence);
+    const retained = /* @__PURE__ */ new Map();
+    if (control.status !== "ended") {
+      for (const participant of control.participants) {
+        const device = this.#deviceFor(participant, snapshot.presence?.items ?? []);
+        if (device) retained.set(participant.participantId, device);
+      }
+    }
+    this.#devices = retained;
+  }
+  #pruneDevices(control, presence) {
+    const cursor = presence ? JSON.stringify([presence.projectionId, presence.sequence]) : null;
+    if (cursor !== this.#presenceCursor) this.#invalidatedDevices.clear();
+    this.#presenceCursor = cursor;
+    for (const [id, device] of this.#devices) {
+      if (!control.participants.some((participant) => participant.participantId === id && participant.admissionRevision === device.admissionRevision)) this.#invalidatedDevices.add(id);
+    }
+  }
+  #deviceFor(participant, presence) {
+    const previous = this.#devices.get(participant.participantId);
+    const known = previous && previous.admissionRevision === participant.admissionRevision ? previous : {};
+    const hint = this.#hintFor(participant, presence) ?? {};
+    const identityId = hint.identityId ?? known.identityId;
+    return identityId ? { admissionRevision: participant.admissionRevision, identityId, deviceType: hint.deviceType ?? known.deviceType } : void 0;
+  }
+  #hintFor(participant, presence) {
+    return presence.find((item) => {
+      if (item.participantId !== participant.participantId) return false;
+      if (item.admissionRevision !== void 0) return item.admissionRevision === participant.admissionRevision;
+      return !this.#invalidatedDevices.has(participant.participantId);
+    });
+  }
   #publish(snapshot, collaborationCapabilities, media) {
+    this.#rememberDevices(snapshot);
     if (snapshot && !controlFor(snapshot)) return;
     const audioParticipants = new Set(media?.remoteTracks.filter((track) => track.source === "screen_audio" && track.track.readyState === "live").map((track) => track.participantId));
     if (snapshot?.participantId && media?.localTracks.some((track) => track.source === "screen_audio" && track.enabled && track.track.readyState === "live")) audioParticipants.add(snapshot.participantId);
-    const projected = participantsFor(snapshot, collaborationCapabilities);
+    const projected = participantsFor(snapshot, collaborationCapabilities, this.#devices);
     const participants = Object.freeze({
       ...projected,
       roster: Object.freeze(projected.roster.map((participant) => Object.freeze({ ...participant, media: Object.freeze({ ...participant.media, screenShareHasAudio: participant.media.screenShare === "active" && audioParticipants.has(participant.participantId) }) })))
@@ -6601,10 +6713,10 @@ function invalid(message) {
 function directed(result) {
   return Object.freeze({ status: result.result, requestId: result.request_id });
 }
-function participantsFor(snapshot, collaborationCapabilities) {
+function participantsFor(snapshot, collaborationCapabilities, devices) {
   const control = controlFor(snapshot);
-  if (!control) return EMPTY_PARTICIPANTS;
-  return Object.freeze({ roster: rosterFor(control.participants, collaborationCapabilities, mediaFor(snapshot), presenceFor(snapshot)), admissionQueue: admissionQueueFor(control.admissionRequests) });
+  if (!control || control.status === "ended") return EMPTY_PARTICIPANTS;
+  return Object.freeze({ roster: rosterFor(control.participants, collaborationCapabilities, mediaFor(snapshot), presenceFor(snapshot), devices), admissionQueue: admissionQueueFor(control.admissionRequests) });
 }
 function controlFor(snapshot) {
   if (!snapshot) return null;
@@ -6618,11 +6730,13 @@ function mediaFor(snapshot) {
 function presenceFor(snapshot) {
   return snapshot?.presence ?? null;
 }
-function rosterFor(participants, collaborationCapabilities, media, presence) {
+function rosterFor(participants, collaborationCapabilities, media, presence, devices) {
   return Object.freeze(
     participants.map(
       (participant) => Object.freeze({
         participantId: participant.participantId,
+        identityId: devices.get(participant.participantId)?.identityId,
+        deviceType: devices.get(participant.participantId)?.deviceType,
         displayName: participant.displayName,
         role: participant.role,
         eligibleRoles: Object.freeze([...participant.eligibleRoles]),
@@ -6644,13 +6758,20 @@ function admissionQueueFor(requests) {
 function selfFor(snapshot, roster) {
   const participantId = snapshot?.participantId ?? null;
   const participant = roster.find((candidate) => candidate.participantId === participantId);
-  if (!participant) return emptySelf(participantId);
+  const identityId = selfIdentityFor(snapshot, participant);
+  if (!participant) return emptySelf(participantId, identityId);
   const capabilities = participant.capabilities;
   const allowed = new Set(capabilities);
-  return Object.freeze({ participantId, displayName: participant.displayName, role: participant.role, capabilities, handRaised: participant.handRaised, can: (capability) => allowed.has(capability) });
+  return Object.freeze({ participantId, identityId, displayName: participant.displayName, role: participant.role, capabilities, handRaised: participant.handRaised, can: (capability) => allowed.has(capability) });
+}
+function selfIdentityFor(snapshot, participant) {
+  if (!snapshot) return void 0;
+  if (snapshot.connection.phase === "terminal") return void 0;
+  if (snapshot.control?.status === "ended") return void 0;
+  return snapshot.participantIdentityId ?? participant?.identityId;
 }
-function emptySelf(participantId) {
-  return Object.freeze({ participantId, displayName: null, role: null, capabilities: Object.freeze([]), handRaised: false, can: () => false });
+function emptySelf(participantId, identityId) {
+  return Object.freeze({ participantId, identityId, displayName: null, role: null, capabilities: Object.freeze([]), handRaised: false, can: () => false });
 }
 function capabilitiesFor(control, collaboration) {
   const capabilities = /* @__PURE__ */ new Set();
@@ -6684,10 +6805,10 @@ function sameParticipantMedia(left, right) {
   return left.media.microphone === right.media.microphone && left.media.camera === right.media.camera && left.media.screenShare === right.media.screenShare && left.media.screenShareHasAudio === right.media.screenShareHasAudio;
 }
 function sameParticipantPresence(left, right) {
-  return left.presence.state === right.presence.state && left.presence.speaking === right.presence.speaking && left.presence.activeSpeaker === right.presence.activeSpeaker;
+  return left.identityId === right.identityId && left.deviceType === right.deviceType && left.presence.state === right.presence.state && left.presence.speaking === right.presence.speaking && left.presence.activeSpeaker === right.presence.activeSpeaker;
 }
 function sameSelf(left, right) {
-  return left.participantId === right.participantId && left.displayName === right.displayName && left.role === right.role && left.handRaised === right.handRaised && sameValues(left.capabilities, right.capabilities);
+  return left.participantId === right.participantId && left.identityId === right.identityId && left.displayName === right.displayName && left.role === right.role && left.handRaised === right.handRaised && sameValues(left.capabilities, right.capabilities);
 }
 function sameArray(left, right, equal) {
   return left.length === right.length && left.every((value, index) => equal(value, right[index]));

package/dist/{chunk-CJVLTSIO.js → chunk-GOSWSXTH.js}

@@ -84,6 +84,7 @@ var AccessGrantSchema = Schema.Struct({
 });
 var AdmitEpisodeParticipantRequestSchema = Schema.Struct({
   admission: Schema.optional(Schema.Literals(["policy", "direct"])),
+  identity_external_id: Schema.optional(Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(256))),
   identity_id: Schema.optional(UUIDSchema),
   metadata: Schema.optional(Schema.Unknown),
   name: Schema.String.check(Schema.isMinLength(1)),
@@ -1125,7 +1126,8 @@ var AddCloudflareSFUTracksQueryParamsSchema = Schema.Struct({
       "local_signaling_failure",
       "remote_signaling_failure",
       "dormant_connection",
-      "access_refresh"
+      "access_refresh",
+      "receive_stalled"
     ])
   )
 });

package/dist/{chunk-WFRTUBN6.js → chunk-O26BHHMI.js}

@@ -1,7 +1,7 @@
 import {
   createChalkEffectClient,
   parseAccessGrant
-} from "./chunk-CJVLTSIO.js";
+} from "./chunk-GOSWSXTH.js";
 
 // src/public-invites/client.ts
 import { Effect } from "effect";

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

@@ -861,7 +861,8 @@ function strictEvent(value) {
 }
 function strictProjectionItem(value, stream) {
   if (stream === "media") return exactObject(value, ["participant_id", "source", "enabled", "publication_id"]);
-  if (stream === "presence") return exactObject(value, ["participant_id", "state", "speaking", "active_speaker"]);
+  if (stream === "presence")
+    return isObject(value) && exactObject(value, [...["participant_id", "state", "speaking", "active_speaker"], ...Object.hasOwn(value, "identity_id") ? ["identity_id"] : [], ...Object.hasOwn(value, "device_type") ? ["device_type"] : [], ...Object.hasOwn(value, "admission_revision") ? ["admission_revision"] : []]);
   return false;
 }
 function strictProjection(value) {
@@ -873,7 +874,13 @@ function strictWelcome(value) {
   const extension = Array.isArray(value.extensions) && value.extensions.length === 1 ? value.extensions[0] : void 0;
   const extensionValid = isObject(extension) && ["collaboration_v1", "collaboration_v2"].includes(String(extension.name)) && exactObject(extension, ["name", "capabilities", "participant_capabilities", "chat_head_sequence", "retained_floor_sequence", "read_receipts"]) && Array.isArray(extension.read_receipts);
   if (Object.hasOwn(value, "entry_confirmation") && value.entry_confirmation !== true) return false;
-  const fields = [...base, ...extensionValid ? ["extensions"] : [], ...Object.hasOwn(value, "entry_confirmation") ? ["entry_confirmation"] : [], ...Object.hasOwn(value, "entry_generation") ? ["entry_generation"] : []];
+  const fields = [
+    ...base,
+    ...extensionValid ? ["extensions"] : [],
+    ...Object.hasOwn(value, "entry_confirmation") ? ["entry_confirmation"] : [],
+    ...Object.hasOwn(value, "entry_generation") ? ["entry_generation"] : [],
+    ...Object.hasOwn(value, "participant_identity_id") ? ["participant_identity_id"] : []
+  ];
   if (!strictCursor(value.head)) return false;
   if (value.mode === "snapshot") return exactObjectWithCorrelation(value, [...fields, "snapshot"]) && strictSnapshot(value.snapshot);
   if (value.mode === "terminal") return exactObjectWithCorrelation(value, [...fields, "reason"]);
@@ -1479,6 +1486,7 @@ var WelcomeBase = {
   protocol: Schema.Literal(1),
   participant_id: UuidSchema,
   participant_generation: PositiveIntegerSchema,
+  participant_identity_id: Schema.optionalKey(UuidSchema),
   recovery_id: UuidSchema,
   head: ControlCursorSchema,
   entry_confirmation: Schema.optionalKey(Schema.Literal(true)),
@@ -1527,9 +1535,15 @@ var CommandIdConflictAckFrameSchema = Schema.Struct({ type: Schema.Literal("ack"
 var MediaProjectionItemSchema = Schema.Struct({ participant_id: UuidSchema, source: Schema.Union([Schema.Literal("microphone"), Schema.Literal("camera"), Schema.Literal("screen")]), enabled: Schema.Boolean, publication_id: Schema.NullOr(boundedUtf8String(256, 1)) }).check(
   Schema.makeFilter((item) => !item.enabled || item.publication_id !== null ? void 0 : { path: [], issue: "enabled requires a publication_id" })
 );
-var PresenceProjectionItemSchema = Schema.Struct({ participant_id: UuidSchema, state: Schema.Union([Schema.Literal("connected"), Schema.Literal("disconnected")]), speaking: Schema.Boolean, active_speaker: Schema.Boolean }).check(
-  Schema.makeFilter((item) => item.state !== "disconnected" || !item.speaking && !item.active_speaker ? void 0 : { path: [], issue: "disconnected presence cannot be speaking or active speaker" })
-);
+var PresenceProjectionItemSchema = Schema.Struct({
+  participant_id: UuidSchema,
+  state: Schema.Union([Schema.Literal("connected"), Schema.Literal("disconnected")]),
+  speaking: Schema.Boolean,
+  active_speaker: Schema.Boolean,
+  identity_id: Schema.optional(UuidSchema),
+  device_type: Schema.optional(Schema.Literals(["phone", "tablet", "computer"])),
+  admission_revision: Schema.optional(PositiveIntegerSchema)
+}).check(Schema.makeFilter((item) => item.state !== "disconnected" || !item.speaking && !item.active_speaker ? void 0 : { path: [], issue: "disconnected presence cannot be speaking or active speaker" }));
 var MediaProjectionSnapshotFrameSchema = Schema.Struct({
   type: Schema.Literal("projection_snapshot"),
   stream: Schema.Literal("media"),
@@ -3016,6 +3030,7 @@ var V1SyncClient = class {
   #presence = null;
   #participantId = null;
   #participantGeneration = null;
+  #participantIdentityId;
   #entryGeneration = null;
   #recovery = null;
   #snapshotRecoveryRequested = false;
@@ -3136,6 +3151,7 @@ var V1SyncClient = class {
     this.#socket?.close(1e3, "client stopped");
     this.#socket = null;
     this.#phase = { phase: "stopped" };
+    this.#options.mediaPlane?.remotePublicationsChanged?.([], "unavailable");
     this.#rejectEphemeral("client_stopped");
     this.#collaborationState.disconnect("client_stopped");
     this.#localPublications = [];
@@ -3164,6 +3180,7 @@ var V1SyncClient = class {
       },
       participantId: this.#participantId,
       participantGeneration: this.#participantGeneration,
+      participantIdentityId: this.#participantIdentityId,
       control: this.#control,
       optimisticControl,
       media: copyProjection(this.#media),
@@ -3183,6 +3200,7 @@ var V1SyncClient = class {
     return () => this.#mediaPauseListeners.delete(listener);
   }
   #notifyMediaPause(event) {
+    if (event.name === "episode_ended") this.#options.mediaPlane?.remotePublicationsChanged?.([]);
     const source = event.name === "participant_microphone_stopped" ? "microphone" : event.name === "participant_camera_stopped" ? "camera" : event.name === "participant_screen_share_stopped" ? "screen" : null;
     if (source && "participant_id" in event.payload && event.payload.participant_id === this.#participantId) {
       for (const listener of this.#mediaPauseListeners) listener({ source, revision: event.revision });
@@ -3444,6 +3462,7 @@ var V1SyncClient = class {
           const control = this.#requireControl();
           this.#send({ type: "delivery_ack", stream: "control", revision: control.revision, state_digest: control.stateDigest });
         }
+        if (this.#control?.status === "ended" || frame.name === "participant_left" && frame.payload.participant_id === this.#participantId) this.#participantIdentityId = void 0;
         if (frame.name === "participant_left" && frame.payload.participant_id === this.#participantId) {
           this.#phase = { phase: "terminal", terminalReason: frame.payload.reason === "removed" ? "participant_removed" : "participant_inactive" };
           this.#socket?.close(1e3, "participant inactive");
@@ -3534,6 +3553,7 @@ var V1SyncClient = class {
     this.#entryGeneration = frame.entry_generation ?? this.#entryGeneration;
     this.#participantId = frame.participant_id;
     this.#participantGeneration = frame.participant_generation;
+    this.#participantIdentityId = frame.mode === "terminal" ? void 0 : frame.participant_identity_id;
     this.#updateLocalMediaStates();
     if (frame.mode === "terminal") {
       await this.#commandScheduler.settleTerminalRecovery(frame);
@@ -3547,6 +3567,7 @@ var V1SyncClient = class {
       const control = await restoreV1Snapshot(frame.snapshot);
       if (!sameHead(control, frame.head)) throw new V1ReplicaError("snapshot head mismatch");
       this.#control = control;
+      if (control.status === "ended") this.#options.mediaPlane?.remotePublicationsChanged?.([]);
       this.#snapshotRevision = control.revision;
       this.#snapshotRecoveryRequested = false;
       this.#controlHeads.clear();
@@ -3592,7 +3613,7 @@ var V1SyncClient = class {
           previous.find((candidate) => mediaKey(candidate) === mediaKey(item)),
           item
         );
-      if (!this.#mediaEnded()) this.#options.mediaPlane?.remotePublicationsChanged?.();
+      if (!this.#mediaEnded()) this.#options.mediaPlane?.remotePublicationsChanged?.(this.#media?.items ?? []);
     } else {
       this.#presence = { projectionId: frame.projection_id, sequence: 0, items: frame.items.map(presenceItem) };
       this.#presenceEventEvidence.clear();
@@ -3611,7 +3632,7 @@ var V1SyncClient = class {
       rememberBoundedEvidence(this.#mediaEventEvidence, frame.sequence, frameSignature(frame), MAX_PROJECTION_EVENT_EVIDENCE);
       this.#notifyRemotePublicationResumed(previous, item);
       if (!this.#mediaEnded() && item.participantId !== this.#participantId && (previous?.enabled !== item.enabled || previous?.publicationId !== item.publicationId)) {
-        this.#options.mediaPlane?.remotePublicationsChanged?.();
+        this.#options.mediaPlane?.remotePublicationsChanged?.(this.#media?.items ?? []);
       }
     } else {
       if (this.#acceptProjectionDuplicate(this.#presence, this.#presenceEventEvidence, frame)) return;
@@ -3694,6 +3715,7 @@ var V1SyncClient = class {
     this.#commandScheduler.disconnect();
     this.#media = null;
     this.#presence = null;
+    this.#options.mediaPlane?.remotePublicationsChanged?.([], this.#mediaEnded() ? "available" : "unavailable");
     this.#rejectRequests("disconnected_before_delivery");
     this.#collaborationState.disconnect("disconnected_before_delivery");
     if (!this.#started || this.#phase.phase === "terminal") return;
@@ -3900,7 +3922,7 @@ function mediaItem(item) {
   return { participantId: item.participant_id, source: item.source, enabled: item.enabled, publicationId: item.publication_id };
 }
 function presenceItem(item) {
-  return { participantId: item.participant_id, state: item.state, speaking: item.speaking, activeSpeaker: item.active_speaker };
+  return { participantId: item.participant_id, admissionRevision: item.admission_revision, identityId: item.identity_id, deviceType: item.device_type, state: item.state, speaking: item.speaking, activeSpeaker: item.active_speaker };
 }
 function mediaKey(item) {
   return `${item.participantId}:${item.source}`;
@@ -3928,6 +3950,8 @@ function validMediaPublication(publication) {
 }
 function entryUrl(value, generation, confirmation) {
   const url = new URL(value);
+  url.searchParams.set("participant_devices", "1");
+  url.searchParams.set("participant_device_admissions", "2");
   url.searchParams.set("entry_generation", generation === null ? "new" : String(generation));
   if (confirmation) url.searchParams.set("entry_confirmation", "1");
   return url.toString();

package/dist/client.d.ts

@@ -23,7 +23,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
             readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
         }>>, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
             readonly allow_partial_remote_tracks: import("effect/Schema").optional<import("effect/Schema").Boolean>;
-            readonly replacement_cause: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh"]>>;
+            readonly replacement_cause: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh", "receive_stalled"]>>;
         }>>, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
             readonly connection_id: import("effect/Schema").String;
             readonly session_description: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
@@ -2478,6 +2478,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
             readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
         }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
             readonly admission: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["policy", "direct"]>>;
+            readonly identity_external_id: import("effect/Schema").optional<import("effect/Schema").String>;
             readonly identity_id: import("effect/Schema").optional<import("effect/Schema").brand<import("effect/Schema").String, "UUID">>;
             readonly metadata: import("effect/Schema").optional<import("effect/Schema").Unknown>;
             readonly name: import("effect/Schema").String;

package/dist/connection/dependencies.d.ts

@@ -68,7 +68,8 @@ export type ConnectionSyncClient = V1CollaborationClient & {
     readonly requestStartCamera: (participantId: string) => Promise<V1DirectedRequestResult>;
 };
 export type ConnectionMediaClient = ClientMediaPlane & {
-    readonly start: (stream: MediaStream) => Promise<void>;
+    /** Starts receiving immediately; resolves the optional initial publication policy before sending. */
+    readonly start: (stream: MediaStream, beforePublish?: () => Promise<MediaStream>) => Promise<void>;
     readonly stop: () => void;
     readonly restart: (input: CloudflareSFUBootstrap | ParticipantMediaAccess) => Promise<void>;
     readonly prepareLocalTrack: (source: "microphone" | "camera" | "screen" | "screen_audio", track: MediaStreamTrack) => void;

package/dist/effect.js

@@ -17,8 +17,8 @@ import {
   makeSpaceClientCoreLayer,
   makeSpaceClientCoreLayerFromServices,
   makeSpaceStoreLayer
-} from "./chunk-I7Y4HR2P.js";
-import "./chunk-YIDKETOX.js";
+} from "./chunk-DHUHTIU7.js";
+import "./chunk-3TGVTP6Z.js";
 import {
   APIKeyListSchema,
   APIKeyWithSecretSchema,
@@ -841,8 +841,8 @@ import {
   WhiteboardStorageUnavailableErrorSchema,
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
-} from "./chunk-CJVLTSIO.js";
-import "./chunk-5YPQNMJE.js";
+} from "./chunk-GOSWSXTH.js";
+import "./chunk-XSB2GDRW.js";
 
 // src/space-client/effect.ts
 import { Context, Effect, Exit, Layer, Scope } from "effect";

package/dist/generated/http-api.d.ts

@@ -7,7 +7,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
 }>>, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
     readonly allow_partial_remote_tracks: import("effect/Schema").optional<import("effect/Schema").Boolean>;
-    readonly replacement_cause: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh"]>>;
+    readonly replacement_cause: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh", "receive_stalled"]>>;
 }>>, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
     readonly connection_id: import("effect/Schema").String;
     readonly session_description: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
@@ -2434,6 +2434,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
 }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
     readonly admission: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["policy", "direct"]>>;
+    readonly identity_external_id: import("effect/Schema").optional<import("effect/Schema").String>;
     readonly identity_id: import("effect/Schema").optional<import("effect/Schema").brand<import("effect/Schema").String, "UUID">>;
     readonly metadata: import("effect/Schema").optional<import("effect/Schema").Unknown>;
     readonly name: import("effect/Schema").String;

package/dist/generated/schemas.d.ts

@@ -89,6 +89,7 @@ export declare const AccessGrantSchema: Schema.Struct<{
 export type AccessGrant = typeof AccessGrantSchema.Type;
 export declare const AdmitEpisodeParticipantRequestSchema: Schema.Struct<{
     readonly admission: Schema.optional<Schema.Literals<readonly ["policy", "direct"]>>;
+    readonly identity_external_id: Schema.optional<Schema.String>;
     readonly identity_id: Schema.optional<Schema.brand<Schema.String, "UUID">>;
     readonly metadata: Schema.optional<Schema.Unknown>;
     readonly name: Schema.String;
@@ -1358,7 +1359,7 @@ export declare const AddCloudflareSFUTracksPathParamsSchema: Schema.Struct<{
 export type AddCloudflareSFUTracksPathParams = typeof AddCloudflareSFUTracksPathParamsSchema.Type;
 export declare const AddCloudflareSFUTracksQueryParamsSchema: Schema.Struct<{
     readonly allow_partial_remote_tracks: Schema.optional<Schema.Boolean>;
-    readonly replacement_cause: Schema.optional<Schema.Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh"]>>;
+    readonly replacement_cause: Schema.optional<Schema.Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh", "receive_stalled"]>>;
 }>;
 export type AddCloudflareSFUTracksQueryParams = typeof AddCloudflareSFUTracksQueryParamsSchema.Type;
 export declare const AddCloudflareSFUTracksRequestBodySchema: Schema.Struct<{
@@ -1426,6 +1427,7 @@ export declare const AdmitEpisodeParticipantRequestHeadersSchema: Schema.Struct<
 export type AdmitEpisodeParticipantRequestHeaders = typeof AdmitEpisodeParticipantRequestHeadersSchema.Type;
 export declare const AdmitEpisodeParticipantRequestBodySchema: Schema.Struct<{
     readonly admission: Schema.optional<Schema.Literals<readonly ["policy", "direct"]>>;
+    readonly identity_external_id: Schema.optional<Schema.String>;
     readonly identity_id: Schema.optional<Schema.brand<Schema.String, "UUID">>;
     readonly metadata: Schema.optional<Schema.Unknown>;
     readonly name: Schema.String;