@statelyai/sdk 0.34.1 → 0.35.0

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

@@ -1,5 +1,3 @@
-import { UnknownMachineConfig } from "xstate";
-
 //#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/json-schema.d.cts
 type _JSONSchema = boolean | JSONSchema;
 type JSONSchema = {
@@ -2553,6 +2551,13 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
 type GraphPatch = output<typeof graphPatchSchema>;
 /** AI-only schema: semantic ops + shared ops (no generic graph ops) */
 //#endregion
+//#region ../../node_modules/.pnpm/xstate@5.32.1/node_modules/xstate/dist/declarations/src/index.d.ts
+declare global {
+  interface SymbolConstructor {
+    readonly observable: symbol;
+  }
+}
+//#endregion
 //#region ../../node_modules/.pnpm/xstate@6.0.0-alpha.51/node_modules/xstate/dist/declarations/src/index.d.ts
 declare global {
   interface SymbolConstructor {
@@ -2700,27 +2705,11 @@ interface JSONSchema7 {
 }
 //#endregion
 //#region ../graph-tools/dist/index.d.mts
-declare const LEGACY_MACHINE_PROFILES: readonly ["xstate-v5", "xstate-v6-alpha"];
-type LegacyMachineProfile = (typeof LEGACY_MACHINE_PROFILES)[number];
 //#endregion
 //#region src/profiles/profileRefs.d.ts
 type ProfileName = `@${string}/${string}`;
 type ProfileSpecifier = `${ProfileName}@${string}`;
 type ResolvedProfileRef = ProfileSpecifier;
-type ProfileRefInput = ResolvedProfileRef | LegacyMachineProfile;
-//#endregion
-//#region src/codegenTypes.d.ts
-interface CodeGenAction {
-  /** Graph-native block id, referenced by `@statelyai.action.*` transitions. */
-  id?: string;
-  type: string;
-  params?: Record<string, unknown>;
-}
-interface CodeGenGuard {
-  type: string;
-  code?: string;
-  params?: Record<string, unknown>;
-}
 /**
  * Serialized inline expression directive.
  *
@@ -2746,186 +2735,6 @@ interface CodeImport {
  * A scalar `context`/`input`/`output` literal, kept verbatim from the source
  * instead of being wrapped as a code expression.
  */
-type ScalarGraphValue = string | number | boolean | null;
-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 | ScalarGraphValue;
-  output?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
-}
-interface CodeGenNodeData {
-  nodeId?: string | null;
-  key: string;
-  type?: 'normal' | 'parallel' | 'final' | 'history' | 'choice' | null;
-  initialId?: string | null;
-  initialInput?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
-  timeout?: number | string | CodeExpression;
-  route?: Record<string, unknown> | CodeExpression;
-  history?: 'shallow' | 'deep' | boolean;
-  output?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
-  schemas?: {
-    context?: Record<string, JSONSchema7> | null;
-    input?: JSONSchema7 | null;
-    output?: JSONSchema7 | null;
-  } | null;
-  entry?: CodeGenAction[];
-  exit?: CodeGenAction[];
-  invokes?: CodeGenInvoke[];
-  tags?: Array<string | {
-    name: string;
-  }>;
-  description?: string | null;
-  meta?: Record<string, unknown> | null;
-  color?: string;
-  parentId?: string | null;
-  temp?: unknown;
-}
-interface CodeGenEdgeData {
-  eventType: string;
-  /** Additional resolved targets for a parallel multi-target transition. */
-  additionalTargetIds?: string[];
-  matches?: Record<string, unknown>;
-  transitionType?: 'normal' | 'targetless' | 'reenter';
-  guard?: CodeGenGuard | null;
-  context?: Record<string, unknown> | CodeExpression;
-  input?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
-  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;
-  name: string;
-  description?: string | null;
-  icon?: string;
-  paramsSchema?: JSONSchema7 | null;
-  code?: {
-    body: string;
-    lang?: string;
-    imports?: CodeImport[];
-  } | null;
-}
-interface CodeGenActorImplementation {
-  id: string;
-  name: string;
-  description?: string | null;
-  icon?: string;
-  inputSchema?: JSONSchema7 | null;
-  outputSchema?: JSONSchema7 | null;
-  code?: {
-    body: string;
-    lang?: string;
-    imports?: CodeImport[];
-  } | null;
-}
-interface CodeGenGraphData {
-  profile?: ProfileRefInput;
-  version?: string | null;
-  options?: {
-    maxIterations?: number;
-  } | null;
-  internalEvents?: string[] | null;
-  context?: Record<string, unknown> | `{{${string}}}` | CodeExpression | null;
-  schemas?: {
-    context?: Record<string, JSONSchema7> | null;
-    events?: Record<string, JSONSchema7> | null;
-    internalEvents?: Record<string, JSONSchema7> | null;
-    emitted?: Record<string, JSONSchema7> | null;
-    actions?: Record<string, unknown> | null;
-    guards?: Record<string, unknown> | null;
-    children?: Record<string, JSONSchema7> | null;
-    input?: JSONSchema7 | null;
-    output?: JSONSchema7 | null;
-    tags?: JSONSchema7 | null;
-    meta?: JSONSchema7 | null;
-  } | null;
-  implementations?: {
-    actions: CodeGenImplementation[];
-    guards: CodeGenImplementation[];
-    actors: CodeGenActorImplementation[];
-    delays: CodeGenImplementation[];
-  } | null;
-}
-interface CodeGenNode {
-  id: string;
-  parentId?: string | null;
-  data: CodeGenNodeData;
-}
-interface CodeGenEdge {
-  id: string;
-  sourceId: string;
-  targetId: string;
-  data: CodeGenEdgeData;
-}
-interface CodeGenGraph {
-  id: string;
-  nodes: CodeGenNode[];
-  edges: CodeGenEdge[];
-  data: CodeGenGraphData;
-} //#endregion
-//#region src/graphToMachineConfig.d.ts
-interface MachineConfigOptions {
-  showDescriptions?: boolean;
-  showMeta?: boolean;
-  /**
-   * Emit inline-code guards as a `{ type }` reference instead of an inline code
-   * expression directive. The simulation needs this: it can't evaluate guard
-   * source, so it stubs each guard by `type` (see getSimImplementations). A
-   * code-expression guard has no `type`, so XState reads `undefined` and throws
-   * "Guard 'undefined' is not implemented" the moment that transition is taken.
-   */
-  inlineGuardsAsTypeRef?: boolean;
-  /**
-   * Keep `xstate.choose` as a structured `{ type, params }` action instead of
-   * lowering it to the v5 `enqueueActions` code expression. The v6 renderer
-   * needs this: v6 has neither `choose` nor `enqueueActions`, so it lowers the
-   * branches itself into the `enq` function body.
-   */
-  keepChooseStructured?: boolean;
-}
-declare function graphToMachineConfig(graph: CodeGenGraph, options?: MachineConfigOptions): UnknownMachineConfig; //#endregion
-//#region src/serializeJS.d.ts
-/**
- * Serializes JavaScript values as JS source code (not JSON).
- * - Unquoted keys for valid identifiers
- * - Single-quoted strings
- * - Omits undefined values
- * - Supports RawCode for verbatim expressions
- * - Supports inline expression directives for verbatim expressions
- */
-declare class RawCode {
-  code: string;
-  sourceValue?: object | undefined;
-  sourceSlice?: {
-    from: number;
-    to: number;
-  } | undefined;
-  constructor(code: string, sourceValue?: object | undefined, sourceSlice?: {
-    from: number;
-    to: number;
-  } | undefined);
-}
-declare function raw(code: string, sourceValue?: object, sourceSlice?: {
-  from: number;
-  to: number;
-}): RawCode;
-declare function serializeJS(value: unknown, indent?: number, step?: number): string; //#endregion
-//#region src/textUtils.d.ts
-/**
- * Pure string utilities used by codegen.
- */
-/**
- * Removes common leading whitespace from all non-empty lines.
- */
 //#endregion
 //#region src/profiles/types.d.ts
 /**
@@ -3000,6 +2809,30 @@ type ProfileMigration = {
   migrate: (data: Readonly<ProfileDataSet>, context: ProfileProjectionContext) => ProfileProjectionResult;
 };
 type FormatId = string;
+type ProfileCodeLocation = {
+  graph: Readonly<ProfileGraph>;
+  path: readonly (string | number)[];
+  parent: unknown;
+  ancestors: readonly unknown[];
+};
+type ProfileCodeTarget = {
+  kind: 'entity';
+  id: string;
+  label: string;
+} | {
+  kind: 'source';
+  id: string;
+  label: string;
+  sourceType: string;
+};
+type ProfileCodeBlock = {
+  name: string;
+  matches: (location: ProfileCodeLocation) => boolean;
+  isValid: (code: string) => boolean;
+  exportInvalid: (invalidCode: string) => string; /** Editor destination used to surface and navigate code diagnostics. */
+  getTarget?: (location: ProfileCodeLocation) => ProfileCodeTarget | undefined; /** Object used by source generation to locate this block in a full document. */
+  getSourceValue?: (location: ProfileCodeLocation) => object | undefined;
+};
 type ProfileFormatManifest = {
   format: FormatId;
   import?: boolean;
@@ -3053,7 +2886,10 @@ type ProfileManifest = {
   graph?: {
     dataSchema?: JSONSchema7;
   }; /** Profile-owned editor vocabulary. The canvas itself only assumes a graph. */
-  authoring?: ProfileAuthoringManifest;
+  authoring?: ProfileAuthoringManifest; /** Profile-owned authored code locations and syntax-safe export fallbacks. */
+  code?: {
+    blocks: readonly ProfileCodeBlock[];
+  };
   operations?: Partial<Record<'simulate' | 'validate' | 'export', boolean>>;
   restrictFormatsToListed?: boolean;
   features?: Record<string, boolean | Record<string, unknown>>;
@@ -3066,56 +2902,4 @@ type ProfileManifest = {
   editorDefaults?: Record<string, unknown>;
 };
 //#endregion
-//#region src/graphToXStateTS.d.ts
-interface XStateTSOptions extends MachineConfigOptions {
-  exportStyle?: 'named' | 'default' | 'none';
-  targetLanguage?: 'typescript' | 'javascript';
-  xstateVersion?: 5 | 6;
-  xstateV6SchemaFormat?: 'types' | 'zod';
-}
-declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions): string;
-//#endregion
-//#region src/graphToXStateV4TS.d.ts
-interface XStateV4TSOptions extends MachineConfigOptions {
-  exportStyle?: 'named' | 'default' | 'none';
-  targetLanguage?: 'typescript' | 'javascript';
-}
-/**
- * Emits XState **v4** (deprecated) TypeScript for a graph.
- *
- * The v4 surface differs from v5 in ways this emitter downgrades:
- * `createMachine(config, options)` instead of `setup().createMachine()`,
- * `cond` instead of `guard`, `services` instead of `actors`, `internal: false`
- * instead of `reenter: true`, `done.invoke.X` / `error.platform.X` /
- * `done.state.X` event names, and positional `(context, event)` implementation
- * arguments (enabled by `predictableActionArguments`).
- *
- * Concepts with no v4 equivalent (`emit`, `spawnChild`, `enqueueActions`,
- * actor-logic creators such as `fromPromise`) are emitted verbatim with a
- * `// TODO: v5-only` marker rather than silently dropped.
- */
-declare function graphToXStateV4TS(graph: CodeGenGraph, options?: XStateV4TSOptions): string; //#endregion
-//#region src/graphToXStateFSM.d.ts
-interface XStateFSMOptions {
-  exportStyle?: 'named' | 'default' | 'none';
-  xstateV6SchemaFormat?: 'types' | 'zod';
-}
-declare function getXStateFSMCompatibilityIssues(graph: CodeGenGraph): string[];
-declare function graphToXStateFSM(graph: CodeGenGraph, options?: XStateFSMOptions): string; //#endregion
-//#region src/emittedNodeIds.d.ts
-//#endregion
-//#region src/jsonSchemaToTSType.d.ts
-declare function jsonSchemaToTSType(schema: JSONSchema7 | undefined | null): string;
-/**
- * Build an inline context type string from the schemas.context record.
- * Each key is a context property name, value is its JSONSchema7.
- */
-declare function contextSchemaToTSType(context: Record<string, JSONSchema7> | null | undefined): string | null;
-/**
- * Build an event union type from the schemas.events record.
- * Each key is the event type name, value describes the payload properties.
- */
-declare function eventsSchemaToTSType(events: Record<string, JSONSchema7> | null | undefined): string | null; //#endregion
-//#region src/jsonSchemaToZod.d.ts
-//#endregion
-export { ZodObject as A, ImplementationSourceType as C, ZodLiteral as D, ZodEnum as E, ZodUnknown as F, output as I, $loose as L, ZodRecord as M, ZodString as N, ZodNullable as O, ZodUnion as P, $strip as R, GraphPatch as S, ZodBoolean as T, raw as _, RawCode as a, CanvasColor as b, XStateV4TSOptions as c, getXStateFSMCompatibilityIssues as d, graphToMachineConfig as f, jsonSchemaToTSType as g, graphToXStateV4TS as h, ProfileManifest as i, ZodOptional as j, ZodNumber as k, contextSchemaToTSType as l, graphToXStateTS as m, CodeGenGraph as n, XStateFSMOptions as o, graphToXStateFSM as p, MachineConfigOptions as r, XStateTSOptions as s, CodeExpression as t, eventsSchemaToTSType as u, serializeJS as v, ZodArray as w, EditorStateType as x, ActionLocation as y };
+export { $strip as S, ZodString as _, EditorStateType as a, output as b, ZodArray as c, ZodLiteral as d, ZodNullable as f, ZodRecord as g, ZodOptional as h, CanvasColor as i, ZodBoolean as l, ZodObject as m, ProfileManifest as n, GraphPatch as o, ZodNumber as p, ActionLocation as r, ImplementationSourceType as s, CodeExpression as t, ZodEnum as u, ZodUnion as v, $loose as x, ZodUnknown as y };

package/dist/index.d.mts

@@ -1,36 +1,13 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { S as GraphPatch, _ as raw, a as RawCode, c as XStateV4TSOptions, d as getXStateFSMCompatibilityIssues, f as graphToMachineConfig, g as jsonSchemaToTSType, h as graphToXStateV4TS, l as contextSchemaToTSType, m as graphToXStateTS, n as CodeGenGraph, o as XStateFSMOptions, p as graphToXStateFSM, r as MachineConfigOptions, s as XStateTSOptions, u as eventsSchemaToTSType, v as serializeJS, y as ActionLocation } from "./index-DZivqh0u.mjs";
-import { C as EventTypeData, S as DigraphNodeConfig, _ as studioMachineConverter, a as StatelyGraphData, b as DigraphConfig, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, o as StatelyGuard, r as StatelyEdgeData, t as StatelyAction, v as toStudioMachine, w as StateNodeJSONData, x as DigraphEdgeConfig, y as DigraphAction } from "./graph-Ciocekxl.mjs";
-import { $t as createInspectionRoomUrls, B as InspectionSentEvent, D as ExportCallOptions, F as InitOptions, Gt as UploadResult, H as InspectorLoadedEvent, J as MachineVersionAutoSaveOptions, L as InspectionAction, M as INSPECTION_PROTOCOL_VERSION, N as INSPECTION_ROOM_QUERY_PARAM, O as ExportFormat, Q as ProjectEmbedMachine, Qt as createInspectionActorId, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, Zt as assertEmbedExamples, _ as EmbedDocumentLanguage, an as EmbedPanelConfig, at as ProjectWorkspaceAction, b as EmbedEventName, ct as ProjectWorkspaceCapabilities, d as CommentsConfig, dt as ProjectWorkspaceMachineOrigin, en as getInspectionRoomId, f as EMBED_DOCUMENT_LANGUAGES, g as EmbedDocument, in as resolveInspectorSettings, k as ExportFormatMap, lt as ProjectWorkspaceConfig, m as EditorCapabilities, n as CapabilityDeniedCapability, nn as isEmbedExampleMachine, on as EmbedPanelPosition, ot as ProjectWorkspaceActionIcon, p as EMBED_DOCUMENT_LIMITS, pt as ProjectWorkspaceProject, r as CapabilityDeniedEvent, rn as mergeInspectorSettings, tn as isEmbedExample, ut as ProjectWorkspaceMachine, v as EmbedEventHandler, w as EmbedMode, x as EmbedExample, y as EmbedEventMap } from "./protocol-B7q2lWj_.mjs";
+import { o as GraphPatch, r as ActionLocation } from "./index-CoxF4Saw.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-B6xUxqR5.mjs";
+import { $t as createInspectionRoomUrls, B as InspectionSentEvent, D as ExportCallOptions, F as InitOptions, Gt as UploadResult, H as InspectorLoadedEvent, J as MachineVersionAutoSaveOptions, L as InspectionAction, M as INSPECTION_PROTOCOL_VERSION, N as INSPECTION_ROOM_QUERY_PARAM, O as ExportFormat, Q as ProjectEmbedMachine, Qt as createInspectionActorId, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, Zt as assertEmbedExamples, _ as EmbedDocumentLanguage, an as EmbedPanelConfig, at as ProjectWorkspaceAction, b as EmbedEventName, ct as ProjectWorkspaceCapabilities, d as CommentsConfig, dt as ProjectWorkspaceMachineOrigin, en as getInspectionRoomId, f as EMBED_DOCUMENT_LANGUAGES, g as EmbedDocument, in as resolveInspectorSettings, k as ExportFormatMap, lt as ProjectWorkspaceConfig, m as EditorCapabilities, n as CapabilityDeniedCapability, nn as isEmbedExampleMachine, on as EmbedPanelPosition, ot as ProjectWorkspaceActionIcon, p as EMBED_DOCUMENT_LIMITS, pt as ProjectWorkspaceProject, r as CapabilityDeniedEvent, rn as mergeInspectorSettings, tn as isEmbedExample, ut as ProjectWorkspaceMachine, v as EmbedEventHandler, w as EmbedMode, x as EmbedExample, y as EmbedEventMap } from "./protocol-nOWsz3UV.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-CVFc85uF.mjs";
-import { _ as EditorHostOutboundMessage, a as EditorHostWorkspaceSessionOptions, d as fetchEditorSyncAccess, f as EDITOR_PROTOCOL_VERSION, g as EditorHostInitOptions, h as EditorHostInboundMessage, i as EditorHostWorkspaceSession, l as RemoteEditorSyncBackendOptions, m as EditorHostExportFormat, n as EditorHostSessionOptions, o as EditorSourceHost, p as EditorHostDiagnostic, r as EditorHostWorkspaceMachine, s as EditorSyncBackend, t as EditorHostSession, u as createRemoteEditorSyncBackend, v as EditorHostValidationIssue } from "./editorHostSession-DBLSyHJs.mjs";
+import { StatelyAuthMode, StatelyCredential, createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
+import { EDITOR_PROTOCOL_VERSION, EditorHostDiagnostic, EditorHostExportFormat, EditorHostInboundMessage, EditorHostInitOptions, EditorHostOutboundMessage, EditorHostValidationIssue } from "./editorHostProtocol.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-BbvfH0Q1.mjs";
-import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-CKdEPGKY.mjs";
+import { _ as createWebSocketTransport, a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, g as createPostMessageTransport, h as TransportFailure, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-DCdu0ST3.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-3ujfe2z0.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";
-//#region src/statelyPragma.d.ts
-interface StatelyPragma {
-  tag: '@statelyai';
-  id?: string;
-  fields: Record<string, string>;
-  start: number;
-  end: number;
-}
-interface StatelyPragmaAttachment {
-  machineStart: number;
-  attachStart: number;
-  pragma?: StatelyPragma;
-}
-interface UpsertStatelyPragmaOptions {
-  fileName?: string;
-  machineIndex?: number;
-  lineEnding?: '\n' | '\r\n';
-}
-declare function findStatelyPragmaAttachments(sourceText: string, fileName?: string): StatelyPragmaAttachment[];
-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 EditorHostDiagnostic, type EditorHostExportFormat, type EditorHostInboundMessage, type EditorHostInitOptions, type EditorHostOutboundMessage, EditorHostSession, type EditorHostSessionOptions, type EditorHostValidationIssue, type EditorHostWorkspaceMachine, EditorHostWorkspaceSession, type EditorHostWorkspaceSessionOptions, type EditorSourceHost, type EditorSyncBackend, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEntity, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedExample, type EmbedFormatContext, type EmbedFormatDefinition, type EmbedGraph, type EmbedMode, type EmbedPanelConfig, type EmbedPanelPosition, 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 InspectorLoadedEvent, type InspectorSettings, 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 ViewerOptions, type XStateFSMOptions, type XStateTSOptions, type XStateV4TSOptions, type XStateVersion, assertEmbedExamples, 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, getXStateFSMCompatibilityIssues, graphToMachineConfig, graphToXStateFSM, graphToXStateTS, graphToXStateV4TS, isEmbedExample, isEmbedExampleMachine, jsonSchemaToTSType, mergeInspectorSettings, raw, refreshToken, registerOAuthClient, resolveInspectorSettings, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CapabilityDeniedCapability, type CapabilityDeniedEvent, 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 EditorHostDiagnostic, type EditorHostExportFormat, type EditorHostInboundMessage, type EditorHostInitOptions, type EditorHostOutboundMessage, type EditorHostValidationIssue, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEntity, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedExample, type EmbedFormatContext, type EmbedFormatDefinition, type EmbedGraph, type EmbedMode, type EmbedPanelConfig, type EmbedPanelPosition, 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 InspectorLoadedEvent, type InspectorSettings, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineVersion, type MachineVersionAutoSaveOptions, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, 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 RepoType, 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 StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type VerifyApiKeyResponse, type VerifyResult, type ViewerOptions, type XStateVersion, assertEmbedExamples, buildAuthorizeUrl, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, fromStudioMachine, getCredentialToken, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine, mergeInspectorSettings, refreshToken, registerOAuthClient, resolveInspectorSettings, studioMachineConverter, toStudioMachine };

package/dist/index.mjs

@@ -1,18 +1,14 @@
-import "./openapi-BTDjYWXd.mjs";
+import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-Bn3alVku.mjs";
 import { c as createInspectionRoomUrls, d as isEmbedExampleMachine, f as mergeInspectorSettings, i as INSPECTION_ROOM_QUERY_PARAM, l as getInspectionRoomId, n as EMBED_DOCUMENT_LIMITS, o as assertEmbedExamples, p as resolveInspectorSettings, r as INSPECTION_PROTOCOL_VERSION, s as createInspectionActorId, t as EMBED_DOCUMENT_LANGUAGES, u as isEmbedExample } from "./protocol-BsBGRISR.mjs";
-import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-BEfUEyPL.mjs";
-import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-B2_t3Le7.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-DECst76A.mjs";
+import { EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
-import { a as fetchEditorSyncAccess, i as createRemoteEditorSyncBackend, n as EditorHostWorkspaceSession, t as EditorHostSession } from "./editorHostSession-Bj5YcijC.mjs";
-import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-BZP6DaIO.mjs";
-import { S as serializeJS, _ as graphToXStateV4TS, f as getXStateFSMCompatibilityIssues, g as graphToXStateTS, h as graphToXStateFSM, l as eventsSchemaToTSType, m as graphToMachineConfig, n as RawCode, o as contextSchemaToTSType, x as raw, y as jsonSchemaToTSType } from "./dist-NJFkDQjK.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-DW30GMge.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-GSXRhzOx.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";
-import { n as getStatelyPragma, r as upsertStatelyPragma, t as findStatelyPragmaAttachments } from "./statelyPragma-YtVaBuIe.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 import { createInspectionRelay } from "./relay.mjs";
 
-export { DEFAULT_STATELY_BASE_URL, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorHostSession, EditorHostWorkspaceSession, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, assertEmbedExamples, 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, getXStateFSMCompatibilityIssues, graphToMachineConfig, graphToXStateFSM, graphToXStateTS, graphToXStateV4TS, isEmbedExample, isEmbedExampleMachine, jsonSchemaToTSType, mergeInspectorSettings, raw, refreshToken, registerOAuthClient, resolveInspectorSettings, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { DEFAULT_STATELY_BASE_URL, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, StatelyApiError, StudioApiError, assertEmbedExamples, buildAuthorizeUrl, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, fromStudioMachine, getCredentialToken, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine, mergeInspectorSettings, refreshToken, registerOAuthClient, resolveInspectorSettings, studioMachineConverter, toStudioMachine };

package/dist/{inspect-BbvfH0Q1.d.mts → inspect-DCdu0ST3.d.mts}

@@ -1,4 +1,4 @@
-import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, R as InspectionClientMetadata, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, k as ExportFormatMap, mt as ProtocolMessage, y as EmbedEventMap } from "./protocol-B7q2lWj_.mjs";
+import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, R as InspectionClientMetadata, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, k as ExportFormatMap, mt as ProtocolMessage, y as EmbedEventMap } from "./protocol-nOWsz3UV.mjs";
 
 //#region src/transport.d.ts
 interface TransportFailure {

package/dist/{inspect-DW30GMge.mjs → inspect-GSXRhzOx.mjs}

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

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
-import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, an as EmbedPanelConfig, b as EmbedEventName, g as EmbedDocument, k as ExportFormatMap, m as EditorCapabilities, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-B7q2lWj_.mjs";
-import { a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-BbvfH0Q1.mjs";
+import { B as InspectionSentEvent, D as ExportCallOptions, H as InspectorLoadedEvent, K as MachinePayload, L as InspectionAction, O as ExportFormat, U as InspectorSettings, V as InspectionTakenTransition, Yt as ViewerOptions, an as EmbedPanelConfig, b as EmbedEventName, g as EmbedDocument, k as ExportFormatMap, m as EditorCapabilities, v as EmbedEventHandler, w as EmbedMode, y as EmbedEventMap } from "./protocol-nOWsz3UV.mjs";
+import { a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-DCdu0ST3.mjs";
 export { AdoptedActor, CreateInspectorOptions, EditorCapabilities, EmbedDocument, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, EmbedPanelConfig, ExportCallOptions, ExportFormat, ExportFormatMap, InspectedEvent, InspectedSnapshot, InspectedTransition, InspectionAction, InspectionSentEvent, InspectionTakenTransition, Inspector, InspectorConnection, InspectorDiscoveryEntry, InspectorEvents, InspectorInspectionEvent, InspectorLoadedEvent, InspectorSettings, MachinePayload, ManualActorOptions, Transport, ViewerOptions, createInspector, createStatelyInspector };

package/dist/inspect.mjs

@@ -1,5 +1,5 @@
 import "./protocol-BsBGRISR.mjs";
-import "./version-BEfUEyPL.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-DW30GMge.mjs";
+import "./version-DECst76A.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-GSXRhzOx.mjs";
 
 export { createInspector, createStatelyInspector };