@statelyai/sdk 0.20.3 → 0.21.0

package/README.md

@@ -44,6 +44,13 @@ embed.init({
 });
 ```
 
+Custom profiles and formats can be supplied when the embed is created. Their
+serializable manifests are sent to the iframe; detector, importer, exporter,
+and validator implementations remain in the host and are called asynchronously.
+RPC methods and payloads are validated before host code runs, and malformed
+graphs returned by custom importers are rejected.
+Use `defaultProfile` and `defaultFormat` to choose the initial custom pair.
+
 Restrict an embed by passing a resolved access policy:
 
 <!-- restricted MachineInitOptions from src/protocol.ts -->

package/dist/embed.d.mts

@@ -1,5 +1,6 @@
-import { i as StatelyGraph } from "./graph-yDK-MM3G.mjs";
-import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
+import { l as ProfileManifest } from "./index-BABex8NE.mjs";
+import { i as StatelyGraph } from "./graph-B4WM_nYg.mjs";
+import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExtensionsManifest, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
 //#region src/embed.d.ts
@@ -29,6 +30,45 @@ interface AssetConfig {
    */
   maxFileSize?: number;
 }
+type EmbedEntity = {
+  data?: Record<string, unknown>;
+};
+type EmbedGraph = EmbedEntity & {
+  nodes?: EmbedEntity[];
+  edges?: EmbedEntity[];
+};
+type EmbedFormatContext = {
+  profile: EmbedProfileDefinition;
+  resolveGraphData(graph: EmbedGraph): Record<string, unknown>;
+  resolveNodeData(node: EmbedEntity): Record<string, unknown>;
+  resolveEdgeData(edge: EmbedEntity): Record<string, unknown>;
+};
+type EmbedProfileDefinition = Omit<ProfileManifest, 'validation'> & {
+  validation?: Array<{
+    name: string;
+    description: string;
+    validate?(context: {
+      graph: EmbedGraph;
+      profile: ProfileManifest;
+      revision?: number;
+      resolveGraphData(graph: EmbedGraph): Record<string, unknown>;
+      resolveNodeData(node: EmbedEntity): Record<string, unknown>;
+      resolveEdgeData(edge: EmbedEntity): Record<string, unknown>;
+    }): unknown | Promise<unknown>;
+  }>;
+};
+type EmbedFormatDefinition = {
+  id: string;
+  name: string;
+  file?: {
+    extension?: string;
+    mediaType?: string;
+  };
+  editorLanguage?: string;
+  detect?(source: string): boolean | number | Promise<boolean | number>;
+  import?(source: string, context: EmbedFormatContext): unknown | Promise<unknown>;
+  export?(graph: EmbedGraph, context: EmbedFormatContext): unknown | Promise<unknown>;
+};
 interface StatelyEmbedOptions extends Partial<MachineInitOptions> {
   baseUrl: string;
   apiKey?: string;
@@ -49,6 +89,10 @@ interface StatelyEmbedOptions extends Partial<MachineInitOptions> {
   commentsByMachineId?: Record<string, CommentsConfig>;
   /** Asset upload configuration. If omitted, files are stored as base64 data URLs. */
   assets?: AssetConfig;
+  profiles?: readonly EmbedProfileDefinition[];
+  formats?: readonly EmbedFormatDefinition[];
+  defaultProfile?: string;
+  defaultFormat?: string;
   onReady?: () => void;
   onLoaded?: (graph: StatelyGraph) => void;
   onChange?: (graph: StatelyGraph, machineConfig: unknown) => void;
@@ -91,4 +135,4 @@ interface StatelyEmbed {
 }
 declare function createStatelyEmbed(options: StatelyEmbedOptions): StatelyEmbed;
 //#endregion
-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 };
+export { AssetConfig, type CapabilityDeniedEvent, type CommentsConfig, type EditorCapabilities, type EmbedDocument, type EmbedDocumentLanguage, EmbedEntity, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedExtensionsManifest, EmbedFormatContext, EmbedFormatDefinition, EmbedGraph, type EmbedMode, EmbedProfileDefinition, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type InitOptions, type MachineInitOptions, type MachineSourceLocations, type ProjectEmbedMachine, StatelyEmbed, StatelyEmbedOptions, type UploadResult, createStatelyEmbed };

package/dist/embed.mjs

@@ -1,13 +1,73 @@
-import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-DoNMw8g6.mjs";
+import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-CNeiHhaT.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
 
 //#region src/embed.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isEmbedEntity(value) {
+	return isRecord(value) && isRecord(value.data);
+}
+function isEmbedGraph(value) {
+	return isRecord(value) && isRecord(value.data) && Array.isArray(value.nodes) && value.nodes.every(isEmbedEntity) && Array.isArray(value.edges) && value.edges.every(isEmbedEntity);
+}
+function assertExtensionCall(value) {
+	if (!isRecord(value)) throw new Error("Invalid extension request.");
+	if (typeof value.requestId !== "string" || typeof value.extensionId !== "string" || ![
+		"detect",
+		"import",
+		"export",
+		"validate"
+	].includes(String(value.method)) || !isRecord(value.payload)) throw new Error("Invalid extension request.");
+	const payload = value.payload;
+	if ((value.method === "detect" || value.method === "import") && typeof payload.source !== "string") throw new Error("Invalid extension source payload.");
+	if ((value.method === "import" || value.method === "export") && typeof payload.profileId !== "string") throw new Error("Invalid extension profile payload.");
+	if ((value.method === "export" || value.method === "validate") && !isEmbedGraph(payload.graph)) throw new Error("Invalid extension graph payload.");
+	if (value.method === "validate" && payload.revision !== void 0 && typeof payload.revision !== "number") throw new Error("Invalid extension revision payload.");
+}
 function buildEmbedUrl(options) {
 	const base = options.baseUrl.replace(/\/+$/, "") + "/embed";
 	const url = new URL(base);
 	if (options.apiKey) url.searchParams.set("api_key", options.apiKey);
 	return url.toString();
 }
+function serializeExtensions(options) {
+	if (!options.profiles?.length && !options.formats?.length) return options.extensions;
+	return {
+		profiles: (options.profiles ?? []).map((profile) => ({
+			profile: profile.profile,
+			name: profile.name,
+			description: profile.description,
+			namespace: profile.namespace,
+			extends: profile.extends,
+			formats: profile.formats,
+			defaultFormat: profile.defaultFormat,
+			graph: profile.graph,
+			authoring: profile.authoring,
+			operations: profile.operations,
+			restrictFormatsToListed: profile.restrictFormatsToListed,
+			features: profile.features,
+			implementations: profile.implementations,
+			rules: profile.rules,
+			editorDefaults: profile.editorDefaults,
+			validation: profile.validation?.map(({ name, description }) => ({
+				name,
+				description
+			}))
+		})),
+		formats: (options.formats ?? []).map((format) => ({
+			id: format.id,
+			name: format.name,
+			file: format.file,
+			editorLanguage: format.editorLanguage,
+			detect: !!format.detect,
+			import: !!format.import,
+			export: !!format.export
+		})),
+		defaultProfile: options.defaultProfile,
+		defaultFormat: options.defaultFormat
+	};
+}
 function extractInitOptions(options) {
 	if (options.machines) return {
 		machines: options.machines,
@@ -26,6 +86,7 @@ function extractInitOptions(options) {
 		machine: options.machine,
 		documents: options.documents,
 		format: options.format,
+		extensions: serializeExtensions(options),
 		mode: options.mode,
 		theme: options.theme,
 		readOnly: options.readOnly,
@@ -41,7 +102,7 @@ function extractInitOptions(options) {
 }
 function createStatelyEmbed(options) {
 	const embedUrl = buildEmbedUrl(options);
-	const targetOrigin = options.origin ?? "*";
+	const targetOrigin = options.origin ?? new URL(embedUrl).origin;
 	let iframe = null;
 	let transport = null;
 	let ownedIframe = false;
@@ -49,6 +110,9 @@ function createStatelyEmbed(options) {
 	let editorProtocolCompatible;
 	const pendingMessages = [];
 	const events = createEventRegistry();
+	const profiles = new Map((options.profiles ?? []).map((profile) => [profile.profile, profile]));
+	const formats = new Map((options.formats ?? []).map((format) => [format.id, format]));
+	const bundledExtensions = serializeExtensions(options);
 	const exportManager = createPendingExportManager((message) => send(message));
 	const assetUploadAdapter = options.assets?.adapter;
 	const uploadAsset = options.assets?.onUploadRequest ? (file, context) => options.assets.onUploadRequest(file, context) : assetUploadAdapter ? (file, context) => assetUploadAdapter.upload({
@@ -72,9 +136,73 @@ function createStatelyEmbed(options) {
 			transport.send(msg);
 		}
 	}
+	function formatContext(profile) {
+		const namespace = profile.namespace ?? /^(@[^/]+)\//.exec(profile.profile)?.[1];
+		if (!namespace) throw new Error(`Profile ${profile.profile} has no namespace.`);
+		const resolve = (data) => Object.fromEntries(Object.entries(data).filter(([key]) => key.startsWith(`${namespace}.`)).map(([key, value]) => [key.slice(namespace.length + 1), value]));
+		return {
+			profile,
+			resolveGraphData: (graph) => resolve(graph.data ?? {}),
+			resolveNodeData: (node) => resolve(node.data ?? {}),
+			resolveEdgeData: (edge) => resolve(edge.data ?? {})
+		};
+	}
+	async function handleExtensionCall(input) {
+		const requestId = isRecord(input) && typeof input.requestId === "string" ? input.requestId : void 0;
+		try {
+			assertExtensionCall(input);
+			const call = input;
+			const payload = call.payload;
+			let result;
+			if (call.method === "validate") {
+				const profile = profiles.get(call.extensionId);
+				if (!profile) throw new Error(`Unknown profile ${call.extensionId}.`);
+				const context = formatContext(profile);
+				result = (await Promise.all((profile.validation ?? []).filter((validator) => validator.validate).map((validator) => validator.validate({
+					graph: payload.graph,
+					revision: typeof payload.revision === "number" ? payload.revision : void 0,
+					...context
+				})))).flat();
+			} else {
+				const format = formats.get(call.extensionId);
+				if (!format) throw new Error(`Unknown format ${call.extensionId}.`);
+				if (call.method === "detect") {
+					if (!format.detect) throw new Error("Format has no detector.");
+					result = await format.detect(String(payload.source ?? ""));
+				} else {
+					const profile = profiles.get(String(payload.profileId ?? ""));
+					if (!profile) throw new Error(`Unknown profile ${payload.profileId}.`);
+					const context = formatContext(profile);
+					if (call.method === "import") {
+						if (!format.import) throw new Error("Format has no importer.");
+						result = await format.import(payload.source, context);
+						if (!isEmbedGraph(result)) throw new Error("Format importer returned an invalid graph.");
+					} else {
+						if (!format.export) throw new Error("Format has no exporter.");
+						result = await format.export(payload.graph, context);
+					}
+				}
+			}
+			send({
+				type: "@statelyai.extension.result",
+				requestId: call.requestId,
+				result
+			});
+		} catch (error) {
+			if (!requestId) return;
+			send({
+				type: "@statelyai.extension.result",
+				requestId,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
 	function handleMessage(data) {
 		if (destroyed) return;
 		switch (data.type) {
+			case "@statelyai.extension.call":
+				handleExtensionCall(data);
+				break;
 			case "@statelyai.ready": {
 				const ready = data;
 				if (ready.protocolVersion !== void 0) {
@@ -257,7 +385,10 @@ function createStatelyEmbed(options) {
 			return el;
 		},
 		init(opts) {
-			send(toInitMessage(opts));
+			send(toInitMessage("machine" in opts ? {
+				...opts,
+				extensions: opts.extensions ?? bundledExtensions
+			} : opts));
 		},
 		updateMachine(machine, format, sourceLocations) {
 			send({

package/dist/{graph-yDK-MM3G.d.mts → graph-B4WM_nYg.d.mts}

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

package/dist/{index-BAkQThnl.d.mts → index-BABex8NE.d.mts}

@@ -2451,6 +2451,70 @@ declare function raw(code: string): RawCode;
 declare function serializeJS(value: unknown, indent?: number, step?: number): string; //#endregion
 //#region src/profiles/xgraphMetadata.d.ts
 //#endregion
+//#region src/profiles/types.d.ts
+type FormatId = string;
+type ProfileFormatManifest = {
+  format: FormatId;
+  import?: boolean;
+  export?: boolean;
+  sourcePreserving?: boolean;
+  warning?: string;
+};
+type ProfileEntityType = {
+  kind: string;
+  label: string;
+  description?: string;
+  authorable?: boolean;
+  terminal?: boolean;
+  canContain?: boolean; /** Logical, unnamespaced profile data stored canonically under the profile namespace. */
+  dataSchema?: JSONSchema7;
+  children?: {
+    types: readonly string[];
+    min?: number;
+    max?: number;
+  };
+};
+type ProfileValidationDefinition = {
+  name: string;
+  description: string;
+};
+type ProfileAuthoringManifest = {
+  terminology: {
+    node: string;
+    edge: string;
+    graph: string;
+  };
+  nodeTypes: readonly ProfileEntityType[];
+  edgeTypes: readonly ProfileEntityType[];
+  attachments?: Partial<Record<'actions' | 'guards' | 'invokes' | 'tags', boolean>>;
+  supportsInitialNode?: boolean;
+  supportsTargetlessEdges?: boolean;
+  supportsReenterEdges?: boolean;
+};
+type ProfileManifest = {
+  profile: ResolvedProfileRef;
+  name: string;
+  description?: string; /** Namespace for canonical profile data, for example `@mastra`. */
+  namespace?: `@${string}`;
+  extends?: ProfileSpecifier;
+  formats: ProfileFormatManifest[];
+  defaultFormat?: FormatId;
+  graph?: {
+    dataSchema?: JSONSchema7;
+  }; /** Profile-owned editor vocabulary. The canvas itself only assumes a graph. */
+  authoring?: ProfileAuthoringManifest;
+  operations?: Partial<Record<'simulate' | 'validate' | 'export', boolean>>;
+  restrictFormatsToListed?: boolean;
+  features?: Record<string, boolean | Record<string, unknown>>;
+  implementations?: Partial<Record<'actions' | 'guards' | 'actors' | 'delays', {
+    mode: 'allowlist' | 'any';
+    items: Record<string, Record<string, unknown>>;
+  }>>;
+  rules?: Array<Record<string, unknown>>;
+  validation?: ProfileValidationDefinition[];
+  editorDefaults?: Record<string, unknown>;
+};
+//#endregion
 //#region src/graphToXStateTS.d.ts
 interface XStateTSOptions extends MachineConfigOptions {
   exportStyle?: 'named' | 'default' | 'none';
@@ -2888,4 +2952,4 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
 type GraphPatch = output<typeof graphPatchSchema>;
 /** AI-only schema: semantic ops + shared ops (no generic graph ops) */
 //#endregion
-export { $strip as A, ZodObject as C, ZodUnion as D, ZodString as E, ZodUnknown as O, ZodNumber as S, ZodRecord as T, serializeJS as _, EditorStateType as a, ZodLiteral as b, MachineConfigOptions as c, contextSchemaToTSType as d, eventsSchemaToTSType as f, raw as g, jsonSchemaToTSType as h, CodeGenGraph as i, output as k, RawCode as l, graphToXStateTS as m, CanvasColor as n, GraphPatch as o, graphToMachineConfig as p, CodeExpression as r, ImplementationSourceType as s, ActionLocation as t, XStateTSOptions as u, ZodArray as v, ZodOptional as w, ZodNullable as x, ZodEnum as y };
+export { output as A, ZodNumber as C, ZodString as D, ZodRecord as E, ZodUnion as O, ZodNullable as S, ZodOptional as T, raw as _, EditorStateType as a, ZodEnum as b, MachineConfigOptions as c, XStateTSOptions as d, contextSchemaToTSType as f, jsonSchemaToTSType as g, graphToXStateTS as h, CodeGenGraph as i, $strip as j, ZodUnknown as k, ProfileManifest as l, graphToMachineConfig as m, CanvasColor as n, GraphPatch as o, eventsSchemaToTSType as p, CodeExpression as r, ImplementationSourceType as s, ActionLocation as t, RawCode as u, serializeJS as v, ZodObject as w, ZodLiteral as x, ZodArray as y };

package/dist/index.d.mts

@@ -1,13 +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-BAkQThnl.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-yDK-MM3G.mjs";
+import { _ as raw, c as MachineConfigOptions, d as XStateTSOptions, f as contextSchemaToTSType, g as jsonSchemaToTSType, h as graphToXStateTS, i as CodeGenGraph, m as graphToMachineConfig, o as GraphPatch, p as eventsSchemaToTSType, t as ActionLocation, u as RawCode, v as serializeJS } from "./index-BABex8NE.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-B4WM_nYg.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-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-lL7wPLnL.mjs";
-import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
+import { AssetConfig, EmbedEntity, EmbedFormatContext, EmbedFormatDefinition, EmbedGraph, EmbedProfileDefinition, 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-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-YSppd-am.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-CjnsqD8j.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";
@@ -33,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, 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 };
+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 EmbedEntity, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedFormatContext, type EmbedFormatDefinition, type EmbedGraph, type EmbedMode, type EmbedProfileDefinition, 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,12 +1,12 @@
 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-DoNMw8g6.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-CNeiHhaT.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-CCTwvUOB.mjs";
 import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-DHGspwII.mjs";
-import { a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, l as graphToMachineConfig, m as serializeJS, n as getStatelyPragma, o as contextSchemaToTSType, p as raw, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-Cesya0Pk.mjs";
+import { a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, l as graphToMachineConfig, m as serializeJS, n as getStatelyPragma, o as contextSchemaToTSType, p as raw, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-mii-qTXd.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-DU-gHyef.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-CnOHdMYX.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-DU-gHyef.mjs → inspect-CnOHdMYX.mjs}

@@ -1,5 +1,5 @@
 import { INSPECTION_PROTOCOL_VERSION, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
-import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-DoNMw8g6.mjs";
+import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-CNeiHhaT.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
-import "./version-DoNMw8g6.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-DU-gHyef.mjs";
+import "./version-CNeiHhaT.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-CnOHdMYX.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/patchTypes.d.mts

@@ -1,2 +1,2 @@
-import { a as EditorStateType, n as CanvasColor, o as GraphPatch, s as ImplementationSourceType, t as ActionLocation } from "./index-BAkQThnl.mjs";
+import { a as EditorStateType, n as CanvasColor, o as GraphPatch, s as ImplementationSourceType, t as ActionLocation } from "./index-BABex8NE.mjs";
 export { type ActionLocation, type CanvasColor, type EditorStateType, type GraphPatch, type ImplementationSourceType };

package/dist/protocol.d.mts

@@ -1,4 +1,5 @@
-import { i as StatelyGraph } from "./graph-yDK-MM3G.mjs";
+import { l as ProfileManifest } from "./index-BABex8NE.mjs";
+import { i as StatelyGraph } from "./graph-B4WM_nYg.mjs";
 import { c as EditorSyncSourceLocation, f as MachineSourceLocations$1, l as EditorSyncSourceRange, t as EditorCapabilities$1, u as EditorSyncStateSourceLocation } from "./editor-sync-types-C-zWaaVk.mjs";
 
 //#region src/protocol.d.ts
@@ -173,11 +174,30 @@ interface EmbedEventMap {
 }
 type EmbedEventName = keyof EmbedEventMap;
 type EmbedEventHandler<K extends EmbedEventName> = (data: EmbedEventMap[K]) => void;
+interface EmbedFormatManifest {
+  id: string;
+  name: string;
+  file?: {
+    extension?: string;
+    mediaType?: string;
+  };
+  editorLanguage?: string;
+  detect?: boolean;
+  import?: boolean;
+  export?: boolean;
+}
+interface EmbedExtensionsManifest {
+  profiles: ProfileManifest[];
+  formats: EmbedFormatManifest[];
+  defaultProfile?: string;
+  defaultFormat?: string;
+}
 interface MachineInitOptions {
   machine: unknown;
   /** Ephemeral, read-only reference documents owned by the embed host. */
   documents?: EmbedDocument[];
   format?: string;
+  extensions?: EmbedExtensionsManifest;
   mode?: EmbedMode;
   theme?: 'light' | 'dark';
   readOnly?: boolean;
@@ -237,6 +257,7 @@ interface InitMessage {
   machine: unknown;
   documents?: EmbedDocument[];
   format?: string;
+  extensions?: EmbedExtensionsManifest;
   mode?: EmbedMode;
   theme?: 'light' | 'dark';
   readOnly?: boolean;
@@ -539,10 +560,23 @@ interface UploadResponseMessage {
   requestId: string;
   result: UploadResult;
 }
+interface ExtensionCallMessage {
+  type: '@statelyai.extension.call';
+  requestId: string;
+  extensionId: string;
+  method: 'detect' | 'import' | 'export' | 'validate';
+  payload: unknown;
+}
+interface ExtensionResultMessage {
+  type: '@statelyai.extension.result';
+  requestId: string;
+  result?: unknown;
+  error?: string;
+}
 /** All messages a client (embed/inspector) can send to the viz. */
-type ClientMessage = InitMessage | SetApiKeyMessage | EditorHandshakeMessage | SavedMessage | ClipboardReadResponseMessage | ClipboardWriteResponseMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemSelectActorMessage | SystemActorRegisteredMessage | SystemActorEventMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ErrorMessage;
+type ClientMessage = InitMessage | SetApiKeyMessage | EditorHandshakeMessage | SavedMessage | ClipboardReadResponseMessage | ClipboardWriteResponseMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemSelectActorMessage | SystemActorRegisteredMessage | SystemActorEventMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ExtensionResultMessage | ErrorMessage;
 /** All messages the viz can send back to a client. */
-type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage;
+type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage | ExtensionCallMessage;
 interface InspectionClientMetadata {
   name?: string;
   machineId?: string;
@@ -571,4 +605,4 @@ declare const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
 declare const INSPECTION_PROTOCOL_VERSION = 2;
 //#endregion
-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, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId };
+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, EmbedExtensionsManifest, EmbedFormatManifest, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, ExtensionCallMessage, ExtensionResultMessage, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId };

package/dist/{statelyPragma-Cesya0Pk.mjs → statelyPragma-mii-qTXd.mjs}

@@ -1,6 +1,5 @@
 import { a as discriminatedUnion, c as object, d as union, 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 "./schemas-b9wG-zYl.mjs";
 import ts from "typescript";
-import "xstate";
 import "xstate/graph";
 
 //#region ../../node_modules/.pnpm/js-yaml@4.2.0/node_modules/js-yaml/dist/js-yaml.mjs
@@ -4410,6 +4409,92 @@ function guardCondition(value) {
 		firstParam: params.startsWith("(") && params.endsWith(")") ? params.slice(1, -1).trim() : params
 	};
 }
+const V6_ARG_BINDINGS = [
+	"context",
+	"event",
+	"actions",
+	"children",
+	"self",
+	"system"
+];
+const V6_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function inferV6ArgBindings(code) {
+	return V6_ARG_BINDINGS.filter((name) => new RegExp(`\\b${name}\\b`).test(code));
+}
+/** Splits a destructuring pattern body on its top-level commas. */
+function splitV6PatternEntries(body) {
+	const entries = [];
+	let depth = 0;
+	let start = 0;
+	let quote;
+	for (let index = 0; index < body.length; index++) {
+		const char = body[index];
+		if (quote) {
+			if (char === "\\") index++;
+			else if (char === quote) quote = void 0;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") quote = char;
+		else if (char === "{" || char === "[" || char === "(") depth++;
+		else if (char === "}" || char === "]" || char === ")") {
+			depth--;
+			if (depth < 0) return void 0;
+		} else if (char === "," && depth === 0) {
+			entries.push(body.slice(start, index));
+			start = index + 1;
+		}
+	}
+	if (depth !== 0 || quote) return void 0;
+	entries.push(body.slice(start));
+	return entries.map((entry) => entry.trim()).filter(Boolean);
+}
+/** Local name a destructuring entry binds, or `undefined` if not a plain one. */
+function getV6PatternBinding(entry) {
+	const colon = entry.indexOf(":");
+	const name = (colon < 0 ? entry : entry.slice(colon + 1)).split("=")[0].trim();
+	return V6_IDENTIFIER.test(name) ? name : void 0;
+}
+/**
+* Unions the bindings referenced by generated code into the parameter authored
+* on a guard, so a collapsed transition function never references unbound
+* variables. Returns `undefined` when the authored parameter cannot be
+* extended safely, in which case the transition array is kept as-is.
+*/
+function mergeV6FirstParam(authoredFirstParam, inferred) {
+	if (!authoredFirstParam) return {
+		firstParam: inferred.length ? `{ ${inferred.join(", ")} }` : "_",
+		prelude: []
+	};
+	if (inferred.length === 0) return {
+		firstParam: authoredFirstParam,
+		prelude: []
+	};
+	if (V6_IDENTIFIER.test(authoredFirstParam)) {
+		if (inferred.includes(authoredFirstParam)) return void 0;
+		return {
+			firstParam: authoredFirstParam,
+			prelude: [`const { ${inferred.join(", ")} } = ${authoredFirstParam};`]
+		};
+	}
+	if (!authoredFirstParam.startsWith("{") || !authoredFirstParam.endsWith("}")) return;
+	const entries = splitV6PatternEntries(authoredFirstParam.slice(1, -1));
+	if (!entries) return void 0;
+	const bound = new Set(entries.map(getV6PatternBinding).filter((name) => name !== void 0));
+	const missing = inferred.filter((name) => !bound.has(name));
+	if (missing.length === 0) return {
+		firstParam: authoredFirstParam,
+		prelude: []
+	};
+	const restIndex = entries.findIndex((entry) => entry.startsWith("..."));
+	return {
+		firstParam: `{ ${(restIndex < 0 ? [...entries, ...missing] : [
+			...entries.slice(0, restIndex),
+			...missing,
+			...entries.slice(restIndex)
+		]).join(", ")} }`,
+		prelude: []
+	};
+}
 function buildV6TransitionFunction(transitions) {
 	const branches = [];
 	let authoredFirstParam;
@@ -4435,24 +4520,23 @@ function buildV6TransitionFunction(transitions) {
 		if (!returnValue) return;
 		const body = [...rendered.statements.map(formatV6Statement), `return ${returnValue};`];
 		if (body.length === 0) return;
-		if (guard.condition === "true") branches.push(...body.map((line) => `  ${line}`));
-		else {
-			branches.push(`  if (${guard.condition}) {`);
-			branches.push(...body.map((line) => `    ${line}`));
-			branches.push("  }");
-		}
+		branches.push({
+			condition: guard.condition,
+			body
+		});
 	}
 	if (branches.length === 0) return;
-	const referenced = branches.join("\n");
-	const inferredBindings = [
-		"context",
-		"event",
-		"actions",
-		"children",
-		"self",
-		"system"
-	].filter((name) => new RegExp(`\\b${name}\\b`).test(referenced));
-	return raw(`(${authoredFirstParam ?? (inferredBindings.length ? `{ ${inferredBindings.join(", ")} }` : "_")}, enq) => {\n${branches.join("\n")}\n}`);
+	const generated = branches.flatMap((branch) => branch.body).join("\n");
+	const merged = mergeV6FirstParam(authoredFirstParam, inferV6ArgBindings(generated));
+	if (!merged) return;
+	const lines = merged.prelude.map((statement) => `  ${statement}`);
+	for (const branch of branches) if (branch.condition === "true") lines.push(...branch.body.map((line) => `  ${line}`));
+	else {
+		lines.push(`  if (${branch.condition}) {`);
+		lines.push(...branch.body.map((line) => `    ${line}`));
+		lines.push("  }");
+	}
+	return raw(`(${merged.firstParam}, enq) => {\n${lines.join("\n")}\n}`);
 }
 function toV6ActionField(actions) {
 	if (actions.length === 1) {
@@ -4470,15 +4554,7 @@ function buildV6ActionFunction(actions, transition) {
 	let returnValue = rendered.contextValue ? `{ context: ${rendered.contextValue} }` : void 0;
 	if (transition) returnValue = buildV6TransitionReturnValue(transition, rendered.contextValue);
 	if (statements.length === 0 && !returnValue) return void 0;
-	const referenced = [...statements, returnValue ?? ""].join("\n");
-	const bindings = [
-		"context",
-		"event",
-		"actions",
-		"children",
-		"self",
-		"system"
-	].filter((name) => new RegExp(`\\b${name}\\b`).test(referenced));
+	const bindings = inferV6ArgBindings([...statements, returnValue ?? ""].join("\n"));
 	return raw(`(${bindings.length ? `{ ${bindings.join(", ")} }` : "_"}, enq) => {\n${[...statements.map((statement) => `  ${formatV6Statement(statement)}`), ...returnValue ? [`  return ${returnValue};`] : []].join("\n")}\n}`);
 }
 function formatV6Statement(statement) {

package/dist/{studio-YSppd-am.d.mts → studio-CjnsqD8j.d.mts}

@@ -1,4 +1,4 @@
-import { A as $strip, C as ZodObject, D as ZodUnion, E as ZodString, O as ZodUnknown, S as ZodNumber, T as ZodRecord, b as ZodLiteral, k as output, v as ZodArray, w as ZodOptional, x as ZodNullable, y as ZodEnum } from "./index-BAkQThnl.mjs";
+import { A as output, C as ZodNumber, D as ZodString, E as ZodRecord, O as ZodUnion, S as ZodNullable, T as ZodOptional, b as ZodEnum, j as $strip, k as ZodUnknown, w as ZodObject, x as ZodLiteral, y as ZodArray } from "./index-BABex8NE.mjs";
 import { n as StatelyCredential, t as StatelyAuthMode } from "./auth-B0ZTKri2.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-YSppd-am.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-CjnsqD8j.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-yDK-MM3G.mjs";
-import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-YSppd-am.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-B4WM_nYg.mjs";
+import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-CjnsqD8j.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
 //#region src/sync.d.ts

package/dist/sync.mjs

@@ -1,5 +1,5 @@
 import { r as createStatelyClient } from "./studio-DHGspwII.mjs";
-import { f as normalizeMachineProfile, h as xstateSourceToConfig, i as INLINE_EXPRESSION_DIRECTIVE_FIELDS, m as serializeJS, n as getStatelyPragma, r as upsertStatelyPragma, s as detectXStateSourceProfile, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-Cesya0Pk.mjs";
+import { f as normalizeMachineProfile, h as xstateSourceToConfig, i as INLINE_EXPRESSION_DIRECTIVE_FIELDS, m as serializeJS, n as getStatelyPragma, r as upsertStatelyPragma, s as detectXStateSourceProfile, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-mii-qTXd.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import * as ts$1 from "typescript";
 import ts from "typescript";

package/dist/{version-DoNMw8g6.mjs → version-CNeiHhaT.mjs}

@@ -134,6 +134,7 @@ function toInitMessage(options) {
 		machine: options.machine,
 		documents: options.documents,
 		format: options.format,
+		extensions: options.extensions,
 		mode: options.mode,
 		theme: options.theme,
 		readOnly: options.readOnly,
@@ -159,9 +160,9 @@ function createPostMessageTransport(options) {
 	const messageHandlers = /* @__PURE__ */ new Set();
 	function handleMessage(e) {
 		if (destroyed) return;
+		const expectedSource = options.source ?? iframe.contentWindow;
+		if (e.source !== expectedSource) return;
 		if (targetOrigin !== "*") {
-			const expectedSource = options.source ?? iframe.contentWindow;
-			if (e.source !== expectedSource) return;
 			if (e.origin !== targetOrigin) return;
 		}
 		const data = e.data;
@@ -328,7 +329,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.20.3";
+const SDK_VERSION = "0.21.0";
 function inspectionRuntime() {
 	if (typeof window !== "undefined") return "browser";
 	if (typeof process !== "undefined" && process.versions?.node) return "node";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.20.3",
+  "version": "0.21.0",
   "license": "MIT",
   "bin": {
     "stately-sdk": "./dist/bin.mjs"
@@ -93,8 +93,8 @@
     "jsdom": "^27.4.0",
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
-    "@statelyai/api-contract": "0.3.4",
-    "@statelyai/graph-tools": "0.1.1"
+    "@statelyai/api-contract": "0.3.6",
+    "@statelyai/graph-tools": "0.2.0"
   },
   "engines": {
     "node": ">=22.4"