@cargo-ai/cli 1.0.18 → 1.0.20

package/README.md

@@ -98,25 +98,55 @@ cargo-ai orchestration workflow --help
 
 ### Domains and example commands
 
-| Domain                   | Description                                                | Example commands                                                                                                              |
-| ------------------------ | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| **init**                 | Workspace initialisation (user, workspace, datasets, etc.) | `cargo-ai init`                                                                                                               |
-| **orchestration**        | Workflows, plays, runs, batches, tools, templates          | `cargo-ai orchestration workflow list`, `cargo-ai orchestration run list --workflow-uuid <uuid>`                              |
-| **workspaceManagement**  | Workspaces, users, tokens, roles, folders                  | `cargo-ai workspaceManagement workspaces list`, `cargo-ai workspaceManagement token list`                                     |
-| **storage**              | Datasets, models, relationships, runs, records             | `cargo-ai storage dataset list`, `cargo-ai storage model list`                                                                |
-| **connection**           | Connectors and integrations                                | `cargo-ai connection connector list`, `cargo-ai connection integration list`                                                  |
-| **billing**              | Usage and subscription                                     | `cargo-ai billing subscription get`, `cargo-ai billing usage get-metrics --payload '{"from":"2025-01-01","to":"2025-01-31"}'` |
-| **segmentation**         | Segments and changes                                       | `cargo-ai segmentation segment list`, `cargo-ai segmentation change list --payload '{}'`                                      |
-| **revenue-organization** | Allocations, capacities, members, territories              | `cargo-ai revenue-organization member list`, `cargo-ai revenue-organization territory list`                                   |
-| **expression**           | Recipes and expression evaluation                          | `cargo-ai expression recipe list`, `cargo-ai expression eval evaluate --payload '{}'`                                         |
-| **system-of-record**     | System of record, client, logs                             | `cargo-ai system-of-record sor list`, `cargo-ai system-of-record log list --payload '{}'`                                     |
-| **user-management**      | Current user (no workspace context)                        | `cargo-ai user-management user get-current`                                                                                   |
-| **ai**                   | AI templates, agents, releases, chats, MCP, files          | `cargo-ai ai template list`, `cargo-ai ai agent list`, `cargo-ai ai file list`                                                |
-| **context**              | Context repository, runtime sandbox, and knowledge graph   | `cargo-ai context repository get`, `cargo-ai context runtime browse --path <path>`, `cargo-ai context graph get`              |
-| **hosting**              | Cargo Hosting apps (Vite SPAs), workers, and deployments   | `cargo-ai hosting app list`, `cargo-ai hosting worker list`, `cargo-ai hosting deployment list --payload '{}'`                |
+| Domain                   | Description                                                   | Example commands                                                                                                              |
+| ------------------------ | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| **init**                 | Workspace initialisation (user, workspace, datasets, etc.)    | `cargo-ai init`                                                                                                               |
+| **orchestration**        | Workflows, plays, runs, batches, tools, templates             | `cargo-ai orchestration workflow list`, `cargo-ai orchestration run list --workflow-uuid <uuid>`                              |
+| **workspaceManagement**  | Workspaces, users, tokens, roles, folders                     | `cargo-ai workspaceManagement workspaces list`, `cargo-ai workspaceManagement token list`                                     |
+| **storage**              | Datasets, models, relationships, runs, records                | `cargo-ai storage dataset list`, `cargo-ai storage model list`                                                                |
+| **connection**           | Connectors and integrations                                   | `cargo-ai connection connector list`, `cargo-ai connection integration list`                                                  |
+| **billing**              | Usage and subscription                                        | `cargo-ai billing subscription get`, `cargo-ai billing usage get-metrics --payload '{"from":"2025-01-01","to":"2025-01-31"}'` |
+| **segmentation**         | Segments and changes                                          | `cargo-ai segmentation segment list`, `cargo-ai segmentation change list --payload '{}'`                                      |
+| **revenue-organization** | Allocations, capacities, members, territories                 | `cargo-ai revenue-organization member list`, `cargo-ai revenue-organization territory list`                                   |
+| **expression**           | Recipes and expression evaluation                             | `cargo-ai expression recipe list`, `cargo-ai expression eval evaluate --payload '{}'`                                         |
+| **system-of-record**     | System of record, client, logs                                | `cargo-ai system-of-record sor list`, `cargo-ai system-of-record log list --payload '{}'`                                     |
+| **user-management**      | Current user (no workspace context)                           | `cargo-ai user-management user get-current`                                                                                   |
+| **ai**                   | AI templates, agents, releases, chats, MCP, files             | `cargo-ai ai template list`, `cargo-ai ai agent list`, `cargo-ai ai file list`                                                |
+| **context**              | Context repository, runtime sandbox, and knowledge graph      | `cargo-ai context repository get`, `cargo-ai context runtime browse --path <path>`, `cargo-ai context graph get`              |
+| **hosting**              | Cargo Hosting apps (Vite SPAs), workers, and deployments      | `cargo-ai hosting app list`, `cargo-ai hosting worker list`, `cargo-ai hosting deployment list --payload '{}'`                |
+| **workflow**             | Workflow SDK developer tools: per-workspace type sync/codegen | `cargo-ai workflow sync` (SDK deploy lives at `cargo-ai orchestration release deploy-draft --file <path>`)                    |
 
 Commands that accept complex payloads use a `--payload <json>` option (e.g. `cargo-ai orchestration play create --payload '{"name":"My Play",...}'`). Use `--help` on any subcommand for options.
 
