@statelyai/sdk 0.15.0 → 0.16.0

package/README.md

@@ -153,15 +153,14 @@ Resource operations always require a credential.
 
 <!-- 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.
+Stream live actor-system state to the hosted Stately inspector. Zero-config
+inspection needs no API key or local relay.
 
 ```ts
 import { createActor } from 'xstate';
 import { createInspector } from '@statelyai/sdk';
 
-const inspector = createInspector({
-  url: 'ws://localhost:4242',
-});
+const inspector = createInspector();
 const { inspect } = inspector;
 
 const actor = createActor(machine, { inspect });
@@ -176,13 +175,23 @@ 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.
+`actorId` is system-local; `sessionId` is globally unique.
 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
-session. AI-backed features remain separately authenticated. The Node process
-does not need a Stately API key.
+connects to `wss://sky.stately.ai` and generates a UUID v4 `?r=` room bearer
+capability. Multiple producers and viewers can share that room. Anyone with the
+URL can inspect its data, so keep it private. Hosted replay expires after 24
+hours without activity. Only actor checkpoints and observations are replayed;
+export traffic is live-only, and auth/upload/embed-control messages are rejected.
+AI-backed features remain separately authenticated.
+
+Set `autoOpen: false`, await `inspector.ready`, and navigate to
+`inspector.inspectorUrl` when a test runner or another process owns the browser.
+`inspectorBaseUrl` targets an inspector UI hosted separately from the WebSocket
+relay. An explicit `url` wins over `STATELY_INSPECT_URL`, which wins over the
+hosted default. See `@statelyai/sdk/protocol` for the versioned message and
+`?r=` query contract.
 
 ### CLI and sync
 
