@statelyai/sdk 0.14.1 → 0.15.0

package/README.md

@@ -80,9 +80,12 @@ Key capabilities:
 - **Asset uploads** with built-in S3 and Supabase adapters, or bring your own upload handler
 - **Runtime settings** - toggle color mode, grid, snap lines, autolayout, and view mode on the fly
 
-### Studio API client
+### Resource API client
 
-Programmatic access to Stately Studio for managing projects and machines, extracting machine configs from source code, and verifying API keys.
+<!-- StudioClient namespaces, DEFAULT_STATELY_BASE_URL, and StudioApiError from src/studio.ts -->
+
+Programmatic access to hosted Stately resources, credential verification, and
+deterministic machine-config extraction.
 
 ```ts
 import { createStatelyClient } from '@statelyai/sdk';
@@ -96,14 +99,55 @@ const studio = createStatelyClient({
 
 const projects = await studio.projects.list();
 const machine = await studio.machines.get('machine-id');
-const extracted = await studio.code.extractMachines(sourceCode);
+const extracted = await studio.code.extractMachines({
+  code: sourceCode,
+});
 ```
 
+The client namespaces map one-to-one onto the server-owned `/api/v1` contract:
+
+| Method                                             | Operation                                             |
+| -------------------------------------------------- | ------------------------------------------------------ |
+| `auth.verify()`                                    | `GET /api/v1/auth/verify`                             |
+| `projects.list()`                                  | `GET /api/v1/projects`                                |
+| `projects.create(input)`                           | `POST /api/v1/projects`                               |
+| `projects.get(projectId)`                          | `GET /api/v1/projects/:projectId`                     |
+| `projects.update(projectId, input)`                | `PATCH /api/v1/projects/:projectId`                   |
+| `projects.delete(projectId)`                       | `DELETE /api/v1/projects/:projectId`                  |
+| `projects.listMachines(projectId)`                 | `GET /api/v1/projects/:projectId/machines`            |
+| `machines.create(input)`                           | `POST /api/v1/machines`                               |
+| `machines.get(machineId)`                          | `GET /api/v1/machines/:machineId`                     |
+| `machines.getVersion(machineId, versionId)`        | `GET /api/v1/machines/:machineId/versions/:versionId` |
+| `machines.update(machineId, input)`                | `PATCH /api/v1/machines/:machineId`                   |
+| `code.extractMachines(input)`                      | `POST /api/v1/code/extract-machines`                  |
+
+`projects.ensure(input)` is a client workflow composed of `projects.list`,
+`projects.get`, and `projects.create`, not a route.
+
+`baseUrl` defaults to `https://editor.stately.ai`. Do not target
+`stately.ai/registry` directly: Registry URLs are deprecated for clients, and
+the server reaches the Registry itself when it is configured to.
+
+Failed requests reject with `StudioApiError`, carrying `status` plus the
+canonical `code`, optional `issues`, and optional `retryable` flag. Codes are
+`bad_request`, `unauthenticated`, `forbidden`, `not_found`, `conflict`,
+`payload_too_large`, `rate_limited`, `capability_disabled`, `upstream_error`,
+and `internal_error`. Deployments with no resource provider answer resource
+calls with `capability_disabled`; code extraction remains available and infers
+XState v5 or v6 structurally when the version is omitted.
+
+Deprecated inputs from earlier versions still work and normalize before the
+request is sent: `{ id }` update inputs, capitalized `visibility`, an omitted
+or `4` machine-create `xstateVersion` (defaulting to `5`), `machines.get(id, { version })`,
+`machines.createMany` (singular semantics: one machine in a single-element
+array), and `code.extractMachines(code, options)`.
+
 Legacy `apiKey` is still accepted as an alias for
 `credential: { type: 'api_key', token }`. The default `authMode: 'auto'` sends
 a credential when present and otherwise lets the server accept or reject an
 unauthenticated request. Use `authMode: 'bearer'` to require a credential before
 making requests, or `authMode: 'none'` to ignore a configured credential.
+Resource operations always require a credential.
 
 ### Inspector
 
