statelyai 0.12.8 → 0.14.0

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 import { Command } from "@oclif/core";
+import { XGraph } from "@statelyai/mcp/loop";
 import { z } from "zod";
+import { ConnectedRepo, CreateProjectInput, LegacyProjectVisibility, OAuthAuthorizationServerMetadata, OAuthProtectedResourceMetadata, ProjectData, ProjectMachineSummary, ProjectVisibility, StudioClient } from "@statelyai/sdk";
 import { StatelyGraph } from "@statelyai/sdk/graph";
-import { ConnectedRepo, CreateProjectInput, OAuthAuthorizationServerMetadata, OAuthProtectedResourceMetadata, ProjectData, ProjectMachineSummary, StudioClient } from "@statelyai/sdk";
 import * as _oclif_core_interfaces0 from "@oclif/core/interfaces";
 
 //#region src/verifyCommand.d.ts
@@ -9,6 +10,10 @@ declare class VerifyCommand extends Command {
   static enableJsonFlag: boolean;
   static summary: string;
   static description: string;
+  static args: {
+    proposal: _oclif_core_interfaces0.Arg<string | undefined, Record<string, unknown>>;
+    regenerated: _oclif_core_interfaces0.Arg<string | undefined, Record<string, unknown>>;
+  };
   static flags: {
     model: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
     bindings: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
@@ -22,6 +27,104 @@ declare class VerifyCommand extends Command {
   run(): Promise<void>;
 }
 //#endregion
+//#region src/link.d.ts
+interface LinkProjectOptions {
+  cwd?: string;
+  configPath?: string;
+  apiKey?: string;
+  baseUrl?: string;
+  client?: StudioClient;
+  projectId?: string;
+  create?: boolean;
+  name?: string;
+  visibility?: ProjectVisibility | LegacyProjectVisibility;
+  force?: boolean;
+  file?: string;
+  machineId?: string;
+  machineIndex?: number;
+}
+declare function resourceId(locator: string, kind: 'project' | 'machine'): string;
+/** Association only: no definitions are uploaded, downloaded, or executed. */
+declare function linkProject(options: LinkProjectOptions): Promise<{
+  project: ProjectData;
+  config: {
+    projectId: string;
+    studioUrl: string;
+    $schema: string;
+    version: string;
+    defaultXStateVersion: number;
+    sourceUpdateStrategy?: "preserve" | "rewrite";
+    include: string[];
+    exclude?: string[];
+    newMachinesDir?: string;
+    storage?: "local" | "hosted";
+  };
+  configPath: string;
+  machineId: string | undefined;
+  filePath: string | undefined;
+}>;
+//#endregion
+//#region src/loopCommands.d.ts
+/**
+ * Offline loop commands over XGraph JSON files and the repository's
+ * `.statelyai/` store. No authentication or network access.
+ */
+type Report = {
+  text: string;
+  exitCode: number;
+};
+/** An XGraph file, or a `.statelyai` head or version file (its `graph`). */
+declare function readGraphFile(file: string): Promise<XGraph>;
+/** `statelyai changes`: change lines and the proposed flow outline, base -> proposed. */
+declare function changesReport(baseFile: string, proposedFile: string, json?: boolean): Promise<Report>;
+/** `statelyai verify <proposal> <regenerated>`: behavior verdict; 1 on drift, 2 when unavailable. */
+declare function verifyReport(proposalFile: string, regeneratedFile: string, json?: boolean): Promise<Report>;
+/** `statelyai brief`: the Apply brief for a pending proposal in `.statelyai/`. */
+declare function briefReport(root: string, machineId: string, versionId: string, json?: boolean): Promise<Report>;
+/** `statelyai pending`: proposals in `.statelyai/` whose baseline is still the head. */
+declare function pendingReport(root: string, json?: boolean): Promise<Report>;
+declare abstract class ReportCommand extends Command {
+  static enableJsonFlag: boolean;
+  protected print(report: Promise<Report>): Promise<void>;
+}
+declare class ChangesCommand extends ReportCommand {
+  static summary: string;
+  static description: string;
+  static args: {
+    base: _oclif_core_interfaces0.Arg<string, Record<string, unknown>>;
+    proposed: _oclif_core_interfaces0.Arg<string, Record<string, unknown>>;
+  };
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+    json: _oclif_core_interfaces0.BooleanFlag<boolean>;
+  };
+  run(): Promise<void>;
+}
+declare class BriefCommand extends ReportCommand {
+  static summary: string;
+  static description: string;
+  static args: {
+    machine: _oclif_core_interfaces0.Arg<string, Record<string, unknown>>;
+  };
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+    proposal: _oclif_core_interfaces0.OptionFlag<string, _oclif_core_interfaces0.CustomOptions>;
+    root: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    json: _oclif_core_interfaces0.BooleanFlag<boolean>;
+  };
+  run(): Promise<void>;
+}
+declare class PendingCommand extends ReportCommand {
+  static summary: string;
+  static description: string;
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+    root: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    json: _oclif_core_interfaces0.BooleanFlag<boolean>;
+  };
+  run(): Promise<void>;
+}
+//#endregion
 //#region src/credentials.d.ts
 type StatelyCredential = {
   type: 'api_key';
@@ -59,6 +162,8 @@ interface StatelyProjectConfig {
   include: string[];
   exclude?: string[];
   newMachinesDir?: string;
+  /** `local` keeps MCP loop models and proposals in `.statelyai/` (read by `stately-mcp`). */
+  storage?: 'local' | 'hosted';
 }
 interface DiscoveredSourceFile {
   filePath: string;
@@ -71,7 +176,7 @@ declare function createStatelyProjectConfig(options: {
   defaultXStateVersion?: number;
 }): StatelyProjectConfig;
 //#endregion
-//#region ../../node_modules/.pnpm/@statelyai+graph@2.1.0_@statelyai+layout@0.4.2_cytoscape@3.34.0_d3-force@3.0.0_d3-hiera_48d6687797f6ba8a844c48e50eec3ae1/node_modules/@statelyai/graph/dist/types-BAEQTwK_.d.mts
+//#region ../../node_modules/.pnpm/@statelyai+graph@2.1.0_@statelyai+layout@0.4.3_cytoscape@3.34.0_d3-force@3.0.0_d3-hiera_2afdfa88fae2fa10712f99651d0f58d6/node_modules/@statelyai/graph/dist/types-BAEQTwK_.d.mts
 //#region src/types.d.ts
 /**
  * Directedness of a graph or an individual edge.
@@ -541,6 +646,25 @@ declare class OpenCommand extends Command {
   run(): Promise<void>;
 }
 declare function resolveOpenRootDir(cwd: string, fileArg?: string): string;
+declare class LinkCommand extends Command {
+  static summary: string;
+  static args: {
+    file: _oclif_core_interfaces0.Arg<string | undefined, Record<string, unknown>>;
+  };
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+    project: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    create: _oclif_core_interfaces0.BooleanFlag<boolean>;
+    name: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    visibility: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    machine: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    'machine-index': _oclif_core_interfaces0.OptionFlag<number | undefined, _oclif_core_interfaces0.CustomOptions>;
+    'base-url': _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    config: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    force: _oclif_core_interfaces0.BooleanFlag<boolean>;
+  };
+  run(): Promise<void>;
+}
 declare class InitCommand extends Command {
   static enableJsonFlag: boolean;
   static summary: string;
@@ -621,9 +745,13 @@ declare const COMMANDS: {
   scan: typeof ScanCommand;
   status: typeof StatusCommand;
   init: typeof InitCommand;
+  link: typeof LinkCommand;
   login: typeof LoginCommand;
   logout: typeof LogoutCommand;
   whoami: typeof WhoamiCommand;
+  changes: typeof ChangesCommand;
+  brief: typeof BriefCommand;
+  pending: typeof PendingCommand;
 };
 declare function run(argv?: string[], entryUrl?: string): Promise<void>;
 //#endregion
@@ -1545,4 +1673,4 @@ declare function verifyProject(options?: VerifyProjectOptions): Promise<{
 /** One case per recorded path/probe. Unattributed divergences remain separate cases. */
 declare function formatVerificationJUnit(report: VerificationRunReport): string;
 //#endregion
-export { ApiKeyResolution, COMMANDS, CredentialStatus, DiscoveredMachine, InitProjectOptions, InitProjectResult, LinkedPullTarget, OAuthLoginDiscovery, ProjectMachineStatus, ProjectStatusMachine, ProjectStatusResult, PushCandidateClassification, RemoteProjectMachineTarget, ResolveApiKeyOptions, ResolvedConfiguredPullTargets, ScanProjectSourcesOptions, type VerificationExecutor, type VerificationRequest, type VerificationRunReport, type VerifyProjectOptions, buildOAuthLoginStart, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveOpenRootDir, resolveProjectStatus, resolveVerificationRequest, run, scanProjectMachines, scanProjectSources, verifyProject };
+export { ApiKeyResolution, COMMANDS, CredentialStatus, DiscoveredMachine, InitProjectOptions, InitProjectResult, type LinkProjectOptions, LinkedPullTarget, OAuthLoginDiscovery, ProjectMachineStatus, ProjectStatusMachine, ProjectStatusResult, PushCandidateClassification, RemoteProjectMachineTarget, ResolveApiKeyOptions, ResolvedConfiguredPullTargets, ScanProjectSourcesOptions, type VerificationExecutor, type VerificationRequest, type VerificationRunReport, type VerifyProjectOptions, briefReport, buildOAuthLoginStart, changesReport, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, linkProject, pendingReport, readGraphFile, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveOpenRootDir, resolveProjectStatus, resolveVerificationRequest, resourceId, run, scanProjectMachines, scanProjectSources, verifyProject, verifyReport };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { C as run, D as verifyProject, E as resolveVerificationRequest, O as formatVerificationJUnit, S as resolveProjectStatus, T as scanProjectSources, _ as isFileGitDirty, a as discoverMachinesInSource, b as resolveCredentialStatus, c as formatDiscoveredMachines, d as formatProjectStatus, f as formatStoredCredentialSource, g as initProject, h as inferInitProjectName, i as discoverLinkedPullTargets, k as createStatelyProjectConfig, l as formatMissingNewMachineDirMessage, m as getEnvCredential, n as buildOAuthLoginStart, o as discoverOAuthLogin, p as getEnvApiKey, r as classifyPushCandidates, s as discoverRemoteProjectMachineTargets, t as COMMANDS, u as formatPlanSummary, v as resolveApiKey, w as scanProjectMachines, x as resolveOpenRootDir, y as resolveConfiguredPullTargets } from "./cli-B2Dd5vY-.mjs";
+import { A as formatVerificationJUnit, C as run, D as resourceId, E as linkProject, F as readGraphFile, I as verifyReport, M as briefReport, N as changesReport, O as resolveVerificationRequest, P as pendingReport, S as resolveProjectStatus, T as scanProjectSources, _ as isFileGitDirty, a as discoverMachinesInSource, b as resolveCredentialStatus, c as formatDiscoveredMachines, d as formatProjectStatus, f as formatStoredCredentialSource, g as initProject, h as inferInitProjectName, i as discoverLinkedPullTargets, j as createStatelyProjectConfig, k as verifyProject, l as formatMissingNewMachineDirMessage, m as getEnvCredential, n as buildOAuthLoginStart, o as discoverOAuthLogin, p as getEnvApiKey, r as classifyPushCandidates, s as discoverRemoteProjectMachineTargets, t as COMMANDS, u as formatPlanSummary, v as resolveApiKey, w as scanProjectMachines, x as resolveOpenRootDir, y as resolveConfiguredPullTargets } from "./cli-BtgsQvTR.mjs";
 
-export { COMMANDS, buildOAuthLoginStart, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveOpenRootDir, resolveProjectStatus, resolveVerificationRequest, run, scanProjectMachines, scanProjectSources, verifyProject };
+export { COMMANDS, briefReport, buildOAuthLoginStart, changesReport, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, linkProject, pendingReport, readGraphFile, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveOpenRootDir, resolveProjectStatus, resolveVerificationRequest, resourceId, run, scanProjectMachines, scanProjectSources, verifyProject, verifyReport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statelyai",
-  "version": "0.12.8",
+  "version": "0.14.0",
   "description": "Command-line tools for Stately",
   "license": "MIT",
   "bin": {
@@ -24,14 +24,15 @@
     "typescript": "^5.9.3",
     "ws": "^8.21.0",
     "zod": "^4.4.1",
-    "@statelyai/sdk": "0.38.2"
+    "@statelyai/mcp": "0.17.1",
+    "@statelyai/sdk": "0.39.0"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
-    "@statelyai/api-contract": "0.6.3",
-    "@statelyai/editor-sync": "0.1.51"
+    "@statelyai/api-contract": "0.7.0",
+    "@statelyai/editor-sync": "0.2.1"
   },
   "oclif": {
     "bin": "statelyai",