@statelyai/sdk 0.9.0 → 0.10.0

package/README.md

@@ -21,6 +21,6 @@ The broader in-progress package documentation draft is kept in:
 Published schemas:
 
 - `@statelyai/sdk/statelyai.schema.json`
-- `@statelyai/sdk/xstate-json.schema.json`
+- `@statelyai/sdk/xstate.schema.json`
 
-The CLI-facing `statelyai.json` schema now uses top-level `include` / `exclude` globs for local file discovery.
+The CLI-facing `statelyai.json` schema now uses top-level `include` / `exclude` globs for local file discovery, plus `newMachineDir` for pulling remote-only project machines into new local files.

package/dist/{graph-CJ3N2r43.d.mts → graph-DmXh22Zu.d.mts}

@@ -1,6 +1,256 @@
 import * as _statelyai_graph0 from "@statelyai/graph";
 import { Graph } from "@statelyai/graph";
 
+//#region ../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts
+// ==================================================================================================
+// JSON Schema Draft 07
+// ==================================================================================================
+// https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
+// --------------------------------------------------------------------------------------------------
+/**
+ * Primitive type
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
+ */
+type JSONSchema7TypeName = "string" //
+| "number" | "integer" | "boolean" | "object" | "array" | "null";
+/**
+ * Primitive type
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
+ */
+type JSONSchema7Type = string //
+| number | boolean | JSONSchema7Object | JSONSchema7Array | null;
+// Workaround for infinite type recursion
+interface JSONSchema7Object {
+  [key: string]: JSONSchema7Type;
+}
+// Workaround for infinite type recursion
+// https://github.com/Microsoft/TypeScript/issues/3496#issuecomment-128553540
+interface JSONSchema7Array extends Array<JSONSchema7Type> {}
+/**
+ * Meta schema
+ *
+ * Recommended values:
+ * - 'http://json-schema.org/schema#'
+ * - 'http://json-schema.org/hyper-schema#'
+ * - 'http://json-schema.org/draft-07/schema#'
+ * - 'http://json-schema.org/draft-07/hyper-schema#'
+ *
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-5
+ */
+type JSONSchema7Version = string;
+/**
+ * JSON Schema v7
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
+ */
+type JSONSchema7Definition = JSONSchema7 | boolean;
+interface JSONSchema7 {
+  $id?: string | undefined;
+  $ref?: string | undefined;
+  $schema?: JSONSchema7Version | undefined;
+  $comment?: string | undefined;
+  /**
+   * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-8.2.4
+   * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#appendix-A
+   */
+  $defs?: {
+    [key: string]: JSONSchema7Definition;
+  } | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1
+   */
+  type?: JSONSchema7TypeName | JSONSchema7TypeName[] | undefined;
+  enum?: JSONSchema7Type[] | undefined;
+  const?: JSONSchema7Type | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.2
+   */
+  multipleOf?: number | undefined;
+  maximum?: number | undefined;
+  exclusiveMaximum?: number | undefined;
+  minimum?: number | undefined;
+  exclusiveMinimum?: number | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.3
+   */
+  maxLength?: number | undefined;
+  minLength?: number | undefined;
+  pattern?: string | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.4
+   */
+  items?: JSONSchema7Definition | JSONSchema7Definition[] | undefined;
+  additionalItems?: JSONSchema7Definition | undefined;
+  maxItems?: number | undefined;
+  minItems?: number | undefined;
+  uniqueItems?: boolean | undefined;
+  contains?: JSONSchema7Definition | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.5
+   */
+  maxProperties?: number | undefined;
+  minProperties?: number | undefined;
+  required?: string[] | undefined;
+  properties?: {
+    [key: string]: JSONSchema7Definition;
+  } | undefined;
+  patternProperties?: {
+    [key: string]: JSONSchema7Definition;
+  } | undefined;
+  additionalProperties?: JSONSchema7Definition | undefined;
+  dependencies?: {
+    [key: string]: JSONSchema7Definition | string[];
+  } | undefined;
+  propertyNames?: JSONSchema7Definition | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.6
+   */
+  if?: JSONSchema7Definition | undefined;
+  then?: JSONSchema7Definition | undefined;
+  else?: JSONSchema7Definition | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.7
+   */
+  allOf?: JSONSchema7Definition[] | undefined;
+  anyOf?: JSONSchema7Definition[] | undefined;
+  oneOf?: JSONSchema7Definition[] | undefined;
+  not?: JSONSchema7Definition | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-7
+   */
+  format?: string | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-8
+   */
+  contentMediaType?: string | undefined;
+  contentEncoding?: string | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-9
+   */
+  definitions?: {
+    [key: string]: JSONSchema7Definition;
+  } | undefined;
+  /**
+   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-10
+   */
+  title?: string | undefined;
+  description?: string | undefined;
+  default?: JSONSchema7Type | undefined;
+  readOnly?: boolean | undefined;
+  writeOnly?: boolean | undefined;
+  examples?: JSONSchema7Type | undefined;
+}
+//#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 src/digraphTypes.d.ts
 type CanvasColor = undefined | 'green' | 'red' | 'purple' | 'blue' | 'orange' | 'yellow' | 'pink' | 'teal';
 type ExtractorGuard = {
@@ -306,7 +556,7 @@ interface StatelyGuard {
 interface StatelyInvoke {
   src: string;
   id: string;
-  input?: Record<string, unknown>;
+  input?: Record<string, unknown> | CodeExpression;
 }
 interface StatelyNodeData {
   key: string;
@@ -390,4 +640,4 @@ declare function toStudioMachine(graph: StatelyGraph): StudioMachine;
 declare function fromStudioMachine(studioMachine: StudioMachine): StatelyGraph;
 declare const studioMachineConverter: _statelyai_graph0.GraphFormatConverter<DigraphConfig, StatelyNodeData, StatelyEdgeData, StatelyGraphData>;
 //#endregion
-export { EventTypeData as C, DigraphNodeConfig as S, studioMachineConverter as _, StatelyGraphData as a, DigraphConfig as b, StatelyInvoke as c, StudioAction as d, StudioEdge as f, fromStudioMachine as g, StudioNode as h, StatelyGraph as i, StatelyNodeData as l, StudioMachine as m, StatelyActorImplementation as n, StatelyGuard as o, StudioEventTypeData as p, StatelyEdgeData as r, StatelyImplementation as s, StatelyAction as t, StatelyTagImplementation as u, toStudioMachine as v, StateNodeJSONData as w, DigraphEdgeConfig as x, DigraphAction as y };
+export { EventTypeData as C, JSONSchema7 as E, DigraphNodeConfig as S, CodeGenGraph as T, studioMachineConverter as _, StatelyGraphData as a, DigraphConfig as b, StatelyInvoke as c, StudioAction as d, StudioEdge as f, fromStudioMachine as g, StudioNode as h, StatelyGraph as i, StatelyNodeData as l, StudioMachine as m, StatelyActorImplementation as n, StatelyGuard as o, StudioEventTypeData as p, StatelyEdgeData as r, StatelyImplementation as s, StatelyAction as t, StatelyTagImplementation as u, toStudioMachine as v, StateNodeJSONData as w, DigraphEdgeConfig as x, DigraphAction as y };

package/dist/graph.d.mts

@@ -1,2 +1,2 @@
-import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-CJ3N2r43.mjs";
+import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-DmXh22Zu.mjs";
 export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createS
 import { CommentsConfig, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.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-CJ3N2r43.mjs";
+import { C as EventTypeData, E as JSONSchema7, S as DigraphNodeConfig, T as CodeGenGraph, _ 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-DmXh22Zu.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-BLlM3qKf.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 { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
@@ -31,256 +31,6 @@ 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 ../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts
-// ==================================================================================================
-// JSON Schema Draft 07
-// ==================================================================================================
-// https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
-// --------------------------------------------------------------------------------------------------
-/**
- * Primitive type
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
- */
-type JSONSchema7TypeName = "string" //
-| "number" | "integer" | "boolean" | "object" | "array" | "null";
-/**
- * Primitive type
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
- */
-type JSONSchema7Type = string //
-| number | boolean | JSONSchema7Object | JSONSchema7Array | null;
-// Workaround for infinite type recursion
-interface JSONSchema7Object {
-  [key: string]: JSONSchema7Type;
-}
-// Workaround for infinite type recursion
-// https://github.com/Microsoft/TypeScript/issues/3496#issuecomment-128553540
-interface JSONSchema7Array extends Array<JSONSchema7Type> {}
-/**
- * Meta schema
- *
- * Recommended values:
- * - 'http://json-schema.org/schema#'
- * - 'http://json-schema.org/hyper-schema#'
- * - 'http://json-schema.org/draft-07/schema#'
- * - 'http://json-schema.org/draft-07/hyper-schema#'
- *
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-5
- */
-type JSONSchema7Version = string;
-/**
- * JSON Schema v7
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
- */
-type JSONSchema7Definition = JSONSchema7 | boolean;
-interface JSONSchema7 {
-  $id?: string | undefined;
-  $ref?: string | undefined;
-  $schema?: JSONSchema7Version | undefined;
-  $comment?: string | undefined;
-  /**
-   * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-8.2.4
-   * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#appendix-A
-   */
-  $defs?: {
-    [key: string]: JSONSchema7Definition;
-  } | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1
-   */
-  type?: JSONSchema7TypeName | JSONSchema7TypeName[] | undefined;
-  enum?: JSONSchema7Type[] | undefined;
-  const?: JSONSchema7Type | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.2
-   */
-  multipleOf?: number | undefined;
-  maximum?: number | undefined;
-  exclusiveMaximum?: number | undefined;
-  minimum?: number | undefined;
-  exclusiveMinimum?: number | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.3
-   */
-  maxLength?: number | undefined;
-  minLength?: number | undefined;
-  pattern?: string | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.4
-   */
-  items?: JSONSchema7Definition | JSONSchema7Definition[] | undefined;
-  additionalItems?: JSONSchema7Definition | undefined;
-  maxItems?: number | undefined;
-  minItems?: number | undefined;
-  uniqueItems?: boolean | undefined;
-  contains?: JSONSchema7Definition | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.5
-   */
-  maxProperties?: number | undefined;
-  minProperties?: number | undefined;
-  required?: string[] | undefined;
-  properties?: {
-    [key: string]: JSONSchema7Definition;
-  } | undefined;
-  patternProperties?: {
-    [key: string]: JSONSchema7Definition;
-  } | undefined;
-  additionalProperties?: JSONSchema7Definition | undefined;
-  dependencies?: {
-    [key: string]: JSONSchema7Definition | string[];
-  } | undefined;
-  propertyNames?: JSONSchema7Definition | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.6
-   */
-  if?: JSONSchema7Definition | undefined;
-  then?: JSONSchema7Definition | undefined;
-  else?: JSONSchema7Definition | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.7
-   */
-  allOf?: JSONSchema7Definition[] | undefined;
-  anyOf?: JSONSchema7Definition[] | undefined;
-  oneOf?: JSONSchema7Definition[] | undefined;
-  not?: JSONSchema7Definition | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-7
-   */
-  format?: string | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-8
-   */
-  contentMediaType?: string | undefined;
-  contentEncoding?: string | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-9
-   */
-  definitions?: {
-    [key: string]: JSONSchema7Definition;
-  } | undefined;
-  /**
-   * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-10
-   */
-  title?: string | undefined;
-  description?: string | undefined;
-  default?: JSONSchema7Type | undefined;
-  readOnly?: boolean | undefined;
-  writeOnly?: boolean | undefined;
-  examples?: JSONSchema7Type | undefined;
-}
-//#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;

package/dist/protocol.d.mts

@@ -1,5 +1,5 @@
 //#region src/protocol.d.ts
-type EmbedMode = 'editing' | 'viewing' | 'simulating' | 'inspecting';
+type EmbedMode = "editing" | "viewing" | "simulating" | "inspecting";
 interface CommentsConfig {
   roomId: string;
   userId?: string | null;
@@ -15,7 +15,7 @@ interface ProjectEmbedMachine {
 interface ValidationIssue {
   nodeIds: string[];
   edgeIds: string[];
-  level: 'info' | 'warning' | 'error';
+  level: "info" | "warning" | "error";
   message: string;
 }
 interface SourceRange {
@@ -30,12 +30,12 @@ interface SourceLocation {
 }
 interface StateSourceLocation extends SourceLocation {
   path: string[];
-  kind: 'inline' | 'objectReference' | 'createStateConfig';
+  kind: "inline" | "objectReference" | "createStateConfig";
   symbol?: string;
   keyRange?: SourceRange;
   referenceRange?: SourceRange;
   keySource?: {
-    kind: 'const' | 'enumMember' | 'computedLiteral';
+    kind: "const" | "enumMember" | "computedLiteral";
     symbol?: string;
     valueRange?: SourceRange;
     machineLocal?: boolean;
@@ -60,7 +60,11 @@ interface ExportFormatMap {
     };
     result: string;
   };
-  'xstate-json': {
+  async: {
+    options: object;
+    result: string;
+  };
+  "xstate-json": {
     options: {
       version?: 4 | 5;
     };
@@ -86,11 +90,11 @@ interface ExportFormatMap {
     options: object;
     result: string;
   };
-  'asl-json': {
+  "asl-json": {
     options: object;
     result: string;
   };
-  'asl-yaml': {
+  "asl-yaml": {
     options: object;
     result: string;
   };
@@ -100,7 +104,7 @@ interface ExportFormatMap {
   };
 }
 type ExportFormat = keyof ExportFormatMap;
-type ExportCallOptions<F extends ExportFormat> = ExportFormatMap[F]['options'] & {
+type ExportCallOptions<F extends ExportFormat> = ExportFormatMap[F]["options"] & {
   timeout?: number;
 };
 interface EmbedEventMap {
@@ -145,7 +149,7 @@ interface MachineInitOptions {
   machine: unknown;
   format?: string;
   mode?: EmbedMode;
-  theme?: 'light' | 'dark';
+  theme?: "light" | "dark";
   readOnly?: boolean;
   depth?: number;
   panels?: {
@@ -169,14 +173,14 @@ interface MachineInitOptions {
    */
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: 'structural' | 'all';
+    mode?: "structural" | "all";
   };
 }
 interface ProjectInitOptions {
   machines: ProjectEmbedMachine[];
   currentMachineId?: string;
   mode?: EmbedMode;
-  theme?: 'light' | 'dark';
+  theme?: "light" | "dark";
   readOnly?: boolean;
   depth?: number;
   panels?: {
@@ -187,16 +191,16 @@ interface ProjectInitOptions {
   commentsByMachineId?: Record<string, CommentsConfig>;
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: 'structural' | 'all';
+    mode?: "structural" | "all";
   };
 }
 type InitOptions = MachineInitOptions | ProjectInitOptions;
 interface InitMessage {
-  type: '@statelyai.init';
+  type: "@statelyai.init";
   machine: unknown;
   format?: string;
   mode?: EmbedMode;
-  theme?: 'light' | 'dark';
+  theme?: "light" | "dark";
   readOnly?: boolean;
   depth?: number;
   leftPanels?: string[];
@@ -207,17 +211,17 @@ interface InitMessage {
   /** Mirror of `InitOptions.unsavedIndicator`. */
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: 'structural' | 'all';
+    mode?: "structural" | "all";
   };
   /** Optional session id override (multiplexed clients only). */
   sessionId?: string;
 }
 interface ProjectInitMessage {
-  type: '@statelyai.project.init';
+  type: "@statelyai.project.init";
   machines: ProjectEmbedMachine[];
   currentMachineId?: string;
   mode?: EmbedMode;
-  theme?: 'light' | 'dark';
+  theme?: "light" | "dark";
   readOnly?: boolean;
   depth?: number;
   leftPanels?: string[];
@@ -226,51 +230,51 @@ interface ProjectInitMessage {
   commentsByMachineId?: Record<string, CommentsConfig>;
   unsavedIndicator?: {
     enabled?: boolean;
-    mode?: 'structural' | 'all';
+    mode?: "structural" | "all";
   };
   sessionId?: string;
 }
 interface ProjectUpdateMessage {
-  type: '@statelyai.project.update';
+  type: "@statelyai.project.update";
   machines: ProjectEmbedMachine[];
   currentMachineId?: string;
   commentsByMachineId?: Record<string, CommentsConfig>;
 }
 interface ProjectSelectMachineMessage {
-  type: '@statelyai.project.selectMachine';
+  type: "@statelyai.project.selectMachine";
   machineId: string;
 }
 interface UpdateMessage {
-  type: '@statelyai.update';
+  type: "@statelyai.update";
   machine: unknown;
   format?: string;
   sourceLocations?: MachineSourceLocations;
 }
 interface SetModeMessage {
-  type: '@statelyai.setMode';
+  type: "@statelyai.setMode";
   mode: EmbedMode;
 }
 interface SetThemeMessage {
-  type: '@statelyai.setTheme';
-  theme: 'light' | 'dark';
+  type: "@statelyai.setTheme";
+  theme: "light" | "dark";
 }
 interface SetSettingsMessage {
-  type: '@statelyai.setSettings';
+  type: "@statelyai.setSettings";
   settings: Record<string, unknown>;
 }
 interface RetrieveMessage {
-  type: '@statelyai.retrieve';
+  type: "@statelyai.retrieve";
   requestId: string;
   format: ExportFormat;
   options?: Record<string, unknown>;
 }
 interface ToastMessage {
-  type: '@statelyai.toast';
+  type: "@statelyai.toast";
   message: string;
-  toastType?: 'success' | 'error' | 'info' | 'warning';
+  toastType?: "success" | "error" | "info" | "warning";
 }
 interface InspectSnapshotMessage {
-  type: '@statelyai.inspectSnapshot';
+  type: "@statelyai.inspectSnapshot";
   snapshot: unknown;
   event: unknown | null;
   /**
@@ -293,13 +297,13 @@ interface ActorSystemEntry {
   snapshot?: unknown;
 }
 interface SystemInitMessage {
-  type: '@statelyai.system.init';
+  type: "@statelyai.system.init";
   /** All known actors at the moment the system is first streamed. */
   actors: ActorSystemEntry[];
   /** Actor id the viz should focus first. Defaults to the root. */
   selectedActorId?: string;
   mode?: EmbedMode;
-  theme?: 'light' | 'dark';
+  theme?: "light" | "dark";
   readOnly?: boolean;
   depth?: number;
   leftPanels?: string[];
@@ -309,7 +313,7 @@ interface SystemInitMessage {
 }
 /** A new actor joined the system after init. */
 interface SystemActorRegisteredMessage {
-  type: '@statelyai.system.actorRegistered';
+  type: "@statelyai.system.actorRegistered";
   actorId: string;
   parentActorId: string | null;
   id: string;
@@ -318,7 +322,7 @@ interface SystemActorRegisteredMessage {
 }
 /** An actor's snapshot updated. */
 interface SystemActorSnapshotMessage {
-  type: '@statelyai.system.actorSnapshot';
+  type: "@statelyai.system.actorSnapshot";
   actorId: string;
   snapshot: unknown;
   event?: unknown | null;
@@ -327,21 +331,21 @@ interface SystemActorSnapshotMessage {
 }
 /** An actor reached a final state / was stopped. */
 interface SystemActorStoppedMessage {
-  type: '@statelyai.system.actorStopped';
+  type: "@statelyai.system.actorStopped";
   actorId: string;
 }
 interface ReadyMessage {
-  type: '@statelyai.ready';
+  type: "@statelyai.ready";
   version: string;
 }
 interface LoadedMessage {
-  type: '@statelyai.loaded';
+  type: "@statelyai.loaded";
   graph: unknown;
   machineId?: string;
   sourceLocations?: MachineSourceLocations;
 }
 interface ChangeMessage {
-  type: '@statelyai.change';
+  type: "@statelyai.change";
   graph: unknown;
   machineConfig: unknown;
   machineId?: string;
@@ -349,7 +353,7 @@ interface ChangeMessage {
   sourceLocations?: MachineSourceLocations;
 }
 interface SaveMessage {
-  type: '@statelyai.save';
+  type: "@statelyai.save";
   graph: unknown;
   machineConfig: unknown;
   machineId?: string;
@@ -358,16 +362,16 @@ interface SaveMessage {
   sourceLocations?: MachineSourceLocations;
 }
 interface ProjectMachineSelectedMessage {
-  type: '@statelyai.project.machineSelected';
+  type: "@statelyai.project.machineSelected";
   machineId: string;
 }
 interface RetrievedMessage {
-  type: '@statelyai.retrieved';
+  type: "@statelyai.retrieved";
   requestId: string;
   data: unknown;
 }
 interface ErrorMessage {
-  type: '@statelyai.error';
+  type: "@statelyai.error";
   code: string;
   message: string;
   requestId?: string;
@@ -394,21 +398,21 @@ interface UploadResult {
 }
 /** Viz requests the parent to upload a file. */
 interface UploadRequestMessage {
-  type: '@statelyai.uploadRequest';
+  type: "@statelyai.uploadRequest";
   requestId: string;
   file: UploadFileInfo;
   stateNodeId: string;
 }
 /** Parent tells the viz the upload capabilities on init. */
 interface UploadCapabilitiesMessage {
-  type: '@statelyai.uploadCapabilities';
+  type: "@statelyai.uploadCapabilities";
   enabled: boolean;
   accept?: string[];
   maxFileSize?: number;
 }
 /** Parent sends the upload result back to the viz. */
 interface UploadResponseMessage {
-  type: '@statelyai.uploadResponse';
+  type: "@statelyai.uploadResponse";
   requestId: string;
   result: UploadResult;
 }
@@ -417,8 +421,8 @@ type ClientMessage = InitMessage | ProjectInitMessage | ProjectUpdateMessage | P
 /** All messages the viz can send back to a client. */
 type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | UploadRequestMessage;
 interface RegisterMessage {
-  type: '@statelyai.register';
-  role: 'client' | 'viz';
+  type: "@statelyai.register";
+  role: "client" | "viz";
   sessionId: string;
   metadata?: {
     name?: string;
@@ -426,11 +430,11 @@ interface RegisterMessage {
   };
 }
 interface RegisteredMessage {
-  type: '@statelyai.registered';
+  type: "@statelyai.registered";
   sessionId: string;
 }
 interface RequestOpenMessage {
-  type: '@statelyai.requestOpen';
+  type: "@statelyai.requestOpen";
   sessionId: string;
 }
 /**
@@ -445,7 +449,7 @@ interface RequestOpenMessage {
  *      the root to target a specific session (falls back to primary).
  */
 interface AddSessionMessage {
-  type: '@statelyai.addSession';
+  type: "@statelyai.addSession";
   sessionId: string;
   metadata?: {
     name?: string;
@@ -454,7 +458,7 @@ interface AddSessionMessage {
 }
 /** Relay → client: acknowledgement that a session was added. */
 interface SessionAddedMessage {
-  type: '@statelyai.sessionAdded';
+  type: "@statelyai.sessionAdded";
   sessionId: string;
 }
 /** All session-management messages for the WS relay. */

package/dist/sync.d.mts

@@ -1,4 +1,4 @@
-import { b as DigraphConfig, i as StatelyGraph } from "./graph-CJ3N2r43.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-DmXh22Zu.mjs";
 import { CreateProjectInput, ProjectData, StudioClient, StudioMachineRecord, XStateVersion } from "./studio.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
@@ -45,6 +45,7 @@ interface PushSyncProjectOptions extends CreateProjectInput {
 interface PushSyncOptions extends Omit<PlanSyncOptions, 'target'> {
   project?: PushSyncProjectOptions;
   xstateVersion?: XStateVersion;
+  relink?: boolean;
 }
 interface PushSyncResult {
   source: ResolvedSyncInput;

package/dist/sync.mjs

@@ -586,10 +586,15 @@ function offsetAtRangePosition(text, line, character) {
 	return text.length;
 }
 
+//#endregion
+//#region ../graph-tools/src/codegenTypes.ts
+const INLINE_EXPRESSION_DIRECTIVE_FIELDS = ["input", "output"];
+
 //#endregion
 //#region src/sync.ts
 const execFileAsync = promisify(execFile);
 const MAX_CAPTURED_LOCAL_MACHINES = 100;
+const INLINE_EXPRESSION_FIELD_SET = new Set(INLINE_EXPRESSION_DIRECTIVE_FIELDS);
 async function extractMachinesFromLocalSource(sourcePath, contents) {
 	try {
 		return { machines: extractMachineConfigsFromAst(sourcePath, parseSourceToMachine(contents, createTextDocument(sourcePath, contents), { resolver: createFileSourceDocumentResolver() })) };
@@ -704,7 +709,12 @@ function evaluateExpression(expression, sourceFile, bindings, seenBindings) {
 			if (!ts.isPropertyAssignment(property)) continue;
 			const key = resolvePropertyNameValue(property.name, sourceFile, bindings, seenBindings);
 			if (key == null) continue;
-			result[String(key)] = evaluateExpression(property.initializer, sourceFile, bindings, seenBindings);
+			const fieldName = String(key);
+			if (shouldPreserveInlineExpression(fieldName, property.initializer, sourceFile, bindings, seenBindings)) {
+				result[fieldName] = createInlineExpressionDirective(property.initializer.getText(sourceFile));
+				continue;
+			}
+			result[fieldName] = evaluateExpression(property.initializer, sourceFile, bindings, seenBindings);
 		}
 		return result;
 	}
@@ -728,6 +738,26 @@ function evaluateExpression(expression, sourceFile, bindings, seenBindings) {
 	}
 	return unwrapped.getText(sourceFile);
 }
+function shouldPreserveInlineExpression(fieldName, expression, sourceFile, bindings, seenBindings) {
+	if (!INLINE_EXPRESSION_FIELD_SET.has(fieldName)) return false;
+	const unwrapped = unwrapExpression(expression);
+	if (ts.isIdentifier(unwrapped)) {
+		const binding = bindings.get(unwrapped.text);
+		if (!binding || binding.kind !== "value" || seenBindings.has(unwrapped.text)) return true;
+		const nextSeen = new Set(seenBindings);
+		nextSeen.add(unwrapped.text);
+		return shouldPreserveInlineExpression(fieldName, binding.expression, sourceFile, bindings, nextSeen);
+	}
+	if (ts.isStringLiteral(unwrapped) || ts.isNoSubstitutionTemplateLiteral(unwrapped) || ts.isNumericLiteral(unwrapped) || unwrapped.kind === ts.SyntaxKind.TrueKeyword || unwrapped.kind === ts.SyntaxKind.FalseKeyword || unwrapped.kind === ts.SyntaxKind.NullKeyword || ts.isObjectLiteralExpression(unwrapped) || ts.isArrayLiteralExpression(unwrapped)) return false;
+	return unwrapped.getText(sourceFile).trim().length > 0;
+}
+function createInlineExpressionDirective(expr) {
+	return {
+		"@type": "code",
+		lang: "ts",
+		expr
+	};
+}
 function resolvePropertyNameValue(name, sourceFile, bindings, seenBindings) {
 	if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) return name.text;
 	if (!ts.isComputedPropertyName(name)) return null;
@@ -990,7 +1020,7 @@ async function pushLocalMachineLinks(options) {
 			});
 			continue;
 		}
-		if (attachment.pragma?.id) {
+		if (attachment.pragma?.id && !options.relink) {
 			const updatedMachine = await client.machines.update({
 				id: attachment.pragma.id,
 				definition: toStudioMachine(fromXStateConfig(extractedMachine.config))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "MIT",
   "files": [
     "dist",
@@ -52,8 +52,10 @@
     },
     "./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"
+    "./xstate.schema.json": "./schemas/xstate.schema.json",
+    "./schemas/xstate.schema.json": "./schemas/xstate.schema.json",
+    "./xstate-json.schema.json": "./schemas/xstate.schema.json",
+    "./schemas/xstate-json.schema.json": "./schemas/xstate.schema.json"
   },
   "dependencies": {
     "@statelyai/graph": "^0.9.0",

package/schemas/statelyai.schema.json

@@ -46,6 +46,11 @@
       "items": {
         "$ref": "#/$defs/globPattern"
       }
+    },
+    "newMachineDir": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Directory, relative to statelyai.json, where statelyai pull should create new local files for remote-only project machines."
     }
   },
   "$defs": {
@@ -63,7 +68,8 @@
       "studioUrl": "https://stately.ai",
       "defaultXStateVersion": 5,
       "include": ["src/**/*.ts", "src/**/*.tsx"],
-      "exclude": ["**/*.test.ts", "**/*.spec.ts"]
+      "exclude": ["**/*.test.ts", "**/*.spec.ts"],
+      "newMachineDir": "src/machines"
     }
   ]
 }

package/schemas/{xstate-json.schema.json → xstate.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://stately.ai/schemas/xstate-json.json",
+  "$id": "https://stately.ai/schemas/xstate.json",
   "title": "XState JSON machine config",
   "description": "Strict JSON subset of an XState machine config that can be passed to createMachine(config). Shorthand string forms are normalized to object and array forms.",
   "$ref": "#/$defs/machineConfig",