@statelyai/sdk 0.32.0 → 0.34.0

package/dist/{protocol-C-tx0WI6.d.mts → protocol-AeHm956D.d.mts}

@@ -1,6 +1,6 @@
-import { i as ProfileManifest } from "./index-DlOZxzrW.mjs";
-import { i as StatelyGraph } from "./graph-CR_g-mOq.mjs";
-import { c as EditorSyncSourceLocation, f as MachineSourceLocations$1, l as EditorSyncSourceRange, t as EditorCapabilities$1, u as EditorSyncStateSourceLocation } from "./editor-sync-types-CPpzTSnT.mjs";
+import { i as ProfileManifest } from "./index-DZivqh0u.mjs";
+import { i as StatelyGraph } from "./graph-Ciocekxl.mjs";
+import { c as EditorSyncSourceLocation, f as MachineSourceLocations$1, l as EditorSyncSourceRange, t as EditorCapabilities$1, u as EditorSyncStateSourceLocation } from "./editor-sync-types-D7YYz6fb.mjs";
 
 //#region src/embedPanel.d.ts
 type EmbedPanelPosition = 'left' | 'right' | 'bottom';
@@ -14,6 +14,11 @@ interface EmbedPanelConfig {
   initiallyOpen?: boolean;
 }
 //#endregion
+//#region src/inspectorSettings.d.ts
+/** Also filters untrusted wire data to the inspection presentation subset. */
+declare function mergeInspectorSettings(previous: InspectorSettings, value: unknown): InspectorSettings;
+declare function resolveInspectorSettings(options: Pick<ViewerOptions<unknown>, 'settings' | 'theme' | 'viewMode'>): InspectorSettings;
+//#endregion
 //#region src/protocol.d.ts
 /** Query parameter carrying the unguessable inspection room capability. */
 declare const INSPECTION_ROOM_QUERY_PARAM = "r";
@@ -345,23 +350,46 @@ declare function isEmbedExampleMachine(value: unknown): value is Record<string,
 declare function isEmbedExample(value: unknown): value is EmbedExample;
 /** Reject malformed host-provided examples before creating an init message. */
 declare function assertEmbedExamples(examples: readonly EmbedExample[] | undefined): void;
