@statelyai/sdk 0.38.1 → 0.38.2

package/README.md

@@ -96,6 +96,9 @@ also update that frame surface.
 If the initial theme is omitted, the SDK keeps the iframe hidden until the
 machine loads or reports an error, so a theme supplied only to `init` cannot
 flash the default theme. The surrounding host supplies the waiting surface.
+For same-site OAuth embeds without an API key, the sign-in prompt reports
+`unauthenticated` through `onError` and reveals the iframe. Keep it mounted;
+initialization remains queued until sign-in completes and the editor is ready.
 Source conversion failures notify `onError` and reveal the editor's error screen.
 Protocol incompatibility also restores the frame's visibility and reports the
 failure to the host.

package/dist/assetStorage.d.mts

@@ -1,4 +1,4 @@
-import { Zt as UploadResult } from "./protocol-weYUfy3l.mjs";
+import { Qt as UploadResult } from "./protocol-DkcbN7fu.mjs";
 //#region src/assetStorage.d.ts
 interface AssetUploadContext {
   stateNodeId: string;

package/dist/editorHostProtocol.d.mts

@@ -1,5 +1,5 @@
 import { o as GraphPatch } from "./index-DfMkVP94.mjs";
-import { fn as PresentationMetadataInitializer, mt as ProjectWorkspaceConfig, n as AuthenticationRecovery, pn as EmbedPanelConfig, rt as ProjectEmbedMachine } from "./protocol-weYUfy3l.mjs";
+import { mn as EmbedPanelConfig, mt as ProjectWorkspaceConfig, n as AuthenticationRecovery, pn as PresentationMetadataInitializer, rt as ProjectEmbedMachine } from "./protocol-DkcbN7fu.mjs";
 import { a as MachineSourceLocations, t as EditorCapabilities } from "./editor-sync-types-Ch5P5XRj.mjs";
 
 //#region src/editorHostProtocol.d.ts

package/dist/embed.d.mts

@@ -1,6 +1,6 @@
 import { n as ProfileManifest, o as GraphPatch } from "./index-DfMkVP94.mjs";
-import { i as StatelyGraph } from "./graph-C--idnZO.mjs";
-import { $ as MachineVersionAutoSaveOptions, A as ExportFormat, E as EmbedMode, F as HostUpdateOptions, Q as MachineSourceLocations, S as EmbedEventName, X as MachineInitOptions, Zt as UploadResult, at as ProjectInitOptions, b as EmbedEventHandler, dt as ProjectWorkspaceActionIcon, f as CommentsConfig, gt as ProjectWorkspaceMachineOrigin, h as EditorCapabilities, ht as ProjectWorkspaceMachine, i as CapabilityDeniedEvent, j as ExportFormatMap, k as ExportCallOptions, mn as EmbedPanelPosition, mt as ProjectWorkspaceConfig, pn as EmbedPanelConfig, pt as ProjectWorkspaceCapabilities, rt as ProjectEmbedMachine, tn as ViewerOptions, ut as ProjectWorkspaceAction, v as EmbedDocument, vt as ProjectWorkspaceProject, w as EmbedExtensionsManifest, x as EmbedEventMap, y as EmbedDocumentLanguage, z as InitOptions } from "./protocol-weYUfy3l.mjs";
+import { i as StatelyGraph } from "./graph-CfWCJS4m.mjs";
+import { $ as MachineVersionAutoSaveOptions, A as ExportFormat, E as EmbedMode, F as HostUpdateOptions, Q as MachineSourceLocations, Qt as UploadResult, S as EmbedEventName, X as MachineInitOptions, at as ProjectInitOptions, b as EmbedEventHandler, dt as ProjectWorkspaceActionIcon, f as CommentsConfig, gt as ProjectWorkspaceMachineOrigin, h as EditorCapabilities, hn as EmbedPanelPosition, ht as ProjectWorkspaceMachine, i as CapabilityDeniedEvent, j as ExportFormatMap, k as ExportCallOptions, mn as EmbedPanelConfig, mt as ProjectWorkspaceConfig, nn as ViewerOptions, pt as ProjectWorkspaceCapabilities, rt as ProjectEmbedMachine, ut as ProjectWorkspaceAction, v as EmbedDocument, vt as ProjectWorkspaceProject, w as EmbedExtensionsManifest, x as EmbedEventMap, y as EmbedDocumentLanguage, z as InitOptions } from "./protocol-DkcbN7fu.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 import { GraphDiff } from "@statelyai/graph";
 

package/dist/embed.mjs

@@ -1,5 +1,5 @@
 import "./protocol-M3Zeun3o.mjs";
-import { c as createPendingExportManager, l as settingsWithViewMode, r as createPostMessageTransport, s as createEventRegistry, t as SDK_VERSION, u as toInitMessage } from "./version-IE72VxaP.mjs";
+import { c as createPendingExportManager, l as settingsWithViewMode, r as createPostMessageTransport, s as createEventRegistry, t as SDK_VERSION, u as toInitMessage } from "./version-BRCbR47D.mjs";
 import { EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol.mjs";
 
 //#region src/embed.ts

package/dist/{graph-C--idnZO.d.mts → graph-CfWCJS4m.d.mts}

@@ -268,13 +268,17 @@ type DigraphInlineAction = {
 };
 type DigraphBuiltinAction = DigraphAssignAction | DigraphRaiseAction | DigraphLogAction | DigraphSendToAction | DigraphStopAction;
 type DigraphAction = DigraphNamedAction | DigraphInlineAction | DigraphBuiltinAction;
-type AssetTemplate = '@stately.image' | '@figma.link' | '@stately.video' | '@stately.pdf' | '@stately.text' | '@stately.unknown';
+type AssetTemplate = '@stately.iframe' | '@stately.image' | '@figma.link' | '@stately.video' | '@stately.pdf' | '@stately.text' | '@stately.unknown';
 type AssetSize = 'sm' | 'md' | 'lg' | 'xl';
 interface AssetProperties {
   uuid: string;
   url: string;
 }
-type DigraphAssetProperties<T extends AssetTemplate> = T extends '@stately.image' ? AssetProperties & {
+type DigraphAssetProperties<T extends AssetTemplate> = T extends '@stately.iframe' ? AssetProperties & {
+  size: AssetSize;
+  width?: number;
+  height?: number;
+} : T extends '@stately.image' ? AssetProperties & {
   size: AssetSize;
   path: string;
 } : T extends '@figma.link' ? AssetProperties & {

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-C--idnZO.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-CfWCJS4m.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,13 +1,14 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
 import { o as GraphPatch, r as ActionLocation } from "./index-DfMkVP94.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-C--idnZO.mjs";
-import { $ as MachineVersionAutoSaveOptions, A as ExportFormat, C as EmbedExample, E as EmbedMode, F as HostUpdateOptions, G as InspectionTakenTransition, I as INSPECTION_PROTOCOL_VERSION, K as InspectorLoadedEvent, L as INSPECTION_ROOM_QUERY_PARAM, S as EmbedEventName, V as InspectionAction, W as InspectionSentEvent, Zt as UploadResult, _ as EmbedChromeOptions, an as createInspectionRoomUrls, b as EmbedEventHandler, cn as isEmbedExampleMachine, dn as resolveInspectorSettings, dt as ProjectWorkspaceActionIcon, f as CommentsConfig, fn as PresentationMetadataInitializer, gt as ProjectWorkspaceMachineOrigin, h as EditorCapabilities, ht as ProjectWorkspaceMachine, i as CapabilityDeniedEvent, in as createInspectionActorId, j as ExportFormatMap, k as ExportCallOptions, m as EMBED_DOCUMENT_LIMITS, mn as EmbedPanelPosition, mt as ProjectWorkspaceConfig, on as getInspectionRoomId, p as EMBED_DOCUMENT_LANGUAGES, pn as EmbedPanelConfig, pt as ProjectWorkspaceCapabilities, q as InspectorSettings, r as CapabilityDeniedCapability, rn as assertEmbedExamples, rt as ProjectEmbedMachine, sn as isEmbedExample, tn as ViewerOptions, un as mergeInspectorSettings, ut as ProjectWorkspaceAction, v as EmbedDocument, vt as ProjectWorkspaceProject, x as EmbedEventMap, y as EmbedDocumentLanguage, z as InitOptions } from "./protocol-weYUfy3l.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-CfWCJS4m.mjs";
+import { $ as MachineVersionAutoSaveOptions, A as ExportFormat, C as EmbedExample, E as EmbedMode, F as HostUpdateOptions, G as InspectionTakenTransition, I as INSPECTION_PROTOCOL_VERSION, K as InspectorLoadedEvent, L as INSPECTION_ROOM_QUERY_PARAM, Qt as UploadResult, S as EmbedEventName, V as InspectionAction, W as InspectionSentEvent, _ as EmbedChromeOptions, an as createInspectionActorId, b as EmbedEventHandler, cn as isEmbedExample, dn as mergeInspectorSettings, dt as ProjectWorkspaceActionIcon, f as CommentsConfig, fn as resolveInspectorSettings, gt as ProjectWorkspaceMachineOrigin, h as EditorCapabilities, hn as EmbedPanelPosition, ht as ProjectWorkspaceMachine, i as CapabilityDeniedEvent, in as assertEmbedExamples, j as ExportFormatMap, k as ExportCallOptions, ln as isEmbedExampleMachine, m as EMBED_DOCUMENT_LIMITS, mn as EmbedPanelConfig, mt as ProjectWorkspaceConfig, nn as ViewerOptions, on as createInspectionRoomUrls, p as EMBED_DOCUMENT_LANGUAGES, pn as PresentationMetadataInitializer, pt as ProjectWorkspaceCapabilities, q as InspectorSettings, r as CapabilityDeniedCapability, rt as ProjectEmbedMachine, sn as getInspectionRoomId, ut as ProjectWorkspaceAction, v as EmbedDocument, vt as ProjectWorkspaceProject, x as EmbedEventMap, y as EmbedDocumentLanguage, z as InitOptions } from "./protocol-DkcbN7fu.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.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, PlanSourceUpdateInput, SourceUpdateEdit, SourceUpdatePlan, 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-BEboOFmE.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-0f8OvMck.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-DSwp5rXP.mjs";
 import { OAuthAuthorizationServerMetadata, OAuthClientRegistrationResponse, OAuthProtectedResourceMetadata, OAuthTokenResponse, PkcePair, buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { CreateInspectionRelayOptions, InspectionRelay, InspectionRelayEffect, InspectionRelayPeer, InspectionRelayRole, InspectionRelaySnapshot, createInspectionRelay } from "./relay.mjs";
-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 EmbedChromeOptions, 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, type HostUpdateOptions, 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 PlanSourceUpdateInput, type PresentationMetadataInitializer, 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 SourceUpdateEdit, type SourceUpdatePlan, 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 };
+import { PreviewEvent, PreviewState, connectPreviewHost, createPreview } from "./preview.mjs";
+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 EmbedChromeOptions, 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, type HostUpdateOptions, 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 PlanSourceUpdateInput, type PresentationMetadataInitializer, type PreviewEvent, type PreviewState, 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 SourceUpdateEdit, type SourceUpdatePlan, 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, connectPreviewHost, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createPreview, 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,14 +1,15 @@
 import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-uGK1kS0n.mjs";
 import { c as createInspectionRoomUrls, d as isEmbedExampleMachine, i as INSPECTION_ROOM_QUERY_PARAM, l as getInspectionRoomId, m as resolveInspectorSettings, n as EMBED_DOCUMENT_LIMITS, o as assertEmbedExamples, p as mergeInspectorSettings, r as INSPECTION_PROTOCOL_VERSION, s as createInspectionActorId, t as EMBED_DOCUMENT_LANGUAGES, u as isEmbedExample } from "./protocol-M3Zeun3o.mjs";
-import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-IE72VxaP.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-BRCbR47D.mjs";
 import { EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-Ca_ZPcrf.mjs";
+import { connectPreviewHost, createPreview } from "./preview.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-CbLY5tk9.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, 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 };
+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, connectPreviewHost, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createPreview, 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-BEboOFmE.d.mts → inspect-0f8OvMck.d.mts}

@@ -1,4 +1,4 @@
-import { A as ExportFormat, G as InspectionTakenTransition, H as InspectionClientMetadata, K as InspectorLoadedEvent, V as InspectionAction, W as InspectionSentEvent, Z as MachinePayload, j as ExportFormatMap, k as ExportCallOptions, q as InspectorSettings, tn as ViewerOptions, x as EmbedEventMap, yt as ProtocolMessage } from "./protocol-weYUfy3l.mjs";
+import { A as ExportFormat, G as InspectionTakenTransition, H as InspectionClientMetadata, K as InspectorLoadedEvent, V as InspectionAction, W as InspectionSentEvent, Z as MachinePayload, j as ExportFormatMap, k as ExportCallOptions, nn as ViewerOptions, q as InspectorSettings, x as EmbedEventMap, yt as ProtocolMessage } from "./protocol-DkcbN7fu.mjs";
 
 //#region src/transport.d.ts
 interface TransportFailure {
@@ -43,6 +43,10 @@ interface MinimalActorRef {
   };
   src?: unknown;
   getSnapshot(): MinimalSnapshot;
+  send?(event: {
+    type: string;
+    [key: string]: unknown;
+  }): void;
   system: {
     inspect: (observer: (event: InspectorInspectionEvent) => void) => {
       unsubscribe: () => void;
@@ -144,6 +148,8 @@ interface ManualActorOptions {
   systemId?: string;
 }
 interface CreateInspectorOptions extends ViewerOptions<InspectorSettings> {
+  /** Allow this inspector to send events to owned, live runtime actors. Default false. */
+  bidirectional?: boolean;
   /**
    * WebSocket relay base URL. Defaults to `STATELY_INSPECT_URL`, then
    * `wss://sky.stately.ai`. Passing this option always wins.

package/dist/{inspect-Ca_ZPcrf.mjs → inspect-CbLY5tk9.mjs}

@@ -1,5 +1,6 @@
 import { c as createInspectionRoomUrls, l as getInspectionRoomId, m as resolveInspectorSettings, p as mergeInspectorSettings, r as INSPECTION_PROTOCOL_VERSION } from "./protocol-M3Zeun3o.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-IE72VxaP.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-BRCbR47D.mjs";
+import { isPreviewEvent } from "./preview.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
@@ -272,6 +273,20 @@ function createInspector(options = {}) {
 		if (destroyed) return;
 		if (msg.producerId && msg.producerId !== producerId) return;
 		switch (msg.type) {
+			case "@statelyai.system.sendEvent": {
+				if (options.bidirectional !== true || !isPreviewEvent(msg.event)) break;
+				const actor = actorsByResolvedSessionId.get(msg.sessionId);
+				if (!actor || terminatedActors.has(actor) || actor.getSnapshot().status !== "active") break;
+				try {
+					actor.send?.(msg.event);
+				} catch (cause) {
+					emitLocal("error", {
+						code: "inspection_failed",
+						message: cause instanceof Error ? cause.message : String(cause)
+					});
+				}
+				break;
+			}
 			case "@statelyai.system.loaded":
 				emitLocal("loaded", { ...msg.producerId && { producerId: msg.producerId } });
 				break;
@@ -495,6 +510,7 @@ function createInspector(options = {}) {
 			type: "@statelyai.system.init",
 			protocolVersion: INSPECTION_PROTOCOL_VERSION,
 			mode: "inspecting",
+			...options.bidirectional === true && { bidirectional: true },
 			actors: allEntries.map(toSystemEntry),
 			...configuredMachines !== void 0 || Object.keys(declaredMachines).length > 0 ? { machines: { ...declaredMachines } } : {},
 			...selectedSessionId && { selectedSessionId },

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
-import { A as ExportFormat, E as EmbedMode, G as InspectionTakenTransition, K as InspectorLoadedEvent, S as EmbedEventName, V as InspectionAction, W as InspectionSentEvent, Z as MachinePayload, b as EmbedEventHandler, h as EditorCapabilities, j as ExportFormatMap, k as ExportCallOptions, pn as EmbedPanelConfig, q as InspectorSettings, tn as ViewerOptions, v as EmbedDocument, x as EmbedEventMap } from "./protocol-weYUfy3l.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-BEboOFmE.mjs";
+import { A as ExportFormat, E as EmbedMode, G as InspectionTakenTransition, K as InspectorLoadedEvent, S as EmbedEventName, V as InspectionAction, W as InspectionSentEvent, Z as MachinePayload, b as EmbedEventHandler, h as EditorCapabilities, j as ExportFormatMap, k as ExportCallOptions, mn as EmbedPanelConfig, nn as ViewerOptions, q as InspectorSettings, v as EmbedDocument, x as EmbedEventMap } from "./protocol-DkcbN7fu.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-0f8OvMck.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,6 @@
 import "./protocol-M3Zeun3o.mjs";
-import "./version-IE72VxaP.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-Ca_ZPcrf.mjs";
+import "./version-BRCbR47D.mjs";
+import "./preview.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-CbLY5tk9.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/preview.d.mts

@@ -0,0 +1,36 @@
+//#region src/preview.d.ts
+/** A preview observes editor-owned state and may request events. */
+interface PreviewState {
+  machine: unknown;
+  snapshot: unknown;
+  mode: string;
+  canSend: boolean;
+  surface: 'inline' | 'preview';
+}
+type PreviewEvent = {
+  type: string;
+  [key: string]: unknown;
+};
+declare function isPreviewEvent(event: unknown): event is PreviewEvent;
+/** Connect only the expected child window, including opaque sandbox origins. */
+declare function connectPreviewHost(options: {
+  window: Window;
+  getState(): PreviewState;
+  onEvent(event: PreviewEvent): void; /** Required for a detached, unsandboxed wrapper; sandbox children use null. */
+  origin?: string;
+}): {
+  update: () => void;
+  destroy(): void;
+};
+/** No machine/snapshot mutation API: the connected editor remains the owner. */
+declare function createPreview(options?: {
+  target?: Window;
+  targetOrigin?: string;
+}): {
+  getState: () => PreviewState | undefined;
+  subscribe(listener: (state: PreviewState) => void): () => void;
+  send(event: PreviewEvent): boolean;
+  destroy(): void;
+};
+//#endregion
+export { PreviewEvent, PreviewState, connectPreviewHost, createPreview, isPreviewEvent };

package/dist/preview.mjs

@@ -0,0 +1,92 @@
+//#region src/preview.ts
+function isPreviewEvent(event) {
+	return !!event && typeof event === "object" && typeof event.type === "string" && event.type.trim().length > 0 && !event.type.startsWith("xstate.") && !event.type.startsWith("@xstate.");
+}
+/** Connect only the expected child window, including opaque sandbox origins. */
+function connectPreviewHost(options) {
+	let port;
+	const update = () => {
+		if (!port) return;
+		try {
+			port.postMessage({
+				type: "@statelyai.preview.state",
+				state: options.getState()
+			});
+		} catch {}
+	};
+	const receive = (event) => {
+		if (event.source !== options.window || event.origin !== (options.origin ?? "null") || event.data?.type !== "@statelyai.preview.ready" || typeof event.data.requestId !== "string") return;
+		port?.close();
+		const channel = new MessageChannel();
+		port = channel.port1;
+		port.onmessage = ({ data }) => {
+			if (data?.type === "@statelyai.preview.event" && options.getState().canSend && isPreviewEvent(data.event)) options.onEvent(data.event);
+		};
+		options.window.postMessage({
+			type: "@statelyai.preview.connect",
+			requestId: event.data.requestId
+		}, options.origin ?? "*", [channel.port2]);
+		update();
+	};
+	window.addEventListener("message", receive);
+	return {
+		update,
+		destroy() {
+			window.removeEventListener("message", receive);
+			port?.close();
+		}
+	};
+}
+/** No machine/snapshot mutation API: the connected editor remains the owner. */
+function createPreview(options = {}) {
+	const target = options.target ?? (window.parent !== window ? window.parent : window.opener);
+	const requestId = crypto.randomUUID();
+	const listeners = /* @__PURE__ */ new Set();
+	let state;
+	let port;
+	const ready = () => target?.postMessage({
+		type: "@statelyai.preview.ready",
+		requestId
+	}, options.targetOrigin ?? "*");
+	const receive = (event) => {
+		if (event.source !== target || options.targetOrigin && event.origin !== options.targetOrigin || event.data?.type !== "@statelyai.preview.connect" || event.data.requestId !== requestId || !event.ports[0] || port) return;
+		port = event.ports[0];
+		clearInterval(retry);
+		port.onmessage = ({ data }) => {
+			if (data?.type !== "@statelyai.preview.state") return;
+			state = data.state;
+			for (const listener of listeners) listener(state);
+		};
+		port.start();
+	};
+	window.addEventListener("message", receive);
+	const retry = setInterval(ready, 500);
+	ready();
+	return {
+		getState: () => state,
+		subscribe(listener) {
+			listeners.add(listener);
+			if (state) listener(state);
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		send(event) {
+			if (!state?.canSend || !isPreviewEvent(event)) return false;
+			port?.postMessage({
+				type: "@statelyai.preview.event",
+				event
+			});
+			return !!port;
+		},
+		destroy() {
+			clearInterval(retry);
+			window.removeEventListener("message", receive);
+			port?.close();
+			listeners.clear();
+		}
+	};
+}
+
+//#endregion
+export { connectPreviewHost, createPreview, isPreviewEvent };

package/dist/{protocol-weYUfy3l.d.mts → protocol-DkcbN7fu.d.mts}

@@ -1,5 +1,5 @@
 import { n as ProfileManifest, o as GraphPatch } from "./index-DfMkVP94.mjs";
-import { b as DigraphConfig, i as StatelyGraph } from "./graph-C--idnZO.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-CfWCJS4m.mjs";
 import { a as MachineSourceLocations$1, i as EditorSyncStateSourceLocation, n as EditorSyncSourceLocation, r as EditorSyncSourceRange, t as EditorCapabilities$1 } from "./editor-sync-types-Ch5P5XRj.mjs";
 
 //#region src/embedPanel.d.ts
@@ -642,6 +642,8 @@ interface InspectionSentEvent {
 }
 interface SystemInitMessage extends ViewerOptions<InspectorSettings> {
   type: '@statelyai.system.init';
+  /** Permit event requests to owned runtime actors. Default false. */
+  bidirectional?: boolean;
   protocolVersion: number;
   /** All known actors at the moment the system is first streamed. */
   actors: ActorSystemEntry[];
@@ -888,7 +890,15 @@ interface ExtensionResultMessage {
 /** All messages a client (embed/inspector) can send to the viz. */
 type ClientMessage = InitMessage | SetApiKeyMessage | EditorHandshakeMessage | SavedMessage | ClipboardReadResponseMessage | ClipboardWriteResponseMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | ProjectSetWorkspaceOpenMessage | UpdateMessage | HighlightMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | ToastDismissMessage | InspectSnapshotMessage | SystemInitMessage | SystemSelectActorMessage | SystemActorRegisteredMessage | SystemActorEventMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ExtensionResultMessage | ErrorMessage;
 /** All messages the viz can send back to a client. */
-type VizMessage = LoginMessage | SystemLoadedMessage | ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | VersionSaveRequestedMessage | ProjectMachineSelectedMessage | ProjectWorkspaceActionMessage | ProjectWorkspaceOpenChangedMessage | ViewModeChangedMessage | PanelChangedMessage | ModeChangedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage | ExtensionCallMessage;
+interface SystemSendEventMessage {
+  type: '@statelyai.system.sendEvent';
+  sessionId: string;
+  event: {
+    type: string;
+    [key: string]: unknown;
+  };
+}
+type VizMessage = SystemSendEventMessage | LoginMessage | SystemLoadedMessage | ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | VersionSaveRequestedMessage | ProjectMachineSelectedMessage | ProjectWorkspaceActionMessage | ProjectWorkspaceOpenChangedMessage | ViewModeChangedMessage | PanelChangedMessage | ModeChangedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage | ExtensionCallMessage;
 interface InspectionClientMetadata {
   name?: string;
   machineId?: string;
@@ -917,4 +927,4 @@ declare const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
 declare const INSPECTION_PROTOCOL_VERSION = 2;
 //#endregion
-export { MachineVersionAutoSaveOptions as $, VersionSaveRequestedMessage as $t, ExportFormat as A, SetApiKeyMessage as At, InspectSnapshotMessage as B, SystemActorStoppedMessage as Bt, EmbedExample as C, RegisteredMessage as Ct, ErrorCode as D, SavedMessage as Dt, EmbedMode as E, SaveMessage as Et, HostUpdateOptions as F, SourceRange as Ft, InspectionTakenTransition as G, ToastMessage as Gt, InspectionClientMetadata as H, SystemLoadedMessage as Ht, INSPECTION_PROTOCOL_VERSION as I, StateSourceLocation as It, LoadedMessage as J, UploadFileInfo as Jt, InspectorLoadedEvent as K, UpdateMessage as Kt, INSPECTION_ROOM_QUERY_PARAM as L, SystemActorEventMessage as Lt, ExtensionCallMessage as M, SetSettingsMessage as Mt, ExtensionResultMessage as N, SetThemeMessage as Nt, ErrorMessage as O, SerializedInspectionMachine as Ot, HighlightMessage as P, SourceLocation as Pt, MachineSourceLocations as Q, ValidationIssue as Qt, InitMessage as R, SystemActorRegisteredMessage as Rt, EmbedEventName as S, RegisterMessage as St, EmbedFormatManifest as T, RetrievedMessage as Tt, InspectionRoomUrls as U, SystemSelectActorMessage as Ut, InspectionAction as V, SystemInitMessage as Vt, InspectionSentEvent as W, ToastDismissMessage as Wt, MachineInitOptions as X, UploadResponseMessage as Xt, LoginMessage as Y, UploadRequestMessage as Yt, MachinePayload as Z, UploadResult as Zt, EmbedChromeOptions as _, ProjectWorkspaceOpenChangedMessage as _t, CapabilityDeniedMessage as a, createInspectionRoomUrls as an, ProjectInitOptions as at, EmbedEventHandler as b, ReadOnlyReason as bt, ClipboardReadMessage as c, isEmbedExampleMachine as cn, ProjectSetWorkspaceOpenMessage as ct, ClipboardWriteResponseMessage as d, resolveInspectorSettings as dn, ProjectWorkspaceActionIcon as dt, ViewModeChangedMessage as en, ModeChangedMessage as et, CommentsConfig as f, PresentationMetadataInitializer as fn, ProjectWorkspaceActionMessage as ft, EditorHandshakeMessage as g, ProjectWorkspaceMachineOrigin as gt, EditorCapabilities as h, ProjectWorkspaceMachine as ht, CapabilityDeniedEvent as i, createInspectionActorId as in, ProjectInitMessage as it, ExportFormatMap as j, SetModeMessage as jt, ExportCallOptions as k, SessionMessage as kt, ClipboardReadResponseMessage as l, isSerializedInspectionMachine as ln, ProjectUpdateMessage as lt, EMBED_DOCUMENT_LIMITS as m, EmbedPanelPosition as mn, ProjectWorkspaceConfig as mt, AuthenticationRecovery as n, VizMessage as nn, PanelChangedMessage as nt, ChangeMessage as o, getInspectionRoomId as on, ProjectMachineSelectedMessage as ot, EMBED_DOCUMENT_LANGUAGES as p, EmbedPanelConfig as pn, ProjectWorkspaceCapabilities as pt, InspectorSettings as q, UploadCapabilitiesMessage as qt, CapabilityDeniedCapability as r, assertEmbedExamples as rn, ProjectEmbedMachine as rt, ClientMessage as s, isEmbedExample as sn, ProjectSelectMachineMessage as st, ActorSystemEntry as t, ViewerOptions as tn, PREFIX as tt, ClipboardWriteMessage as u, mergeInspectorSettings as un, ProjectWorkspaceAction as ut, EmbedDocument as v, ProjectWorkspaceProject as vt, EmbedExtensionsManifest as w, RetrieveMessage as wt, EmbedEventMap as x, ReadyMessage as xt, EmbedDocumentLanguage as y, ProtocolMessage as yt, InitOptions as z, SystemActorSnapshotMessage as zt };
+export { MachineVersionAutoSaveOptions as $, ValidationIssue as $t, ExportFormat as A, SetApiKeyMessage as At, InspectSnapshotMessage as B, SystemActorStoppedMessage as Bt, EmbedExample as C, RegisteredMessage as Ct, ErrorCode as D, SavedMessage as Dt, EmbedMode as E, SaveMessage as Et, HostUpdateOptions as F, SourceRange as Ft, InspectionTakenTransition as G, ToastDismissMessage as Gt, InspectionClientMetadata as H, SystemLoadedMessage as Ht, INSPECTION_PROTOCOL_VERSION as I, StateSourceLocation as It, LoadedMessage as J, UploadCapabilitiesMessage as Jt, InspectorLoadedEvent as K, ToastMessage as Kt, INSPECTION_ROOM_QUERY_PARAM as L, SystemActorEventMessage as Lt, ExtensionCallMessage as M, SetSettingsMessage as Mt, ExtensionResultMessage as N, SetThemeMessage as Nt, ErrorMessage as O, SerializedInspectionMachine as Ot, HighlightMessage as P, SourceLocation as Pt, MachineSourceLocations as Q, UploadResult as Qt, InitMessage as R, SystemActorRegisteredMessage as Rt, EmbedEventName as S, RegisterMessage as St, EmbedFormatManifest as T, RetrievedMessage as Tt, InspectionRoomUrls as U, SystemSelectActorMessage as Ut, InspectionAction as V, SystemInitMessage as Vt, InspectionSentEvent as W, SystemSendEventMessage as Wt, MachineInitOptions as X, UploadRequestMessage as Xt, LoginMessage as Y, UploadFileInfo as Yt, MachinePayload as Z, UploadResponseMessage as Zt, EmbedChromeOptions as _, ProjectWorkspaceOpenChangedMessage as _t, CapabilityDeniedMessage as a, createInspectionActorId as an, ProjectInitOptions as at, EmbedEventHandler as b, ReadOnlyReason as bt, ClipboardReadMessage as c, isEmbedExample as cn, ProjectSetWorkspaceOpenMessage as ct, ClipboardWriteResponseMessage as d, mergeInspectorSettings as dn, ProjectWorkspaceActionIcon as dt, VersionSaveRequestedMessage as en, ModeChangedMessage as et, CommentsConfig as f, resolveInspectorSettings as fn, ProjectWorkspaceActionMessage as ft, EditorHandshakeMessage as g, ProjectWorkspaceMachineOrigin as gt, EditorCapabilities as h, EmbedPanelPosition as hn, ProjectWorkspaceMachine as ht, CapabilityDeniedEvent as i, assertEmbedExamples as in, ProjectInitMessage as it, ExportFormatMap as j, SetModeMessage as jt, ExportCallOptions as k, SessionMessage as kt, ClipboardReadResponseMessage as l, isEmbedExampleMachine as ln, ProjectUpdateMessage as lt, EMBED_DOCUMENT_LIMITS as m, EmbedPanelConfig as mn, ProjectWorkspaceConfig as mt, AuthenticationRecovery as n, ViewerOptions as nn, PanelChangedMessage as nt, ChangeMessage as o, createInspectionRoomUrls as on, ProjectMachineSelectedMessage as ot, EMBED_DOCUMENT_LANGUAGES as p, PresentationMetadataInitializer as pn, ProjectWorkspaceCapabilities as pt, InspectorSettings as q, UpdateMessage as qt, CapabilityDeniedCapability as r, VizMessage as rn, ProjectEmbedMachine as rt, ClientMessage as s, getInspectionRoomId as sn, ProjectSelectMachineMessage as st, ActorSystemEntry as t, ViewModeChangedMessage as tn, PREFIX as tt, ClipboardWriteMessage as u, isSerializedInspectionMachine as un, ProjectWorkspaceAction as ut, EmbedDocument as v, ProjectWorkspaceProject as vt, EmbedExtensionsManifest as w, RetrieveMessage as wt, EmbedEventMap as x, ReadyMessage as xt, EmbedDocumentLanguage as y, ProtocolMessage as yt, InitOptions as z, SystemActorSnapshotMessage as zt };

package/dist/protocol.d.mts

@@ -1,2 +1,2 @@
-import { $ as MachineVersionAutoSaveOptions, $t as VersionSaveRequestedMessage, A as ExportFormat, At as SetApiKeyMessage, B as InspectSnapshotMessage, Bt as SystemActorStoppedMessage, C as EmbedExample, Ct as RegisteredMessage, D as ErrorCode, Dt as SavedMessage, E as EmbedMode, Et as SaveMessage, F as HostUpdateOptions, Ft as SourceRange, G as InspectionTakenTransition, Gt as ToastMessage, H as InspectionClientMetadata, Ht as SystemLoadedMessage, I as INSPECTION_PROTOCOL_VERSION, It as StateSourceLocation, J as LoadedMessage, Jt as UploadFileInfo, K as InspectorLoadedEvent, Kt as UpdateMessage, L as INSPECTION_ROOM_QUERY_PARAM, Lt as SystemActorEventMessage, M as ExtensionCallMessage, Mt as SetSettingsMessage, N as ExtensionResultMessage, Nt as SetThemeMessage, O as ErrorMessage, Ot as SerializedInspectionMachine, P as HighlightMessage, Pt as SourceLocation, Q as MachineSourceLocations, Qt as ValidationIssue, R as InitMessage, Rt as SystemActorRegisteredMessage, S as EmbedEventName, St as RegisterMessage, T as EmbedFormatManifest, Tt as RetrievedMessage, U as InspectionRoomUrls, Ut as SystemSelectActorMessage, V as InspectionAction, Vt as SystemInitMessage, W as InspectionSentEvent, Wt as ToastDismissMessage, X as MachineInitOptions, Xt as UploadResponseMessage, Y as LoginMessage, Yt as UploadRequestMessage, Z as MachinePayload, Zt as UploadResult, _ as EmbedChromeOptions, _t as ProjectWorkspaceOpenChangedMessage, a as CapabilityDeniedMessage, an as createInspectionRoomUrls, at as ProjectInitOptions, b as EmbedEventHandler, bt as ReadOnlyReason, c as ClipboardReadMessage, cn as isEmbedExampleMachine, ct as ProjectSetWorkspaceOpenMessage, d as ClipboardWriteResponseMessage, dn as resolveInspectorSettings, dt as ProjectWorkspaceActionIcon, en as ViewModeChangedMessage, et as ModeChangedMessage, f as CommentsConfig, ft as ProjectWorkspaceActionMessage, g as EditorHandshakeMessage, gt as ProjectWorkspaceMachineOrigin, h as EditorCapabilities, ht as ProjectWorkspaceMachine, i as CapabilityDeniedEvent, in as createInspectionActorId, it as ProjectInitMessage, j as ExportFormatMap, jt as SetModeMessage, k as ExportCallOptions, kt as SessionMessage, l as ClipboardReadResponseMessage, ln as isSerializedInspectionMachine, lt as ProjectUpdateMessage, m as EMBED_DOCUMENT_LIMITS, mn as EmbedPanelPosition, mt as ProjectWorkspaceConfig, n as AuthenticationRecovery, nn as VizMessage, nt as PanelChangedMessage, o as ChangeMessage, on as getInspectionRoomId, ot as ProjectMachineSelectedMessage, p as EMBED_DOCUMENT_LANGUAGES, pn as EmbedPanelConfig, pt as ProjectWorkspaceCapabilities, q as InspectorSettings, qt as UploadCapabilitiesMessage, r as CapabilityDeniedCapability, rn as assertEmbedExamples, rt as ProjectEmbedMachine, s as ClientMessage, sn as isEmbedExample, st as ProjectSelectMachineMessage, t as ActorSystemEntry, tn as ViewerOptions, tt as PREFIX, u as ClipboardWriteMessage, un as mergeInspectorSettings, ut as ProjectWorkspaceAction, v as EmbedDocument, vt as ProjectWorkspaceProject, w as EmbedExtensionsManifest, wt as RetrieveMessage, x as EmbedEventMap, xt as ReadyMessage, y as EmbedDocumentLanguage, yt as ProtocolMessage, z as InitOptions, zt as SystemActorSnapshotMessage } from "./protocol-weYUfy3l.mjs";
-export { ActorSystemEntry, AuthenticationRecovery, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, ClipboardReadMessage, ClipboardReadResponseMessage, ClipboardWriteMessage, ClipboardWriteResponseMessage, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EditorHandshakeMessage, EmbedChromeOptions, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExample, EmbedExtensionsManifest, EmbedFormatManifest, EmbedMode, EmbedPanelConfig, EmbedPanelPosition, ErrorCode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, ExtensionCallMessage, ExtensionResultMessage, HighlightMessage, HostUpdateOptions, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, InspectorLoadedEvent, InspectorSettings, LoadedMessage, LoginMessage, MachineInitOptions, MachinePayload, MachineSourceLocations, MachineVersionAutoSaveOptions, ModeChangedMessage, PREFIX, PanelChangedMessage, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SerializedInspectionMachine, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemLoadedMessage, SystemSelectActorMessage, ToastDismissMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VersionSaveRequestedMessage, ViewModeChangedMessage, ViewerOptions, VizMessage, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine, isSerializedInspectionMachine, mergeInspectorSettings, resolveInspectorSettings };
+import { $ as MachineVersionAutoSaveOptions, $t as ValidationIssue, A as ExportFormat, At as SetApiKeyMessage, B as InspectSnapshotMessage, Bt as SystemActorStoppedMessage, C as EmbedExample, Ct as RegisteredMessage, D as ErrorCode, Dt as SavedMessage, E as EmbedMode, Et as SaveMessage, F as HostUpdateOptions, Ft as SourceRange, G as InspectionTakenTransition, Gt as ToastDismissMessage, H as InspectionClientMetadata, Ht as SystemLoadedMessage, I as INSPECTION_PROTOCOL_VERSION, It as StateSourceLocation, J as LoadedMessage, Jt as UploadCapabilitiesMessage, K as InspectorLoadedEvent, Kt as ToastMessage, L as INSPECTION_ROOM_QUERY_PARAM, Lt as SystemActorEventMessage, M as ExtensionCallMessage, Mt as SetSettingsMessage, N as ExtensionResultMessage, Nt as SetThemeMessage, O as ErrorMessage, Ot as SerializedInspectionMachine, P as HighlightMessage, Pt as SourceLocation, Q as MachineSourceLocations, Qt as UploadResult, R as InitMessage, Rt as SystemActorRegisteredMessage, S as EmbedEventName, St as RegisterMessage, T as EmbedFormatManifest, Tt as RetrievedMessage, U as InspectionRoomUrls, Ut as SystemSelectActorMessage, V as InspectionAction, Vt as SystemInitMessage, W as InspectionSentEvent, Wt as SystemSendEventMessage, X as MachineInitOptions, Xt as UploadRequestMessage, Y as LoginMessage, Yt as UploadFileInfo, Z as MachinePayload, Zt as UploadResponseMessage, _ as EmbedChromeOptions, _t as ProjectWorkspaceOpenChangedMessage, a as CapabilityDeniedMessage, an as createInspectionActorId, at as ProjectInitOptions, b as EmbedEventHandler, bt as ReadOnlyReason, c as ClipboardReadMessage, cn as isEmbedExample, ct as ProjectSetWorkspaceOpenMessage, d as ClipboardWriteResponseMessage, dn as mergeInspectorSettings, dt as ProjectWorkspaceActionIcon, en as VersionSaveRequestedMessage, et as ModeChangedMessage, f as CommentsConfig, fn as resolveInspectorSettings, ft as ProjectWorkspaceActionMessage, g as EditorHandshakeMessage, gt as ProjectWorkspaceMachineOrigin, h as EditorCapabilities, hn as EmbedPanelPosition, ht as ProjectWorkspaceMachine, i as CapabilityDeniedEvent, in as assertEmbedExamples, it as ProjectInitMessage, j as ExportFormatMap, jt as SetModeMessage, k as ExportCallOptions, kt as SessionMessage, l as ClipboardReadResponseMessage, ln as isEmbedExampleMachine, lt as ProjectUpdateMessage, m as EMBED_DOCUMENT_LIMITS, mn as EmbedPanelConfig, mt as ProjectWorkspaceConfig, n as AuthenticationRecovery, nn as ViewerOptions, nt as PanelChangedMessage, o as ChangeMessage, on as createInspectionRoomUrls, ot as ProjectMachineSelectedMessage, p as EMBED_DOCUMENT_LANGUAGES, pt as ProjectWorkspaceCapabilities, q as InspectorSettings, qt as UpdateMessage, r as CapabilityDeniedCapability, rn as VizMessage, rt as ProjectEmbedMachine, s as ClientMessage, sn as getInspectionRoomId, st as ProjectSelectMachineMessage, t as ActorSystemEntry, tn as ViewModeChangedMessage, tt as PREFIX, u as ClipboardWriteMessage, un as isSerializedInspectionMachine, ut as ProjectWorkspaceAction, v as EmbedDocument, vt as ProjectWorkspaceProject, w as EmbedExtensionsManifest, wt as RetrieveMessage, x as EmbedEventMap, xt as ReadyMessage, y as EmbedDocumentLanguage, yt as ProtocolMessage, z as InitOptions, zt as SystemActorSnapshotMessage } from "./protocol-DkcbN7fu.mjs";
+export { ActorSystemEntry, AuthenticationRecovery, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, ClipboardReadMessage, ClipboardReadResponseMessage, ClipboardWriteMessage, ClipboardWriteResponseMessage, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EditorHandshakeMessage, EmbedChromeOptions, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExample, EmbedExtensionsManifest, EmbedFormatManifest, EmbedMode, EmbedPanelConfig, EmbedPanelPosition, ErrorCode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, ExtensionCallMessage, ExtensionResultMessage, HighlightMessage, HostUpdateOptions, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, InspectorLoadedEvent, InspectorSettings, LoadedMessage, LoginMessage, MachineInitOptions, MachinePayload, MachineSourceLocations, MachineVersionAutoSaveOptions, ModeChangedMessage, PREFIX, PanelChangedMessage, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SerializedInspectionMachine, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemLoadedMessage, SystemSelectActorMessage, SystemSendEventMessage, ToastDismissMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VersionSaveRequestedMessage, ViewModeChangedMessage, ViewerOptions, VizMessage, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine, isSerializedInspectionMachine, mergeInspectorSettings, resolveInspectorSettings };

package/dist/relay.d.mts

@@ -1,4 +1,4 @@
-import { yt as ProtocolMessage } from "./protocol-weYUfy3l.mjs";
+import { yt as ProtocolMessage } from "./protocol-DkcbN7fu.mjs";
 //#region src/relay.d.ts
 type InspectionRelayRole = 'producer' | 'viewer';
 interface InspectionRelayPeer {

package/dist/relay.mjs

@@ -20,6 +20,7 @@ const FORWARD_ONLY_MESSAGE_TYPES = new Set([
 	"@statelyai.loaded",
 	"@statelyai.system.loaded",
 	"@statelyai.capabilityDenied",
+	"@statelyai.system.sendEvent",
 	"@statelyai.register",
 	"@statelyai.registered"
 ]);
@@ -41,6 +42,7 @@ function validationError(message) {
 	if (!isSupportedMessageType(message.type)) return `Unsupported inspection message type ${String(message.type)}`;
 	const hasString = (key) => typeof message[key] === "string" && message[key] !== "";
 	switch (message.type) {
+		case "@statelyai.system.sendEvent": return hasString("producerId") && hasString("sessionId") && message.event && typeof message.event === "object" && typeof message.event.type === "string" ? null : "sendEvent requires producerId, sessionId, and an event";
 		case "@statelyai.setSettings": return message.settings && typeof message.settings === "object" && !Array.isArray(message.settings) ? null : "setSettings requires a settings object";
 		case "@statelyai.system.init": return message.protocolVersion === INSPECTION_PROTOCOL_VERSION && Array.isArray(message.actors) ? null : "system.init requires the current protocolVersion and actors array";
 		case "@statelyai.system.selectActor":

package/dist/{version-IE72VxaP.mjs → version-BRCbR47D.mjs}

@@ -379,7 +379,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.38.1";
+const SDK_VERSION = "0.38.2";
 function inspectionRuntime() {
 	if (typeof window !== "undefined") return "browser";
 	if (typeof process !== "undefined" && process.versions?.node) return "node";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.38.1",
+  "version": "0.38.2",
   "license": "MIT",
   "bin": {
     "stately-sdk": "./dist/bin.mjs"
@@ -21,6 +21,10 @@
       "types": "./dist/embed.d.mts",
       "import": "./dist/embed.mjs"
     },
+    "./preview": {
+      "types": "./dist/preview.d.mts",
+      "import": "./dist/preview.mjs"
+    },
     "./inspect": {
       "types": "./dist/inspect.d.mts",
       "import": "./dist/inspect.mjs"
@@ -92,8 +96,8 @@
     "ws": "^8.19.0",
     "xstate": "^5.0.0",
     "xstate-v6": "npm:xstate@6.0.0-alpha.65",
-    "@statelyai/api-contract": "0.6.2",
-    "@statelyai/graph-tools": "0.9.6"
+    "@statelyai/api-contract": "0.6.3",
+    "@statelyai/graph-tools": "0.9.7"
   },
   "peerDependencies": {
     "ws": "^8.19.0"