@@ -132,6 +176,8 @@ completed request-scoped runs stay available for inspection.
 
 XState v5 and v6 inspection events normalize to independent actor, event,
 snapshot, and stop observations before crossing the WebSocket protocol.
+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
 generates a cryptographically random session capability; hosted inspectors open
 without requiring login. The session capability controls access to the live
@@ -190,6 +236,7 @@ Key environment variables for self-hosted deployments:
 | Variable                    | Purpose                                           |
 | --------------------------- | ------------------------------------------------- |
 | `AUTH_PROVIDER`             | Auth strategy used by the editor host             |
+| `RESOURCE_PROVIDER`         | Set to `stately` to enable project and machine resource operations; `none` (default) disables them |
 | `EDITOR_SYNC_AUTH_REQUIRED` | Set to `false` to skip editor-sync API-key checks |
 | `NEXT_PUBLIC_BASE_URL`      | Public-facing editor URL                          |
 

package/dist/auth.d.mts

@@ -1,2 +1,2 @@
-import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-DmPZiERd.mjs";
+import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-2Thaw42j.mjs";
 export { StatelyAuthMode, StatelyCredential, createAuthorizationHeader, getCredentialToken };

package/dist/embed.d.mts

@@ -1,3 +1,4 @@
+import { i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
 import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
@@ -49,9 +50,9 @@ interface StatelyEmbedOptions extends Partial<MachineInitOptions> {
   /** Asset upload configuration. If omitted, files are stored as base64 data URLs. */
   assets?: AssetConfig;
   onReady?: () => void;
-  onLoaded?: (graph: unknown) => void;
-  onChange?: (graph: unknown, machineConfig: unknown) => void;
-  onSave?: (graph: unknown, machineConfig: unknown) => void;
+  onLoaded?: (graph: StatelyGraph) => void;
+  onChange?: (graph: StatelyGraph, machineConfig: unknown) => void;
+  onSave?: (graph: StatelyGraph, machineConfig: unknown) => void;
   onError?: (error: {
     code: string;
     message: string;

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

@@ -1,4 +1,4 @@
-import { r as CodeExpression } from "./index-DVjNSTuQ.mjs";
+import { r as CodeExpression } from "./index-ag6K2iAS.mjs";
 import * as _statelyai_graph0 from "@statelyai/graph";
 import { Graph } from "@statelyai/graph";
 
@@ -18,6 +18,7 @@ interface DigraphNodeInvokeData {
 }
 interface DigraphEdgeData {
   eventTypeData: EventTypeData;
+  matches?: Record<string, unknown>;
   guard?: ExtractorGuard;
   transitions?: DigraphEdgeTransition[];
   actions: DigraphAction[];
@@ -203,6 +204,7 @@ interface DigraphData {
 }
 interface DigraphConfig {
   id: string;
+  profile?: 'xstate-v5' | 'xstate-v6-alpha';
   rootNode: DigraphNodeConfig;
   edges: DigraphEdgeConfig[];
   context: Record<string, JsonItem> | JsonExpressionString;
@@ -324,6 +326,7 @@ interface StatelyNodeData {
 }
 interface StatelyEdgeData {
   eventType: string;
+  matches?: Record<string, unknown>;
   transitionType?: 'normal' | 'targetless' | 'reenter';
   guard?: StatelyGuard | null;
   actions?: StatelyAction[];
@@ -332,6 +335,7 @@ interface StatelyEdgeData {
   meta?: Record<string, unknown> | null;
 }
 interface StatelyGraphData {
+  profile?: 'xstate-v5' | 'xstate-v6-alpha';
   schemas?: {
     context?: Record<string, SimpleJsonSchema> | null;
     events?: Record<string, SimpleJsonSchemaObject> | null;

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-R0sbxnZ7.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-DuOeLGvh.mjs";
 export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };

package/dist/graph.mjs

@@ -286,6 +286,7 @@ function toStudioMachine(graph) {
 			} } : {},
 			data: {
 				eventTypeData: toStudioEventTypeData(eventType),
+				...edge.data.matches ? { matches: edge.data.matches } : {},
 				actions: (edge.data.actions ?? []).map(toStudioAction),
 				...edge.data.guard ? { guard: {
 					kind: edge.data.guard.code ? "inline" : "named",
@@ -305,6 +306,7 @@ function toStudioMachine(graph) {
 		edges: studioEdges,
 		context: {},
 		...graph.data?.schemas ? { schemas: normalizeSchemas(graph.data.schemas) } : {},
+		...graph.data?.profile ? { profile: graph.data.profile } : {},
 		...graph.data?.implementations ? { implementations: {
 			actions: Object.fromEntries(graph.data.implementations.actions.map((action) => [action.name, toActionSource(action)])),
 			guards: Object.fromEntries(graph.data.implementations.guards.map((guard) => [guard.name, toGuardSource(guard)])),
@@ -332,6 +334,7 @@ function fromStudioMachine(studioMachine) {
 		} : {},
 		data: {
 			eventType: fromStudioEventTypeData(edge.data.eventTypeData),
+			...edge.data.matches ? { matches: edge.data.matches } : {},
 			transitionType: edge.target ? "normal" : "targetless",
 			...edge.data.guard ? { guard: {
 				type: edge.data.guard.type,
@@ -352,6 +355,7 @@ function fromStudioMachine(studioMachine) {
 		})),
 		edges: edges.map(({ type: _type, ...edge }) => edge),
 		data: {
+			...studioMachine.profile ? { profile: studioMachine.profile } : {},
 			...studioMachine.schemas ? { schemas: studioMachine.schemas } : {},
 			...studioMachine.implementations ? { implementations: {
 				actions: Object.entries(studioMachine.implementations.actions).filter(([key]) => !key.startsWith("inline:")).map(([, source]) => fromActionSource(source)),

package/dist/{index-DVjNSTuQ.d.mts → index-ag6K2iAS.d.mts}

@@ -2129,6 +2129,13 @@ interface ZodReadonly<T extends SomeType = $ZodType> extends _ZodType<$ZodReadon
 }
 declare const ZodReadonly: $constructor<ZodReadonly>;
 //#endregion
+//#region ../../node_modules/.pnpm/xstate@6.0.0-alpha.24/node_modules/xstate/dist/declarations/src/index.d.ts
+declare global {
+  interface SymbolConstructor {
+    readonly observable: symbol;
+  }
+}
+//#endregion
 //#region ../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts
 // ==================================================================================================
 // JSON Schema Draft 07
@@ -2270,6 +2277,10 @@ interface JSONSchema7 {
 //#endregion
 //#region ../graph-tools/dist/index.d.mts
 //#endregion
+//#region src/machineProfile.d.ts
+declare const MACHINE_PROFILES: readonly ["xstate-v5", "xstate-v6-alpha"];
+type MachineProfile = (typeof MACHINE_PROFILES)[number];
+//#endregion
 //#region src/codegenTypes.d.ts
 interface CodeGenAction {
   /** Graph-native block id, referenced by `@statelyai.action.*` transitions. */
@@ -2303,8 +2314,12 @@ interface CodeImport {
 }
 interface CodeGenInvoke {
   src: string;
+  /** Exact authored actor-logic expression for inline/direct actor sources. */
+  srcExpression?: CodeExpression;
   id: string;
   invocationId?: string;
+  registryKey?: string;
+  timeout?: number | string | CodeExpression;
   input?: Record<string, unknown> | CodeExpression;
   output?: Record<string, unknown> | CodeExpression;
 }
@@ -2313,6 +2328,9 @@ interface CodeGenNodeData {
   key: string;
   type?: 'normal' | 'parallel' | 'final' | 'history' | 'choice' | null;
   initialId?: string | null;
+  initialInput?: Record<string, unknown> | CodeExpression;
+  timeout?: number | string | CodeExpression;
+  route?: Record<string, unknown> | CodeExpression;
   history?: 'shallow' | 'deep' | boolean;
   output?: Record<string, unknown> | CodeExpression;
   entry?: CodeGenAction[];
@@ -2329,14 +2347,18 @@ interface CodeGenNodeData {
 }
 interface CodeGenEdgeData {
   eventType: string;
+  matches?: Record<string, unknown>;
   transitionType?: 'normal' | 'targetless' | 'reenter';
   guard?: CodeGenGuard | null;
   context?: Record<string, unknown> | CodeExpression;
+  input?: Record<string, unknown> | CodeExpression;
   actions?: CodeGenAction[];
   description?: string | null;
   color?: string;
   meta?: Record<string, unknown> | null;
   temp?: unknown;
+  /** Derived visualization edge for a destination state's `route` config. */
+  route?: boolean;
 }
 interface CodeGenImplementation {
   id: string;
@@ -2362,6 +2384,7 @@ interface CodeGenActorImplementation {
   } | null;
 }
 interface CodeGenGraphData {
+  profile?: MachineProfile;
   context?: Record<string, unknown> | CodeExpression | null;
   schemas?: {
     context?: Record<string, JSONSchema7> | null;
@@ -2422,6 +2445,12 @@ declare class RawCode {
 }
 declare function raw(code: string): RawCode;
 declare function serializeJS(value: unknown, indent?: number, step?: number): string; //#endregion
+//#region src/v6Simulation.d.ts
+/**
+ * Adapts Viz's serializable choice projection to XState v6's executable
+ * `choice` function. Other v6 config stays untouched.
+ */
+//#endregion
 //#region src/graphToXStateTS.d.ts
 interface XStateTSOptions extends MachineConfigOptions {
   exportStyle?: 'named' | 'default' | 'none';
@@ -2510,6 +2539,9 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
     }>>>;
     description: ZodOptional<ZodString>;
     initialId: ZodOptional<ZodNullable<ZodString>>;
+    initialInput: ZodOptional<ZodUnknown>;
+    timeout: ZodOptional<ZodUnknown>;
+    route: ZodOptional<ZodUnknown>;
   }, $strip>;
 }, $strip>, ZodObject<{
   op: ZodLiteral<"deleteNode">;
@@ -2522,6 +2554,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   sourceId: ZodString;
   targetId: ZodString;
   eventType: ZodString;
+  matches: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
   transitionType: ZodOptional<ZodEnum<{
     normal: "normal";
     targetless: "targetless";
@@ -2535,12 +2568,14 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
     sourceId: ZodOptional<ZodString>;
     targetId: ZodOptional<ZodString>;
     eventType: ZodOptional<ZodString>;
+    matches: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
     transitionType: ZodOptional<ZodEnum<{
       normal: "normal";
       targetless: "targetless";
       reenter: "reenter";
     }>>;
     description: ZodOptional<ZodNullable<ZodString>>;
+    input: ZodOptional<ZodUnknown>;
   }, $strip>;
 }, $strip>, ZodObject<{
   op: ZodLiteral<"deleteEdge">;
@@ -2586,6 +2621,9 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   }>>>;
   stateDescription: ZodOptional<ZodString>;
   initialId: ZodOptional<ZodNullable<ZodString>>;
+  initialInput: ZodOptional<ZodUnknown>;
+  timeout: ZodOptional<ZodUnknown>;
+  route: ZodOptional<ZodUnknown>;
   color: ZodOptional<ZodNullable<ZodEnum<{
     green: "green";
     red: "red";
@@ -2612,6 +2650,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   sourceId: ZodString;
   targetId: ZodString;
   eventType: ZodString;
+  matches: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
   transitionType: ZodOptional<ZodEnum<{
     normal: "normal";
     targetless: "targetless";
@@ -2633,6 +2672,7 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
     teal: "teal";
   }>>>;
   transitionDescription: ZodOptional<ZodNullable<ZodString>>;
+  input: ZodOptional<ZodUnknown>;
 }, $strip>, ZodObject<{
   op: ZodLiteral<"updateTransition">;
   description: ZodOptional<ZodString>;
@@ -2640,12 +2680,14 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   sourceId: ZodOptional<ZodString>;
   targetId: ZodOptional<ZodString>;
   eventType: ZodOptional<ZodString>;
+  matches: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
   transitionType: ZodOptional<ZodEnum<{
     normal: "normal";
     targetless: "targetless";
     reenter: "reenter";
   }>>;
   transitionDescription: ZodOptional<ZodNullable<ZodString>>;
+  input: ZodOptional<ZodUnknown>;
   color: ZodOptional<ZodNullable<ZodEnum<{
     green: "green";
     red: "red";
@@ -2720,9 +2762,12 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
     id: ZodOptional<ZodString>;
     invocationId: ZodOptional<ZodString>;
     src: ZodString;
+    srcExpression: ZodOptional<ZodUnknown>;
     code: ZodOptional<ZodString>;
-    input: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
-    output: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
+    registryKey: ZodOptional<ZodString>;
+    timeout: ZodOptional<ZodUnknown>;
+    input: ZodOptional<ZodUnknown>;
+    output: ZodOptional<ZodUnknown>;
   }, $strip>;
 }, $strip>, ZodObject<{
   op: ZodLiteral<"updateInvoke">;
@@ -2732,9 +2777,12 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   data: ZodObject<{
     invocationId: ZodOptional<ZodString>;
     src: ZodOptional<ZodString>;
+    srcExpression: ZodOptional<ZodUnknown>;
     code: ZodOptional<ZodString>;
-    input: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
-    output: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
+    registryKey: ZodOptional<ZodString>;
+    timeout: ZodOptional<ZodUnknown>;
+    input: ZodOptional<ZodUnknown>;
+    output: ZodOptional<ZodUnknown>;
   }, $strip>;
 }, $strip>, ZodObject<{
   op: ZodLiteral<"deleteInvoke">;
@@ -2840,4 +2888,4 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
 type GraphPatch = output<typeof graphPatchSchema>;
 /** AI-only schema: semantic ops + shared ops (no generic graph ops) */
 //#endregion
-export { serializeJS as _, EditorStateType as a, MachineConfigOptions as c, contextSchemaToTSType as d, eventsSchemaToTSType as f, raw as g, jsonSchemaToTSType as h, CodeGenGraph as i, RawCode as l, graphToXStateTS as m, CanvasColor as n, GraphPatch as o, graphToMachineConfig as p, CodeExpression as r, ImplementationSourceType as s, ActionLocation as t, XStateTSOptions as u };
+export { $strip as A, ZodObject as C, ZodUnion as D, ZodString as E, ZodUnknown as O, ZodNumber as S, ZodRecord as T, serializeJS as _, EditorStateType as a, ZodLiteral as b, MachineConfigOptions as c, contextSchemaToTSType as d, eventsSchemaToTSType as f, raw as g, jsonSchemaToTSType as h, CodeGenGraph as i, output as k, RawCode as l, graphToXStateTS as m, CanvasColor as n, GraphPatch as o, graphToMachineConfig as p, CodeExpression as r, ImplementationSourceType as s, ActionLocation as t, XStateTSOptions as u, ZodArray as v, ZodOptional as w, ZodNullable as x, ZodEnum as y };

package/dist/index.d.mts

@@ -1,12 +1,12 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
+import { _ as serializeJS, c as MachineConfigOptions, d as contextSchemaToTSType, f as eventsSchemaToTSType, g as raw, h as jsonSchemaToTSType, i as CodeGenGraph, l as RawCode, m as graphToXStateTS, o as GraphPatch, p as graphToMachineConfig, t as ActionLocation, u as XStateTSOptions } from "./index-ag6K2iAS.mjs";
+import { C as EventTypeData, S as DigraphNodeConfig, _ as studioMachineConverter, a as StatelyGraphData, b as DigraphConfig, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, o as StatelyGuard, r as StatelyEdgeData, t as StatelyAction, v as toStudioMachine, w as StateNodeJSONData, x as DigraphEdgeConfig, y as DigraphAction } from "./graph-DuOeLGvh.mjs";
 import { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, InitOptions, InspectionAction, InspectionSentEvent, InspectionTakenTransition, ProjectEmbedMachine, UploadResult } 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-DmPZiERd.mjs";
+import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-2Thaw42j.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { _ as serializeJS, c as MachineConfigOptions, d as contextSchemaToTSType, f as eventsSchemaToTSType, g as raw, h as jsonSchemaToTSType, i as CodeGenGraph, l as RawCode, m as graphToXStateTS, o as GraphPatch, p as graphToMachineConfig, t as ActionLocation, u as XStateTSOptions } from "./index-DVjNSTuQ.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-R0sbxnZ7.mjs";
-import { _ as createPostMessageTransport, a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as MultiplexedChannelOptions, g as createMultiplexedWebSocketConnection, h as Transport, i as InspectedSnapshot, l as ManualActorOptions, m as MultiplexedWebSocketConnectionOptions, n as CreateInspectorOptions, o as Inspector, p as MultiplexedWebSocketConnection, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector, v as createWebSocketTransport } from "./inspect-DQ_7I7eH.mjs";
-import { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, UpdateMachineInput, VerifyApiKeyResponse, XStateVersion, createStatelyClient } from "./studio.mjs";
+import { _ as createPostMessageTransport, a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as MultiplexedChannelOptions, g as createMultiplexedWebSocketConnection, h as Transport, i as InspectedSnapshot, l as ManualActorOptions, m as MultiplexedWebSocketConnectionOptions, n as CreateInspectorOptions, o as Inspector, p as MultiplexedWebSocketConnection, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector, v as createWebSocketTransport } from "./inspect-DenVP7IE.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-Da5pyxv6.mjs";
 import { OAuthAuthorizationServerMetadata, OAuthClientRegistrationResponse, OAuthProtectedResourceMetadata, OAuthTokenResponse, PkcePair, buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
 import { CreateInspectionRelayOptions, InspectionRelay, InspectionRelayEffect, InspectionRelayPeer, InspectionRelayRole, InspectionRelaySnapshot, createInspectionRelay } from "./relay.mjs";
@@ -32,4 +32,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, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EditorCapabilities, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesResponse, type ExtractedMachine, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, 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 MachineConfigOptions, type ManualActorOptions, type MultiplexedChannelOptions, type MultiplexedWebSocketConnection, type MultiplexedWebSocketConnectionOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, 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 StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UpdateMachineInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type XStateTSOptions, type XStateVersion, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionRelay, createInspector, createMultiplexedWebSocketConnection, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, 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, type EditorCapabilities, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesInput, type ExtractMachinesResponse, type ExtractedMachine, type ExtractedMachines, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, 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 MultiplexedChannelOptions, type MultiplexedWebSocketConnection, type MultiplexedWebSocketConnectionOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateTSOptions, type XStateVersion, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionRelay, createInspector, createMultiplexedWebSocketConnection, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/index.mjs

@@ -2,13 +2,13 @@ import { n as createPostMessageTransport, r as createWebSocketTransport, t as cr
 import { INSPECTION_PROTOCOL_VERSION } from "./protocol.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-BcKTFJI1.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-DWDTNMEc.mjs";
+import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-txdyJHD7.mjs";
+import { a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, f as raw, l as graphToMachineConfig, n as getStatelyPragma, o as contextSchemaToTSType, p as serializeJS, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-Bm9O4XV6.mjs";
 import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
-import { StudioApiError, createStatelyClient } from "./studio.mjs";
 import { buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { a as eventsSchemaToTSType, c as jsonSchemaToTSType, f as findStatelyPragmaAttachments, l as raw, m as upsertStatelyPragma, n as RawCode, o as graphToMachineConfig, p as getStatelyPragma, r as contextSchemaToTSType, s as graphToXStateTS, u as serializeJS } from "./dist-C8jVuuHf.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 import { createInspectionRelay } from "./relay.mjs";
 
-export { INSPECTION_PROTOCOL_VERSION, RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionRelay, createInspector, createMultiplexedWebSocketConnection, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { DEFAULT_STATELY_BASE_URL, INSPECTION_PROTOCOL_VERSION, RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionRelay, createInspector, createMultiplexedWebSocketConnection, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/{inspect-BcKTFJI1.mjs → inspect-DWDTNMEc.mjs}

@@ -61,6 +61,7 @@ function createInspector(options = {}) {
 	let initSent = false;
 	let initialized = false;
 	let pendingTransportReady = false;
+	let transportWasReady = false;
 	let didAutoOpen = false;
 	const pendingMessages = [];
 	const events = createEventRegistry();
@@ -81,9 +82,16 @@ function createInspector(options = {}) {
 		transport.send(msg);
 	}
 	function handleTransportReady() {
-		pendingMessages.length = 0;
-		initSent = false;
-		sendInit();
+		if (!transportWasReady) {
+			transportWasReady = true;
+			if (!initSent) sendInit();
+			const queued = pendingMessages.splice(0);
+			for (const message of queued) transport.send(message);
+		} else {
+			pendingMessages.length = 0;
+			initSent = false;
+			sendInit();
+		}
 		if (autoOpen && !didAutoOpen && ownsTransport) {
 			didAutoOpen = true;
 			const launchUrl = createInspectorLaunchUrl(url, sessionId);
@@ -372,7 +380,7 @@ function createInspector(options = {}) {
 				break;
 			default: break;
 		}
-		if (isNewRoot && initSent) sendInit();
+		if (isNewRoot) sendInit();
 	}
 	function attachActor(actor) {
 		const root = actor;
@@ -386,7 +394,7 @@ function createInspector(options = {}) {
 			subscription
 		});
 		backfillActorTree(root, rootActorId);
-		if (initSent) sendInit();
+		sendInit();
 		return { unsubscribe() {
 			subscription.unsubscribe();
 			inspectedRoots.delete(rootActorId);
@@ -405,7 +413,8 @@ function createInspector(options = {}) {
 			machineConfig: opts?.machine ?? null
 		};
 		actors.set(id, entry);
-		if (initSent) send({
+		if (!initSent) sendInit();
+		else send({
 			type: "@statelyai.system.actorRegistered",
 			actorId: id,
 			parentActorId: entry.parentActorId,

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, h 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-DQ_7I7eH.mjs";
+import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, h 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-DenVP7IE.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 };

package/dist/inspect.mjs

@@ -1,3 +1,3 @@
-import { n as createStatelyInspector, t as createInspector } from "./inspect-BcKTFJI1.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-DWDTNMEc.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/patchTypes.d.mts

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

package/dist/protocol.d.mts

@@ -1,3 +1,5 @@
+import { i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
+
 //#region src/protocol.d.ts
 type EmbedMode = "editing" | "viewing" | "simulating" | "inspecting";
 interface CommentsConfig {
@@ -139,19 +141,19 @@ interface EmbedEventMap {
     version: string;
   };
   loaded: {
-    graph: unknown;
+    graph: StatelyGraph;
     machineId?: string;
     sourceLocations?: MachineSourceLocations;
   };
   change: {
-    graph: unknown;
+    graph: StatelyGraph;
     machineConfig: unknown;
     machineId?: string;
     patches?: unknown[];
     sourceLocations?: MachineSourceLocations;
   };
   save: {
-    graph: unknown;
+    graph: StatelyGraph;
     machineConfig: unknown;
     machineId?: string;
     patches?: unknown[];
@@ -427,13 +429,13 @@ interface ReadyMessage {
 }
 interface LoadedMessage {
   type: "@statelyai.loaded";
-  graph: unknown;
+  graph: StatelyGraph;
   machineId?: string;
   sourceLocations?: MachineSourceLocations;
 }
 interface ChangeMessage {
   type: "@statelyai.change";
-  graph: unknown;
+  graph: StatelyGraph;
   machineConfig: unknown;
   machineId?: string;
   patches?: unknown[];
@@ -441,7 +443,7 @@ interface ChangeMessage {
 }
 interface SaveMessage {
   type: "@statelyai.save";
-  graph: unknown;
+  graph: StatelyGraph;
   machineConfig: unknown;
   machineId?: string;
   patches?: unknown[];