@q9labsai/chalk-client 5.3.1 → 5.4.0

package/dist/{chunk-FD7ZSDTM.js → chunk-XF567GPH.js}

@@ -301,6 +301,73 @@ function scheduleSyncDialDeadline(clock, onTimeout, timeoutMs = SYNC_DIAL_TIMEOU
   return () => clock.clearTimeout(timer);
 }
 
+// src/sync/link-watch.ts
+var LONG_DROP_MS = 6e4;
+var ROUND_TRIP_MS = 5e3;
+var UNANSWERED_LIMIT_MS = 6e4;
+var LinkWatch = class {
+  #clock;
+  #page;
+  #suspends = 0;
+  #pings = [];
+  #proof = null;
+  #suspended = () => {
+    this.#suspends += 1;
+  };
+  constructor(clock, page) {
+    this.#clock = clock;
+    this.#page = page;
+  }
+  /** Listens for page suspension. Idempotent, and paired with `close`. */
+  open() {
+    this.close();
+    this.#page?.addEventListener("freeze", this.#suspended);
+    this.#page?.addEventListener("resume", this.#suspended);
+  }
+  close() {
+    this.#page?.removeEventListener("freeze", this.#suspended);
+    this.#page?.removeEventListener("resume", this.#suspended);
+  }
+  /** Call when a connection goes live: the previous socket's pings will not be answered. */
+  restart() {
+    this.#pings = [];
+  }
+  /**
+   * Call as a ping goes out, in the same order as the pings. False means the oldest ping has gone unanswered for over
+   * `UNANSWERED_LIMIT_MS`: the socket is dead and this ping must not be sent on it.
+   */
+  pinged() {
+    const now = this.#read();
+    const oldest = this.#pings[0];
+    if (oldest !== void 0 && (now.wall - oldest.wall > UNANSWERED_LIMIT_MS || now.mono - oldest.mono > UNANSWERED_LIMIT_MS)) return false;
+    this.#pings.push(now);
+    return true;
+  }
+  /** Call as a pong is received. It answers the oldest ping in flight, and proves contact only if the round trip was short. */
+  ponged() {
+    const sent = this.#pings.shift();
+    if (sent === void 0) return;
+    const now = this.#read();
+    const wall = now.wall - sent.wall;
+    const mono = now.mono - sent.mono;
+    if (wall < 0 || wall > ROUND_TRIP_MS || mono < 0 || mono > ROUND_TRIP_MS || now.suspends !== sent.suspends) return;
+    this.#proof = sent;
+  }
+  proof() {
+    return this.#proof;
+  }
+  longSince(proof) {
+    if (proof === null) return true;
+    const now = this.#read();
+    const wall = now.wall - proof.wall;
+    const mono = now.mono - proof.mono;
+    return wall < 0 || mono < 0 || wall >= LONG_DROP_MS || mono >= LONG_DROP_MS || now.suspends !== proof.suspends;
+  }
+  #read() {
+    return { wall: this.#clock.wall(), mono: this.#clock.mono(), suspends: this.#suspends + (this.#page?.wasDiscarded === true ? 1 : 0) };
+  }
+};
+
 // src/generated/sync.ts
 import { Schema } from "effect";
 var SyncProtocolMetadata = {
@@ -874,8 +941,13 @@ function strictEvent(value) {
       return false;
   }
 }
