@q9labsai/chalk-client 5.2.0 → 5.2.2

package/dist/chunk-6LNRDKJF.js

@@ -0,0 +1,162 @@
+import {
+  createChalkEffectClient,
+  parseAccessGrant
+} from "./chunk-GA3JDPFI.js";
+
+// src/public-invites/client.ts
+import { Effect } from "effect";
+function createChalkPublicClient(options) {
+  const baseClientOptions = {
+    baseUrl: options.baseUrl,
+    credentials: options.credentials ?? (options.runtime === "react-native" ? void 0 : "include"),
+    fetch: options.fetch
+  };
+  const createClient = (guestCredential, requestInit) => createChalkEffectClient({
+    ...baseClientOptions,
+    ...requestInit ? { fetch: requestInitFetch(options.fetch, requestInit) } : {},
+    headers: requestHeaders(options, guestCredential)
+  });
+  const createPublicSpace = async (input, idempotency) => {
+    const client = await Effect.runPromise(createClient(void 0));
+    const response = await Effect.runPromise(
+      client.spaces.createPublicSpace({
+        headers: { "Idempotency-Key": idempotencyKey(idempotency) },
+        payload: { display_name: required(input.displayName, "displayName") }
+      })
+    );
+    return publicSpaceCreated(response);
+  };
+  const arriveBySpacePublicInvite = async (input, arrival) => {
+    const client = await Effect.runPromise(createClient(arrival?.guestCredential ?? options.guestCredential));
+    const response = await Effect.runPromise(
+      client.spaces.arriveBySpacePublicInvite({
+        headers: {
+          "Idempotency-Key": idempotencyKey(arrival),
+          ...arrival?.arrivalHandle === void 0 ? {} : { "X-Chalk-Arrival-Handle": required(arrival.arrivalHandle, "arrivalHandle") }
+        },
+        payload: {
+          display_name: required(input.displayName, "displayName"),
+          space_invite_token: required(input.spaceInviteToken, "spaceInviteToken")
+        }
+      })
+    );
+    return publicSpaceArrival(response);
+  };
+  const getSpacePublicInviteArrival = async (reference) => {
+    const normalized = arrivalReference(reference);
+    const client = await Effect.runPromise(createClient(normalized.guestCredential ?? options.guestCredential));
+    const response = await Effect.runPromise(
+      client.spaces.getSpacePublicInviteArrival({
+        headers: { "X-Chalk-Arrival-Handle": normalized.arrivalHandle }
+      })
+    );
+    return publicSpaceArrival(response);
+  };
+  const refreshSpacePublicInviteAccess = async (input, arrival) => {
+    const normalized = refreshInput(input, arrival);
+    const client = await Effect.runPromise(createClient(normalized.guestCredential ?? options.guestCredential, normalized.signal ? { signal: normalized.signal } : void 0));
+    const response = await Effect.runPromise(
+      client.spaces.refreshSpacePublicInviteAccess({
+        headers: { "X-Chalk-Arrival-Handle": normalized.arrivalHandle },
+        payload: { media_proof: required(normalized.mediaProof, "mediaProof"), replace_media_connection: normalized.replaceMediaConnection ?? false }
+      })
+    );
+    return parseAccessGrant(response);
+  };
+  const leaveSpacePublicInviteArrival = async (reference, leaveOptions) => {
+    const normalized = arrivalReference(reference);
+    const client = await Effect.runPromise(createClient(normalized.guestCredential ?? options.guestCredential, requestInitForLeave(leaveOptions)));
+    await Effect.runPromise(
+      client.spaces.leaveSpacePublicInviteArrival({
+        headers: { "X-Chalk-Arrival-Handle": normalized.arrivalHandle }
+      })
+    );
+  };
+  return {
+    prepareSpaceEntrance: async (spaceInviteToken) => {
+      const client = await Effect.runPromise(createClient(void 0));
+      await Effect.runPromise(client.spaces.preparePublicSpaceEntrance({ payload: { space_invite_token: required(spaceInviteToken, "spaceInviteToken") } }));
+    },
+    arrive: arriveBySpacePublicInvite,
+    arriveBySpacePublicInvite,
+    create: createPublicSpace,
+    createPublicSpace,
+    getSpacePublicInviteArrival,
+    leave: leaveSpacePublicInviteArrival,
+    leaveSpacePublicInviteArrival,
+    refresh: refreshSpacePublicInviteAccess,
+    refreshSpacePublicInviteAccess,
+    status: getSpacePublicInviteArrival
+  };
+}
+var createChalkPublicInviteClient = createChalkPublicClient;
+function requestHeaders(options, guestCredential) {
+  const headers = { ...options.headers };
+  if (options.runtime === "react-native") {
+    headers["X-Chalk-Client"] = "react-native";
+    const credential = guestCredential ?? options.guestCredential;
+    if (credential !== void 0) headers.Authorization = `ChalkGuest ${required(credential, "guestCredential")}`;
+  }
+  return headers;
+}
+function idempotencyKey(options) {
+  return options?.idempotencyKey === void 0 ? globalThis.crypto.randomUUID() : required(options.idempotencyKey, "idempotencyKey");
+}
+function arrivalReference(reference) {
+  if (typeof reference === "string") return { arrivalHandle: required(reference, "arrivalHandle") };
+  return { arrivalHandle: required(reference.arrivalHandle, "arrivalHandle"), guestCredential: reference.guestCredential };
+}
+function refreshInput(input, arrival) {
+  const values = typeof input === "string" ? { arrivalHandle: arrival?.arrivalHandle, guestCredential: arrival?.guestCredential, mediaProof: input } : { arrivalHandle: input.arrivalHandle ?? arrival?.arrivalHandle, guestCredential: input.guestCredential ?? arrival?.guestCredential, mediaProof: input.mediaProof, replaceMediaConnection: input.replaceMediaConnection, signal: input.signal };
+  return {
+    ...values,
+    arrivalHandle: required(values.arrivalHandle ?? "", "arrivalHandle")
+  };
+}
+function requestInitForLeave(options) {
+  if (options?.keepalive === void 0) return void 0;
+  return { keepalive: options.keepalive };
+}
+function requestInitFetch(fetchImplementation, requestInit) {
+  const implementation = fetchImplementation ?? globalThis.fetch;
+  return (input, init) => implementation(input, { ...init, ...requestInit });
+}
+function publicSpaceCreated(value) {
+  const { arrival, ...created } = value;
+  return { ...created, arrival: publicSpaceArrival(arrival) };
+}
+function publicSpaceArrival(value) {
+  const { access, ...arrival } = value;
+  if (access === void 0) return arrival;
+  return { ...arrival, access: access === null ? null : parseAccessGrant(access) };
+}
+function required(value, name) {
+  const normalized = value.trim();
+  if (!normalized) throw new TypeError(`${name} is required`);
+  return normalized;
+}
+
+// src/public-invites/words.ts
+var INVITE_WORD_COUNT = 4;
+var INVITE_WORDS = new Set(
+  "abacus able accent acorn acoustic acre acrobat active actor adore aerial agenda agent agile ahead aim airport album alike alive almond aloe aloha alone alpaca alto alumni amber amend ample amuse anchor angle animal anthem antique anvil apple april apron aqua arcade arctic area arena arise aroma array art artist aspire astute atlas atom attach attain attic audio autumn avenue avocado awake award awning bacon badge bagel baked baker bakery bamboo banana banjo banner barge barn basil basket batch baton beacon beetle blank blanket blaze blend blink blog blossom bluebird boat bobcat bolt bonsai bonus book booth boots boss botany both bottle boulder bounce bowler branch breeze brick bright brim bring brisk broil bronze brook broom brush bubble bucket budget buffalo builder bulb bulk bunch bundle bunny busy butter button buzz cabana cable cactus cake calm cameo camera camper campus canal canary candle candy canopy canyon cape captain carbon card cargo carrot carry cartoon case castle catalog cedar celery chair charm cheer cheese chef cherry chess chief chill chip chunk churn cinema circle circus citrus city civic civil claim clamp clap clasp class clay clean clear clever click cling clip cloak clock clone closet cloth cloud clover clump coach coast coat cobalt cocoa coconut coffee coil cola cold colony comfy comic compass concert condor cone cookie cope copper copy coral cork corner cosmic cost cotton couch cover craft crane crate crave crawl crayon create cricket crisp crop crowd crown crumb crust crystal cub cube cupcake curl curry cursor curve cut cycle daffodil daily daisy dance dash date dawn deal debug decaf deck decor delta deluxe denim depth desk device dial diary dice dig dime diner dinner disco dish dock doing doll dolphin domain dome donut dot down dragon dragonfly drama draw drawing dress dried drift drill drive drizzle drove drum dry duck duke duo dusk dust duty eagle early earth easel east echo eclipse edge editor eel effort elder elf elk elm email ember emblem emboss emerald encore energy engine enrich enter entry equal equator eraser errand even evolve exact exit expert fable fabric fact factory falcon fall fame family fancy feast feather feed fence fern ferry fetch fiber fiddle figure film filter final finale finch firefly fit five flag flame flap flick flight flip float flock flower foam fog foil folk font food forest fossil found fountain fox frame fresh fridge friend from front frost fruit gala galaxy game gap garage garden garlic gave gazebo gear gecko gem gerbil giant gift gig ginger giraffe glacier glad glass glide glitter glory gloss glove glow glue goal going golden golf good gown grab grain granite grant grape graph grasp grass gravy green greet grew grid grill grip groom groove guide guitar gulf gummy gush habit half hamster happy harvest hatch haven hazel hazy heap heat hedge helium helmet help heron hickory holiday honey horizon hub hula hull human humid hurry hut ice iceberg icing icon igloo image insect iron island item ivory ivy jacket jaguar jam jasmine jazz jelly jersey jet jigsaw job jog jolly jolt journal joy judge juice juicy july jumbo jump jungle keep kettle kilt king kite kitten kiwi koala ladder lady lagoon lake lamp land lantern laptop large latch laurel lavender leaflet legend lemon length lens leopard letter lettuce level lever library lid life lift lilac lily limit line linen lint lion liquid list little lively lizard lobster locket lotus luggage lumber lunar lunch lyric magnet maker mango manor many map maple marble marine market mascot mash match math meadow melon mercury meteor mitten mocha monkey mop mosaic motor motto mount mouse move movie mud muffin mug mural muse museum mushroom music nacho nail name nap napkin nature neat nectar neon nest net next nickel noodle nugget nutmeg nylon oak oasis oat oatmeal ocean octagon octopus oil olive onion opal open opera orchid origami otter outdoor outer oval oven owl oxygen oyster ozone pace packet pager palace palm panda panther pantry pants papaya paper parade parcel park parrot parsley party pasta pastel patch path patio pebble pecan pelican pencil penguin penny pepper perch petal photo picnic pigeon pillow plank plant plaza plenty pluck plug plus pod poem poet point polar polka polo pond pony poppy portal poster pouch pound power press print prism prize proof pug pull pulp pulse puma pupil puppet puppy purse push puzzle quiet quilt quota quote race rack radar radio radish raft rail rake rally ramp ranch range ranger rank raven reach react recap relax relay relic remix repay reply rerun reset rhyme ribbon rice rich ride rinse ripple rise river robe robin rock rocket rope rover royal ruby rug rule rush safari sage salad salon salsa salt sample sandy satin say scale scan scarf scoop scoot scope score scout scrap screen script scrub scuba scuff sedan send serve seven shack shade shaky shape shed sheep shelf shell shine shiny ship shirt shop shore sift silk silly silver simple single sip size skate sketch skid skip skirt sky slab slack slate sled sleek sleep slice slick sling slip slush small smile snack snap snowy speak speed spend spent spill spiny spoke sponge spool spoon sport spot spout spray spring sprint sprout spruce spur squad squid stack staff stage stall stamp stand staple start state statue steam steep stem step stereo stew stick sting stir stock stool stop storm stove straw stream street strut stuck studio stuff stump stunt subway sugar surf sushi swan sway sweep swell swim swing swipe swirl swoop syrup tablet taco tag take tall task taste tasty thaw theme think thread thumb tiara tidal tidy tiger tile tilt tint tiny trace track trade train travel tray treat tree trek trend trial trick trio trophy trout truck trunk try tug tulip turf turtle tutor tweak tweet twice twins twirl twist uncle undo unify unit untie update upper urban user valley value velvet venue verify verse vest video view violet vista vocal voice volt vowel voyage wafer wagon wake walk walnut wand watch water wavy wheat whoop widen width willow wing wink wipe wise wish wizard wok wolf wool word work woven yam yard year yelp yield yoga yogurt yummy zebra zero zesty zippy zone zoom".split(
+    " "
+  )
+);
+
+// src/public-invites/code.ts
+var INVITE_CODE_PATTERN = /^(?:[a-z]{10}|[a-z]{3}-[a-z]{4}-[a-z]{3})$/;
+function parseInviteCode(value) {
+  const normalized = value.trim().toLowerCase();
+  const words = normalized.split(/[-.\s]+/u);
+  if (words.length === INVITE_WORD_COUNT && words.every((word) => INVITE_WORDS.has(word))) return words.join("-");
+  if (!INVITE_CODE_PATTERN.test(normalized)) return void 0;
+  const code = normalized.replaceAll("-", "");
+  return `${code.slice(0, 3)}-${code.slice(3, 7)}-${code.slice(7)}`;
+}
+
+export {
+  createChalkPublicClient,
+  createChalkPublicInviteClient,
+  parseInviteCode
+};

