@statelyai/sdk 0.25.0 → 0.26.0

package/README.md

@@ -59,6 +59,13 @@ 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.
 
+<!-- Embed version configuration and events from src/embed.ts and src/protocol.ts -->
+
+Automatic version capture is opt-in. Pass `versionAutoSave: { intervalMs }` to
+the embed and handle `versionSaveRequested` to persist immutable snapshots in
+the host, or omit it to keep versioning manual. Hosts with server-side
+auto-versioning should choose one capture path per save.
+
 Restrict an embed by passing a resolved access policy:
 
 <!-- restricted MachineInitOptions from src/protocol.ts -->
@@ -115,6 +122,7 @@ Key capabilities:
 - **Comments** via Liveblocks integration (optional)
 - **Asset uploads** with built-in S3 and Supabase adapters, or bring your own upload handler
 - **Runtime settings** - toggle color mode, grid, snap lines, and view mode on the fly
+- **Automatic versions** - optionally request host-owned immutable snapshots at a configured interval
 
 ### Resource API client
 

package/dist/embed.d.mts

@@ -1,6 +1,6 @@
-import { i as ProfileManifest } from "./index-DuvCSThi.mjs";
-import { i as StatelyGraph } from "./graph-BGUND7ZF.mjs";
-import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExtensionsManifest, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceProject, UploadResult } from "./protocol.mjs";
+import { i as ProfileManifest } from "./index-DKRB-u93.mjs";
+import { i as StatelyGraph } from "./graph-DoUReqxz.mjs";
+import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExtensionsManifest, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, MachineVersionAutoSaveOptions, ProjectEmbedMachine, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceProject, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
 //#region src/embed.d.ts
@@ -104,6 +104,7 @@ interface StatelyEmbedOptions extends Partial<MachineInitOptions> {
   onLoaded?: (graph: StatelyGraph) => void;
   onChange?: (graph: StatelyGraph, machineConfig: unknown) => void;
   onSave?: (graph: StatelyGraph, machineConfig: unknown) => void;
+  onVersionSaveRequested?: (event: EmbedEventMap['versionSaveRequested']) => void;
   onViewModeChanged?: (viewMode: 'graph' | 'list') => void;
   onError?: (error: {
     code: string;
@@ -150,4 +151,4 @@ interface StatelyEmbed {
 }
 declare function createStatelyEmbed(options: StatelyEmbedOptions): StatelyEmbed;
 //#endregion
-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, type ProjectWorkspaceAction, type ProjectWorkspaceActionIcon, type ProjectWorkspaceCapabilities, type ProjectWorkspaceConfig, type ProjectWorkspaceMachine, type ProjectWorkspaceProject, 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 MachineVersionAutoSaveOptions, type ProjectEmbedMachine, type ProjectWorkspaceAction, type ProjectWorkspaceActionIcon, type ProjectWorkspaceCapabilities, type ProjectWorkspaceConfig, type ProjectWorkspaceMachine, type ProjectWorkspaceMachineOrigin, type ProjectWorkspaceProject, StatelyEmbed, StatelyEmbedOptions, type UploadResult, createStatelyEmbed };

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-BfcJU2pO.mjs";
+import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-u0s4xat2.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 
 //#region src/embed.ts
@@ -87,7 +87,8 @@ function extractInitOptions(options) {
 		projectWorkspace: options.projectWorkspace,
 		projectWorkspaceOpen: options.projectWorkspaceOpen,
 		settings: options.settings,
-		unsavedIndicator: options.unsavedIndicator
+		unsavedIndicator: options.unsavedIndicator,
+		versionAutoSave: options.versionAutoSave
 	};
 	if (options.machine !== void 0) return {
 		machine: options.machine,
@@ -104,7 +105,8 @@ function extractInitOptions(options) {
 		comments: options.comments,
 		sourceLocations: options.sourceLocations,
 		settings: options.settings,
-		unsavedIndicator: options.unsavedIndicator
+		unsavedIndicator: options.unsavedIndicator,
+		versionAutoSave: options.versionAutoSave
 	};
 	return null;
 }
@@ -288,6 +290,21 @@ function createStatelyEmbed(options) {
 				});
 				break;
 			}
