@statelyai/sdk 0.17.0 → 0.20.0

package/dist/editorHostSession-jnC5mQDN.d.mts

@@ -0,0 +1,184 @@
+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-D8_EZm0A.mjs";
+
+//#region src/editorHostProtocol.d.ts
+declare const EDITOR_PROTOCOL_VERSION = 1;
+type EditorHostExportFormat = 'xstate-v6' | 'xstate' | 'async' | 'xstate-json' | 'xgraph' | 'digraph' | 'd2' | 'mermaid' | 'redux' | 'zustand' | 'asl-json' | 'asl-yaml' | 'scxml';
+interface EditorHostValidationIssue {
+  nodeIds: string[];
+  edgeIds: string[];
+  level: 'info' | 'warning' | 'error';
+  message: string;
+}
+type EditorHostInboundMessage = {
+  type: '@statelyai.ready';
+  version?: string;
+  protocolVersion?: number;
+} | {
+  type: '@statelyai.loaded';
+  graph: unknown;
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.change';
+  graph: unknown;
+  machineConfig: unknown;
+  patches?: unknown[];
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.save';
+  graph: unknown;
+  machineConfig: unknown;
+  patches?: unknown[];
+  validations?: EditorHostValidationIssue[];
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.retrieved';
+  requestId: string;
+  data: unknown;
+} | {
+  type: '@statelyai.error';
+  code: string;
+  message: string;
+  requestId?: string;
+} | {
+  type: '@statelyai.clipboardRead';
+  requestId: string;
+} | {
+  type: '@statelyai.clipboardWrite';
+  requestId: string;
+  text: string;
+};
+interface EditorHostInitOptions {
+  settings?: Record<string, unknown>;
+  leftPanels?: string[];
+  rightPanels?: string[];
+  activePanels?: string[];
+  unsavedIndicator?: {
+    enabled?: boolean;
+    mode?: 'structural' | 'all';
+  };
+}
+type EditorHostOutboundMessage = {
+  type: '@statelyai.init';
+  machine: unknown;
+  format?: string;
+  mode?: 'editing' | 'viewing';
+  theme?: 'light' | 'dark';
+  readOnly?: boolean;
+  readOnlyReason?: 'free-plan' | 'access-unverified';
+  capabilities?: EditorCapabilities;
+  sourceLocations?: MachineSourceLocations;
+  settings?: Record<string, unknown>;
+  leftPanels?: string[];
+  rightPanels?: string[];
+  activePanels?: string[];
+  unsavedIndicator?: {
+    enabled?: boolean;
+    mode?: 'structural' | 'all';
+  };
+} | {
+  type: '@statelyai.setApiKey';
+  apiKey: string;
+} | {
+  type: '@statelyai.handshake';
+  protocolVersion: number;
+  client?: {
+    name: string;
+    version: string;
+  };
+} | {
+  type: '@statelyai.update';
+  machine: unknown;
+  format?: string;
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.saved';
+  graph: unknown;
+} | {
+  type: '@statelyai.retrieve';
+  requestId: string;
+  format: EditorHostExportFormat;
+} | {
+  type: '@statelyai.toast';
+  message: string;
+  toastType?: 'success' | 'error' | 'info' | 'warning';
+} | {
+  type: '@statelyai.error';
+  code: string;
+  message: string;
+} | {
+  type: '@statelyai.clipboardReadResponse';
+  requestId: string;
+  text: string;
+} | {
+  type: '@statelyai.clipboardWriteResponse';
+  requestId: string;
+  ok: boolean;
+};
+//#endregion
+//#region src/editorHostSession.d.ts
+interface EditorSyncBackend {
+  parse(request: EditorSyncParseRequest): Promise<EditorSyncParseResponse>;
+  apply(request: EditorSyncApplyRequest): Promise<EditorSyncApplyResponse>;
+}
+interface RemoteEditorSyncBackendOptions {
+  editorUrl: string;
+  apiKey?: string;
+  fetch?: typeof globalThis.fetch;
+}
+declare function createRemoteEditorSyncBackend(options: RemoteEditorSyncBackendOptions): EditorSyncBackend;
+declare function fetchEditorSyncAccess(options: RemoteEditorSyncBackendOptions): Promise<EditorSyncAccess>;
+interface EditorSourceHost {
+  rootUri: string;
+  rootFileName: string;
+  rootDir: string;
+  collectDocuments(extraUris?: readonly string[]): Promise<EditorSyncSourceDocument[]>;
+  applyReplacements(replacements: EditorSyncTextReplacement[], rootUri: string): Promise<string[]>;
+  saveDocuments?(uris: string[]): Promise<void>;
+  watchSavedDocuments?(listener: (uri: string) => void | Promise<void>): {
+    dispose(): void;
+  };
+  getPreserveStatelyMetadata?(uri: string): boolean;
+}
+interface EditorHostSessionOptions {
+  source: EditorSourceHost;
+  sync: EditorSyncBackend;
+  send(message: EditorHostOutboundMessage): void;
+  access?: EditorSyncAccess;
+  apiKey?: string;
+  getTheme?(): 'light' | 'dark';
+  showError?(message: string): void;
+  readClipboard?(): Promise<string>;
+  writeClipboard?(text: string): Promise<void>;
+  init?: EditorHostInitOptions;
+  client?: {
+    name: string;
+    version: string;
+  };
+}
+declare class EditorHostSession {
+  private options;
+  private editorProtocolState;
+  private currentGraph;
+  private lastPersistedGraph;
+  private currentFormat;
+  private currentSourceLocations;
+  private access;
+  private watchedSourceUris;
+  private selfEditCount;
+  private watcher;
+  private retrieveRequestCount;
+  private pendingRetrievals;
+  constructor(options: EditorHostSessionOptions);
+  dispose(): void;
+  notifySavedDocument(uri?: string): Promise<void>;
+  receive(message: EditorHostInboundMessage): Promise<void>;
+  private initialize;
+  private save;
+  private handleSavedDocument;
+  private updateWatchedSourceUris;
+  private getSerializedPayload;
+  private requestSerialized;
+  private resolveRetrieved;
+}
+//#endregion
+export { RemoteEditorSyncBackendOptions as a, EDITOR_PROTOCOL_VERSION as c, EditorHostInitOptions as d, EditorHostOutboundMessage as f, EditorSyncBackend as i, EditorHostExportFormat as l, EditorHostSessionOptions as n, createRemoteEditorSyncBackend as o, EditorHostValidationIssue as p, EditorSourceHost as r, fetchEditorSyncAccess as s, EditorHostSession as t, EditorHostInboundMessage as u };