@@ -231,6 +240,22 @@ const embed = createStatelyEmbed({
 });
 ```
 
+For inspection, run your own relay and pass its URL explicitly:
+
+```bash
+npx @statelyai/sdk relay
+```
+
+```ts
+const inspector = createInspector({
+  url: 'ws://localhost:4242',
+  inspectorBaseUrl: 'http://localhost:3000/inspect',
+});
+```
+
+This repository's `packages/sky` is an optional Cloudflare Durable Object
+reference deployment.
+
 Key environment variables for self-hosted deployments:
 
 | Variable                    | Purpose                                           |

package/dist/bin.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/bin.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { createNodeInspectionRelay } from "./node-relay.mjs";
+
+//#region src/bin.ts
+function readFlag(name, fallback) {
+	const index = process.argv.indexOf(`--${name}`);
+	return index >= 0 ? process.argv[index + 1] ?? fallback : fallback;
+}
+async function main() {
+	const command = process.argv[2];
+	if (command !== "relay") {
+		console.info("Usage: stately-sdk relay [--host 127.0.0.1] [--port 4242]");
+		process.exitCode = command ? 1 : 0;
+		return;
+	}
+	const relay = createNodeInspectionRelay({
+		host: readFlag("host", process.env.STATELY_HOST ?? "127.0.0.1"),
+		port: Number(readFlag("port", process.env.STATELY_PORT ?? "4242")),
+		logger: console
+	});
+	await relay.start();
+	const shutdown = async () => {
+		await relay.stop();
+		process.exit(0);
+	};
+	process.on("SIGINT", () => void shutdown());
+	process.on("SIGTERM", () => void shutdown());
+}
+main().catch((error) => {
+	console.error(error);
+	process.exit(1);
+});
+
+//#endregion
+export {  };

package/dist/embed.mjs

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

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 { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitOptions, InspectionAction, InspectionSentEvent, InspectionTakenTransition, ProjectEmbedMachine, UploadResult, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
 import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-2Thaw42j.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.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 { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, h as createWebSocketTransport, i as InspectedSnapshot, l as ManualActorOptions, m as createPostMessageTransport, n as CreateInspectorOptions, o as Inspector, p as TransportFailure, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-CduY_2Fa.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-Bk_u41gu.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, 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 };
+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, INSPECTION_ROOM_QUERY_PARAM, type InitOptions, type InspectedEvent, type InspectedSnapshot, type InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorEvents, type InspectorInspectionEvent, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineConfigOptions, type MachineVersion, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateTSOptions, type XStateVersion, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/index.mjs

@@ -1,14 +1,14 @@
-import { n as createPostMessageTransport, r as createWebSocketTransport, t as createMultiplexedWebSocketConnection } from "./transport-D2Ud05yg.mjs";
-import { INSPECTION_PROTOCOL_VERSION } from "./protocol.mjs";
+import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-B_ig9Znn.mjs";
+import { INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-DWDTNMEc.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-BwVdM4R8.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 { 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-Th0gdXfx.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 { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 import { createInspectionRelay } from "./relay.mjs";
 
-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 };
+export { DEFAULT_STATELY_BASE_URL, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

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

@@ -1,5 +1,5 @@
-import { a as createPendingExportManager, i as createEventRegistry, r as createWebSocketTransport } from "./transport-D2Ud05yg.mjs";
-import { INSPECTION_PROTOCOL_VERSION } from "./protocol.mjs";
+import { i as createPendingExportManager, n as createWebSocketTransport, r as createEventRegistry } from "./transport-B_ig9Znn.mjs";
+import { INSPECTION_PROTOCOL_VERSION, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
@@ -37,25 +37,23 @@ function isStoppedSnapshot(snapshot) {
 	const status = snapshot?.status;
 	return status === "done" || status === "stopped" || status === "error";
 }
-function generateSessionId() {
-	if (!globalThis.crypto?.randomUUID) throw new Error("createInspector() requires crypto.randomUUID() to generate a secure session capability. Pass sessionId explicitly in older runtimes.");
+function generateRoomId() {
+	if (!globalThis.crypto?.randomUUID) throw new Error("createInspector() requires crypto.randomUUID() to generate a secure room capability. Pass roomId explicitly in older runtimes.");
 	return globalThis.crypto.randomUUID();
 }
-function createInspectorLaunchUrl(websocketUrl, sessionId) {
-	try {
-		const launchUrl = new URL(websocketUrl);
-		if (launchUrl.protocol === "ws:") launchUrl.protocol = "http:";
-		else if (launchUrl.protocol === "wss:") launchUrl.protocol = "https:";
-		else return null;
-		launchUrl.searchParams.set("session", sessionId);
-		return launchUrl.toString();
-	} catch {
-		return null;
-	}
-}
 function createInspector(options = {}) {
-	const { url = "ws://localhost:4242", autoOpen = true, name, serializeSnapshot = defaultSerializeSnapshot, extractMachineConfig = defaultExtractMachineConfig, selectedActorId, panels, theme, readOnly, depth, capabilities, transport: injectedTransport } = options;
-	const sessionId = options.sessionId ?? generateSessionId();
+	const environmentUrl = typeof process !== "undefined" ? process.env?.STATELY_INSPECT_URL : void 0;
+	const url = options.url ?? environmentUrl ?? "wss://sky.stately.ai";
+	const { inspectorBaseUrl, autoOpen = true, name, serializeSnapshot = defaultSerializeSnapshot, extractMachineConfig = defaultExtractMachineConfig, selectedSessionId: configuredSelectedSessionId, selectedActorId, panels, theme, readOnly, depth, capabilities, transport: injectedTransport } = options;
+	const roomId = options.roomId ?? options.sessionId ?? getInspectionRoomId(url) ?? generateRoomId();
+	const producerId = options.producerId ?? generateRoomId();
+	const roomUrls = injectedTransport ? null : createInspectionRoomUrls({
+		url,
+		roomId,
+		inspectorBaseUrl
+	});
+	const relayUrl = roomUrls?.relayUrl ?? null;
+	const inspectorUrl = roomUrls?.inspectorUrl ?? null;
 	const displayName = name ?? "system:manual";
 	let destroyed = false;
 	let initSent = false;
@@ -63,13 +61,21 @@ function createInspector(options = {}) {
 	let pendingTransportReady = false;
 	let transportWasReady = false;
 	let didAutoOpen = false;
+	let resolveReady;
+	let rejectReady;
+	let readySettled = false;
+	const ready = new Promise((resolve, reject) => {
+		resolveReady = resolve;
+		rejectReady = reject;
+	});
+	ready.catch(() => {});
 	const pendingMessages = [];
 	const events = createEventRegistry();
 	const localListeners = {};
 	const transport = injectedTransport ?? createWebSocketTransport({
-		url,
-		role: "client",
-		sessionId,
+		url: relayUrl,
+		role: "producer",
+		producerId,
 		metadata: { name: displayName }
 	});
 	const ownsTransport = !injectedTransport;
@@ -87,6 +93,8 @@ function createInspector(options = {}) {
 			if (!initSent) sendInit();
 			const queued = pendingMessages.splice(0);
 			for (const message of queued) transport.send(message);
+			readySettled = true;
+			resolveReady();
 		} else {
 			pendingMessages.length = 0;
 			initSent = false;
@@ -94,8 +102,7 @@ function createInspector(options = {}) {
 		}
 		if (autoOpen && !didAutoOpen && ownsTransport) {
 			didAutoOpen = true;
-			const launchUrl = createInspectorLaunchUrl(url, sessionId);
-			if (launchUrl) openBrowser(launchUrl).catch((error) => {
+			if (inspectorUrl) openBrowser(inspectorUrl).catch((error) => {
 				const failure = {
 					code: "open_failed",
 					message: error instanceof Error ? error.message : "Unable to open the inspector browser"
@@ -112,6 +119,15 @@ function createInspector(options = {}) {
 		}
 		handleTransportReady();
 	});
+	transport.onError?.((failure) => {
+		const error = new Error(failure.message);
+		if (!readySettled) {
+			readySettled = true;
+			rejectReady(error);
+		}
+		emitLocal("error", failure);
+		events.emit("error", failure);
+	});
 	transport.onMessage((msg) => {
 		if (destroyed) return;
 		switch (msg.type) {
@@ -120,6 +136,10 @@ function createInspector(options = {}) {
 				break;
 			case "@statelyai.error":
 				exportManager.reject(new Error(msg.message), msg.requestId);
+				if (!readySettled) {
+					readySettled = true;
+					rejectReady(new Error(msg.message));
+				}
 				emitLocal("error", {
 					code: msg.code,
 					message: msg.message
@@ -138,13 +158,14 @@ function createInspector(options = {}) {
 		for (const handler of set) handler(data);
 	}
 	const actors = /* @__PURE__ */ new Map();
+	const manualSessionIds = /* @__PURE__ */ new Map();
 	/** Tracks which actors we've already emitted local actor events for. */
 	const locallyRegistered = /* @__PURE__ */ new Set();
 	/** v5 emits transition facets separately; accumulate them until snapshot. */
 	const pendingTransitions = /* @__PURE__ */ new Map();
 	function emitRegisterOnce(entry) {
-		if (locallyRegistered.has(entry.actorId)) return;
-		locallyRegistered.add(entry.actorId);
+		if (locallyRegistered.has(entry.sessionId)) return;
+		locallyRegistered.add(entry.sessionId);
 		emitLocal("actor", entry);
 		emitLocal("register", entry);
 	}
@@ -164,10 +185,10 @@ function createInspector(options = {}) {
 	}
 	function toEntry(actorRef, rootActorId, details) {
 		return {
-			actorId: actorRef.sessionId,
-			parentActorId: details?.parentRef?.sessionId ?? actorRef._parent?.sessionId ?? null,
-			rootId: rootActorId,
-			id: details?.id ?? actorRef.id ?? actorRef.sessionId,
+			sessionId: actorRef.sessionId,
+			actorId: details?.id ?? actorRef.id ?? actorRef.sessionId,
+			parentSessionId: details?.parentRef?.sessionId ?? actorRef._parent?.sessionId ?? null,
+			rootSessionId: rootActorId,
 			systemId: actorRef.systemId,
 			snapshot: details?.snapshot ? serializeSnapshot(details.snapshot) : snapshotValue(actorRef),
 			stopped: stoppedValue(actorRef, details?.snapshot),
@@ -176,9 +197,9 @@ function createInspector(options = {}) {
 	}
 	function toSystemEntry(entry) {
 		return {
+			sessionId: entry.sessionId,
 			actorId: entry.actorId,
-			parentActorId: entry.parentActorId,
-			id: entry.id,
+			parentSessionId: entry.parentSessionId,
 			machine: entry.machineConfig,
 			snapshot: entry.snapshot ?? void 0,
 			...entry.stopped && { stopped: true }
@@ -195,7 +216,7 @@ function createInspector(options = {}) {
 			const snapshot = actorRef.getSnapshot();
 			existing.snapshot = serializeSnapshot(snapshot);
 			existing.stopped ||= isStoppedSnapshot(snapshot);
-		} else actors.set(entry.actorId, entry);
+		} else actors.set(entry.sessionId, entry);
 		emitRegisterOnce(entry);
 		const children = actorRef.getSnapshot()?.children ?? {};
 		for (const child of Object.values(children)) if (child) backfillActorTree(child, rootActorId);
@@ -204,12 +225,14 @@ function createInspector(options = {}) {
 	const observedRootIds = /* @__PURE__ */ new Set();
 	function sendInit() {
 		for (const [rootActorId, { actor }] of inspectedRoots) backfillActorTree(actor, rootActorId);
+		const allEntries = Array.from(actors.values());
+		const selectedSessionId = configuredSelectedSessionId ?? selectedActorId ?? observedRootIds.values().next().value ?? allEntries[0]?.sessionId;
 		send({
 			type: "@statelyai.system.init",
 			protocolVersion: INSPECTION_PROTOCOL_VERSION,
 			mode: "inspecting",
-			actors: Array.from(actors.values()).map(toSystemEntry),
-			selectedActorId: selectedActorId ?? observedRootIds.values().next().value ?? sessionId,
+			actors: allEntries.map(toSystemEntry),
+			...selectedSessionId && { selectedSessionId },
 			...theme && { theme },
 			...readOnly !== void 0 && { readOnly },
 			...depth !== void 0 && { depth },
@@ -223,13 +246,13 @@ function createInspector(options = {}) {
 	function handleActor(actorRef, rootActorId, details) {
 		if (actors.has(actorRef.sessionId)) return;
 		const entry = toEntry(actorRef, rootActorId, details);
-		actors.set(entry.actorId, entry);
+		actors.set(entry.sessionId, entry);
 		emitRegisterOnce(entry);
 		if (initSent) send({
 			type: "@statelyai.system.actorRegistered",
+			sessionId: entry.sessionId,
 			actorId: entry.actorId,
-			parentActorId: entry.parentActorId,
-			id: entry.id,
+			parentSessionId: entry.parentSessionId,
 			machine: entry.machineConfig,
 			snapshot: entry.snapshot ?? void 0
 		});
@@ -254,7 +277,7 @@ function createInspector(options = {}) {
 	}
 	function normalizeSentEvent(sentEvent) {
 		return {
-			...sentEvent.targetRef?.sessionId && { targetActorId: sentEvent.targetRef.sessionId },
+			...sentEvent.targetRef?.sessionId && { targetSessionId: sentEvent.targetRef.sessionId },
 			targetId: sentEvent.targetId,
 			event: sentEvent.event,
 			...sentEvent.delay !== void 0 && { delay: sentEvent.delay },
@@ -265,23 +288,23 @@ function createInspector(options = {}) {
 		return {
 			previousSnapshot: actors.get(actorRef.sessionId)?.snapshot ?? null,
 			event,
-			sourceActorId: sourceRef?.sessionId ?? null,
+			sourceSessionId: sourceRef?.sessionId ?? null,
 			actions: [],
 			transitions: [],
 			sent: []
 		};
 	}
-	function handleEvent(actorId, event, sourceActorId) {
+	function handleEvent(sessionId, event, sourceSessionId) {
 		const inspectedEvent = {
-			actorId,
-			sourceActorId,
+			sessionId,
+			sourceSessionId,
 			event
 		};
 		if (initSent) send({
 			type: "@statelyai.system.actorEvent",
-			actorId,
+			sessionId,
 			event,
-			sourceActorId
+			sourceSessionId
 		});
 		emitLocal("event", inspectedEvent);
 	}
@@ -298,8 +321,8 @@ function createInspector(options = {}) {
 		if (!entry) return;
 		const serialized = serializeSnapshot(snapshot);
 		const inspectedSnapshot = {
-			actorId: entry.actorId,
-			sourceActorId: transition.sourceActorId,
+			sessionId: entry.sessionId,
+			sourceSessionId: transition.sourceSessionId,
 			previousSnapshot: transition.previousSnapshot,
 			snapshot: serialized,
 			event: triggeringEvent ?? transition.event ?? null,
@@ -311,14 +334,14 @@ function createInspector(options = {}) {
 		entry.snapshot = serialized;
 		const stopped = isStoppedSnapshot(snapshot);
 		entry.stopped ||= stopped;
-		pendingTransitions.delete(entry.actorId);
+		pendingTransitions.delete(entry.sessionId);
 		if (initSent) send({
 			type: "@statelyai.system.actorSnapshot",
-			actorId: entry.actorId,
+			sessionId: entry.sessionId,
 			previousSnapshot: inspectedSnapshot.previousSnapshot,
 			snapshot: inspectedSnapshot.snapshot,
 			event: inspectedSnapshot.event,
-			sourceActorId: inspectedSnapshot.sourceActorId,
+			sourceSessionId: inspectedSnapshot.sourceSessionId,
 			actions: inspectedSnapshot.actions,
 			transitions: inspectedSnapshot.transitions,
 			sent: inspectedSnapshot.sent
@@ -326,12 +349,12 @@ function createInspector(options = {}) {
 		emitLocal("snapshot", inspectedSnapshot);
 		emitLocal("transition", inspectedSnapshot);
 		if (stopped && !wasStopped) {
-			pendingTransitions.delete(entry.actorId);
+			pendingTransitions.delete(entry.sessionId);
 			if (initSent) send({
 				type: "@statelyai.system.actorStopped",
-				actorId: entry.actorId
+				sessionId: entry.sessionId
 			});
-			const stopped = { actorId: entry.actorId };
+			const stopped = { sessionId: entry.sessionId };
 			emitLocal("stop", stopped);
 			emitLocal("stopped", stopped);
 		}
@@ -372,7 +395,7 @@ function createInspector(options = {}) {
 				handleTransition(event.actorRef, event.snapshot, event.event, rootActorId, {
 					previousSnapshot: actors.get(event.actorRef.sessionId)?.snapshot ?? null,
 					event: event.event,
-					sourceActorId: event.sourceRef?.sessionId ?? null,
+					sourceSessionId: event.sourceRef?.sessionId ?? null,
 					actions: event.actions.map(normalizeAction),
 					transitions: event.microsteps.map(normalizeTakenTransition),
 					sent: event.sent.map(normalizeSentEvent)
@@ -400,37 +423,44 @@ function createInspector(options = {}) {
 			inspectedRoots.delete(rootActorId);
 		} };
 	}
+	function getManualSessionId(actorId) {
+		return manualSessionIds.get(actorId) ?? `${producerId}:${actorId}`;
+	}
 	function manualRegister(id, opts) {
-		if (actors.has(id)) return;
+		const sessionId = getManualSessionId(id);
+		if (actors.has(sessionId)) return;
+		manualSessionIds.set(id, sessionId);
+		const parentSessionId = opts?.parent ? getManualSessionId(opts.parent) : null;
 		const entry = {
+			sessionId,
 			actorId: id,
-			parentActorId: opts?.parent ?? null,
-			rootId: sessionId,
-			id,
+			parentSessionId,
+			rootSessionId: (parentSessionId && actors.get(parentSessionId)?.rootSessionId) ?? sessionId,
 			systemId: opts?.systemId,
 			snapshot: opts?.snapshot ?? null,
 			stopped: false,
 			machineConfig: opts?.machine ?? null
 		};
-		actors.set(id, entry);
+		actors.set(sessionId, entry);
 		if (!initSent) sendInit();
 		else send({
 			type: "@statelyai.system.actorRegistered",
+			sessionId,
 			actorId: id,
-			parentActorId: entry.parentActorId,
-			id,
+			parentSessionId: entry.parentSessionId,
 			machine: entry.machineConfig,
 			snapshot: entry.snapshot ?? void 0
 		});
 		emitRegisterOnce(entry);
 	}
 	function manualSnapshot(actorId, snapshot, event) {
-		if (!actors.has(actorId)) manualRegister(actorId);
-		const entry = actors.get(actorId);
+		const sessionId = getManualSessionId(actorId);
+		if (!actors.has(sessionId)) manualRegister(actorId);
+		const entry = actors.get(sessionId);
 		const previousSnapshot = entry.snapshot;
 		const inspectedSnapshot = {
-			actorId,
-			sourceActorId: null,
+			sessionId,
+			sourceSessionId: null,
 			previousSnapshot,
 			snapshot,
 			event: event ?? null,
@@ -441,11 +471,11 @@ function createInspector(options = {}) {
 		entry.snapshot = snapshot;
 		if (initSent) send({
 			type: "@statelyai.system.actorSnapshot",
-			actorId,
+			sessionId,
 			previousSnapshot,
 			snapshot,
 			event: event ?? null,
-			sourceActorId: null,
+			sourceSessionId: null,
 			actions: [],
 			transitions: [],
 			sent: []
@@ -455,18 +485,20 @@ function createInspector(options = {}) {
 	}
 	function manualEvent(actorId, event, eventOpts) {
 		const eventObj = typeof event === "string" ? { type: event } : { ...event };
-		if (!actors.has(actorId)) manualRegister(actorId);
-		handleEvent(actorId, eventObj, eventOpts?.source ?? null);
+		const sessionId = getManualSessionId(actorId);
+		if (!actors.has(sessionId)) manualRegister(actorId);
+		handleEvent(sessionId, eventObj, eventOpts?.source ? getManualSessionId(eventOpts.source) : null);
 	}
 	function manualStop(actorId) {
-		const entry = actors.get(actorId);
+		const sessionId = getManualSessionId(actorId);
+		const entry = actors.get(sessionId);
 		if (!entry || entry.stopped) return;
 		entry.stopped = true;
 		if (initSent) send({
 			type: "@statelyai.system.actorStopped",
-			actorId
+			sessionId
 		});
-		const stopped = { actorId };
+		const stopped = { sessionId };
 		emitLocal("stop", stopped);
 		emitLocal("stopped", stopped);
 	}
@@ -477,9 +509,14 @@ function createInspector(options = {}) {
 	}
 	return {
 		actors,
+		roomId,
+		relayUrl,
+		producerId,
 		get sessionId() {
-			return sessionId;
+			return roomId;
 		},
+		inspectorUrl,
+		ready,
 		inspect: handleInspectionEvent,
 		attach: attachActor,
 		on(event, handler) {