@statelyai/sdk 0.22.0 → 0.23.0

package/README.md

@@ -94,6 +94,9 @@ CLI and editor-extension hosts use `EditorHostSession` from
 clipboard requests, and editor protocol negotiation. Use
 `createRemoteEditorSyncBackend` for two-way validation of the versioned Editor
 Sync HTTP contract.
+Remote authentication failures are surfaced as `EditorSyncError` with HTTP
+status and protocol error code metadata so hosts can refresh credentials and
+retry once without depending on response-message text.
 Hosts keep ownership of files, credentials, UI, and transport adapters.
 
 Key capabilities:
@@ -237,10 +240,11 @@ may be producer-resolved. A room uses `producerId + sessionId` as the global
 actor identity.
 Observations captured before the first transport registration replay in order
 after the initial actor-tree baseline. Reconnects use the latest checkpoint.
-In Node, the inspector opens in the default browser automatically. The SDK
-connects to `wss://sky.stately.ai` and generates a UUID v4 `?r=` room bearer
-capability. Multiple producers and viewers can share that room. Anyone with the
-URL can inspect its data, so keep it private. Hosted replay expires after 24
+The SDK connects to `wss://sky.stately.ai`, logs the inspector URL, and does not
+open a browser by default. Pass `launch: 'browser'` to open it explicitly from
+Node. It generates a UUID v4 `?r=` room bearer capability. Multiple producers
+and viewers can share that room. Anyone with the URL can inspect its data, so
+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.
@@ -255,8 +259,11 @@ and request metadata. A source origin can identify a site or customer, so this
 is operational telemetry rather than anonymous data. Pass a self-hosted `url`
 to opt out of Stately-hosted collection.
 
-Set `autoOpen: false`, await `inspector.ready`, and navigate to
-`inspector.inspectorUrl` when a test runner or another process owns the browser.
+`inspector.inspectorUrl` is available immediately. Await `inspector.ready` when
+the next step depends on successful relay registration, or listen for the
+`connected` event when reconnects matter. The default `launch: 'none'` is safe
+for test runners, automation, and CI; pass `launch: 'browser'` only when the SDK
+should open the default browser from Node.
 `inspectorBaseUrl` targets an inspector UI hosted separately from the WebSocket
 relay. An explicit `url` wins over `STATELY_INSPECT_URL`, which wins over the
 hosted default. See `@statelyai/sdk/protocol` for the versioned message and

package/dist/{editorHostSession-HRuIaZ2G.mjs → editorHostSession-BZE_Wm0m.mjs}

@@ -4,6 +4,10 @@ import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs"
 //#region ../api-contract/dist/editor-sync.mjs
 const EDITOR_SYNC_PROTOCOL_VERSION = 1;
 const EDITOR_SYNC_PROTOCOL_HEADER = "X-Stately-Editor-Sync-Version";
