@q9labsai/chalk-client 5.3.0 → 5.4.0

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

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

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

@@ -1,3 +1,7 @@
+import {
+  sessionBaggage
+} from "./chunk-N4IPKRS6.js";
+
 // src/sync/canonical.ts
 var encoder = new TextEncoder();
 function canonicalJson(value) {
@@ -297,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 = {
@@ -405,11 +476,20 @@ var SyncProtocolMetadata = {
         pattern: "^[a-z][a-z0-9_*\\-/]{0,255}=[\\x21-\\x2b\\x2d-\\x3c\\x3e-\\x7e]{1,256}(,[a-z][a-z0-9_*\\-/]{0,255}=[\\x21-\\x2b\\x2d-\\x3c\\x3e-\\x7e]{1,256})*$"
       }
     },
+    helloOnlyFields: {
+      baggage: {
+        kind: "string",
+        minBytes: 47,
+        maxBytes: 47,
+        format: "w3c-baggage-session-id",
+        pattern: "^session\\.id=[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+      }
+    },
     acceptedOn: {
       hello: "client-to-server",
       serverFrames: "server-to-client"
     },
-    upgradeHeaders: ["x-chalk-journey-id", "traceparent", "tracestate"],
+    upgradeHeaders: ["x-chalk-journey-id", "traceparent", "tracestate", "baggage"],
     rule: "propagate_from_first_observed_layer_to_every_downstream_frame"
   },
   externalIntents: [
@@ -712,7 +792,9 @@ function strictCommand(value) {
 function strictCollaborationsHelloExtension(value) {
   return exactObject(value, ["name", "chat_cursor"]) && ["collaboration_v1", "collaboration_v2"].includes(String(value.name)) && exactObject(value.chat_cursor, ["after_sequence", "retained_floor_sequence"]);
 }
-function strictHello(value) {
+function strictHello(hello) {
+  const { baggage, ...value } = hello;
+  if (baggage !== void 0 && !(typeof baggage === "string" && boundedCorrelationString(baggage, 47, 47) && /^session\.id=[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u.test(baggage))) return false;
   const base = exactObjectWithCorrelation(value, ["type", "protocol", "token", "streams"]);
   const extended = exactObjectWithCorrelation(value, ["type", "protocol", "token", "streams", "extensions"]) && Array.isArray(value.extensions) && value.extensions.length === 1 && strictCollaborationsHelloExtension(value.extensions[0]);
   if (!base && !extended || !exactObject(value.streams, ["control", "media", "presence", "requests"])) return false;
@@ -859,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;
@@ -874,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"] : []
   ];
@@ -957,9 +1046,10 @@ var TraceparentSchema = boundedUtf8String(55, 55).check(
 var TracestateSchema = boundedUtf8String(512, 1).check(
   Schema.makeFilter((value) => new RegExp("^[a-z][a-z0-9_*\\-/]{0,255}=[\\x21-\\x2b\\x2d-\\x3c\\x3e-\\x7e]{1,256}(,[a-z][a-z0-9_*\\-/]{0,255}=[\\x21-\\x2b\\x2d-\\x3c\\x3e-\\x7e]{1,256})*$", "u").test(value) ? void 0 : { path: [], issue: "must be a valid bounded W3C tracestate" })
 );
+var BaggageSchema = boundedUtf8String(47, 47).check(Schema.makeFilter((value) => /^session\.id=[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u.test(value) ? void 0 : { path: [], issue: "must be the single W3C baggage member session.id=<lowercase UUID>" }));
 var SyncCorrelationFieldsSchema = Schema.Struct({ journey_id: Schema.optional(JourneyIdSchema), traceparent: Schema.optional(TraceparentSchema), tracestate: Schema.optional(TracestateSchema) });
-var HelloCorrelationFields = { journey_id: Schema.optional(JourneyIdSchema), traceparent: Schema.optional(TraceparentSchema), tracestate: Schema.optional(TracestateSchema) };
-var ServerCorrelationFields = { ...HelloCorrelationFields };
+var ServerCorrelationFields = { journey_id: Schema.optional(JourneyIdSchema), traceparent: Schema.optional(TraceparentSchema), tracestate: Schema.optional(TracestateSchema) };
+var HelloCorrelationFields = { ...ServerCorrelationFields, baggage: Schema.optional(BaggageSchema) };
 var StateDigestSchema = Schema.String.check(Schema.makeFilter((value) => /^[0-9a-f]{64}$/u.test(value) ? void 0 : { path: [], issue: "must be a lowercase hexadecimal SHA-256 digest" }));
 var UnsignedDecimalSchema = Schema.String.check(Schema.makeFilter((value) => /^(?:0|[1-9][0-9]*)$/u.test(value) ? void 0 : { path: [], issue: "must be an unsigned decimal integer" }));
 var CommandIdSchema = boundedUtf8String(64).check(Schema.makeFilter((value) => textEncoder.encode(value).byteLength >= 16 ? void 0 : { path: [], issue: "must meet the command ID minimum byte length" }));
@@ -1490,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]) };
@@ -1532,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")]),
@@ -2528,6 +2624,11 @@ var V1CommandScheduler = class {
   async acknowledge(frame) {
     const deferred = this.#commands.get(frame.command_id);
     if (!deferred) return;
+    if (isSatisfiedByInactiveParticipant(frame, deferred.frame)) {
+      const head = this.#options.controlHead();
+      await this.#finishCommand(frame.command_id, { type: "ack", command_id: frame.command_id, delivery: "duplicate", outcome: "satisfied", revision: head.revision, state_digest: head.state_digest });
+      return;
+    }
     if (frame.outcome === "rejected" || frame.outcome === "command_id_conflict") {
       await this.#finishCommand(frame.command_id, frame);
       return;
@@ -2566,15 +2667,12 @@ var V1CommandScheduler = class {
     }
   }
   async settleTerminalRecovery(frame) {
-    const satisfiedOperations = /* @__PURE__ */ new Set();
-    if (frame.reason === "episode_ended") {
-      satisfiedOperations.add("end_episode");
-      satisfiedOperations.add("participant_leave");
-    } else if (frame.reason === "participant_inactive") {
-      satisfiedOperations.add("participant_leave");
-    }
+    const satisfies = (operation) => {
+      if (frame.reason === "episode_ended") return operation === "end_episode" || operation === "participant_leave";
+      return frame.reason === "participant_inactive" && inactiveParticipantSatisfies(operation);
+    };
     for (const [commandId, deferred] of this.#commands) {
-      if (deferred.frame.type !== "operation" || !satisfiedOperations.has(deferred.frame.name)) continue;
+      if (deferred.frame.type !== "operation" || !satisfies(deferred.frame.name)) continue;
       await this.#finishCommand(commandId, {
         type: "ack",
         command_id: commandId,
@@ -2744,6 +2842,12 @@ function targetFrame(commandId, command) {
       return { type: "command", command_id: commandId, name: command.name, payload: command.payload };
   }
 }
+function inactiveParticipantSatisfies(operation) {
+  return operation === "participant_leave";
+}
+function isSatisfiedByInactiveParticipant(result, command) {
+  return result.outcome === "rejected" && result.reason === "participant_inactive" && command.type === "operation" && inactiveParticipantSatisfies(command.name);
+}
 function isTerminalLifecycleOperation(frame) {
   return frame.type === "operation" && (frame.name === "participant_leave" || frame.name === "end_episode");
 }
@@ -3002,6 +3106,7 @@ var MAX_REPLAY_EVENTS = SyncProtocolLimits.completeReplayMaxEvents;
 var MAX_REPLAY_BYTES = SyncProtocolLimits.completeReplayEncodedBytes;
 var MAX_PROJECTION_EVENT_EVIDENCE = 256;
 var CLIENT_RESTART_CLOSE_CODE = 4e3;
+var legacyHelloServers = /* @__PURE__ */ new Set();
 var DEFAULT_RECONNECT_DELAY_MS = 250;
 var MAX_RECONNECT_DELAY_MS = 5e3;
 var FAST_RECONNECT_ATTEMPTS = 8;
@@ -3046,12 +3151,19 @@ 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() {
     return { stage: this.#opened ? "hello" : "upgrade", opened: this.#opened, closeCode: null, closeReason: null, durationMs: Math.max(0, this.#clock().now() - (this.#connectStartedAt ?? this.#clock().now())), attempt: this.#connectAttemptCount };
   }
   #reconnectAttempt = 0;
+  /** The socket whose hello carried baggage and has not been answered by a welcome yet. */
+  #baggageHelloSocket = null;
   #episodeEndTimer;
   #heartbeatTimer;
   #missedHeartbeats = 0;
@@ -3070,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,
@@ -3082,7 +3196,11 @@ var V1SyncClient = class {
       isStarted: () => this.#started,
       sendIfLive: (frame) => this.#sendIfLive(frame),
       stateChanged: () => this.#emit(),
-      ackHeadIsProven: (ack) => this.#ackHeadIsProven(ack)
+      ackHeadIsProven: (ack) => this.#ackHeadIsProven(ack),
+      controlHead: () => {
+        const control = this.#requireControl();
+        return { revision: control.revision, state_digest: control.stateDigest };
+      }
     });
     this.#liveTargets = new V1LiveTargetCoordinator({
       mediaPlane: options.mediaPlane,
@@ -3112,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;
@@ -3124,6 +3243,7 @@ var V1SyncClient = class {
     } catch (error) {
       if (startupGeneration === this.#startupGeneration) {
         this.#started = false;
+        this.#watch.close();
       }
       throw error;
     }
@@ -3135,6 +3255,7 @@ var V1SyncClient = class {
   }
   stop() {
     this.#started = false;
+    this.#watch.close();
     this.#entryPending = false;
     this.#entryGeneration = null;
     this.#startupGeneration += 1;
@@ -3166,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;
@@ -3326,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));
@@ -3373,11 +3499,12 @@ var V1SyncClient = class {
       this.#clock().setTimeout(() => {
         if (connectionGeneration !== this.#connectionGeneration) return;
         this.#inbound = this.#inbound.then(() => {
+          const legacyHello = event.code === 1009 && this.#legacyHelloRejected(socket);
           if (socket === this.#socket && event.code === 1008 && (event.reason === "" || event.reason === "invalid token" || event.reason === "policy violation" || event.reason === "entry timeout")) {
             this.#phase = { phase: "terminal", terminalReason: event.reason === "entry timeout" ? "entry_timeout" : "access_rejected" };
             this.#emit();
           }
-          this.#disconnected(socket);
+          this.#disconnected(socket, legacyHello);
         });
       }, 0);
     };
@@ -3394,10 +3521,12 @@ var V1SyncClient = class {
       const token = await this.#options.token();
       if (socket !== this.#socket) return;
       this.#phase = { phase: "recovering" };
+      const baggage = legacyHelloServers.has(this.#options.url) ? void 0 : sessionBaggage();
       const hello = {
         type: "hello",
         protocol: 1,
         ...this.#options.traceparent ? { traceparent: this.#options.traceparent } : {},
+        ...baggage ? { baggage } : {},
         token,
         streams: {
           control: { cursor: this.#control && { revision: this.#control.revision, state_schema_version: this.#control.stateSchemaVersion, state_digest: this.#control.stateDigest } },
@@ -3407,6 +3536,7 @@ var V1SyncClient = class {
         }
       };
       const collaborationExtension = this.#collaborationState.helloExtension;
+      this.#baggageHelloSocket = baggage ? socket : null;
       if (!collaborationExtension) {
         this.#send(hello);
       } else {
@@ -3426,7 +3556,7 @@ var V1SyncClient = class {
     } catch (error) {
       if (this.#snapshotRecoveryRequested) this.#failDigestRecovery();
       else if (error instanceof V1StateDigestMismatchError) this.#recoverDigestMismatch();
-      else this.#recover("invalid_frame");
+      else this.#recover("invalid_frame", error instanceof V1ReplicaError && error.message === "invalid_frame" && this.#legacyHelloRejected(socket));
     }
   }
   async #handleFrame(frame) {
@@ -3537,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;
@@ -3548,8 +3679,10 @@ var V1SyncClient = class {
   }
   async #welcome(frame) {
     if (this.#phase.phase !== "recovering" || this.#recovery) throw new V1ReplicaError("unexpected welcome");
+    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;
@@ -3631,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 ?? []);
       }
@@ -3704,7 +3840,7 @@ var V1SyncClient = class {
     if (evidence.get(frame.sequence) !== frameSignature(frame)) throw new V1ReplicaError("conflicting or unprovable duplicate projection event");
     return true;
   }
-  #disconnected(socket) {
+  #disconnected(socket, retryNow = false) {
     if (socket !== this.#socket) return;
     this.#socket = null;
     this.#clearDial();
@@ -3723,6 +3859,13 @@ var V1SyncClient = class {
     this.#emit();
     if (!this.#transportAvailable) return;
     this.#clearReconnect();
+    if (retryNow) {
+      this.#reconnectTimer = this.#clock().setTimeout(() => {
+        this.#reconnectTimer = void 0;
+        this.#connect();
+      }, 0);
+      return;
+    }
     const configuredDelay = this.#options.reconnectDelayMs;
     const exponentialAttempt = configuredDelay === void 0 ? Math.max(0, this.#reconnectAttempt - FAST_RECONNECT_ATTEMPTS + 1) : this.#reconnectAttempt;
     const baseDelay = configuredDelay === 0 ? 0 : Math.min(MAX_RECONNECT_DELAY_MS, (configuredDelay ?? DEFAULT_RECONNECT_DELAY_MS) * 2 ** Math.min(exponentialAttempt, 5));
@@ -3733,11 +3876,21 @@ var V1SyncClient = class {
       this.#connect();
     }, delay);
   }
-  #recover(reason) {
+  #recover(reason, retryNow = false) {
     const socket = this.#socket;
     if (!socket) return;
     socket.close(CLIENT_RESTART_CLOSE_CODE, reason);
-    this.#disconnected(socket);
+    this.#disconnected(socket, retryNow);
+  }
+  /**
+   * A Sync that predates the session ID rejects any hello with an unknown `baggage` field before welcome. The first
+   * rejection marks that server as legacy, so the retry and every later reconnect send the hello without it.
+   */
+  #legacyHelloRejected(socket) {
+    if (this.#baggageHelloSocket !== socket) return false;
+    this.#baggageHelloSocket = null;
+    legacyHelloServers.add(this.#options.url);
+    return true;
   }
   #recoverDigestMismatch() {
     const now = this.#clock().now();
@@ -3872,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);
   }
@@ -3883,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;
@@ -3891,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);
@@ -3901,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);
@@ -3919,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 };
@@ -3952,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();