+			case "@statelyai.versionSaveRequested": {
+				const version = data;
+				const event = {
+					graph: version.graph,
+					machineConfig: version.machineConfig,
+					machineId: version.machineId,
+					patches: version.patches,
+					createdBy: version.createdBy,
+					captureType: version.captureType,
+					sourceLocations: version.sourceLocations
+				};
+				options.onVersionSaveRequested?.(event);
+				events.emit("versionSaveRequested", event);
+				break;
+			}
 			case "@statelyai.project.machineSelected":
 				events.emit("machineSelected", { machineId: String(data.machineId) });
 				break;

package/dist/{graph-BGUND7ZF.d.mts → graph-DoUReqxz.d.mts}

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

package/dist/{index-DuvCSThi.d.mts → index-DKRB-u93.d.mts}

@@ -2199,6 +2199,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
     description: ZodOptional<ZodString>;
     initialId: ZodOptional<ZodNullable<ZodString>>;
     initialInput: ZodOptional<ZodUnknown>;
+    output: ZodOptional<ZodUnknown>;
     timeout: ZodOptional<ZodUnknown>;
     route: ZodOptional<ZodUnknown>;
   }, $strip>;
@@ -2278,9 +2279,10 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
     final: "final";
     choice: "choice";
   }>>>;
-  stateDescription: ZodOptional<ZodString>;
+  stateDescription: ZodOptional<ZodNullable<ZodString>>;
   initialId: ZodOptional<ZodNullable<ZodString>>;
   initialInput: ZodOptional<ZodUnknown>;