+const editorSyncErrorResponseSchema = object({
+	error: string(),
+	code: string().optional()
+}).passthrough();
 const editorCapabilitiesSchema = object({
 	edit: boolean().optional(),
 	export: boolean().optional(),
@@ -102,6 +106,16 @@ const editorSyncAccessResponseSchema = object({ access: editorSyncAccessSchema }
 
 //#endregion
 //#region src/editorHostSession.ts
+var EditorSyncError = class extends Error {
+	status;
+	code;
+	constructor(message, status, code) {
+		super(message);
+		this.name = "EditorSyncError";
+		this.status = status;
+		this.code = code;
+	}
+};
 function createRemoteEditorSyncBackend(options) {
 	const fetchImpl = options.fetch ?? globalThis.fetch;
 	async function post(pathname, body) {
@@ -118,10 +132,7 @@ function createRemoteEditorSyncBackend(options) {
 		});
 		assertEditorSyncResponseProtocol(response);
 		const data = await response.json().catch(() => null);
-		if (!response.ok) {
-			const message = data && typeof data === "object" && "error" in data && typeof data.error === "string" ? data.error : `HTTP ${response.status}`;
-			throw new Error(message);
-		}
+		if (!response.ok) throwEditorSyncError(response.status, data);
 		return data;
 	}
 	return {
@@ -144,12 +155,14 @@ async function fetchEditorSyncAccess(options) {
 	});
 	assertEditorSyncResponseProtocol(response);
 	const data = await response.json().catch(() => null);
-	if (!response.ok) {
-		const message = data && typeof data === "object" && "error" in data && typeof data.error === "string" ? data.error : `HTTP ${response.status}`;
-		throw new Error(message);
-	}
+	if (!response.ok) throwEditorSyncError(response.status, data);
 	return editorSyncAccessResponseSchema.parse(data).access;
 }
+function throwEditorSyncError(status, data) {
+	const parsed = editorSyncErrorResponseSchema.safeParse(data);
+	const error = parsed.success ? parsed.data : void 0;
+	throw new EditorSyncError(error?.error ?? `HTTP ${status}`, status, error?.code);
+}
 function assertEditorSyncResponseProtocol(response) {
 	const selectedVersion = response.headers.get(EDITOR_SYNC_PROTOCOL_HEADER);
 	if (selectedVersion === null || selectedVersion === String(EDITOR_SYNC_PROTOCOL_VERSION)) return;
@@ -476,4 +489,4 @@ function stateSourceLocationUris(sourceLocations) {
 }
 
 //#endregion
-export { createRemoteEditorSyncBackend as n, fetchEditorSyncAccess as r, EditorHostSession as t };
+export { fetchEditorSyncAccess as i, EditorSyncError as n, createRemoteEditorSyncBackend as r, EditorHostSession as t };

package/dist/{editorHostSession-lL7wPLnL.d.mts → editorHostSession-CMwC9KKh.d.mts}

@@ -125,6 +125,11 @@ interface RemoteEditorSyncBackendOptions {
   apiKey?: string;
   fetch?: typeof globalThis.fetch;
 }
+declare class EditorSyncError extends Error {
+  readonly status: number;
+  readonly code: string | undefined;
+  constructor(message: string, status: number, code?: string);
+}
 declare function createRemoteEditorSyncBackend(options: RemoteEditorSyncBackendOptions): EditorSyncBackend;
 declare function fetchEditorSyncAccess(options: RemoteEditorSyncBackendOptions): Promise<EditorSyncAccess>;
 interface EditorSourceHost {
@@ -181,4 +186,4 @@ declare class EditorHostSession {
   private resolveRetrieved;
 }
 //#endregion
-export { RemoteEditorSyncBackendOptions as a, EDITOR_PROTOCOL_VERSION as c, EditorHostInitOptions as d, EditorHostOutboundMessage as f, EditorSyncBackend as i, EditorHostExportFormat as l, EditorHostSessionOptions as n, createRemoteEditorSyncBackend as o, EditorHostValidationIssue as p, EditorSourceHost as r, fetchEditorSyncAccess as s, EditorHostSession as t, EditorHostInboundMessage as u };
+export { EditorSyncError as a, fetchEditorSyncAccess as c, EditorHostInboundMessage as d, EditorHostInitOptions as f, EditorSyncBackend as i, EDITOR_PROTOCOL_VERSION as l, EditorHostValidationIssue as m, EditorHostSessionOptions as n, RemoteEditorSyncBackendOptions as o, EditorHostOutboundMessage as p, EditorSourceHost as r, createRemoteEditorSyncBackend as s, EditorHostSession as t, EditorHostExportFormat as u };

package/dist/editorHostSession.d.mts

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

package/dist/editorHostSession.mjs

@@ -1,5 +1,5 @@
 import "./openapi-BTDjYWXd.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
-import { n as createRemoteEditorSyncBackend, r as fetchEditorSyncAccess, t as EditorHostSession } from "./editorHostSession-HRuIaZ2G.mjs";
+import { i as fetchEditorSyncAccess, n as EditorSyncError, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-BZE_Wm0m.mjs";
 
-export { EDITOR_PROTOCOL_VERSION, EditorHostSession, createRemoteEditorSyncBackend, fetchEditorSyncAccess };
+export { EDITOR_PROTOCOL_VERSION, EditorHostSession, EditorSyncError, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/embed.d.mts

@@ -1,5 +1,5 @@
-import { i as ProfileManifest } from "./index-Bakx1tkW.mjs";
-import { i as StatelyGraph } from "./graph-DYjfFztq.mjs";
+import { i as ProfileManifest } from "./index-D_pO_Pr8.mjs";
+import { i as StatelyGraph } from "./graph-1fwR0Ynl.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";
 

package/dist/embed.mjs

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

package/dist/{graph-DYjfFztq.d.mts → graph-1fwR0Ynl.d.mts}

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

package/dist/{index-Bakx1tkW.d.mts → index-D_pO_Pr8.d.mts}

@@ -2547,7 +2547,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
 type GraphPatch = output<typeof graphPatchSchema>;
 /** AI-only schema: semantic ops + shared ops (no generic graph ops) */
 //#endregion
-//#region ../../node_modules/.pnpm/xstate@6.0.0-alpha.24/node_modules/xstate/dist/declarations/src/index.d.ts
+//#region ../../node_modules/.pnpm/xstate@6.0.0-alpha.47/node_modules/xstate/dist/declarations/src/index.d.ts
 declare global {
   interface SymbolConstructor {
     readonly observable: symbol;

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { _ as GraphPatch, a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, f as raw, l as graphToMachineConfig, m as ActionLocation, n as CodeGenGraph, o as XStateTSOptions, p as serializeJS, r as MachineConfigOptions, s as contextSchemaToTSType, u as graphToXStateTS } from "./index-Bakx1tkW.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-DYjfFztq.mjs";
+import { _ as GraphPatch, a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, f as raw, l as graphToMachineConfig, m as ActionLocation, n as CodeGenGraph, o as XStateTSOptions, p as serializeJS, r as MachineConfigOptions, s as contextSchemaToTSType, u as graphToXStateTS } from "./index-D_pO_Pr8.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-1fwR0Ynl.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 { c as fetchEditorSyncAccess, d as EditorHostInboundMessage, f as EditorHostInitOptions, i as EditorSyncBackend, l as EDITOR_PROTOCOL_VERSION, m as EditorHostValidationIssue, n as EditorHostSessionOptions, o as RemoteEditorSyncBackendOptions, p as EditorHostOutboundMessage, r as EditorSourceHost, s as createRemoteEditorSyncBackend, t as EditorHostSession, u as EditorHostExportFormat } from "./editorHostSession-CMwC9KKh.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-DYI613t_.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-Br_vS_lK.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-CkrbMK00.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 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 };
+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 InspectorConnection, type InspectorDiscoveryEntry, 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,13 +1,13 @@
 import "./openapi-BTDjYWXd.mjs";
 import { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
-import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-3cKMfysA.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-D3ug8VHa.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
-import { n as createRemoteEditorSyncBackend, r as fetchEditorSyncAccess, t as EditorHostSession } from "./editorHostSession-HRuIaZ2G.mjs";
+import { i as fetchEditorSyncAccess, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-BZE_Wm0m.mjs";
 import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-iNSHtNmP.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-CokFTPgT.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-0djA1cnm.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-DDl5w1sy.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-Bz3dcNBH.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-CGJR4iZK.d.mts → inspect-Br_vS_lK.d.mts}

@@ -100,7 +100,16 @@ interface InspectedEvent {
   sourceSessionId: string | null;
   event: unknown;
 }
+interface InspectorConnection {
+  inspectorUrl: string | null;
+  relayUrl: string | null;
+  roomId: string;
+  producerId: string;
+}
+/** Browser-page discovery metadata consumed by the Stately DevTools extension. */
+type InspectorDiscoveryEntry = InspectorConnection;
 interface InspectorEvents {
+  connected: InspectorConnection;
   actor: AdoptedActor;
   event: InspectedEvent;
   snapshot: InspectedSnapshot;
@@ -148,7 +157,9 @@ interface CreateInspectorOptions {
    * is derived from the relay URL by replacing `ws` with `http`.
    */
   inspectorBaseUrl?: string;
-  /** Auto-open browser to visualizer. Default: `true`. */
+  /** How to launch the inspector UI. Defaults to `none` in every runtime. */
+  launch?: 'none' | 'browser';
+  /** @deprecated Use `launch: 'browser'` or `launch: 'none'`. */
   autoOpen?: boolean;
   /**
    * Legacy name for the unguessable room capability.
@@ -260,4 +271,4 @@ declare function createInspector(options?: CreateInspectorOptions): Inspector;
 /** @deprecated Use {@link createInspector}. */
 declare const createStatelyInspector: typeof createInspector;
 //#endregion
-export { InspectedTransition as a, InspectorInspectionEvent as c, createStatelyInspector as d, Transport as f, createWebSocketTransport as h, InspectedSnapshot as i, ManualActorOptions as l, createPostMessageTransport as m, CreateInspectorOptions as n, Inspector as o, TransportFailure as p, InspectedEvent as r, InspectorEvents as s, AdoptedActor as t, createInspector as u };
+export { createWebSocketTransport as _, InspectedTransition as a, InspectorDiscoveryEntry as c, ManualActorOptions as d, createInspector as f, createPostMessageTransport as g, TransportFailure as h, InspectedSnapshot as i, InspectorEvents as l, Transport as m, CreateInspectorOptions as n, Inspector as o, createStatelyInspector as p, InspectedEvent as r, InspectorConnection as s, AdoptedActor as t, InspectorInspectionEvent as u };

package/dist/{inspect-DDl5w1sy.mjs → inspect-Bz3dcNBH.mjs}

@@ -1,9 +1,9 @@
 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-3cKMfysA.mjs";
+import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-D3ug8VHa.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
-	if (typeof process === "undefined" || !process.versions?.node || typeof process.getBuiltinModule !== "function") return;
+	if (typeof process === "undefined" || !process.versions?.node || typeof process.getBuiltinModule !== "function") throw new Error("Opening a browser is not supported in this runtime.");
 	const { spawn } = process.getBuiltinModule("node:child_process");
 	const child = spawn(process.platform === "darwin" ? "open" : process.platform === "win32" ? "powershell.exe" : "xdg-open", process.platform === "win32" ? [
 		"-NoProfile",
@@ -37,6 +37,19 @@ function isStoppedSnapshot(snapshot) {
 	const status = snapshot?.status;
 	return status === "done" || status === "stopped" || status === "error";
 }
+const browserInspectorRegistryKey = "__statelyInspectorsV1";
+function isBrowserRuntime() {
+	return typeof window !== "undefined" && window === globalThis;
+}
+function getBrowserInspectorRegistry() {
+	const global = globalThis;
+	if (!global.__statelyInspectorsV1) Object.defineProperty(global, browserInspectorRegistryKey, {
+		value: /* @__PURE__ */ new Map(),
+		enumerable: false,
+		configurable: true
+	});
+	return global.__statelyInspectorsV1;
+}
 function generateRoomId() {
 	if (!globalThis.crypto?.randomUUID) throw new Error("createInspector() requires crypto.randomUUID() to generate a secure room capability. Pass roomId explicitly in older runtimes.");
 	return globalThis.crypto.randomUUID();
@@ -44,7 +57,8 @@ function generateRoomId() {
 function createInspector(options = {}) {
 	const environmentUrl = typeof process !== "undefined" ? process.env?.STATELY_INSPECT_URL : void 0;
 	const url = options.url ?? environmentUrl ?? "wss://sky.stately.ai";
-	const { inspectorBaseUrl, autoOpen = true, name, serializeSnapshot = defaultSerializeSnapshot, selectedSessionId: configuredSelectedSessionId, selectedActorId, panels, theme, readOnly, depth, capabilities, transport: injectedTransport } = options;
+	const { inspectorBaseUrl, name, serializeSnapshot = defaultSerializeSnapshot, selectedSessionId: configuredSelectedSessionId, selectedActorId, panels, theme, readOnly, depth, capabilities, transport: injectedTransport } = options;
+	const launch = options.launch ?? (options.autoOpen === true ? "browser" : "none");
 	const extractMachine = options.extractMachine ?? options.extractMachineConfig ?? defaultExtractMachineConfig;
 	const roomId = options.roomId ?? options.sessionId ?? getInspectionRoomId(url) ?? generateRoomId();
 	const producerId = options.producerId ?? generateRoomId();
@@ -55,13 +69,24 @@ function createInspector(options = {}) {
 	});
 	const relayUrl = roomUrls?.relayUrl ?? null;
 	const inspectorUrl = roomUrls?.inspectorUrl ?? null;
+	const connection = {
+		inspectorUrl,
+		relayUrl,
+		roomId,
+		producerId
+	};
 	const displayName = name ?? "system:manual";
+	if (inspectorUrl && launch === "none") console.info(`[Stately Inspector] ${inspectorUrl}`);
+	const browserRegistry = isBrowserRuntime() ? getBrowserInspectorRegistry() : void 0;
+	browserRegistry?.set(producerId, connection);
+	const browserLaunchUnsupported = launch === "browser" && isBrowserRuntime();
+	if (browserLaunchUnsupported) console.warn("createInspector({ launch: 'browser' }) cannot open a browser from a browser runtime. Open inspectorUrl from a user gesture or use the Stately DevTools extension.");
 	let destroyed = false;
 	let initSent = false;
 	let initialized = false;
 	let pendingTransportReady = false;
 	let transportWasReady = false;
-	let didAutoOpen = false;
+	let didLaunch = false;
 	let resolveReady;
 	let rejectReady;
 	let readySettled = false;
@@ -106,8 +131,20 @@ function createInspector(options = {}) {
 			initSent = false;
 			sendInit();
 		}
-		if (autoOpen && !didAutoOpen && ownsTransport) {
-			didAutoOpen = true;
+		queueMicrotask(() => {
+			if (!destroyed) emitLocal("connected", connection);
+		});
+		if (launch === "browser" && !didLaunch && ownsTransport) {
+			didLaunch = true;
+			if (browserLaunchUnsupported) {
+				const failure = {
+					code: "unsupported_launch",
+					message: "createInspector({ launch: 'browser' }) is unsupported in browser runtimes."
+				};
+				emitLocal("error", failure);
+				events.emit("error", failure);
+				return;
+			}
 			if (inspectorUrl) openBrowser(inspectorUrl).catch((error) => {
 				const failure = {
 					code: "open_failed",
@@ -581,6 +618,7 @@ function createInspector(options = {}) {
 		destroy() {
 			if (destroyed) return;
 			destroyed = true;
+			if (browserRegistry?.get(producerId) === connection) browserRegistry.delete(producerId);
 			try {
 				for (const { subscription } of inspectedRoots.values()) subscription.unsubscribe();
 			} catch {}

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
 import { EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InspectionAction, InspectionSentEvent, InspectionTakenTransition } from "./protocol.mjs";
-import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, i as InspectedSnapshot, l as ManualActorOptions, n as CreateInspectorOptions, o as Inspector, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-CGJR4iZK.mjs";
-export { AdoptedActor, CreateInspectorOptions, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InspectedEvent, InspectedSnapshot, InspectedTransition, InspectionAction, InspectionSentEvent, InspectionTakenTransition, Inspector, InspectorEvents, InspectorInspectionEvent, ManualActorOptions, Transport, createInspector, createStatelyInspector };
+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-Br_vS_lK.mjs";
+export { AdoptedActor, CreateInspectorOptions, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InspectedEvent, InspectedSnapshot, InspectedTransition, InspectionAction, InspectionSentEvent, InspectionTakenTransition, Inspector, InspectorConnection, InspectorDiscoveryEntry, InspectorEvents, InspectorInspectionEvent, ManualActorOptions, Transport, createInspector, createStatelyInspector };

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
-import "./version-3cKMfysA.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-DDl5w1sy.mjs";
+import "./version-D3ug8VHa.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-Bz3dcNBH.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/patchTypes.d.mts

@@ -1,2 +1,2 @@
-import { _ as GraphPatch, g as EditorStateType, h as CanvasColor, m as ActionLocation, v as ImplementationSourceType } from "./index-Bakx1tkW.mjs";
+import { _ as GraphPatch, g as EditorStateType, h as CanvasColor, m as ActionLocation, v as ImplementationSourceType } from "./index-D_pO_Pr8.mjs";
 export { type ActionLocation, type CanvasColor, type EditorStateType, type GraphPatch, type ImplementationSourceType };

package/dist/protocol.d.mts

@@ -1,5 +1,5 @@
-import { i as ProfileManifest } from "./index-Bakx1tkW.mjs";
-import { i as StatelyGraph } from "./graph-DYjfFztq.mjs";
+import { i as ProfileManifest } from "./index-D_pO_Pr8.mjs";
+import { i as StatelyGraph } from "./graph-1fwR0Ynl.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

package/dist/{statelyPragma-CokFTPgT.mjs → statelyPragma-0djA1cnm.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 "./openapi-BTDjYWXd.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
@@ -2472,7 +2471,7 @@ function stripExportDefault(code) {
 	return trimmed;
 }
 const XSTATE_V5_PROFILE = "@statelyai/xstate@5.30.0";
-const XSTATE_V6_PROFILE = "@statelyai/xstate@6.0.0-alpha.24";
+const XSTATE_V6_PROFILE = "@statelyai/xstate@6.0.0-alpha.47";
 const LEGACY_MACHINE_PROFILES = ["xstate-v5", "xstate-v6-alpha"];
 function normalizeMachineProfile(profile) {
 	return profile === "xstate-v5" ? XSTATE_V5_PROFILE : profile === "xstate-v6-alpha" ? XSTATE_V6_PROFILE : profile;
@@ -2868,10 +2867,11 @@ function graphToMachineConfig(graph, options = {}) {
 		Object.assign(nodeConfig, {
 			id: resolvedNodeId,
 			type: nodeType === "normal" ? void 0 : nodeType ?? void 0,
-			initial: initialNode ? node.data.initialInput !== void 0 ? {
+			initial: initialNode ? nodeType === "history" ? void 0 : node.data.initialInput !== void 0 ? {
 				target: initialNode.data.key,
 				input: node.data.initialInput
 			} : initialNode.data.key : void 0,
+			target: nodeType === "history" && initialNode ? initialNode.data.key : void 0,
 			...node.data.timeout !== void 0 ? { timeout: node.data.timeout } : void 0,
 			...node.data.route !== void 0 ? { route: node.data.route } : void 0,
 			...node.data.entry?.length ? { entry: node.data.entry.map(serializeActionItem) } : void 0,
@@ -3817,10 +3817,28 @@ function guardParams(fn) {
 	if (!param) return "()";
 	return `(${param.getText()})`;
 }
+function transitionContextIdentity(fn) {
+	const parameter = fn.parameters[0]?.name;
+	if (!parameter) return null;
+	if (ts.isIdentifier(parameter)) return `${parameter.text}.context`;
+	if (!ts.isObjectBindingPattern(parameter)) return null;
+	for (const element of parameter.elements) {
+		if (!ts.isIdentifier(element.name)) continue;
+		if ((element.propertyName ? propName(element.propertyName) : element.name.text) === "context") return element.name.text;
+	}
+	return null;
+}
+function omitIdentityTransitionContext(transition, identity) {
+	const context = transition.context;
+	if (!identity || !context || typeof context !== "object" || context["@type"] !== "code" || context.expr !== identity) return transition;
+	const { context: _context, ...rest } = transition;
+	return rest;
+}
 function normalizeFunctionTransition(fn, bindings, depth) {
 	if (fn.body && ts.isBlock(fn.body) && hasUnsafeVariableInitializer(fn.body)) return fallbackFunctionTransition(fn);
 	const branches = ts.isArrowFunction(fn) && !ts.isBlock(fn.body) ? expressionBranches(fn.body, bindings, depth + 1) : fn.body && ts.isBlock(fn.body) ? statementBranches(fn.body.statements, bindings, enqueueParamName(fn)) : [];
 	if (branches.some((branch) => branch.unknown)) return fallbackFunctionTransition(fn);
+	const contextIdentity = transitionContextIdentity(fn);
 	const transitions = branches.map((branch) => {
 		const transition = transitionFromValue(branch.result, branch.actions);
 		if (!transition) return null;
@@ -3832,10 +3850,10 @@ function normalizeFunctionTransition(fn, bindings, depth) {
 			} : transition;
 		}
 		const guard = guardFromConditions(branch.conds, guardParams(fn));
-		return guard ? {
+		return omitIdentityTransitionContext(guard ? {
 			...transition,
 			guard
-		} : transition;
+		} : transition, contextIdentity);
 	}).filter((transition) => Boolean(transition));
 	if (transitions.length === 1) return transitions[0];
 	if (transitions.length > 1) return transitions;
@@ -4059,10 +4077,13 @@ function collectBindings(file) {
 }
 function isCreateMachineCall(node) {
 	const expression = node.expression;
-	if (ts.isIdentifier(expression)) return expression.text === "createMachine";
-	if (ts.isPropertyAccessExpression(expression)) return expression.name.text === "createMachine";
+	if (ts.isIdentifier(expression)) return isMachineFactoryName(expression.text);
+	if (ts.isPropertyAccessExpression(expression)) return isMachineFactoryName(expression.name.text);
 	return false;
 }
+function isMachineFactoryName(name) {
+	return name === "createMachine" || name === "createMachineFromConfig";
+}
 function setupCallForCreateMachine(node, bindings) {
 	if (!ts.isPropertyAccessExpression(node.expression)) return null;
 	let receiver = unwrapExpression(node.expression.expression);
@@ -4122,6 +4143,10 @@ function hasV6Syntax(source) {
 	}
 	function visitMachineCalls(node) {
 		if (ts.isCallExpression(node) && isCreateMachineCall(node)) {
+			if ((ts.isIdentifier(node.expression) ? node.expression.text : ts.isPropertyAccessExpression(node.expression) ? node.expression.name.text : void 0) === "createMachineFromConfig") {
+				found = true;
+				return;
+			}
 			const config = node.arguments[0];
 			if (config) visitSyntax(config);
 			const setupConfig = setupCallForCreateMachine(node, bindings)?.arguments[0];

package/dist/{studio-DYI613t_.d.mts → studio-CkrbMK00.d.mts}

@@ -1,4 +1,4 @@
-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-Bakx1tkW.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-D_pO_Pr8.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-DYI613t_.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-CkrbMK00.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-DYjfFztq.mjs";
-import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-DYI613t_.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-1fwR0Ynl.mjs";
+import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-CkrbMK00.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-iNSHtNmP.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-CokFTPgT.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-0djA1cnm.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import * as ts$1 from "typescript";
 import ts from "typescript";
@@ -155,7 +155,10 @@ function collectXStateSourceLocations(sourceText, document, options = {}) {
 	const rootProfile = detectXStateSourceProfile(sourceText);
 	const referencedStateSymbols = new Set([...states, ...statesObjectLocations].map((state) => state.symbol).filter((symbol) => typeof symbol === "string"));
 	const resolvedTransitionFunctions = collectResolvedTransitionFunctions(root, bindings);
-	const inferredProfile = rootProfile === "xstate-v6-alpha" || resolvedTransitionFunctions.size > 0 || [...referencedStateSymbols].some((symbol) => detectXStateSourceProfile(bindings.get(symbol)?.sourceFile.text ?? "") === "xstate-v6-alpha") ? "xstate-v6-alpha" : rootProfile;
+	const inferredProfile = rootProfile === "xstate-v6-alpha" || resolvedTransitionFunctions.size > 0 || [...referencedStateSymbols].some((symbol) => {
+		const binding = bindings.get(symbol);
+		return binding?.kind === "createStateConfig" || detectXStateSourceProfile(binding?.sourceFile.text ?? "") === "xstate-v6-alpha";
+	}) ? "xstate-v6-alpha" : rootProfile;
 	return {
 		version: 1,
 		profile: packageProfile?.profile ?? inferredProfile,
@@ -701,7 +704,8 @@ function getEnumMemberName(name) {
 	return null;
 }
 function isCreateMachineExpression$1(expression) {
-	return ts$1.isIdentifier(expression) && expression.text === "createMachine" || ts$1.isPropertyAccessExpression(expression) && expression.name.text === "createMachine";
+	const isMachineFactoryName = (name) => name === "createMachine" || name === "createMachineFromConfig";
+	return ts$1.isIdentifier(expression) && isMachineFactoryName(expression.text) || ts$1.isPropertyAccessExpression(expression) && isMachineFactoryName(expression.name.text);
 }
 function unwrapObjectLiteralExpression(expression) {
 	const unwrapped = unwrapExpression$1(expression);

package/dist/{version-3cKMfysA.mjs → version-D3ug8VHa.mjs}

@@ -331,7 +331,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.22.0";
+const SDK_VERSION = "0.23.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.22.0",
+  "version": "0.23.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.6",
-    "@statelyai/graph-tools": "0.2.0"
+    "@statelyai/api-contract": "0.3.8",
+    "@statelyai/graph-tools": "0.2.2"
   },
   "engines": {
     "node": ">=22.4"