@statelyai/sdk 0.6.0 → 0.7.0

package/dist/index.d.mts

@@ -1,13 +1,14 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, VerifyApiKeyResponse, XStateVersion, createStatelyClient } from "./studio.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-CB-ALrdk.mjs";
-import { PlanSyncOptions, PullSyncResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
-import { a as EmbedMode, c as ExportFormatMap, f as ProjectEmbedMachine, i as EmbedEventName, l as InitOptions, m as UploadResult, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig } from "./protocol-CEbWQPYe.mjs";
+import { a as EmbedMode, c as ExportFormatMap, f as ProjectEmbedMachine, i as EmbedEventName, l as InitOptions, m as UploadResult, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig } from "./protocol-DN4mH4jR.mjs";
+import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
+import { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, UpdateMachineInput, VerifyApiKeyResponse, XStateVersion, createStatelyClient } from "./studio.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-DpBGHZwl.mjs";
+import { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { a as ManualActorOptions, c as createPostMessageTransport, i as InspectorEvents, l as createWebSocketTransport, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-DIxB2Tr3.mjs";
+import { a as ManualActorOptions, c as createPostMessageTransport, i as InspectorEvents, l as createWebSocketTransport, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-Bg9FTvb3.mjs";
 import { ActionLocation, GraphPatch } from "./patchTypes.mjs";
-import { CodeGenGraph, MachineConfigOptions, RawCode, graphToMachineConfig, raw, serializeJS } from "@statelyai/graph-tools";
 import { JSONSchema7 } from "json-schema";
+import { UnknownMachineConfig } from "xstate";
 
 //#region src/statelyPragma.d.ts
 interface StatelyPragma {
@@ -31,12 +32,146 @@ declare function findStatelyPragmaAttachments(sourceText: string, fileName?: str
 declare function getStatelyPragma(sourceText: string, fileName?: string, machineIndex?: number): StatelyPragma | undefined;
 declare function upsertStatelyPragma(sourceText: string, id: string, options?: UpsertStatelyPragmaOptions): string;
 //#endregion
+//#region ../graph-tools/src/codegenTypes.d.ts
+interface CodeGenAction {
+  type: string;
+  params?: Record<string, unknown>;
+}
+interface CodeGenGuard {
+  type: string;
+  code?: string;
+  params?: Record<string, unknown>;
+}
+/**
+ * Serialized inline expression directive.
+ *
+ * Code generation treats this object as JavaScript/TypeScript source, not as a
+ * machine config object. It is used for fields such as invoke `input` and
+ * `output` where XState accepts mapper expressions.
+ */
+interface CodeExpression {
+  '@type': 'code';
+  lang: 'js' | 'ts';
+  expr: string;
+}
+interface CodeGenInvoke {
+  src: string;
+  id: string;
+  input?: Record<string, unknown> | CodeExpression;
+  output?: Record<string, unknown> | CodeExpression;
+}
+interface CodeGenNodeData {
+  nodeId?: string | null;
+  key: string;
+  type?: 'normal' | 'parallel' | 'final' | 'history' | null;
+  initialId?: string | null;
+  history?: 'shallow' | 'deep' | boolean;
+  entry?: CodeGenAction[];
+  exit?: CodeGenAction[];
+  invokes?: CodeGenInvoke[];
+  tags?: Array<string | {
+    name: string;
+  }>;
+  description?: string | null;
+  meta?: Record<string, unknown> | null;
+  color?: string;
+  parentId?: string | null;
+  temp?: boolean;
+}
+interface CodeGenEdgeData {
+  eventType: string;
+  transitionType?: 'normal' | 'targetless' | 'reenter';
+  guard?: CodeGenGuard | null;
+  actions?: CodeGenAction[];
+  description?: string | null;
+  color?: string;
+  meta?: Record<string, unknown> | null;
+  temp?: boolean;
+}
+interface CodeGenImplementation {
+  id: string;
+  name: string;
+  description?: string | null;
+  icon?: string;
+  paramsSchema?: JSONSchema7 | null;
+  code?: {
+    body: string;
+    lang?: string;
+  } | null;
+}
+interface CodeGenActorImplementation {
+  id: string;
+  name: string;
+  description?: string | null;
+  icon?: string;
+  inputSchema?: JSONSchema7 | null;
+  outputSchema?: JSONSchema7 | null;
+  code?: {
+    body: string;
+    lang?: string;
+  } | null;
+}
+interface CodeGenGraphData {
+  schemas?: {
+    context?: Record<string, JSONSchema7> | null;
+    events?: Record<string, JSONSchema7> | null;
+    input?: JSONSchema7 | null;
+    output?: JSONSchema7 | null;
+  } | null;
+  implementations?: {
+    actions: CodeGenImplementation[];
+    guards: CodeGenImplementation[];
+    actors: CodeGenActorImplementation[];
+    delays: CodeGenImplementation[];
+  } | null;
+}
+interface CodeGenNode {
+  id: string;
+  parentId?: string | null;
+  data: CodeGenNodeData;
+}
+interface CodeGenEdge {
+  id: string;
+  sourceId: string;
+  targetId: string;
+  data: CodeGenEdgeData;
+}
+interface CodeGenGraph {
+  id: string;
+  nodes: CodeGenNode[];
+  edges: CodeGenEdge[];
+  data: CodeGenGraphData;
+}
+//#endregion
+//#region ../graph-tools/src/graphToMachineConfig.d.ts
+interface MachineConfigOptions {
+  showDescriptions?: boolean;
+  showMeta?: boolean;
+}
+declare function graphToMachineConfig(graph: CodeGenGraph, options?: MachineConfigOptions): UnknownMachineConfig;
+//#endregion
 //#region src/graphToXStateTS.d.ts
 interface XStateTSOptions extends MachineConfigOptions {
   exportStyle?: 'named' | 'default' | 'none';
 }
 declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions): string;
 //#endregion
+//#region ../graph-tools/src/serializeJS.d.ts
+/**
+ * Serializes JavaScript values as JS source code (not JSON).
+ * - Unquoted keys for valid identifiers
+ * - Single-quoted strings
+ * - Omits undefined values
+ * - Supports RawCode for verbatim expressions
+ * - Supports inline expression directives for verbatim expressions
+ */
+declare class RawCode {
+  code: string;
+  constructor(code: string);
+}
+declare function raw(code: string): RawCode;
+declare function serializeJS(value: unknown, indent?: number, step?: number): string;
+//#endregion
 //#region src/jsonSchemaToTSType.d.ts
 declare function jsonSchemaToTSType(schema: JSONSchema7 | undefined | null): string;
 /**
@@ -50,4 +185,4 @@ declare function contextSchemaToTSType(context: Record<string, JSONSchema7> | nu
  */
 declare function eventsSchemaToTSType(events: Record<string, JSONSchema7> | null | undefined): string | null;
 //#endregion
-export { type ActionLocation, type AdoptedActor, type AssetConfig, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesResponse, type ExtractedMachine, type GetMachineOptions, type GraphPatch, type InitOptions, type Inspector, type InspectorEvents, type MachineConfigOptions, type ManualActorOptions, type PlanSyncOptions, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectVisibility, type PullSyncResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type XStateTSOptions, type XStateVersion, contextSchemaToTSType, createPostMessageTransport, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, findStatelyPragmaAttachments, fromStudioMachine, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type CreateS3AssetUploadAdapterOptions, type CreateSupabaseAssetUploadAdapterOptions, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesResponse, type ExtractedMachine, type GetMachineOptions, type GraphPatch, type InitOptions, type Inspector, type InspectorEvents, type MachineConfigOptions, type ManualActorOptions, type PlanSyncOptions, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UpdateMachineInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type XStateTSOptions, type XStateVersion, contextSchemaToTSType, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, eventsSchemaToTSType, findStatelyPragmaAttachments, fromStudioMachine, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/index.mjs

@@ -1,9 +1,10 @@
-import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-C0eTgNNu.mjs";
+import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-C8UTS3Fa.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
+import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
 import { createStatelyInspector } from "./inspect.mjs";
 import { StudioApiError, createStatelyClient } from "./studio.mjs";
 import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { a as RawCode, c as graphToMachineConfig, d as upsertStatelyPragma, i as jsonSchemaToTSType, l as findStatelyPragmaAttachments, n as contextSchemaToTSType, o as raw, r as eventsSchemaToTSType, s as serializeJS, t as graphToXStateTS, u as getStatelyPragma } from "./graphToXStateTS-CvXM8wHL.mjs";
+import { a as graphToMachineConfig, c as serializeJS, d as upsertStatelyPragma, i as jsonSchemaToTSType, l as findStatelyPragmaAttachments, n as contextSchemaToTSType, o as RawCode, r as eventsSchemaToTSType, s as raw, t as graphToXStateTS, u as getStatelyPragma } from "./graphToXStateTS-Gzh0ZqbN.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 
-export { RawCode, StatelyApiError, StudioApiError, contextSchemaToTSType, createPostMessageTransport, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, findStatelyPragmaAttachments, fromStudioMachine, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { RawCode, StatelyApiError, StudioApiError, contextSchemaToTSType, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, eventsSchemaToTSType, findStatelyPragmaAttachments, fromStudioMachine, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/{inspect-DIxB2Tr3.d.mts → inspect-Bg9FTvb3.d.mts}

@@ -1,4 +1,4 @@
-import { c as ExportFormatMap, o as ExportCallOptions, p as ProtocolMessage, r as EmbedEventMap, s as ExportFormat } from "./protocol-CEbWQPYe.mjs";
+import { c as ExportFormatMap, o as ExportCallOptions, p as ProtocolMessage, r as EmbedEventMap, s as ExportFormat } from "./protocol-DN4mH4jR.mjs";
 
 //#region src/transport.d.ts
 interface Transport {

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
-import { a as EmbedMode, c as ExportFormatMap, i as EmbedEventName, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat } from "./protocol-CEbWQPYe.mjs";
-import { a as ManualActorOptions, i as InspectorEvents, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-DIxB2Tr3.mjs";
+import { a as EmbedMode, c as ExportFormatMap, i as EmbedEventName, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat } from "./protocol-DN4mH4jR.mjs";
+import { a as ManualActorOptions, i as InspectorEvents, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-Bg9FTvb3.mjs";
 export { AdoptedActor, CreateInspectorOptions, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, Inspector, InspectorEvents, ManualActorOptions, Transport, createStatelyInspector };

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
-import { i as createPendingExportManager, n as createWebSocketTransport, r as createEventRegistry } from "./transport-C0eTgNNu.mjs";
+import { i as createPendingExportManager, n as createWebSocketTransport, r as createEventRegistry } from "./transport-C8UTS3Fa.mjs";
 
 //#region src/inspect.ts
 const defaultSerializeSnapshot = (snapshot) => ({

package/dist/{protocol-CEbWQPYe.d.mts → protocol-DN4mH4jR.d.mts}

@@ -60,9 +60,8 @@ interface ExportFormatMap {
     };
     result: string;
   };
-  json: {
+  'xstate-json': {
     options: {
-      simplifyArrays?: boolean;
       version?: 4 | 5;
     };
     result: Record<string, unknown>;

package/dist/studio.d.mts

@@ -75,6 +75,11 @@ interface CreateMachineFromTemplateInput {
   xstateVersion?: XStateVersion;
 }
 type CreateMachineInput<TDefinition = Record<string, unknown>> = CreateMachineFromDefinitionInput<TDefinition> | CreateMachineFromTemplateInput;
+interface UpdateMachineInput<TDefinition = Record<string, unknown>> {
+  id: string;
+  name?: string;
+  definition?: TDefinition;
+}
 interface StudioMachineRecord<TDefinition = Record<string, unknown>> {
   id: string;
   name: string;
@@ -99,6 +104,7 @@ interface StudioClient {
   machines: {
     create<TMachine = Record<string, unknown>>(input: CreateMachineInput<TMachine>): Promise<StudioMachineRecord<TMachine>>;
     createMany<TMachine = Record<string, unknown>>(input: CreateMachineInput<TMachine>): Promise<Array<StudioMachineRecord<TMachine>>>;
+    update<TMachine = Record<string, unknown>>(input: UpdateMachineInput<TMachine>): Promise<StudioMachineRecord<TMachine>>;
     get<TMachine = Record<string, unknown>>(machineId: string, options?: GetMachineOptions): Promise<TMachine>;
   };
   code: {
@@ -109,4 +115,4 @@ interface StudioClient {
 }
 declare function createStatelyClient(options?: StudioClientOptions): StudioClient;
 //#endregion
-export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, VerifyApiKeyResponse, XStateVersion, createStatelyClient };
+export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, UpdateMachineInput, VerifyApiKeyResponse, XStateVersion, createStatelyClient };

package/dist/studio.mjs

@@ -102,6 +102,13 @@ function createStatelyClient(options = {}) {
 			async createMany(input) {
 				return [await this.create(input)];
 			},
+			update(input) {
+				return request(`/machines/${encodeURIComponent(input.id)}`, {
+					method: "PATCH",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify(input)
+				});
+			},
 			get(machineId, getOptions = {}) {
 				const search = new URLSearchParams();
 				if (getOptions.version) search.set("version", getOptions.version);

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
 import { CreateProjectInput, ProjectData, StudioClient, StudioMachineRecord, XStateVersion } from "./studio.mjs";
-import { b as DigraphConfig, i as StatelyGraph } from "./graph-CB-ALrdk.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-DpBGHZwl.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
 //#region src/sync.d.ts
@@ -52,8 +52,26 @@ interface PushSyncResult {
   machine: StudioMachineRecord<DigraphConfig>;
   outputPath?: string;
 }
+interface PushLocalMachineLinksResult {
+  sourcePath: string;
+  project: ProjectData;
+  created: Array<{
+    machineIndex: number;
+    machine: StudioMachineRecord<DigraphConfig>;
+  }>;
+  updated: Array<{
+    machineIndex: number;
+    machine: StudioMachineRecord<DigraphConfig>;
+  }>;
+  skipped: Array<{
+    machineIndex: number;
+    reason: string;
+  }>;
+  outputPath?: string;
+}
+declare function pushLocalMachineLinks(options: PushSyncOptions): Promise<PushLocalMachineLinksResult>;
 declare function planSync(options: PlanSyncOptions): Promise<SyncPlan>;
 declare function pullSync(options: PlanSyncOptions): Promise<PullSyncResult>;
 declare function pushSync(options: PushSyncOptions): Promise<PushSyncResult>;
 //#endregion
-export { PlanSyncOptions, PullSyncResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary, planSync, pullSync, pushSync };
+export { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary, planSync, pullSync, pushLocalMachineLinks, pushSync };

package/dist/sync.mjs

@@ -1,5 +1,5 @@
 import { createStatelyClient } from "./studio.mjs";
-import { d as upsertStatelyPragma, t as graphToXStateTS } from "./graphToXStateTS-CvXM8wHL.mjs";
+import { d as upsertStatelyPragma, l as findStatelyPragmaAttachments, t as graphToXStateTS, u as getStatelyPragma } from "./graphToXStateTS-Gzh0ZqbN.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import { getDiff, isEmptyDiff } from "@statelyai/graph";
 import fs from "node:fs/promises";
@@ -186,6 +186,90 @@ function fromXStateConfig(config) {
 		data: {}
 	};
 }
+async function pushLocalMachineLinks(options) {
+	const client = options.client ?? createStatelyClient({
+		apiKey: options.apiKey,
+		baseUrl: options.baseUrl,
+		fetch: options.fetch
+	});
+	const sourcePath = path.resolve(options.cwd ?? process.cwd(), options.source);
+	const project = await resolvePushProject(client, sourcePath, options);
+	if (!project.projectVersionId) throw new Error("Resolved project is missing projectVersionId.");
+	const contents = await fs.readFile(sourcePath, "utf8");
+	const attachments = findStatelyPragmaAttachments(contents, sourcePath);
+	const extracted = await client.code.extractMachines(contents);
+	if (attachments.length === 0 || extracted.machines.length === 0) return {
+		sourcePath,
+		project,
+		created: [],
+		updated: [],
+		skipped: [{
+			machineIndex: 0,
+			reason: "No local machines were discovered in this file."
+		}]
+	};
+	if (attachments.length !== extracted.machines.length) return {
+		sourcePath,
+		project,
+		created: [],
+		updated: [],
+		skipped: [{
+			machineIndex: 0,
+			reason: "The local machine extractor did not align with the source attachments for this file."
+		}]
+	};
+	let nextContents = contents;
+	let outputPath;
+	const created = [];
+	const updated = [];
+	const skipped = [];
+	for (const [machineIndex, attachment] of attachments.entries()) {
+		const extractedMachine = extracted.machines[machineIndex];
+		if (!extractedMachine?.config) {
+			skipped.push({
+				machineIndex,
+				reason: "No extracted machine config was available for this source."
+			});
+			continue;
+		}
+		if (attachment.pragma?.id) {
+			const updatedMachine = await client.machines.update({
+				id: attachment.pragma.id,
+				definition: toStudioMachine(fromXStateConfig(extractedMachine.config))
+			});
+			updated.push({
+				machineIndex,
+				machine: updatedMachine
+			});
+			continue;
+		}
+		const machine = await client.machines.create({
+			projectVersionId: project.projectVersionId,
+			definition: toStudioMachine(fromXStateConfig(extractedMachine.config)),
+			xstateVersion: Math.max(5, options.xstateVersion ?? 5)
+		});
+		nextContents = upsertStatelyPragma(nextContents, machine.id, {
+			fileName: sourcePath,
+			machineIndex
+		});
+		created.push({
+			machineIndex,
+			machine
+		});
+	}
+	if (nextContents !== contents) {
+		await fs.writeFile(sourcePath, nextContents, "utf8");
+		outputPath = sourcePath;
+	}
+	return {
+		sourcePath,
+		project,
+		created,
+		updated,
+		skipped,
+		...outputPath ? { outputPath } : {}
+	};
+}
 async function resolveLocalFile(locator, options) {
 	const filePath = path.resolve(options.cwd ?? process.cwd(), locator);
 	const contents = await fs.readFile(filePath, "utf8");
@@ -350,12 +434,20 @@ async function pushSync(options) {
 	if (source.kind !== "local-file") throw new Error("pushSync currently requires a local source file.");
 	const sourcePath = source.locator;
 	const project = await resolvePushProject(client, sourcePath, options);
-	if (!project.projectVersionId) throw new Error("Resolved project is missing projectVersionId.");
-	const machine = await client.machines.create({
-		projectVersionId: project.projectVersionId,
-		definition: toStudioMachine(source.graph),
-		xstateVersion: options.xstateVersion ?? 5
+	const existingMachineId = source.format === "xstate" ? getStatelyPragma(await fs.readFile(sourcePath, "utf8"), sourcePath)?.id : void 0;
+	let machine;
+	if (existingMachineId) machine = await client.machines.update({
+		id: existingMachineId,
+		definition: toStudioMachine(source.graph)
 	});
+	else {
+		if (!project.projectVersionId) throw new Error("Resolved project is missing projectVersionId.");
+		machine = await client.machines.create({
+			projectVersionId: project.projectVersionId,
+			definition: toStudioMachine(source.graph),
+			xstateVersion: options.xstateVersion ?? 5
+		});
+	}
 	let outputPath;
 	if (source.format === "xstate") {
 		const contents = await fs.readFile(sourcePath, "utf8");
@@ -374,4 +466,4 @@ async function pushSync(options) {
 }
 
 //#endregion
-export { planSync, pullSync, pushSync };
+export { planSync, pullSync, pushLocalMachineLinks, pushSync };

package/dist/{transport-C0eTgNNu.mjs → transport-C8UTS3Fa.mjs}

@@ -1,7 +1,7 @@
 //#region src/clientUtils.ts
 const jsonResultFormats = new Set([
 	"digraph",
-	"json",
+	"xstate-json",
 	"xgraph"
 ]);
 function createRequestId() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "bin": {
     "statelyai": "./dist/cli.mjs"
@@ -49,15 +49,20 @@
       "types": "./dist/api.d.mts",
       "import": "./dist/api.mjs"
     },
+    "./assetStorage": {
+      "types": "./dist/assetStorage.d.mts",
+      "import": "./dist/assetStorage.mjs"
+    },
     "./statelyai.schema.json": "./schemas/statelyai.schema.json",
-    "./schemas/statelyai.schema.json": "./schemas/statelyai.schema.json"
+    "./schemas/statelyai.schema.json": "./schemas/statelyai.schema.json",
+    "./xstate-json.schema.json": "./schemas/xstate-json.schema.json",
+    "./schemas/xstate-json.schema.json": "./schemas/xstate-json.schema.json"
   },
   "dependencies": {
     "@oclif/core": "^4.10.3",
     "@statelyai/graph": "^0.9.0",
     "typescript": "^5.9.3",
-    "xstate": "^5.0.0",
-    "@statelyai/graph-tools": "0.0.0"
+    "xstate": "^5.0.0"
   },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",

package/schemas/statelyai.schema.json

@@ -54,7 +54,7 @@
       "enum": [
         "auto",
         "xstate",
-        "json",
+        "xstate-json",
         "xgraph",
         "digraph",
         "mermaid",