package/dist/{chunk-D2GXPX2P.js → chunk-AIJ5Z6HA.js}

@@ -154,7 +154,9 @@ function createReactNativeWebSocketFactory(WebSocketConstructor) {
 function createReactNativeSyncLifecycle(environment) {
   return {
     subscribe(listener) {
-      const appState = environment.appState.addEventListener("change", (state) => listener(state === "active" ? "active" : "inactive"));
+      const appState = environment.appState.addEventListener("change", (state) => {
+        if (state !== "inactive") listener(state === "active" ? "active" : "inactive");
+      });
       const network = environment.networkInfo?.addEventListener((state) => listener(isNetworkOnline(state) ? "online" : "offline"));
       listener(environment.appState.currentState === "active" ? "active" : "inactive");
       return () => {
@@ -247,8 +249,11 @@ var SAFE_REASONS = /* @__PURE__ */ new Set([
 function safeSyncCloseReason(reason) {
   return reason ? SAFE_REASONS.has(reason) ? reason : "redacted" : null;
 }
+function syncConnectFailureCode(diagnostic) {
+  return diagnostic?.stage === "upgrade" ? "sync_start_failed" : "sync_hello_timeout";
+}
 function formatSyncConnectDiagnostic(diagnostic) {
-  return `[${diagnostic.stage}; open=${diagnostic.opened ? 1 : 0}; close=${diagnostic.closeCode ?? "none"}; reason=${safeSyncCloseReason(diagnostic.closeReason ?? void 0) ?? "none"}; ${Math.round(diagnostic.durationMs)}ms]`;
+  return `[${diagnostic.stage}; open=${diagnostic.opened ? 1 : 0}; close=${diagnostic.closeCode ?? "none"}; reason=${safeSyncCloseReason(diagnostic.closeReason ?? void 0) ?? "none"}; ${diagnostic.stage === "upgrade" && diagnostic.closeCode !== null ? "cause=closed_before_open; " : ""}${diagnostic.attempt === void 0 ? "" : `attempt=${diagnostic.attempt}; `}${diagnostic.attempts === void 0 ? "" : `attempts=${diagnostic.attempts}; `}${Math.round(diagnostic.durationMs)}ms]`;
 }
 
 // src/sync/v1-health.ts
@@ -1956,7 +1961,7 @@ function reduceEvent(state, event) {
     case "episode_started":
       return state;
     case "episode_ended":
-      return { ...state, status: "ended", participants: [], admissionRequests: [], recording: null };
+      return { ...state, status: "ended", endReason: event.payload.reason, participants: [], admissionRequests: [], recording: null };
     case "hand_raised":
     case "hand_lowered":
       return updateParticipant(state, event.payload.participant_id, (participant) => ({ ...participant, handRaised: event.name === "hand_raised" }));
@@ -3022,12 +3027,14 @@ var V1SyncClient = class {
   #cancelDial;
   #dialTimeoutCount = 0;
   #connectStartedAt = null;
+  #connectAttemptCount = 0;
   #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())) };
+    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;
+  #episodeEndTimer;
   #heartbeatTimer;
   #missedHeartbeats = 0;
   #noticeTimer;
@@ -3087,6 +3094,8 @@ var V1SyncClient = class {
   async start() {
     if (this.#started) return;
     this.#started = true;
+    this.#connectAttemptCount = 0;
+    this.#connectFailure = void 0;
     const startupGeneration = ++this.#startupGeneration;
     let stored;
     try {
@@ -3112,6 +3121,8 @@ var V1SyncClient = class {
     this.#unsubscribeLifecycle = void 0;
     this.#clearReconnect();
     this.#clearDial();
+    this.#clock().clearTimeout(this.#episodeEndTimer);
+    this.#episodeEndTimer = void 0;
     this.#clearHeartbeat();
     this.#clearNoticeProbe();
     this.#commandScheduler.stop("client_stopped");
@@ -3283,9 +3294,10 @@ var V1SyncClient = class {
   #connect() {
     if (!this.#started || !this.#transportAvailable || this.#socket || this.#phase.phase === "terminal") return;
     this.#phase = { phase: "connecting" };
+    this.#connectAttemptCount += 1;
     this.#connectStartedAt = this.#clock().now();
     this.#opened = false;
-    this.#connectFailure = void 0;
+    if (this.#connectFailure?.opened) this.#connectFailure = void 0;
     this.#emit();
     this.#entryNegotiated = false;
     let socket;
@@ -3294,7 +3306,7 @@ var V1SyncClient = class {
     } catch {
       this.#connectFailure = this.#connectDiagnostic();
       this.#emit();
-      throw new V1SyncError("Sync WebSocket could not be created", "sync_hello_timeout");
+      throw new V1SyncError("Sync WebSocket could not be created", "sync_start_failed");
     }
     const connectionGeneration = ++this.#connectionGeneration;
     this.#socket = socket;
@@ -3336,7 +3348,7 @@ var V1SyncClient = class {
     };
     socket.onerror = () => {
       if (socket === this.#socket && (this.#phase.phase === "connecting" || this.#phase.phase === "recovering")) {
-        this.#connectFailure = this.#connectDiagnostic();
+        this.#connectFailure ??= this.#connectDiagnostic();
         this.#emit();
       }
       socket.close(CLIENT_RESTART_CLOSE_CODE, "transport error");
@@ -3423,6 +3435,19 @@ var V1SyncClient = class {
       case "ack":
         this.#requireLive();
         await this.#commandScheduler.acknowledge(frame);
+        if (frame.outcome === "rejected" && frame.reason === "episode_ended") {
+          if (this.#episodeEndTimer === void 0) {
+            this.#episodeEndTimer = this.#clock().setTimeout(() => {
+              this.#episodeEndTimer = void 0;
+              if (this.#control?.status === "ended" || this.#phase.phase === "terminal") return;
+              this.#phase = { phase: "terminal", terminalReason: "episode_ended" };
+              this.#clearReconnect();
+              this.#socket?.close(1e3, "episode ended");
+              this.#emit();
+            }, 5e3);
+          }
+          this.#recover("episode ended");
+        }
         return;
       case "retryable_error":
         this.#requireLive();
@@ -3652,9 +3677,10 @@ var V1SyncClient = class {
     this.#presence = null;
     this.#rejectRequests("disconnected_before_delivery");
     this.#collaborationState.disconnect("disconnected_before_delivery");
-    if (!this.#started || !this.#transportAvailable || this.#phase.phase === "terminal") return;
+    if (!this.#started || this.#phase.phase === "terminal") return;
     this.#phase = { phase: "connecting" };
     this.#emit();
+    if (!this.#transportAvailable) return;
     this.#clearReconnect();
     const configuredDelay = this.#options.reconnectDelayMs;
     const exponentialAttempt = configuredDelay === void 0 ? Math.max(0, this.#reconnectAttempt - FAST_RECONNECT_ATTEMPTS + 1) : this.#reconnectAttempt;
@@ -3699,8 +3725,13 @@ var V1SyncClient = class {
     if (event === "online" || event === "offline") this.#online = event === "online";
     else this.#active = event === "active";
     this.#transportAvailable = this.#online && this.#active;
-    if (!this.#transportAvailable) this.#socket?.close(CLIENT_RESTART_CLOSE_CODE, "lifecycle unavailable");
-    else this.#connect();
+    if (!this.#transportAvailable) {
+      const socket = this.#socket;
+      if (socket) {
+        socket.close(CLIENT_RESTART_CLOSE_CODE, "lifecycle unavailable");
+        this.#disconnected(socket);
+      }
+    } else this.#connect();
   }
   #rejectEphemeral(code) {
     this.#rejectRequests(code);
@@ -4022,6 +4053,7 @@ function createV1SyncClient(options) {
 }
 
 export {
+  syncConnectFailureCode,
   formatSyncConnectDiagnostic,
   UuidSchema,
   ReactionValues,

package/dist/{chunk-HO4745TX.js → chunk-GA3JDPFI.js}

@@ -532,6 +532,7 @@ var PublicSpaceArrivalSchema = Schema.Struct({
     Schema.NullOr(
       Schema.Struct({
         admission_mode: Schema.String,
+        maximum_episode_duration_seconds: Schema.optional(Schema.Number),
         name: Schema.String,
         slug: Schema.String
       })
@@ -546,6 +547,7 @@ var PublicSpaceCreatedSchema = Schema.Struct({
   lifecycle_until: DateTimeStringSchema,
   space: Schema.Struct({
     admission_mode: Schema.String,
+    maximum_episode_duration_seconds: Schema.optional(Schema.Number),
     name: Schema.String,
     slug: Schema.String
   })

package/dist/{chunk-BCO3AZUB.js → chunk-XPW3OCPO.js}

@@ -6,7 +6,7 @@ import {
 import {
   AccessGrantError,
   requireParsedAccessGrant
-} from "./chunk-HO4745TX.js";
+} from "./chunk-GA3JDPFI.js";
 import {
   ChatAttachmentMimeTypeSchema,
   ChatReactionSetFrameSchema,
@@ -18,8 +18,9 @@ import {
   createBrowserWebSocketFactory,
   createV1SyncClient,
   formatSyncConnectDiagnostic,
-  scheduleSyncDialDeadline
-} from "./chunk-D2GXPX2P.js";
+  scheduleSyncDialDeadline,
+  syncConnectFailureCode
+} from "./chunk-AIJ5Z6HA.js";
 
 // src/access/manager.ts
 import { Clock, Context, Data, Effect, Layer, SynchronizedRef } from "effect";
@@ -2551,7 +2552,7 @@ var ConnectionDiagnostics = class {
 
 // src/connection/lifecycle.ts
 var MEDIA_RECOVERY_TIMEOUT_MS = 6e4;
-var START_TIMEOUT_MS = 1e4;
+var START_TIMEOUT_MS = 3e4;
 var LEAVE_TIMEOUT_MS = 5e3;
 var RECOVERY_BUDGET_MS = 1e4;
 var MAX_RECOVERY_ATTEMPTS = 3;
@@ -2621,6 +2622,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
       initialMediaIntent: null,
       intent: { microphone: options.initialMicrophoneEnabled ?? true, camera: options.initialCameraEnabled ?? true },
       episodeEndConfirmed: false,
+      episodeEndReason: void 0,
       removedByHost: false,
       activeScope: null,
       syncBindingCleanup: null,
@@ -2767,7 +2769,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
         const failure2 = snapshot.connection.connectFailure;
         if (failure2 && failure2 !== observedConnectFailure) {
           observedConnectFailure = failure2;
-          diagnostics.record({ event: "sync_connect_failed", state: model.state, epoch: model.epoch, code: "sync_hello_timeout", sync: failure2 });
+          diagnostics.record({ event: "sync_connect_failed", state: model.state, epoch: model.epoch, code: syncConnectFailureCode(failure2), sync: failure2 });
         }
         const count = snapshot.connection.dialTimeoutCount ?? 0;
         if (count > observedDialTimeouts) {
@@ -2843,7 +2845,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
       const span = diagnostics.startSpan({ step, state: model.state, epoch: model.epoch });
       return effect.pipe(
         Effect2.tap(() => Effect2.sync(() => span.end({ state: model.state, epoch: model.epoch, outcome: "succeeded" }))),
-        Effect2.tapError(() => Effect2.sync(() => span.end({ state: model.state, epoch: model.epoch, outcome: "failed" })))
+        Effect2.tapError((cause) => Effect2.sync(() => span.end({ state: model.state, epoch: model.epoch, outcome: "failed", code: failureFromCause(cause, "internal_error", "Connection step failed").code })))
       );
     };
     const confirmSyncEntry = (sync) => {
@@ -2856,6 +2858,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
       model.epoch += 1;
       model.failure = null;
       model.episodeEndConfirmed = false;
+      model.episodeEndReason = void 0;
       model.removedByHost = false;
       yield* transition("joining");
       const span = diagnostics.startSpan({ step: "join", state: model.state, epoch: model.epoch });
@@ -2919,7 +2922,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
         Effect2.matchEffect({
           onFailure: (cause) => Effect2.gen(function* () {
             stopStream(stream);
-            const failure2 = failureFromCause(cause, "sync_start_failed", "The Connection could not start");
+            const failure2 = failureFromCause(cause, "internal_error", "The Connection could not start");
             model.failure = toFailure(failure2);
             if (model.joinCancelled) {
               span.end({ state: model.state, epoch: model.epoch, outcome: "cancelled", code: "invalid_state" });
@@ -3265,7 +3268,10 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
       const ended = episodeEnded(snapshot);
       const removed = snapshot.connection.terminalReason === "participant_removed";
       if (ended || removed || snapshot.connection.terminalReason === "participant_inactive") {
-        if (ended) model.episodeEndConfirmed = true;
+        if (ended) {
+          model.episodeEndConfirmed = true;
+          model.episodeEndReason = snapshot.control?.endReason;
+        }
         if (removed) model.removedByHost = true;
         yield* finishTerminalSnapshot();
         return true;
@@ -3454,6 +3460,7 @@ function snapshotFor(model, access) {
     connection: Object.freeze({ syncHealth: model.syncSnapshot?.connection.health, sync: model.syncSnapshot?.connection.phase === "live" && model.syncNoticeUnresponsive ? "unresponsive" : syncPhase(model.syncSnapshot?.connection.phase), media: mediaPhase(model.mediaSnapshot?.connection.phase) }),
     failure: model.failure ? Object.freeze({ ...model.failure }) : null,
     episodeEnded: model.episodeEndConfirmed,
+    episodeEndReason: model.episodeEndReason,
     removedByHost: model.removedByHost
   });
 }
@@ -3578,9 +3585,11 @@ function syncTerminalFailure(snapshot) {
   return lifecycleFailure("sync_start_failed", true, "The Sync transport needs recovery");
 }
 function syncStartupFailure(snapshot) {
-  const sync = snapshot.connection.connectFailure ?? snapshot.connection.connectAttempt;
+  const evidence = snapshot.connection.connectFailure ?? snapshot.connection.connectAttempt;
+  const attempts = snapshot.connection.connectAttempt?.attempt;
+  const sync = evidence ? { ...evidence, ...attempts === void 0 ? {} : { attempts } } : void 0;
   const message = sync?.opened === false ? "Sync could not reach the call service" : "Sync could not connect";
-  return new ConnectionLifecycleFailure({ code: "sync_hello_timeout", recoverable: true, message: `${message}${sync ? ` ${formatSyncConnectDiagnostic(sync)}` : " before the startup deadline"}`, ...sync ? { sync: Object.freeze({ ...sync }) } : {} });
+  return new ConnectionLifecycleFailure({ code: syncConnectFailureCode(sync), recoverable: true, message: `${message}${sync ? ` ${formatSyncConnectDiagnostic(sync)}` : " before the startup deadline"}`, ...sync ? { sync: Object.freeze({ ...sync }) } : {} });
 }
 function syncAutoRecoverable(snapshot, failure2) {
   return failure2.recoverable && snapshot.connection.terminalReason !== "entry_timeout";
@@ -3625,6 +3634,7 @@ var INVALID_PAYLOAD_CODE_BY_ACTION = /* @__PURE__ */ new Map([
 ]);
 var MEDIA_TIMEOUT_FAILURE = { code: "media.timeout", recoverable: true, message: "Media did not respond in time. Try again." };
 var SYNC_FAILURES = /* @__PURE__ */ new Map([
+  ["sync_start_failed", { failure: { code: "connection.sync_start_failed", recoverable: true, message: "A connection to the call service could not be opened. Try again." } }],
   ["sync_hello_timeout", { failure: { code: "connection.sync_hello_timeout", recoverable: true, message: "Sync could not reach the call service. Try again." } }],
   ["not_live", { failure: { code: "connection.invalid_state", recoverable: true, message: "Wait for the call to connect, then try again." } }],
   ["signaling_timeout", { failure: MEDIA_TIMEOUT_FAILURE }],
@@ -3732,6 +3742,7 @@ var SpaceStore = class _SpaceStore {
       episode: snapshot.episode,
       lastError: sameError(current.lastError, error2) ? current.lastError : error2,
       episodeEnded: snapshot.episodeEnded ?? false,
+      episodeEndReason: snapshot.episodeEndReason,
       removedByHost: snapshot.removedByHost ?? false
     };
     if (sameConnection(current, next)) return;
@@ -3790,7 +3801,7 @@ function connectionStatus(snapshot) {
   return snapshot.state === "live" && interrupted ? "reconnecting" : snapshot.state;
 }
 function sameConnection(left, right) {
-  return left.status === right.status && left.syncHealth === right.syncHealth && sameEpisode(left.episode, right.episode) && left.lastError === right.lastError && left.episodeEnded === right.episodeEnded && left.removedByHost === right.removedByHost;
+  return left.status === right.status && left.syncHealth === right.syncHealth && sameEpisode(left.episode, right.episode) && left.lastError === right.lastError && left.episodeEnded === right.episodeEnded && left.episodeEndReason === right.episodeEndReason && left.removedByHost === right.removedByHost;
 }
 function sameEpisode(left, right) {
   if (left === right) return true;
@@ -4348,6 +4359,7 @@ function chatError(message) {
 // src/space-client/media-controller.ts
 import { Clock as Clock3, Context as Context6, Deferred as Deferred2, Effect as Effect5, Exit as Exit2, Layer as Layer6, Semaphore } from "effect";
 var MEDIA_SOURCES = ["microphone", "camera", "screen"];
+var MEDIA_READY_TIMEOUT_MS = 1e4;
 function sourceWorker(enabled) {
   return { desired: { enabled, revision: 0, previousEnabled: enabled }, result: { revision: 0, status: "confirmed" }, sentRevision: 0, initialRevision: 0, localEnabled: enabled, pause: null, serverSequence: -1, forcedRevision: null };
 }
@@ -4392,8 +4404,9 @@ var MediaControllerRuntime = class {
   #tracks = /* @__PURE__ */ new Map();
   #sources = { microphone: sourceWorker(true), camera: sourceWorker(true), screen: sourceWorker(false) };
   #syncLive = false;
-  #pendingSources = /* @__PURE__ */ new Set();
+  #pendingSources = /* @__PURE__ */ new Map();
   #pendingCaptures = /* @__PURE__ */ new Set();
+  #readinessChecks = /* @__PURE__ */ new Set();
   #requestGenerations = /* @__PURE__ */ new Map();
   #camera = { status: "idle" };
   #requests = Object.freeze([]);
@@ -4421,8 +4434,8 @@ 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.#mediaAction(enabled, this.#set("microphone", enabled));
-  setCameraEnabled = (enabled) => this.#mediaAction(enabled, this.#set("camera", enabled));
+  setMicrophoneEnabled = (enabled) => 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();
   selectMicrophone = (deviceId) => Effect5.sync(() => {
@@ -4516,6 +4529,7 @@ var MediaControllerRuntime = class {
     this.#fork(this.#refreshDevices().pipe(Effect5.ignore));
   }
   dispose() {
+    for (const check of this.#readinessChecks) check(normalizeMediaError(cancelledCaptureError()));
     this.#cancelCaptures();
     for (const unsubscribe of [this.#unsubscribeMedia, this.#unsubscribeRequests, this.#unsubscribePause, this.#unsubscribeSync]) unsubscribe?.();
     this.#unsubscribeConnection?.();
@@ -4540,8 +4554,37 @@ var MediaControllerRuntime = class {
   #mediaAction(enabling, operation) {
     return Effect5.suspend(() => !enabling || this.#store.getSnapshot().connection.status === "live" ? operation : Effect5.fail(normalizeMediaError(new V1SyncError("Media enable requires a live call", "not_live"))));
   }
+  #waitForLive(source, revision, ports) {
+    return Effect5.suspend(() => {
+      let cleanup = () => {
+      };
+      return Effect5.callback((resume) => {
+        const check = (failure2) => {
+          if (failure2) return resume(Effect5.fail(failure2));
+          if (this.#sources[source].desired.revision !== revision) return resume(Effect5.void);
+          if (ports && (this.#ports?.sync !== ports.sync || this.#ports.media !== ports.media)) return resume(Effect5.fail(normalizeMediaError(cancelledCaptureError())));
+          const state = this.#connection.getSnapshot().state;
+          if (state === "live" && this.#ports?.sync.getSnapshot().connection.phase === "live" && this.#store.getSnapshot().connection.status === "live") return resume(Effect5.void);
+          if (state !== "joining" && state !== "reconnecting" && state !== "live") resume(Effect5.fail(normalizeMediaError(new V1SyncError("Media enable requires a live call", "not_live"))));
+        };
+        this.#readinessChecks.add(check);
+        const unsubscribe = this.#connection.subscribe(() => check());
+        const unsubscribeStore = this.#store.subscribe(() => check());
+        const unsubscribePorts = this.#connection.subscribePorts(() => check());
+        const timer = this.#connection.scheduleUnsafe(() => check(new SpaceClientError({ code: "media.timeout", recoverable: true, message: "The call did not connect in time. Try again." })), MEDIA_READY_TIMEOUT_MS);
+        cleanup = () => {
+          this.#readinessChecks.delete(check);
+          unsubscribe();
+          unsubscribeStore();
+          unsubscribePorts();
+          this.#connection.cancelScheduleUnsafe(timer);
+        };
+        check();
+      }).pipe(Effect5.ensuring(Effect5.sync(() => cleanup())));
+    });
+  }
   #set(source, enabled) {
-    return this.#act(source, enabled);
+    return Effect5.suspend(() => this.#store.getSnapshot().connection.status === "joining" ? this.#act(source, enabled) : this.#mediaAction(enabled, this.#act(source, enabled)));
   }
   #startScreen(options) {
     return this.#act("screen", true, options);
@@ -4576,19 +4619,41 @@ var MediaControllerRuntime = class {
         void state.pause.catch(() => void 0);
       }
     }
+    for (const check of this.#readinessChecks) check();
     return desired;
   }
   #act(source, enabled, options) {
     return Effect5.suspend(() => {
       const desired = this.#recordIntent(source, enabled, options);
-      return this.#serialize(source, this.#work(source)).pipe(
-        Effect5.andThen(
-          Effect5.suspend(() => {
-            if (enabled && this.#store.getSnapshot().connection.status !== "live") return this.#mediaAction(true, Effect5.void);
-            const result = this.#sources[source].result;
-            return result.revision === desired.revision && result.status === "failed" ? Effect5.fail(result.cause) : Effect5.void;
+      const ready = enabled && source !== "screen" && this.#store.getSnapshot().connection.status !== "live" ? this.#waitForLive(source, desired.revision).pipe(
+        Effect5.tapError(
+          (cause) => Effect5.sync(() => {
+            if (this.#sources[source].desired.revision === desired.revision) {
+              const cancelled = this.#recordIntent(source, false);
+              this.#sources[source].result = { revision: cancelled.revision, status: "failed", cause, cleanup: false };
+            }
           })
         )
+      ) : Effect5.void;
+      return this.#pending(
+        source,
+        ready.pipe(
+          Effect5.andThen(
+            Effect5.suspend(() => {
+              if (this.#sources[source].desired.revision !== desired.revision) return Effect5.void;
+              return this.#serialize(source, this.#work(source)).pipe(
+                Effect5.andThen(
+                  Effect5.suspend(() => {
+                    const result = this.#sources[source].result;
+                    if (result.revision === desired.revision && result.status === "failed") return Effect5.fail(result.cause);
+                    if (enabled && (source === "screen" || this.#sources[source].desired.enabled) && this.#store.getSnapshot().connection.status !== "live") return this.#mediaAction(true, Effect5.void);
+                    return Effect5.void;
+                  })
+                )
+              );
+            })
+          )
+        )
       );
     }).pipe(Effect5.mapError(normalizeMediaError));
   }
@@ -4663,18 +4728,24 @@ var MediaControllerRuntime = class {
           return source === "camera" && !intent.previousEnabled || !this.#hasTrack(source) ? this.#captureForPublish(
             source,
             ports.media,
-            (track) => Effect5.try({
-              try: () => {
-                captured = track;
-                this.#assertActivePorts(ports, action);
-                this.#assertCurrentIntent(source, intent.revision);
-                this.#setTrack(source, track);
-                ports.media.prepareLocalTrack(source, track);
-                prepared = true;
-                this.#publish();
-              },
-              catch: (cause) => cause
-            })
+            (track) => Effect5.sync(() => {
+              captured = track;
+            }).pipe(
+              Effect5.andThen(this.#waitForLive(source, intent.revision, ports)),
+              Effect5.andThen(
+                Effect5.try({
+                  try: () => {
+                    this.#assertActivePorts(ports, action);
+                    this.#assertCurrentIntent(source, intent.revision);
+                    this.#setTrack(source, track);
+                    ports.media.prepareLocalTrack(source, track);
+                    prepared = true;
+                    this.#publish();
+                  },
+                  catch: (cause) => cause
+                })
+              )
+            )
           ) : Effect5.void;
         });
         return retire.pipe(Effect5.andThen(acquire), Effect5.andThen(this.#send(ports, source, intent, true)));
@@ -4790,7 +4861,7 @@ var MediaControllerRuntime = class {
     return this.#serialize("microphone", this.#serialize("camera", publish));
   }
   #send(ports, source, intent, enabled) {
-    return this.#mediaAction(
+    const command = this.#mediaAction(
       enabled,
       foreign2(async () => {
         this.#assertCurrentIntent(source, intent.revision);
@@ -4798,9 +4869,12 @@ var MediaControllerRuntime = class {
         const state = this.#sources[source];
         state.sentRevision = intent.revision;
         await (source === "microphone" ? ports.sync.setMicrophoneEnabled(enabled) : source === "camera" ? ports.sync.setCameraEnabled(enabled) : ports.sync.setScreenShareEnabled(enabled));
-        this.#assertActivePorts(ports, source === "screen" ? "startScreenShare" : source === "camera" ? "setCameraEnabled" : "setMicrophoneEnabled");
-      })
+      }).pipe(
+        Effect5.andThen(enabled && source !== "screen" ? this.#waitForLive(source, intent.revision, ports) : Effect5.void),
+        Effect5.tap(() => Effect5.try({ try: () => this.#assertActivePorts(ports, source === "screen" ? "startScreenShare" : source === "camera" ? "setCameraEnabled" : "setMicrophoneEnabled"), catch: (cause) => cause }))
+      )
     );
+    return enabled && source !== "screen" ? this.#waitForLive(source, intent.revision, ports).pipe(Effect5.andThen(command)) : command;
   }
   #reconcileIntents() {
     const live = this.#connection.getSnapshot().state === "live" && this.#ports?.sync.getSnapshot().connection.phase === "live";
@@ -4825,18 +4899,21 @@ var MediaControllerRuntime = class {
     return pause;
   }
   #serialize(source, effect) {
-    return this.#gates.get(source).withPermit(
-      Effect5.sync(() => {
-        this.#pendingSources.add(source);
-        this.#publish();
-      }).pipe(
-        Effect5.andThen(effect),
-        Effect5.ensuring(
-          Effect5.sync(() => {
-            this.#pendingSources.delete(source);
-            this.#publish();
-          })
-        )
+    return this.#gates.get(source).withPermit(this.#pending(source, effect));
+  }
+  #pending(source, effect) {
+    return Effect5.sync(() => {
+      this.#pendingSources.set(source, (this.#pendingSources.get(source) ?? 0) + 1);
+      this.#publish();
+    }).pipe(
+      Effect5.andThen(effect),
+      Effect5.ensuring(
+        Effect5.sync(() => {
+          const remaining = this.#pendingSources.get(source) - 1;
+          if (remaining === 0) this.#pendingSources.delete(source);
+          else this.#pendingSources.set(source, remaining);
+          this.#publish();
+        })
       )
     );
   }
@@ -5279,9 +5356,9 @@ var MediaControllerRuntime = class {
     const snapshot = this.#ports?.media.getSnapshot();
     const state = this.#connection.getSnapshot().state;
     const local = Object.freeze({
-      microphone: localMedia("microphone", this.#localTracks(), snapshot, this.#sources.microphone.localEnabled, state, this.#pendingSources.has("microphone")),
-      camera: localMedia("camera", this.#localTracks(), snapshot, this.#sources.camera.localEnabled, state, this.#pendingSources.has("camera")),
-      screen: localMedia("screen", this.#localTracks(), snapshot, false, state, this.#pendingSources.has("screen"))
+      microphone: localMedia("microphone", this.#localTracks(), snapshot, this.#sources.microphone.localEnabled, state, this.#pendingSources.has("microphone") && this.#sources.microphone.desired.enabled),
+      camera: localMedia("camera", this.#localTracks(), snapshot, this.#sources.camera.localEnabled, state, this.#pendingSources.has("camera") && this.#sources.camera.desired.enabled),
+      screen: localMedia("screen", this.#localTracks(), snapshot, false, state, this.#pendingSources.has("screen") && this.#sources.screen.desired.enabled)
     });
     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({
@@ -5335,8 +5412,8 @@ function initialTrackEntries(microphone, camera) {
 function localMedia(source, tracks, snapshot, intended, connectionState, pending) {
   const track = tracks.get(source) ?? null;
   const publication = snapshot?.localTracks.find((candidate) => candidate.source === source);
-  if (locallyMuted(intended, track, publication)) return Object.freeze({ source, state: "disabled", track });
   if (pending) return Object.freeze({ source, state: "requesting", track });
+  if (locallyMuted(intended, track, publication)) return Object.freeze({ source, state: "disabled", track });
   if (publication?.enabled) return Object.freeze({ source, state: "enabled", track });
   if (publication && connectionState === "live") return Object.freeze({ source, state: "disabled", track });
   return Object.freeze({ source, state: localMediaState(source, track, intended, connectionState), track });
@@ -6338,7 +6415,7 @@ var SpaceClientCore = class {
       this.#store.updateConnection(snapshot);
       const newlyEnded = snapshot.episodeEnded && !this.#episodeEnded;
       this.#episodeEnded = snapshot.episodeEnded ?? false;
-      if (newlyEnded) this.#emit("episodeEnded", { episode });
+      if (newlyEnded) this.#emit("episodeEnded", { episode, reason: snapshot.episodeEndReason });
     });
   }
   getSnapshot = () => this.#store.getSnapshot();

package/dist/client.d.ts

@@ -4063,6 +4063,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
             readonly retry_after: import("effect/Schema").optional<import("effect/Schema").Number>;
             readonly space: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
                 readonly admission_mode: import("effect/Schema").String;
+                readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
                 readonly name: import("effect/Schema").String;
                 readonly slug: import("effect/Schema").String;
             }>>>;
@@ -4236,6 +4237,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
                 readonly retry_after: import("effect/Schema").optional<import("effect/Schema").Number>;
                 readonly space: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
                     readonly admission_mode: import("effect/Schema").String;
+                    readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
                     readonly name: import("effect/Schema").String;
                     readonly slug: import("effect/Schema").String;
                 }>>>;
@@ -4246,6 +4248,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
             readonly lifecycle_until: import("effect/Schema").brand<import("effect/Schema").String, "DateTimeString">;
             readonly space: import("effect/Schema").Struct<{
                 readonly admission_mode: import("effect/Schema").String;
+                readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
                 readonly name: import("effect/Schema").String;
                 readonly slug: import("effect/Schema").String;
             }>;
@@ -4665,6 +4668,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
             readonly retry_after: import("effect/Schema").optional<import("effect/Schema").Number>;
             readonly space: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
                 readonly admission_mode: import("effect/Schema").String;
+                readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
                 readonly name: import("effect/Schema").String;
                 readonly slug: import("effect/Schema").String;
             }>>>;

package/dist/connection/index.d.ts

@@ -18,6 +18,7 @@ export type ConnectionLifecycleSnapshot = {
     };
     readonly failure: ConnectionFailure | null;
     readonly episodeEnded?: boolean;
+    readonly episodeEndReason?: import("../sync/v1-types").V1ControlState["endReason"];
     readonly removedByHost?: boolean;
 };
 export type ConnectionPorts = {

package/dist/effect.js

@@ -17,7 +17,7 @@ import {
   makeSpaceClientCoreLayer,
   makeSpaceClientCoreLayerFromServices,
   makeSpaceStoreLayer
-} from "./chunk-BCO3AZUB.js";
+} from "./chunk-XPW3OCPO.js";
 import "./chunk-DWKTGBHR.js";
 import {
   APIKeyListSchema,
@@ -828,8 +828,8 @@ import {
   WhiteboardStorageUnavailableErrorSchema,
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
-} from "./chunk-HO4745TX.js";
-import "./chunk-D2GXPX2P.js";
+} from "./chunk-GA3JDPFI.js";
+import "./chunk-AIJ5Z6HA.js";
 
 // src/space-client/effect.ts
 import { Context, Effect, Exit, Layer, Scope } from "effect";

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

@@ -3994,6 +3994,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly retry_after: import("effect/Schema").optional<import("effect/Schema").Number>;
     readonly space: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
         readonly admission_mode: import("effect/Schema").String;
+        readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
         readonly name: import("effect/Schema").String;
         readonly slug: import("effect/Schema").String;
     }>>>;
@@ -4165,6 +4166,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
         readonly retry_after: import("effect/Schema").optional<import("effect/Schema").Number>;
         readonly space: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
             readonly admission_mode: import("effect/Schema").String;
+            readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
             readonly name: import("effect/Schema").String;
             readonly slug: import("effect/Schema").String;
         }>>>;
@@ -4175,6 +4177,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly lifecycle_until: import("effect/Schema").brand<import("effect/Schema").String, "DateTimeString">;
     readonly space: import("effect/Schema").Struct<{
         readonly admission_mode: import("effect/Schema").String;
+        readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
         readonly name: import("effect/Schema").String;
         readonly slug: import("effect/Schema").String;
     }>;
@@ -4589,6 +4592,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly retry_after: import("effect/Schema").optional<import("effect/Schema").Number>;
     readonly space: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
         readonly admission_mode: import("effect/Schema").String;
+        readonly maximum_episode_duration_seconds: import("effect/Schema").optional<import("effect/Schema").Number>;
         readonly name: import("effect/Schema").String;
         readonly slug: import("effect/Schema").String;
     }>>>;

package/dist/generated/schemas.d.ts

@@ -608,6 +608,7 @@ export declare const PublicSpaceArrivalSchema: Schema.Struct<{
     readonly retry_after: Schema.optional<Schema.Number>;
     readonly space: Schema.optional<Schema.NullOr<Schema.Struct<{
         readonly admission_mode: Schema.String;
+        readonly maximum_episode_duration_seconds: Schema.optional<Schema.Number>;
         readonly name: Schema.String;
         readonly slug: Schema.String;
     }>>>;
@@ -642,6 +643,7 @@ export declare const PublicSpaceCreatedSchema: Schema.Struct<{
         readonly retry_after: Schema.optional<Schema.Number>;
         readonly space: Schema.optional<Schema.NullOr<Schema.Struct<{
             readonly admission_mode: Schema.String;
+            readonly maximum_episode_duration_seconds: Schema.optional<Schema.Number>;
             readonly name: Schema.String;
             readonly slug: Schema.String;
         }>>>;
@@ -652,6 +654,7 @@ export declare const PublicSpaceCreatedSchema: Schema.Struct<{
     readonly lifecycle_until: Schema.brand<Schema.String, "DateTimeString">;
     readonly space: Schema.Struct<{
         readonly admission_mode: Schema.String;
+        readonly maximum_episode_duration_seconds: Schema.optional<Schema.Number>;
         readonly name: Schema.String;
         readonly slug: Schema.String;
     }>;
@@ -1558,6 +1561,7 @@ export declare const ArriveBySpacePublicInviteResponseSchema: Schema.Struct<{
     readonly retry_after: Schema.optional<Schema.Number>;
     readonly space: Schema.optional<Schema.NullOr<Schema.Struct<{
         readonly admission_mode: Schema.String;
+        readonly maximum_episode_duration_seconds: Schema.optional<Schema.Number>;
         readonly name: Schema.String;
         readonly slug: Schema.String;
     }>>>;
@@ -1790,6 +1794,7 @@ export declare const CreatePublicSpaceResponseSchema: Schema.Struct<{
         readonly retry_after: Schema.optional<Schema.Number>;
         readonly space: Schema.optional<Schema.NullOr<Schema.Struct<{
             readonly admission_mode: Schema.String;
+            readonly maximum_episode_duration_seconds: Schema.optional<Schema.Number>;
             readonly name: Schema.String;
             readonly slug: Schema.String;
         }>>>;
@@ -1800,6 +1805,7 @@ export declare const CreatePublicSpaceResponseSchema: Schema.Struct<{
     readonly lifecycle_until: Schema.brand<Schema.String, "DateTimeString">;
     readonly space: Schema.Struct<{
         readonly admission_mode: Schema.String;
+        readonly maximum_episode_duration_seconds: Schema.optional<Schema.Number>;
         readonly name: Schema.String;
         readonly slug: Schema.String;
     }>;
@@ -2343,6 +2349,7 @@ export declare const GetSpacePublicInviteArrivalResponseSchema: Schema.Struct<{
     readonly retry_after: Schema.optional<Schema.Number>;
     readonly space: Schema.optional<Schema.NullOr<Schema.Struct<{
         readonly admission_mode: Schema.String;
+        readonly maximum_episode_duration_seconds: Schema.optional<Schema.Number>;
         readonly name: Schema.String;
         readonly slug: Schema.String;
     }>>>;

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export * from "./sync";
 export * from "./whiteboard";
 export * from "./public-invites";
 export { formatSyncConnectDiagnostic } from "./sync/connect-diagnostics";
+export { getConnectionFailureDetail } from "./space-client/failure-detail";

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   createSpaceClient,
   decodeWhiteboardV1ServerFrame,
   encodeWhiteboardV1ClientFrame
-} from "./chunk-BCO3AZUB.js";
+} from "./chunk-XPW3OCPO.js";
 import {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -31,15 +31,16 @@ import {
 } from "./chunk-DWKTGBHR.js";
 import {
   createChalkPublicClient,
-  createChalkPublicInviteClient
-} from "./chunk-DHGAKJXP.js";
+  createChalkPublicInviteClient,
+  parseInviteCode
+} from "./chunk-6LNRDKJF.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError,
   parseParsedAccessGrant,
   requireAccessGrant
-} from "./chunk-HO4745TX.js";
+} from "./chunk-GA3JDPFI.js";
 import {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,
@@ -68,7 +69,7 @@ import {
   optimisticV1Control,
   reactionFromFrame,
   restoreV1Snapshot
-} from "./chunk-D2GXPX2P.js";
+} from "./chunk-AIJ5Z6HA.js";
 
 // src/space-client/reload-rejoin.ts
 import { Schema } from "effect";
@@ -114,6 +115,23 @@ function reloadRejoinAccess(access) {
   const parsed = parseParsedAccessGrant(access);
   return { tenantId: parsed.subject.tenantId, episodeId: parsed.subject.episodeId, participantId: parsed.subject.participantId, participantGeneration: parsed.subject.participantGeneration, mediaProof: parsed.media.token };
 }
+
+// src/space-client/failure-detail.ts
+var DEFAULT_FAILURE_DETAIL = "Something went wrong while joining. Try again.";
+var FAILURE_DETAILS = {
+  "access.invalid": "Access to this call was rejected. Refresh the page and try again.",
+  "access.unavailable": "Couldn\u2019t get access to the call. Try again.",
+  "connection.sync_start_failed": "Couldn\u2019t reach the call service. Try again.",
+  "connection.sync_hello_timeout": "The call service did not respond in time. Try again.",
+  "connection.sync_recovery_exhausted": "The call connection could not recover. Try again.",
+  "connection.media_start_failed": "Audio and video could not connect. Try again.",
+  "connection.media_recovery_exhausted": "Audio and video could not reconnect. Try again.",
+  "environment.unsupported": "This device cannot start the call. Use an up-to-date browser over HTTPS, or update the app."
+};
+function getConnectionFailureDetail({ code, sync }) {
+  if (sync?.stage === "upgrade") return sync.closeCode !== null ? "The connection closed before the call service could be reached. Try again." : "A connection to the call service could not be opened. Try again.";
+  return (code && FAILURE_DETAILS[code]) ?? DEFAULT_FAILURE_DETAIL;
+}
 export {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
@@ -165,8 +183,10 @@ export {
   encodeV1ClientFrame,
   encodeWhiteboardV1ClientFrame,
   formatSyncConnectDiagnostic,
+  getConnectionFailureDetail,
   optimisticV1Control,
   parseCloudflareSFUPublicationID,
+  parseInviteCode,
   publicationKey,
   reactionFromFrame,
   readReloadRejoin,

package/dist/public-invites/code.d.ts

@@ -0,0 +1 @@
+export declare function parseInviteCode(value: string): string | undefined;

package/dist/public-invites/index.d.ts

@@ -1,4 +1,5 @@
 export { createChalkPublicClient, createChalkPublicInviteClient } from "./client.js";
+export { parseInviteCode } from "./code.js";
 export type { ArriveBySpacePublicInviteInput, ChalkPublicClient, ChalkPublicClientOptions, ChalkPublicClientRuntime, ChalkPublicIdempotencyOptions, ChalkPublicInviteError, CreatePublicSpace, CreatePublicSpaceInput, ArriveBySpacePublicInvite, GetSpacePublicInviteArrival, LeaveSpacePublicInviteArrival, PublicArrivalOptions, PublicArrivalReference, PublicRefreshAccessInput, PublicLeaveOptions, PublicSpaceArrival, PublicSpaceArrivalAccess, PublicSpaceCreated, RefreshSpacePublicInviteAccess, } from "./types.js";
 export { ArrivalInvalidHandleError, ArrivalUnavailableError, SpacePublicInviteUnavailableError } from "../generated/schemas.js";
 export type { ApproveSpacePublicAdmissionRequestError, ArriveBySpacePublicInviteError, CreatePublicSpaceError, DenySpacePublicAdmissionRequestError, GetSpacePublicInviteArrivalError, LeaveSpacePublicInviteArrivalError, RefreshSpacePublicInviteAccessError } from "../generated/schemas.js";

package/dist/public-invites/index.js

@@ -1,16 +1,18 @@
 import {
   createChalkPublicClient,
-  createChalkPublicInviteClient
-} from "../chunk-DHGAKJXP.js";
+  createChalkPublicInviteClient,
+  parseInviteCode
+} from "../chunk-6LNRDKJF.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError
-} from "../chunk-HO4745TX.js";
+} from "../chunk-GA3JDPFI.js";
 export {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError,
   createChalkPublicClient,
-  createChalkPublicInviteClient
+  createChalkPublicInviteClient,
+  parseInviteCode
 };

package/dist/public-invites/words.d.ts

@@ -0,0 +1,2 @@
+export declare const INVITE_WORD_COUNT = 4;
+export declare const INVITE_WORDS: Set<string>;

package/dist/space-client/failure-detail.d.ts

@@ -0,0 +1,6 @@
+import type { ClientFailure, ErrorCode } from "./types";
+/** Safe, actionable failure copy shared by web and native call screens. */
+export declare function getConnectionFailureDetail({ code, sync }: {
+    readonly code?: ErrorCode;
+    readonly sync?: ClientFailure["sync"];
+}): string;

package/dist/space-client/types.d.ts

@@ -67,6 +67,7 @@ export type ConnectionSlice = {
     readonly lastError: ClientFailure | null;
     /** The Episode ended while this person was in it. */
     readonly episodeEnded: boolean;
+    readonly episodeEndReason?: import("../sync/v1-types").V1ControlState["endReason"];
     /** The server removed this person from the call; a person's own leave never sets this. */
     readonly removedByHost: boolean;
 };
@@ -260,6 +261,7 @@ export type ClientEventMap = {
     };
     readonly episodeEnded: {
         readonly episode: EpisodeSummary | null;
+        readonly reason?: ConnectionSlice["episodeEndReason"];
     };
     readonly screenShareStarted: {
         readonly participantId: string;

package/dist/sync/connect-diagnostics.d.ts

@@ -5,6 +5,12 @@ export type SyncConnectDiagnostic = {
     readonly closeCode: number | null;
     readonly closeReason: string | null;
     readonly durationMs: number;
+    /** One-based socket attempt since Sync start; absent in older SDK evidence. */
+    readonly attempt?: number;
+    /** Total sockets started when the join failed, including a pending replacement. */
+    readonly attempts?: number;
 };
 export declare function safeSyncCloseReason(reason: string | undefined): string | null;
+/** Keep published error codes stable while separating upgrade from hello failures. */
+export declare function syncConnectFailureCode(diagnostic: SyncConnectDiagnostic | undefined): "sync_start_failed" | "sync_hello_timeout";
 export declare function formatSyncConnectDiagnostic(diagnostic: SyncConnectDiagnostic): string;

package/dist/sync/index.js

@@ -22,7 +22,7 @@ import {
   encodeV1ClientFrame,
   optimisticV1Control,
   restoreV1Snapshot
-} from "../chunk-D2GXPX2P.js";
+} from "../chunk-AIJ5Z6HA.js";
 export {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,

package/dist/sync/v1-types.d.ts

@@ -37,6 +37,10 @@ export type V1ControlState = {
     readonly stateSchemaVersion: number;
     readonly stateDigest: string;
     readonly status: "active" | "ended";
+    readonly endReason?: Extract<SyncV1ServerFrame, {
+        readonly type: "event";
+        readonly name: "episode_ended";
+    }>["payload"]["reason"];
     readonly admissionPolicy: V1AdmissionPolicy;
     readonly deadlineAtMs: number;
     readonly deadlineGeneration: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q9labsai/chalk-client",
-  "version": "5.2.0",
+  "version": "5.2.2",
   "license": "MIT",
   "repository": {
     "type": "git",

package/dist/chunk-DHGAKJXP.js

@@ -1,142 +0,0 @@
-import {
-  createChalkEffectClient,
-  parseAccessGrant
-} from "./chunk-HO4745TX.js";
-
-// src/public-invites/client.ts
-import { Effect } from "effect";
-function createChalkPublicClient(options) {
-  const baseClientOptions = {
-    baseUrl: options.baseUrl,
-    credentials: options.credentials ?? (options.runtime === "react-native" ? void 0 : "include"),
-    fetch: options.fetch
-  };
-  const createClient = (guestCredential, requestInit) => createChalkEffectClient({
-    ...baseClientOptions,
-    ...requestInit ? { fetch: requestInitFetch(options.fetch, requestInit) } : {},
-    headers: requestHeaders(options, guestCredential)
-  });
-  const createPublicSpace = async (input, idempotency) => {
-    const client = await Effect.runPromise(createClient(void 0));
-    const response = await Effect.runPromise(
-      client.spaces.createPublicSpace({
-        headers: { "Idempotency-Key": idempotencyKey(idempotency) },
-        payload: { display_name: required(input.displayName, "displayName") }
-      })
-    );
-    return publicSpaceCreated(response);
-  };
-  const arriveBySpacePublicInvite = async (input, arrival) => {
-    const client = await Effect.runPromise(createClient(arrival?.guestCredential ?? options.guestCredential));
-    const response = await Effect.runPromise(
-      client.spaces.arriveBySpacePublicInvite({
-        headers: {
-          "Idempotency-Key": idempotencyKey(arrival),
-          ...arrival?.arrivalHandle === void 0 ? {} : { "X-Chalk-Arrival-Handle": required(arrival.arrivalHandle, "arrivalHandle") }
-        },
-        payload: {
-          display_name: required(input.displayName, "displayName"),
-          space_invite_token: required(input.spaceInviteToken, "spaceInviteToken")
-        }
-      })
-    );
-    return publicSpaceArrival(response);
-  };
-  const getSpacePublicInviteArrival = async (reference) => {
-    const normalized = arrivalReference(reference);
-    const client = await Effect.runPromise(createClient(normalized.guestCredential ?? options.guestCredential));
-    const response = await Effect.runPromise(
-      client.spaces.getSpacePublicInviteArrival({
-        headers: { "X-Chalk-Arrival-Handle": normalized.arrivalHandle }
-      })
-    );
-    return publicSpaceArrival(response);
-  };
-  const refreshSpacePublicInviteAccess = async (input, arrival) => {
-    const normalized = refreshInput(input, arrival);
-    const client = await Effect.runPromise(createClient(normalized.guestCredential ?? options.guestCredential, normalized.signal ? { signal: normalized.signal } : void 0));
-    const response = await Effect.runPromise(
-      client.spaces.refreshSpacePublicInviteAccess({
-        headers: { "X-Chalk-Arrival-Handle": normalized.arrivalHandle },
-        payload: { media_proof: required(normalized.mediaProof, "mediaProof"), replace_media_connection: normalized.replaceMediaConnection ?? false }
-      })
-    );
-    return parseAccessGrant(response);
-  };
-  const leaveSpacePublicInviteArrival = async (reference, leaveOptions) => {
-    const normalized = arrivalReference(reference);
-    const client = await Effect.runPromise(createClient(normalized.guestCredential ?? options.guestCredential, requestInitForLeave(leaveOptions)));
-    await Effect.runPromise(
-      client.spaces.leaveSpacePublicInviteArrival({
-        headers: { "X-Chalk-Arrival-Handle": normalized.arrivalHandle }
-      })
-    );
-  };
-  return {
-    prepareSpaceEntrance: async (spaceInviteToken) => {
-      const client = await Effect.runPromise(createClient(void 0));
-      await Effect.runPromise(client.spaces.preparePublicSpaceEntrance({ payload: { space_invite_token: required(spaceInviteToken, "spaceInviteToken") } }));
-    },
-    arrive: arriveBySpacePublicInvite,
-    arriveBySpacePublicInvite,
-    create: createPublicSpace,
-    createPublicSpace,
-    getSpacePublicInviteArrival,
-    leave: leaveSpacePublicInviteArrival,
-    leaveSpacePublicInviteArrival,
-    refresh: refreshSpacePublicInviteAccess,
-    refreshSpacePublicInviteAccess,
-    status: getSpacePublicInviteArrival
-  };
-}
-var createChalkPublicInviteClient = createChalkPublicClient;
-function requestHeaders(options, guestCredential) {
-  const headers = { ...options.headers };
-  if (options.runtime === "react-native") {
-    headers["X-Chalk-Client"] = "react-native";
-    const credential = guestCredential ?? options.guestCredential;
-    if (credential !== void 0) headers.Authorization = `ChalkGuest ${required(credential, "guestCredential")}`;
-  }
-  return headers;
-}
-function idempotencyKey(options) {
-  return options?.idempotencyKey === void 0 ? globalThis.crypto.randomUUID() : required(options.idempotencyKey, "idempotencyKey");
-}
-function arrivalReference(reference) {
-  if (typeof reference === "string") return { arrivalHandle: required(reference, "arrivalHandle") };
-  return { arrivalHandle: required(reference.arrivalHandle, "arrivalHandle"), guestCredential: reference.guestCredential };
-}
-function refreshInput(input, arrival) {
-  const values = typeof input === "string" ? { arrivalHandle: arrival?.arrivalHandle, guestCredential: arrival?.guestCredential, mediaProof: input } : { arrivalHandle: input.arrivalHandle ?? arrival?.arrivalHandle, guestCredential: input.guestCredential ?? arrival?.guestCredential, mediaProof: input.mediaProof, replaceMediaConnection: input.replaceMediaConnection, signal: input.signal };
-  return {
-    ...values,
-    arrivalHandle: required(values.arrivalHandle ?? "", "arrivalHandle")
-  };
-}
-function requestInitForLeave(options) {
-  if (options?.keepalive === void 0) return void 0;
-  return { keepalive: options.keepalive };
-}
-function requestInitFetch(fetchImplementation, requestInit) {
-  const implementation = fetchImplementation ?? globalThis.fetch;
-  return (input, init) => implementation(input, { ...init, ...requestInit });
-}
-function publicSpaceCreated(value) {
-  const { arrival, ...created } = value;
-  return { ...created, arrival: publicSpaceArrival(arrival) };
-}
-function publicSpaceArrival(value) {
-  const { access, ...arrival } = value;
-  if (access === void 0) return arrival;
-  return { ...arrival, access: access === null ? null : parseAccessGrant(access) };
-}
-function required(value, name) {
-  const normalized = value.trim();
-  if (!normalized) throw new TypeError(`${name} is required`);
-  return normalized;
-}
-
-export {
-  createChalkPublicClient,
-  createChalkPublicInviteClient
-};