@statelyai/sdk 0.17.0 → 0.20.0

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
 import { EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InspectionAction, InspectionSentEvent, InspectionTakenTransition } from "./protocol.mjs";
-import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, i as InspectedSnapshot, l as ManualActorOptions, n as CreateInspectorOptions, o as Inspector, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-BZFzyeew.mjs";
+import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, i as InspectedSnapshot, l as ManualActorOptions, n as CreateInspectorOptions, o as Inspector, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-CGJR4iZK.mjs";
 export { AdoptedActor, CreateInspectorOptions, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InspectedEvent, InspectedSnapshot, InspectedTransition, InspectionAction, InspectionSentEvent, InspectionTakenTransition, Inspector, InspectorEvents, InspectorInspectionEvent, ManualActorOptions, Transport, createInspector, createStatelyInspector };

package/dist/inspect.mjs

@@ -1,3 +1,4 @@
-import { n as createStatelyInspector, t as createInspector } from "./inspect-CF_6aEnv.mjs";
+import "./version-TY9EZF0F.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-CWwLGwLq.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/patchTypes.d.mts

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

package/dist/protocol.d.mts

@@ -1,12 +1,13 @@
-import { i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
+import { i as StatelyGraph } from "./graph-DxeqWHC3.mjs";
+import { c as EditorSyncSourceLocation, f as MachineSourceLocations$1, l as EditorSyncSourceRange, t as EditorCapabilities$1, u as EditorSyncStateSourceLocation } from "./editor-sync-types-D8_EZm0A.mjs";
 
 //#region src/protocol.d.ts
 /** Query parameter carrying the unguessable inspection room capability. */
 declare const INSPECTION_ROOM_QUERY_PARAM = "r";
 /**
  * Create the room-global identity for one producer-local actor session.
- * XState session ids are process-local; the producer id supplies the missing
- * cross-process namespace.
+ * Runtime and producer-resolved session ids may use different uniqueness
+ * domains; the producer id supplies a stable room namespace.
  */
 declare function createInspectionActorId(producerId: string, sessionId: string): string;
 interface InspectionRoomUrls {
@@ -35,23 +36,28 @@ interface ProjectEmbedMachine {
   name?: string;
   machine: unknown;
 }
+declare const EMBED_DOCUMENT_LANGUAGES: readonly ["markdown", "typescript", "javascript", "json", "xml", "mermaid", "text"];
+type EmbedDocumentLanguage = (typeof EMBED_DOCUMENT_LANGUAGES)[number];
+declare const EMBED_DOCUMENT_LIMITS: {
+  readonly maxDocuments: 100;
+  readonly maxDocumentLength: number;
+  readonly maxTotalLength: number;
+};
+/** Read-only text supplied by an embed host for display beside a machine. */
+interface EmbedDocument {
+  /** Relative POSIX path used as the document's stable identity. */
+  path: string;
+  content: string;
+  /** Overrides renderer detection from the path's file extension. */
+  language?: EmbedDocumentLanguage;
+}
 interface ValidationIssue {
   nodeIds: string[];
   edgeIds: string[];
   level: 'info' | 'warning' | 'error';
   message: string;
 }
-interface EditorCapabilities {
-  edit?: boolean;
-  export?: boolean;
-  ai?: boolean;
-  simulate?: boolean;
-  inspect?: boolean;
-  navigateHierarchy?: boolean;
-  maxDepth?: number;
-  panels?: string[];
-  commands?: string[];
-}
+type EditorCapabilities = EditorCapabilities$1;
 type ReadOnlyReason = 'free-plan' | 'access-unverified';
 type CapabilityDeniedCapability = 'edit' | 'export' | 'ai' | 'simulate' | 'inspect' | 'navigateHierarchy' | 'panel' | 'mode';
 interface CapabilityDeniedEvent {
@@ -61,39 +67,10 @@ interface CapabilityDeniedEvent {
   message: string;
   dedupeKey: string;
 }
-interface SourceRange {
-  startLine: number;
-  startChar: number;
-  endLine: number;
-  endChar: number;
-}
-interface SourceLocation {
-  uri: string;
-  range: SourceRange;
-}
-interface StateSourceLocation extends SourceLocation {
-  path: string[];
-  kind: 'inline' | 'objectReference' | 'createStateConfig';
-  symbol?: string;
-  keyRange?: SourceRange;
-  referenceRange?: SourceRange;
-  keySource?: {
-    kind: 'const' | 'enumMember' | 'computedLiteral';
-    symbol?: string;
-    valueRange?: SourceRange;
-    machineLocal?: boolean;
-  };
-  keyReplacementText?: string;
-}
-interface MachineSourceLocations {
-  version: 1;
-  root?: SourceLocation;
-  statesObject?: StateSourceLocation;
-  states: StateSourceLocation[];
-  staticValues?: Array<SourceLocation & {
-    value: string;
-  }>;
-}
+type SourceRange = EditorSyncSourceRange;
+type SourceLocation = EditorSyncSourceLocation;
+type StateSourceLocation = EditorSyncStateSourceLocation;
+type MachineSourceLocations = MachineSourceLocations$1;
 interface ExportFormatMap {
   xstate: {
     options: {
@@ -198,6 +175,8 @@ type EmbedEventName = keyof EmbedEventMap;
 type EmbedEventHandler<K extends EmbedEventName> = (data: EmbedEventMap[K]) => void;
 interface MachineInitOptions {
   machine: unknown;
+  /** Ephemeral, read-only reference documents owned by the embed host. */
+  documents?: EmbedDocument[];
   format?: string;
   mode?: EmbedMode;
   theme?: 'light' | 'dark';
@@ -232,6 +211,8 @@ interface MachineInitOptions {
 }
 interface ProjectInitOptions {
   machines: ProjectEmbedMachine[];
+  /** Ephemeral, read-only reference documents shared across the project. */
+  documents?: EmbedDocument[];
   currentMachineId?: string;
   mode?: EmbedMode;
   theme?: 'light' | 'dark';
@@ -254,6 +235,7 @@ type InitOptions = MachineInitOptions | ProjectInitOptions;
 interface InitMessage {
   type: '@statelyai.init';
   machine: unknown;
+  documents?: EmbedDocument[];
   format?: string;
   mode?: EmbedMode;
   theme?: 'light' | 'dark';
@@ -277,9 +259,33 @@ interface SetApiKeyMessage {
   type: '@statelyai.setApiKey';
   apiKey: string;
 }
+interface SavedMessage {
+  type: '@statelyai.saved';
+  graph: unknown;
+}
+interface ClipboardReadResponseMessage {
+  type: '@statelyai.clipboardReadResponse';
+  requestId: string;
+  text: string;
+}
+interface ClipboardWriteResponseMessage {
+  type: '@statelyai.clipboardWriteResponse';
+  requestId: string;
+  ok: boolean;
+}
+interface ClipboardReadMessage {
+  type: '@statelyai.clipboardRead';
+  requestId: string;
+}
+interface ClipboardWriteMessage {
+  type: '@statelyai.clipboardWrite';
+  requestId: string;
+  text: string;
+}
 interface ProjectInitMessage {
   type: '@statelyai.project.init';
   machines: ProjectEmbedMachine[];
+  documents?: EmbedDocument[];
   currentMachineId?: string;
   mode?: EmbedMode;
   theme?: 'light' | 'dark';
@@ -384,6 +390,7 @@ interface SystemInitMessage {
   actors: ActorSystemEntry[];
   /** Actor session id the viz should focus first. Defaults to the root. */
   selectedSessionId?: string;
+  documents?: EmbedDocument[];
   mode?: EmbedMode;
   theme?: 'light' | 'dark';
   readOnly?: boolean;
@@ -441,6 +448,15 @@ interface SystemActorStoppedMessage {
 interface ReadyMessage {
   type: '@statelyai.ready';
   version: string;
+  protocolVersion?: number;
+}
+interface EditorHandshakeMessage {
+  type: '@statelyai.handshake';
+  protocolVersion: number;
+  client?: {
+    name: string;
+    version: string;
+  };
 }
 interface LoadedMessage {
   type: '@statelyai.loaded';
@@ -524,9 +540,9 @@ interface UploadResponseMessage {
   result: UploadResult;
 }
 /** All messages a client (embed/inspector) can send to the viz. */
-type ClientMessage = InitMessage | SetApiKeyMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemSelectActorMessage | SystemActorRegisteredMessage | SystemActorEventMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ErrorMessage;
+type ClientMessage = InitMessage | SetApiKeyMessage | EditorHandshakeMessage | SavedMessage | ClipboardReadResponseMessage | ClipboardWriteResponseMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemSelectActorMessage | SystemActorRegisteredMessage | SystemActorEventMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ErrorMessage;
 /** All messages the viz can send back to a client. */
-type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | UploadRequestMessage;
+type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | ClipboardReadMessage | ClipboardWriteMessage | UploadRequestMessage;
 interface InspectionClientMetadata {
   name?: string;
   machineId?: string;
@@ -555,4 +571,4 @@ declare const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
 declare const INSPECTION_PROTOCOL_VERSION = 2;
 //#endregion
-export { ActorSystemEntry, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId };
+export { ActorSystemEntry, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, ClipboardReadMessage, ClipboardReadResponseMessage, ClipboardWriteMessage, ClipboardWriteResponseMessage, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EditorHandshakeMessage, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId };

package/dist/protocol.mjs

@@ -3,8 +3,8 @@
 const INSPECTION_ROOM_QUERY_PARAM = "r";
 /**
 * Create the room-global identity for one producer-local actor session.
-* XState session ids are process-local; the producer id supplies the missing
-* cross-process namespace.
+* Runtime and producer-resolved session ids may use different uniqueness
+* domains; the producer id supplies a stable room namespace.
 */
 function createInspectionActorId(producerId, sessionId) {
 	return `${encodeURIComponent(producerId)}:${encodeURIComponent(sessionId)}`;
@@ -38,9 +38,23 @@ function createInspectionRoomUrls(options) {
 function getInspectionRoomId(value) {
 	return new URL(value).searchParams.get(INSPECTION_ROOM_QUERY_PARAM)?.trim() || null;
 }
+const EMBED_DOCUMENT_LANGUAGES = [
+	"markdown",
+	"typescript",
+	"javascript",
+	"json",
+	"xml",
+	"mermaid",
+	"text"
+];
+const EMBED_DOCUMENT_LIMITS = {
+	maxDocuments: 100,
+	maxDocumentLength: 512 * 1024,
+	maxTotalLength: 2 * 1024 * 1024
+};
 const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
 const INSPECTION_PROTOCOL_VERSION = 2;
 
 //#endregion
-export { INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, PREFIX, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId };
+export { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, PREFIX, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId };

package/dist/{studio-txdyJHD7.mjs → schemas-C2raUv-n.mjs}

@@ -1,5 +1,3 @@
-import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
-
 //#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
 var _a$1;
 function $constructor(name, initializer, params) {
@@ -4329,397 +4327,4 @@ const describe = describe$1;
 const meta = meta$1;
 
 //#endregion
-//#region ../api-contract/dist/errors.mjs
-/**
-* Error shape returned by every `/api/v1` machine operation (and by the shared
-* auth guard). Each operation registers its own error schema component in the
-* OpenAPI document, so this is a factory rather than a single shared instance.
-*/
-function createApiErrorResponseSchema() {
-	return object({
-		error: string(),
-		issues: array(unknown()).optional()
-	});
-}
-const apiErrorResponseSchema = createApiErrorResponseSchema();
-/**
-* Canonical error codes for the `/api/v1` resource operations. Machine
-* operations keep the flat `{ error: string }` shape above unchanged; the
-* nested envelope below applies to resource operations only.
-*/
-const resourceErrorCodeSchema = _enum([
-	"bad_request",
-	"unauthenticated",
-	"forbidden",
-	"not_found",
-	"conflict",
-	"payload_too_large",
-	"rate_limited",
-	"capability_disabled",
-	"upstream_error",
-	"internal_error"
-]);
-/** Factory, matching `createApiErrorResponseSchema`, for per-route OpenAPI components. */
-function createResourceApiErrorResponseSchema() {
-	return object({ error: object({
-		code: resourceErrorCodeSchema,
-		message: string(),
-		issues: array(unknown()).optional(),
-		retryable: boolean().optional()
-	}) });
-}
-const resourceApiErrorResponseSchema = createResourceApiErrorResponseSchema();
-
-//#endregion
-//#region ../api-contract/dist/resources.mjs
-/**
-* Canonical schemas for persistent `/api/v1` resources plus the owned,
-* deterministic code-extraction operation.
-*
-* These models are canonical, not upstream-shaped: providers (e.g. the Stately
-* Registry adapter) are responsible for translating upstream envelopes,
-* identifier quirks and casing into these shapes. No `{ data }` envelope
-* appears anywhere; all timestamps are ISO strings.
-*/
-/**
-* XState major versions the editor targets (see
-* `packages/editor/src/formats/xstate.ts`).
-*/
-const xstateVersionSchema = union([literal(5), literal(6)]);
-const projectVisibilitySchema = _enum([
-	"public",
-	"unlisted",
-	"private"
-]);
-const verifyResultSchema = object({
-	valid: literal(true),
-	tokenScope: _enum(["user", "project"])
-});
-const projectSummarySchema = object({
-	projectId: string(),
-	projectVersionId: string(),
-	name: string(),
-	description: string().nullable(),
-	visibility: projectVisibilitySchema,
-	createdAt: string(),
-	updatedAt: string()
-});
-const projectSchema = projectSummarySchema.extend({
-	rootMachineId: string().nullable(),
-	machines: array(object({ machineId: string() }))
-});
-/**
-* `name` is optional: the Registry project envelope only returns machine ids.
-* Providers that can supply names cheaply should.
-*/
-const projectMachineSummarySchema = object({
-	machineId: string(),
-	name: string().optional()
-});
-const machineSchema = object({
-	machineId: string(),
-	name: string(),
-	projectId: string().optional(),
-	projectVersionId: string(),
-	definition: unknown(),
-	createdAt: string().optional(),
-	updatedAt: string().optional()
-});
-const machineVersionSchema = object({
-	machineVersionId: string(),
-	machineId: string(),
-	versionNumber: number(),
-	name: string(),
-	definition: unknown(),
-	createdAt: string(),
-	updatedAt: string()
-});
-const extractedMachinesSchema = object({ machines: array(object({ config: record(string(), unknown()) })) });
-const projectsCreateRequestSchema = object({
-	name: string().min(1),
-	visibility: projectVisibilitySchema
-});
-const projectsUpdateRequestSchema = object({
-	name: string().min(1).optional(),
-	description: string().nullable().optional(),
-	visibility: projectVisibilitySchema.optional()
-}).refine((value) => value.name !== void 0 || value.description !== void 0 || value.visibility !== void 0, { message: "At least one of `name`, `description` or `visibility` is required." });
-const machinesCreateRequestSchema = object({
-	projectVersionId: string().min(1),
-	xstateVersion: xstateVersionSchema,
-	name: string().min(1).optional(),
-	definition: unknown().optional()
-});
-const machinesUpdateRequestSchema = object({
-	name: string().min(1).optional(),
-	definition: unknown().optional()
-}).refine((value) => value.name !== void 0 || value.definition !== void 0, { message: "At least one of `name` or `definition` is required." });
-const codeExtractMachinesRequestSchema = object({
-	code: string().min(1),
-	xstateVersion: xstateVersionSchema.optional()
-});
-const authVerifyResponseSchema = verifyResultSchema;
-const projectsListResponseSchema = array(projectSummarySchema);
-const projectsGetResponseSchema = projectSchema;
-const projectsCreateResponseSchema = projectSchema;
-const projectsUpdateResponseSchema = projectSchema;
-const projectsDeleteResponseSchema = object({ projectId: string() });
-const projectsListMachinesResponseSchema = array(projectMachineSummarySchema);
-const machinesCreateResponseSchema = machineSchema;
-const machinesGetResponseSchema = machineSchema;
-const machinesUpdateResponseSchema = machineSchema;
-const machinesGetVersionResponseSchema = machineVersionSchema;
-const codeExtractMachinesResponseSchema = extractedMachinesSchema;
-/**
-* Request/response schema pairs keyed by resource capability name. Kept here
-* rather than on the `Capability` metadata entries so that the capability
-* registry stays plain, serialisable data.
-*/
-const resourceOperationSchemas = {
-	"auth.verify": { response: authVerifyResponseSchema },
-	"projects.list": { response: projectsListResponseSchema },
-	"projects.create": {
-		request: projectsCreateRequestSchema,
-		response: projectsCreateResponseSchema
-	},
-	"projects.get": { response: projectsGetResponseSchema },
-	"projects.update": {
-		request: projectsUpdateRequestSchema,
-		response: projectsUpdateResponseSchema
-	},
-	"projects.delete": { response: projectsDeleteResponseSchema },
-	"projects.listMachines": { response: projectsListMachinesResponseSchema },
-	"machines.create": {
-		request: machinesCreateRequestSchema,
-		response: machinesCreateResponseSchema
-	},
-	"machines.get": { response: machinesGetResponseSchema },
-	"machines.getVersion": { response: machinesGetVersionResponseSchema },
-	"machines.update": {
-		request: machinesUpdateRequestSchema,
-		response: machinesUpdateResponseSchema
-	}
-};
-/** Provider-independent operations implemented by this repository. */
-const codeOperationSchemas = { "code.extractMachines": {
-	request: codeExtractMachinesRequestSchema,
-	response: codeExtractMachinesResponseSchema
-} };
-/** Every owned API operation with a canonical request/response contract. */
-const operationSchemas = {
-	...resourceOperationSchemas,
-	...codeOperationSchemas
-};
-
-//#endregion
-//#region src/studio.ts
-/**
-* Remote client for the owned Stately resource contract (`/api/v1/*`).
-*
-* Every method targets our own routes (never the legacy Registry API), sends
-* JSON bodies with a bearer credential, and validates responses against the
-* canonical Zod schemas from `@statelyai/api-contract`. Responses are canonical
-* values directly: there is no `{ data }` envelope. Errors use the nested
-* envelope `{ error: { code, message, issues?, retryable? } }`.
-*/
-/** Default base URL of the editor/API deployment hosting `/api/v1`. */
-const DEFAULT_STATELY_BASE_URL = "https://editor.stately.ai";
-var StudioApiError = class extends Error {
-	status;
-	/** Canonical resource error code, when the server sent one. */
-	code;
-	issues;
-	retryable;
-	constructor(message, status, options = {}) {
-		super(message);
-		this.name = "StudioApiError";
-		this.status = status;
-		this.code = options.code;
-		this.issues = options.issues;
-		this.retryable = options.retryable;
-	}
-};
-function getFetch(fetchImpl) {
-	const resolvedFetch = fetchImpl ?? globalThis.fetch;
-	if (!resolvedFetch) throw new Error("No fetch implementation available. Pass one via createStatelyClient({ fetch }).");
-	return resolvedFetch;
-}
-function joinApiUrl(baseUrl, path) {
-	return `${baseUrl.replace(/\/+$/, "")}/api/v1${path}`;
-}
-async function parseJson(response) {
-	if (!response.headers.get("content-type")?.includes("application/json")) return null;
-	return response.json().catch(() => null);
-}
-function toApiError(data, status) {
-	const parsed = resourceApiErrorResponseSchema.safeParse(data);
-	if (parsed.success) {
-		const { code, message, issues, retryable } = parsed.data.error;
-		return new StudioApiError(message, status, {
-			code,
-			issues,
-			retryable
-		});
-	}
-	if (typeof data === "object" && data !== null && "error" in data && typeof data.error === "string") return new StudioApiError(data.error, status);
-	return new StudioApiError(`HTTP ${status}`, status);
-}
-function normalizeVisibility(visibility) {
-	return visibility.toLowerCase();
-}
-function normalizeXStateVersion(xstateVersion) {
-	return xstateVersion === void 0 || xstateVersion === 4 ? 5 : xstateVersion;
-}
-function normalizeExtractXStateVersion(xstateVersion) {
-	return xstateVersion === 4 ? 5 : xstateVersion;
-}
-function withMachineAlias(machine) {
-	return {
-		...machine,
-		definition: machine.definition,
-		id: machine.machineId
-	};
-}
-function withProjectAlias(project) {
-	return {
-		...project,
-		id: project.projectVersionId
-	};
-}
-function isCredentialLike(value) {
-	if (typeof value === "string") return true;
-	return typeof value === "object" && value !== null && "type" in value && (value.type === "api_key" || value.type === "oauth");
-}
-function createStatelyClient(options = {}) {
-	const baseUrl = options.baseUrl ?? DEFAULT_STATELY_BASE_URL;
-	const fetchImpl = getFetch(options.fetch);
-	const defaultCredential = options.credential ?? (options.apiKey ? {
-		type: "api_key",
-		token: options.apiKey
-	} : void 0);
-	const defaultAuthMode = options.authMode ?? "auto";
-	async function request(path, init, schema, requestOptions = {}) {
-		const headers = new Headers(init.headers);
-		const authMode = requestOptions.authMode ?? defaultAuthMode;
-		const credential = requestOptions.credential ?? defaultCredential;
-		if (authMode !== "none") {
-			const token = getCredentialToken(credential);
-			if (authMode === "bearer" && (!token || !credential)) throw new StudioApiError("No Stately credential configured. Pass createStatelyClient({ credential }) or use authMode: \"auto\" to let the server decide whether authentication is required.", 401, { code: "unauthenticated" });
-			if (token && credential) headers.set("Authorization", createAuthorizationHeader(credential));
-		}
-		const response = await fetchImpl(joinApiUrl(baseUrl, path), {
-			...init,
-			headers,
-			...requestOptions.signal ? { signal: requestOptions.signal } : {}
-		});
-		const data = await parseJson(response);
-		if (!response.ok) throw toApiError(data, response.status);
-		const parsed = schema.safeParse(data);
-		if (!parsed.success) throw new StudioApiError(`Unexpected response for ${path}: ${parsed.error.message}`, response.status, {
-			code: "internal_error",
-			issues: [...parsed.error.issues]
-		});
-		return parsed.data;
-	}
-	function jsonInit(method, body) {
-		return {
-			method,
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(body)
-		};
-	}
-	const projects = {
-		list(requestOptions) {
-			return request("/projects", { method: "GET" }, projectsListResponseSchema, requestOptions);
-		},
-		create(input, requestOptions) {
-			return request("/projects", jsonInit("POST", {
-				name: input.name,
-				visibility: normalizeVisibility(input.visibility)
-			}), projectSchema, requestOptions).then(withProjectAlias);
-		},
-		get(projectId, requestOptions) {
-			return request(`/projects/${encodeURIComponent(projectId)}`, { method: "GET" }, projectSchema, requestOptions).then(withProjectAlias);
-		},
-		update(projectId, input, requestOptions) {
-			return request(`/projects/${encodeURIComponent(projectId)}`, jsonInit("PATCH", {
-				...input.name !== void 0 ? { name: input.name } : {},
-				...input.description !== void 0 ? { description: input.description } : {},
-				...input.visibility !== void 0 ? { visibility: normalizeVisibility(input.visibility) } : {}
-			}), projectSchema, requestOptions).then(withProjectAlias);
-		},
-		delete(projectId, requestOptions) {
-			return request(`/projects/${encodeURIComponent(projectId)}`, { method: "DELETE" }, projectsDeleteResponseSchema, requestOptions);
-		},
-		listMachines(projectId, requestOptions) {
-			return request(`/projects/${encodeURIComponent(projectId)}/machines`, { method: "GET" }, projectsListMachinesResponseSchema, requestOptions);
-		},
-		async ensure(input, requestOptions) {
-			if (input.matchConnectedRepo !== false) {
-				const match = (await projects.list(requestOptions)).find((candidate) => candidate.name === input.name);
-				if (match) return projects.get(match.projectId, requestOptions);
-			}
-			return projects.create(input, requestOptions);
-		}
-	};
-	const machines = {
-		create(input, requestOptions) {
-			return request("/machines", jsonInit("POST", {
-				projectVersionId: input.projectVersionId,
-				xstateVersion: normalizeXStateVersion(input.xstateVersion),
-				...input.name !== void 0 ? { name: input.name } : {},
-				...input.definition !== void 0 ? { definition: input.definition } : {}
-			}), machineSchema, requestOptions).then((machine) => withMachineAlias(machine));
-		},
-		async createMany(input, requestOptions) {
-			return [await machines.create(input, requestOptions)];
-		},
-		get(machineId, getOptions = {}) {
-			return request(`/machines/${encodeURIComponent(machineId)}`, { method: "GET" }, machineSchema, getOptions).then((machine) => withMachineAlias(machine));
-		},
-		getVersion(machineId, versionId, requestOptions) {
-			return request(`/machines/${encodeURIComponent(machineId)}/versions/${encodeURIComponent(versionId)}`, { method: "GET" }, machineVersionSchema, requestOptions);
-		},
-		update(machineIdOrInput, inputOrOptions, maybeOptions) {
-			const machineId = typeof machineIdOrInput === "string" ? machineIdOrInput : machineIdOrInput.machineId ?? machineIdOrInput.id;
-			if (!machineId) throw new StudioApiError("machines.update requires a machine id.", 400, { code: "bad_request" });
-			const input = (typeof machineIdOrInput === "string" ? inputOrOptions : machineIdOrInput) ?? {};
-			const requestOptions = typeof machineIdOrInput === "string" ? maybeOptions : inputOrOptions;
-			return request(`/machines/${encodeURIComponent(machineId)}`, jsonInit("PATCH", {
-				...input.name !== void 0 ? { name: input.name } : {},
-				...input.definition !== void 0 ? { definition: input.definition } : {}
-			}), machineSchema, requestOptions).then((machine) => withMachineAlias(machine));
-		}
-	};
-	return {
-		auth: { verify(credentialOrOptions, verifyOptions) {
-			return request("/auth/verify", { method: "GET" }, verifyResultSchema, isCredentialLike(credentialOrOptions) ? {
-				...verifyOptions,
-				credential: credentialOrOptions
-			} : credentialOrOptions ?? verifyOptions ?? {});
-		} },
-		projects,
-		machines,
-		code: { extractMachines(codeOrInput, extractOptions = {}) {
-			const input = typeof codeOrInput === "string" ? {
-				code: codeOrInput,
-				xstateVersion: extractOptions.xstateVersion
-			} : codeOrInput;
-			const legacyOptions = extractOptions;
-			const credential = legacyOptions.credential ?? (legacyOptions.apiKey ? {
-				type: "api_key",
-				token: legacyOptions.apiKey
-			} : void 0);
-			return request("/code/extract-machines", jsonInit("POST", {
-				code: input.code,
-				xstateVersion: normalizeExtractXStateVersion(input.xstateVersion)
-			}), extractedMachinesSchema, {
-				...extractOptions,
-				credential
-			});
-		} }
-	};
-}
-
-//#endregion
-export { array as a, literal as c, record as d, string as f, _enum as i, number as l, unknown as m, StudioApiError as n, boolean as o, union as p, createStatelyClient as r, discriminatedUnion as s, DEFAULT_STATELY_BASE_URL as t, object as u };
+export { literal as a, record as c, unknown as d, discriminatedUnion as i, string as l, array as n, number as o, boolean as r, object as s, _enum as t, union as u };

package/dist/{statelyPragma-Th0gdXfx.mjs → statelyPragma-GN-bfuC_.mjs}

@@ -1,5 +1,6 @@
-import { a as array, c as literal, d as record, f as string, i as _enum, l as number, m as unknown, o as boolean, p as union, s as discriminatedUnion, u as object } from "./studio-txdyJHD7.mjs";
+import { a as literal, c as record, d as unknown, i as discriminatedUnion, l as string, n as array, o as number, r as boolean, s as object, t as _enum, u as union } from "./schemas-C2raUv-n.mjs";
 import ts from "typescript";
+import "xstate";
 import "xstate/graph";
 
 //#region ../../node_modules/.pnpm/js-yaml@4.2.0/node_modules/js-yaml/dist/js-yaml.mjs