@cargo-ai/cli 1.0.72 → 1.0.74

package/build/commands/connection/connector.js

@@ -1,5 +1,8 @@
+import { awaitBrowserStep, buildCliConnectorCreateUrl, buildCliConnectorEditUrl, isCodingAgent, openBrowser, resolveUserUuid, shouldWaitForPerson, } from "@cargo-ai/cdk/cli";
+import { getConfig } from "../../config.js";
 import { parseBooleanOption } from "../../utils/booleanOption.js";
-import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
+import { openPromptInput } from "../../utils/prompt.js";
+import { colors, ExitCodes, failWith, handleApiCall, info, outputJson, parseJson, } from "../runHandler.js";
 export function registerConnectorCommands(parent, getApi) {
     const connector = parent
         .command("connector")
@@ -46,7 +49,7 @@ export function registerConnectorCommands(parent, getApi) {
         .requiredOption("--slug <slug>", "Field slug to autocomplete (string, required)")
         .requiredOption("--params <json>", "Autocomplete parameters (JSON object, required)")
         .option("--value <value>", "Search value to filter results (string)")
-        .option("--refresh [value]", "Refresh cached results (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--refresh [true|false]", "Refresh cached results (defaults to true when passed bare)", parseBooleanOption)
         .option("--variables <json>", "Additional variables (JSON object)")
         .action(async (opts) => {
         const api = getApi();
@@ -79,39 +82,70 @@ export function registerConnectorCommands(parent, getApi) {
     });
     connector
         .command("create")
-        .description("Create a connector")
-        .requiredOption("--name <name>", "Connector name (string, required)")
-        .requiredOption("--slug <slug>", "Connector slug identifier (string, required)")
+        .description("Create a connector. Without --config, opens the hosted form in a browser and waits.")
+        .option("--name <name>", "Connector name (string, required with --config)")
+        .option("--slug <slug>", "Connector slug identifier (string, required with --config)")
         .requiredOption("--integration-slug <slug>", "Integration slug to connect to (string, required)")
-        .option("--config <json>", "Connector configuration (JSON object, shape depends on integration)")
+        .option("--config <json>", "Connector configuration (JSON object, shape depends on integration). Skips the browser.")
         .option("--rate-limit <json>", 'Rate limit configuration (JSON object). Shape: {"maxRequests": integer, "windowMs": integer}')
         .option("--cache-ttl-milliseconds <n>", "Cache TTL in milliseconds (integer)")
         .addHelpText("after", `
 Examples:
-  $ cargo-ai connection connector create --name "HubSpot" --slug hubspot-main --integration-slug hubspot
+  # Open the hosted form, wait, then write connectors/hubspot.ts and bind it
+  $ cargo-ai connection connector create --integration-slug hubspot
+
+  # Fully non-interactive — no browser
   $ cargo-ai connection connector create --name "HubSpot" --slug hubspot-main --integration-slug hubspot \\
-      --rate-limit '{"maxRequests":100,"windowMs":60000}' --cache-ttl-milliseconds 300000`)
+      --config '{"method":"privateApp","accessToken":"pat-..."}'
+  $ cargo-ai connection connector create --name "HubSpot" --slug hubspot-main --integration-slug hubspot \\
+      --config '{...}' --rate-limit '{"maxRequests":100,"windowMs":60000}' --cache-ttl-milliseconds 300000`)
         .action(async (opts) => {
         const api = getApi();
-        const result = await handleApiCall(() => api.connection.connector.create({
-            name: opts.name,
-            slug: opts.slug,
-            integrationSlug: opts.integrationSlug,
-            config: opts.config !== undefined
-                ? parseJson(opts.config, "--config")
-                : undefined,
-            rateLimit: opts.rateLimit !== undefined
+        // `--config` keeps the original, fully scriptable behaviour.
+        if (opts.config !== undefined) {
+            const rateLimit = opts.rateLimit !== undefined
                 ? parseJson(opts.rateLimit, "--rate-limit")
-                : undefined,
-            cacheTtlMilliseconds: opts.cacheTtlMilliseconds !== undefined
+                : undefined;
+            const cacheTtlMilliseconds = opts.cacheTtlMilliseconds !== undefined
                 ? parseInt(opts.cacheTtlMilliseconds, 10)
-                : undefined,
-        }));
-        outputJson(result);
+                : undefined;
+            const name = opts.name;
+            const slug = opts.slug;
+            if (name === undefined || slug === undefined) {
+                failWith("--name and --slug are required when --config is passed.", { code: ExitCodes.InvalidUsage });
+                return;
+            }
+            const config = parseJson(opts.config, "--config");
+            const result = await handleApiCall(() => api.connection.connector.create({
+                name,
+                slug,
+                integrationSlug: opts.integrationSlug,
+                config,
+                rateLimit,
+                cacheTtlMilliseconds,
+            }));
+            outputJson(result);
+            return;
+        }
+        const ignored = [
+            opts.name === undefined ? undefined : "--name",
+            opts.slug === undefined ? undefined : "--slug",
+            opts.rateLimit === undefined ? undefined : "--rate-limit",
+            opts.cacheTtlMilliseconds === undefined
+                ? undefined
+                : "--cache-ttl-milliseconds",
+        ].filter((flag) => flag !== undefined);
+        // The hosted form asks for all of these itself, so accepting them here
+        // and dropping them would silently produce a connector the caller did
+        // not describe.
+        if (ignored.length > 0) {
+            failWith(`${ignored.join(", ")} only applies with --config — the browser form asks for it.`, { code: ExitCodes.InvalidUsage });
+        }
+        await runCreateHandoff({ api, integrationSlug: opts.integrationSlug });
     });
     connector
         .command("update")
-        .description("Update a connector")
+        .description("Update a connector. With no field flags, opens the hosted form in a browser (use it to re-authorize).")
         .requiredOption("--uuid <uuid>", "Connector UUID")
         .option("--name <name>", "Connector name")
         .option("--config <json>", "Configuration (JSON object)")
@@ -119,6 +153,19 @@ Examples:
         .option("--cache-ttl-milliseconds <n>", "Cache TTL in milliseconds")
         .action(async (opts) => {
         const api = getApi();
+        // No field to change means "let me edit it in the form" — the only way
+        // to re-run an OAuth flow for an existing connector.
+        const hasFieldFlag = opts.name !== undefined ||
+            opts.config !== undefined ||
+            opts.rateLimit !== undefined ||
+            opts.cacheTtlMilliseconds !== undefined;
+        if (hasFieldFlag === false) {
+            // Re-auth changes credentials, not the binding: the CDK file already
+            // exists and binds by slug, so there is nothing to write and nothing
+            // to wait for. Open the form and get out of the way.
+            openConnectorEditForm(opts.uuid);
+            return;
+        }
         const result = await handleApiCall(() => api.connection.connector.update({
             uuid: opts.uuid,
             name: opts.name,
@@ -144,3 +191,79 @@ Examples:
         outputJson(result);
     });
 }
+/**
+ * Send the user to the connectors page, wait for them to confirm, then report
+ * the connector they made.
+ *
+ * Imperative only: it creates a connector and prints it. Writing
+ * `connectors/<slug>.ts` and binding cargo.state.json is
+ * `cargo-ai cdk add connector/<integration>`, so running this inside a repo
+ * never touches the repo.
+ */
+async function runCreateHandoff(input) {
+    const { api, integrationSlug } = input;
+    const url = buildCliConnectorCreateUrl({
+        ...resolveAppContext(),
+        integrationSlug,
+    });
+    // Nothing can drive a browser for an agent: hand back the URL and where to
+    // look once a human has clicked through. `openPromptInput` still finds
+    // `/dev/tty` when stdin is piped; `shouldWaitForPerson` additionally
+    // refuses coding agents, whose stdin often looks like a TTY.
+    if (shouldWaitForPerson({
+        isCodingAgent: isCodingAgent(),
+        isCi: process.env["CI"] === "true",
+        hasPromptInput: openPromptInput() !== undefined,
+    }) === false) {
+        outputJson({
+            ok: true,
+            status: "actionRequired",
+            action: "openBrowser",
+            integrationSlug,
+            url,
+            reason: "Creating this connector needs the hosted form, which cannot be driven headlessly.",
+            next: `cargo-ai connection connector list --integration-slug ${integrationSlug}`,
+        });
+        return;
+    }
+    const [before, userUuid] = await Promise.all([
+        handleApiCall(() => api.connection.connector.list({ integrationSlug })),
+        resolveUserUuid(api),
+    ]);
+    const connector = await awaitBrowserStep({
+        api,
+        url,
+        integrationSlug,
+        before: before.connectors,
+        userUuid,
+    });
+    if (connector === undefined) {
+        return;
+    }
+    outputJson({ ok: true, status: "connected", connector });
+}
+/** Open this connector's edit form so the user can re-run its auth flow. */
+function openConnectorEditForm(connectorUuid) {
+    const url = buildCliConnectorEditUrl({
+        ...resolveAppContext(),
+        connectorUuid,
+    });
+    info(["", "Re-authorize the connector here:", `  ${colors.cyan(url)}`, ""].join("\n"));
+    openBrowser(url);
+    outputJson({
+        ok: true,
+        status: "actionRequired",
+        action: "openBrowser",
+        url,
+    });
+}
+/** The workspace to act in; the app URL is configuration, not a guess. */
+function resolveAppContext() {
+    const { appUrl, workspaceUuid } = getConfig();
+    if (workspaceUuid === undefined) {
+        return failWith("No workspace selected. Run 'cargo-ai login' first.", {
+            code: ExitCodes.NotAuthenticated,
+        });
+    }
+    return { appUrl, workspaceUuid };
+}

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,CAoGN"}
+{"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"}

package/build/commands/connection/integration.js

@@ -6,7 +6,7 @@ export function registerIntegrationCommands(parent, getApi) {
     integration
         .command("list")
         .description("List all integrations")
-        .option("--category <category>", "Filter by category (string)")
+        .option("--category <engagement|marketing|sales|finance|analytics|freeform|success|support|enrichment|storage|custom>", "Filter by category")
         .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")')

package/build/commands/content/library.js

@@ -7,7 +7,7 @@ export function registerLibraryCommands(parent, getApi) {
         .command("list")
         .description("List workspace libraries")
         .option("--connector-uuid <uuid>", "Filter by connector UUID")
-        .option("--kind <kind>", "Filter by kind (native or connector)")
+        .option("--kind <native|connector>", "Filter by kind")
         .action(async (opts) => {
         const api = getApi();
         const kind = opts.kind === "connector" || opts.kind === "native"

package/build/commands/context/runtime.js

@@ -51,7 +51,7 @@ export function registerRuntimeCommands(parent, getApi) {
         .requiredOption("--path <path>", "Path to the file")
         .requiredOption("--old-string <old>", "Exact substring to replace (must occur once unless --replace-all is set)")
         .requiredOption("--new-string <new>", "Replacement string (may be empty to delete the match). Must differ from --old-string.")
-        .option("--replace-all [value]", "Replace every occurrence of --old-string instead of requiring a single match", parseBooleanOption)
+        .option("--replace-all [true|false]", "Replace every occurrence of --old-string instead of requiring a single match", parseBooleanOption)
         .option("--commit-message <message>", "Commit message override")
         .action(async (opts) => {
         const api = getApi();

package/build/commands/expression/recipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/commands/expression/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAwKN"}
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/commands/expression/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAgLN"}

package/build/commands/expression/recipe.js

@@ -5,9 +5,9 @@ export function registerRecipeCommands(parent, getApi) {
     recipe
         .command("list")
         .description("List recipes")
-        .option("--tab <tab>", "Tab filter (all, user, workspace, favorites)")
-        .option("--ui-types <types>", "UI types (comma-separated: js, ai)")
-        .option("--categories <cats>", "Categories (comma-separated)")
+        .option("--tab <all|user|workspace|favorites>", "Tab filter")
+        .option("--ui-types <js,ai>", "UI types")
+        .option("--categories <other,classification,cleaning,marketing,sales,event,copywriting>", "Categories")
         .option("--name <name>", "Filter by name")
         .option("--limit <n>", "Limit")
         .option("--offset <n>", "Offset")
@@ -45,12 +45,12 @@ export function registerRecipeCommands(parent, getApi) {
         .description("Create a recipe")
         .requiredOption("--name <name>", "Recipe name")
         .requiredOption("--description <text>", "Recipe description")
-        .requiredOption("--category <cat>", "Category (other, classification, cleaning, marketing, sales, event, copywriting)")
-        .requiredOption("--kind <kind>", "Kind (jsExpression or templateExpression)")
+        .requiredOption("--category <other|classification|cleaning|marketing|sales|event|copywriting>", "Category")
+        .requiredOption("--kind <jsExpression|templateExpression>", "Kind")
         .requiredOption("--expression <expr>", "Expression")
-        .requiredOption("--instruct-to <value>", "Instruct to (ai or none)")
+        .requiredOption("--instruct-to <ai|none>", "Instruct to")
         .requiredOption("--placeholders <json>", 'Placeholders (JSON array, e.g. [{"slug":"my_var","label":"My Variable","kind":"text"}])')
-        .option("--is-public [value]", "Make recipe public", parseBooleanOption)
+        .option("--is-public [true|false]", "Make recipe public", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.expression.recipe.create({
@@ -71,10 +71,10 @@ export function registerRecipeCommands(parent, getApi) {
         .requiredOption("--uuid <uuid>", "Recipe UUID")
         .requiredOption("--name <name>", "Recipe name")
         .requiredOption("--description <text>", "Recipe description")
-        .requiredOption("--category <cat>", "Category (other, classification, cleaning, marketing, sales, event, copywriting)")
+        .requiredOption("--category <other|classification|cleaning|marketing|sales|event|copywriting>", "Category")
         .requiredOption("--expression <expr>", "Expression")
         .requiredOption("--placeholders <json>", 'Placeholders (JSON array, e.g. [{"slug":"my_var","label":"My Variable","kind":"text"}])')
-        .option("--is-public [value]", "Make recipe public", parseBooleanOption)
+        .option("--is-public [true|false]", "Make recipe public", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.expression.recipe.createNewVersion({

package/build/commands/mailboxManagement/event.js

@@ -10,7 +10,7 @@ export function registerEventCommands(parent, getApi) {
         .option("--mailbox-uuid <uuid>", "Filter by mailbox")
         .option("--message-uuid <uuid>", "Filter by outbound message")
         .option("--thread-uuid <uuid>", "Filter by thread")
-        .option("--kinds <list>", "Filter by kind (comma-separated: sent,opened,clicked,replied,bounced,unsubscribed)")
+        .option("--kinds <sent,opened,clicked,replied,bounced,unsubscribed>", "Filter by kind")
         .option("--occurred-after <date>", "Occurred after (ISO 8601)")
         .option("--occurred-before <date>", "Occurred before (ISO 8601)")
         .option("--search <text>", "Search actor email or snippet")

package/build/commands/mailboxManagement/mailbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../src/commands/mailboxManagement/mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAUxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA+SN"}
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../src/commands/mailboxManagement/mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAUxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAySN"}

package/build/commands/mailboxManagement/mailbox.js

@@ -9,7 +9,7 @@ export function registerMailboxCommands(parent, getApi) {
         .description("List mailboxes in this workspace")
         .option("--domain-uuid <uuid>", "Only mailboxes on this sending domain")
         .option("--folder-uuid <uuid>", 'Folder UUID, or "none" for mailboxes not in a folder')
-        .option("--statuses <list>", "Filter by statuses (comma-separated: pending,active,inactive)")
+        .option("--statuses <pending,active,inactive>", "Filter by statuses")
         .option("--limit <n>", "Max results to return (integer)")
         .option("--offset <n>", "Number of results to skip (integer)")
         .addHelpText("after", `
@@ -43,7 +43,7 @@ Example:
         .command("create")
         .description("Provision a mailbox on a sending domain the workspace owns")
         .requiredOption("--domain-uuid <uuid>", "Sending domain UUID")
-        .requiredOption("--type <type>", "Mailbox flavour: google, shared, or private (outlook cannot deliver yet)")
+        .requiredOption("--type <google|shared|private>", "Mailbox flavour (outlook cannot deliver yet)")
         .requiredOption("--username <local-part>", "Local part of the address, e.g. jane for jane@acme.com")
         .requiredOption("--first-name <name>", "Sender first name in the From header")
         .requiredOption("--last-name <name>", "Sender last name in the From header")
@@ -136,7 +136,7 @@ Example:
         .description("Change warm-up daily target or pause/resume the pool")
         .requiredOption("--uuid <uuid>", "Mailbox UUID")
         .option("--daily-target <n>", "Warm-up messages per day at full ramp")
-        .option("--status <status>", "Warm-up state: disabled, pending, active, paused, failed")
+        .option("--status <disabled|pending|active|paused|failed>", "Warm-up state")
         .addHelpText("after", `
 Example:
   $ cargo-ai mailboxManagement mailbox update-warmup --uuid 550e8400-... --status paused`)

package/build/commands/mailboxManagement/message.js

@@ -9,7 +9,7 @@ export function registerMessageCommands(parent, getApi) {
         .description("List outbound messages")
         .option("--mailbox-uuid <uuid>", "Filter by mailbox")
         .option("--thread-uuid <uuid>", "Filter by thread")
-        .option("--statuses <list>", "Filter by list status (comma-separated: pending,error,sent,opened,clicked,replied,bounced,unsubscribed)")
+        .option("--statuses <pending,error,sent,opened,clicked,replied,bounced,unsubscribed>", "Filter by list status")
         .option("--created-after <date>", "Created after (ISO 8601)")
         .option("--created-before <date>", "Created before (ISO 8601)")
         .option("--search <text>", "Search subject or recipient")

package/build/commands/mailboxManagement/suppression.js

@@ -7,7 +7,7 @@ export function registerSuppressionCommands(parent, getApi) {
     suppression
         .command("list")
         .description("List suppressions")
-        .option("--reasons <list>", "Filter by reason (comma-separated: unsubscribed,bounced,complained,manual)")
+        .option("--reasons <unsubscribed,bounced,complained,manual>", "Filter by reason")
         .option("--limit <n>", "Max results to return (integer)")
         .option("--offset <n>", "Number of results to skip (integer)")
         .addHelpText("after", `

package/build/commands/mailboxManagement/thread.js

@@ -8,7 +8,7 @@ export function registerThreadCommands(parent, getApi) {
         .command("list")
         .description("List threads")
         .option("--mailbox-uuid <uuid>", "Filter by mailbox")
-        .option("--statuses <list>", "Filter by latest list status (comma-separated: pending,error,sent,opened,clicked,replied,bounced,unsubscribed)")
+        .option("--statuses <pending,error,sent,opened,clicked,replied,bounced,unsubscribed>", "Filter by latest list status")
         .option("--created-after <date>", "Created after (ISO 8601)")
         .option("--created-before <date>", "Created before (ISO 8601)")
         .option("--search <text>", "Search subject or recipient")

package/build/commands/observability/alert.js

@@ -28,7 +28,7 @@ export function registerAlertCommands(parent, getApi) {
         .requiredOption("--scope <json>", 'Scope (JSON), one of: {"kind":"spans","workflowUuid":"..."}, {"kind":"runs","workflowUuid":"...","statuses":["error"]}, {"kind":"records","workflowUuid":"...","statuses":["error"]}, {"kind":"orchestrationQuery","query":"select ..."}, {"kind":"storageQuery","query":"select ..."} or {"kind":"model","modelUuid":"...","filter":{...}}')
         .requiredOption("--threshold <json>", 'Threshold (JSON). Spans, runs and records scopes: {"metric":"errorRate","operator":"gte","value":10}, {"metric":"duration","aggregation":"p95","operator":"gte","value":30}, {"metric":"credits","aggregation":"sum","operator":"gte","value":500} or {"metric":"count","operator":"lte","value":0}; model scopes: {"metric":"recordsCount","operator":"lte","value":0}, {"metric":"recordsShare","operator":"gte","value":30} (needs a scope filter), {"metric":"freshness","operator":"gte","value":60} or {"metric":"syncDuration","operator":"gte","value":300}; query scopes: {"metric":"query","operator":"gte","value":10}')
         .option("--actions <json>", "Actions fired as runs on breach (JSON Action[]: connector, tool, or agent nodes)")
-        .option("--disabled [value]", "Create the alert disabled", parseBooleanOption)
+        .option("--disabled [true|false]", "Create the alert disabled", parseBooleanOption)
         .option("--description <text>", "What this alert watches")
         .option("--folder <uuid>", "Folder UUID to file the alert under")
         .action(async (opts) => {
@@ -53,7 +53,7 @@ export function registerAlertCommands(parent, getApi) {
         .requiredOption("--uuid <uuid>", "Alert UUID")
         .option("--name <name>", "Alert name")
         .option("--cron <cron>", 'Evaluation schedule: 5-field cron or "@every <interval>" (UTC), at most once a minute')
-        .option("--enabled [value]", "Enable or disable the alert (true/false)", parseBooleanOption)
+        .option("--enabled [true|false]", "Enable or disable the alert", parseBooleanOption)
         .option("--scope <json>", "Scope (JSON). See `alert create`")
         .option("--threshold <json>", "Threshold (JSON). See `alert create`")
         .option("--actions <json>", "Actions fired as runs on breach (JSON Action[])")

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

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAqBxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuSN"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAcxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAgTN"}

package/build/commands/orchestration/action.js

@@ -1,6 +1,5 @@
 import { parseBooleanOption } from "../../utils/booleanOption.js";
 import { applyRecordsLimit, ExitCodes, failWith, handleApiCall, outputJson, parseJson, parsePositiveInt, pollBatchUntilFinished, pollRunUntilFinished, } from "../runHandler.js";
-import { buildCostRows, groupActionsByIntegration, renderCostTable, summarize, } from "./costTable.js";
 export function registerActionCommands(parent, getApi) {
     const action = parent
         .command("action")
@@ -18,21 +17,34 @@ graph needed. Creates a run and consumes credits.
 
 To debug a node inside an existing workflow instead, use
 'cargo-ai orchestration node'.`);
-    registerCostTableCommand(action, getApi);
     const listableKinds = ["connector", "native", "tool", "agent"];
     action
         .command("list")
         .description("List actions")
         .argument("[query...]", "Keywords to match (space-separated, optional)")
-        .option("--kind <kind>", "Restrict to one kind: connector, native, tool, or agent (enum)")
+        .option("--kind <connector|native|tool|agent>", "Restrict to one kind")
         .option("--integration-slug <slug>", "Restrict connector actions to this integration (string)")
-        .option("--category <category>", "Restrict connector actions to integrations in this category (e.g. enrichment, sales, freeform)")
+        .option("--category <engagement|marketing|sales|finance|analytics|freeform|success|support|enrichment|storage|custom>", "Restrict connector actions to integrations in this category")
         .option("--limit <n>", "Maximum results to return (integer). Omit to return all results.")
         .addHelpText("after", `
 Each result includes an 'action' object you can pass to execute, execute-batch,
 or get-output-schema. All query terms must match (AND). Matches on the action
 slug or name rank above integration matches, which rank above description.
 
+Billed actions carry a 'credits' array — this is where pricing lives, so it is
+the answer to "what does <action> cost". Actions without it cost no credits.
+Each entry is one of three shapes, selected by the 'config' it matches:
+
+  - fixed:   'cost' credits per call.
+  - unit:    'cost' credits per 'unit' consumed, plus 'fixedCost' per call.
+  - package: 'cost' credits per block of 'unitsCount' 'unit', plus 'fixedCost'.
+
+'fixedCost' is a base charge on top of the metered rate, not an alternative to
+it — a search billed 0.175 fixedCost + 0.025 per item costs 0.2 for one item.
+When several entries are present the price depends on config, and each entry's
+'config.jsonSchema' const/enum is what selects it (an LLM model, a phone-or-
+email toggle).
+
 Examples:
   $ cargo-ai orchestration action list enrich
   $ cargo-ai orchestration action list --kind tool
@@ -65,7 +77,7 @@ Examples:
         .description("Execute a single action")
         .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-..."}\'')
         .requiredOption("--data <json>", "Input data for the run (JSON object, required)")
-        .option("--wait-until-finished [value]", "Poll the run until it reaches a terminal status before returning (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--wait-until-finished [true|false]", "Poll the run until it reaches a terminal status before returning (defaults to true when passed bare)", parseBooleanOption)
         .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
         .option("--webhook-url <url>", "URL to call when the run completes")
         .option("--webhook-secret <secret>", "Secret used to sign webhook deliveries")
@@ -99,7 +111,7 @@ Examples:
         .option("--webhook-url <url>", "URL to call when the batch completes")
         .option("--webhook-secret <secret>", "Secret used to sign webhook deliveries")
         .option("--limit <n>", "Pilot: only submit the first N records (integer). Inspect the pilot's output before re-running on the full set — credits-based actions bill per record.")
-        .option("--wait-until-finished [value]", "Poll the batch until it reaches a terminal status before returning (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--wait-until-finished [true|false]", "Poll the batch until it reaches a terminal status before returning (defaults to true when passed bare)", parseBooleanOption)
         .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
         .addHelpText("after", `
 Examples:
@@ -160,60 +172,3 @@ Examples:
         outputJson(result);
     });
 }
-function registerCostTableCommand(action, getApi) {
-    action
-        .command("cost-table")
-        .description("Price list of every credits-based action in the catalog, sorted by cost (free, reads the catalog)")
-        .option("--category <category>", "Filter by integration category (string)")
-        .option("--integration <slug>", "Filter by integration slug (string)")
-        .option("--raw", "Print the markdown document instead of JSON")
-        .addHelpText("after", `
-Free, spends nothing: the catalog is where pricing actually lives, so this is
-the answer to "what does <action> cost" and "what is the cheapest way to do
-<stage>" without pricing anyone copied by hand.
-
-Covers connector actions and Cargo's own native actions: sendEmail, modelAsk
-and fileSearch are billed, so a connector-only price list is not a complete one.
-Filtering by --category or --integration drops the natives.
-
-Actions absent from the output cost no credits. Actions whose price depends on
-config (an LLM model, a phone-or-email toggle) show a range, with the
-per-config prices in the document's second half.
-
-Examples:
-  $ cargo-ai orchestration action cost-table
-  $ cargo-ai orchestration action cost-table --category enrichment --raw
-  $ cargo-ai orchestration action cost-table --raw > credits-cost-table.md`)
-        .action(async (opts) => {
-        const api = getApi();
-        const isFiltered = opts.category !== undefined || opts.integration !== undefined;
-        // Fetch all connector and native actions. Omitting limit returns all.
-        // When filtering by category or integration, only connectors match —
-        // natives have no category and no integrationSlug.
-        const kinds = isFiltered
-            ? ["connector"]
-            : ["connector", "native"];
-        const allActions = [];
-        for (const kind of kinds) {
-            const result = await handleApiCall(() => api.orchestration.action.list({
-                kind,
-                category: opts.category,
-                integrationSlug: opts.integration,
-            }));
-            allActions.push(...result.results);
-        }
-        const catalog = groupActionsByIntegration(allActions);
-        const rows = buildCostRows(catalog);
-        const summary = summarize(catalog);
-        if (opts.raw === true) {
-            console.log(renderCostTable(rows, summary, {
-                generatedAt: new Date().toISOString().slice(0, 10),
-                filter: isFiltered
-                    ? { category: opts.category, integration: opts.integration }
-                    : undefined,
-            }));
-            return;
-        }
-        outputJson({ summary, rows });
-    });
-}

package/build/commands/orchestration/batch.js

@@ -13,12 +13,12 @@ export function registerBatchCommands(parent, getApi) {
         .option("--parent-batch-uuid <uuid>", "Filter by parent batch UUID (string)")
         .option("--parent-run-uuid <uuid>", "Filter by parent run UUID (string)")
         .option("--parent-node-uuid <uuid>", "Filter by parent node UUID (string)")
-        .option("--statuses <list>", "Filter by statuses (comma-separated: pending,syncing,skipped,querying,running,success,cancelling,error,cancelled)")
-        .option("--has-runs [value]", "Only return batches that have runs (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--is-skipped [value]", "Only return skipped batches (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--is-finished [value]", "Only return finished batches (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--included-data-kinds <list>", "Include only these data kinds (comma-separated strings)")
-        .option("--excluded-data-kinds <list>", "Exclude these data kinds (comma-separated strings)")
+        .option("--statuses <pending,syncing,skipped,querying,running,success,cancelling,error,cancelled>", "Filter by statuses")
+        .option("--has-runs [true|false]", "Only return batches that have runs (defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-skipped [true|false]", "Only return skipped batches (defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-finished [true|false]", "Only return finished batches (defaults to true when passed bare)", parseBooleanOption)
+        .option("--included-data-kinds <segment,change,filter,recordIds,watchedRecords,records,file,runs,group,schedule,form>", "Include only these data kinds")
+        .option("--excluded-data-kinds <segment,change,filter,recordIds,watchedRecords,records,file,runs,group,schedule,form>", "Exclude these data kinds")
         .option("--limit <n>", "Max results to return (integer, default: 20)", "20")
         .option("--offset <n>", "Number of results to skip (integer, default: 0)", "0")
         .action(async (opts) => {
@@ -69,7 +69,7 @@ export function registerBatchCommands(parent, getApi) {
         .option("--release-uuid <uuid>", "Release UUID to pin the batch to (string)")
         .option("--file <path>", "Path to a Workflow SDK module (its default export must be the compiled workflow returned by defineWorkflow()). Compiles it, resolves any @cargo-ai/cdk resource handles to real uuids from cargo.state.json, and runs the resulting nodes. Rejected with --nodes.")
         .option("--nodes <json>", "Custom nodes to override the workflow definition (JSON array). Rejected with --file.")
-        .option("--wait-until-finished [value]", "Poll the batch until it reaches a terminal status before returning (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--wait-until-finished [true|false]", "Poll the batch until it reaches a terminal status before returning (defaults to true when passed bare)", parseBooleanOption)
         .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
         .addHelpText("after", `
 Examples:

package/build/commands/orchestration/node.js

@@ -111,7 +111,7 @@ function registerDiagramCommand(node, getApi) {
         .option("--nodes <json>", "Node definitions (JSON array, or '-' to read from stdin)")
         .option("--file <path>", "Read a JSON payload or node array from a file")
         .option("--workflow-uuid <uuid>", "Diagram a workflow's deployed release (add --draft for its draft)")
-        .option("--draft [value]", "With --workflow-uuid, use the draft release", parseBooleanOption)
+        .option("--draft [true|false]", "With --workflow-uuid, use the draft release", parseBooleanOption)
         .option("--release-uuid <uuid>", "Diagram a specific release")
         .option("--run-uuid <uuid>", "Diagram the graph a run executed (follows the run's release when it has one)")
         .option("--title <text>", "Title rendered above the diagram")
@@ -119,7 +119,7 @@ function registerDiagramCommand(node, getApi) {
         .option("--direction <TD|LR>", "Mermaid flow direction, ignored by --format ascii (default: TD)", "TD")
         .option("--paid <slugs>", "Comma-separated node slugs/uuids that bill credits — marked 💳")
         .option("--highlight <slugs>", "Comma-separated node slugs/uuids to mark (red in Mermaid, ← in ASCII)")
-        .option("--raw [value]", "Print the diagram itself instead of JSON", parseBooleanOption)
+        .option("--raw [true|false]", "Print the diagram itself instead of JSON", parseBooleanOption)
         .addHelpText("after", `
 Free, runs nothing: turns a node graph into a picture so a reviewer can see the
 routing, the fallback paths and which steps bill before approving or deploying

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

@@ -1 +1 @@
-{"version":3,"file":"play.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/play.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAuR7E"}
+{"version":3,"file":"play.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/play.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA2R7E"}

package/build/commands/orchestration/play.js

@@ -9,9 +9,9 @@ export function registerPlayCommands(parent, getApi) {
         .description("List plays (optional filters match GET /orchestration/plays/list)")
         .option("--model-uuid <uuid>", "Only plays for this model UUID")
         .option("--segment-uuid <uuid>", "Only plays for this segment UUID")
-        .option("--schedule-type <type>", "Only plays with this schedule type: dbt | cron | realtime | dependency | watch")
-        .option("--is-enabled [value]", "Only enabled plays (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--is-disabled [value]", "Only disabled plays (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--schedule-type <dbt|cron|realtime|dependency|watch>", "Only plays with this schedule type")
+        .option("--is-enabled [true|false]", "Only enabled plays (defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-disabled [true|false]", "Only disabled plays (defaults to true when passed bare)", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const isEnabledFilter = resolveBooleanPair(opts.isEnabled, opts.isDisabled, { positive: "--is-enabled", negative: "--is-disabled" });
@@ -43,8 +43,8 @@ export function registerPlayCommands(parent, getApi) {
         .description("Create a play")
         .requiredOption("--name <name>", "Play name (string, required)")
         .requiredOption("--model-uuid <uuid>", "Model UUID to trigger on (string, required)")
-        .requiredOption("--change-kinds <kinds>", "Change kinds to trigger on (comma-separated strings, required)")
-        .requiredOption("--run-creation-rule <rule>", "Run creation rule. Allowed values: always, once, noConcurrency")
+        .requiredOption("--change-kinds <added,updated,removed,unchanged>", "Change kinds to trigger on (required)")
+        .requiredOption("--run-creation-rule <always|once|noConcurrency>", "Run creation rule")
         .option("--description <description>", "Play description (string)")
         .option("--folder-uuid <uuid>", "Folder UUID (string)")
         .addHelpText("after", `
@@ -82,10 +82,10 @@ Examples:
         .description("Update a play")
         .option("--name <name>", "Play name")
         .option("--description <description>", "Description")
-        .option("--is-enabled [value]", "Enable the play", parseBooleanOption)
-        .option("--is-disabled [value]", "Disable the play", parseBooleanOption)
-        .option("--change-kinds <kinds>", "Change kinds to trigger on (comma-separated strings)")
-        .option("--run-creation-rule <rule>", "Run creation rule. Allowed values: always, once, noConcurrency")
+        .option("--is-enabled [true|false]", "Enable the play", parseBooleanOption)
+        .option("--is-disabled [true|false]", "Disable the play", parseBooleanOption)
+        .option("--change-kinds <added,updated,removed,unchanged>", "Change kinds to trigger on")
+        .option("--run-creation-rule <always|once|noConcurrency>", "Run creation rule")
         .option("--folder-uuid <uuid>", "Folder UUID")
         .option("--filter <json>", "Filter definition (JSON object, same format as segmentation segment update)")
         .option("--sort <json>", 'Sort definition (JSON object). Shape: {"slug": string, "order": "asc" | "desc"}')