@cargo-ai/cli 1.0.74 → 1.0.76

package/README.md

@@ -168,7 +168,7 @@ Deploy a draft release of an **existing** workflow. Two input modes share the sa
 # 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
+# Preview nodes + form fields without deploying
 cargo-ai orchestration release deploy-draft --file ./my-workflow.ts --dry-run
 
 # Pin an explicit version + description

package/build/commands/connection/integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuGN"}
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAwHN"}

package/build/commands/connection/integration.js

@@ -6,11 +6,12 @@ export function registerIntegrationCommands(parent, getApi) {
     integration
         .command("list")
         .description("List all integrations")
-        .option("--category <engagement|marketing|sales|finance|analytics|freeform|success|support|enrichment|storage|custom>", "Filter by category")
+        .option("--category <category>", "Filter by category (string)")
         .option("--slugs <list>", "Filter by integration slugs (comma-separated strings)")
         .option("--search <search>", "Search by name, case-insensitive (string)")
         .option("--has-actions <bool>", 'Filter by presence of actions (string: "true" or "false")')
         .option("--has-extractors <bool>", 'Filter by presence of extractors (string: "true" or "false")')
+        .option("--summary", "Only slug, name, and category — drops actions/schemas so pickers stay under the palette capture limit")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.connection.integration.list({
@@ -33,6 +34,19 @@ export function registerIntegrationCommands(parent, getApi) {
                     ? false
                     : undefined,
         }));
+        // Full `integration.list` is multi-megabyte (every action schema). The
+        // palette captures at most 2MB; without this trim, JSON truncates and
+        // the picker silently falls back to free text.
+        if (opts.summary === true) {
+            outputJson({
+                integrations: result.integrations.map((integration) => ({
+                    slug: integration.slug,
+                    name: integration.name,
+                    category: integration.category,
+                })),
+            });
+            return;
+        }
         outputJson(result);
     });
     integration

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAiBxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAoK7E"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAiBxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAqK7E"}

package/build/commands/orchestration/node.js

@@ -12,8 +12,9 @@ Use these commands to inspect or debug the node graph of a workflow. To just
 run a tool or connector action, no workflow needed, use instead:
   $ cargo-ai orchestration action execute --action '<json>' --data '<json>'
 
-'diagram', 'compute' and 'validate' are free and run nothing. 'execute' is not
-a dry run: it performs the node's real action and consumes credits.
+'diagram', 'compute' and 'validate' are free and run nothing.
+'execute' is not a dry run: it performs the node's real action and consumes
+credits.
 
 Before deploying a graph:
   $ cargo-ai orchestration node validate --nodes '<json>'

package/build/commands/orchestration/nodeDiagram.d.ts

@@ -15,6 +15,10 @@ export type DiagramNode = {
     childrenUuids?: (string | null)[] | null;
     fallbackChildUuid?: string | null;
     config?: Record<string, unknown> | null;
+    position?: {
+        x?: number;
+        y?: number;
+    } | null;
 };
 export type DiagramOptions = {
     title?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"nodeDiagram.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/nodeDiagram.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodeDiagram.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/nodeDiagram.ts"],"names":[],"mappings":"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"}

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;AAoCxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAgLN"}
+{"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;AAoCxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAkLN"}

package/build/commands/orchestration/release.js

@@ -1,3 +1,4 @@
+import { layoutWorkflowNodes, parseWorkflowLayoutNodes, } from "@cargo-ai/utils/workflow-layout";
 import { parseBooleanOption } from "../../utils/booleanOption.js";
 import { loadCompiledWorkflow, } from "../../utils/loadCompiledWorkflow.js";
 import { ExitCodes, failWith, handleApiCall, info, outputJson, parseJson, success, } from "../runHandler.js";