package/dist/editorHostSession.d.mts

@@ -0,0 +1,2 @@
+import { a as RemoteEditorSyncBackendOptions, c as EDITOR_PROTOCOL_VERSION, d as EditorHostInitOptions, f as EditorHostOutboundMessage, i as EditorSyncBackend, l as EditorHostExportFormat, n as EditorHostSessionOptions, o as createRemoteEditorSyncBackend, p as EditorHostValidationIssue, r as EditorSourceHost, s as fetchEditorSyncAccess, t as EditorHostSession, u as EditorHostInboundMessage } from "./editorHostSession-jnC5mQDN.mjs";
+export { EDITOR_PROTOCOL_VERSION, EditorHostExportFormat, EditorHostInboundMessage, EditorHostInitOptions, EditorHostOutboundMessage, EditorHostSession, EditorHostSessionOptions, EditorHostValidationIssue, EditorSourceHost, EditorSyncBackend, RemoteEditorSyncBackendOptions, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/editorHostSession.mjs

@@ -0,0 +1,4 @@
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
+import { n as createRemoteEditorSyncBackend, r as fetchEditorSyncAccess, t as EditorHostSession } from "./editorHostSession-CZHd22pZ.mjs";
+
+export { EDITOR_PROTOCOL_VERSION, EditorHostSession, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/embed.d.mts

@@ -1,5 +1,5 @@
-import { i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
-import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
+import { i as StatelyGraph } from "./graph-DxeqWHC3.mjs";
+import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
 //#region src/embed.d.ts
@@ -91,4 +91,4 @@ interface StatelyEmbed {
 }
 declare function createStatelyEmbed(options: StatelyEmbedOptions): StatelyEmbed;
 //#endregion
-export { AssetConfig, type CapabilityDeniedEvent, type CommentsConfig, type EditorCapabilities, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type InitOptions, type MachineInitOptions, type MachineSourceLocations, type ProjectEmbedMachine, StatelyEmbed, StatelyEmbedOptions, type UploadResult, createStatelyEmbed };
+export { AssetConfig, type CapabilityDeniedEvent, type CommentsConfig, type EditorCapabilities, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type InitOptions, type MachineInitOptions, type MachineSourceLocations, type ProjectEmbedMachine, StatelyEmbed, StatelyEmbedOptions, type UploadResult, createStatelyEmbed };

package/dist/embed.mjs

@@ -1,4 +1,5 @@
-import { a as toInitMessage, i as createPendingExportManager, r as createEventRegistry, t as createPostMessageTransport } from "./transport-B_ig9Znn.mjs";
+import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-TY9EZF0F.mjs";
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
 
 //#region src/embed.ts
 function buildEmbedUrl(options) {
@@ -10,6 +11,7 @@ function buildEmbedUrl(options) {
 function extractInitOptions(options) {
 	if (options.machines) return {
 		machines: options.machines,
+		documents: options.documents,
 		currentMachineId: options.currentMachineId,
 		mode: options.mode,
 		theme: options.theme,
@@ -22,6 +24,7 @@ function extractInitOptions(options) {
 	};
 	if (options.machine !== void 0) return {
 		machine: options.machine,
+		documents: options.documents,
 		format: options.format,
 		mode: options.mode,
 		theme: options.theme,
@@ -43,6 +46,7 @@ function createStatelyEmbed(options) {
 	let transport = null;
 	let ownedIframe = false;
 	let destroyed = false;
+	let editorProtocolCompatible;
 	const pendingMessages = [];
 	const events = createEventRegistry();
 	const exportManager = createPendingExportManager((message) => send(message));
@@ -54,6 +58,7 @@ function createStatelyEmbed(options) {
 	const assetAccept = options.assets?.accept ?? assetUploadAdapter?.accept;
 	const assetMaxFileSize = options.assets?.maxFileSize ?? assetUploadAdapter?.maxFileSize;
 	function send(msg) {
+		if (editorProtocolCompatible === false) return;
 		if (!transport?.ready) {
 			pendingMessages.push(msg);
 			return;
@@ -61,7 +66,7 @@ function createStatelyEmbed(options) {
 		transport.send(msg);
 	}
 	function flush() {
-		if (!transport) return;
+		if (!transport || editorProtocolCompatible === false) return;
 		while (pendingMessages.length > 0) {
 			const msg = pendingMessages.shift();
 			transport.send(msg);
@@ -72,6 +77,27 @@ function createStatelyEmbed(options) {
 		switch (data.type) {
 			case "@statelyai.ready": {
 				const ready = data;
+				if (ready.protocolVersion !== void 0) {
+					if (ready.protocolVersion !== EDITOR_PROTOCOL_VERSION) {
+						editorProtocolCompatible = false;
+						const error = {
+							code: "unsupported_protocol",
+							message: `Editor protocol ${ready.protocolVersion} is unsupported; this SDK supports ${EDITOR_PROTOCOL_VERSION}.`
+						};
+						options.onError?.(error);
+						events.emit("error", error);
+						break;
+					}
+					editorProtocolCompatible = true;
+					send({
+						type: "@statelyai.handshake",
+						protocolVersion: EDITOR_PROTOCOL_VERSION,
+						client: {
+							name: "@statelyai/sdk",
+							version: SDK_VERSION
+						}
+					});
+				} else editorProtocolCompatible = true;
 				flush();
 				if (uploadAsset) send({
 					type: "@statelyai.uploadCapabilities",
@@ -187,6 +213,7 @@ function createStatelyEmbed(options) {
 	}
 	function replaceTransport(nextTransport) {
 		transport?.destroy();
+		editorProtocolCompatible = void 0;
 		transport = nextTransport;
 	}
 	function setupTransport(el) {
@@ -196,7 +223,10 @@ function createStatelyEmbed(options) {
 		});
 		replaceTransport(nextTransport);
 		nextTransport.onMessage(handleMessage);
-		nextTransport.onReady(flush);
+		nextTransport.onReady(() => {
+			editorProtocolCompatible ??= true;
+			flush();
+		});
 	}
 	const embed = {
 		attach(el) {

package/dist/{graph-DuOeLGvh.d.mts → graph-DxeqWHC3.d.mts}

@@ -1,4 +1,4 @@
-import { r as CodeExpression } from "./index-ag6K2iAS.mjs";
+import { r as CodeExpression } from "./index-CKFbG_Ix.mjs";
 import * as _statelyai_graph0 from "@statelyai/graph";
 import { Graph } from "@statelyai/graph";
 

package/dist/graph.d.mts

@@ -1,2 +1,2 @@
-import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-DuOeLGvh.mjs";
+import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-DxeqWHC3.mjs";
 export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };

package/dist/index.d.mts

@@ -1,12 +1,13 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { _ as serializeJS, c as MachineConfigOptions, d as contextSchemaToTSType, f as eventsSchemaToTSType, g as raw, h as jsonSchemaToTSType, i as CodeGenGraph, l as RawCode, m as graphToXStateTS, o as GraphPatch, p as graphToMachineConfig, t as ActionLocation, u as XStateTSOptions } from "./index-ag6K2iAS.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-DuOeLGvh.mjs";
-import { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitOptions, InspectionAction, InspectionSentEvent, InspectionTakenTransition, ProjectEmbedMachine, UploadResult, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
+import { _ as serializeJS, c as MachineConfigOptions, d as contextSchemaToTSType, f as eventsSchemaToTSType, g as raw, h as jsonSchemaToTSType, i as CodeGenGraph, l as RawCode, m as graphToXStateTS, o as GraphPatch, p as graphToMachineConfig, t as ActionLocation, u as XStateTSOptions } from "./index-CKFbG_Ix.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-DxeqWHC3.mjs";
+import { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitOptions, InspectionAction, InspectionSentEvent, InspectionTakenTransition, ProjectEmbedMachine, UploadResult, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.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-2Thaw42j.mjs";
+import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-B0ZTKri2.mjs";
+import { a as RemoteEditorSyncBackendOptions, c as EDITOR_PROTOCOL_VERSION, d as EditorHostInitOptions, f as EditorHostOutboundMessage, i as EditorSyncBackend, l as EditorHostExportFormat, n as EditorHostSessionOptions, o as createRemoteEditorSyncBackend, p as EditorHostValidationIssue, r as EditorSourceHost, s as fetchEditorSyncAccess, t as EditorHostSession, u as EditorHostInboundMessage } from "./editorHostSession-jnC5mQDN.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, h as createWebSocketTransport, i as InspectedSnapshot, l as ManualActorOptions, m as createPostMessageTransport, n as CreateInspectorOptions, o as Inspector, p as TransportFailure, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-BZFzyeew.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-Bk_u41gu.mjs";
+import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, h as createWebSocketTransport, i as InspectedSnapshot, l as ManualActorOptions, m as createPostMessageTransport, n as CreateInspectorOptions, o as Inspector, p as TransportFailure, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-CGJR4iZK.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-DLduJRSp.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";
 import { CreateInspectionRelayOptions, InspectionRelay, InspectionRelayEffect, InspectionRelayPeer, InspectionRelayRole, InspectionRelaySnapshot, createInspectionRelay } from "./relay.mjs";
@@ -32,4 +33,4 @@ declare function findStatelyPragmaAttachments(sourceText: string, fileName?: str
 declare function getStatelyPragma(sourceText: string, fileName?: string, machineIndex?: number): StatelyPragma | undefined;
 declare function upsertStatelyPragma(sourceText: string, id: string, options?: UpsertStatelyPragmaOptions): string;
 //#endregion
-export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CapabilityDeniedCapability, type CapabilityDeniedEvent, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectionRelayOptions, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type CreateS3AssetUploadAdapterOptions, type CreateSupabaseAssetUploadAdapterOptions, DEFAULT_STATELY_BASE_URL, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EditorCapabilities, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesInput, type ExtractMachinesResponse, type ExtractedMachine, type ExtractedMachines, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, type InitOptions, type InspectedEvent, type InspectedSnapshot, type InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorEvents, type InspectorInspectionEvent, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineConfigOptions, type MachineVersion, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateTSOptions, type XStateVersion, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CapabilityDeniedCapability, type CapabilityDeniedEvent, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectionRelayOptions, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type CreateS3AssetUploadAdapterOptions, type CreateSupabaseAssetUploadAdapterOptions, DEFAULT_STATELY_BASE_URL, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, type EditorCapabilities, type EditorHostExportFormat, type EditorHostInboundMessage, type EditorHostInitOptions, type EditorHostOutboundMessage, EditorHostSession, type EditorHostSessionOptions, type EditorHostValidationIssue, type EditorSourceHost, type EditorSyncBackend, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesInput, type ExtractMachinesResponse, type ExtractedMachine, type ExtractedMachines, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, type InitOptions, type InspectedEvent, type InspectedSnapshot, type InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorEvents, type InspectorInspectionEvent, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineConfigOptions, type MachineVersion, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RemoteEditorSyncBackendOptions, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateTSOptions, type XStateVersion, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/index.mjs

@@ -1,14 +1,16 @@
-import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-B_ig9Znn.mjs";
-import { INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
+import { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-TY9EZF0F.mjs";
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
+import { n as createRemoteEditorSyncBackend, r as fetchEditorSyncAccess, t as EditorHostSession } from "./editorHostSession-CZHd22pZ.mjs";
+import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-EKd7cQN7.mjs";
+import { a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, f as raw, l as graphToMachineConfig, n as getStatelyPragma, o as contextSchemaToTSType, p as serializeJS, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-GN-bfuC_.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-CF_6aEnv.mjs";
-import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-txdyJHD7.mjs";
-import { a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, f as raw, l as graphToMachineConfig, n as getStatelyPragma, o as contextSchemaToTSType, p as serializeJS, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-Th0gdXfx.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-CWwLGwLq.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";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 import { createInspectionRelay } from "./relay.mjs";
 
-export { DEFAULT_STATELY_BASE_URL, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { DEFAULT_STATELY_BASE_URL, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorHostSession, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/{inspect-BZFzyeew.d.mts → inspect-CGJR4iZK.d.mts}

@@ -62,7 +62,7 @@ interface InspectorInspectionEvent {
   readonly actorRef: unknown;
 }
 interface AdoptedActor {
-  /** XState process-local `actor.sessionId`. Pair with inspector.producerId. */
+  /** Producer-local session id; defaults to XState's `actor.sessionId`. */
   sessionId: string;
   /** System-local `actor.id`. */
   actorId: string;
@@ -137,7 +137,10 @@ interface CreateInspectorOptions {
   url?: string;
   /** Unguessable inspection room capability. Defaults to a random UUID. */
   roomId?: string;
-  /** Stable identity for this producer connection. Defaults to a random UUID. */
+  /**
+   * Stable identity for this producer across reconnects and restored Inspector
+   * instances. Defaults to a random UUID.
+   */
   producerId?: string;
   /**
    * Inspector UI base URL when hosted separately from the WebSocket relay. The
@@ -172,6 +175,13 @@ interface CreateInspectorOptions {
    * @deprecated Use {@link extractMachine}; it also accepts source strings.
    */
   extractMachineConfig?: (actor: any, source?: unknown) => unknown;
+  /**
+   * 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.
+   */
+  resolveSessionId?: (actor: any, defaultSessionId: string) => string;
   /** Selected actor session id to focus on first. */
   selectedSessionId?: string;
   /** @deprecated Use {@link selectedSessionId}. */
@@ -193,7 +203,7 @@ interface CreateInspectorOptions {
   transport?: Transport;
 }
 interface Inspector {
-  /** Snapshot of this producer's actors keyed by XState `sessionId`. */
+  /** Snapshot of this producer's actors keyed by resolved `sessionId`. */
   readonly actors: ReadonlyMap<string, AdoptedActor>;
   /** Unguessable inspection room capability. */
   readonly roomId: string;

package/dist/{inspect-CF_6aEnv.mjs → inspect-CWwLGwLq.mjs}

@@ -1,5 +1,5 @@
-import { i as createPendingExportManager, n as createWebSocketTransport, r as createEventRegistry } from "./transport-B_ig9Znn.mjs";
 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-TY9EZF0F.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
@@ -26,15 +26,6 @@ async function openBrowser(url) {
 	});
 }
 
-//#endregion
-//#region src/version.ts
-const SDK_VERSION = "0.17.0";
-function inspectionRuntime() {
-	if (typeof window !== "undefined") return "browser";
-	if (typeof process !== "undefined" && process.versions?.node) return "node";
-	return "unknown";
-}
-
 //#endregion
 //#region src/inspect.ts
 const defaultSerializeSnapshot = (snapshot) => ({
@@ -174,11 +165,29 @@ function createInspector(options = {}) {
 		for (const handler of set) handler(data);
 	}
 	const actors = /* @__PURE__ */ new Map();
+	const resolvedSessionIds = /* @__PURE__ */ new WeakMap();
+	const actorsByResolvedSessionId = /* @__PURE__ */ new Map();
 	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) {
+		const existing = resolvedSessionIds.get(actorRef);
+		if (existing) return existing;
+		const resolved = options.resolveSessionId?.(actorRef, actorRef.sessionId) ?? actorRef.sessionId;
+		if (typeof resolved !== "string" || resolved.length === 0) throw new Error("createInspector(): resolveSessionId must return a non-empty string.");
+		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}".`);
+		resolvedSessionIds.set(actorRef, resolved);
+		actorsByResolvedSessionId.set(resolved, actorRef);
+		return resolved;
+	}
+	function rootSessionIdOf(runtimeRootId, actorRef) {
+		let rootRef = actorRef;
+		while (rootRef._parent) rootRef = rootRef._parent;
+		return rootRef.sessionId === runtimeRootId ? sessionIdOf(rootRef) : runtimeRootId;
+	}
 	function emitRegisterOnce(entry) {
 		if (locallyRegistered.has(entry.sessionId)) return;
 		locallyRegistered.add(entry.sessionId);
@@ -200,10 +209,12 @@ function createInspector(options = {}) {
 		}
 	}
 	function toEntry(actorRef, rootActorId, details) {
+		const sessionId = sessionIdOf(actorRef);
+		const parentRef = details?.parentRef ?? actorRef._parent;
 		return {
-			sessionId: actorRef.sessionId,
-			actorId: details?.id ?? actorRef.id ?? actorRef.sessionId,
-			parentSessionId: details?.parentRef?.sessionId ?? actorRef._parent?.sessionId ?? null,
+			sessionId,
+			actorId: details?.id ?? actorRef.id ?? sessionId,
+			parentSessionId: parentRef ? sessionIdOf(parentRef) : null,
 			rootSessionId: rootActorId,
 			systemId: actorRef.systemId,
 			snapshot: details?.snapshot ? serializeSnapshot(details.snapshot) : snapshotValue(actorRef),
@@ -221,12 +232,17 @@ 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);
+	}
 	/**
 	* 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(actorRef.sessionId);
+		const existing = actors.get(sessionIdOf(actorRef));
 		const entry = existing ?? toEntry(actorRef, rootActorId);
 		if (existing) {
 			const snapshot = actorRef.getSnapshot();
@@ -260,7 +276,7 @@ function createInspector(options = {}) {
 		initSent = true;
 	}
 	function handleActor(actorRef, rootActorId, details) {
-		if (actors.has(actorRef.sessionId)) return;
+		if (actors.has(sessionIdOf(actorRef))) return;
 		const entry = toEntry(actorRef, rootActorId, details);
 		actors.set(entry.sessionId, entry);
 		emitRegisterOnce(entry);
@@ -293,7 +309,7 @@ function createInspector(options = {}) {
 	}
 	function normalizeSentEvent(sentEvent) {
 		return {
-			...sentEvent.targetRef?.sessionId && { targetSessionId: sentEvent.targetRef.sessionId },
+			...sentEvent.targetRef?.sessionId && { targetSessionId: sessionIdOf(sentEvent.targetRef) },
 			targetId: sentEvent.targetId,
 			event: sentEvent.event,
 			...sentEvent.delay !== void 0 && { delay: sentEvent.delay },
@@ -301,10 +317,11 @@ function createInspector(options = {}) {
 		};
 	}
 	function createPendingTransition(actorRef, event = null, sourceRef) {
+		const sessionId = sessionIdOf(actorRef);
 		return {
-			previousSnapshot: actors.get(actorRef.sessionId)?.snapshot ?? null,
+			previousSnapshot: actors.get(sessionId)?.snapshot ?? null,
 			event,
-			sourceSessionId: sourceRef?.sessionId ?? null,
+			sourceSessionId: sourceRef ? sessionIdOf(sourceRef) : null,
 			actions: [],
 			transitions: [],
 			sent: []
@@ -325,15 +342,17 @@ function createInspector(options = {}) {
 		emitLocal("event", inspectedEvent);
 	}
 	function getPendingTransition(actorRef, event) {
-		const existing = pendingTransitions.get(actorRef.sessionId);
+		const sessionId = sessionIdOf(actorRef);
+		const existing = pendingTransitions.get(sessionId);
 		if (existing) return existing;
 		const pending = createPendingTransition(actorRef, event);
-		pendingTransitions.set(actorRef.sessionId, pending);
+		pendingTransitions.set(sessionId, pending);
 		return pending;
 	}
 	function handleTransition(actorRef, snapshot, triggeringEvent, rootActorId, transition) {
-		if (!actors.has(actorRef.sessionId)) handleActor(actorRef, rootActorId);
-		const entry = actors.get(actorRef.sessionId);
+		const sessionId = sessionIdOf(actorRef);
+		if (!actors.has(sessionId)) handleActor(actorRef, rootActorId);
+		const entry = actors.get(sessionId);
 		if (!entry) return;
 		const serialized = serializeSnapshot(snapshot);
 		const inspectedSnapshot = {
@@ -378,7 +397,7 @@ function createInspector(options = {}) {
 	function handleInspectionEvent(inspectionEvent) {
 		if (destroyed) return;
 		const event = inspectionEvent;
-		const rootActorId = event.rootId;
+		const rootActorId = rootSessionIdOf(event.rootId, event.actorRef);
 		const isNewRoot = !observedRootIds.has(rootActorId);
 		observedRootIds.add(rootActorId);
 		switch (event.type) {
@@ -390,11 +409,13 @@ function createInspector(options = {}) {
 					snapshot: event.snapshot
 				});
 				break;
-			case "@xstate.event":
-				if (!actors.has(event.actorRef.sessionId)) handleActor(event.actorRef, rootActorId);
-				handleEvent(event.actorRef.sessionId, event.event, event.sourceRef?.sessionId ?? null);
-				pendingTransitions.set(event.actorRef.sessionId, createPendingTransition(event.actorRef, event.event, event.sourceRef));
+			case "@xstate.event": {
+				const sessionId = sessionIdOf(event.actorRef);
+				if (!actors.has(sessionId)) handleActor(event.actorRef, rootActorId);
+				handleEvent(sessionId, event.event, event.sourceRef ? sessionIdOf(event.sourceRef) : null);
+				pendingTransitions.set(sessionId, createPendingTransition(event.actorRef, event.event, event.sourceRef));
 				break;
+			}
 			case "@xstate.action":
 				getPendingTransition(event.actorRef).actions.push(normalizeAction(event.action));
 				break;
@@ -409,9 +430,9 @@ function createInspector(options = {}) {
 			case "@xstate.transition":
 				if (!event.actions || !event.microsteps || !event.sent) break;
 				handleTransition(event.actorRef, event.snapshot, event.event, rootActorId, {
-					previousSnapshot: actors.get(event.actorRef.sessionId)?.snapshot ?? null,
+					previousSnapshot: actors.get(sessionIdOf(event.actorRef))?.snapshot ?? null,
 					event: event.event,
-					sourceSessionId: event.sourceRef?.sessionId ?? null,
+					sourceSessionId: event.sourceRef ? sessionIdOf(event.sourceRef) : null,
 					actions: event.actions.map(normalizeAction),
 					transitions: event.microsteps.map(normalizeTakenTransition),
 					sent: event.sent.map(normalizeSentEvent)
@@ -423,9 +444,10 @@ function createInspector(options = {}) {
 	}
 	function attachActor(actor) {
 		const root = actor;
-		const rootActorId = root.sessionId;
+		const rootActorId = sessionIdOf(root);
 		const existing = inspectedRoots.get(rootActorId);
 		if (existing) return existing.subscription;
+		resolveActorTreeSessionIds(root);
 		observedRootIds.add(rootActorId);
 		const subscription = root.system.inspect(handleInspectionEvent);
 		inspectedRoots.set(rootActorId, {
@@ -443,8 +465,12 @@ function createInspector(options = {}) {
 		return manualSessionIds.get(actorId) ?? `${producerId}:${actorId}`;
 	}
 	function manualRegister(id, opts) {
+		const existingManualSessionId = manualSessionIds.get(id);
 		const sessionId = getManualSessionId(id);
-		if (actors.has(sessionId)) return;
+		if (actors.has(sessionId)) {
+			if (existingManualSessionId === sessionId) return;
+			throw new Error(`createInspector(): manual actor session id "${sessionId}" conflicts with a resolved actor session id.`);
+		}
 		manualSessionIds.set(id, sessionId);
 		const parentSessionId = opts?.parent ? getManualSessionId(opts.parent) : null;
 		const entry = {
@@ -565,6 +591,7 @@ function createInspector(options = {}) {
 			exportManager.clear("Inspector destroyed");
 			events.clear();
 			actors.clear();
+			actorsByResolvedSessionId.clear();
 			inspectedRoots.clear();
 			observedRootIds.clear();
 			pendingTransitions.clear();