-interface MachineInitOptions {
-  machine: unknown;
-  /** Ephemeral, read-only reference documents owned by the embed host. */
+/** Display configuration shared by embeds and inspectors. */
+interface ViewerOptions<Settings = Record<string, unknown>> {
+  /** Ephemeral, read-only reference documents owned by the host. */
   documents?: EmbedDocument[];
-  format?: string;
-  extensions?: EmbedExtensionsManifest;
-  mode?: EmbedMode;
+  panels?: EmbedPanelConfig[];
   theme?: 'light' | 'dark';
+  viewMode?: 'graph' | 'list';
+  settings?: Settings;
   readOnly?: boolean;
-  readOnlyReason?: ReadOnlyReason;
   depth?: number;
   capabilities?: EditorCapabilities;
+}
+/** Inspection only accepts presentation preferences, never authoring settings. */
+interface InspectorSettings {
+  appearance?: {
+    colorMode?: 'light' | 'dark' | 'system';
+  };
+  canvas?: {
+    viewMode?: 'graph' | 'list';
+    showGrid?: boolean;
+    dimUnselected?: boolean;
+    edgeHighlightWidth?: number;
+  };
+}
+/** A viewer mounted and its selected surface is usable (including an empty system). */
+interface InspectorLoadedEvent {
+  producerId?: string;
+}
+interface SystemLoadedMessage extends InspectorLoadedEvent {
+  type: '@statelyai.system.loaded';
+}
+interface MachineInitOptions extends ViewerOptions {
+  machine: unknown;
+  format?: string;
+  extensions?: EmbedExtensionsManifest;
+  mode?: EmbedMode;
+  readOnlyReason?: ReadOnlyReason;
   examples?: readonly EmbedExample[];
-  panels?: EmbedPanelConfig[];
   comments?: CommentsConfig;
   sourceLocations?: MachineSourceLocations;
-  settings?: Record<string, unknown>;
   /**
    * Show a persistent "Save to apply" pill in the embed whenever Viz has
    * local edits that have not yet been saved. Intended for contexts like
@@ -381,27 +409,19 @@ interface MachineInitOptions {
   /** Omit to disable automatic version requests. */
   versionAutoSave?: MachineVersionAutoSaveOptions;
 }
-interface ProjectInitOptions {
+interface ProjectInitOptions extends ViewerOptions {
   machines: ProjectEmbedMachine[];
   /** Optional project-level chrome owned by the embed host. */
   chrome?: {
     /** Reserve a header row above the editor canvas. */header?: boolean;
   };
-  /** Ephemeral, read-only reference documents shared across the project. */
-  documents?: EmbedDocument[];
   currentMachineId?: string;
   mode?: EmbedMode;
-  theme?: 'light' | 'dark';
-  readOnly?: boolean;
   readOnlyReason?: ReadOnlyReason;
-  depth?: number;
-  capabilities?: EditorCapabilities;
   examples?: readonly EmbedExample[];
-  panels?: EmbedPanelConfig[];
   commentsByMachineId?: Record<string, CommentsConfig>;
   projectWorkspace?: ProjectWorkspaceConfig;
   projectWorkspaceOpen?: boolean;
-  settings?: Record<string, unknown>;
   unsavedIndicator?: {
     enabled?: boolean;
     mode?: 'structural' | 'all';
@@ -410,35 +430,14 @@ interface ProjectInitOptions {
   versionAutoSave?: MachineVersionAutoSaveOptions;
 }
 type InitOptions = MachineInitOptions | ProjectInitOptions;
-interface InitMessage {
+interface InitMessage extends MachineInitOptions {
   type: '@statelyai.init';
-  machine: unknown;
-  documents?: EmbedDocument[];
-  format?: string;
-  extensions?: EmbedExtensionsManifest;
-  mode?: EmbedMode;
-  theme?: 'light' | 'dark';
-  readOnly?: boolean;
-  readOnlyReason?: ReadOnlyReason;
-  depth?: number;
-  capabilities?: EditorCapabilities;
-  examples?: readonly EmbedExample[];
-  panels?: EmbedPanelConfig[];
   /** @deprecated Use `panels`. */
   leftPanels?: string[];
   /** @deprecated Use `panels`. */
   rightPanels?: string[];
   /** @deprecated Use `panels[].initiallyOpen`. */
   activePanels?: string[];
-  comments?: CommentsConfig;
-  sourceLocations?: MachineSourceLocations;
-  settings?: Record<string, unknown>;
-  /** Mirror of `InitOptions.unsavedIndicator`. */
-  unsavedIndicator?: {
-    enabled?: boolean;
-    mode?: 'structural' | 'all';
-  };
-  versionAutoSave?: MachineVersionAutoSaveOptions;
 }
 interface SetApiKeyMessage {
   type: '@statelyai.setApiKey';
@@ -468,37 +467,14 @@ interface ClipboardWriteMessage {
   requestId: string;
   text: string;
 }
-interface ProjectInitMessage {
+interface ProjectInitMessage extends ProjectInitOptions {
   type: '@statelyai.project.init';
-  machines: ProjectEmbedMachine[];
-  chrome?: {
-    header?: boolean;
-  };
-  documents?: EmbedDocument[];
-  currentMachineId?: string;
-  mode?: EmbedMode;
-  theme?: 'light' | 'dark';
-  readOnly?: boolean;
-  readOnlyReason?: ReadOnlyReason;
-  depth?: number;
-  capabilities?: EditorCapabilities;
-  examples?: readonly EmbedExample[];
-  panels?: EmbedPanelConfig[];
   /** @deprecated Use `panels`. */
   leftPanels?: string[];
   /** @deprecated Use `panels`. */
   rightPanels?: string[];
   /** @deprecated Use `panels[].initiallyOpen`. */
   activePanels?: string[];
-  commentsByMachineId?: Record<string, CommentsConfig>;
-  projectWorkspace?: ProjectWorkspaceConfig;
-  projectWorkspaceOpen?: boolean;
-  settings?: Record<string, unknown>;
-  unsavedIndicator?: {
-    enabled?: boolean;
-    mode?: 'structural' | 'all';
-  };
-  versionAutoSave?: MachineVersionAutoSaveOptions;
   sessionId?: string;
 }
 interface ProjectUpdateMessage {
@@ -575,6 +551,8 @@ interface ActorSystemEntry {
   /** Whether this actor stopped before this checkpoint was sent. */
   stopped?: boolean;
 }
+/** Source text or machine config used to render a declared machine. */
+type MachinePayload = unknown;
 /** JSON-safe record of an action executed during an inspected transition. */
 interface InspectionAction {
   type: string;
@@ -595,20 +573,16 @@ interface InspectionSentEvent {
   delay?: number;
   id?: string;
 }
-interface SystemInitMessage {
+interface SystemInitMessage extends ViewerOptions<InspectorSettings> {
   type: '@statelyai.system.init';
   protocolVersion: number;
   /** All known actors at the moment the system is first streamed. */
   actors: ActorSystemEntry[];
+  /** Machine definitions available before their first actor exists. */
+  machines?: Record<string, MachinePayload>;
   /** Actor session id the viz should focus first. Defaults to the root. */
   selectedSessionId?: string;
-  documents?: EmbedDocument[];
   mode?: EmbedMode;
-  theme?: 'light' | 'dark';
-  readOnly?: boolean;
-  depth?: number;
-  capabilities?: EditorCapabilities;
-  panels?: EmbedPanelConfig[];
   /** @deprecated Use `panels`. */
   leftPanels?: string[];
   /** @deprecated Use `panels`. */
@@ -829,7 +803,7 @@ interface ExtensionResultMessage {
 /** All messages a client (embed/inspector) can send to the viz. */
 type ClientMessage = InitMessage | SetApiKeyMessage | EditorHandshakeMessage | SavedMessage | ClipboardReadResponseMessage | ClipboardWriteResponseMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | ProjectSetWorkspaceOpenMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | ToastDismissMessage | InspectSnapshotMessage | SystemInitMessage | SystemSelectActorMessage | SystemActorRegisteredMessage | SystemActorEventMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ExtensionResultMessage | ErrorMessage;
 /** All messages the viz can send back to a client. */
-type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | VersionSaveRequestedMessage | ProjectMachineSelectedMessage | ProjectWorkspaceActionMessage | ProjectWorkspaceOpenChangedMessage | ViewModeChangedMessage | PanelChangedMessage | ModeChangedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage | ExtensionCallMessage;
+type VizMessage = SystemLoadedMessage | ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | VersionSaveRequestedMessage | ProjectMachineSelectedMessage | ProjectWorkspaceActionMessage | ProjectWorkspaceOpenChangedMessage | ViewModeChangedMessage | PanelChangedMessage | ModeChangedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage | ExtensionCallMessage;
 interface InspectionClientMetadata {
   name?: string;
   machineId?: string;
@@ -858,4 +832,4 @@ declare const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
 declare const INSPECTION_PROTOCOL_VERSION = 2;
 //#endregion
-export { ProjectSelectMachineMessage as $, EmbedPanelPosition as $t, ExtensionCallMessage as A, SystemActorSnapshotMessage as At, InspectionSentEvent as B, UploadResponseMessage as Bt, EmbedFormatManifest as C, SetSettingsMessage as Ct, ExportCallOptions as D, StateSourceLocation as Dt, ErrorMessage as E, SourceRange as Et, InitOptions as F, ToastMessage as Ft, MachineVersionAutoSaveOptions as G, VizMessage as Gt, LoadedMessage as H, ValidationIssue as Ht, InspectSnapshotMessage as I, UpdateMessage as It, PanelChangedMessage as J, createInspectionRoomUrls as Jt, ModeChangedMessage as K, assertEmbedExamples as Kt, InspectionAction as L, UploadCapabilitiesMessage as Lt, INSPECTION_PROTOCOL_VERSION as M, SystemInitMessage as Mt, INSPECTION_ROOM_QUERY_PARAM as N, SystemSelectActorMessage as Nt, ExportFormat as O, SystemActorEventMessage as Ot, InitMessage as P, ToastDismissMessage as Pt, ProjectMachineSelectedMessage as Q, EmbedPanelConfig as Qt, InspectionClientMetadata as R, UploadFileInfo as Rt, EmbedExtensionsManifest as S, SetModeMessage as St, ErrorCode as T, SourceLocation as Tt, MachineInitOptions as U, VersionSaveRequestedMessage as Ut, InspectionTakenTransition as V, UploadResult as Vt, MachineSourceLocations as W, ViewModeChangedMessage as Wt, ProjectInitMessage as X, isEmbedExample as Xt, ProjectEmbedMachine as Y, getInspectionRoomId as Yt, ProjectInitOptions as Z, isEmbedExampleMachine as Zt, EmbedDocumentLanguage as _, RetrievedMessage as _t, ChangeMessage as a, ProjectWorkspaceCapabilities as at, EmbedEventName as b, SessionMessage as bt, ClipboardReadResponseMessage as c, ProjectWorkspaceMachineOrigin as ct, CommentsConfig as d, ProtocolMessage as dt, ProjectSetWorkspaceOpenMessage as et, EMBED_DOCUMENT_LANGUAGES as f, ReadOnlyReason as ft, EmbedDocument as g, RetrieveMessage as gt, EditorHandshakeMessage as h, RegisteredMessage as ht, CapabilityDeniedMessage as i, ProjectWorkspaceActionMessage as it, ExtensionResultMessage as j, SystemActorStoppedMessage as jt, ExportFormatMap as k, SystemActorRegisteredMessage as kt, ClipboardWriteMessage as l, ProjectWorkspaceOpenChangedMessage as lt, EditorCapabilities as m, RegisterMessage as mt, CapabilityDeniedCapability as n, ProjectWorkspaceAction as nt, ClientMessage as o, ProjectWorkspaceConfig as ot, EMBED_DOCUMENT_LIMITS as p, ReadyMessage as pt, PREFIX as q, createInspectionActorId as qt, CapabilityDeniedEvent as r, ProjectWorkspaceActionIcon as rt, ClipboardReadMessage as s, ProjectWorkspaceMachine as st, ActorSystemEntry as t, ProjectUpdateMessage as tt, ClipboardWriteResponseMessage as u, ProjectWorkspaceProject as ut, EmbedEventHandler as v, SaveMessage as vt, EmbedMode as w, SetThemeMessage as wt, EmbedExample as x, SetApiKeyMessage as xt, EmbedEventMap as y, SavedMessage as yt, InspectionRoomUrls as z, UploadRequestMessage as zt };
+export { ProjectInitMessage as $, createInspectionRoomUrls as $t, ExtensionCallMessage as A, StateSourceLocation as At, InspectionSentEvent as B, UpdateMessage as Bt, EmbedFormatManifest as C, SessionMessage as Ct, ExportCallOptions as D, SetThemeMessage as Dt, ErrorMessage as E, SetSettingsMessage as Et, InitOptions as F, SystemInitMessage as Ft, MachineInitOptions as G, UploadResult as Gt, InspectorLoadedEvent as H, UploadFileInfo as Ht, InspectSnapshotMessage as I, SystemLoadedMessage as It, MachineVersionAutoSaveOptions as J, ViewModeChangedMessage as Jt, MachinePayload as K, ValidationIssue as Kt, InspectionAction as L, SystemSelectActorMessage as Lt, INSPECTION_PROTOCOL_VERSION as M, SystemActorRegisteredMessage as Mt, INSPECTION_ROOM_QUERY_PARAM as N, SystemActorSnapshotMessage as Nt, ExportFormat as O, SourceLocation as Ot, InitMessage as P, SystemActorStoppedMessage as Pt, ProjectEmbedMachine as Q, createInspectionActorId as Qt, InspectionClientMetadata as R, ToastDismissMessage as Rt, EmbedExtensionsManifest as S, SavedMessage as St, ErrorCode as T, SetModeMessage as Tt, InspectorSettings as U, UploadRequestMessage as Ut, InspectionTakenTransition as V, UploadCapabilitiesMessage as Vt, LoadedMessage as W, UploadResponseMessage as Wt, PREFIX as X, VizMessage as Xt, ModeChangedMessage as Y, ViewerOptions as Yt, PanelChangedMessage as Z, assertEmbedExamples as Zt, EmbedDocumentLanguage as _, RegisterMessage as _t, ChangeMessage as a, EmbedPanelConfig as an, ProjectWorkspaceAction as at, EmbedEventName as b, RetrievedMessage as bt, ClipboardReadResponseMessage as c, ProjectWorkspaceCapabilities as ct, CommentsConfig as d, ProjectWorkspaceMachineOrigin as dt, getInspectionRoomId as en, ProjectInitOptions as et, EMBED_DOCUMENT_LANGUAGES as f, ProjectWorkspaceOpenChangedMessage as ft, EmbedDocument as g, ReadyMessage as gt, EditorHandshakeMessage as h, ReadOnlyReason as ht, CapabilityDeniedMessage as i, resolveInspectorSettings as in, ProjectUpdateMessage as it, ExtensionResultMessage as j, SystemActorEventMessage as jt, ExportFormatMap as k, SourceRange as kt, ClipboardWriteMessage as l, ProjectWorkspaceConfig as lt, EditorCapabilities as m, ProtocolMessage as mt, CapabilityDeniedCapability as n, isEmbedExampleMachine as nn, ProjectSelectMachineMessage as nt, ClientMessage as o, EmbedPanelPosition as on, ProjectWorkspaceActionIcon as ot, EMBED_DOCUMENT_LIMITS as p, ProjectWorkspaceProject as pt, MachineSourceLocations as q, VersionSaveRequestedMessage as qt, CapabilityDeniedEvent as r, mergeInspectorSettings as rn, ProjectSetWorkspaceOpenMessage as rt, ClipboardReadMessage as s, ProjectWorkspaceActionMessage as st, ActorSystemEntry as t, isEmbedExample as tn, ProjectMachineSelectedMessage as tt, ClipboardWriteResponseMessage as u, ProjectWorkspaceMachine as ut, EmbedEventHandler as v, RegisteredMessage as vt, EmbedMode as w, SetApiKeyMessage as wt, EmbedExample as x, SaveMessage as xt, EmbedEventMap as y, RetrieveMessage as yt, InspectionRoomUrls as z, ToastMessage as zt };

package/dist/protocol-BsBGRISR.mjs

@@ -0,0 +1,116 @@
+//#region src/inspectorSettings.ts
+const record = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+/** Also filters untrusted wire data to the inspection presentation subset. */
+function mergeInspectorSettings(previous, value) {
+	const input = record(value);
+	const appearance = record(input.appearance);
+	const canvas = record(input.canvas);
+	const result = {
+		appearance: { ...previous.appearance },
+		canvas: { ...previous.canvas }
+	};
+	if ([
+		"light",
+		"dark",
+		"system"
+	].includes(String(appearance.colorMode))) result.appearance.colorMode = appearance.colorMode;
+	if (canvas.viewMode === "graph" || canvas.viewMode === "list") result.canvas.viewMode = canvas.viewMode;
+	for (const key of ["showGrid", "dimUnselected"]) if (typeof canvas[key] === "boolean") result.canvas[key] = canvas[key];
+	if (typeof canvas.edgeHighlightWidth === "number" && Number.isFinite(canvas.edgeHighlightWidth) && canvas.edgeHighlightWidth >= 0) result.canvas.edgeHighlightWidth = canvas.edgeHighlightWidth;
+	return result;
+}
+function resolveInspectorSettings(options) {
+	return mergeInspectorSettings(mergeInspectorSettings({}, options.settings), {
+		appearance: { colorMode: options.theme },
+		canvas: { viewMode: options.viewMode }
+	});
+}
+
+//#endregion
+//#region src/protocol.ts
+/** Query parameter carrying the unguessable inspection room capability. */
+const INSPECTION_ROOM_QUERY_PARAM = "r";
+/**
+* Create the room-global identity for one producer-local actor session.
+* Runtime and producer-resolved session ids may use different uniqueness
+* domains; the producer id supplies a stable room namespace.
+*/
+function createInspectionActorId(producerId, sessionId) {
+	return `${encodeURIComponent(producerId)}:${encodeURIComponent(sessionId)}`;
+}
+/** 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 EMBED_DOCUMENT_LANGUAGES = [
+	"markdown",
+	"typescript",
+	"javascript",
+	"json",
+	"xml",
+	"mermaid",
+	"text"
+];
+const EMBED_DOCUMENT_LIMITS = {
+	maxDocuments: 100,
+	maxDocumentLength: 512 * 1024,
+	maxTotalLength: 2 * 1024 * 1024
+};
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOwn(value, key) {
+	return Object.prototype.hasOwnProperty.call(value, key);
+}
+/** Check whether an example machine has a shape supported by the editor. */
+function isEmbedExampleMachine(value) {
+	if (!isRecord(value)) return false;
+	if (hasOwn(value, "rootNode")) return isRecord(value.rootNode);
+	if (hasOwn(value, "root") && hasOwn(value, "states")) return isRecord(value.states);
+	if (hasOwn(value, "states")) return isRecord(value.states);
+	if (hasOwn(value, "States")) return isRecord(value.States);
+	return hasOwn(value, "nodes") && Array.isArray(value.nodes) && hasOwn(value, "edges") && Array.isArray(value.edges) && hasOwn(value, "data") && isRecord(value.data);
+}
+/** Check whether an unknown value is a valid serialized embed example. */
+function isEmbedExample(value) {
+	return isRecord(value) && typeof value.id === "string" && typeof value.title === "string" && typeof value.description === "string" && typeof value.category === "string" && isEmbedExampleMachine(value.machine);
+}
+/** Reject malformed host-provided examples before creating an init message. */
+function assertEmbedExamples(examples) {
+	if (examples === void 0) return;
+	if (!Array.isArray(examples)) throw new TypeError("Embed examples must be an array.");
+	examples.forEach((example, index) => {
+		if (!isEmbedExample(example)) throw new TypeError(`Invalid embed example at index ${index}.`);
+	});
+}
+const PREFIX = "@statelyai.";
+/** Current WebSocket inspection protocol version. */
+const INSPECTION_PROTOCOL_VERSION = 2;
+
+//#endregion
+export { PREFIX as a, createInspectionRoomUrls as c, isEmbedExampleMachine as d, mergeInspectorSettings as f, INSPECTION_ROOM_QUERY_PARAM as i, getInspectionRoomId as l, EMBED_DOCUMENT_LIMITS as n, assertEmbedExamples as o, resolveInspectorSettings as p, INSPECTION_PROTOCOL_VERSION as r, createInspectionActorId as s, EMBED_DOCUMENT_LANGUAGES as t, isEmbedExample as u };

package/dist/protocol.d.mts

@@ -1,2 +1,2 @@
-import { $ as ProjectSelectMachineMessage, $t as EmbedPanelPosition, A as ExtensionCallMessage, At as SystemActorSnapshotMessage, B as InspectionSentEvent, Bt as UploadResponseMessage, C as EmbedFormatManifest, Ct as SetSettingsMessage, D as ExportCallOptions, Dt as StateSourceLocation, E as ErrorMessage, Et as SourceRange, F as InitOptions, Ft as ToastMessage, G as MachineVersionAutoSaveOptions, Gt as VizMessage, H as LoadedMessage, Ht as ValidationIssue, I as InspectSnapshotMessage, It as UpdateMessage, J as PanelChangedMessage, Jt as createInspectionRoomUrls, K as ModeChangedMessage, Kt as assertEmbedExamples, L as InspectionAction, Lt as UploadCapabilitiesMessage, M as INSPECTION_PROTOCOL_VERSION, Mt as SystemInitMessage, N as INSPECTION_ROOM_QUERY_PARAM, Nt as SystemSelectActorMessage, O as ExportFormat, Ot as SystemActorEventMessage, P as InitMessage, Pt as ToastDismissMessage, Q as ProjectMachineSelectedMessage, Qt as EmbedPanelConfig, R as InspectionClientMetadata, Rt as UploadFileInfo, S as EmbedExtensionsManifest, St as SetModeMessage, T as ErrorCode, Tt as SourceLocation, U as MachineInitOptions, Ut as VersionSaveRequestedMessage, V as InspectionTakenTransition, Vt as UploadResult, W as MachineSourceLocations, Wt as ViewModeChangedMessage, X as ProjectInitMessage, Xt as isEmbedExample, Y as ProjectEmbedMachine, Yt as getInspectionRoomId, Z as ProjectInitOptions, Zt as isEmbedExampleMachine, _ as EmbedDocumentLanguage, _t as RetrievedMessage, a as ChangeMessage, at as ProjectWorkspaceCapabilities, b as EmbedEventName, bt as SessionMessage, c as ClipboardReadResponseMessage, ct as ProjectWorkspaceMachineOrigin, d as CommentsConfig, dt as ProtocolMessage, et as ProjectSetWorkspaceOpenMessage, f as EMBED_DOCUMENT_LANGUAGES, ft as ReadOnlyReason, g as EmbedDocument, gt as RetrieveMessage, h as EditorHandshakeMessage, ht as RegisteredMessage, i as CapabilityDeniedMessage, it as ProjectWorkspaceActionMessage, j as ExtensionResultMessage, jt as SystemActorStoppedMessage, k as ExportFormatMap, kt as SystemActorRegisteredMessage, l as ClipboardWriteMessage, lt as ProjectWorkspaceOpenChangedMessage, m as EditorCapabilities, mt as RegisterMessage, n as CapabilityDeniedCapability, nt as ProjectWorkspaceAction, o as ClientMessage, ot as ProjectWorkspaceConfig, p as EMBED_DOCUMENT_LIMITS, pt as ReadyMessage, q as PREFIX, qt as createInspectionActorId, r as CapabilityDeniedEvent, rt as ProjectWorkspaceActionIcon, s as ClipboardReadMessage, st as ProjectWorkspaceMachine, t as ActorSystemEntry, tt as ProjectUpdateMessage, u as ClipboardWriteResponseMessage, ut as ProjectWorkspaceProject, v as EmbedEventHandler, vt as SaveMessage, w as EmbedMode, wt as SetThemeMessage, x as EmbedExample, xt as SetApiKeyMessage, y as EmbedEventMap, yt as SavedMessage, z as InspectionRoomUrls, zt as UploadRequestMessage } from "./protocol-C-tx0WI6.mjs";
-export { ActorSystemEntry, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, ClipboardReadMessage, ClipboardReadResponseMessage, ClipboardWriteMessage, ClipboardWriteResponseMessage, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EditorHandshakeMessage, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExample, EmbedExtensionsManifest, EmbedFormatManifest, EmbedMode, EmbedPanelConfig, EmbedPanelPosition, ErrorCode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, ExtensionCallMessage, ExtensionResultMessage, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, MachineVersionAutoSaveOptions, ModeChangedMessage, PREFIX, PanelChangedMessage, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastDismissMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VersionSaveRequestedMessage, ViewModeChangedMessage, VizMessage, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine };
+import { $ as ProjectInitMessage, $t as createInspectionRoomUrls, A as ExtensionCallMessage, At as StateSourceLocation, B as InspectionSentEvent, Bt as UpdateMessage, C as EmbedFormatManifest, Ct as SessionMessage, D as ExportCallOptions, Dt as SetThemeMessage, E as ErrorMessage, Et as SetSettingsMessage, F as InitOptions, Ft as SystemInitMessage, G as MachineInitOptions, Gt as UploadResult, H as InspectorLoadedEvent, Ht as UploadFileInfo, I as InspectSnapshotMessage, It as SystemLoadedMessage, J as MachineVersionAutoSaveOptions, Jt as ViewModeChangedMessage, K as MachinePayload, Kt as ValidationIssue, L as InspectionAction, Lt as SystemSelectActorMessage, M as INSPECTION_PROTOCOL_VERSION, Mt as SystemActorRegisteredMessage, N as INSPECTION_ROOM_QUERY_PARAM, Nt as SystemActorSnapshotMessage, O as ExportFormat, Ot as SourceLocation, P as InitMessage, Pt as SystemActorStoppedMessage, Q as ProjectEmbedMachine, Qt as createInspectionActorId, R as InspectionClientMetadata, Rt as ToastDismissMessage, S as EmbedExtensionsManifest, St as SavedMessage, T as ErrorCode, Tt as SetModeMessage, U as InspectorSettings, Ut as UploadRequestMessage, V as InspectionTakenTransition, Vt as UploadCapabilitiesMessage, W as LoadedMessage, Wt as UploadResponseMessage, X as PREFIX, Xt as VizMessage, Y as ModeChangedMessage, Yt as ViewerOptions, Z as PanelChangedMessage, Zt as assertEmbedExamples, _ as EmbedDocumentLanguage, _t as RegisterMessage, a as ChangeMessage, an as EmbedPanelConfig, at as ProjectWorkspaceAction, b as EmbedEventName, bt as RetrievedMessage, c as ClipboardReadResponseMessage, ct as ProjectWorkspaceCapabilities, d as CommentsConfig, dt as ProjectWorkspaceMachineOrigin, en as getInspectionRoomId, et as ProjectInitOptions, f as EMBED_DOCUMENT_LANGUAGES, ft as ProjectWorkspaceOpenChangedMessage, g as EmbedDocument, gt as ReadyMessage, h as EditorHandshakeMessage, ht as ReadOnlyReason, i as CapabilityDeniedMessage, in as resolveInspectorSettings, it as ProjectUpdateMessage, j as ExtensionResultMessage, jt as SystemActorEventMessage, k as ExportFormatMap, kt as SourceRange, l as ClipboardWriteMessage, lt as ProjectWorkspaceConfig, m as EditorCapabilities, mt as ProtocolMessage, n as CapabilityDeniedCapability, nn as isEmbedExampleMachine, nt as ProjectSelectMachineMessage, o as ClientMessage, on as EmbedPanelPosition, ot as ProjectWorkspaceActionIcon, p as EMBED_DOCUMENT_LIMITS, pt as ProjectWorkspaceProject, q as MachineSourceLocations, qt as VersionSaveRequestedMessage, r as CapabilityDeniedEvent, rn as mergeInspectorSettings, rt as ProjectSetWorkspaceOpenMessage, s as ClipboardReadMessage, st as ProjectWorkspaceActionMessage, t as ActorSystemEntry, tn as isEmbedExample, tt as ProjectMachineSelectedMessage, u as ClipboardWriteResponseMessage, ut as ProjectWorkspaceMachine, v as EmbedEventHandler, vt as RegisteredMessage, w as EmbedMode, wt as SetApiKeyMessage, x as EmbedExample, xt as SaveMessage, y as EmbedEventMap, yt as RetrieveMessage, z as InspectionRoomUrls, zt as ToastMessage } from "./protocol-AeHm956D.mjs";
+export { ActorSystemEntry, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, ClipboardReadMessage, ClipboardReadResponseMessage, ClipboardWriteMessage, ClipboardWriteResponseMessage, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EditorHandshakeMessage, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExample, EmbedExtensionsManifest, EmbedFormatManifest, EmbedMode, EmbedPanelConfig, EmbedPanelPosition, ErrorCode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, ExtensionCallMessage, ExtensionResultMessage, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, InspectorLoadedEvent, InspectorSettings, LoadedMessage, MachineInitOptions, MachinePayload, MachineSourceLocations, MachineVersionAutoSaveOptions, ModeChangedMessage, PREFIX, PanelChangedMessage, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemLoadedMessage, SystemSelectActorMessage, ToastDismissMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VersionSaveRequestedMessage, ViewModeChangedMessage, ViewerOptions, VizMessage, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine, mergeInspectorSettings, resolveInspectorSettings };

package/dist/protocol.mjs

@@ -1,87 +1,3 @@
-//#region src/protocol.ts
-/** Query parameter carrying the unguessable inspection room capability. */
-const INSPECTION_ROOM_QUERY_PARAM = "r";
-/**
-* Create the room-global identity for one producer-local actor session.
-* Runtime and producer-resolved session ids may use different uniqueness
-* domains; the producer id supplies a stable room namespace.
-*/
-function createInspectionActorId(producerId, sessionId) {
-	return `${encodeURIComponent(producerId)}:${encodeURIComponent(sessionId)}`;
-}
-/** 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 EMBED_DOCUMENT_LANGUAGES = [
-	"markdown",
-	"typescript",
-	"javascript",
-	"json",
-	"xml",
-	"mermaid",
-	"text"
-];
-const EMBED_DOCUMENT_LIMITS = {
-	maxDocuments: 100,
-	maxDocumentLength: 512 * 1024,
-	maxTotalLength: 2 * 1024 * 1024
-};
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function hasOwn(value, key) {
-	return Object.prototype.hasOwnProperty.call(value, key);
-}
-/** Check whether an example machine has a shape supported by the editor. */
-function isEmbedExampleMachine(value) {
-	if (!isRecord(value)) return false;
-	if (hasOwn(value, "rootNode")) return isRecord(value.rootNode);
-	if (hasOwn(value, "root") && hasOwn(value, "states")) return isRecord(value.states);
-	if (hasOwn(value, "states")) return isRecord(value.states);
-	if (hasOwn(value, "States")) return isRecord(value.States);
-	return hasOwn(value, "nodes") && Array.isArray(value.nodes) && hasOwn(value, "edges") && Array.isArray(value.edges) && hasOwn(value, "data") && isRecord(value.data);
-}
-/** Check whether an unknown value is a valid serialized embed example. */
-function isEmbedExample(value) {
-	return isRecord(value) && typeof value.id === "string" && typeof value.title === "string" && typeof value.description === "string" && typeof value.category === "string" && isEmbedExampleMachine(value.machine);
-}
-/** Reject malformed host-provided examples before creating an init message. */
-function assertEmbedExamples(examples) {
-	if (examples === void 0) return;
-	if (!Array.isArray(examples)) throw new TypeError("Embed examples must be an array.");
-	examples.forEach((example, index) => {
-		if (!isEmbedExample(example)) throw new TypeError(`Invalid embed example at index ${index}.`);
-	});
-}
-const PREFIX = "@statelyai.";
-/** Current WebSocket inspection protocol version. */
-const INSPECTION_PROTOCOL_VERSION = 2;
+import { a as PREFIX, c as createInspectionRoomUrls, d as isEmbedExampleMachine, f as mergeInspectorSettings, i as INSPECTION_ROOM_QUERY_PARAM, l as getInspectionRoomId, n as EMBED_DOCUMENT_LIMITS, o as assertEmbedExamples, p as resolveInspectorSettings, r as INSPECTION_PROTOCOL_VERSION, s as createInspectionActorId, t as EMBED_DOCUMENT_LANGUAGES, u as isEmbedExample } from "./protocol-BsBGRISR.mjs";
 
-//#endregion
-export { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, PREFIX, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine };
+export { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, PREFIX, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine, mergeInspectorSettings, resolveInspectorSettings };

package/dist/relay.d.mts

@@ -1,4 +1,4 @@
-import { dt as ProtocolMessage } from "./protocol-C-tx0WI6.mjs";
+import { mt as ProtocolMessage } from "./protocol-AeHm956D.mjs";
 
 //#region src/relay.d.ts
 type InspectionRelayRole = 'producer' | 'viewer';

package/dist/relay.mjs

@@ -1,4 +1,4 @@
-import { INSPECTION_PROTOCOL_VERSION, PREFIX } from "./protocol.mjs";
+import { a as PREFIX, f as mergeInspectorSettings, p as resolveInspectorSettings, r as INSPECTION_PROTOCOL_VERSION } from "./protocol-BsBGRISR.mjs";
 
 //#region src/relay.ts
 const REPLAYABLE_MESSAGE_TYPES = new Set([
@@ -8,15 +8,17 @@ const REPLAYABLE_MESSAGE_TYPES = new Set([
 	"@statelyai.system.actorRegistered",
 	"@statelyai.system.actorEvent",
 	"@statelyai.system.actorSnapshot",
-	"@statelyai.system.actorStopped"
+	"@statelyai.system.actorStopped",
+	"@statelyai.setSettings",
+	"@statelyai.system.selectActor"
 ]);
 const FORWARD_ONLY_MESSAGE_TYPES = new Set([
-	"@statelyai.system.selectActor",
 	"@statelyai.retrieve",
 	"@statelyai.retrieved",
 	"@statelyai.error",
 	"@statelyai.ready",
 	"@statelyai.loaded",
+	"@statelyai.system.loaded",
 	"@statelyai.capabilityDenied",
 	"@statelyai.register",
 	"@statelyai.registered"
@@ -39,6 +41,7 @@ function validationError(message) {
 	if (!isSupportedMessageType(message.type)) return `Unsupported inspection message type ${String(message.type)}`;
 	const hasString = (key) => typeof message[key] === "string" && message[key] !== "";
 	switch (message.type) {
+		case "@statelyai.setSettings": return message.settings && typeof message.settings === "object" && !Array.isArray(message.settings) ? null : "setSettings requires a settings object";
 		case "@statelyai.system.init": return message.protocolVersion === INSPECTION_PROTOCOL_VERSION && Array.isArray(message.actors) ? null : "system.init requires the current protocolVersion and actors array";
 		case "@statelyai.system.selectActor":
 		case "@statelyai.system.actorStopped": return hasString("sessionId") ? null : `${message.type} requires sessionId`;
@@ -61,6 +64,23 @@ function errorMessage(code, message) {
 function compactReplay(replay, message, max) {
 	const record = message;
 	const type = record.type;
+	if (type === "@statelyai.setSettings" || type === "@statelyai.system.selectActor") {
+		const index = replay.findIndex((entry) => entry.type === "@statelyai.system.init");
+		const init = replay[index];
+		if (init?.type === "@statelyai.system.init") {
+			if (type === "@statelyai.setSettings") {
+				const { theme: _theme, viewMode: _viewMode, ...rest } = init;
+				replay[index] = {
+					...rest,
+					settings: mergeInspectorSettings(resolveInspectorSettings(init), record.settings)
+				};
+			} else replay[index] = {
+				...init,
+				selectedSessionId: record.sessionId
+			};
+			return;
+		}
+	}
 	if (type === "@statelyai.system.init") for (let index = replay.length - 1; index >= 0; index--) {
 		const replayType = replay[index].type;
 		if (replayType === "@statelyai.system.init" || replayType.startsWith("@statelyai.system.actor")) replay.splice(index, 1);