+function validMediaOffReason(item) {
+  if (!Object.hasOwn(item, "off_reason")) return !Object.hasOwn(item, "off_revision");
+  if (item.off_reason === "host") return Number.isInteger(item.off_revision) && item.off_revision > 0;
+  return item.enabled === false && (item.off_reason === "self" || item.off_reason === "dead") && !Object.hasOwn(item, "off_revision");
+}
 function strictProjectionItem(value, stream) {
-  if (stream === "media") return exactObject(value, ["participant_id", "source", "enabled", "publication_id"]);
+  if (stream === "media") return isObject(value) && exactObject(value, [...["participant_id", "source", "enabled", "publication_id"], ...Object.hasOwn(value, "off_reason") ? ["off_reason"] : [], ...Object.hasOwn(value, "off_revision") ? ["off_revision"] : []]) && validMediaOffReason(value);
   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;
@@ -889,10 +961,12 @@ 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;
+  if (Object.hasOwn(value, "media_off_reason") && value.media_off_reason !== true) return false;
   const fields = [
     ...base,
     ...extensionValid ? ["extensions"] : [],
     ...Object.hasOwn(value, "entry_confirmation") ? ["entry_confirmation"] : [],
+    ...Object.hasOwn(value, "media_off_reason") ? ["media_off_reason"] : [],
     ...Object.hasOwn(value, "entry_generation") ? ["entry_generation"] : [],
     ...Object.hasOwn(value, "participant_identity_id") ? ["participant_identity_id"] : []
   ];
@@ -1506,6 +1580,7 @@ var WelcomeBase = {
   recovery_id: UuidSchema,
   head: ControlCursorSchema,
   entry_confirmation: Schema.optionalKey(Schema.Literal(true)),
+  media_off_reason: Schema.optionalKey(Schema.Literal(true)),
   entry_generation: Schema.optionalKey(PositiveIntegerSchema.check(Schema.isLessThanOrEqualTo(9007199254740991)))
 };
 var ExtendedWelcomeBase = { ...WelcomeBase, extensions: Schema.Tuple([CollaborationWelcomeExtensionSchema]) };
@@ -1548,9 +1623,14 @@ var CommittedAckFrameSchema = Schema.Struct({ type: Schema.Literal("ack"), comma
 var SatisfiedAckFrameSchema = Schema.Struct({ type: Schema.Literal("ack"), command_id: CommandIdSchema, delivery: AckDeliverySchema, outcome: Schema.Literal("satisfied"), revision: NonNegativeIntegerSchema, state_digest: StateDigestSchema, ...ServerCorrelationFields });
 var RejectedAckFrameSchema = Schema.Struct({ type: Schema.Literal("ack"), command_id: CommandIdSchema, delivery: AckDeliverySchema, outcome: Schema.Literal("rejected"), reason: RejectionReasonSchema, ...ServerCorrelationFields });
 var CommandIdConflictAckFrameSchema = Schema.Struct({ type: Schema.Literal("ack"), command_id: CommandIdSchema, delivery: AckDeliverySchema, outcome: Schema.Literal("command_id_conflict"), reason: Schema.Literal("command_id_conflict"), ...ServerCorrelationFields });
-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 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)),
+  off_reason: Schema.optional(Schema.Literals(["host", "self", "dead"])),
+  off_revision: Schema.optional(PositiveIntegerSchema)
+}).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")]),
@@ -3071,6 +3151,11 @@ var V1SyncClient = class {
   #socketCloses = [];
   #omittedSocketCloses = 0;
   #lastHeartbeatReplyAt = null;
+  /** Whether this connection's welcome advertised `media_off_reason`; reset for each connection. */
+  #offReasonNegotiated = false;
+  #watch;
+  /** Tells a recovery whether the drop was proven short. */
+  link;
   #opened = false;
   #connectFailure;
   #connectDiagnostic() {
@@ -3097,6 +3182,8 @@ var V1SyncClient = class {
   constructor(options) {
     assertV1Url(options.url);
     this.#options = options;
+    this.#watch = new LinkWatch({ wall: () => this.#now(), mono: options.monotonic ?? (() => performance.now()) }, options.page === void 0 ? typeof document === "object" ? document : null : options.page);
+    this.link = this.#watch;
     this.#commandScheduler = new V1CommandScheduler({
       store: options.pendingStore ?? new InMemoryV1PendingTargetStore(),
       ids: options.ids,
@@ -3143,6 +3230,7 @@ var V1SyncClient = class {
   async start() {
     if (this.#started) return;
     this.#started = true;
+    this.#watch.open();
     this.#connectAttemptCount = 0;
     this.#socketCloses = [];
     this.#omittedSocketCloses = 0;
@@ -3155,6 +3243,7 @@ var V1SyncClient = class {
     } catch (error) {
       if (startupGeneration === this.#startupGeneration) {
         this.#started = false;
+        this.#watch.close();
       }
       throw error;
     }
@@ -3166,6 +3255,7 @@ var V1SyncClient = class {
   }
   stop() {
     this.#started = false;
+    this.#watch.close();
     this.#entryPending = false;
     this.#entryGeneration = null;
     this.#startupGeneration += 1;
@@ -3197,6 +3287,10 @@ var V1SyncClient = class {
     if (!this.#entryNegotiated) return;
     this.#send({ type: "entered" });
   }
+  /** True when the connected Sync advertised `media_off_reason` in its welcome, so media items may carry `off_reason`. */
+  offReasonNegotiated() {
+    return this.#offReasonNegotiated;
+  }
   getSnapshot() {
     const pendingCommands = this.#commandScheduler.pendingCommands;
     const optimisticControl = this.#control && this.#participantId ? optimisticV1Control(this.#control, this.#participantId, pendingCommands) : this.#control;
@@ -3357,6 +3451,7 @@ var V1SyncClient = class {
     if (this.#connectFailure?.opened) this.#connectFailure = void 0;
     this.#emit();
     this.#entryNegotiated = false;
+    this.#offReasonNegotiated = false;
     let socket;
     try {
       socket = this.#options.webSocket.connect(entryUrl(this.#options.url, this.#entryGeneration, this.#options.entryConfirmation === true));
@@ -3572,6 +3667,7 @@ var V1SyncClient = class {
         return;
       case "pong": {
         this.#requireLive();
+        this.#watch.ponged();
         this.#missedHeartbeats = 0;
         this.#lastHeartbeatReplyAt = this.#now();
         const previous = this.#health.health;
@@ -3586,6 +3682,7 @@ var V1SyncClient = class {
     this.#baggageHelloSocket = null;
     this.#collaborationState.acceptWelcome(frame);
     this.#entryNegotiated = frame.entry_confirmation === true;
+    this.#offReasonNegotiated = frame.media_off_reason === true;
     this.#entryGeneration = frame.entry_generation ?? this.#entryGeneration;
     this.#participantId = frame.participant_id;
     this.#participantGeneration = frame.participant_generation;
@@ -3667,6 +3764,9 @@ var V1SyncClient = class {
       this.#media = updateProjection(this.#media, frame.projection_id, frame.sequence, item, mediaKey);
       rememberBoundedEvidence(this.#mediaEventEvidence, frame.sequence, frameSignature(frame), MAX_PROJECTION_EVENT_EVIDENCE);
       this.#notifyRemotePublicationResumed(previous, item);
+      if (!this.#mediaEnded() && item.participantId === this.#participantId && previous?.publicationId && previous.publicationId !== item.publicationId) {
+        this.#options.mediaPlane?.localPublicationWithdrawn?.(previous.publicationId);
+      }
       if (!this.#mediaEnded() && item.participantId !== this.#participantId && (previous?.enabled !== item.enabled || previous?.publicationId !== item.publicationId)) {
         this.#options.mediaPlane?.remotePublicationsChanged?.(this.#media?.items ?? []);
       }
@@ -3925,7 +4025,7 @@ var V1SyncClient = class {
         this.#socket?.close(CLIENT_RESTART_CLOSE_CODE, "heartbeat timeout");
         return;
       }
-      this.#send({ type: "ping" });
+      if (!this.#sendPing()) return;
       this.#startHeartbeat();
     }, 2e4);
   }
@@ -3936,7 +4036,8 @@ var V1SyncClient = class {
   }
   #startNoticeProbe() {
     this.#clearNoticeProbe();
-    this.#send({ type: "ping" });
+    this.#watch.restart();
+    this.#sendPing();
     this.#health = new V1SyncHealth(this.#now());
     const tick = () => {
       this.#noticeProbeTimer = void 0;
@@ -3944,7 +4045,7 @@ var V1SyncClient = class {
       const previous = this.#health.health;
       this.#health.check(this.#now());
       if (previous !== this.#health.health) this.#emit();
-      this.#send({ type: "ping" });
+      if (!this.#sendPing()) return;
       this.#noticeProbeTimer = this.#clock().setTimeout(tick, SYNC_HEALTH_BUDGET.probeIntervalMs);
     };
     this.#noticeProbeTimer = this.#clock().setTimeout(tick, SYNC_HEALTH_BUDGET.probeIntervalMs);
@@ -3954,6 +4055,16 @@ var V1SyncClient = class {
       this.#emit();
     }, SYNC_HEALTH_BUDGET.degradedAfterMs);
   }
+  // The link watch times each ping, so every ping goes through here. When the oldest ping has gone unanswered for over 60 s, the
+  // old heartbeat timeout, the socket is dead: it is replaced through the normal reconnect and this ping is not sent.
+  #sendPing() {
+    if (!this.#watch.pinged()) {
+      this.#recover("ping unanswered for 60 s");
+      return false;
+    }
+    this.#send({ type: "ping" });
+    return true;
+  }
   #clearNoticeProbe() {
     if (this.#noticeTimer !== void 0) this.#clock().clearTimeout(this.#noticeTimer);
     if (this.#noticeProbeTimer !== void 0) this.#clock().clearTimeout(this.#noticeProbeTimer);
@@ -3972,7 +4083,14 @@ function updateProjection(projection, projectionId, sequence, item, key) {
   return { projectionId, sequence, items: [...projection.items.filter((candidate) => key(candidate) !== itemKey), item] };
 }
 function mediaItem(item) {
-  return { participantId: item.participant_id, source: item.source, enabled: item.enabled, publicationId: item.publication_id };
+  return {
+    participantId: item.participant_id,
+    source: item.source,
+    enabled: item.enabled,
+    publicationId: item.publication_id,
+    ...item.off_reason === void 0 ? {} : { offReason: item.off_reason },
+    ...item.off_revision === void 0 ? {} : { offRevision: item.off_revision }
+  };
 }
 function presenceItem(item) {
   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 };
@@ -4005,6 +4123,7 @@ 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("media_off_reason", "1");
   url.searchParams.set("entry_generation", generation === null ? "new" : String(generation));
   if (confirmation) url.searchParams.set("entry_confirmation", "1");
   return url.toString();

package/dist/connection/dependencies.d.ts

@@ -3,6 +3,7 @@ import type { ConnectionReporter, ConnectionReportTransportEvent } from "./repor
 import type { ClientMediaPlane, CloudflareSFUBootstrap, ConnectionMediaSnapshot } from "../media";
 import type { ChalkChatFileTransport } from "../chat-files";
 import type { V1AdmissionTarget, V1AssignableRole, V1CommandResult, V1EpisodeSnapshot, V1SelfMediaTargetResult } from "../sync";
+import type { LinkJudge } from "../sync/link-watch";
 import type { V1CollaborationClient, V1DirectedRequest, V1DirectedRequestResult, V1MediaPause } from "../sync/v1-types";
 import type { ChalkWhiteboardSummary, ChalkWhiteboardV1ClientOptions, ChalkWhiteboardV1Transport } from "../whiteboard/types";
 import type { ParsedAccessGrant, ParticipantMediaAccess, ParticipantMediaCredential } from "../access/grant";
@@ -40,6 +41,10 @@ export type ConnectionSyncClient = V1CollaborationClient & {
     readonly restartTransport?: () => void;
     readonly stop: () => void;
     readonly getSnapshot: () => V1EpisodeSnapshot;
+    /** Judges whether a drop was proven short. Absent means unknown, which is treated as long. */
+    readonly link?: LinkJudge;
+    /** Whether the connected Sync advertised `media_off_reason`. Absent means no. */
+    readonly offReasonNegotiated?: () => boolean;
     readonly subscribe: (listener: (snapshot: V1EpisodeSnapshot) => void) => () => void;
     readonly leave: () => Promise<V1CommandResult>;
     readonly setMicrophoneEnabled: (enabled: boolean) => Promise<V1SelfMediaTargetResult>;

package/dist/connection/production.d.ts

@@ -10,6 +10,6 @@ export declare const makeProductionConnectionPlatformLayer: (options: {
     readonly syncURL: string;
     readonly whiteboardURL?: string | null;
 }) => import("effect/Layer").Layer<import("./dependencies").ConnectionPlatformService, never, never>;
-type BoundMediaClient = Pick<ConnectionMediaClient, "setLocalPublicationTarget" | "pauseLocalCapture" | "setLocalSourceIntent" | "closeForcedLocalPublication" | "observeLocalPublications" | "observeRemotePublications" | "remotePublicationsChanged" | "remoteParticipantsChanged" | "remotePublicationResumed" | "start" | "stop" | "prepareLocalTrack" | "clearPreparedLocalTrack" | "getSnapshot" | "subscribe">;
+type BoundMediaClient = Pick<ConnectionMediaClient, "setLocalPublicationTarget" | "pauseLocalCapture" | "setLocalSourceIntent" | "closeForcedLocalPublication" | "observeLocalPublications" | "observeRemotePublications" | "remotePublicationsChanged" | "remoteParticipantsChanged" | "remotePublicationResumed" | "localPublicationWithdrawn" | "start" | "stop" | "prepareLocalTrack" | "clearPreparedLocalTrack" | "getSnapshot" | "subscribe">;
 export declare function bindConnectionMediaClient(client: BoundMediaClient, restart: ConnectionMediaClient["restart"]): ConnectionMediaClient;
 export {};

package/dist/effect.js

@@ -17,7 +17,7 @@ import {
   makeSpaceClientCoreLayer,
   makeSpaceClientCoreLayerFromServices,
   makeSpaceStoreLayer
-} from "./chunk-2CEMOTZF.js";
+} from "./chunk-TA2BJXI7.js";
 import {
   APIKeyListSchema,
   APIKeyWithSecretSchema,
@@ -853,8 +853,8 @@ import {
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
 } from "./chunk-MHJ4UPM3.js";
-import "./chunk-O5JB5XVX.js";
-import "./chunk-FD7ZSDTM.js";
+import "./chunk-UVWRTXNO.js";
+import "./chunk-XF567GPH.js";
 import "./chunk-N4IPKRS6.js";
 
 // src/space-client/effect.ts

package/dist/generated/sync.d.ts

@@ -1333,6 +1333,7 @@ export declare const WelcomeSnapshotFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"snapshot">;
     readonly snapshot: Schema.Struct<{
@@ -1382,6 +1383,7 @@ export declare const WelcomeReplayFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"replay">;
 }>;
@@ -1401,6 +1403,7 @@ export declare const WelcomeUpToDateFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"up_to_date">;
 }>;
@@ -1420,6 +1423,7 @@ export declare const WelcomeTerminalFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"terminal">;
     readonly reason: Schema.Union<readonly [Schema.Literal<"episode_ended">, Schema.Literal<"participant_inactive">, Schema.Literal<"stale_participant_generation">]>;
@@ -1440,6 +1444,7 @@ export declare const ExtendedWelcomeSnapshotFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1502,6 +1507,7 @@ export declare const ExtendedWelcomeReplayFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1534,6 +1540,7 @@ export declare const ExtendedWelcomeUpToDateFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1566,6 +1573,7 @@ export declare const ExtendedWelcomeTerminalFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1599,6 +1607,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1660,6 +1669,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1691,6 +1701,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1722,6 +1733,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1754,6 +1766,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"snapshot">;
     readonly snapshot: Schema.Struct<{
@@ -1802,6 +1815,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"replay">;
 }>, Schema.Struct<{
@@ -1820,6 +1834,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"up_to_date">;
 }>, Schema.Struct<{
@@ -1838,6 +1853,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"terminal">;
     readonly reason: Schema.Union<readonly [Schema.Literal<"episode_ended">, Schema.Literal<"participant_inactive">, Schema.Literal<"stale_participant_generation">]>;
@@ -2198,6 +2214,8 @@ export declare const MediaProjectionItemSchema: Schema.Struct<{
     readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
     readonly enabled: Schema.Boolean;
     readonly publication_id: Schema.NullOr<Schema.String>;
+    readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+    readonly off_revision: Schema.optional<Schema.Number>;
 }>;
 export declare const PresenceProjectionItemSchema: Schema.Struct<{
     readonly participant_id: Schema.String;
@@ -2221,6 +2239,8 @@ export declare const MediaProjectionSnapshotFrameSchema: Schema.Struct<{
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>>;
 }>;
 export declare const PresenceProjectionSnapshotFrameSchema: Schema.Struct<{
@@ -2254,6 +2274,8 @@ export declare const MediaProjectionEventFrameSchema: Schema.Struct<{
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>;
 }>;
 export declare const PresenceProjectionEventFrameSchema: Schema.Struct<{
@@ -2287,6 +2309,8 @@ export declare const ProjectionFrameSchema: Schema.Union<readonly [Schema.Struct
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -2318,6 +2342,8 @@ export declare const ProjectionFrameSchema: Schema.Union<readonly [Schema.Struct
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -3037,6 +3063,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3098,6 +3125,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3129,6 +3157,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3160,6 +3189,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3192,6 +3222,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"snapshot">;
     readonly snapshot: Schema.Struct<{
@@ -3240,6 +3271,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"replay">;
 }>, Schema.Struct<{
@@ -3258,6 +3290,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"up_to_date">;
 }>, Schema.Struct<{
@@ -3276,6 +3309,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"terminal">;
     readonly reason: Schema.Union<readonly [Schema.Literal<"episode_ended">, Schema.Literal<"participant_inactive">, Schema.Literal<"stale_participant_generation">]>;
@@ -3921,6 +3955,8 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -3952,6 +3988,8 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   createSpaceClient,
   decodeWhiteboardV1ServerFrame,
   encodeWhiteboardV1ClientFrame
-} from "./chunk-2CEMOTZF.js";
+} from "./chunk-TA2BJXI7.js";
 import {
   createChalkPublicClient,
   createChalkPublicInviteClient,
@@ -41,7 +41,7 @@ import {
   setVideoRenderSize,
   validatePublicationSnapshot,
   waitFor
-} from "./chunk-O5JB5XVX.js";
+} from "./chunk-UVWRTXNO.js";
 import {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,
@@ -70,7 +70,7 @@ import {
   optimisticV1Control,
   reactionFromFrame,
   restoreV1Snapshot
-} from "./chunk-FD7ZSDTM.js";
+} from "./chunk-XF567GPH.js";
 import {
   SESSION_ID_KEY,
   currentSessionId,

package/dist/media/client.d.ts

@@ -6,6 +6,7 @@ export declare class CloudflareSFUClient implements ClientMediaPlane {
     getSnapshot(): CloudflareSFUSnapshot;
     subscribe(listener: () => void): () => void;
     remotePublicationResumed(publicationId: string): void;
+    localPublicationWithdrawn(publicationId: string): void;
     remoteParticipantsChanged(participantIds: readonly string[]): void;
     remotePublicationsChanged(publications?: readonly MediaPublication[], projectionState?: "available" | "unavailable"): void;
     prepareLocalTrack(source: MediaPublicationSource, track: MediaStreamTrack): void;

package/dist/media/index.js

@@ -11,7 +11,7 @@ import {
   setVideoRenderSize,
   validatePublicationSnapshot,
   waitFor
-} from "../chunk-O5JB5XVX.js";
+} from "../chunk-UVWRTXNO.js";
 import "../chunk-N4IPKRS6.js";
 export {
   CloudflareSFUClient,

package/dist/media/plane.d.ts

@@ -67,4 +67,5 @@ export type ClientMediaPlane = {
     readonly remotePublicationsChanged?: (publications?: readonly MediaPublication[], projectionState?: "available" | "unavailable") => void;
     readonly remoteParticipantsChanged?: (participantIds: readonly string[]) => void;
     readonly remotePublicationResumed?: (publicationId: string) => void;
+    readonly localPublicationWithdrawn?: (publicationId: string) => void;
 };

package/dist/sync/index.js

@@ -22,7 +22,7 @@ import {
   encodeV1ClientFrame,
   optimisticV1Control,
   restoreV1Snapshot
-} from "../chunk-FD7ZSDTM.js";
+} from "../chunk-XF567GPH.js";
 import "../chunk-N4IPKRS6.js";
 export {
   AsyncStorageV1PendingTargetStore,