+  output: ZodOptional<ZodUnknown>;
   timeout: ZodOptional<ZodUnknown>;
   route: ZodOptional<ZodUnknown>;
   color: ZodOptional<ZodNullable<ZodEnum<{
@@ -2339,7 +2341,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   sourceId: ZodOptional<ZodString>;
   targetId: ZodOptional<ZodString>;
   eventType: ZodOptional<ZodString>;
-  matches: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
+  matches: ZodOptional<ZodNullable<ZodRecord<ZodString, ZodUnknown>>>;
   transitionType: ZodOptional<ZodEnum<{
     normal: "normal";
     targetless: "targetless";
@@ -2434,11 +2436,11 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   nodeId: ZodString;
   invokeId: ZodString;
   data: ZodObject<{
-    invocationId: ZodOptional<ZodString>;
+    invocationId: ZodOptional<ZodNullable<ZodString>>;
     src: ZodOptional<ZodString>;
     srcExpression: ZodOptional<ZodUnknown>;
-    code: ZodOptional<ZodString>;
-    registryKey: ZodOptional<ZodString>;
+    code: ZodOptional<ZodNullable<ZodString>>;
+    registryKey: ZodOptional<ZodNullable<ZodString>>;
     timeout: ZodOptional<ZodUnknown>;
     input: ZodOptional<ZodUnknown>;
     output: ZodOptional<ZodUnknown>;
@@ -2474,7 +2476,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   implementationId: ZodString;
   data: ZodObject<{
     name: ZodOptional<ZodString>;
-    code: ZodOptional<ZodString>;
+    code: ZodOptional<ZodNullable<ZodString>>;
   }, $strip>;
 }, $strip>, ZodObject<{
   op: ZodLiteral<"deleteImplementation">;
@@ -2533,7 +2535,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
 }, $strip>, ZodObject<{
   op: ZodLiteral<"setContext">;
   description: ZodOptional<ZodString>;
-  context: ZodRecord<ZodString, ZodUnknown>;
+  context: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
 }, $strip>, ZodObject<{
   op: ZodLiteral<"updateSchemas">;
   description: ZodOptional<ZodString>;
@@ -2945,6 +2947,8 @@ interface XStateTSOptions extends MachineConfigOptions {
   xstateV6SchemaFormat?: 'types' | 'zod';
 }
 declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions): string; //#endregion
+//#region src/emittedNodeIds.d.ts
+//#endregion
 //#region src/jsonSchemaToTSType.d.ts
 declare function jsonSchemaToTSType(schema: JSONSchema7 | undefined | null): string;
 /**

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-DuvCSThi.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-BGUND7ZF.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, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceProject, UploadResult, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.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-DKRB-u93.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-DoUReqxz.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, MachineVersionAutoSaveOptions, ProjectEmbedMachine, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceProject, 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 { 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-DTXKcLhR.mjs";
 import { AssetConfig, EmbedEntity, EmbedFormatContext, EmbedFormatDefinition, EmbedGraph, EmbedProfileDefinition, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
 import { _ as createWebSocketTransport, a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, g as createPostMessageTransport, h as TransportFailure, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-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-erXbdakn.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-B6P177N3.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 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 ProjectWorkspaceAction, type ProjectWorkspaceActionIcon, type ProjectWorkspaceCapabilities, type ProjectWorkspaceConfig, type ProjectWorkspaceMachine, type ProjectWorkspaceProject, 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 MachineVersionAutoSaveOptions, 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 ProjectWorkspaceAction, type ProjectWorkspaceActionIcon, type ProjectWorkspaceCapabilities, type ProjectWorkspaceConfig, type ProjectWorkspaceMachine, type ProjectWorkspaceMachineOrigin, type ProjectWorkspaceProject, 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-BfcJU2pO.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-u0s4xat2.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { i as fetchEditorSyncAccess, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-BwS-EiBJ.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-B-axv279.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-QlXh72hZ.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-DNM-Qs93.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-QlXh72hZ.mjs → inspect-DNM-Qs93.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-BfcJU2pO.mjs";
+import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-u0s4xat2.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
@@ -95,7 +95,10 @@ function createInspector(options = {}) {
 		rejectReady = reject;
 	});
 	ready.catch(() => {});
+	const INIT_PLACEHOLDER = { __pendingInit: true };
+	const isInitPlaceholder = (message) => message === INIT_PLACEHOLDER;
 	const pendingMessages = [];
+	let initQueueIndex = null;
 	const events = createEventRegistry();
 	const localListeners = {};
 	const transport = injectedTransport ?? createWebSocketTransport({
@@ -110,8 +113,18 @@ function createInspector(options = {}) {
 	});
 	const ownsTransport = !injectedTransport;
 	const exportManager = createPendingExportManager((message) => send(message));
+	/**
+	* Build the queued init payload now, so it captures the actor tree as it was
+	* before whatever is being queued next.
+	*/
+	function materializePendingInit() {
+		if (initQueueIndex === null) return;
+		if (pendingMessages[initQueueIndex] !== INIT_PLACEHOLDER) return;
+		pendingMessages[initQueueIndex] = buildInitMessage();
+	}
 	function send(msg) {
 		if (!transport.ready) {
+			materializePendingInit();
 			pendingMessages.push(msg);
 			return;
 		}
@@ -123,11 +136,14 @@ function createInspector(options = {}) {
 			transportWasReady = true;
 			if (!initSent) sendInit();
 			const queued = pendingMessages.splice(0);
-			for (const message of queued) transport.send(message);
+			initQueueIndex = null;
+			for (const message of queued) if (isInitPlaceholder(message)) transport.send(buildInitMessage());
+			else transport.send(message);
 			readySettled = true;
 			resolveReady();
 		} else {
 			pendingMessages.length = 0;
+			initQueueIndex = null;
 			initSent = false;
 			sendInit();
 		}
@@ -292,11 +308,11 @@ function createInspector(options = {}) {
 	}
 	const inspectedRoots = /* @__PURE__ */ new Map();
 	const observedRootIds = /* @__PURE__ */ new Set();
-	function sendInit() {
+	function buildInitMessage() {
 		for (const [rootActorId, { actor }] of inspectedRoots) backfillActorTree(actor, rootActorId);
 		const allEntries = Array.from(actors.values());
 		const selectedSessionId = configuredSelectedSessionId ?? selectedActorId ?? observedRootIds.values().next().value ?? allEntries[0]?.sessionId;
-		send({
+		return {
 			type: "@statelyai.system.init",
 			protocolVersion: INSPECTION_PROTOCOL_VERSION,
 			mode: "inspecting",
@@ -309,7 +325,13 @@ function createInspector(options = {}) {
 			...panels?.leftPanels && { leftPanels: panels.leftPanels },
 			...panels?.rightPanels && { rightPanels: panels.rightPanels },
 			...panels?.activePanels && { activePanels: panels.activePanels }
-		});
+		};
+	}
+	function sendInit() {
+		if (!transport.ready) {
+			if (initQueueIndex === null) initQueueIndex = pendingMessages.push(INIT_PLACEHOLDER) - 1;
+			else if (pendingMessages[initQueueIndex] !== INIT_PLACEHOLDER) pendingMessages[initQueueIndex] = buildInitMessage();
+		} else transport.send(buildInitMessage());
 		initSent = true;
 	}
 	function handleActor(actorRef, rootActorId, details) {
@@ -433,6 +455,7 @@ function createInspector(options = {}) {
 	}
 	function handleInspectionEvent(inspectionEvent) {
 		if (destroyed) return;
+		materializePendingInit();
 		const event = inspectionEvent;
 		const rootActorId = rootSessionIdOf(event.rootId, event.actorRef);
 		const isNewRoot = !observedRootIds.has(rootActorId);
@@ -484,6 +507,7 @@ function createInspector(options = {}) {
 		const rootActorId = sessionIdOf(root);
 		const existing = inspectedRoots.get(rootActorId);
 		if (existing) return existing.subscription;
+		materializePendingInit();
 		resolveActorTreeSessionIds(root);
 		observedRootIds.add(rootActorId);
 		const subscription = root.system.inspect(handleInspectionEvent);
@@ -521,7 +545,7 @@ function createInspector(options = {}) {
 			machineConfig: opts?.machine ?? null
 		};
 		actors.set(sessionId, entry);
-		if (!initSent) sendInit();
+		if (!initSent || !transport.ready) sendInit();
 		else send({
 			type: "@statelyai.system.actorRegistered",
 			sessionId,
@@ -535,6 +559,7 @@ function createInspector(options = {}) {
 	function manualSnapshot(actorId, snapshot, event) {
 		const sessionId = getManualSessionId(actorId);
 		if (!actors.has(sessionId)) manualRegister(actorId);
+		materializePendingInit();
 		const entry = actors.get(sessionId);
 		const previousSnapshot = entry.snapshot;
 		const inspectedSnapshot = {
@@ -566,12 +591,14 @@ function createInspector(options = {}) {
 		const eventObj = typeof event === "string" ? { type: event } : { ...event };
 		const sessionId = getManualSessionId(actorId);
 		if (!actors.has(sessionId)) manualRegister(actorId);
+		materializePendingInit();
 		handleEvent(sessionId, eventObj, eventOpts?.source ? getManualSessionId(eventOpts.source) : null);
 	}
 	function manualStop(actorId) {
 		const sessionId = getManualSessionId(actorId);
 		const entry = actors.get(sessionId);
 		if (!entry || entry.stopped) return;
+		materializePendingInit();
 		entry.stopped = true;
 		if (initSent) send({
 			type: "@statelyai.system.actorStopped",
@@ -634,6 +661,7 @@ function createInspector(options = {}) {
 			observedRootIds.clear();
 			pendingTransitions.clear();
 			pendingMessages.length = 0;
+			initQueueIndex = null;
 			for (const set of Object.values(localListeners)) set?.clear();
 		}
 	};

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
-import "./version-BfcJU2pO.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-QlXh72hZ.mjs";
+import "./version-u0s4xat2.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-DNM-Qs93.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-DuvCSThi.mjs";
+import { _ as GraphPatch, g as EditorStateType, h as CanvasColor, m as ActionLocation, v as ImplementationSourceType } from "./index-DKRB-u93.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-DuvCSThi.mjs";
-import { i as StatelyGraph } from "./graph-BGUND7ZF.mjs";
+import { i as ProfileManifest } from "./index-DKRB-u93.mjs";
+import { i as StatelyGraph } from "./graph-DoUReqxz.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
@@ -37,6 +37,9 @@ interface ProjectEmbedMachine {
   name?: string;
   /** Optional host project scope for machine-to-machine references. */
   projectId?: string;
+  createdAt?: number;
+  updatedAt?: number;
+  origin?: ProjectWorkspaceMachineOrigin;
   machine: unknown;
 }
 type ProjectWorkspaceActionIcon = 'arrow-left' | 'copy' | 'fork' | 'history';
@@ -46,9 +49,33 @@ interface ProjectWorkspaceAction {
   icon?: ProjectWorkspaceActionIcon;
   disabled?: boolean;
 }
+interface ProjectWorkspaceMachineOrigin {
+  parentMachineId: string;
+  type: 'version' | 'fork';
+  createdBy?: {
+    type: string;
+    id?: string;
+    name?: string;
+  };
+  captureType?: string;
+}
+/** Opt-in host-facing automatic version capture policy. */
+interface MachineVersionAutoSaveOptions {
+  /** Minimum time between automatic versions, in milliseconds. */
+  intervalMs: number;
+  createdBy?: {
+    type: string;
+    id?: string;
+    name?: string;
+  };
+  captureType?: string;
+}
 interface ProjectWorkspaceMachine {
   id: string;
   name?: string;
+  createdAt?: number;
+  updatedAt?: number;
+  origin?: ProjectWorkspaceMachineOrigin;
 }
 interface ProjectWorkspaceProject {
   id: string;
@@ -60,6 +87,8 @@ interface ProjectWorkspaceProject {
 interface ProjectWorkspaceCapabilities {
   renameProject?: ProjectWorkspaceAction;
   createMachine?: ProjectWorkspaceAction;
+  createMachineVersion?: ProjectWorkspaceAction;
+  restoreMachineVersion?: ProjectWorkspaceAction;
   renameMachine?: ProjectWorkspaceAction;
   copyMachine?: ProjectWorkspaceAction;
   deleteMachine?: ProjectWorkspaceAction;
@@ -81,7 +110,7 @@ interface ProjectWorkspaceConfigBase {
 }
 /** Serializable workspace tree rendered by project-mode embeds. */
 type ProjectWorkspaceConfig = (ProjectWorkspaceConfigBase & {
-  /** Single-project mode: hides project CRUD and flattens its machines. */project: ProjectWorkspaceProject;
+  /** Single-project mode: hides project CRUD for this project. */project: ProjectWorkspaceProject;
   projects?: never;
 }) | (ProjectWorkspaceConfigBase & {
   /** Multi-project mode: renders a collapsible project tree. */projects: ProjectWorkspaceProject[];
@@ -209,6 +238,15 @@ interface EmbedEventMap {
     validations?: ValidationIssue[];
     sourceLocations?: MachineSourceLocations;
   };
+  versionSaveRequested: {
+    graph: StatelyGraph;
+    machineConfig: unknown;
+    machineId?: string;
+    patches?: unknown[];
+    createdBy: NonNullable<MachineVersionAutoSaveOptions['createdBy']>;
+    captureType: string;
+    sourceLocations?: MachineSourceLocations;
+  };
   error: {
     code: string;
     message: string;
@@ -291,6 +329,8 @@ interface MachineInitOptions {
     enabled?: boolean;
     mode?: 'structural' | 'all';
   };
+  /** Omit to disable automatic version requests. */
+  versionAutoSave?: MachineVersionAutoSaveOptions;
 }
 interface ProjectInitOptions {
   machines: ProjectEmbedMachine[];
@@ -315,6 +355,8 @@ interface ProjectInitOptions {
     enabled?: boolean;
     mode?: 'structural' | 'all';
   };
+  /** Omit to disable automatic version requests. */
+  versionAutoSave?: MachineVersionAutoSaveOptions;
 }
 type InitOptions = MachineInitOptions | ProjectInitOptions;
 interface InitMessage {
@@ -340,6 +382,7 @@ interface InitMessage {
     enabled?: boolean;
     mode?: 'structural' | 'all';
   };
+  versionAutoSave?: MachineVersionAutoSaveOptions;
 }
 interface SetApiKeyMessage {
   type: '@statelyai.setApiKey';
@@ -389,6 +432,7 @@ interface ProjectInitMessage {
     enabled?: boolean;
     mode?: 'structural' | 'all';
   };
+  versionAutoSave?: MachineVersionAutoSaveOptions;
   sessionId?: string;
 }
 interface ProjectUpdateMessage {
@@ -575,6 +619,16 @@ interface SaveMessage {
   validations?: ValidationIssue[];
   sourceLocations?: MachineSourceLocations;
 }
+interface VersionSaveRequestedMessage {
+  type: '@statelyai.versionSaveRequested';
+  graph: StatelyGraph;
+  machineConfig: unknown;
+  machineId?: string;
+  patches?: unknown[];
+  createdBy: NonNullable<MachineVersionAutoSaveOptions['createdBy']>;
+  captureType: string;
+  sourceLocations?: MachineSourceLocations;
+}
 interface ProjectMachineSelectedMessage {
   type: '@statelyai.project.machineSelected';
   machineId: string;
@@ -665,7 +719,7 @@ interface ExtensionResultMessage {
 /** All messages a client (embed/inspector) can send to the viz. */
 type ClientMessage = InitMessage | SetApiKeyMessage | EditorHandshakeMessage | SavedMessage | ClipboardReadResponseMessage | ClipboardWriteResponseMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | ProjectSetWorkspaceOpenMessage | 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 | ProjectWorkspaceActionMessage | ProjectWorkspaceOpenChangedMessage | ViewModeChangedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage | ExtensionCallMessage;
+type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | VersionSaveRequestedMessage | ProjectMachineSelectedMessage | ProjectWorkspaceActionMessage | ProjectWorkspaceOpenChangedMessage | ViewModeChangedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage | ExtensionCallMessage;
 interface InspectionClientMetadata {
   name?: string;
   machineId?: string;
@@ -694,4 +748,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, 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, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, ViewModeChangedMessage, 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, MachineVersionAutoSaveOptions, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VersionSaveRequestedMessage, ViewModeChangedMessage, VizMessage, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId };

package/dist/{studio-erXbdakn.d.mts → studio-B6P177N3.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-DuvCSThi.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-DKRB-u93.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-erXbdakn.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-B6P177N3.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-BGUND7ZF.mjs";
-import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-erXbdakn.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-DoUReqxz.mjs";
+import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-B6P177N3.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
 //#region src/sync.d.ts

package/dist/{version-BfcJU2pO.mjs → version-u0s4xat2.mjs}

@@ -130,7 +130,8 @@ function toInitMessage(options) {
 		projectWorkspace: options.projectWorkspace,
 		projectWorkspaceOpen: options.projectWorkspaceOpen,
 		settings: options.settings,
-		unsavedIndicator: options.unsavedIndicator
+		unsavedIndicator: options.unsavedIndicator,
+		versionAutoSave: options.versionAutoSave
 	};
 	return {
 		type: "@statelyai.init",
@@ -150,7 +151,8 @@ function toInitMessage(options) {
 		comments: options.comments,
 		sourceLocations: options.sourceLocations,
 		settings: options.settings,
-		unsavedIndicator: options.unsavedIndicator
+		unsavedIndicator: options.unsavedIndicator,
+		versionAutoSave: options.versionAutoSave
 	};
 }
 
@@ -333,7 +335,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.25.0";
+const SDK_VERSION = "0.26.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.25.0",
+  "version": "0.26.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.9",
-    "@statelyai/graph-tools": "0.3.0"
+    "@statelyai/api-contract": "0.3.11",
+    "@statelyai/graph-tools": "0.4.0"
   },
   "engines": {
     "node": ">=22.4"