@statelyai/sdk 0.29.1 → 0.31.0

package/README.md

@@ -62,6 +62,8 @@ and validator implementations remain in the host and are called asynchronously.
 RPC methods and payloads are validated before host code runs, and malformed
 graphs returned by custom importers are rejected.
 Use `defaultProfile` and `defaultFormat` to choose the initial custom pair.
+Profile namespaced-data adaptation and migration hooks are in-process React
+editor extensions and are intentionally omitted from iframe manifests.
 
 The Get started launchpad is host-configurable. Pass serializable `examples` to
 `embed.init()` (or the project equivalent) to show the Examples section; omit
@@ -325,8 +327,12 @@ npx statelyai push
 npx statelyai pull
 npx statelyai diff ./checkout.machine.ts machine-id
 npx statelyai open ./checkout.machine.ts
+npx statelyai open
 ```
 
+`open <file>` shows every machine in that file in one collapsed workspace;
+`open` discovers machines across the current worktree.
+
 `statelyai diff` ignores entity IDs and presentation-only layout or color
 fields, so `--fail-on-changes` can gate CI on machine semantics.
 

package/dist/assetStorage.d.mts

@@ -1,4 +1,4 @@
-import { UploadResult } from "./protocol.mjs";
+import { Bt as UploadResult } from "./protocol-DOt1Vz-5.mjs";
 
 //#region src/assetStorage.d.ts
 interface AssetUploadContext {

package/dist/auth.d.mts

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

package/dist/{statelyPragma-p1vu8PmH.mjs → dist-BQEaIgBI.mjs}

@@ -1,5 +1,6 @@
 import { a as discriminatedUnion, c as object, d as union, f as unknown, i as custom, l as record, n as array, o as literal, r as boolean, s as number, t as _enum, u as string } from "./openapi-BTDjYWXd.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
@@ -3166,6 +3167,10 @@ function graphChangeToPatchesResult(prevGraph, nextGraph) {
 		op: "deleteTransition",
 		transitionId: edge.id
 	});
+	if (prevGraph.data.profile !== nextGraph.data.profile) patches.push({
+		op: "setProfile",
+		profile: nextGraph.data.profile ?? "xstate-v5"
+	});
 	if (!isEqual(prevGraph.data.context, nextGraph.data.context)) patches.push({
 		op: "setContext",
 		context: nextGraph.data.context ?? null
@@ -3272,6 +3277,30 @@ function alignCompareGraphIds(base, compare, semanticBase, semanticCompare) {
 	}
 	return aligned;
 }
+const XSTATE_V5_PROFILE = "@statelyai/xstate@5.30.0";
+const XSTATE_V6_PROFILE = "@statelyai/xstate@6.0.0-alpha.51";
+const LEGACY_MACHINE_PROFILES = ["xstate-v5", "xstate-v6-alpha"];
+function normalizeMachineProfile(profile) {
+	return profile === "xstate-v5" ? XSTATE_V5_PROFILE : profile === "xstate-v6-alpha" ? XSTATE_V6_PROFILE : profile;
+}
+function isXStateV6Profile(profile) {
+	return (profile === "xstate-v5" || profile === "xstate-v6-alpha" ? normalizeMachineProfile(profile) : profile ?? XSTATE_V5_PROFILE).startsWith("@statelyai/xstate@6.");
+}
+const EXACT_SEMVER$1 = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+function parseProfileSpecifier(specifier) {
+	const separator = specifier.lastIndexOf("@");
+	const name = specifier.slice(0, separator);
+	const version = specifier.slice(separator + 1);
+	if (separator <= 0 || !/^@[^/]+\/[^@/]+$/.test(name) || !version) throw new Error(`Invalid profile specifier: ${specifier}`);
+	return {
+		name,
+		version,
+		kind: EXACT_SEMVER$1.test(version) ? "exact" : "range"
+	};
+}
+function normalizeProfileRef(profile) {
+	return profile === "xstate-v5" || profile === "xstate-v6-alpha" ? normalizeMachineProfile(profile) : profile;
+}
 function isAutoGeneratedId(id) {
 	return !!id && id.startsWith("$auto-");
 }
@@ -3387,15 +3416,6 @@ function stripExportDefault(code) {
 	if (trimmed.startsWith("export default ")) return trimmed.slice(15).replace(/;$/, "");
 	return trimmed;
 }
-const XSTATE_V5_PROFILE = "@statelyai/xstate@5.30.0";
-const XSTATE_V6_PROFILE = "@statelyai/xstate@6.0.0-alpha.51";
-const LEGACY_MACHINE_PROFILES = ["xstate-v5", "xstate-v6-alpha"];
-function normalizeMachineProfile(profile) {
-	return profile === "xstate-v5" ? XSTATE_V5_PROFILE : profile === "xstate-v6-alpha" ? XSTATE_V6_PROFILE : profile;
-}
-function isXStateV6Profile(profile) {
-	return (profile === "xstate-v5" || profile === "xstate-v6-alpha" ? normalizeMachineProfile(profile) : profile ?? XSTATE_V5_PROFILE).startsWith("@statelyai/xstate@6.");
-}
 /**
 * Graph-native transition references. Transitions point at invoke/action/state
 * blocks by graph id (`@statelyai.*`); the literal `xstate.*` event is produced
@@ -3989,25 +4009,79 @@ const INLINE_EXPRESSION_DIRECTIVE_FIELDS = [
 	"initialInput",
 	"route"
 ];
-const EXACT_SEMVER$1 = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-function parseProfileSpecifier(specifier) {
-	const separator = specifier.lastIndexOf("@");
-	const name = specifier.slice(0, separator);
-	const version = specifier.slice(separator + 1);
-	if (separator <= 0 || !/^@[^/]+\/[^@/]+$/.test(name) || !version) throw new Error(`Invalid profile specifier: ${specifier}`);
-	return {
-		name,
-		version,
-		kind: EXACT_SEMVER$1.test(version) ? "exact" : "range"
-	};
-}
-function normalizeProfileRef(profile) {
-	return profile === "xstate-v5" || profile === "xstate-v6-alpha" ? normalizeMachineProfile(profile) : profile;
-}
+function analyzeXStateV5Compatibility(graph) {
+	const issues = [];
+	const graphPaths = [
+		["data.version", graph.data.version],
+		["data.options", graph.data.options],
+		["data.schemas.input", graph.data.schemas?.input],
+		["data.schemas.output", graph.data.schemas?.output]
+	].filter(([, value]) => value != null);
+	if (graphPaths.length) issues.push({
+		level: "warning",
+		message: "XState v6 machine fields are retained but read-only in XState v5.",
+		readOnlyPaths: graphPaths.map(([path]) => path)
+	});
+	for (const node of graph.nodes) {
+		const paths = [
+			["data.initialInput", node.data.initialInput],
+			["data.timeout", node.data.timeout],
+			["data.route", node.data.route],
+			["data.schemas", node.data.schemas]
+		].filter(([, value]) => value != null);
+		if (paths.length) issues.push({
+			level: "warning",
+			message: `XState v6 fields on ${node.data.key ?? node.id} are retained but read-only in XState v5.`,
+			nodeIds: [node.id],
+			readOnlyPaths: paths.map(([path]) => `nodes.${node.id}.${path}`)
+		});
+	}
+	for (const edge of graph.edges) {
+		const paths = [["data.matches", edge.data.matches], ["data.input", edge.data.input]].filter(([, value]) => value != null);
+		if (paths.length) issues.push({
+			level: "warning",
+			message: "XState v6 transition fields are retained but read-only in XState v5.",
+			edgeIds: [edge.id],
+			readOnlyPaths: paths.map(([path]) => `edges.${edge.id}.${path}`)
+		});
+	}
+	return issues;
+}
+const XSTATE_V5_PROJECTION = {
+	readOnlyPaths: [
+		"data.version",
+		"data.options",
+		"data.schemas.input",
+		"data.schemas.output",
+		"nodes.*.data.initialInput",
+		"nodes.*.data.timeout",
+		"nodes.*.data.route",
+		"nodes.*.data.schemas",
+		"edges.*.data.matches",
+		"edges.*.data.input"
+	],
+	analyzeCompatibility: analyzeXStateV5Compatibility
+};
+const XSTATE_V6_PROJECTION = {};
+/**
+* Derive LangGraph authoring kinds into its namespace. Canonical fields and
+* graph topology are never returned, so the adapter cannot rewrite them.
+*/
+const LANGGRAPH_PROJECTION = { adapt: (graph) => ({ data: {
+	nodes: Object.fromEntries(graph.nodes.map((node) => [node.id, { kind: node.data.type === "final" ? "end" : node.data.kind === "agent" || node.data.kind === "task" || node.data.kind === "entrypoint" ? node.data.kind : "node" }])),
+	edges: Object.fromEntries(graph.edges.map((edge) => {
+		const source = graph.nodes.find((node) => node.id === edge.sourceId);
+		return [edge.id, { kind: edge.data.kind === "call" ? "call" : edge.data.kind === "conditional" || edge.data.guard != null || source?.data.type === "choice" ? "conditional" : "edge" }];
+	}))
+} }) };
 /** Stately's semantic projection of the LangGraph 1.x APIs across runtimes. */
 const LANGGRAPH_PROFILE = "@statelyai/langgraph@1.0.0";
 const LANGGRAPH_PROFILE_MANIFEST = {
 	profile: LANGGRAPH_PROFILE,
+	namespace: "@statelyai.langgraph",
+	lineage: "@statelyai/langgraph",
+	projection: LANGGRAPH_PROJECTION,
+	selectable: false,
 	name: "LangGraph",
 	description: "LangGraph 1.x graph semantics for Python and JavaScript/TypeScript source.",
 	restrictFormatsToListed: true,
@@ -4188,6 +4262,9 @@ const XSTATE_AUTHORING = {
 };
 const XSTATE_PROFILE_MANIFESTS = [{
 	profile: XSTATE_V5_PROFILE,
+	namespace: "@statelyai.xstate",
+	lineage: "@statelyai/xstate",
+	projection: XSTATE_V5_PROJECTION,
 	name: "XState v5",
 	formats: [...XSTATE_FORMATS],
 	authoring: XSTATE_AUTHORING,
@@ -4198,7 +4275,10 @@ const XSTATE_PROFILE_MANIFESTS = [{
 	}
 }, {
 	profile: XSTATE_V6_PROFILE,
-	name: "XState v6",
+	namespace: "@statelyai.xstate",
+	lineage: "@statelyai/xstate",
+	projection: XSTATE_V6_PROJECTION,
+	name: "XState v6 alpha",
 	formats: [...XSTATE_FORMATS],
 	authoring: XSTATE_AUTHORING,
 	operations: {
@@ -5362,10 +5442,15 @@ function hasV6Syntax(source) {
 			const binding = bindings.get(node.text);
 			return binding ? containsFunctionTransitionMap(binding, seen) : false;
 		}
-		if (!ts.isObjectLiteralExpression(node)) return false;
+		if (ts.isArrayLiteralExpression(node)) return node.elements.some((element) => ts.isExpression(element) && containsFunctionTransitionMap(element, seen));
+		if (!ts.isObjectLiteralExpression(node)) return containsFunction(node);
 		return node.properties.some((property) => {
 			if (ts.isMethodDeclaration(property)) return true;
-			if (ts.isPropertyAssignment(property)) return containsFunction(property.initializer);
+			if (ts.isPropertyAssignment(property)) {
+				const key = propName(property.name);
+				if (key === "guard" || key === "cond" || key === "actions") return false;
+				return containsFunctionTransitionMap(property.initializer, seen);
+			}
 			if (ts.isShorthandPropertyAssignment(property)) return containsFunction(property.name);
 			if (ts.isSpreadAssignment(property)) return containsFunctionTransitionMap(property.expression, seen);
 			return false;
@@ -5431,11 +5516,6 @@ function hasV6Syntax(source) {
 function detectXStateSourceProfile(source) {
 	return hasV6Syntax(source) ? "xstate-v6-alpha" : "xstate-v5";
 }
-function xstateSourceToConfig(source, options = {}) {
-	const [config] = extractXStateMachineConfigs(source, options);
-	if (!config) throw new Error("No createMachine(...), createFSM(...), or setup factory call found.");
-	return config;
-}
 /**
 * Extract every XState machine config from source without executing code.
 * XState 5/6 syntax is inferred structurally unless a profile is supplied.
@@ -5551,9 +5631,6 @@ function extractXStateMachineConfigEntries(source, options = {}) {
 	visit(file);
 	return found;
 }
-function extractXStateMachineConfigs(source, options = {}) {
-	return extractXStateMachineConfigEntries(source, options).map(({ config }) => config);
-}
 function jsonSchemaToTSType(schema) {
 	if (!schema) return "unknown";
 	if (schema.enum) return schema.enum.map((v) => typeof v === "string" ? `'${v}'` : String(v)).join(" | ");
@@ -7676,102 +7753,4 @@ const simulateMachineStepInputSchema = machineInputSchema.extend({
 });
 
 //#endregion
-//#region src/statelyPragma.ts
-function findStatelyPragmaAttachments(sourceText, fileName = "machine.ts") {
-	const sourceFile = ts.createSourceFile(fileName, sourceText, ts.ScriptTarget.Latest, true, getScriptKind(fileName));
-	const attachments = [];
-	const visit = (node) => {
-		if (ts.isCallExpression(node) && isCreateMachineExpression(node.expression)) {
-			const attachNode = findAttachNode(node);
-			if (attachNode) attachments.push({
-				machineStart: getMachineExpressionStart(node.expression, sourceFile),
-				attachStart: attachNode.getStart(sourceFile),
-				pragma: findAttachedStatelyPragma(sourceText, attachNode)
-			});
-		}
-		ts.forEachChild(node, visit);
-	};
-	visit(sourceFile);
-	return attachments;
-}
-function getStatelyPragma(sourceText, fileName = "machine.ts", machineIndex = 0) {
-	return findStatelyPragmaAttachments(sourceText, fileName)[machineIndex]?.pragma;
-}
-function upsertStatelyPragma(sourceText, id, options = {}) {
-	const attachment = findStatelyPragmaAttachments(sourceText, options.fileName ?? "machine.ts")[options.machineIndex ?? 0];
-	if (!attachment) return sourceText;
-	const lineEnding = options.lineEnding ?? detectLineEnding(sourceText);
-	const canonicalComment = `// @statelyai id=${id}`;
-	if (attachment.pragma) return sourceText.slice(0, attachment.pragma.start) + canonicalComment + sourceText.slice(attachment.pragma.end);
-	const insertText = `${getIndentationAtOffset(sourceText, attachment.attachStart)}${canonicalComment}${lineEnding}`;
-	return sourceText.slice(0, attachment.attachStart) + insertText + sourceText.slice(attachment.attachStart);
-}
-function findAttachedStatelyPragma(sourceText, node) {
-	const comments = ts.getLeadingCommentRanges(sourceText, node.getFullStart()) ?? [];
-	for (let index = comments.length - 1; index >= 0; index -= 1) {
-		const comment = comments[index];
-		const parsed = parseStatelyPragma(sourceText, comment.pos, comment.end);
-		if (parsed) return parsed;
-	}
-}
-function parseStatelyPragma(sourceText, start, end) {
-	const match = normalizeCommentContent(sourceText.slice(start, end)).match(/^@statelyai(?:\s+(.*))?$/s);
-	if (!match) return;
-	const fields = parseFields(match[1] ?? "");
-	return {
-		tag: "@statelyai",
-		id: fields.id,
-		fields,
-		start,
-		end
-	};
-}
-function normalizeCommentContent(rawComment) {
-	if (rawComment.startsWith("//")) return rawComment.slice(2).trim();
-	if (rawComment.startsWith("/*")) return rawComment.slice(2, rawComment.endsWith("*/") ? -2 : void 0).split(/\r?\n/).map((line) => line.replace(/^\s*\*\s?/, "")).join(" ").trim();
-	return rawComment.trim();
-}
-function parseFields(input) {
-	const fields = {};
-	for (const token of input.split(/\s+/)) {
-		if (!token) continue;
-		const equalsIndex = token.indexOf("=");
-		if (equalsIndex <= 0) continue;
-		const key = token.slice(0, equalsIndex);
-		const value = token.slice(equalsIndex + 1);
-		if (!key || !value) continue;
-		fields[key] = value;
-	}
-	return fields;
-}
-function findAttachNode(node) {
-	let current = node;
-	while (current?.parent) {
-		if (ts.isVariableStatement(current.parent) || ts.isExpressionStatement(current.parent) || ts.isExportAssignment(current.parent)) return current.parent;
-		current = current.parent;
-	}
-	return current;
-}
-function isCreateMachineExpression(expression) {
-	return ts.isIdentifier(expression) && expression.text === "createMachine" || ts.isPropertyAccessExpression(expression) && expression.name.text === "createMachine";
-}
-function getMachineExpressionStart(expression, sourceFile) {
-	if (ts.isPropertyAccessExpression(expression)) return expression.name.getStart(sourceFile);
-	return expression.getStart(sourceFile);
-}
-function getIndentationAtOffset(sourceText, offset) {
-	const lineStart = sourceText.lastIndexOf("\n", Math.max(0, offset - 1)) + 1;
-	return sourceText.slice(lineStart, offset).match(/^[ \t]*/)?.[0] ?? "";
-}
-function detectLineEnding(sourceText) {
-	return sourceText.includes("\r\n") ? "\r\n" : "\n";
-}
-function getScriptKind(fileName) {
-	if (fileName.endsWith(".tsx")) return ts.ScriptKind.TSX;
-	if (fileName.endsWith(".jsx")) return ts.ScriptKind.JSX;
-	if (fileName.endsWith(".js")) return ts.ScriptKind.JS;
-	return ts.ScriptKind.TS;
-}
-
-//#endregion
-export { jsonSchemaToTSType as _, RawCode as a, serializeJS as b, detectXStateSourceProfile as c, getXStateFSMCompatibilityIssues as d, graphChangeToPatchesResult as f, graphToXStateV4TS as g, graphToXStateTS as h, INLINE_EXPRESSION_DIRECTIVE_FIELDS as i, diffGraphsSemantically as l, graphToXStateFSM as m, getStatelyPragma as n, alignCompareGraphIds as o, graphToMachineConfig as p, upsertStatelyPragma as r, contextSchemaToTSType as s, findStatelyPragmaAttachments as t, eventsSchemaToTSType as u, normalizeMachineProfile as v, xstateSourceToConfig as x, raw as y };
+export { raw as _, detectXStateSourceProfile as a, extractXStateMachineConfigEntries as c, graphToMachineConfig as d, graphToXStateFSM as f, normalizeMachineProfile as g, jsonSchemaToTSType as h, contextSchemaToTSType as i, getXStateFSMCompatibilityIssues as l, graphToXStateV4TS as m, RawCode as n, diffGraphsSemantically as o, graphToXStateTS as p, alignCompareGraphIds as r, eventsSchemaToTSType as s, INLINE_EXPRESSION_DIRECTIVE_FIELDS as t, graphChangeToPatchesResult as u, serializeJS as v };