@@ -61,12 +62,13 @@ export function registerReleaseCommands(parent, getApi) {
         .option("--options <json>", "Options (JSON object)")
         .action(async (opts) => {
         const api = getApi();
+        const nodes = opts.nodes !== undefined
+            ? await layoutOrFail(parseJson(opts.nodes, "--nodes"))
+            : undefined;
         const result = await handleApiCall(() => api.orchestration.draftRelease.update({
             workflowUuid: opts.workflowUuid,
             parentUuid: opts.parentUuid,
-            nodes: opts.nodes !== undefined
-                ? parseJson(opts.nodes, "--nodes")
-                : undefined,
+            nodes,
             testRecords: opts.testRecords !== undefined
                 ? parseJson(opts.testRecords, "--test-records")
                 : undefined,
@@ -122,11 +124,13 @@ async function runJsonDeploy(getApi, opts) {
     const workflowUuid = opts.workflowUuid;
     const nodesJson = opts.nodes;
     const formFieldsJson = opts.formFields;
+    const parsedNodes = parseJson(nodesJson, "--nodes");
+    const nodes = await layoutOrFail(parsedNodes);
     const api = getApi();
     const result = await handleApiCall(() => api.orchestration.draftRelease.deploy({
         workflowUuid,
         version: opts.version,
-        nodes: parseJson(nodesJson, "--nodes"),
+        nodes: nodes,
         formFields: formFieldsJson === "null"
             ? null
             : parseJson(formFieldsJson, "--form-fields"),
@@ -153,10 +157,11 @@ async function runFileDeploy(getApi, opts) {
         failWith("--form-fields is not allowed with --file (sourced from the module)", { code: ExitCodes.InvalidUsage });
     }
     const compiled = await loadCompiledWorkflow(opts.file);
+    const nodes = await layoutOrFail(compiled.nodes);
     if (opts.dryRun === true) {
         outputJson({
             slug: compiled.slug,
-            nodes: compiled.nodes,
+            nodes,
             formFields: compiled.formFields,
         });
         return;
@@ -166,11 +171,11 @@ async function runFileDeploy(getApi, opts) {
     const version = opts.version !== undefined
         ? opts.version
         : await computeNextVersion(api, workflowUuid);
-    info(`Deploying "${compiled.slug}" → workflow ${workflowUuid} as v${version} (${String(compiled.nodes.length)} node(s))…`);
+    info(`Deploying "${compiled.slug}" → workflow ${workflowUuid} as v${version} (${String(nodes.length)} node(s))…`);
     const payload = {
         workflowUuid,
         version,
-        nodes: compiled.nodes,
+        nodes: nodes,
         formFields: compiled.formFields,
         description: opts.description,
         options: opts.options !== undefined
@@ -181,6 +186,16 @@ async function runFileDeploy(getApi, opts) {
     success(`Deployed v${version}.`);
     outputJson(result);
 }
+async function layoutOrFail(value) {
+    try {
+        return (await layoutWorkflowNodes(parseWorkflowLayoutNodes(value), {
+            nested: "recursive",
+        }));
+    }
+    catch (error) {
+        failWith(`layout failed: ${error instanceof Error ? error.message : String(error)}`, { code: ExitCodes.InvalidUsage });
+    }
+}
 // 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

package/build/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { availableCodingAgents, BRAND, canRunPalette, cdkProjectRoot, declareSources, fetchCreditsLeft, fetchWorkspaceName, formatWorkspaceSuffix, isInteractive, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
+import { availableCodingAgents, BRAND, canRunPalette, cdkProjectDir, cdkProjectRoot, declareSources, fetchCreditsLeft, fetchWorkspaceName, formatWorkspaceSuffix, isInteractive, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
 import { Command } from "commander";
 import { AGENT_SKILLS_HINT } from "./agentSkills.js";
 import { createApi } from "./api.js";
@@ -125,10 +125,12 @@ const getApi = () => {
 };
 // Where the palette finds answers for an option that wants an id. Keyed by the
 // flag, because `--model-uuid` asks the same question in all 28 places it
-// appears; these six entries cover the 84 uuid options this CLI declares.
+// appears; the uuid entries cover the 84 uuid options this CLI declares, and
+// the integration-slug entries cover every catalog-slug flag the same way.
 //
-// Nobody knows a uuid. Every one of these replaces a field you would otherwise
-// have to leave the palette to fill.
+// Nobody knows a uuid — and few people remember every integration slug. Every
+// one of these replaces a field you would otherwise have to leave the palette
+// to fill.
 declareSources({
     // A workflow row carries a uuid, two timestamps and a toolUuid — nothing to
     // choose between. The plays and tools that own those workflows carry a name
@@ -173,6 +175,35 @@ declareSources({
     "--segment-uuid": [
         { argv: ["segmentation", "segment", "list"], value: "uuid", label: "name" },
     ],
+    // Integration slugs are the catalog names (`hubspot`, `linkedin`) — same
+    // question for `--integration-slug`, the shorter `--integration` filters,
+    // and span filters keyed on the node. `--summary` is required: the full
+    // list is multi-megabyte and exceeds the palette's capture limit, which
+    // truncates JSON and falls back to a free-text prompt.
+    "--integration-slug": [
+        {
+            argv: ["connection", "integration", "list", "--summary"],
+            value: "slug",
+            label: "name",
+            hint: "slug",
+        },
+    ],
+    "--integration": [
+        {
+            argv: ["connection", "integration", "list", "--summary"],
+            value: "slug",
+            label: "name",
+            hint: "slug",
+        },
+    ],
+    "--node-integration-slug": [
+        {
+            argv: ["connection", "integration", "list", "--summary"],
+            value: "slug",
+            label: "name",
+            hint: "slug",
+        },
+    ],
 });
 const binPath = process.argv[1] === undefined ? "cargo-ai" : process.argv[1];
 // First, so it is the first row of the palette: for someone signed in, this is
@@ -231,11 +262,23 @@ async function openPalette(startPath) {
     // Re-read after each command: signing in or out from inside the palette
     // changes both what the setup line says and which rows are worth pinning.
     // The cwd is re-tested too — a command can create a project in it.
-    const rebuildLayout = () => buildPaletteLayout({
-        signedIn: isSignedIn(),
-        agents,
-        cdkProjectRoot: cdkProjectRoot(process.cwd()),
-    });
+    const rebuildLayout = () => {
+        // Read once: a layout describing two different directories could offer to
+        // deploy one and name the other.
+        const cwd = process.cwd();
+        const root = cdkProjectRoot(cwd);
+        return buildPaletteLayout({
+            signedIn: isSignedIn(),
+            agents,
+            cdkProjectRoot: root,
+            // Resolved from the root, never the cwd. `cdkProjectDir` looks *down* for
+            // `infra/` rather than walking up, and a scaffolded `infra/` carries no
+            // package.json to be recognised by — so asked from inside one it answers
+            // undefined, and `deploy` would fall back to the root it must not use.
+            cdkProjectDir: root === undefined ? undefined : cdkProjectDir(root),
+            cwd,
+        });
+    };
     await runPalette({
         program,
         binPath,

package/build/paletteLayout.d.ts

@@ -4,6 +4,22 @@ export type PaletteLayoutInput = {
     agents: readonly CodingAgent[];
     /** The CDK repo root the palette is standing in, or undefined when none. */
     cdkProjectRoot: string | undefined;
+    /**
+     * The directory holding the CDK project — `infra/` for a scaffolded repo, or
+     * the same as `cdkProjectRoot` for a hand-rolled layout. Commands that load
+     * the resource tree and state (`cdk deploy`) need this, not the repo root.
+     *
+     * Resolve it from `cdkProjectRoot` rather than from `cwd`: `cdkProjectDir`
+     * looks down for `infra/` instead of walking up, so from inside one it
+     * answers undefined.
+     */
+    cdkProjectDir: string | undefined;
+    /**
+     * Where the palette is standing. The project rows are resolved by walking
+     * *up* from here, so this is what says whether they point at the directory
+     * on screen or one somewhere above it.
+     */
+    cwd: string;
 };
 export declare function buildPaletteLayout(input: PaletteLayoutInput): PaletteLayout;
 /**

package/build/paletteLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAsE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CA+CjE"}
+{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAwE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CA4CjE"}

package/build/paletteLayout.js

@@ -7,16 +7,19 @@
 // most often wants, a coding agent briefed on their workspace, two screens
 // down behind `start`. This is the missing opinion, kept in one place and as
 // data, so it can be read and tested rather than inferred from a menu.
+import { basename, relative, resolve } from "node:path";
 /** Pinned row values. The leading space keeps them out of the command namespace. */
 const SIGN_IN = " sign-in";
 const DEMO = " demo";
 const CODE = " code";
-const ADD_COOKBOOK = " add-cookbook";
+const ADD = " add";
+const DEPLOY = " deploy";
 /**
  * `start` runs most of these; the pinned row is the shortcut to one of them.
- * The exception is "Add a cookbook", which runs `cdk add` directly: it is not
- * a `start` destination, because it needs neither the sign-in step nor a
- * choice of where to carry on — you are already in the project.
+ * The exceptions are "Add" and "Deploy", which run `cdk add` and `cdk deploy`
+ * directly: neither is a `start` destination, because neither needs the sign-in
+ * step nor a choice of where to carry on — you are already in the project. Bare
+ * `cdk add` asks connector vs cookbook, then shows that kind's list.
  */
 const ENTRANCE = "start";
 /**
@@ -95,24 +98,27 @@ export function pinnedRows(input) {
             },
         ];
     }
-    // Inside a CDK project, "Add a cookbook" is more useful than "Set up as
-    // code" — the project already exists. Outside, scaffold one.
-    const cdkRow = input.cdkProjectRoot !== undefined
-        ? {
-            value: ADD_COOKBOOK,
-            label: "Add a cookbook",
-            hint: "install a worked pipeline into this project",
-            // `--dir` because `cdk add` refuses a directory with no
-            // package.json, and the palette is as often open in `infra/` — where
-            // the scaffold's README sends people — as at the root.
-            argv: ["cdk", "add", "--dir", input.cdkProjectRoot],
-        }
-        : {
-            value: CODE,
-            label: "Set up as code",
-            hint: "scaffold a CDK project",
-            argv: [ENTRANCE, "--continue", "code"],
-        };
+    // Inside a CDK project the rows are the loop somebody is actually in — add a
+    // resource, deploy it — and the guided demo is not part of it: it is the tour
+    // for a workspace you have not built yet, and this one is open on screen.
+    // Outside, there is no project to add to or deploy, so offer the tour and the
+    // scaffold instead.
+    const projectRows = input.cdkProjectRoot !== undefined
+        ? cdkRows(input.cdkProjectRoot, input.cdkProjectDir, input.cwd)
+        : [
+            {
+                value: DEMO,
+                label: "Guided demo",
+                hint: "companies, then the people, for your ICP",
+                argv: [ENTRANCE, "--continue", "demo"],
+            },
+            {
+                value: CODE,
+                label: "Set up as code",
+                hint: "scaffold a CDK project",
+                argv: [ENTRANCE, "--continue", "code"],
+            },
+        ];
     return [
         ...input.agents.map((agent) => ({
             value: ` agent:${agent.bin}`,
@@ -120,12 +126,49 @@ export function pinnedRows(input) {
             hint: "briefed on this workspace",
             argv: [ENTRANCE, "--continue", agent.bin],
         })),
+        ...projectRows,
+    ];
+}
+/** The two rows for a palette standing in the CDK project rooted at `root`. */
+function cdkRows(root, projectDir, cwd) {
+    // `cdk deploy` loads the resource tree and `cargo.state.json` from the
+    // directory it runs in, so it needs the CDK project — `infra/` in a
+    // scaffolded repo — where `add` takes the root and resolves that itself.
+    const target = projectDir !== undefined ? projectDir : root;
+    return [
+        {
+            value: ADD,
+            label: "Add",
+            hint: "a connector or a cookbook into this project",
+            // `--dir` because `cdk add` refuses a directory with no package.json,
+            // and the palette is as often open in `infra/` — where the scaffold's
+            // README sends people — as at the root.
+            argv: ["cdk", "add", "--dir", root],
+        },
         {
-            value: DEMO,
-            label: "Guided demo",
-            hint: "companies, then the people, for your ICP",
-            argv: [ENTRANCE, "--continue", "demo"],
+            value: DEPLOY,
+            label: "Deploy",
+            // Name the directory whenever it is not the one on screen. The project is
+            // found by walking *up*, so this row can target a project the cwd gives no
+            // sign of — and it mutates a live workspace, which in a repo holding more
+            // than one project is worth saying out loud before it is picked.
+            hint: resolve(target) === resolve(cwd)
+                ? "this project to your workspace"
+                : `${projectName(target, root)}/ to your workspace`,
+            // No `--yes`: `deploy` shows the plan and asks, which is the point of
+            // reaching it from a menu.
+            argv: ["cdk", "deploy", "--dir", target],
         },
-        cdkRow,
     ];
 }
+/**
+ * A short name for the CDK project directory: where it sits inside the repo
+ * (`infra`), or the repo's own directory name when it *is* the repo root.
+ *
+ * `relative` answers "" for two equal paths — the hand-rolled layout that keeps
+ * its resources at the root — and "" is not a name anybody can read.
+ */
+function projectName(dir, root) {
+    const within = relative(root, dir);
+    return within === "" ? basename(root) : within;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.74",
+  "version": "1.0.76",
   "private": false,
   "license": "UNLICENSED",
   "homepage": "https://getcargo.ai",
@@ -66,8 +66,9 @@
   "dependencies": {
     "@cargo-ai/api": "^1.0.71",
     "@cargo-ai/app-sdk": "^1.0.9",
-    "@cargo-ai/cdk": "^1.0.60",
-    "@cargo-ai/types": "^1.0.66",
+    "@cargo-ai/cdk": "^1.0.61",
+    "@cargo-ai/types": "^1.0.68",
+    "@cargo-ai/utils": "^1.0.28",
     "@cargo-ai/worker-sdk": "^1.0.17",
     "@modelcontextprotocol/sdk": "1.29.0",
     "commander": "^12.1.0",