@statelyai/sdk 0.12.3 → 0.13.1

package/README.md

@@ -1,20 +1,32 @@
 # @statelyai/sdk
 
-> **Preview** -- this SDK is not yet publicly available. Reach out to [team@stately.ai](mailto:team@stately.ai) for early access.
+The public alpha SDK for embedding the Stately visual editor, inspecting live
+actor systems, and using the Stately Studio API.
 
-The Stately SDK lets you embed the [Stately visual editor](https://stately.ai) directly into your own application, inspect live actor systems, and programmatically manage Stately Studio projects and machines.
+APIs may change between minor releases. Review generated source changes before
+committing them.
 
-## What's coming
+## Install
+
+<!-- install command derived from package.json#name -->
+
+```bash
+npm install @statelyai/sdk
+```
+
+## Capabilities
 
 ### Embeddable editor
 
+<!-- createStatelyEmbed usage from src/embed.ts and the hosted editor URL -->
+
 Drop a fully interactive state machine editor into any web app. The embed communicates over `postMessage` and gives you full control over theme, layout, panels, read-only mode, and more.
 
 ```ts
 import { createStatelyEmbed } from '@statelyai/sdk';
 
 const embed = createStatelyEmbed({
-  baseUrl: 'https://stately.ai',
+  baseUrl: 'https://editor.stately.ai',
   apiKey: 'your-api-key',
 });
 
@@ -70,7 +82,10 @@ Key capabilities:
 
 ### Self-hosting
 
-The SDK is designed to work with both hosted Stately (`stately.ai`) and self-hosted deployments of the editor.
+<!-- self-host configuration from the editor app auth and editor-sync routes -->
+
+The SDK works with both the hosted Stately editor (`editor.stately.ai`) and
+self-hosted deployments.
 
 When self-hosting, authentication is handled by your editor server, not by this npm package. The editor host supports configurable auth strategies, and you can disable API-key checks for editor-sync endpoints when running behind your own auth layer.
 
@@ -88,8 +103,6 @@ Key environment variables for self-hosted deployments:
 | --------------------------- | -------------------------------------------- |
 | `AUTH_PROVIDER`             | Auth strategy used by the editor host        |
 | `EDITOR_SYNC_AUTH_REQUIRED` | Set to `false` to skip editor-sync API-key checks |
-| `STATELY_API_KEY`           | Server-side API key for Stately data fetching |
-| `STATELY_API_URL`           | Stately API base URL override                |
 | `NEXT_PUBLIC_BASE_URL`      | Public-facing editor URL                     |
 
 ### Studio API client
@@ -117,22 +130,38 @@ self-hosted deployments that intentionally accept unauthenticated calls.
 
 ### Inspector
 
+<!-- createInspector API from src/inspect.ts -->
+
 Stream live actor-system state to the Stately inspector over WebSockets, with support for automatic XState actor adoption and manual actor registration.
 
 ```ts
 import { createActor } from 'xstate';
-import { createStatelyInspector } from '@statelyai/sdk';
+import { createInspector } from '@statelyai/sdk';
 
 const actor = createActor(machine);
-const inspector = createStatelyInspector({ autoOpen: true });
+const inspector = createInspector({
+  url: 'ws://localhost:4242',
+});
 
 inspector.inspect(actor);
 actor.start();
 ```
 
+XState v5 and v6 inspection events normalize to actor, transition, and stop
+events before crossing the WebSocket protocol.
+In Node, the inspector opens in the default browser automatically. The SDK
+generates a cryptographically random session capability; hosted inspectors send
+signed-out users through OAuth and return them to that same live session. The
+Node process does not need a Stately API key.
+
 ### CLI and sync
 
-A `statelyai` CLI for syncing local XState source files with Stately Studio projects: push local machines to the cloud, pull remote changes back into source, and open a local file in a browser-backed visual editor session.
+<!-- CLI package identity and commands from ../cli/package.json and ../cli/src/cli.ts#COMMANDS -->
+
+The separate [`statelyai`](https://www.npmjs.com/package/statelyai) CLI syncs
+local XState source files with Stately Studio projects: push local machines,
+pull remote changes, and open a local file in a browser-backed visual editor
+session.
 
 ```bash
 npx statelyai push
@@ -144,6 +173,7 @@ npx statelyai open ./checkout.machine.ts
 
 Convert between Studio graph data, XState machine configs, and TypeScript source. Generate types from JSON Schema.
 
-## Get notified
+## Support
 
-This SDK and the embeddable editor are in active development. For early access, pricing, and self-hosting details, contact [team@stately.ai](mailto:team@stately.ai).
+For pricing and self-hosting details, contact
+[team@stately.ai](mailto:team@stately.ai).

package/dist/auth.d.mts

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

package/dist/embed.mjs

@@ -1,4 +1,4 @@
-import { a as toInitMessage, i as createPendingExportManager, r as createEventRegistry, t as createPostMessageTransport } from "./transport-DysvAtl5.mjs";
+import { a as createPendingExportManager, i as createEventRegistry, n as createPostMessageTransport, o as toInitMessage } from "./transport-D2Ud05yg.mjs";
 
 //#region src/embed.ts
 function buildEmbedUrl(options) {

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

@@ -1,4 +1,4 @@
-import { r as CodeExpression } from "./index-BRW2DecD.mjs";
+import { r as CodeExpression } from "./index-DVjNSTuQ.mjs";
 import * as _statelyai_graph0 from "@statelyai/graph";
 import { Graph } from "@statelyai/graph";
 

package/dist/graph.d.mts

@@ -1,2 +1,2 @@
-import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-Dq5ycdSq.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-R0sbxnZ7.mjs";
 export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };

package/dist/index.d.mts

@@ -1,14 +1,15 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, ProjectEmbedMachine, UploadResult } from "./protocol.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-DO1-eQcU.mjs";
+import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-DmPZiERd.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-BRW2DecD.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-Dq5ycdSq.mjs";
-import { a as ManualActorOptions, c as createPostMessageTransport, i as InspectorEvents, l as createWebSocketTransport, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-BmZUcnZB.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 { a as InspectorEvents, c as createStatelyInspector, d as MultiplexedWebSocketConnectionOptions, f as Transport, h as createWebSocketTransport, i as Inspector, l as MultiplexedChannelOptions, m as createPostMessageTransport, n as CreateInspectorOptions, o as ManualActorOptions, p as createMultiplexedWebSocketConnection, r as InspectedTransition, s as createInspector, t as AdoptedActor, u as MultiplexedWebSocketConnection } from "./inspect-COqtklcn.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 { 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';
@@ -31,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 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, type InitOptions, type Inspector, type InspectorEvents, type MachineConfigOptions, type ManualActorOptions, 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, 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, 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 InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorEvents, 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 };

