@statelyai/sdk 0.31.2 → 0.33.0

package/README.md

@@ -247,6 +247,15 @@ const inspector = createInspector({
 });
 ```
 
+Declare source or config before its first actor exists to pre-render the graph
+and warm source conversion. The declaration is a hint; an actor's payload wins
+when it differs. `inspector.machine()` replaces a declaration after init.
+
+```ts
+const inspector = createInspector({ machines: { root: machineSource } });
+inspector.machine('root', updatedMachineSource);
+```
+
 Actor IDs are preserved exactly. Unnamed invocations can carry a separate
 `displayName`, derived from the parent machine's resolved invocation declaration
 (for example, `fetchPolicies · account.loading`). Explicit invocation IDs take
@@ -258,22 +267,35 @@ Error, or Stopped); “Awaiting snapshot” means no snapshot has arrived.
 
 For persisted actors, `resolveSessionId` can keep one producer-local identity
 across sequential restore/resume incarnations. Generate a new id for a new
-logical invocation, persist it beside the actor snapshot, and reuse it only
-after the previous incarnation has stopped. Create a new inspector for the
-restored actor system, reusing the same room and producer identities:
+logical invocation, persist it beside the actor snapshot, and reuse it after
+the previous incarnation has stopped. The same inspector may observe the
+replacement runtime actor:
 
 ```ts
 const inspector = createInspector({
   roomId: persistedInspectionRoomId,
   producerId: persistedInspectionProducerId,
-  resolveSessionId: (actor, defaultSessionId) =>
-    actor.logic === machine ? persistedInspectionId : defaultSessionId,
+  resolveSessionId: (actor, defaultSessionId, parentSessionId) =>
+    parentSessionId
+      ? `${parentSessionId}/${actor.id}`
+      : persistedInspectionId,
 });
 ```
 
 A resume must reuse the same room id, producer id, and resolved session id. Keep
 the room id private because it is the room's bearer capability. A new logical
-invocation keeps the producer id but receives a new resolved session id.
+invocation keeps the producer id but receives a new resolved session id. Active
+owners reject collisions unless `sessionIdReuse: "always"` explicitly permits
+replacement; late observations from a displaced actor are ignored.
+
+The resolver's third argument is the parent's resolved id, so recreated child
+actors can use stable paths instead of accumulating runtime session ids. IDs
+must still be unique within one live actor tree.
+
+To present a stopped request-scoped runtime as waiting for its next resume, map
+its serialized status to a non-terminal value such as `suspended` in
+`serializeSnapshot`. The raw terminal status still permits the next runtime
+actor to rebind automatically.
 
 Stopped actors remain in `inspector.actors` and in reconnect checkpoints, so
 completed request-scoped runs stay available for inspection.

package/dist/assetStorage.d.mts

@@ -1,4 +1,4 @@
-import { Vt as UploadResult } from "./protocol-DC7XJtw_.mjs";
+import { Ht as UploadResult } from "./protocol-CQL9Ubt9.mjs";
 
 //#region src/assetStorage.d.ts
 interface AssetUploadContext {

package/dist/{editorHostSession-UdKBWr0I.d.mts → editorHostSession-C6yxOmSO.d.mts}

@@ -1,4 +1,4 @@
-import { Qt as EmbedPanelConfig, Y as ProjectEmbedMachine, ot as ProjectWorkspaceConfig } from "./protocol-DC7XJtw_.mjs";
+import { $t as EmbedPanelConfig, X as ProjectEmbedMachine, st as ProjectWorkspaceConfig } from "./protocol-CQL9Ubt9.mjs";
 import { a as EditorSyncParseRequest, d as EditorSyncTextReplacement, f as MachineSourceLocations, i as EditorSyncApplyResponse, n as EditorSyncAccess, o as EditorSyncParseResponse, r as EditorSyncApplyRequest, s as EditorSyncSourceDocument, t as EditorCapabilities } from "./editor-sync-types-CPpzTSnT.mjs";
 
 //#region src/editorHostProtocol.d.ts

package/dist/editorHostSession.d.mts

@@ -1,2 +1,2 @@
-import { _ as EditorHostOutboundMessage, a as EditorHostWorkspaceSessionOptions, c as EditorSyncError, d as fetchEditorSyncAccess, f as EDITOR_PROTOCOL_VERSION, g as EditorHostInitOptions, h as EditorHostInboundMessage, i as EditorHostWorkspaceSession, l as RemoteEditorSyncBackendOptions, m as EditorHostExportFormat, n as EditorHostSessionOptions, o as EditorSourceHost, p as EditorHostDiagnostic, r as EditorHostWorkspaceMachine, s as EditorSyncBackend, t as EditorHostSession, u as createRemoteEditorSyncBackend, v as EditorHostValidationIssue } from "./editorHostSession-UdKBWr0I.mjs";
+import { _ as EditorHostOutboundMessage, a as EditorHostWorkspaceSessionOptions, c as EditorSyncError, d as fetchEditorSyncAccess, f as EDITOR_PROTOCOL_VERSION, g as EditorHostInitOptions, h as EditorHostInboundMessage, i as EditorHostWorkspaceSession, l as RemoteEditorSyncBackendOptions, m as EditorHostExportFormat, n as EditorHostSessionOptions, o as EditorSourceHost, p as EditorHostDiagnostic, r as EditorHostWorkspaceMachine, s as EditorSyncBackend, t as EditorHostSession, u as createRemoteEditorSyncBackend, v as EditorHostValidationIssue } from "./editorHostSession-C6yxOmSO.mjs";
 export { EDITOR_PROTOCOL_VERSION, EditorHostDiagnostic, EditorHostExportFormat, EditorHostInboundMessage, EditorHostInitOptions, EditorHostOutboundMessage, EditorHostSession, EditorHostSessionOptions, EditorHostValidationIssue, EditorHostWorkspaceMachine, EditorHostWorkspaceSession, EditorHostWorkspaceSessionOptions, EditorSourceHost, EditorSyncBackend, EditorSyncError, RemoteEditorSyncBackendOptions, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/embed.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 { $t as EmbedPanelPosition, D as ExportCallOptions, F as InitOptions, G as MachineVersionAutoSaveOptions, O as ExportFormat, Qt as EmbedPanelConfig, S as EmbedExtensionsManifest, U as MachineInitOptions, Vt as UploadResult, W as MachineSourceLocations, Y as ProjectEmbedMachine, Z as ProjectInitOptions, _ as EmbedDocumentLanguage, at as ProjectWorkspaceCapabilities, b as EmbedEventName, ct as ProjectWorkspaceMachineOrigin, d as CommentsConfig, g as EmbedDocument, k as ExportFormatMap, m as EditorCapabilities, nt as ProjectWorkspaceAction, ot as ProjectWorkspaceConfig, r as CapabilityDeniedEvent, rt as ProjectWorkspaceActionIcon, st as ProjectWorkspaceMachine, ut as ProjectWorkspaceProject, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-DC7XJtw_.mjs";
+import { $t as EmbedPanelConfig, D as ExportCallOptions, F as InitOptions, G as MachineSourceLocations, Ht as UploadResult, K as MachineVersionAutoSaveOptions, O as ExportFormat, Q as ProjectInitOptions, S as EmbedExtensionsManifest, U as MachineInitOptions, X as ProjectEmbedMachine, _ as EmbedDocumentLanguage, b as EmbedEventName, ct as ProjectWorkspaceMachine, d as CommentsConfig, dt as ProjectWorkspaceProject, en as EmbedPanelPosition, g as EmbedDocument, it as ProjectWorkspaceActionIcon, k as ExportFormatMap, lt as ProjectWorkspaceMachineOrigin, m as EditorCapabilities, ot as ProjectWorkspaceCapabilities, r as CapabilityDeniedEvent, rt as ProjectWorkspaceAction, st as ProjectWorkspaceConfig, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-CQL9Ubt9.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
 //#region src/embed.d.ts

package/dist/embed.mjs

@@ -1,4 +1,4 @@
-import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-CsJTVKWN.mjs";
+import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-BblbkW8-.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 
 //#region src/embed.ts

package/dist/index.d.mts

@@ -1,12 +1,12 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
 import { S as GraphPatch, _ as raw, a as RawCode, c as XStateV4TSOptions, d as getXStateFSMCompatibilityIssues, f as graphToMachineConfig, g as jsonSchemaToTSType, h as graphToXStateV4TS, l as contextSchemaToTSType, m as graphToXStateTS, n as CodeGenGraph, o as XStateFSMOptions, p as graphToXStateFSM, r as MachineConfigOptions, s as XStateTSOptions, u as eventsSchemaToTSType, v as serializeJS, y as ActionLocation } from "./index-DlOZxzrW.mjs";
 import { C as EventTypeData, S as DigraphNodeConfig, _ as studioMachineConverter, a as StatelyGraphData, b as DigraphConfig, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, o as StatelyGuard, r as StatelyEdgeData, t as StatelyAction, v as toStudioMachine, w as StateNodeJSONData, x as DigraphEdgeConfig, y as DigraphAction } from "./graph-CR_g-mOq.mjs";
-import { $t as EmbedPanelPosition, B as InspectionSentEvent, D as ExportCallOptions, F as InitOptions, G as MachineVersionAutoSaveOptions, Jt as createInspectionRoomUrls, Kt as assertEmbedExamples, L as InspectionAction, M as INSPECTION_PROTOCOL_VERSION, N as INSPECTION_ROOM_QUERY_PARAM, O as ExportFormat, Qt as EmbedPanelConfig, V as InspectionTakenTransition, Vt as UploadResult, Xt as isEmbedExample, Y as ProjectEmbedMachine, Yt as getInspectionRoomId, Zt as isEmbedExampleMachine, _ as EmbedDocumentLanguage, at as ProjectWorkspaceCapabilities, b as EmbedEventName, ct as ProjectWorkspaceMachineOrigin, d as CommentsConfig, f as EMBED_DOCUMENT_LANGUAGES, g as EmbedDocument, k as ExportFormatMap, m as EditorCapabilities, n as CapabilityDeniedCapability, nt as ProjectWorkspaceAction, ot as ProjectWorkspaceConfig, p as EMBED_DOCUMENT_LIMITS, qt as createInspectionActorId, r as CapabilityDeniedEvent, rt as ProjectWorkspaceActionIcon, st as ProjectWorkspaceMachine, ut as ProjectWorkspaceProject, v as EmbedEventHandler, w as EmbedMode, x as EmbedExample, y as EmbedEventMap } from "./protocol-DC7XJtw_.mjs";
+import { $t as EmbedPanelConfig, B as InspectionSentEvent, D as ExportCallOptions, F as InitOptions, Ht as UploadResult, Jt as createInspectionActorId, K as MachineVersionAutoSaveOptions, L as InspectionAction, M as INSPECTION_PROTOCOL_VERSION, N as INSPECTION_ROOM_QUERY_PARAM, O as ExportFormat, Qt as isEmbedExampleMachine, V as InspectionTakenTransition, X as ProjectEmbedMachine, Xt as getInspectionRoomId, Yt as createInspectionRoomUrls, Zt as isEmbedExample, _ as EmbedDocumentLanguage, b as EmbedEventName, ct as ProjectWorkspaceMachine, d as CommentsConfig, dt as ProjectWorkspaceProject, en as EmbedPanelPosition, f as EMBED_DOCUMENT_LANGUAGES, g as EmbedDocument, it as ProjectWorkspaceActionIcon, k as ExportFormatMap, lt as ProjectWorkspaceMachineOrigin, m as EditorCapabilities, n as CapabilityDeniedCapability, ot as ProjectWorkspaceCapabilities, p as EMBED_DOCUMENT_LIMITS, qt as assertEmbedExamples, r as CapabilityDeniedEvent, rt as ProjectWorkspaceAction, st as ProjectWorkspaceConfig, v as EmbedEventHandler, w as EmbedMode, x as EmbedExample, y as EmbedEventMap } from "./protocol-CQL9Ubt9.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
 import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-Dg7prjeL.mjs";
-import { _ as EditorHostOutboundMessage, a as EditorHostWorkspaceSessionOptions, d as fetchEditorSyncAccess, f as EDITOR_PROTOCOL_VERSION, g as EditorHostInitOptions, h as EditorHostInboundMessage, i as EditorHostWorkspaceSession, l as RemoteEditorSyncBackendOptions, m as EditorHostExportFormat, n as EditorHostSessionOptions, o as EditorSourceHost, p as EditorHostDiagnostic, r as EditorHostWorkspaceMachine, s as EditorSyncBackend, t as EditorHostSession, u as createRemoteEditorSyncBackend, v as EditorHostValidationIssue } from "./editorHostSession-UdKBWr0I.mjs";
+import { _ as EditorHostOutboundMessage, a as EditorHostWorkspaceSessionOptions, d as fetchEditorSyncAccess, f as EDITOR_PROTOCOL_VERSION, g as EditorHostInitOptions, h as EditorHostInboundMessage, i as EditorHostWorkspaceSession, l as RemoteEditorSyncBackendOptions, m as EditorHostExportFormat, n as EditorHostSessionOptions, o as EditorSourceHost, p as EditorHostDiagnostic, r as EditorHostWorkspaceMachine, s as EditorSyncBackend, t as EditorHostSession, u as createRemoteEditorSyncBackend, v as EditorHostValidationIssue } from "./editorHostSession-C6yxOmSO.mjs";
 import { AssetConfig, EmbedEntity, EmbedFormatContext, EmbedFormatDefinition, EmbedGraph, EmbedProfileDefinition, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { _ as createWebSocketTransport, a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, g as createPostMessageTransport, h as TransportFailure, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-DVRwYKva.mjs";
+import { _ as createWebSocketTransport, a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, g as createPostMessageTransport, h as TransportFailure, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-CunxIl8H.mjs";
 import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-DV5IIGhV.mjs";
 import { OAuthAuthorizationServerMetadata, OAuthClientRegistrationResponse, OAuthProtectedResourceMetadata, OAuthTokenResponse, PkcePair, buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import "./openapi-BTDjYWXd.mjs";
 import { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine } from "./protocol.mjs";
-import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-CsJTVKWN.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-BblbkW8-.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { a as fetchEditorSyncAccess, i as createRemoteEditorSyncBackend, n as EditorHostWorkspaceSession, t as EditorHostSession } from "./editorHostSession-DfmHzpls.mjs";
 import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-rSI54Ese.mjs";
 import { _ as graphToXStateV4TS, b as raw, f as getXStateFSMCompatibilityIssues, g as graphToXStateTS, h as graphToXStateFSM, l as eventsSchemaToTSType, m as graphToMachineConfig, n as RawCode, o as contextSchemaToTSType, v as jsonSchemaToTSType, x as serializeJS } from "./dist-wbhkeGh6.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-Dcjy_T2E.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-C-eEfU3T.mjs";
 import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
 import { buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";

package/dist/{inspect-Dcjy_T2E.mjs → inspect-C-eEfU3T.mjs}

@@ -1,5 +1,5 @@
 import { INSPECTION_PROTOCOL_VERSION, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
-import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-CsJTVKWN.mjs";
+import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-BblbkW8-.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
@@ -78,7 +78,8 @@ function generateRoomId() {
 function createInspector(options = {}) {
 	const environmentUrl = typeof process !== "undefined" ? process.env?.STATELY_INSPECT_URL : void 0;
 	const url = options.url ?? environmentUrl ?? "wss://sky.stately.ai";
-	const { inspectorBaseUrl, name, serializeSnapshot = defaultSerializeSnapshot, selectedSessionId: configuredSelectedSessionId, selectedActorId, panels, theme, readOnly, depth, capabilities, transport: injectedTransport } = options;
+	const { inspectorBaseUrl, name, machines: configuredMachines, serializeSnapshot = defaultSerializeSnapshot, selectedSessionId: configuredSelectedSessionId, selectedActorId, panels, theme, readOnly, depth, capabilities, sessionIdReuse = "stopped", transport: injectedTransport } = options;
+	const declaredMachines = { ...configuredMachines };
 	const launch = options.launch ?? (options.autoOpen === true ? "browser" : "none");
 	const extractMachine = options.extractMachine ?? options.extractMachineConfig ?? defaultExtractMachineConfig;
 	const roomId = options.roomId ?? options.sessionId ?? getInspectionRoomId(url) ?? generateRoomId();
@@ -241,26 +242,60 @@ function createInspector(options = {}) {
 	const actors = /* @__PURE__ */ new Map();
 	const resolvedSessionIds = /* @__PURE__ */ new WeakMap();
 	const actorsByResolvedSessionId = /* @__PURE__ */ new Map();
+	const runtimeRoots = /* @__PURE__ */ new WeakMap();
+	const terminatedActors = /* @__PURE__ */ new WeakSet();
+	const reboundActors = /* @__PURE__ */ new WeakSet();
 	const manualSessionIds = /* @__PURE__ */ new Map();
 	/** Tracks which actors we've already emitted local actor events for. */
 	const locallyRegistered = /* @__PURE__ */ new Set();
 	/** v5 emits transition facets separately; accumulate them until snapshot. */
 	const pendingTransitions = /* @__PURE__ */ new Map();
-	function sessionIdOf(actorRef) {
+	function runtimeRootOf(actorRef, parentRef) {
+		const known = runtimeRoots.get(actorRef);
+		if (known) return known;
+		let rootRef = parentRef ?? actorRef;
+		while (rootRef._parent) rootRef = rootRef._parent;
+		runtimeRoots.set(actorRef, rootRef);
+		return rootRef;
+	}
+	function sessionIdOf(actorRef, parentRef = actorRef._parent, runtimeRoot) {
 		const existing = resolvedSessionIds.get(actorRef);
 		if (existing) return existing;
-		const resolved = options.resolveSessionId?.(actorRef, actorRef.sessionId) ?? actorRef.sessionId;
+		const parentSessionId = parentRef ? sessionIdOf(parentRef, parentRef._parent, runtimeRoot) : null;
+		const resolved = options.resolveSessionId?.(actorRef, actorRef.sessionId, parentSessionId) ?? actorRef.sessionId;
 		if (typeof resolved !== "string" || resolved.length === 0) throw new Error("createInspector(): resolveSessionId must return a non-empty string.");
+		assertSessionIdAvailable(actorRef, resolved, runtimeRoot ?? runtimeRootOf(actorRef, parentRef));
+		return claimSessionId(actorRef, resolved);
+	}
+	function assertSessionIdAvailable(actorRef, resolved, nextRoot) {
 		const claimedBy = actorsByResolvedSessionId.get(resolved);
-		if (claimedBy !== void 0 && claimedBy !== actorRef || claimedBy === void 0 && actors.has(resolved)) throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
+		const claimedEntry = actors.get(resolved);
+		if (claimedBy !== void 0 && claimedBy !== actorRef) {
+			if (runtimeRootOf(claimedBy) === nextRoot || !terminatedActors.has(claimedBy) && sessionIdReuse !== "always") throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
+		}
+		if (claimedBy === void 0 && claimedEntry) throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
+	}
+	function claimSessionId(actorRef, resolved) {
+		const claimedBy = actorsByResolvedSessionId.get(resolved);
+		if (claimedBy !== void 0 && claimedBy !== actorRef) {
+			actorsByResolvedSessionId.set(resolved, actorRef);
+			resolvedSessionIds.set(actorRef, resolved);
+			reboundActors.add(actorRef);
+			pendingTransitions.delete(resolved);
+			return resolved;
+		}
 		resolvedSessionIds.set(actorRef, resolved);
 		actorsByResolvedSessionId.set(resolved, actorRef);
 		return resolved;
 	}
+	function isCurrentOwner(actorRef) {
+		const sessionId = resolvedSessionIds.get(actorRef);
+		return sessionId === void 0 || actorsByResolvedSessionId.get(sessionId) === actorRef;
+	}
 	function rootSessionIdOf(runtimeRootId, actorRef) {
 		let rootRef = actorRef;
 		while (rootRef._parent) rootRef = rootRef._parent;
-		return rootRef.sessionId === runtimeRootId ? sessionIdOf(rootRef) : runtimeRootId;
+		return rootRef.sessionId === runtimeRootId ? sessionIdOf(rootRef, void 0, rootRef) : runtimeRootId;
 	}
 	function emitRegisterOnce(entry) {
 		if (locallyRegistered.has(entry.sessionId)) return;
@@ -268,23 +303,26 @@ function createInspector(options = {}) {
 		emitLocal("actor", entry);
 		emitLocal("register", entry);
 	}
-	function snapshotValue(actorRef) {
+	function readSnapshot(actorRef) {
 		try {
-			return serializeSnapshot(actorRef.getSnapshot());
+			return actorRef.getSnapshot();
 		} catch {
-			return null;
+			return;
 		}
 	}
-	function stoppedValue(actorRef, snapshot) {
-		try {
-			return isStoppedSnapshot(snapshot ?? actorRef.getSnapshot());
-		} catch {
-			return false;
-		}
+	function trackTermination(actorRef, snapshot) {
+		if (isStoppedSnapshot(snapshot)) terminatedActors.add(actorRef);
+	}
+	function serializedStoppedValue(serialized, snapshot) {
+		if (serialized !== null && typeof serialized === "object" && Object.hasOwn(serialized, "status")) return isStoppedSnapshot(serialized);
+		return isStoppedSnapshot(snapshot);
 	}
 	function toEntry(actorRef, rootActorId, details) {
-		const sessionId = sessionIdOf(actorRef);
 		const parentRef = details?.parentRef ?? actorRef._parent;
+		const sessionId = sessionIdOf(actorRef, parentRef);
+		const snapshot = details?.snapshot ?? readSnapshot(actorRef);
+		const serialized = snapshot === void 0 ? null : serializeSnapshot(snapshot);
+		if (snapshot !== void 0) trackTermination(actorRef, snapshot);
 		return {
 			sessionId,
 			actorId: details?.id ?? actorRef.id ?? sessionId,
@@ -292,8 +330,8 @@ function createInspector(options = {}) {
 			parentSessionId: parentRef ? sessionIdOf(parentRef) : null,
 			rootSessionId: rootActorId,
 			systemId: actorRef.systemId,
-			snapshot: details?.snapshot ? serializeSnapshot(details.snapshot) : snapshotValue(actorRef),
-			stopped: stoppedValue(actorRef, details?.snapshot),
+			snapshot: serialized,
+			stopped: snapshot === void 0 ? false : serializedStoppedValue(serialized, snapshot),
 			machineConfig: extractMachine(actorRef, details?.source ?? actorRef.src)
 		};
 	}
@@ -308,26 +346,73 @@ function createInspector(options = {}) {
 			...entry.stopped && { stopped: true }
 		};
 	}
-	function resolveActorTreeSessionIds(actorRef) {
-		sessionIdOf(actorRef);
-		const children = actorRef.getSnapshot()?.children ?? {};
-		for (const child of Object.values(children)) if (child) resolveActorTreeSessionIds(child);
+	function resolveActorTreeSessionIds(rootRef) {
+		const pending = /* @__PURE__ */ new Map();
+		const owners = /* @__PURE__ */ new Map();
+		function visit(actorRef, parentRef) {
+			const existing = resolvedSessionIds.get(actorRef);
+			const parentSessionId = parentRef ? resolvedSessionIds.get(parentRef) ?? pending.get(parentRef)?.resolved : null;
+			const resolved = existing ?? options.resolveSessionId?.(actorRef, actorRef.sessionId, parentSessionId ?? null) ?? actorRef.sessionId;
+			if (typeof resolved !== "string" || resolved.length === 0) throw new Error("createInspector(): resolveSessionId must return a non-empty string.");
+			const localOwner = owners.get(resolved);
+			if (localOwner && localOwner !== actorRef) throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
+			owners.set(resolved, actorRef);
+			if (!existing) pending.set(actorRef, {
+				resolved,
+				parentRef
+			});
+			assertSessionIdAvailable(actorRef, resolved, rootRef);
+			const children = actorRef.getSnapshot()?.children ?? {};
+			for (const child of Object.values(children)) if (child) visit(child, actorRef);
+		}
+		visit(rootRef);
+		for (const [actorRef, { resolved }] of pending) {
+			runtimeRoots.set(actorRef, rootRef);
+			claimSessionId(actorRef, resolved);
+		}
 	}
 	/**
 	* Walk the actor tree and populate the local `actors` map. Idempotent —
 	* existing entries stay in place but have their snapshot refreshed.
 	*/
-	function backfillActorTree(actorRef, rootActorId) {
-		const existing = actors.get(sessionIdOf(actorRef));
-		const entry = existing ?? toEntry(actorRef, rootActorId);
-		if (existing) {
+	function publishActorRegistered(entry, replaces = false) {
+		if (!initSent) return;
+		send({
+			type: "@statelyai.system.actorRegistered",
+			sessionId: entry.sessionId,
+			actorId: entry.actorId,
+			...replaces && { replaces: true },
+			...entry.displayName && { displayName: entry.displayName },
+			parentSessionId: entry.parentSessionId,
+			machine: entry.machineConfig,
+			snapshot: entry.snapshot ?? void 0
+		});
+		if ((configuredSelectedSessionId ?? selectedActorId) === entry.sessionId) send({
+			type: "@statelyai.system.selectActor",
+			sessionId: entry.sessionId
+		});
+	}
+	function backfillActorTree(actorRef, rootActorId, publish = false) {
+		const sessionId = sessionIdOf(actorRef);
+		const existing = actors.get(sessionId);
+		const replaces = reboundActors.delete(actorRef);
+		const entry = !existing || replaces ? toEntry(actorRef, rootActorId) : existing;
+		if (existing && !replaces) {
 			const snapshot = actorRef.getSnapshot();
-			existing.snapshot = serializeSnapshot(snapshot);
-			existing.stopped ||= isStoppedSnapshot(snapshot);
-		} else actors.set(entry.sessionId, entry);
-		emitRegisterOnce(entry);
+			const serialized = serializeSnapshot(snapshot);
+			trackTermination(actorRef, snapshot);
+			existing.snapshot = serialized;
+			existing.stopped ||= serializedStoppedValue(serialized, snapshot);
+		} else {
+			actors.set(entry.sessionId, entry);
+			if (replaces) {
+				emitLocal("actor", entry);
+				emitLocal("register", entry);
+			} else emitRegisterOnce(entry);
+			if (publish) publishActorRegistered(entry, replaces);
+		}
 		const children = actorRef.getSnapshot()?.children ?? {};
-		for (const child of Object.values(children)) if (child) backfillActorTree(child, rootActorId);
+		for (const child of Object.values(children)) if (child) backfillActorTree(child, rootActorId, publish);
 	}
 	const inspectedRoots = /* @__PURE__ */ new Map();
 	const observedRootIds = /* @__PURE__ */ new Set();
@@ -340,6 +425,7 @@ function createInspector(options = {}) {
 			protocolVersion: INSPECTION_PROTOCOL_VERSION,
 			mode: "inspecting",
 			actors: allEntries.map(toSystemEntry),
+			...configuredMachines !== void 0 || Object.keys(declaredMachines).length > 0 ? { machines: { ...declaredMachines } } : {},
 			...selectedSessionId && { selectedSessionId },
 			...theme && { theme },
 			...readOnly !== void 0 && { readOnly },
@@ -356,19 +442,16 @@ function createInspector(options = {}) {
 		initSent = true;
 	}
 	function handleActor(actorRef, rootActorId, details) {
-		if (actors.has(sessionIdOf(actorRef))) return;
+		const sessionId = sessionIdOf(actorRef, details?.parentRef);
+		const replaces = reboundActors.delete(actorRef);
+		if (actors.has(sessionId) && !replaces) return;
 		const entry = toEntry(actorRef, rootActorId, details);
 		actors.set(entry.sessionId, entry);
-		emitRegisterOnce(entry);
-		if (initSent) send({
-			type: "@statelyai.system.actorRegistered",
-			sessionId: entry.sessionId,
-			actorId: entry.actorId,
-			...entry.displayName && { displayName: entry.displayName },
-			parentSessionId: entry.parentSessionId,
-			machine: entry.machineConfig,
-			snapshot: entry.snapshot ?? void 0
-		});
+		if (replaces) {
+			emitLocal("actor", entry);
+			emitLocal("register", entry);
+		} else emitRegisterOnce(entry);
+		publishActorRegistered(entry, replaces);
 	}
 	function normalizeAction(action) {
 		return {
@@ -436,6 +519,7 @@ function createInspector(options = {}) {
 		const entry = actors.get(sessionId);
 		if (!entry) return;
 		const serialized = serializeSnapshot(snapshot);
+		trackTermination(actorRef, snapshot);
 		const inspectedSnapshot = {
 			sessionId: entry.sessionId,
 			sourceSessionId: transition.sourceSessionId,
@@ -448,7 +532,7 @@ function createInspector(options = {}) {
 		};
 		const wasStopped = entry.stopped;
 		entry.snapshot = serialized;
-		const stopped = isStoppedSnapshot(snapshot);
+		const stopped = serializedStoppedValue(serialized, snapshot);
 		entry.stopped ||= stopped;
 		pendingTransitions.delete(entry.sessionId);
 		if (initSent) send({
@@ -480,6 +564,7 @@ function createInspector(options = {}) {
 		materializePendingInit();
 		const event = inspectionEvent;
 		const rootActorId = rootSessionIdOf(event.rootId, event.actorRef);
+		if (!isCurrentOwner(event.actorRef)) return;
 		const isNewRoot = !observedRootIds.has(rootActorId);
 		observedRootIds.add(rootActorId);
 		switch (event.type) {
@@ -522,26 +607,30 @@ function createInspector(options = {}) {
 				break;
 			default: break;
 		}
-		if (isNewRoot) sendInit();
+		if (isNewRoot && !initSent) sendInit();
 	}
 	function attachActor(actor) {
 		const root = actor;
+		resolveActorTreeSessionIds(root);
 		const rootActorId = sessionIdOf(root);
 		const existing = inspectedRoots.get(rootActorId);
-		if (existing) return existing.subscription;
+		if (existing?.actor === root) return existing.subscription;
+		if (existing) {
+			existing.subscription.unsubscribe();
+			inspectedRoots.delete(rootActorId);
+		}
 		materializePendingInit();
-		resolveActorTreeSessionIds(root);
 		observedRootIds.add(rootActorId);
 		const subscription = root.system.inspect(handleInspectionEvent);
 		inspectedRoots.set(rootActorId, {
 			actor: root,
 			subscription
 		});
-		backfillActorTree(root, rootActorId);
-		sendInit();
+		backfillActorTree(root, rootActorId, true);
+		if (!initSent) sendInit();
 		return { unsubscribe() {
 			subscription.unsubscribe();
-			inspectedRoots.delete(rootActorId);
+			if (inspectedRoots.get(rootActorId)?.subscription === subscription) inspectedRoots.delete(rootActorId);
 		} };
 	}
 	function getManualSessionId(actorId) {
@@ -630,6 +719,10 @@ function createInspector(options = {}) {
 		emitLocal("stop", stopped);
 		emitLocal("stopped", stopped);
 	}
+	function manualMachine(id, payload) {
+		declaredMachines[id] = payload;
+		sendInit();
+	}
 	initialized = true;
 	if (pendingTransportReady) {
 		pendingTransportReady = false;
@@ -661,6 +754,7 @@ function createInspector(options = {}) {
 			return exportManager.start(format, callOptions, "Inspector is destroyed", () => destroyed);
 		},
 		actor: manualRegister,
+		machine: manualMachine,
 		snapshot: manualSnapshot,
 		event: manualEvent,
 		stop: manualStop,

package/dist/{inspect-DVRwYKva.d.mts → inspect-CunxIl8H.d.mts}

@@ -1,4 +1,4 @@
-import { B as InspectionSentEvent, D as ExportCallOptions, L as InspectionAction, O as ExportFormat, Qt as EmbedPanelConfig, R as InspectionClientMetadata, V as InspectionTakenTransition, dt as ProtocolMessage, k as ExportFormatMap, m as EditorCapabilities, y as EmbedEventMap } from "./protocol-DC7XJtw_.mjs";
+import { $t as EmbedPanelConfig, B as InspectionSentEvent, D as ExportCallOptions, L as InspectionAction, O as ExportFormat, R as InspectionClientMetadata, V as InspectionTakenTransition, W as MachinePayload, ft as ProtocolMessage, k as ExportFormatMap, m as EditorCapabilities, y as EmbedEventMap } from "./protocol-CQL9Ubt9.mjs";
 
 //#region src/transport.d.ts
 interface TransportFailure {
@@ -170,10 +170,14 @@ interface CreateInspectorOptions {
   sessionId?: string;
   /** Display name for this system in the visualizer. */
   name?: string;
+  /** Machine definitions available before their first actor exists. */
+  machines?: Record<string, MachinePayload>;
   /**
    * Serialize a snapshot for the wire. Defaults to `{value, status}` —
    * dropping context entirely because xstate contexts routinely contain
-   * spawned actor refs which are not JSON-safe.
+   * spawned actor refs which are not JSON-safe. An explicit serialized status
+   * controls terminal presentation; for example, map a runtime `stopped`
+   * status to `suspended` when a logical actor is expected to resume.
    */
   serializeSnapshot?: (snapshot: MinimalSnapshot) => unknown;
   /**
@@ -191,10 +195,17 @@ interface CreateInspectorOptions {
   /**
    * Resolve the producer-local identity used for an actor on the inspection
    * wire. Defaults to XState's runtime `actor.sessionId`. The resolver runs
-   * once per runtime actor and must return a non-empty id that is unique among
-   * all actors observed by this inspector.
+   * once per runtime actor and receives its parent's resolved id as the third
+   * argument. It must return a non-empty id. Reusing an id follows
+   * {@link CreateInspectorOptions.sessionIdReuse}.
    */
-  resolveSessionId?: (actor: any, defaultSessionId: string) => string;
+  resolveSessionId?: (actor: any, defaultSessionId: string, parentSessionId: string | null) => string;
+  /**
+   * Controls when a resolved session id may move to another runtime actor.
+   * Stopped actors are replaced by default. Use `always` for hosts that can
+   * guarantee the previous runtime actor will no longer produce relevant events.
+   */
+  sessionIdReuse?: 'stopped' | 'always';
   /** Selected actor session id to focus on first. */
   selectedSessionId?: string;
   /** @deprecated Use {@link selectedSessionId}. */
@@ -245,6 +256,8 @@ interface Inspector {
    * xstate-discovered ones; in manual mode it's the only way to add actors.
    */
   actor(id: string, options?: ManualActorOptions): void;
+  /** Declare or replace a machine definition and refresh the system checkpoint. */
+  machine(id: string, payload: MachinePayload): void;
   /**
    * Push a snapshot update for an actor, optionally with the event known to
    * have caused it. The actor is auto-registered if needed.

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
-import { B as InspectionSentEvent, D as ExportCallOptions, L as InspectionAction, O as ExportFormat, V as InspectionTakenTransition, b as EmbedEventName, k as ExportFormatMap, m as EditorCapabilities, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-DC7XJtw_.mjs";
-import { a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-DVRwYKva.mjs";
-export { AdoptedActor, CreateInspectorOptions, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InspectedEvent, InspectedSnapshot, InspectedTransition, InspectionAction, InspectionSentEvent, InspectionTakenTransition, Inspector, InspectorConnection, InspectorDiscoveryEntry, InspectorEvents, InspectorInspectionEvent, ManualActorOptions, Transport, createInspector, createStatelyInspector };
+import { B as InspectionSentEvent, D as ExportCallOptions, L as InspectionAction, O as ExportFormat, V as InspectionTakenTransition, W as MachinePayload, b as EmbedEventName, k as ExportFormatMap, m as EditorCapabilities, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-CQL9Ubt9.mjs";
+import { a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-CunxIl8H.mjs";
+export { AdoptedActor, CreateInspectorOptions, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InspectedEvent, InspectedSnapshot, InspectedTransition, InspectionAction, InspectionSentEvent, InspectionTakenTransition, Inspector, InspectorConnection, InspectorDiscoveryEntry, InspectorEvents, InspectorInspectionEvent, MachinePayload, ManualActorOptions, Transport, createInspector, createStatelyInspector };

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
-import "./version-CsJTVKWN.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-Dcjy_T2E.mjs";
+import "./version-BblbkW8-.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-C-eEfU3T.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/{protocol-DC7XJtw_.d.mts → protocol-CQL9Ubt9.d.mts}

@@ -575,6 +575,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;
@@ -600,6 +602,8 @@ interface SystemInitMessage {
   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[];
@@ -627,6 +631,8 @@ interface SystemActorRegisteredMessage {
   type: '@statelyai.system.actorRegistered';
   sessionId: string;
   actorId: string;
+  /** This runtime actor replaces the previous owner of `sessionId`. */
+  replaces?: boolean;
   /** Optional readable label; never replaces the runtime actor ID. */
   displayName?: string;
   parentSessionId: string | null;
@@ -856,4 +862,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 { ProjectMachineSelectedMessage as $, EmbedPanelConfig as $t, ExtensionCallMessage as A, SystemActorRegisteredMessage as At, InspectionSentEvent as B, UploadRequestMessage as Bt, EmbedFormatManifest as C, SetModeMessage as Ct, ExportCallOptions as D, SourceRange as Dt, ErrorMessage as E, SourceLocation as Et, InitOptions as F, ToastDismissMessage as Ft, MachineSourceLocations as G, ViewModeChangedMessage as Gt, LoadedMessage as H, UploadResult as Ht, InspectSnapshotMessage as I, ToastMessage as It, PREFIX as J, createInspectionActorId as Jt, MachineVersionAutoSaveOptions as K, VizMessage as Kt, InspectionAction as L, UpdateMessage as Lt, INSPECTION_PROTOCOL_VERSION as M, SystemActorStoppedMessage as Mt, INSPECTION_ROOM_QUERY_PARAM as N, SystemInitMessage as Nt, ExportFormat as O, StateSourceLocation as Ot, InitMessage as P, SystemSelectActorMessage as Pt, ProjectInitOptions as Q, isEmbedExampleMachine as Qt, InspectionClientMetadata as R, UploadCapabilitiesMessage as Rt, EmbedExtensionsManifest as S, SetApiKeyMessage as St, ErrorCode as T, SetThemeMessage as Tt, MachineInitOptions as U, ValidationIssue as Ut, InspectionTakenTransition as V, UploadResponseMessage as Vt, MachinePayload as W, VersionSaveRequestedMessage as Wt, ProjectEmbedMachine as X, getInspectionRoomId as Xt, PanelChangedMessage as Y, createInspectionRoomUrls as Yt, ProjectInitMessage as Z, isEmbedExample as Zt, EmbedDocumentLanguage as _, RetrieveMessage as _t, ChangeMessage as a, ProjectWorkspaceActionMessage as at, EmbedEventName as b, SavedMessage as bt, ClipboardReadResponseMessage as c, ProjectWorkspaceMachine as ct, CommentsConfig as d, ProjectWorkspaceProject as dt, EmbedPanelPosition as en, ProjectSelectMachineMessage as et, EMBED_DOCUMENT_LANGUAGES as f, ProtocolMessage as ft, EmbedDocument as g, RegisteredMessage as gt, EditorHandshakeMessage as h, RegisterMessage as ht, CapabilityDeniedMessage as i, ProjectWorkspaceActionIcon as it, ExtensionResultMessage as j, SystemActorSnapshotMessage as jt, ExportFormatMap as k, SystemActorEventMessage as kt, ClipboardWriteMessage as l, ProjectWorkspaceMachineOrigin as lt, EditorCapabilities as m, ReadyMessage as mt, CapabilityDeniedCapability as n, ProjectUpdateMessage as nt, ClientMessage as o, ProjectWorkspaceCapabilities as ot, EMBED_DOCUMENT_LIMITS as p, ReadOnlyReason as pt, ModeChangedMessage as q, assertEmbedExamples as qt, CapabilityDeniedEvent as r, ProjectWorkspaceAction as rt, ClipboardReadMessage as s, ProjectWorkspaceConfig as st, ActorSystemEntry as t, ProjectSetWorkspaceOpenMessage as tt, ClipboardWriteResponseMessage as u, ProjectWorkspaceOpenChangedMessage as ut, EmbedEventHandler as v, RetrievedMessage as vt, EmbedMode as w, SetSettingsMessage as wt, EmbedExample as x, SessionMessage as xt, EmbedEventMap as y, SaveMessage as yt, InspectionRoomUrls as z, UploadFileInfo as zt };

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

package/dist/relay.d.mts

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

package/dist/{version-CsJTVKWN.mjs → version-BblbkW8-.mjs}

@@ -366,7 +366,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.31.2";
+const SDK_VERSION = "0.33.0";
 function inspectionRuntime() {
 	if (typeof window !== "undefined") return "browser";
 	if (typeof process !== "undefined" && process.versions?.node) return "node";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.31.2",
+  "version": "0.33.0",
   "license": "MIT",
   "bin": {
     "stately-sdk": "./dist/bin.mjs"