+### `orchestration release deploy-draft`
+
+Deploy a draft release of an **existing** workflow. Two input modes share the same command:
+
+```bash
+# Compile a Workflow SDK module and deploy it
+cargo-ai orchestration release deploy-draft --file ./my-workflow.ts
+
+# Preview the compiled nodes + form fields without deploying
+cargo-ai orchestration release deploy-draft --file ./my-workflow.ts --dry-run
+
+# Pin an explicit version + description
+cargo-ai orchestration release deploy-draft --file ./my-workflow.ts --workflow-uuid <uuid> --version 2.0.0 --description "New enrichment path"
+
+# Power-user path: deploy raw wire-format JSON
+cargo-ai orchestration release deploy-draft --workflow-uuid <uuid> --nodes '[…]' --form-fields '[…]'
+```
+
+`--file <path>` loads a [`@cargo-ai/workflow-sdk`](../workflow-sdk/README.md) module (its `export default defineWorkflow(...)`) and sources `nodes` / `formFields` / `description` from the compiled output. With `--file`:
+
+- `--workflow-uuid` is optional — when omitted, the command best-effort matches the compiled `slug` against existing workflows' `template.slug` and errors if the match is missing or ambiguous.
+- `--version` defaults to the next minor bump over the latest existing release (or `1.0.0` for the first).
+- `--description` defaults to the compiled workflow's description.
+- `--nodes` / `--form-fields` are rejected (they're sourced from the module).
+
+Without `--file`, `--workflow-uuid`, `--nodes`, and `--form-fields` are all required (raw JSON path). Constraint either way: there is **no** workflow-create endpoint, so the target workflow must already exist.
+
+Other release verbs (`list`, `get <uuid>`, `get-deployed`, `get-draft`, `update-draft`) live under the same group — see `cargo-ai orchestration release --help`.
+
 ## Agent Skills
 
 [Cargo Skills](https://github.com/getcargohq/cargo-skills) teaches AI coding agents (Claude Code, Cursor, Windsurf, GitHub Copilot, etc.) how to use the Cargo CLI. Install the skill to let your agent build, run, and manage revenue automation workflows programmatically:

package/build/commands/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAexC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAkB3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAcxC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAiB3E"}

package/build/commands/ai/index.js

@@ -1,7 +1,6 @@
 import { registerAgentCommands } from "./agent.js";
 import { registerChatCommands } from "./chat.js";
 import { registerDocumentCommands } from "./document.js";
-import { registerFileCommands } from "./file.js";
 import { registerMcpClientCommands } from "./mcpClient.js";
 import { registerMcpServerCommands } from "./mcpServer.js";
 import { registerMemoryCommands } from "./memory.js";
@@ -14,13 +13,12 @@ import { registerVoteCommands } from "./vote.js";
 export function registerAiCommands(parent, getApi) {
     const ai = parent
         .command("ai")
-        .description("AI templates, agents, releases, chats, MCP, files");
+        .description("AI templates, agents, releases, chats, MCP");
     registerTemplateCommands(ai, getApi);
     registerAgentCommands(ai, getApi);
     registerReleaseCommands(ai, getApi);
     registerChatCommands(ai, getApi);
     registerMcpServerCommands(ai, getApi);
-    registerFileCommands(ai, getApi);
     registerMessageCommands(ai, getApi);
     registerVoteCommands(ai, getApi);
     registerDocumentCommands(ai, getApi);

package/build/commands/content/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/commands/content/file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAkF7E"}

package/build/commands/{ai → content}/file.js

@@ -2,13 +2,13 @@ import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
 import { handleApiCall, outputJson } from "../runHandler.js";
 export function registerFileCommands(parent, getApi) {
-    const file = parent.command("file").description("AI file operations");
+    const file = parent.command("file").description("Storage file operations");
     file
         .command("list")
-        .description("List all AI files")
+        .description("List all workspace files")
         .action(async () => {
         const api = getApi();
-        const result = await handleApiCall(() => api.ai.file.all());
+        const result = await handleApiCall(() => api.content.file.all());
         outputJson(result);
     });
     file
@@ -16,7 +16,7 @@ export function registerFileCommands(parent, getApi) {
         .description("Get file by UUID")
         .action(async (uuid) => {
         const api = getApi();
-        const result = await handleApiCall(() => api.ai.file.get(uuid));
+        const result = await handleApiCall(() => api.content.file.get(uuid));
         outputJson(result);
     });
     file
@@ -27,7 +27,7 @@ export function registerFileCommands(parent, getApi) {
         .option("--folder-uuid <uuid>", "Folder UUID")
         .action(async (opts) => {
         const api = getApi();
-        const result = await handleApiCall(() => api.ai.file.update({
+        const result = await handleApiCall(() => api.content.file.update({
             uuid: opts.uuid,
             name: opts.name,
             folderUuid: opts.folderUuid,
@@ -39,7 +39,7 @@ export function registerFileCommands(parent, getApi) {
         .description("Remove a file")
         .action(async (uuid) => {
         const api = getApi();
-        await handleApiCall(() => api.ai.file.remove(uuid));
+        await handleApiCall(() => api.content.file.remove(uuid));
         outputJson({ ok: true });
     });
     file
@@ -53,7 +53,7 @@ export function registerFileCommands(parent, getApi) {
         const fileObj = new File([buffer], name);
         const api = getApi();
         await handleApiCall(() => new Promise((resolve, reject) => {
-            api.ai.file.upload({
+            api.content.file.upload({
                 file: fileObj,
                 folderUuid: opts.folderUuid,
                 onProgress: (pct) => {

package/build/commands/content/index.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { Api } from "../../api.js";
+export declare function registerContentCommands(parent: Command, getApi: () => Api): void;
+//# sourceMappingURL=index.d.ts.map

package/build/commands/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAON"}

package/build/commands/content/index.js

@@ -0,0 +1,9 @@
+import { registerFileCommands } from "./file.js";
+import { registerLibraryCommands } from "./library.js";
+export function registerContentCommands(parent, getApi) {
+    const content = parent
+        .command("content")
+        .description("Workspace files and libraries");
+    registerFileCommands(content, getApi);
+    registerLibraryCommands(content, getApi);
+}

package/build/commands/content/library.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { Api } from "../../api.js";
+export declare function registerLibraryCommands(parent: Command, getApi: () => Api): void;
+//# sourceMappingURL=library.d.ts.map

package/build/commands/content/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../src/commands/content/library.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAwGN"}

package/build/commands/content/library.js

@@ -0,0 +1,78 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+export function registerLibraryCommands(parent, getApi) {
+    const library = parent
+        .command("library")
+        .description("Storage library operations");
+    library
+        .command("list")
+        .description("List workspace libraries")
+        .option("--connector-uuid <uuid>", "Filter by connector UUID")
+        .option("--kind <kind>", "Filter by kind (native or connector)")
+        .action(async (opts) => {
+        const api = getApi();
+        const kind = opts.kind === "connector" || opts.kind === "native"
+            ? opts.kind
+            : undefined;
+        const result = await handleApiCall(() => api.content.library.list({
+            connectorUuid: opts.connectorUuid,
+            kind,
+        }));
+        outputJson(result);
+    });
+    library
+        .command("get <uuid>")
+        .description("Get library by UUID")
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.content.library.get(uuid));
+        outputJson(result);
+    });
+    library
+        .command("create")
+        .description("Create a connector library")
+        .requiredOption("--name <name>", "Library name")
+        .requiredOption("--extractor-slug <slug>", "Unstructured extractor slug")
+        .requiredOption("--connector-uuid <uuid>", "Connector UUID")
+        .option("--folder-uuid <uuid>", "Default folder UUID")
+        .option("--config <json>", "Library config JSON", "{}")
+        .action(async (opts) => {
+        const api = getApi();
+        const config = JSON.parse(opts.config);
+        const result = await handleApiCall(() => api.content.library.create({
+            name: opts.name,
+            extractorSlug: opts.extractorSlug,
+            connectorUuid: opts.connectorUuid,
+            folderUuid: opts.folderUuid,
+            config,
+        }));
+        outputJson(result);
+    });
+    library
+        .command("update")
+        .description("Update a library")
+        .requiredOption("--uuid <uuid>", "Library UUID")
+        .option("--name <name>", "Library name")
+        .option("--folder-uuid <uuid>", "Default folder UUID")
+        .option("--config <json>", "Library config JSON")
+        .action(async (opts) => {
+        const api = getApi();
+        const config = opts.config !== undefined
+            ? JSON.parse(opts.config)
+            : undefined;
+        const result = await handleApiCall(() => api.content.library.update({
+            uuid: opts.uuid,
+            name: opts.name,
+            folderUuid: opts.folderUuid,
+            config,
+        }));
+        outputJson(result);
+    });
+    library
+        .command("remove <uuid>")
+        .description("Remove a library")
+        .action(async (uuid) => {
+        const api = getApi();
+        await handleApiCall(() => api.content.library.remove(uuid));
+        outputJson({ ok: true });
+    });
+}

package/build/commands/orchestration/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAgBxC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAmBN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAexC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAkBN"}

package/build/commands/orchestration/index.js

@@ -1,6 +1,5 @@
 import { registerActionCommands } from "./action.js";
 import { registerBatchCommands } from "./batch.js";
-import { registerDraftReleaseCommands } from "./draftRelease.js";
 import { registerNodeCommands } from "./node.js";
 import { registerPlayCommands } from "./play.js";
 import { registerQueryCommands } from "./query.js";
@@ -24,7 +23,6 @@ export function registerOrchestrationCommands(parent, getApi) {
     registerSpanCommands(orchestration, getApi);
     registerTraceCommands(orchestration, getApi);
     registerReleaseCommands(orchestration, getApi);
-    registerDraftReleaseCommands(orchestration, getApi);
     registerToolCommands(orchestration, getApi);
     registerRecordCommands(orchestration, getApi);
     registerTemplateCommands(orchestration, getApi);

package/build/commands/orchestration/release.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA8DN"}
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/release.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAyCxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAkLN"}

package/build/commands/orchestration/release.js

@@ -1,8 +1,11 @@
-import { handleApiCall, outputJson } from "../runHandler.js";
+import { existsSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { ExitCodes, failWith, handleApiCall, info, outputJson, parseJson, success, } from "../runHandler.js";
 export function registerReleaseCommands(parent, getApi) {
     const release = parent
         .command("release")
-        .description("Manage workflow releases (list, get, get-deployed)");
+        .description("Manage workflow releases (list, get, get-deployed, get-draft, update-draft, deploy-draft)");
     release
         .command("list")
         .description("List releases")
@@ -37,4 +40,255 @@ export function registerReleaseCommands(parent, getApi) {
         }));
         outputJson(result);
     });
+    release
+        .command("get-draft")
+        .description("Get the draft release for a workflow")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.draftRelease.get({
+            workflowUuid: opts.workflowUuid,
+        }));
+        outputJson(result);
+    });
+    release
+        .command("update-draft")
+        .description("Update the draft release of a workflow")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
+        .option("--parent-uuid <uuid>", "Parent release UUID")
+        .option("--nodes <json>", "Nodes (JSON array of node definitions)")
+        .option("--test-records <json>", "Test records (JSON array)")
+        .option("--form-fields <json>", "Form fields (JSON array, or 'null')")
+        .option("--options <json>", "Options (JSON object)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.draftRelease.update({
+            workflowUuid: opts.workflowUuid,
+            parentUuid: opts.parentUuid,
+            nodes: opts.nodes !== undefined
+                ? parseJson(opts.nodes, "--nodes")
+                : undefined,
+            testRecords: opts.testRecords !== undefined
+                ? parseJson(opts.testRecords, "--test-records")
+                : undefined,
+            formFields: opts.formFields === "null"
+                ? null
+                : opts.formFields !== undefined
+                    ? parseJson(opts.formFields, "--form-fields")
+                    : undefined,
+            options: opts.options !== undefined
+                ? parseJson(opts.options, "--options")
+                : undefined,
+        }));
+        outputJson(result);
+    });
+    release
+        .command("deploy-draft")
+        .description("Deploy a draft release. Pass --file to compile a Workflow SDK module, or --nodes + --form-fields to deploy raw wire-format JSON.")
+        .option("--file <path>", "Path to a Workflow SDK module (its default export must be the compiled workflow returned by defineWorkflow()). When set, --nodes / --form-fields are sourced from the compiled output.")
+        .option("--workflow-uuid <uuid>", "Target workflow UUID. Required without --file; with --file, defaults to the existing workflow whose template.slug matches the compiled slug.")
+        .option("--version <version>", "Release version (e.g. '1.2.0'). With --file, defaults to the next minor bump over the latest existing release; otherwise required by the engine.")
+        .option("--nodes <json>", "Nodes (JSON array of node definitions). Required without --file; rejected with --file.")
+        .option("--form-fields <json>", "Form fields (JSON array, or 'null'). Required without --file; rejected with --file.")
+        .option("--description <text>", "Release description (with --file, defaults to the compiled workflow's description).")
+        .option("--options <json>", "Options (JSON object)")
+        .option("--dry-run", "With --file: compile and print the nodes + form fields without deploying. Ignored without --file.")
+        .action(async (opts) => {
+        if (opts.file !== undefined) {
+            await runFileDeploy(getApi, opts);
+            return;
+        }
+        await runJsonDeploy(getApi, opts);
+    });
+}
+// ---------- raw-JSON path (legacy `draft-release deploy`) ----------
+async function runJsonDeploy(getApi, opts) {
+    if (opts.workflowUuid === undefined) {
+        failWith("--workflow-uuid is required when --file is not set", {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    if (opts.nodes === undefined) {
+        failWith("--nodes is required when --file is not set", {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    if (opts.formFields === undefined) {
+        failWith("--form-fields is required when --file is not set", {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    // Pull required values into locals so the narrowing survives the closure
+    // we hand to `handleApiCall` below.
+    const workflowUuid = opts.workflowUuid;
+    const nodesJson = opts.nodes;
+    const formFieldsJson = opts.formFields;
+    const api = getApi();
+    const result = await handleApiCall(() => api.orchestration.draftRelease.deploy({
+        workflowUuid,
+        version: opts.version,
+        nodes: parseJson(nodesJson, "--nodes"),
+        formFields: formFieldsJson === "null"
+            ? null
+            : parseJson(formFieldsJson, "--form-fields"),
+        description: opts.description,
+        options: opts.options !== undefined
+            ? parseJson(opts.options, "--options")
+            : undefined,
+    }));
+    outputJson(result);
+}
+// ---------- SDK-file path (replaces `workflow deploy <file>`) ----------
+async function runFileDeploy(getApi, opts) {
+    if (opts.file === undefined) {
+        failWith("--file is required for SDK deploy", {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    if (opts.nodes !== undefined) {
+        failWith("--nodes is not allowed with --file (sourced from the module)", {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    if (opts.formFields !== undefined) {
+        failWith("--form-fields is not allowed with --file (sourced from the module)", { code: ExitCodes.InvalidUsage });
+    }
+    const compiled = await loadCompiledWorkflow(opts.file);
+    if (opts.dryRun === true) {
+        outputJson({
+            slug: compiled.slug,
+            description: compiled.description,
+            nodes: compiled.nodes,
+            formFields: compiled.formFields,
+        });
+        return;
+    }
+    const api = getApi();
+    const workflowUuid = await resolveWorkflowUuid(api, compiled, opts.workflowUuid);
+    const version = opts.version !== undefined
+        ? opts.version
+        : await computeNextVersion(api, workflowUuid);
+    const description = opts.description !== undefined ? opts.description : compiled.description;
+    info(`Deploying "${compiled.slug}" → workflow ${workflowUuid} as v${version} (${String(compiled.nodes.length)} node(s))…`);
+    const payload = {
+        workflowUuid,
+        version,
+        nodes: compiled.nodes,
+        formFields: compiled.formFields,
+        description,
+        options: opts.options !== undefined
+            ? parseJson(opts.options, "--options")
+            : undefined,
+    };
+    const result = await handleApiCall(() => api.orchestration.draftRelease.deploy(payload));
+    success(`Deployed v${version}.`);
+    outputJson(result);
+}
+// Load a workflow module via the tsx ESM loader so `.ts` sources (and their
+// imports of `@cargo-ai/workflow-sdk` / `zod`) are transpiled on the fly,
+// returning its default export validated as a compiled workflow.
+async function loadCompiledWorkflow(file) {
+    const absPath = isAbsolute(file) ? file : resolve(process.cwd(), file);
+    if (!existsSync(absPath)) {
+        failWith(`Workflow file not found: ${absPath}`, {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    let mod;
+    try {
+        const { tsImport } = await import("tsx/esm/api");
+        mod = (await tsImport(pathToFileURL(absPath).href, import.meta.url));
+    }
+    catch (error) {
+        failWith(`Failed to load workflow module: ${error instanceof Error ? error.message : String(error)}`, { code: ExitCodes.GenericError });
+    }
+    const candidate = resolveDefaultExport(mod);
+    if (!isCompiledWorkflow(candidate)) {
+        failWith("Workflow module must `export default` a compiled workflow (the value returned by defineWorkflow()).", { code: ExitCodes.InvalidUsage });
+    }
+    return candidate;
+}
+// Peel the extra interop layer tsx adds when a TS source is transpiled to
+// CJS: the ESM namespace's `default` is then the CJS `module.exports`
+// (`{ __esModule: true, default: … }`), so the real value lives one level
+// deeper. True-ESM modules expose it directly.
+function resolveDefaultExport(mod) {
+    const top = mod.default;
+    if (top !== null && typeof top === "object") {
+        const inner = top;
+        if (inner["__esModule"] === true && "default" in inner) {
+            return inner["default"];
+        }
+    }
+    return top;
+}
+function isCompiledWorkflow(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const v = value;
+    return (typeof v["slug"] === "string" &&
+        Array.isArray(v["nodes"]) &&
+        Array.isArray(v["formFields"]));
+}
+// Resolve the target workflow UUID. The platform `Workflow` has no free-form
+// slug field — the closest stable identifier is `template.slug` — and there
+// is no `workflow.create` endpoint, so an explicit `--workflow-uuid` always
+// wins and slug matching is a best-effort convenience over existing
+// workflows only.
+async function resolveWorkflowUuid(api, compiled, explicitUuid) {
+    if (explicitUuid !== undefined)
+        return explicitUuid;
+    const { workflows } = await handleApiCall(() => api.orchestration.workflow.all());
+    const matches = workflows.filter((w) => {
+        const template = w.template;
+        return (template !== null &&
+            template !== undefined &&
+            template.slug === compiled.slug);
+    });
+    if (matches.length === 1) {
+        const match = matches[0];
+        if (match !== undefined) {
+            info(`Matched workflow ${match.uuid} by slug "${compiled.slug}".`);
+            return match.uuid;
+        }
+    }
+    if (matches.length > 1) {
+        failWith(`Multiple workflows match slug "${compiled.slug}". Pass --workflow-uuid to disambiguate.`, {
+            code: ExitCodes.InvalidUsage,
+            extra: { candidates: matches.map((w) => w.uuid) },
+        });
+    }
+    failWith(`No workflow matched slug "${compiled.slug}". Create the workflow in the app first (there is no create endpoint), then deploy with --workflow-uuid <uuid>.`, { code: ExitCodes.NotFound });
+}
+// Derive the next release version by bumping the minor of the highest
+// existing semver, or `1.0.0` when there are no prior releases.
+async function computeNextVersion(api, workflowUuid) {
+    const { releases } = await handleApiCall(() => api.orchestration.release.list({ workflowUuid }));
+    let best;
+    for (const release of releases) {
+        const parsed = parseSemver(release.version);
+        if (parsed === undefined)
+            continue;
+        if (best === undefined || compareSemver(parsed, best) > 0) {
+            best = parsed;
+        }
+    }
+    if (best === undefined)
+        return "1.0.0";
+    return `${String(best[0])}.${String(best[1] + 1)}.0`;
+}
+function parseSemver(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(value.trim());
+    if (match === null)
+        return undefined;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function compareSemver(a, b) {
+    if (a[0] !== b[0])
+        return a[0] - b[0];
+    if (a[1] !== b[1])
+        return a[1] - b[1];
+    return a[2] - b[2];
 }

package/build/commands/storage/model.js

@@ -92,11 +92,11 @@ export function registerModelCommands(parent, getApi) {
         outputJson(result);
     });
     model
-        .command("sync <uuid>")
-        .description("Sync a model")
+        .command("refresh <uuid>")
+        .description("Refresh a model")
         .action(async (uuid) => {
         const api = getApi();
-        const result = await handleApiCall(() => api.storage.model.sync(uuid));
+        const result = await handleApiCall(() => api.storage.model.refresh(uuid));
         outputJson(result);
     });
     model

package/build/commands/workflow/index.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { Api } from "../../api.js";
+export declare function registerWorkflowCommands(parent: Command, getApi: () => Api): void;
+//# sourceMappingURL=index.d.ts.map

package/build/commands/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAMxC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAMN"}

package/build/commands/workflow/index.js

@@ -0,0 +1,10 @@
+import { registerSyncCommand } from "./sync.js";
+// SDK deploy lives under `cargo-ai orchestration release deploy-draft --file
+// <path>` (alongside the raw-JSON deploy path), so this group only ships the
+// `sync` developer tool today.
+export function registerWorkflowCommands(parent, getApi) {
+    const workflow = parent
+        .command("workflow")
+        .description("Workflow SDK developer tools (type sync, codegen)");
+    registerSyncCommand(workflow, getApi);
+}

package/build/commands/workflow/inputTypes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Fixed input shape of every agent node. Matches the SDK's `AgentInput`
+ * type and the engine's `AiUtils.agentConfig` schema.
+ */
+export declare const AGENT_INPUT_TYPE_SRC: string;
+/**
+ * Print an integration action's JSON Schema config as a TS input type.
+ * Returns `"Record<string, unknown>"` when the schema is missing or not an
+ * object schema we can render.
+ */
+export declare function printJsonSchemaInput(schema: unknown): string;
+/**
+ * Print a tool release's `formFields` as a TS input type. Returns
+ * `undefined` when the fields can't be interpreted (caller falls back to
+ * `Record<string, unknown>`).
+ */
+export declare function printFormFieldsInput(formFields: unknown): string | undefined;
+//# sourceMappingURL=inputTypes.d.ts.map

package/build/commands/workflow/inputTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputTypes.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/inputTypes.ts"],"names":[],"mappings":"AAgCA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAE+D,CAAC;AAEjG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAM5D;AAgGD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAU5E"}