package/dist/{editor-sync-types-DB1N6QUK.d.mts → editor-sync-types-CPpzTSnT.d.mts}

@@ -65,6 +65,8 @@ interface EditorSyncDocumentContext {
   rootFileName: string;
   rootDir: string;
   documents: EditorSyncSourceDocument[];
+  /** Zero-based machine occurrence within the root source document. */
+  machineIndex?: number;
 }
 type EditorSyncParseRequest = EditorSyncDocumentContext;
 interface EditorSyncParseResponse {
@@ -81,7 +83,9 @@ interface EditorSyncApplyRequest extends EditorSyncDocumentContext {
   sourceLocations?: MachineSourceLocations;
   serialized?: Record<string, string>;
   preserveStatelyMetadata?: boolean;
+  sourceUpdateStrategy?: SourceUpdateStrategy;
 }
+type SourceUpdateStrategy = 'preserve' | 'rewrite';
 interface EditorSyncTextReplacement {
   uri?: string;
   range: EditorSyncSourceRange;

package/dist/{editorHostSession-vSt07IJV.d.mts → editorHostSession-BHr3WBHT.d.mts}

@@ -1,5 +1,5 @@
-import { t as EmbedPanelConfig } from "./embedPanel-Bpbq4sfJ.mjs";
-import { a as EditorSyncParseRequest, d as EditorSyncTextReplacement, f as MachineSourceLocations, i as EditorSyncApplyResponse, n as EditorSyncAccess, o as EditorSyncParseResponse, r as EditorSyncApplyRequest, s as EditorSyncSourceDocument, t as EditorCapabilities } from "./editor-sync-types-DB1N6QUK.mjs";
+import { Y as ProjectEmbedMachine, Zt as EmbedPanelConfig, ot as ProjectWorkspaceConfig } from "./protocol-DOt1Vz-5.mjs";
+import { a as EditorSyncParseRequest, d as EditorSyncTextReplacement, f as MachineSourceLocations, i as EditorSyncApplyResponse, n as EditorSyncAccess, o as EditorSyncParseResponse, r as EditorSyncApplyRequest, s as EditorSyncSourceDocument, t as EditorCapabilities } from "./editor-sync-types-CPpzTSnT.mjs";
 
 //#region src/editorHostProtocol.d.ts
 declare const EDITOR_PROTOCOL_VERSION = 1;
@@ -24,11 +24,13 @@ type EditorHostInboundMessage = {
 } | {
   type: '@statelyai.loaded';
   graph: unknown;
+  machineId?: string;
   sourceLocations?: MachineSourceLocations;
 } | {
   type: '@statelyai.change';
   graph: unknown;
   machineConfig: unknown;
+  machineId?: string;
   patches?: unknown[];
   sourceLocations?: MachineSourceLocations;
 } | {
@@ -36,19 +38,24 @@ type EditorHostInboundMessage = {
   requestId?: string;
   graph: unknown;
   machineConfig: unknown;
+  machineId?: string;
   patches?: unknown[];
   validations?: EditorHostValidationIssue[];
   sourceLocations?: MachineSourceLocations;
+  sourceUpdateStrategy?: 'preserve' | 'rewrite';
 } | {
   type: '@statelyai.refresh';
+  machineId?: string;
 } | {
   type: '@statelyai.retrieved';
   requestId: string;
   data: unknown;
+  machineId?: string;
 } | {
   type: '@statelyai.error';
   code: string;
   message: string;
+  machineId?: string;
   requestId?: string;
   diagnostic?: EditorHostDiagnostic;
 } | {
@@ -58,6 +65,18 @@ type EditorHostInboundMessage = {
   type: '@statelyai.clipboardWrite';
   requestId: string;
   text: string;
+} | {
+  type: '@statelyai.project.machineSelected';
+  machineId: string;
+} | {
+  type: '@statelyai.project.workspaceAction';
+  actionId: string;
+  projectId?: string;
+  machineId?: string;
+  data?: unknown;
+} | {
+  type: '@statelyai.project.workspaceOpenChanged';
+  open: boolean;
 };
 interface EditorHostInitOptions {
   settings?: Record<string, unknown>;
@@ -92,6 +111,32 @@ type EditorHostOutboundMessage = {
     enabled?: boolean;
     mode?: 'structural' | 'all';
   };
+} | {
+  type: '@statelyai.project.init';
+  machines: ProjectEmbedMachine[];
+  currentMachineId?: string;
+  mode?: 'editing' | 'viewing';
+  theme?: 'light' | 'dark';
+  readOnly?: boolean;
+  readOnlyReason?: 'free-plan' | 'access-unverified';
+  capabilities?: EditorCapabilities;
+  projectWorkspace?: ProjectWorkspaceConfig;
+  projectWorkspaceOpen?: boolean;
+  settings?: Record<string, unknown>;
+  panels?: EmbedPanelConfig[];
+  unsavedIndicator?: {
+    enabled?: boolean;
+    mode?: 'structural' | 'all';
+  };
+} | {
+  type: '@statelyai.project.update';
+  machines: ProjectEmbedMachine[];
+  currentMachineId?: string;
+  projectWorkspace?: ProjectWorkspaceConfig;
+  projectWorkspaceOpen?: boolean;
+} | {
+  type: '@statelyai.project.selectMachine';
+  machineId: string;
 } | {
   type: '@statelyai.setApiKey';
   apiKey: string;
@@ -106,23 +151,28 @@ type EditorHostOutboundMessage = {
   type: '@statelyai.update';
   machine: unknown;
   format?: string;
+  machineId?: string;
   sourceLocations?: MachineSourceLocations;
 } | {
   type: '@statelyai.saved';
   requestId?: string;
   graph: unknown;
+  machineId?: string;
 } | {
   type: '@statelyai.retrieve';
   requestId: string;
   format: EditorHostExportFormat;
+  machineId?: string;
 } | {
   type: '@statelyai.toast';
   message: string;
   toastType?: 'success' | 'error' | 'info' | 'warning';
+  machineId?: string;
 } | {
   type: '@statelyai.error';
   code: string;
   message: string;
+  machineId?: string;
   requestId?: string;
   diagnostic?: EditorHostDiagnostic;
 } | {
@@ -156,6 +206,8 @@ interface EditorSourceHost {
   rootUri: string;
   rootFileName: string;
   rootDir: string;
+  /** Zero-based machine occurrence within the root source document. */
+  machineIndex?: number;
   collectDocuments(extraUris?: readonly string[]): Promise<EditorSyncSourceDocument[]>;
   applyReplacements(replacements: EditorSyncTextReplacement[], rootUri: string): Promise<string[]>;
   saveDocuments?(uris: string[]): Promise<void>;
@@ -168,6 +220,7 @@ interface EditorSourceHost {
   getPreserveStatelyMetadata?(uri: string): boolean;
 }
 interface EditorHostSessionOptions {
+  sourceUpdateStrategy?: 'preserve' | 'rewrite';
   source: EditorSourceHost;
   sync: EditorSyncBackend;
   send(message: EditorHostOutboundMessage): void;
@@ -183,8 +236,16 @@ interface EditorHostSessionOptions {
     version: string;
   };
 }
+type SaveReminderState = {
+  shown: boolean;
+};
+type SelfEditState = {
+  count: number;
+};
 declare class EditorHostSession {
   private options;
+  private saveReminderState;
+  private selfEditState;
   private editorProtocolState;
   private currentGraph;
   private lastPersistedGraph;
@@ -192,13 +253,11 @@ declare class EditorHostSession {
   private currentSourceLocations;
   private access;
   private watchedSourceUris;
-  private selfEditCount;
-  private saveReminderShown;
   private watcher;
   private changeWatcher;
   private retrieveRequestCount;
   private pendingRetrievals;
-  constructor(options: EditorHostSessionOptions);
+  constructor(options: EditorHostSessionOptions, saveReminderState?: SaveReminderState, selfEditState?: SelfEditState);
   dispose(): void;
   notifySavedDocument(uri?: string): Promise<void>;
   receive(message: EditorHostInboundMessage): Promise<void>;
@@ -211,5 +270,45 @@ declare class EditorHostSession {
   private requestSerialized;
   private resolveRetrieved;
 }
+interface EditorHostWorkspaceMachine {
+  id: string;
+  name?: string;
+  sourceReference?: string;
+  source: EditorSourceHost;
+}
+type EditorHostWorkspaceSessionOptions = Omit<EditorHostSessionOptions, 'source' | 'send'> & {
+  machines: EditorHostWorkspaceMachine[];
+  send(message: EditorHostOutboundMessage): void;
+  currentMachineId?: string;
+  workspaceName?: string;
+  projectWorkspaceOpen?: boolean;
+};
+/**
+ * Runs one source-sync session per discovered machine while presenting the
+ * editor's project/workspace protocol as a single surface.
+ */
+declare class EditorHostWorkspaceSession {
+  private options;
+  private children;
+  private machineDefinitions;
+  private initialMessages;
+  private selectedMachineId;
+  private sentHandshake;
+  private sentApiKey;
+  private initialized;
+  private projectWorkspaceOpen;
+  private retrieveRequestCount;
+  private pendingRetrievals;
+  private saveReminderStates;
+  private selfEditStates;
+  constructor(options: EditorHostWorkspaceSessionOptions);
+  receive(message: EditorHostInboundMessage): Promise<void>;
+  selectMachine(machineId: string): void;
+  dispose(): void;
+  private handleChildMessage;
+  private flushProjectInit;
+  private getProjectMachines;
+  private getProjectWorkspace;
+}
 //#endregion
-export { EditorSyncError as a, fetchEditorSyncAccess as c, EditorHostExportFormat as d, EditorHostInboundMessage as f, EditorHostValidationIssue as h, EditorSyncBackend as i, EDITOR_PROTOCOL_VERSION as l, EditorHostOutboundMessage as m, EditorHostSessionOptions as n, RemoteEditorSyncBackendOptions as o, EditorHostInitOptions as p, EditorSourceHost as r, createRemoteEditorSyncBackend as s, EditorHostSession as t, EditorHostDiagnostic as u };
+export { EditorHostOutboundMessage as _, EditorHostWorkspaceSessionOptions as a, EditorSyncError as c, fetchEditorSyncAccess as d, EDITOR_PROTOCOL_VERSION as f, EditorHostInitOptions as g, EditorHostInboundMessage as h, EditorHostWorkspaceSession as i, RemoteEditorSyncBackendOptions as l, EditorHostExportFormat as m, EditorHostSessionOptions as n, EditorSourceHost as o, EditorHostDiagnostic as p, EditorHostWorkspaceMachine as r, EditorSyncBackend as s, EditorHostSession as t, createRemoteEditorSyncBackend as u, EditorHostValidationIssue as v };