@statelyai/sdk 0.29.1 → 0.31.1

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-Bo-YhDEG.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-2cvzJtGN.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 };