@statelyai/sdk 0.34.0 → 0.34.2

package/README.md

@@ -223,6 +223,12 @@ Resource operations always require a credential.
 Stream live actor-system state to the hosted Stately inspector. Zero-config
 inspection needs no API key or local relay.
 
+For an app that only needs actor inspection, install
+[`@statelyai/inspector`](../inspector) instead. It provides the same
+`createInspector` API without installing the SDK's source-sync, graph, and Node
+relay dependencies. In the examples below, import from `@statelyai/inspector`
+when using that package.
+
 `selectedSessionId` takes the exact session id: `actor.sessionId` for runtime
 actors (or your `resolveSessionId` result), and `${producerId}:${id}` for manual
 actors. For example, with `producerId: 'demo'`, select `inspector.actor('root')`
@@ -236,9 +242,14 @@ const inspector = createInspector();
 const { inspect } = inspector;
 
 const actor = createActor(machine, { inspect });
+// With XState v6, the inspector shows this actor's graph before start().
 actor.start();
 ```
 
+Before `start()`, the XState v6 actor view has no active-state highlight. The
+first runtime transition updates that same actor view. An initial error is
+shown immediately, even if `start()` produces no transition.
+
 The inspector also accepts read-only `documents`, panel configuration, initial
 `viewMode`, and typed display `settings`. Use `selectActor(sessionId)`,
 `setTheme(theme)`, `setViewMode(mode)`, and `setSettings(settings)` to control the
@@ -278,6 +289,12 @@ original IDs. Hover an actor label in the viewer to see its runtime ID.
 Actors without a machine state value show their snapshot status (Active, Done,
 Error, or Stopped); “Awaiting snapshot” means no snapshot has arrived.
 
+<!-- default snapshot serialization from packages/sdk/src/inspect.ts -->
+
+The default snapshot serializer includes state value, status, and active tags
+when the runtime supplies them. Custom serializers should preserve `tags` as
+a string array to show them in actor details.
+
 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 after
@@ -301,7 +318,12 @@ 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.
+must be unique along each parent-child path. Sibling actors may reuse one id
+after its previous owner reaches `done`, `stopped`, or `error`; setting
+`sessionIdReuse: "always"` also permits explicit replacement of an active
+sibling. The displaced actor's later observations are ignored. Inspector
+callback errors emit `on('error', ...)` with code `inspection_failed` and do not
+interrupt the actor system.
 
 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
@@ -326,6 +348,9 @@ keep it private. Hosted replay expires after 24
 hours without activity. Only actor checkpoints and observations are replayed;
 export traffic is live-only, and auth/upload/embed-control messages are rejected.
 AI-backed features remain separately authenticated.
+The relay keeps a complete current actor checkpoint while bounding recent
+observation history, so joining after many actor registrations still initializes
+the viewer.
 
 After successful registration, hosted Sky records coarse connection analytics:
 role, normalized browser origin or `unknown`, localhost status, runtime,
@@ -393,10 +418,14 @@ regeneration when the source cannot be reconciled safely.
 <!-- graph conversion and codegen exports from src/graph.ts and src/index.ts -->
 
 Convert between Studio graph data, XState machine configs, and TypeScript
-source with `graphToXStateTS`. Use `graphToXStateFSM` for a flat `createFSM`
-projection and `getXStateFSMCompatibilityIssues` before exporting to report
-semantics that the compact FSM cannot represent. Generate types from JSON
-Schema.
+source with `graphToXStateTS`. `graphToXStateTSResult` also reports code leaves
+that a profile replaced to keep an export syntactically valid;
+`getProfileCodeIssues` inspects them without exporting, and
+`recoverInvalidProfileCode` applies the profile's exact fallback functions to a
+copy. Source-location documents retain authored code instead of applying these
+export-only stubs. Use `graphToXStateFSM` for a flat `createFSM` projection and
+`getXStateFSMCompatibilityIssues` before exporting to report semantics that the
+compact FSM cannot represent. Generate types from JSON Schema.
 
 ## Support
 

package/dist/assetStorage.d.mts

@@ -1,4 +1,4 @@
-import { Gt as UploadResult } from "./protocol-AeHm956D.mjs";
+import { Gt as UploadResult } from "./protocol-CCf9j_SZ.mjs";
 
 //#region src/assetStorage.d.ts
 interface AssetUploadContext {

package/dist/{dist-NJFkDQjK.mjs → dist-DsOTTfYv.mjs}

@@ -3832,12 +3832,18 @@ function actionCodeExpression(expr, source) {
 		}]
 	};
 }
-function inlineCodeExpression$1(expr) {
-	return {
+function inlineCodeExpression$1(expr, sourceValue) {
+	const result = {
 		"@type": "code",
 		lang: "ts",
 		expr: stripExportDefault(expr)
 	};
+	const sourceId = sourceValue?.__stately_source_id__;
+	if (sourceId !== void 0) Object.defineProperty(result, "__stately_source_id__", {
+		value: sourceId,
+		enumerable: true
+	});
+	return result;
 }
 /**
 * Serialize an edge guard for a machine config. Codegen emits inline guards as
@@ -3850,7 +3856,7 @@ function serializeGuard(guard, asTypeRef) {
 		type: guard.type,
 		params: guard.params
 	} : { type: guard.type };
-	return guard.code ? inlineCodeExpression$1(guard.code) : guard;
+	return guard.code ? inlineCodeExpression$1(guard.code, guard) : guard;
 }
 /**
 * Converts a built-in xstate ActionItem to a code expression directive,
@@ -3862,13 +3868,13 @@ function serializeActionItem(action, keepChooseStructured = false) {
 		type,
 		params
 	};
-	if (type === "xstate.enqueue" && typeof params?.code === "string") return inlineCodeExpression$1(params.code);
+	if (type === "xstate.enqueue" && typeof params?.code === "string") return inlineCodeExpression$1(params.code, action);
 	const exprCode = type === "xstate.expr" && typeof params?.code === "string" ? params.code : void 0;
 	if (isBuiltInActionType(type)) {
 		const builtInAction = XSTATE_BUILT_IN_ACTIONS[type];
 		return actionCodeExpression(emitBuiltInAction(type, params), builtInAction);
 	}
-	if (exprCode) return inlineCodeExpression$1(exprCode);
+	if (exprCode) return inlineCodeExpression$1(exprCode, action);
 	if (!params || Object.keys(params).length === 0) return { type };
 	return {
 		type,
@@ -4310,6 +4316,135 @@ const XSTATE_AUTHORING = {
 	supportsTargetlessEdges: true,
 	supportsReenterEdges: true
 };
+function hasNoParseErrors(source) {
+	return (ts.createSourceFile("profile-code.ts", source, ts.ScriptTarget.Latest, false, ts.ScriptKind.TS).parseDiagnostics?.length ?? 0) === 0;
+}
+function isExpression(code) {
+	return code.trim().length > 0 && hasNoParseErrors(`(${code})`);
+}
+function isImplementation(code) {
+	return isExpression(stripExportDefault(code)) || hasNoParseErrors(`function implementation() {\n${code}\n}`);
+}
+function isAsyncImplementation(code) {
+	return isExpression(stripExportDefault(code)) || hasNoParseErrors(`async function implementation() {\n${code}\n}`);
+}
+function pathEndsWith(location, suffix) {
+	return suffix.every((segment, index) => location.path[location.path.length - suffix.length + index] === segment);
+}
+function commented(code) {
+	return code.replace(/\r\n?|\u2028|\u2029/g, "\n").split("\n").map((line) => `// ${line}`).join("\n");
+}
+function indent(code, spaces) {
+	const prefix = " ".repeat(spaces);
+	return code.split("\n").map((line) => `${prefix}${line}`).join("\n");
+}
+function indentAfterFirstLine(code, spaces) {
+	const [first = "", ...rest] = code.split("\n");
+	if (rest.length === 0) return first;
+	return `${first}\n${indent(rest.join("\n"), spaces)}`;
+}
+const throwingBody = (invalidCode) => `// FIXME(stately): authored code does not compile\n${commented(invalidCode)}\nthrow new Error('Invalid authored code');`;
+const falseBody = (invalidCode) => `// FIXME(stately): authored code does not compile\n${commented(invalidCode)}\nreturn false;`;
+const throwingExpression = (invalidCode) => `(() => {\n${indent(throwingBody(invalidCode), 2)}\n})()`;
+const functionThrowingExpression = (invalidCode) => `() => {\n${indent(throwingBody(invalidCode), 2)}\n}`;
+const functionFalseExpression = (invalidCode) => `() => {\n${indent(falseBody(invalidCode), 2)}\n}`;
+const throwingImplementationBody = (invalidCode) => indentAfterFirstLine(throwingBody(invalidCode), 2);
+const falseImplementationBody = (invalidCode) => indentAfterFirstLine(falseBody(invalidCode), 2);
+function implementationTarget(location, collection) {
+	const index = location.path[3];
+	const implementations = location.graph.data.implementations?.[collection];
+	const implementation = typeof index === "number" ? implementations?.[index] : void 0;
+	if (!implementation?.id) return void 0;
+	return {
+		kind: "source",
+		sourceType: collection === "actors" ? "actor" : collection.slice(0, -1),
+		id: implementation.id,
+		label: implementation.name || implementation.id
+	};
+}
+function entityTarget(location) {
+	const [collection, index] = location.path;
+	const isNode = collection === "nodes" && typeof index === "number";
+	const isEdge = collection === "edges" && typeof index === "number";
+	const owner = isNode ? location.graph.nodes[index] : isEdge ? location.graph.edges[index] : void 0;
+	if (!owner) return void 0;
+	const dataOffset = location.path.indexOf("data");
+	const field = location.path[dataOffset + 1];
+	const itemIndex = location.path[dataOffset + 2];
+	if ((field === "entry" || field === "exit" || field === "actions") && typeof itemIndex === "number") {
+		const action = owner.data[field]?.[itemIndex];
+		if (action?.id) return {
+			kind: "entity",
+			id: `action:${action.id}`,
+			label: action.type ? `Action: ${action.type}` : "Action"
+		};
+	}
+	if (field === "invokes" && typeof itemIndex === "number") {
+		const invoke = owner.data.invokes?.[itemIndex];
+		if (invoke?.id) return {
+			kind: "entity",
+			id: `invoke:${invoke.id}`,
+			label: invoke.src ? `Invoke: ${invoke.src}` : "Invoke"
+		};
+	}
+	if (isEdge && field === "guard") return {
+		kind: "entity",
+		id: `guard:${owner.id}`,
+		label: "Guard"
+	};
+	if (isEdge && field === "context") return {
+		kind: "entity",
+		id: `context:${owner.id}`,
+		label: "Context"
+	};
+	if (field === "meta") return {
+		kind: "entity",
+		id: `meta:${owner.id}`,
+		label: "Meta"
+	};
+}
+const implementationBlock = (name, collection, exportInvalid, isValid = isImplementation) => ({
+	name,
+	matches: ({ path }) => path.length === 6 && path[0] === "data" && path[1] === "implementations" && path[2] === collection && typeof path[3] === "number" && path[4] === "code" && path[5] === "body",
+	isValid,
+	exportInvalid,
+	getTarget: (location) => implementationTarget(location, collection)
+});
+const XSTATE_CODE_BLOCKS = [
+	implementationBlock("action implementation", "actions", throwingImplementationBody),
+	implementationBlock("guard implementation", "guards", falseImplementationBody),
+	implementationBlock("actor implementation", "actors", throwingImplementationBody, isAsyncImplementation),
+	implementationBlock("delay implementation", "delays", throwingImplementationBody),
+	{
+		name: "inline guard",
+		matches: (location) => pathEndsWith(location, ["guard", "code"]),
+		isValid: isExpression,
+		exportInvalid: functionFalseExpression,
+		getTarget: entityTarget
+	},
+	{
+		name: "inline action",
+		matches: (location) => {
+			if (!pathEndsWith(location, ["params", "code"])) return false;
+			const owner = location.ancestors.at(-2);
+			return !!owner && typeof owner === "object" && owner.type === "xstate.expr";
+		},
+		isValid: isExpression,
+		exportInvalid: functionThrowingExpression,
+		getTarget: entityTarget,
+		getSourceValue: (location) => {
+			const owner = location.ancestors.at(-2);
+			return owner && typeof owner === "object" ? owner : void 0;
+		}
+	},
+	{
+		name: "code expression",
+		matches: (location) => pathEndsWith(location, ["expr"]) && !!location.parent && typeof location.parent === "object" && location.parent["@type"] === "code",
+		isValid: isExpression,
+		exportInvalid: throwingExpression,
+		getTarget: entityTarget
+	}
+];
 const XSTATE_PROFILE_MANIFESTS = [{
 	profile: XSTATE_V5_PROFILE,
 	namespace: "@statelyai.xstate",
@@ -4318,6 +4453,7 @@ const XSTATE_PROFILE_MANIFESTS = [{
 	name: "XState v5",
 	formats: [...XSTATE_FORMATS],
 	authoring: XSTATE_AUTHORING,
+	code: { blocks: XSTATE_CODE_BLOCKS },
 	operations: {
 		simulate: true,
 		validate: true,
@@ -4331,6 +4467,7 @@ const XSTATE_PROFILE_MANIFESTS = [{
 	name: "XState v6 alpha",
 	formats: [...XSTATE_FORMATS],
 	authoring: XSTATE_AUTHORING,
+	code: { blocks: XSTATE_CODE_BLOCKS },
 	operations: {
 		simulate: true,
 		validate: true,
@@ -5924,6 +6061,78 @@ function extractXStateMachineConfigEntries(source, options = {}) {
 	visit(file);
 	return found;
 }
+function getProfileCodeIssues(graph, profile) {
+	return visitProfileCode(graph, profile).issues;
+}
+function recoverInvalidProfileCode(graph, profile) {
+	const result = visitProfileCode(graph, profile, true);
+	return {
+		graph: result.value,
+		issues: result.issues
+	};
+}
+function visitProfileCode(graph, profile, recover = false) {
+	const blocks = profile?.code?.blocks ?? [];
+	const issues = [];
+	const occurrences = [];
+	const visit = (value, path, ancestors) => {
+		const parent = ancestors.at(-1);
+		if (typeof value === "string") {
+			const location = {
+				graph,
+				path,
+				parent,
+				ancestors
+			};
+			const block = blocks.find((candidate) => candidate.matches(location));
+			if (!block) return value;
+			const issue = toIssue(graph, block, location, value);
+			const valid = block.isValid(value);
+			occurrences.push({
+				...issue,
+				sourceValue: block.getSourceValue?.(location) ?? (parent && typeof parent === "object" ? parent : void 0),
+				valid
+			});
+			if (valid) return value;
+			issues.push(issue);
+			return recover ? block.exportInvalid(value) : value;
+		}
+		if (!value || typeof value !== "object") return value;
+		if (!recover) {
+			for (const key of Reflect.ownKeys(value)) {
+				if (typeof key === "symbol") continue;
+				visit(value[key], [...path, Array.isArray(value) ? Number(key) : String(key)], [...ancestors, value]);
+			}
+			return value;
+		}
+		const clone = Array.isArray(value) ? [] : {};
+		for (const key of Reflect.ownKeys(value)) {
+			const descriptor = Object.getOwnPropertyDescriptor(value, key);
+			if (!descriptor) continue;
+			if ("value" in descriptor && typeof key !== "symbol") descriptor.value = visit(descriptor.value, [...path, Array.isArray(value) ? Number(key) : String(key)], [...ancestors, value]);
+			Object.defineProperty(clone, key, descriptor);
+		}
+		return clone;
+	};
+	return {
+		value: visit(graph, [], []),
+		issues,
+		occurrences
+	};
+}
+function toIssue(graph, block, location, invalidCode) {
+	const { path } = location;
+	const nodeIndex = path[0] === "nodes" ? path[1] : void 0;
+	const edgeIndex = path[0] === "edges" ? path[1] : void 0;
+	return {
+		block: block.name,
+		path,
+		invalidCode,
+		nodeIds: typeof nodeIndex === "number" && graph.nodes[nodeIndex] ? [graph.nodes[nodeIndex].id] : [],
+		edgeIds: typeof edgeIndex === "number" && graph.edges[edgeIndex] ? [graph.edges[edgeIndex].id] : [],
+		target: block.getTarget?.(location)
+	};
+}
 function jsonSchemaToTSType(schema) {
 	if (!schema) return "unknown";
 	if (schema.enum) return schema.enum.map((v) => typeof v === "string" ? `'${v}'` : String(v)).join(" | ");
@@ -6127,8 +6336,19 @@ function isRequiredProperty(key, definition, required) {
 	return typeof definition === "object" && definition !== null && definition.required === true;
 }
 function graphToXStateTS(graph, options = {}) {
-	const inferredXStateVersion = isXStateV6ProfileRef(graph.data.profile ?? "xstate-v5") ? 6 : 5;
-	const { exportStyle = "named", targetLanguage = "typescript", xstateVersion = inferredXStateVersion, xstateV6SchemaFormat = "types", ...configOptions } = options;
+	return graphToXStateTSResult(graph, options).source;
+}
+function graphToXStateTSResult(inputGraph, options = {}) {
+	const inferredXStateVersion = isXStateV6ProfileRef(inputGraph.data.profile ?? "xstate-v5") ? 6 : 5;
+	const { exportStyle = "named", targetLanguage = "typescript", xstateVersion = inferredXStateVersion, xstateV6SchemaFormat = "types", profile: profileOverride, recoverInvalidCode = true, ...configOptions } = options;
+	const graphProfile = getProfileManifest(normalizeProfileRef(inputGraph.data.profile ?? "xstate-v5"));
+	const profile = profileOverride ?? graphProfile ?? getProfileManifest(xstateVersion === 6 ? XSTATE_V6_PROFILE : XSTATE_V5_PROFILE);
+	const profileGraph = inputGraph;
+	const recovered = recoverInvalidCode ? recoverInvalidProfileCode(profileGraph, profile) : {
+		graph: profileGraph,
+		issues: getProfileCodeIssues(profileGraph, profile)
+	};
+	const graph = recovered.graph;
 	const schemas = graph.data.schemas;
 	const impls = filterInlineImplementations$1(graph.data.implementations);
 	const supportsTypeSyntax = targetLanguage === "typescript";
@@ -6188,7 +6408,14 @@ function graphToXStateTS(graph, options = {}) {
 		lines.push("");
 		lines.push("export default machine;");
 	}
-	return lines.join("\n") + "\n";
+	return {
+		source: lines.join("\n") + "\n",
+		diagnostics: recovered.issues
+	};
+}
+function markDiagnosticSource(value, code) {
+	const id = value && typeof value === "object" ? value[SERIALIZED_SOURCE_ID] : void 0;
+	return id === void 0 ? code : `/*__stately_diagnostic_${id}_start__*/${code}/*__stately_diagnostic_${id}_end__*/`;
 }
 function stripStateSchemas(config) {
 	delete config.schemas;
@@ -6375,13 +6602,13 @@ function guardCondition(value) {
 	if (arrow < 0) return null;
 	const params = expression.slice(0, arrow).trim();
 	const body = expression.slice(arrow + 2).trim();
-	const callCondition = `(${expression})({ context, event, input, output, actions, guards, children, self, system })`;
+	const callCondition = `(${markDiagnosticSource(value, expression)})({ context, event, input, output, actions, guards, children, self, system })`;
 	if (body.startsWith("{")) return {
 		condition: callCondition,
 		callCondition
 	};
 	return {
-		condition: body,
+		condition: markDiagnosticSource(value, body),
 		callCondition,
 		firstParam: params.startsWith("(") && params.endsWith(")") ? params.slice(1, -1).trim() : params
 	};
@@ -6555,7 +6782,7 @@ function buildV6TransitionFunction(transitions) {
 function toV6ActionField(actions) {
 	if (actions.length === 1) {
 		const expr = inlineExpr(actions[0]);
-		if (expr && isCompleteFunctionExpression(stripExportDefault(expr))) return raw(stripExportDefault(expr));
+		if (expr && isCompleteFunctionExpression(stripExportDefault(expr))) return raw(stripExportDefault(expr), actions[0] && typeof actions[0] === "object" ? actions[0] : void 0);
 	}
 	return buildV6ActionFunction(actions) ?? actions;
 }
@@ -6654,14 +6881,14 @@ function actionToV6Effect(action) {
 	const expr = inlineExpr(action);
 	if (expr) {
 		const assignment = getV6AssignmentContextValue(expr);
-		if (assignment) return { contextValue: assignment };
-		if (expr.startsWith("enq(") || expr.startsWith("enq.")) return { statements: [expr] };
+		if (assignment) return { contextValue: markDiagnosticSource(action, assignment) };
+		if (expr.startsWith("enq(") || expr.startsWith("enq.")) return { statements: [markDiagnosticSource(action, expr)] };
 		const builtIn = expr.match(/^(raise|emit|sendTo|cancel|log|spawnChild|stopChild)\(([\s\S]*)\)$/);
 		if (builtIn) {
 			const [, name, args] = builtIn;
-			return { statements: [`enq.${name === "spawnChild" ? "spawn" : name === "stopChild" ? "stop" : name}(${args})`] };
+			return { statements: [markDiagnosticSource(action, `enq.${name === "spawnChild" ? "spawn" : name === "stopChild" ? "stop" : name}(${args})`)] };
 		}
-		return { statements: [`enq(${expr})`] };
+		return { statements: [markDiagnosticSource(action, `enq(${expr})`)] };
 	}
 	if (!action || typeof action !== "object" || Array.isArray(action)) return null;
 	const record = action;
@@ -6922,7 +7149,7 @@ function buildTypesBlock(schemas, options) {
 	const contextType = contextSchemaToTSType(schemas.context);
 	if (contextType) types.context = raw(`{} as ${contextType}`);
 	const eventsType = eventsSchemaToTSType(schemas.events);
-	if (eventsType) types.events = raw(`{} as\n    | ${eventsType}`);
+	if (eventsType) types.events = raw(`{} as\n  | ${eventsType}`);
 	if (schemas.input) types.input = raw(`{} as ${jsonSchemaToTSType(schemas.input)}`);
 	if (schemas.output) types.output = raw(`{} as ${jsonSchemaToTSType(schemas.output)}`);
 	return Object.keys(types).length > 0 ? types : void 0;

package/dist/{editorHostSession-Bj5YcijC.mjs → editorHostSession-DCTHhBqC.mjs}

@@ -1,6 +1,6 @@
 import { c as object, f as unknown, i as custom, l as record, n as array, o as literal, r as boolean, s as number, t as _enum, u as string } from "./openapi-BTDjYWXd.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-B2_t3Le7.mjs";
-import { p as graphChangeToPatchesResult } from "./dist-NJFkDQjK.mjs";
+import { p as graphChangeToPatchesResult } from "./dist-DsOTTfYv.mjs";
 import * as ts$1 from "typescript";
 
 //#region ../api-contract/dist/editor-sync.mjs

package/dist/{editorHostSession-DwD_9cER.d.mts → editorHostSession-yGUKdLjq.d.mts}

@@ -1,4 +1,4 @@
-import { Q as ProjectEmbedMachine, an as EmbedPanelConfig, lt as ProjectWorkspaceConfig } from "./protocol-AeHm956D.mjs";
+import { Q as ProjectEmbedMachine, an as EmbedPanelConfig, lt as ProjectWorkspaceConfig } from "./protocol-CCf9j_SZ.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-D7YYz6fb.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-DwD_9cER.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-yGUKdLjq.mjs";
 export { EDITOR_PROTOCOL_VERSION, EditorHostDiagnostic, EditorHostExportFormat, EditorHostInboundMessage, EditorHostInitOptions, EditorHostOutboundMessage, EditorHostSession, EditorHostSessionOptions, EditorHostValidationIssue, EditorHostWorkspaceMachine, EditorHostWorkspaceSession, EditorHostWorkspaceSessionOptions, EditorSourceHost, EditorSyncBackend, EditorSyncError, RemoteEditorSyncBackendOptions, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/editorHostSession.mjs

@@ -1,6 +1,6 @@
 import "./openapi-BTDjYWXd.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-B2_t3Le7.mjs";
-import { a as fetchEditorSyncAccess, i as createRemoteEditorSyncBackend, n as EditorHostWorkspaceSession, r as EditorSyncError, t as EditorHostSession } from "./editorHostSession-Bj5YcijC.mjs";
-import "./dist-NJFkDQjK.mjs";
+import { a as fetchEditorSyncAccess, i as createRemoteEditorSyncBackend, n as EditorHostWorkspaceSession, r as EditorSyncError, t as EditorHostSession } from "./editorHostSession-DCTHhBqC.mjs";
+import "./dist-DsOTTfYv.mjs";
 
 export { EDITOR_PROTOCOL_VERSION, EditorHostSession, EditorHostWorkspaceSession, EditorSyncError, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/embed.d.mts

@@ -1,6 +1,6 @@
-import { i as ProfileManifest } from "./index-DZivqh0u.mjs";
-import { i as StatelyGraph } from "./graph-Ciocekxl.mjs";
-import { D as ExportCallOptions, F as InitOptions, G as MachineInitOptions, Gt as UploadResult, J as MachineVersionAutoSaveOptions, O as ExportFormat, Q as ProjectEmbedMachine, S as EmbedExtensionsManifest, Yt as ViewerOptions, _ as EmbedDocumentLanguage, an as EmbedPanelConfig, at as ProjectWorkspaceAction, b as EmbedEventName, ct as ProjectWorkspaceCapabilities, d as CommentsConfig, dt as ProjectWorkspaceMachineOrigin, et as ProjectInitOptions, g as EmbedDocument, k as ExportFormatMap, lt as ProjectWorkspaceConfig, m as EditorCapabilities, on as EmbedPanelPosition, ot as ProjectWorkspaceActionIcon, pt as ProjectWorkspaceProject, q as MachineSourceLocations, r as CapabilityDeniedEvent, ut as ProjectWorkspaceMachine, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-AeHm956D.mjs";
+import { i as ProfileManifest } from "./index-A5CMACoO.mjs";
+import { i as StatelyGraph } from "./graph-DVfx7FwN.mjs";
+import { D as ExportCallOptions, F as InitOptions, G as MachineInitOptions, Gt as UploadResult, J as MachineVersionAutoSaveOptions, O as ExportFormat, Q as ProjectEmbedMachine, S as EmbedExtensionsManifest, Yt as ViewerOptions, _ as EmbedDocumentLanguage, an as EmbedPanelConfig, at as ProjectWorkspaceAction, b as EmbedEventName, ct as ProjectWorkspaceCapabilities, d as CommentsConfig, dt as ProjectWorkspaceMachineOrigin, et as ProjectInitOptions, g as EmbedDocument, k as ExportFormatMap, lt as ProjectWorkspaceConfig, m as EditorCapabilities, on as EmbedPanelPosition, ot as ProjectWorkspaceActionIcon, pt as ProjectWorkspaceProject, q as MachineSourceLocations, r as CapabilityDeniedEvent, ut as ProjectWorkspaceMachine, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-CCf9j_SZ.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
 //#region src/embed.d.ts

package/dist/embed.mjs

@@ -1,5 +1,5 @@
 import "./protocol-BsBGRISR.mjs";
-import { c as createPendingExportManager, l as settingsWithViewMode, r as createPostMessageTransport, s as createEventRegistry, t as SDK_VERSION, u as toInitMessage } from "./version-DxDSBJta.mjs";
+import { c as createPendingExportManager, l as settingsWithViewMode, r as createPostMessageTransport, s as createEventRegistry, t as SDK_VERSION, u as toInitMessage } from "./version-CUFh-PYe.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-B2_t3Le7.mjs";
 
 //#region src/embed.ts

package/dist/{graph-Ciocekxl.d.mts → graph-DVfx7FwN.d.mts}

@@ -1,4 +1,4 @@
-import { t as CodeExpression } from "./index-DZivqh0u.mjs";
+import { t as CodeExpression } from "./index-A5CMACoO.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-Ciocekxl.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-DVfx7FwN.mjs";
 export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };

package/dist/{index-DZivqh0u.d.mts → index-A5CMACoO.d.mts}

@@ -3000,6 +3000,30 @@ type ProfileMigration = {
   migrate: (data: Readonly<ProfileDataSet>, context: ProfileProjectionContext) => ProfileProjectionResult;
 };
 type FormatId = string;
+type ProfileCodeLocation = {
+  graph: Readonly<ProfileGraph>;
+  path: readonly (string | number)[];
+  parent: unknown;
+  ancestors: readonly unknown[];
+};
+type ProfileCodeTarget = {
+  kind: 'entity';
+  id: string;
+  label: string;
+} | {
+  kind: 'source';
+  id: string;
+  label: string;
+  sourceType: string;
+};
+type ProfileCodeBlock = {
+  name: string;
+  matches: (location: ProfileCodeLocation) => boolean;
+  isValid: (code: string) => boolean;
+  exportInvalid: (invalidCode: string) => string; /** Editor destination used to surface and navigate code diagnostics. */
+  getTarget?: (location: ProfileCodeLocation) => ProfileCodeTarget | undefined; /** Object used by source generation to locate this block in a full document. */
+  getSourceValue?: (location: ProfileCodeLocation) => object | undefined;
+};
 type ProfileFormatManifest = {
   format: FormatId;
   import?: boolean;
@@ -3053,7 +3077,10 @@ type ProfileManifest = {
   graph?: {
     dataSchema?: JSONSchema7;
   }; /** Profile-owned editor vocabulary. The canvas itself only assumes a graph. */
-  authoring?: ProfileAuthoringManifest;
+  authoring?: ProfileAuthoringManifest; /** Profile-owned authored code locations and syntax-safe export fallbacks. */
+  code?: {
+    blocks: readonly ProfileCodeBlock[];
+  };
   operations?: Partial<Record<'simulate' | 'validate' | 'export', boolean>>;
   restrictFormatsToListed?: boolean;
   features?: Record<string, boolean | Record<string, unknown>>;
@@ -3072,6 +3099,10 @@ interface XStateTSOptions extends MachineConfigOptions {
   targetLanguage?: 'typescript' | 'javascript';
   xstateVersion?: 5 | 6;
   xstateV6SchemaFormat?: 'types' | 'zod';
+  /** Overrides the selected XState profile's code validation/export policy. */
+  profile?: ProfileManifest;
+  /** Keep authored invalid code for virtual source documents with edit slices. */
+  recoverInvalidCode?: boolean;
 }
 declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions): string;
 //#endregion

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 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-DZivqh0u.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-Ciocekxl.mjs";
-import { $t as createInspectionRoomUrls, B as InspectionSentEvent, D as ExportCallOptions, F as InitOptions, Gt as UploadResult, H as InspectorLoadedEvent, J as MachineVersionAutoSaveOptions, L as InspectionAction, M as INSPECTION_PROTOCOL_VERSION, N as INSPECTION_ROOM_QUERY_PARAM, O as ExportFormat, Q as ProjectEmbedMachine, Qt as createInspectionActorId, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, Zt as assertEmbedExamples, _ as EmbedDocumentLanguage, an as EmbedPanelConfig, at as ProjectWorkspaceAction, b as EmbedEventName, ct as ProjectWorkspaceCapabilities, d as CommentsConfig, dt as ProjectWorkspaceMachineOrigin, en as getInspectionRoomId, f as EMBED_DOCUMENT_LANGUAGES, g as EmbedDocument, in as resolveInspectorSettings, k as ExportFormatMap, lt as ProjectWorkspaceConfig, m as EditorCapabilities, n as CapabilityDeniedCapability, nn as isEmbedExampleMachine, on as EmbedPanelPosition, ot as ProjectWorkspaceActionIcon, p as EMBED_DOCUMENT_LIMITS, pt as ProjectWorkspaceProject, r as CapabilityDeniedEvent, rn as mergeInspectorSettings, tn as isEmbedExample, ut as ProjectWorkspaceMachine, v as EmbedEventHandler, w as EmbedMode, x as EmbedExample, y as EmbedEventMap } from "./protocol-AeHm956D.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-A5CMACoO.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-DVfx7FwN.mjs";
+import { $t as createInspectionRoomUrls, B as InspectionSentEvent, D as ExportCallOptions, F as InitOptions, Gt as UploadResult, H as InspectorLoadedEvent, J as MachineVersionAutoSaveOptions, L as InspectionAction, M as INSPECTION_PROTOCOL_VERSION, N as INSPECTION_ROOM_QUERY_PARAM, O as ExportFormat, Q as ProjectEmbedMachine, Qt as createInspectionActorId, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, Zt as assertEmbedExamples, _ as EmbedDocumentLanguage, an as EmbedPanelConfig, at as ProjectWorkspaceAction, b as EmbedEventName, ct as ProjectWorkspaceCapabilities, d as CommentsConfig, dt as ProjectWorkspaceMachineOrigin, en as getInspectionRoomId, f as EMBED_DOCUMENT_LANGUAGES, g as EmbedDocument, in as resolveInspectorSettings, k as ExportFormatMap, lt as ProjectWorkspaceConfig, m as EditorCapabilities, n as CapabilityDeniedCapability, nn as isEmbedExampleMachine, on as EmbedPanelPosition, ot as ProjectWorkspaceActionIcon, p as EMBED_DOCUMENT_LIMITS, pt as ProjectWorkspaceProject, r as CapabilityDeniedEvent, rn as mergeInspectorSettings, tn as isEmbedExample, ut as ProjectWorkspaceMachine, v as EmbedEventHandler, w as EmbedMode, x as EmbedExample, y as EmbedEventMap } from "./protocol-CCf9j_SZ.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-CVFc85uF.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-DwD_9cER.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-yGUKdLjq.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-D-L0qj9L.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-CKdEPGKY.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-DBH9oOAd.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-CFN3-0-2.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";

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import "./openapi-BTDjYWXd.mjs";
 import { c as createInspectionRoomUrls, d as isEmbedExampleMachine, f as mergeInspectorSettings, i as INSPECTION_ROOM_QUERY_PARAM, l as getInspectionRoomId, n as EMBED_DOCUMENT_LIMITS, o as assertEmbedExamples, p as resolveInspectorSettings, r as INSPECTION_PROTOCOL_VERSION, s as createInspectionActorId, t as EMBED_DOCUMENT_LANGUAGES, u as isEmbedExample } from "./protocol-BsBGRISR.mjs";
-import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-DxDSBJta.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-CUFh-PYe.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-B2_t3Le7.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
-import { a as fetchEditorSyncAccess, i as createRemoteEditorSyncBackend, n as EditorHostWorkspaceSession, t as EditorHostSession } from "./editorHostSession-Bj5YcijC.mjs";
+import { a as fetchEditorSyncAccess, i as createRemoteEditorSyncBackend, n as EditorHostWorkspaceSession, t as EditorHostSession } from "./editorHostSession-DCTHhBqC.mjs";
 import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-BZP6DaIO.mjs";
-import { S as serializeJS, _ as graphToXStateV4TS, f as getXStateFSMCompatibilityIssues, g as graphToXStateTS, h as graphToXStateFSM, l as eventsSchemaToTSType, m as graphToMachineConfig, n as RawCode, o as contextSchemaToTSType, x as raw, y as jsonSchemaToTSType } from "./dist-NJFkDQjK.mjs";
+import { S as serializeJS, _ as graphToXStateV4TS, f as getXStateFSMCompatibilityIssues, g as graphToXStateTS, h as graphToXStateFSM, l as eventsSchemaToTSType, m as graphToMachineConfig, n as RawCode, o as contextSchemaToTSType, x as raw, y as jsonSchemaToTSType } from "./dist-DsOTTfYv.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-0dMcaOz_.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-ZVDq9tK2.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-D-L0qj9L.d.mts → inspect-DBH9oOAd.d.mts}

@@ -1,4 +1,4 @@
-import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, R as InspectionClientMetadata, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, k as ExportFormatMap, mt as ProtocolMessage, y as EmbedEventMap } from "./protocol-AeHm956D.mjs";
+import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, R as InspectionClientMetadata, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, k as ExportFormatMap, mt as ProtocolMessage, y as EmbedEventMap } from "./protocol-CCf9j_SZ.mjs";
 
 //#region src/transport.d.ts
 interface TransportFailure {
@@ -53,6 +53,7 @@ interface MinimalSnapshot {
   value: unknown;
   status: unknown;
   context?: unknown;
+  tags?: Iterable<string>;
   children?: Record<string, MinimalActorRef>;
 }
 /** Cross-version event envelope accepted by {@link Inspector.inspect}. */

package/dist/{inspect-0dMcaOz_.mjs → inspect-ZVDq9tK2.mjs}

@@ -1,5 +1,5 @@
 import { c as createInspectionRoomUrls, f as mergeInspectorSettings, l as getInspectionRoomId, p as resolveInspectorSettings, r as INSPECTION_PROTOCOL_VERSION } from "./protocol-BsBGRISR.mjs";
-import { a as assertEmbedDocuments, c as createPendingExportManager, i as createWebSocketTransport, n as inspectionRuntime, o as assertEmbedPanels, s as createEventRegistry, t as SDK_VERSION } from "./version-DxDSBJta.mjs";
+import { a as assertEmbedDocuments, c as createPendingExportManager, i as createWebSocketTransport, n as inspectionRuntime, o as assertEmbedPanels, s as createEventRegistry, t as SDK_VERSION } from "./version-CUFh-PYe.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
@@ -51,7 +51,8 @@ function deriveActorDisplayName(parentLogic, actorId) {
 //#region src/inspect.ts
 const defaultSerializeSnapshot = (snapshot) => ({
 	value: snapshot?.value,
-	status: snapshot?.status
+	status: snapshot?.status,
+	...snapshot?.tags && { tags: Array.from(snapshot.tags) }
 });
 const defaultExtractMachineConfig = (actor, source) => actor?.logic?.config ?? source?.config ?? null;
 function isStoppedSnapshot(snapshot) {
@@ -251,12 +252,19 @@ function createInspector(options = {}) {
 	function emitLocal(event, data) {
 		const set = localListeners[event];
 		if (!set) return;
-		for (const handler of set) handler(data);
+		for (const handler of set) try {
+			handler(data);
+		} catch (cause) {
+			if (event === "error") console.error("Inspector error listener failed:", cause);
+			else emitLocal("error", {
+				code: "inspection_failed",
+				message: cause instanceof Error ? cause.message : String(cause)
+			});
+		}
 	}
 	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();
@@ -264,28 +272,21 @@ function createInspector(options = {}) {
 	const locallyRegistered = /* @__PURE__ */ new Set();
 	/** v5 emits transition facets separately; accumulate them until snapshot. */
 	const pendingTransitions = /* @__PURE__ */ new Map();
-	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) {
+	function sessionIdOf(actorRef, parentRef = actorRef._parent) {
 		const existing = resolvedSessionIds.get(actorRef);
 		if (existing) return existing;
-		const parentSessionId = parentRef ? sessionIdOf(parentRef, parentRef._parent, runtimeRoot) : null;
+		const parentSessionId = parentRef ? sessionIdOf(parentRef, parentRef._parent) : 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));
+		for (let ancestor = parentRef; ancestor; ancestor = ancestor._parent) if (sessionIdOf(ancestor, ancestor._parent) === resolved) throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
+		assertSessionIdAvailable(actorRef, resolved);
 		return claimSessionId(actorRef, resolved);
 	}
-	function assertSessionIdAvailable(actorRef, resolved, nextRoot) {
+	function assertSessionIdAvailable(actorRef, resolved) {
 		const claimedBy = actorsByResolvedSessionId.get(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 (!terminatedActors.has(claimedBy) && !isStoppedSnapshot(readSnapshot(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}".`);
 	}
@@ -309,7 +310,7 @@ function createInspector(options = {}) {
 	function rootSessionIdOf(runtimeRootId, actorRef) {
 		let rootRef = actorRef;
 		while (rootRef._parent) rootRef = rootRef._parent;
-		return rootRef.sessionId === runtimeRootId ? sessionIdOf(rootRef, void 0, rootRef) : runtimeRootId;
+		return rootRef.sessionId === runtimeRootId ? sessionIdOf(rootRef, void 0) : runtimeRootId;
 	}
 	function emitRegisterOnce(entry) {
 		if (locallyRegistered.has(entry.sessionId)) return;
@@ -334,9 +335,9 @@ function createInspector(options = {}) {
 	function toEntry(actorRef, rootActorId, details) {
 		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);
+		const snapshot = details?.snapshot === null ? null : details?.snapshot ?? readSnapshot(actorRef);
+		const serialized = snapshot == null ? null : serializeSnapshot(snapshot);
+		if (snapshot != null) trackTermination(actorRef, snapshot);
 		return {
 			sessionId,
 			actorId: details?.id ?? actorRef.id ?? sessionId,
@@ -363,27 +364,30 @@ function createInspector(options = {}) {
 	function resolveActorTreeSessionIds(rootRef) {
 		const pending = /* @__PURE__ */ new Map();
 		const owners = /* @__PURE__ */ new Map();
-		function visit(actorRef, parentRef) {
+		function visit(actorRef, parentRef, ancestorIds = /* @__PURE__ */ new Set()) {
 			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.");
+			if (ancestorIds.has(resolved)) throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
 			const localOwner = owners.get(resolved);
-			if (localOwner && localOwner !== actorRef) throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
+			if (localOwner && localOwner !== actorRef) {
+				if (sessionIdReuse !== "always" && !isStoppedSnapshot(readSnapshot(localOwner))) throw new Error(`createInspector(): resolveSessionId returned duplicate id "${resolved}".`);
+			}
 			owners.set(resolved, actorRef);
 			if (!existing) pending.set(actorRef, {
 				resolved,
 				parentRef
 			});
-			assertSessionIdAvailable(actorRef, resolved, rootRef);
+			assertSessionIdAvailable(actorRef, resolved);
 			const children = actorRef.getSnapshot()?.children ?? {};
-			for (const child of Object.values(children)) if (child) visit(child, actorRef);
+			const childAncestorIds = new Set(ancestorIds);
+			childAncestorIds.add(resolved);
+			for (const child of Object.values(children)) if (child) visit(child, actorRef, childAncestorIds);
 		}
 		visit(rootRef);
-		for (const [actorRef, { resolved }] of pending) {
-			runtimeRoots.set(actorRef, rootRef);
-			claimSessionId(actorRef, resolved);
-		}
+		for (const [actorRef, { resolved }] of pending) if (owners.get(resolved) === actorRef) claimSessionId(actorRef, resolved);
+		else resolvedSessionIds.set(actorRef, resolved);
 	}
 	/**
 	* Walk the actor tree and populate the local `actors` map. Idempotent —
@@ -408,6 +412,7 @@ function createInspector(options = {}) {
 	}
 	function backfillActorTree(actorRef, rootActorId, publish = false) {
 		const sessionId = sessionIdOf(actorRef);
+		if (!isCurrentOwner(actorRef)) return;
 		const existing = actors.get(sessionId);
 		const replaces = reboundActors.delete(actorRef);
 		const entry = !existing || replaces ? toEntry(actorRef, rootActorId) : existing;
@@ -584,14 +589,16 @@ function createInspector(options = {}) {
 		const isNewRoot = !observedRootIds.has(rootActorId);
 		observedRootIds.add(rootActorId);
 		switch (event.type) {
-			case "@xstate.actor":
+			case "@xstate.actor": {
+				const initialSnapshot = event.snapshot ?? readSnapshot(event.actorRef);
 				handleActor(event.actorRef, rootActorId, {
 					parentRef: event.parentRef,
 					id: event.id,
 					source: event.src,
-					snapshot: event.snapshot
+					snapshot: isStoppedSnapshot(initialSnapshot) ? initialSnapshot : null
 				});
 				break;
+			}
 			case "@xstate.event": {
 				const sessionId = sessionIdOf(event.actorRef);
 				if (!actors.has(sessionId)) handleActor(event.actorRef, rootActorId);
@@ -625,6 +632,16 @@ function createInspector(options = {}) {
 		}
 		if (isNewRoot && !initSent) sendInit();
 	}
+	function safelyHandleInspectionEvent(event) {
+		try {
+			handleInspectionEvent(event);
+		} catch (cause) {
+			emitLocal("error", {
+				code: "inspection_failed",
+				message: cause instanceof Error ? cause.message : String(cause)
+			});
+		}
+	}
 	function attachActor(actor) {
 		const root = actor;
 		resolveActorTreeSessionIds(root);
@@ -637,7 +654,7 @@ function createInspector(options = {}) {
 		}
 		materializePendingInit();
 		observedRootIds.add(rootActorId);
-		const subscription = root.system.inspect(handleInspectionEvent);
+		const subscription = root.system.inspect(safelyHandleInspectionEvent);
 		inspectedRoots.set(rootActorId, {
 			actor: root,
 			subscription
@@ -763,7 +780,7 @@ function createInspector(options = {}) {
 		},
 		inspectorUrl,
 		ready,
-		inspect: handleInspectionEvent,
+		inspect: safelyHandleInspectionEvent,
 		attach: attachActor,
 		on(event, handler) {
 			if (!localListeners[event]) localListeners[event] = /* @__PURE__ */ new Set();

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
-import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, an as EmbedPanelConfig, b as EmbedEventName, g as EmbedDocument, k as ExportFormatMap, m as EditorCapabilities, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-AeHm956D.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-D-L0qj9L.mjs";
+import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, an as EmbedPanelConfig, b as EmbedEventName, g as EmbedDocument, k as ExportFormatMap, m as EditorCapabilities, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-CCf9j_SZ.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-DBH9oOAd.mjs";
 export { AdoptedActor, CreateInspectorOptions, EditorCapabilities, EmbedDocument, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, EmbedPanelConfig, ExportCallOptions, ExportFormat, ExportFormatMap, InspectedEvent, InspectedSnapshot, InspectedTransition, InspectionAction, InspectionSentEvent, InspectionTakenTransition, Inspector, InspectorConnection, InspectorDiscoveryEntry, InspectorEvents, InspectorInspectionEvent, InspectorLoadedEvent, InspectorSettings, MachinePayload, ManualActorOptions, Transport, ViewerOptions, createInspector, createStatelyInspector };

package/dist/inspect.mjs

@@ -1,5 +1,5 @@
 import "./protocol-BsBGRISR.mjs";
-import "./version-DxDSBJta.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-0dMcaOz_.mjs";
+import "./version-CUFh-PYe.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-ZVDq9tK2.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/patchTypes.d.mts

@@ -1,2 +1,2 @@
-import { C as ImplementationSourceType, S as GraphPatch, b as CanvasColor, x as EditorStateType, y as ActionLocation } from "./index-DZivqh0u.mjs";
+import { C as ImplementationSourceType, S as GraphPatch, b as CanvasColor, x as EditorStateType, y as ActionLocation } from "./index-A5CMACoO.mjs";
 export { type ActionLocation, type CanvasColor, type EditorStateType, type GraphPatch, type ImplementationSourceType };

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

@@ -1,5 +1,5 @@
-import { i as ProfileManifest } from "./index-DZivqh0u.mjs";
-import { i as StatelyGraph } from "./graph-Ciocekxl.mjs";
+import { i as ProfileManifest } from "./index-A5CMACoO.mjs";
+import { i as StatelyGraph } from "./graph-DVfx7FwN.mjs";
 import { c as EditorSyncSourceLocation, f as MachineSourceLocations$1, l as EditorSyncSourceRange, t as EditorCapabilities$1, u as EditorSyncStateSourceLocation } from "./editor-sync-types-D7YYz6fb.mjs";
 
 //#region src/embedPanel.d.ts
@@ -530,6 +530,8 @@ interface ToastDismissMessage {
 }
 interface InspectSnapshotMessage {
   type: '@statelyai.inspectSnapshot';
+  /** Taken transitions, when supplied by the producer. */
+  transitions?: InspectionTakenTransition[];
   snapshot: unknown;
   event: unknown | null;
   /** Producer-local actor session id, when this snapshot belongs to an actor. */

package/dist/protocol.d.mts

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

package/dist/relay.d.mts

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

package/dist/relay.mjs

@@ -64,6 +64,41 @@ function errorMessage(code, message) {
 function compactReplay(replay, message, max) {
 	const record = message;
 	const type = record.type;
+	const checkpoint = type === "@statelyai.system.actorRegistered" || type === "@statelyai.system.actorSnapshot" || type === "@statelyai.system.actorStopped" ? replay.find((entry) => entry.type === "@statelyai.system.init") : void 0;
+	if (checkpoint && typeof record.sessionId === "string") {
+		const actorIndex = checkpoint.actors.findIndex((actor) => actor.sessionId === record.sessionId);
+		if (type === "@statelyai.system.actorRegistered") {
+			const nextActor = {
+				sessionId: record.sessionId,
+				actorId: record.actorId,
+				...typeof record.displayName === "string" && { displayName: record.displayName },
+				parentSessionId: record.parentSessionId,
+				machine: record.machine,
+				snapshot: record.snapshot
+			};
+			if (actorIndex >= 0) checkpoint.actors[actorIndex] = nextActor;
+			else checkpoint.actors.push(nextActor);
+			for (let index = replay.length - 1; index >= 0; index--) {
+				const previous = replay[index];
+				if (previous.sessionId === record.sessionId && typeof previous.type === "string" && previous.type.startsWith("@statelyai.system.actor")) replay.splice(index, 1);
+			}
+			return;
+		}
+		const actor = checkpoint.actors[actorIndex];
+		if (actor) {
+			if (type === "@statelyai.system.actorSnapshot") checkpoint.actors[actorIndex] = {
+				...actor,
+				snapshot: record.snapshot
+			};
+			else if (type === "@statelyai.system.actorStopped") {
+				checkpoint.actors[actorIndex] = {
+					...actor,
+					stopped: true
+				};
+				return;
+			}
+		}
+	}
 	if (type === "@statelyai.setSettings" || type === "@statelyai.system.selectActor") {
 		const index = replay.findIndex((entry) => entry.type === "@statelyai.system.init");
 		const init = replay[index];
@@ -97,7 +132,11 @@ function compactReplay(replay, message, max) {
 		if (index >= 0) replay.splice(index, 1);
 	}
 	replay.push(message);
-	if (replay.length > max) replay.splice(0, replay.length - max);
+	while (replay.length > max) {
+		const oldestDelta = replay.findIndex((entry) => entry.type !== "@statelyai.system.init" && entry.type !== "@statelyai.init");
+		if (oldestDelta < 0) break;
+		replay.splice(oldestDelta, 1);
+	}
 }
 /**
 * Runtime-neutral implementation of one inspection room.

package/dist/{studio-CKdEPGKY.d.mts → studio-CFN3-0-2.d.mts}

@@ -1,4 +1,4 @@
-import { A as ZodObject, D as ZodLiteral, E as ZodEnum, F as ZodUnknown, I as output, L as $loose, M as ZodRecord, N as ZodString, O as ZodNullable, P as ZodUnion, R as $strip, T as ZodBoolean, j as ZodOptional, k as ZodNumber, w as ZodArray } from "./index-DZivqh0u.mjs";
+import { A as ZodObject, D as ZodLiteral, E as ZodEnum, F as ZodUnknown, I as output, L as $loose, M as ZodRecord, N as ZodString, O as ZodNullable, P as ZodUnion, R as $strip, T as ZodBoolean, j as ZodOptional, k as ZodNumber, w as ZodArray } from "./index-A5CMACoO.mjs";
 import { n as StatelyCredential, t as StatelyAuthMode } from "./auth-CVFc85uF.mjs";
 
 //#region ../api-contract/dist/errors.d.mts

package/dist/studio.d.mts

@@ -1,2 +1,2 @@
-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, p as LegacyExtractMachinesOptions, 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-CKdEPGKY.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, p as LegacyExtractMachinesOptions, 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-CFN3-0-2.mjs";
 export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, DEFAULT_STATELY_BASE_URL, EnsureProjectInput, ExtractMachinesInput, ExtractMachinesResponse, ExtractedMachine, ExtractedMachines, GetMachineOptions, LegacyExtractMachinesOptions, LegacyProjectVisibility, LegacyUpdateMachineInput, Machine, MachineVersion, Project, ProjectData, ProjectMachine, ProjectMachineSummary, ProjectSummary, ProjectVisibility, RepoType, ResourceErrorCode, StudioApiError, StudioApiErrorOptions, StudioClient, StudioClientOptions, StudioMachineRecord, StudioRequestOptions, UpdateMachineInput, UpdateProjectInput, VerifyApiKeyResponse, VerifyResult, XStateVersion, createStatelyClient };

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { b as DigraphConfig, i as StatelyGraph } from "./graph-Ciocekxl.mjs";
-import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-CKdEPGKY.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-DVfx7FwN.mjs";
+import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-CFN3-0-2.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
 //#region src/sync.d.ts

package/dist/sync.mjs

@@ -1,6 +1,6 @@
 import "./openapi-BTDjYWXd.mjs";
 import { r as createStatelyClient } from "./studio-BZP6DaIO.mjs";
-import { C as toXStateV6MachineConfig, S as serializeJS, a as alignCompareGraphIds, b as normalizeMachineProfile, c as diffGraphsSemantically, d as getDelayKeyFromEventType, g as graphToXStateTS, i as XSTATE_V6_FN_TRANSITION_META, m as graphToMachineConfig, p as graphChangeToPatchesResult, r as XSTATE_V6_BRANCH_DESCRIPTION_META, s as detectXStateSourceProfile, t as INLINE_EXPRESSION_DIRECTIVE_FIELDS, u as extractXStateMachineConfigEntries, v as isCodeExpression } from "./dist-NJFkDQjK.mjs";
+import { C as toXStateV6MachineConfig, S as serializeJS, a as alignCompareGraphIds, b as normalizeMachineProfile, c as diffGraphsSemantically, d as getDelayKeyFromEventType, g as graphToXStateTS, i as XSTATE_V6_FN_TRANSITION_META, m as graphToMachineConfig, p as graphChangeToPatchesResult, r as XSTATE_V6_BRANCH_DESCRIPTION_META, s as detectXStateSourceProfile, t as INLINE_EXPRESSION_DIRECTIVE_FIELDS, u as extractXStateMachineConfigEntries, v as isCodeExpression } from "./dist-DsOTTfYv.mjs";
 import { n as getStatelyPragma, r as upsertStatelyPragma, t as findStatelyPragmaAttachments } from "./statelyPragma-YtVaBuIe.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import * as ts$1 from "typescript";

package/dist/{version-DxDSBJta.mjs → version-CUFh-PYe.mjs}

@@ -378,7 +378,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.34.0";
+const SDK_VERSION = "0.34.2";
 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.34.0",
+  "version": "0.34.2",
   "license": "MIT",
   "bin": {
     "stately-sdk": "./dist/bin.mjs"
@@ -82,7 +82,6 @@
   },
   "dependencies": {
     "@statelyai/graph": "^2.1.0",
-    "esbuild": "^0.27.0",
     "typescript": "^5.9.3",
     "ws": "^8.19.0",
     "xstate": "^5.0.0"
@@ -93,8 +92,9 @@
     "jsdom": "^27.4.0",
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
-    "@statelyai/api-contract": "0.5.1",
-    "@statelyai/graph-tools": "0.8.4"
+    "xstate-v6": "npm:xstate@6.0.0-alpha.51",
+    "@statelyai/api-contract": "0.5.2",
+    "@statelyai/graph-tools": "0.9.0"
   },
   "engines": {
     "node": ">=22.4"