@statelyai/sdk 0.15.0 → 0.16.1

package/dist/protocol.d.mts

@@ -1,7 +1,22 @@
 import { i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
 
 //#region src/protocol.d.ts
-type EmbedMode = "editing" | "viewing" | "simulating" | "inspecting";
+/** Query parameter carrying the unguessable inspection room capability. */
+declare const INSPECTION_ROOM_QUERY_PARAM = "r";
+interface InspectionRoomUrls {
+  roomId: string;
+  relayUrl: string;
+  inspectorUrl: string;
+}
+/** Resolve the transport and browser URLs required by the inspection protocol. */
+declare function createInspectionRoomUrls(options: {
+  url: string;
+  roomId: string;
+  inspectorBaseUrl?: string;
+}): InspectionRoomUrls;
+/** Read a room capability from a conforming relay or inspector URL. */
+declare function getInspectionRoomId(value: string | URL): string | null;
+type EmbedMode = 'editing' | 'viewing' | 'simulating' | 'inspecting';
 interface CommentsConfig {
   roomId: string;
   userId?: string | null;
@@ -17,7 +32,7 @@ interface ProjectEmbedMachine {
 interface ValidationIssue {
   nodeIds: string[];
   edgeIds: string[];
-  level: "info" | "warning" | "error";
+  level: 'info' | 'warning' | 'error';
   message: string;
 }
 interface EditorCapabilities {
@@ -31,11 +46,11 @@ interface EditorCapabilities {
   panels?: string[];
   commands?: string[];
 }
-type ReadOnlyReason = "free-plan" | "access-unverified";
-type CapabilityDeniedCapability = "edit" | "export" | "ai" | "simulate" | "inspect" | "navigateHierarchy" | "panel" | "mode";
+type ReadOnlyReason = 'free-plan' | 'access-unverified';
+type CapabilityDeniedCapability = 'edit' | 'export' | 'ai' | 'simulate' | 'inspect' | 'navigateHierarchy' | 'panel' | 'mode';
 interface CapabilityDeniedEvent {
   capability: CapabilityDeniedCapability;
-  action: "openPanel" | "openDialog" | "editSource" | "navigateHierarchy" | "setMode" | "simulationStart" | "inspectStart" | "retrieve";
+  action: 'openPanel' | 'openDialog' | 'editSource' | 'navigateHierarchy' | 'setMode' | 'simulationStart' | 'inspectStart' | 'retrieve';
   requested?: string;
   message: string;
   dedupeKey: string;
@@ -52,12 +67,12 @@ interface SourceLocation {
 }
 interface StateSourceLocation extends SourceLocation {
   path: string[];
-  kind: "inline" | "objectReference" | "createStateConfig";
+  kind: 'inline' | 'objectReference' | 'createStateConfig';
   symbol?: string;
   keyRange?: SourceRange;
   referenceRange?: SourceRange;
   keySource?: {
-    kind: "const" | "enumMember" | "computedLiteral";
+    kind: 'const' | 'enumMember' | 'computedLiteral';
     symbol?: string;
     valueRange?: SourceRange;
     machineLocal?: boolean;
@@ -87,7 +102,7 @@ interface ExportFormatMap {
     options: object;
     result: string;
   };
-  "xstate-json": {
+  'xstate-json': {
     options: {
       version?: 4 | 5;
     };
@@ -119,11 +134,11 @@ interface ExportFormatMap {
     options: object;
     result: string;
   };
-  "asl-json": {
+  'asl-json': {
     options: object;
     result: string;
   };
-  "asl-yaml": {
+  'asl-yaml': {
     options: object;
     result: string;
   };
@@ -133,7 +148,7 @@ interface ExportFormatMap {
   };
 }
 type ExportFormat = keyof ExportFormatMap;
-type ExportCallOptions<F extends ExportFormat> = ExportFormatMap[F]["options"] & {
+type ExportCallOptions<F extends ExportFormat> = ExportFormatMap[F]['options'] & {
   timeout?: number;
 };
 interface EmbedEventMap {
@@ -179,7 +194,7 @@ interface MachineInitOptions {
   machine: unknown;
   format?: string;
   mode?: EmbedMode;
-  theme?: "light" | "dark";
+  theme?: 'light' | 'dark';
   readOnly?: boolean;
   readOnlyReason?: ReadOnlyReason;
   depth?: number;
@@ -206,14 +221,14 @@ interface MachineInitOptions {
    */
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: "structural" | "all";
+    mode?: 'structural' | 'all';
   };
 }
 interface ProjectInitOptions {
   machines: ProjectEmbedMachine[];
   currentMachineId?: string;
   mode?: EmbedMode;
-  theme?: "light" | "dark";
+  theme?: 'light' | 'dark';
   readOnly?: boolean;
   depth?: number;
   capabilities?: EditorCapabilities;
@@ -226,16 +241,16 @@ interface ProjectInitOptions {
   settings?: Record<string, unknown>;
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: "structural" | "all";
+    mode?: 'structural' | 'all';
   };
 }
 type InitOptions = MachineInitOptions | ProjectInitOptions;
 interface InitMessage {
-  type: "@statelyai.init";
+  type: '@statelyai.init';
   machine: unknown;
   format?: string;
   mode?: EmbedMode;
-  theme?: "light" | "dark";
+  theme?: 'light' | 'dark';
   readOnly?: boolean;
   readOnlyReason?: ReadOnlyReason;
   depth?: number;
@@ -249,21 +264,19 @@ interface InitMessage {
   /** Mirror of `InitOptions.unsavedIndicator`. */
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: "structural" | "all";
+    mode?: 'structural' | 'all';
   };
-  /** Optional session id override (multiplexed clients only). */
-  sessionId?: string;
 }
 interface SetApiKeyMessage {
-  type: "@statelyai.setApiKey";
+  type: '@statelyai.setApiKey';
   apiKey: string;
 }
 interface ProjectInitMessage {
-  type: "@statelyai.project.init";
+  type: '@statelyai.project.init';
   machines: ProjectEmbedMachine[];
   currentMachineId?: string;
   mode?: EmbedMode;
-  theme?: "light" | "dark";
+  theme?: 'light' | 'dark';
   readOnly?: boolean;
   depth?: number;
   capabilities?: EditorCapabilities;
@@ -274,67 +287,63 @@ interface ProjectInitMessage {
   settings?: Record<string, unknown>;
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: "structural" | "all";
+    mode?: 'structural' | 'all';
   };
   sessionId?: string;
 }
 interface ProjectUpdateMessage {
-  type: "@statelyai.project.update";
+  type: '@statelyai.project.update';
   machines: ProjectEmbedMachine[];
   currentMachineId?: string;
   commentsByMachineId?: Record<string, CommentsConfig>;
 }
 interface ProjectSelectMachineMessage {
-  type: "@statelyai.project.selectMachine";
+  type: '@statelyai.project.selectMachine';
   machineId: string;
 }
 interface UpdateMessage {
-  type: "@statelyai.update";
+  type: '@statelyai.update';
   machine: unknown;
   format?: string;
   sourceLocations?: MachineSourceLocations;
 }
 interface SetModeMessage {
-  type: "@statelyai.setMode";
+  type: '@statelyai.setMode';
   mode: EmbedMode;
 }
 interface SetThemeMessage {
-  type: "@statelyai.setTheme";
-  theme: "light" | "dark";
+  type: '@statelyai.setTheme';
+  theme: 'light' | 'dark';
 }
 interface SetSettingsMessage {
-  type: "@statelyai.setSettings";
+  type: '@statelyai.setSettings';
   settings: Record<string, unknown>;
 }
 interface RetrieveMessage {
-  type: "@statelyai.retrieve";
+  type: '@statelyai.retrieve';
   requestId: string;
   format: ExportFormat;
   options?: Record<string, unknown>;
 }
 interface ToastMessage {
-  type: "@statelyai.toast";
+  type: '@statelyai.toast';
   message: string;
-  toastType?: "success" | "error" | "info" | "warning";
+  toastType?: 'success' | 'error' | 'info' | 'warning';
 }
 interface InspectSnapshotMessage {
-  type: "@statelyai.inspectSnapshot";
+  type: '@statelyai.inspectSnapshot';
   snapshot: unknown;
   event: unknown | null;
-  /**
-   * Optional session id override. Used by multiplexed clients that share one
-   * WebSocket across many actor sessions. When omitted, the relay routes
-   * to the connection's primary sessionId.
-   */
+  /** Global actor session id, when this snapshot belongs to an actor. */
   sessionId?: string;
 }
 interface ActorSystemEntry {
-  /** The xstate `actor.sessionId` — unique within the system. */
+  /** Globally unique xstate `actor.sessionId`. */
+  sessionId: string;
+  /** System-local xstate `actor.id`. */
   actorId: string;
   /** Parent actor's sessionId, or `null` for the root. */
-  parentActorId: string | null;
-  /** Human-facing id (`actor.id`). */
-  id: string;
+  parentSessionId: string | null;
   /** Machine configuration used to render the state chart. */
   machine: unknown;
   /** Optional current snapshot (`{value, status, ...}`). */
@@ -356,21 +365,21 @@ interface InspectionTakenTransition {
 }
 /** JSON-safe record of an event sent or scheduled during a transition. */
 interface InspectionSentEvent {
-  targetActorId?: string;
+  targetSessionId?: string;
   targetId: string;
   event: unknown;
   delay?: number;
   id?: string;
 }
 interface SystemInitMessage {
-  type: "@statelyai.system.init";
-  protocolVersion?: number;
+  type: '@statelyai.system.init';
+  protocolVersion: number;
   /** All known actors at the moment the system is first streamed. */
   actors: ActorSystemEntry[];
-  /** Actor id the viz should focus first. Defaults to the root. */
-  selectedActorId?: string;
+  /** Actor session id the viz should focus first. Defaults to the root. */
+  selectedSessionId?: string;
   mode?: EmbedMode;
-  theme?: "light" | "dark";
+  theme?: 'light' | 'dark';
   readOnly?: boolean;
   depth?: number;
   capabilities?: EditorCapabilities;
@@ -381,36 +390,36 @@ interface SystemInitMessage {
 }
 /** Change the focused actor without re-initializing the system. */
 interface SystemSelectActorMessage {
-  type: "@statelyai.system.selectActor";
-  actorId: string;
+  type: '@statelyai.system.selectActor';
+  sessionId: string;
 }
 /** A new actor joined the system after init. */
 interface SystemActorRegisteredMessage {
-  type: "@statelyai.system.actorRegistered";
+  type: '@statelyai.system.actorRegistered';
+  sessionId: string;
   actorId: string;
-  parentActorId: string | null;
-  id: string;
+  parentSessionId: string | null;
   machine: unknown;
   snapshot?: unknown;
 }
 /** An event was observed targeting an actor, before processing completed. */
 interface SystemActorEventMessage {
-  type: "@statelyai.system.actorEvent";
-  actorId: string;
+  type: '@statelyai.system.actorEvent';
+  sessionId: string;
   event: unknown;
-  /** The actorId of the actor that sent the event, if known. */
-  sourceActorId?: string | null;
+  /** Global session id of the actor that sent the event, if known. */
+  sourceSessionId?: string | null;
 }
 /** An actor's snapshot updated. */
 interface SystemActorSnapshotMessage {
-  type: "@statelyai.system.actorSnapshot";
-  actorId: string;
+  type: '@statelyai.system.actorSnapshot';
+  sessionId: string;
   /** Snapshot before the event was processed. */
   previousSnapshot?: unknown | null;
   snapshot: unknown;
   event?: unknown | null;
-  /** The actorId of the actor that sent the triggering event, if known. */
-  sourceActorId?: string | null;
+  /** Global session id of the actor that sent the triggering event, if known. */
+  sourceSessionId?: string | null;
   /** Actions executed while processing the event. */
   actions?: InspectionAction[];
   /** State transitions taken across every microstep. */
@@ -420,21 +429,21 @@ interface SystemActorSnapshotMessage {
 }
 /** An actor reached a final state / was stopped. */
 interface SystemActorStoppedMessage {
-  type: "@statelyai.system.actorStopped";
-  actorId: string;
+  type: '@statelyai.system.actorStopped';
+  sessionId: string;
 }
 interface ReadyMessage {
-  type: "@statelyai.ready";
+  type: '@statelyai.ready';
   version: string;
 }
 interface LoadedMessage {
-  type: "@statelyai.loaded";
+  type: '@statelyai.loaded';
   graph: StatelyGraph;
   machineId?: string;
   sourceLocations?: MachineSourceLocations;
 }
 interface ChangeMessage {
-  type: "@statelyai.change";
+  type: '@statelyai.change';
   graph: StatelyGraph;
   machineConfig: unknown;
   machineId?: string;
@@ -442,7 +451,7 @@ interface ChangeMessage {
   sourceLocations?: MachineSourceLocations;
 }
 interface SaveMessage {
-  type: "@statelyai.save";
+  type: '@statelyai.save';
   graph: StatelyGraph;
   machineConfig: unknown;
   machineId?: string;
@@ -451,22 +460,22 @@ interface SaveMessage {
   sourceLocations?: MachineSourceLocations;
 }
 interface ProjectMachineSelectedMessage {
-  type: "@statelyai.project.machineSelected";
+  type: '@statelyai.project.machineSelected';
   machineId: string;
 }
 interface RetrievedMessage {
-  type: "@statelyai.retrieved";
+  type: '@statelyai.retrieved';
   requestId: string;
   data: unknown;
 }
 interface ErrorMessage {
-  type: "@statelyai.error";
+  type: '@statelyai.error';
   code: string;
   message: string;
   requestId?: string;
 }
 interface CapabilityDeniedMessage extends CapabilityDeniedEvent {
-  type: "@statelyai.capabilityDenied";
+  type: '@statelyai.capabilityDenied';
 }
 /** File metadata sent from viz to SDK when a file needs uploading. */
 interface UploadFileInfo {
@@ -490,21 +499,21 @@ interface UploadResult {
 }
 /** Viz requests the parent to upload a file. */
 interface UploadRequestMessage {
-  type: "@statelyai.uploadRequest";
+  type: '@statelyai.uploadRequest';
   requestId: string;
   file: UploadFileInfo;
   stateNodeId: string;
 }
 /** Parent tells the viz the upload capabilities on init. */
 interface UploadCapabilitiesMessage {
-  type: "@statelyai.uploadCapabilities";
+  type: '@statelyai.uploadCapabilities';
   enabled: boolean;
   accept?: string[];
   maxFileSize?: number;
 }
 /** Parent sends the upload result back to the viz. */
 interface UploadResponseMessage {
-  type: "@statelyai.uploadResponse";
+  type: '@statelyai.uploadResponse';
   requestId: string;
   result: UploadResult;
 }
@@ -512,51 +521,32 @@ interface UploadResponseMessage {
 type ClientMessage = InitMessage | SetApiKeyMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemSelectActorMessage | SystemActorRegisteredMessage | SystemActorEventMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ErrorMessage;
 /** All messages the viz can send back to a client. */
 type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | UploadRequestMessage;
+interface InspectionClientMetadata {
+  name?: string;
+  machineId?: string;
+  sdkVersion?: string;
+  runtime?: 'browser' | 'node' | 'unknown';
+}
 interface RegisterMessage {
-  type: "@statelyai.register";
-  protocolVersion?: number;
-  role: "client" | "viz";
-  sessionId: string;
-  metadata?: {
-    name?: string;
-    machineId?: string;
-  };
+  type: '@statelyai.register';
+  protocolVersion: number;
+  role: 'producer' | 'viewer';
+  producerId?: string;
+  metadata?: InspectionClientMetadata;
 }
 interface RegisteredMessage {
-  type: "@statelyai.registered";
-  protocolVersion?: number;
-  sessionId: string;
-}
-/**
- * Client → relay: add another sessionId to an existing connection. Used by
- * multiplexed clients that want one WebSocket to serve many actor sessions.
- * Order of operations for a multiplexed client:
- *
- *   1. Connect WebSocket
- *   2. Send `@statelyai.register { sessionId: primary }`
- *   3. Send `@statelyai.addSession { sessionId }` for each additional session
- *   4. Send regular messages; each can include an explicit `sessionId` at
- *      the root to target a specific session (falls back to primary).
- */
-interface AddSessionMessage {
-  type: "@statelyai.addSession";
-  sessionId: string;
-  metadata?: {
-    name?: string;
-    machineId?: string;
-  };
-}
-/** Relay → client: acknowledgement that a session was added. */
-interface SessionAddedMessage {
-  type: "@statelyai.sessionAdded";
-  sessionId: string;
-}
-/** All session-management messages for the WS relay. */
-type SessionMessage = RegisterMessage | RegisteredMessage | AddSessionMessage | SessionAddedMessage;
-/** Any valid protocol message. */
-type ProtocolMessage = ClientMessage | VizMessage | SessionMessage;
+  type: '@statelyai.registered';
+  protocolVersion: number;
+  producerId?: string;
+}
+/** All registration messages for the WebSocket relay. */
+type SessionMessage = RegisterMessage | RegisteredMessage;
+/** Any valid protocol message. Relays add/consume `producerId` as an envelope. */
+type ProtocolMessage = (ClientMessage | VizMessage | SessionMessage) & {
+  producerId?: string;
+};
 declare const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
-declare const INSPECTION_PROTOCOL_VERSION = 1;
+declare const INSPECTION_PROTOCOL_VERSION = 2;
 //#endregion
-export { ActorSystemEntry, AddSessionMessage, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SessionAddedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage };
+export { ActorSystemEntry, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage, createInspectionRoomUrls, getInspectionRoomId };

package/dist/protocol.mjs

@@ -1,7 +1,38 @@
 //#region src/protocol.ts
+/** Query parameter carrying the unguessable inspection room capability. */
+const INSPECTION_ROOM_QUERY_PARAM = "r";
+/** Resolve the transport and browser URLs required by the inspection protocol. */
+function createInspectionRoomUrls(options) {
+	const relayUrl = new URL(options.url);
+	if (relayUrl.protocol !== "ws:" && relayUrl.protocol !== "wss:") throw new Error("Inspection relay URLs must use ws: or wss:.");
+	const existingRoomId = relayUrl.searchParams.get(INSPECTION_ROOM_QUERY_PARAM);
+	if (existingRoomId && existingRoomId !== options.roomId) throw new Error("Inspection relay URL room does not match roomId.");
+	relayUrl.searchParams.set(INSPECTION_ROOM_QUERY_PARAM, options.roomId);
+	if (options.inspectorBaseUrl) {
+		const inspectorUrl = new URL(options.inspectorBaseUrl);
+		inspectorUrl.searchParams.set("ws", relayUrl.toString());
+		inspectorUrl.searchParams.set(INSPECTION_ROOM_QUERY_PARAM, options.roomId);
+		return {
+			roomId: options.roomId,
+			relayUrl: relayUrl.toString(),
+			inspectorUrl: inspectorUrl.toString()
+		};
+	}
+	const inspectorUrl = new URL(relayUrl);
+	inspectorUrl.protocol = relayUrl.protocol === "wss:" ? "https:" : "http:";
+	return {
+		roomId: options.roomId,
+		relayUrl: relayUrl.toString(),
+		inspectorUrl: inspectorUrl.toString()
+	};
+}
+/** Read a room capability from a conforming relay or inspector URL. */
+function getInspectionRoomId(value) {
+	return new URL(value).searchParams.get(INSPECTION_ROOM_QUERY_PARAM)?.trim() || null;
+}
 const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
-const INSPECTION_PROTOCOL_VERSION = 1;
+const INSPECTION_PROTOCOL_VERSION = 2;
 
 //#endregion
-export { INSPECTION_PROTOCOL_VERSION, PREFIX };
+export { INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, PREFIX, createInspectionRoomUrls, getInspectionRoomId };

package/dist/relay.d.mts

@@ -1,15 +1,14 @@
 import { ProtocolMessage } from "./protocol.mjs";
 
 //#region src/relay.d.ts
-type InspectionRelayRole = 'client' | 'viz';
+type InspectionRelayRole = 'producer' | 'viewer';
 interface InspectionRelayPeer {
   id: string;
   role: InspectionRelayRole;
-  primarySessionId: string;
-  sessionIds: string[];
+  producerId?: string;
 }
 interface InspectionRelaySnapshot {
-  sessions: Record<string, ProtocolMessage[]>;
+  producers: Record<string, ProtocolMessage[]>;
 }
 type InspectionRelayEffect = {
   type: 'send';
@@ -23,20 +22,20 @@ interface InspectionRelay {
   clear(): void;
   peer(peerId: string): InspectionRelayPeer | undefined;
   receive(peerId: string, raw: unknown): InspectionRelayEffect[];
-  snapshot(): InspectionRelaySnapshot;
+  snapshot(producerId?: string): InspectionRelaySnapshot;
 }
 interface CreateInspectionRelayOptions {
   snapshot?: InspectionRelaySnapshot;
   maxReplayMessages?: number;
-  /** Maximum sessions retained for late-join replay. Default 100. */
-  maxReplaySessions?: number;
+  /** Maximum producers retained for late-join replay. Default 100. */
+  maxReplayProducers?: number;
 }
 /**
- * Runtime-neutral WebSocket inspection room.
+ * Runtime-neutral implementation of one inspection room.
  *
- * It owns protocol registration, routing, multiplexed session membership, and
- * bounded late-join replay. Node and Durable Object adapters only translate
- * `send` effects to their native WebSocket APIs and persist `snapshot()`.
+ * The hosting adapter selects the room from the WebSocket URL. This module
+ * owns protocol registration, multi-producer/viewer routing, and bounded
+ * per-producer replay.
  */
 declare function createInspectionRelay(options?: CreateInspectionRelayOptions): InspectionRelay;
 //#endregion