package/dist/index.mjs

@@ -1,12 +1,14 @@
-import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-DysvAtl5.mjs";
+import { n as createPostMessageTransport, r as createWebSocketTransport, t as createMultiplexedWebSocketConnection } from "./transport-D2Ud05yg.mjs";
+import { INSPECTION_PROTOCOL_VERSION } from "./protocol.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { createStatelyInspector } from "./inspect.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-pcNCbL7j.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-C-AdA8Iw.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-CHGcvOdQ.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
+import { createInspectionRelay } from "./relay.mjs";
 
-export { RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, 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 { 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-BmZUcnZB.d.mts → inspect-COqtklcn.d.mts}

@@ -1,4 +1,4 @@
-import { EditorCapabilities, EmbedEventMap, ExportCallOptions, ExportFormat, ExportFormatMap, ProtocolMessage } from "./protocol.mjs";
+import { EditorCapabilities, EmbedEventMap, ExportCallOptions, ExportFormat, ExportFormatMap, InspectionAction, InspectionSentEvent, InspectionTakenTransition, ProtocolMessage } from "./protocol.mjs";
 
 //#region src/transport.d.ts
 interface Transport {
@@ -29,6 +29,39 @@ interface WebSocketTransportOptions {
   maxReconnectAttempts?: number;
 }
 declare function createWebSocketTransport(options: WebSocketTransportOptions): Transport;
+interface MultiplexedWebSocketConnectionOptions {
+  url: string;
+  role: 'client' | 'viz';
+  /** First (primary) session to register on connect. */
+  sessionId: string;
+  /** Metadata for the primary session. */
+  metadata?: {
+    name?: string;
+    machineId?: string;
+  };
+  reconnect?: boolean;
+  maxReconnectAttempts?: number;
+}
+interface MultiplexedChannelOptions {
+  /** Session id this channel targets. */
+  sessionId: string;
+  /** Optional metadata for this session. */
+  metadata?: {
+    name?: string;
+    machineId?: string;
+  };
+}
+interface MultiplexedWebSocketConnection {
+  /** Open a channel for a sessionId. Re-opening an existing session returns the same channel. */
+  openChannel(options: MultiplexedChannelOptions): Transport;
+  /** Close the connection and all its channels. */
+  destroy(): void;
+  /** Whether the underlying WebSocket is connected + the primary session is registered. */
+  readonly ready: boolean;
+  /** Primary session id (first registered). */
+  readonly primarySessionId: string;
+}
+declare function createMultiplexedWebSocketConnection(options: MultiplexedWebSocketConnectionOptions): MultiplexedWebSocketConnection;
 //#endregion
 //#region src/inspect.d.ts
 interface MinimalActorRef {
@@ -39,6 +72,7 @@ interface MinimalActorRef {
   logic?: {
     config?: unknown;
   };
+  src?: unknown;
   getSnapshot(): MinimalSnapshot;
   system: {
     inspect: (observer: (event: InspectionEvent) => void) => {
@@ -56,6 +90,10 @@ type InspectionEvent = {
   type: '@xstate.actor';
   actorRef: MinimalActorRef;
   rootId: string;
+  parentRef?: MinimalActorRef;
+  id?: string;
+  src?: unknown;
+  snapshot?: MinimalSnapshot;
 } | {
   type: '@xstate.snapshot';
   actorRef: MinimalActorRef;
@@ -68,12 +106,34 @@ type InspectionEvent = {
   rootId: string;
   sourceRef?: MinimalActorRef;
   event: unknown;
+} | {
+  type: '@xstate.transition';
+  actorRef: MinimalActorRef;
+  rootId: string;
+  snapshot: MinimalSnapshot;
+  event: unknown;
+  sourceRef?: MinimalActorRef;
+  targetRef?: MinimalActorRef;
+  eventType?: string;
+  microsteps?: unknown[];
+  actions?: Array<{
+    type: string;
+    params: unknown;
+  }>;
+  sent?: Array<{
+    targetRef?: MinimalActorRef;
+    targetId: string;
+    event: unknown;
+    delay?: number;
+    id?: string;
+  }>;
 } | {
   type: '@xstate.microstep';
   actorRef: MinimalActorRef;
   rootId: string;
   snapshot: MinimalSnapshot;
   event: unknown;
+  _transitions?: unknown[];
 } | {
   type: '@xstate.action';
   actorRef: MinimalActorRef;
@@ -99,9 +159,28 @@ interface AdoptedActor {
   /** Machine config sent to the visualizer, or `null` for non-machine actors. */
   machineConfig: unknown;
 }
+/** One normalized transition, independent of the XState inspection version. */
+interface InspectedTransition {
+  actorId: string;
+  sourceActorId: string | null;
+  previousSnapshot: unknown | null;
+  snapshot: unknown;
+  event: unknown | null;
+  actions: InspectionAction[];
+  transitions: InspectionTakenTransition[];
+  sent: InspectionSentEvent[];
+}
 interface InspectorEvents {
+  actor: AdoptedActor;
+  transition: InspectedTransition;
+  stop: {
+    actorId: string;
+  };
+  /** @deprecated Use `actor`. */
   register: AdoptedActor;
+  /** @deprecated Use `transition`. */
   snapshot: AdoptedActor;
+  /** @deprecated Use `stop`. */
   stopped: {
     actorId: string;
   };
@@ -125,8 +204,9 @@ interface CreateInspectorOptions {
   /** Auto-open browser to visualizer. Default: `true`. */
   autoOpen?: boolean;
   /**
-   * Relay session id. Defaults to a random id. This is the `?session=<id>`
-   * value the viz iframe connects with.
+   * Relay session capability. Defaults to a cryptographically random UUID.
+   * This is the `?session=<id>` value the visualizer connects with. Custom
+   * values used with a hosted relay must be unguessable.
    */
   sessionId?: string;
   /** Display name for this system in the visualizer. */
@@ -141,7 +221,7 @@ interface CreateInspectorOptions {
    * Extract the machine config for a given actor. Defaults to reading
    * `actor.logic.config`. Return `null` for non-machine actors.
    */
-  extractMachineConfig?: (actor: any) => unknown;
+  extractMachineConfig?: (actor: any, source?: unknown) => unknown;
   /** Selected actor id to focus on first. Defaults to the first inspected root. */
   selectedActorId?: string;
   /** Panel layout forwarded into the system init message. */
@@ -200,6 +280,8 @@ interface Inspector {
   /** Tear down the WebSocket + xstate subscription. */
   destroy(): void;
 }
-declare function createStatelyInspector(options?: CreateInspectorOptions): Inspector;
+declare function createInspector(options?: CreateInspectorOptions): Inspector;
+/** @deprecated Use {@link createInspector}. */
+declare const createStatelyInspector: typeof createInspector;
 //#endregion
-export { ManualActorOptions as a, createPostMessageTransport as c, InspectorEvents as i, createWebSocketTransport as l, CreateInspectorOptions as n, createStatelyInspector as o, Inspector as r, Transport as s, AdoptedActor as t };
+export { InspectorEvents as a, createStatelyInspector as c, MultiplexedWebSocketConnectionOptions as d, Transport as f, createWebSocketTransport as h, Inspector as i, MultiplexedChannelOptions as l, createPostMessageTransport as m, CreateInspectorOptions as n, ManualActorOptions as o, createMultiplexedWebSocketConnection as p, InspectedTransition as r, createInspector as s, AdoptedActor as t, MultiplexedWebSocketConnection as u };