@cargo-ai/cli 1.0.70 → 1.0.72

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;AAcxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuRN"}
+{"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"}

package/build/commands/orchestration/action.js

@@ -1,5 +1,6 @@
 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")
@@ -17,6 +18,7 @@ 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")
@@ -24,7 +26,8 @@ To debug a node inside an existing workflow instead, use
         .argument("[query...]", "Keywords to match (space-separated, optional)")
         .option("--kind <kind>", "Restrict to one kind: connector, native, tool, or agent (enum)")
         .option("--integration-slug <slug>", "Restrict connector actions to this integration (string)")
-        .option("--limit <n>", "Maximum results to return (integer, default: 20, max: 50)", "20")
+        .option("--category <category>", "Restrict connector actions to integrations in this category (e.g. enrichment, sales, freeform)")
+        .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
@@ -33,7 +36,9 @@ slug or name rank above integration matches, which rank above description.
 Examples:
   $ cargo-ai orchestration action list enrich
   $ cargo-ai orchestration action list --kind tool
-  $ cargo-ai orchestration action list send --kind connector --integration-slug slack`)
+  $ cargo-ai orchestration action list send --kind connector --integration-slug slack
+  $ cargo-ai orchestration action list --category enrichment
+  $ cargo-ai orchestration action list --limit 10`)
         .action(async (queryTerms, opts) => {
         let kind;
         if (opts.kind !== undefined) {
@@ -42,12 +47,15 @@ Examples:
                 failWith('--kind must be "connector", "native", "tool", or "agent".', { code: ExitCodes.InvalidUsage });
             }
         }
-        const limit = parsePositiveInt(opts.limit, "--limit");
+        const limit = opts.limit === undefined
+            ? undefined
+            : parsePositiveInt(opts.limit, "--limit");
         const query = queryTerms.length === 0 ? undefined : queryTerms.join(" ");
         const result = await handleApiCall(() => getApi().orchestration.action.list({
             query,
             kind,
             integrationSlug: opts.integrationSlug,
+            category: opts.category,
             limit,
         }));
         outputJson(result);
@@ -152,3 +160,60 @@ 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/costTable.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Renders every credits-based action as a pricing table.
+ *
+ * The catalog is the only place pricing lives, and it moves — providers get
+ * added, actions get repriced, tiers get split. Anything that copies those
+ * numbers by hand goes stale silently, so the table is generated rather than
+ * maintained.
+ *
+ * Sourced from `orchestration action list` (without a limit), which spans
+ * connector and native actions in a single call. Natives are a small set but
+ * not a free one — `sendEmail` is 0.1, `modelAsk` 0.5, `fileSearch` 0.02/1k
+ * tokens — and a table built from connectors alone silently omits them while
+ * claiming to be complete.
+ */
+/**
+ * Shape returned by `orchestration action list` for each matching action.
+ */
+export type ListActionMatch = {
+    name: string;
+    description?: string;
+    score: number;
+    action: {
+        kind: string;
+        integrationSlug?: string;
+        actionSlug?: string;
+    };
+    integrationName?: string;
+    category?: string;
+    credits?: CreditsCost[];
+};
+export type CreditsCost = {
+    type?: string;
+    cost?: number;
+    unit?: string;
+    unitsCount?: number;
+    fixedCost?: number;
+    config?: {
+        jsonSchema?: JsonSchema;
+    };
+};
+type JsonSchema = {
+    type?: string;
+    const?: unknown;
+    enum?: unknown[];
+    minItems?: number;
+    maxItems?: number;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+};
+export type CatalogAction = {
+    name?: string;
+    description?: string;
+    credits?: {
+        costs?: CreditsCost[];
+    };
+};
+export type CatalogIntegration = {
+    slug: string;
+    name: string;
+    category?: string;
+    actions?: Record<string, CatalogAction>;
+};
+export type CostVariant = {
+    /** Config that selects this price, e.g. `model=gpt-5-nano`. */
+    when: string;
+    /** Rendered price, e.g. `0.4 + 0.006 / 1k token`. */
+    price: string;
+};
+export type CostRow = {
+    integrationSlug: string;
+    integrationName: string;
+    category: string | undefined;
+    actionSlug: string;
+    name: string | undefined;
+    description: string | undefined;
+    /** Cheapest and dearest per-unit price, in credits. */
+    minCost: number;
+    maxCost: number;
+    /**
+     * What one call at the cheapest config costs — per-unit price plus any flat
+     * component. The sort key, so a cheap-looking per-item rate with a base
+     * charge doesn't outrank a genuinely cheaper flat action.
+     */
+    sortCost: number;
+    /** Single price, or `min–max` when config picks between several. */
+    price: string;
+    /** Config fields that move the price; empty when there is only one. */
+    variesBy: string[];
+    variants: CostVariant[];
+};
+export type CostTableSummary = {
+    integrations: number;
+    integrationsWithActions: number;
+    actions: number;
+    creditsBasedActions: number;
+    freeActions: number;
+};
+/**
+ * Natives have no integration of their own. `native` cannot collide with a real
+ * integration slug, and it is what `kind` an action object needs to run one:
+ * `{"kind":"native","actionSlug":"sendEmail"}`.
+ */
+export declare const NATIVE_PROVIDER_SLUG = "native";
+export declare function asNativeCatalogIntegration(actions: Record<string, CatalogAction> | undefined): CatalogIntegration;
+/**
+ * Groups the flat action list returned by `orchestration action list` into the
+ * integration-grouped shape that `buildCostRows` and `summarize` expect.
+ */
+export declare function groupActionsByIntegration(actions: ListActionMatch[]): CatalogIntegration[];
+export declare function buildCostRows(integrations: CatalogIntegration[]): CostRow[];
+export declare function summarize(integrations: CatalogIntegration[]): CostTableSummary;
+export type RenderCostTableOptions = {
+    generatedAt: string;
+    filter?: {
+        category?: string;
+        integration?: string;
+    };
+};
+export declare function renderCostTable(rows: CostRow[], summary: CostTableSummary, opts: RenderCostTableOptions): string;
+export {};
+//# sourceMappingURL=costTable.d.ts.map

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

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

package/build/commands/orchestration/costTable.js

@@ -0,0 +1,363 @@
+/**
+ * Renders every credits-based action as a pricing table.
+ *
+ * The catalog is the only place pricing lives, and it moves — providers get
+ * added, actions get repriced, tiers get split. Anything that copies those
+ * numbers by hand goes stale silently, so the table is generated rather than
+ * maintained.
+ *
+ * Sourced from `orchestration action list` (without a limit), which spans
+ * connector and native actions in a single call. Natives are a small set but
+ * not a free one — `sendEmail` is 0.1, `modelAsk` 0.5, `fileSearch` 0.02/1k
+ * tokens — and a table built from connectors alone silently omits them while
+ * claiming to be complete.
+ */
+const DESCRIPTION_MAX_LENGTH = 120;
+/**
+ * Natives have no integration of their own. `native` cannot collide with a real
+ * integration slug, and it is what `kind` an action object needs to run one:
+ * `{"kind":"native","actionSlug":"sendEmail"}`.
+ */
+export const NATIVE_PROVIDER_SLUG = "native";
+export function asNativeCatalogIntegration(actions) {
+    return {
+        slug: NATIVE_PROVIDER_SLUG,
+        name: "Cargo native",
+        category: "platform",
+        actions: actions ?? {},
+    };
+}
+/**
+ * Groups the flat action list returned by `orchestration action list` into the
+ * integration-grouped shape that `buildCostRows` and `summarize` expect.
+ */
+export function groupActionsByIntegration(actions) {
+    const integrationMap = new Map();
+    for (const match of actions) {
+        const actionKind = match.action.kind;
+        const actionSlug = match.action.actionSlug;
+        if (actionSlug === undefined) {
+            continue;
+        }
+        let slug;
+        let name;
+        let category;
+        if (actionKind === "native") {
+            slug = NATIVE_PROVIDER_SLUG;
+            name = "Cargo native";
+            category = "platform";
+        }
+        else if (actionKind === "connector") {
+            slug =
+                match.action.integrationSlug !== undefined
+                    ? match.action.integrationSlug
+                    : "";
+            name = match.integrationName !== undefined ? match.integrationName : slug;
+            category = match.category;
+        }
+        else {
+            continue;
+        }
+        let integration = integrationMap.get(slug);
+        if (integration === undefined) {
+            integration = { slug, name, category, actions: {} };
+            integrationMap.set(slug, integration);
+        }
+        if (integration.actions === undefined) {
+            integration.actions = {};
+        }
+        integration.actions[actionSlug] = {
+            name: match.name,
+            description: match.description,
+            credits: match.credits !== undefined ? { costs: match.credits } : undefined,
+        };
+    }
+    return Array.from(integrationMap.values());
+}
+export function buildCostRows(integrations) {
+    const rows = [];
+    for (const integration of integrations) {
+        for (const [actionSlug, action] of Object.entries(integration.actions ?? {})) {
+            const costs = action.credits?.costs;
+            const [first] = costs ?? [];
+            if (costs === undefined || first === undefined) {
+                continue;
+            }
+            const amounts = costs.map((cost) => cost.cost ?? 0);
+            const effective = costs.map((cost) => (cost.cost ?? 0) + (cost.fixedCost ?? 0));
+            const variants = costs.map((cost) => ({
+                when: describeSelector(cost.config?.jsonSchema),
+                price: renderPrice(cost),
+            }));
+            const minCost = Math.min(...amounts);
+            const maxCost = Math.max(...amounts);
+            rows.push({
+                integrationSlug: integration.slug,
+                integrationName: integration.name,
+                category: integration.category,
+                actionSlug,
+                name: action.name,
+                description: truncate(action.description),
+                minCost,
+                maxCost,
+                sortCost: Math.min(...effective),
+                price: costs.length === 1
+                    ? renderPrice(first)
+                    : renderRange(costs, minCost, maxCost),
+                variesBy: costs.length === 1 ? [] : selectorFields(costs),
+                variants: costs.length === 1 ? [] : variants,
+            });
+        }
+    }
+    return rows.sort((a, b) => a.sortCost - b.sortCost ||
+        a.maxCost - b.maxCost ||
+        a.integrationSlug.localeCompare(b.integrationSlug) ||
+        a.actionSlug.localeCompare(b.actionSlug));
+}
+export function summarize(integrations) {
+    let actions = 0;
+    let creditsBasedActions = 0;
+    let integrationsWithActions = 0;
+    for (const integration of integrations) {
+        const entries = Object.values(integration.actions ?? {});
+        // The native pseudo-integration is a carrier for platform actions, not a
+        // 139th integration. Its actions count; it does not.
+        const isNative = integration.slug === NATIVE_PROVIDER_SLUG;
+        if (entries.length > 0 && isNative === false) {
+            integrationsWithActions += 1;
+        }
+        actions += entries.length;
+        for (const action of entries) {
+            if ((action.credits?.costs ?? []).length > 0) {
+                creditsBasedActions += 1;
+            }
+        }
+    }
+    return {
+        integrations: integrations.filter((integration) => {
+            return integration.slug !== NATIVE_PROVIDER_SLUG;
+        }).length,
+        integrationsWithActions,
+        actions,
+        creditsBasedActions,
+        freeActions: actions - creditsBasedActions,
+    };
+}
+export function renderCostTable(rows, summary, opts) {
+    const lines = [];
+    const filter = opts.filter;
+    const isFiltered = filter !== undefined &&
+        (filter.category !== undefined || filter.integration !== undefined);
+    lines.push("# Credits cost table");
+    lines.push("");
+    if (isFiltered) {
+        const filterDesc = filter.category !== undefined && filter.integration !== undefined
+            ? `category \`${filter.category}\` and integration \`${filter.integration}\``
+            : filter.category !== undefined
+                ? `category \`${filter.category}\``
+                : `integration \`${filter.integration}\``;
+        lines.push(`Filtered by ${filterDesc}: ${String(summary.creditsBasedActions)} credits-based actions ` +
+            `out of ${String(summary.actions)} total across ${String(summary.integrationsWithActions)} of ` +
+            `${String(summary.integrations)} integrations, sorted by cost. ` +
+            `The other ${String(summary.freeActions)} actions in this subset cost no credits. ` +
+            "Run without filters for the full catalog, including Cargo's native actions.");
+    }
+    else {
+        lines.push(`Every credits-based action Cargo can run — ${String(summary.creditsBasedActions)} of the ` +
+            `${String(summary.actions)} actions exposed by ${String(summary.integrationsWithActions)} of the catalog's ` +
+            `${String(summary.integrations)} integrations, plus Cargo's own native actions — sorted by cost. The other ${String(summary.freeActions)} actions ` +
+            "(CRM writes, sequencer pushes, Slack sends, …) cost no credits; list them with " +
+            "`cargo-ai connection integration get <slug>`.");
+    }
+    lines.push("");
+    if (isFiltered === false) {
+        lines.push("Rows whose provider is `native` are Cargo's own platform actions, run as " +
+            '`{"kind":"native","actionSlug":"<action>"}` with no integration; every other row ' +
+            'runs as `{"kind":"connector","integrationSlug":"<provider>","actionSlug":"<action>"}`.');
+        lines.push("");
+    }
+    lines.push("**Auto-generated. Do not edit by hand** — regenerate with " +
+        "`cargo-ai orchestration action cost-table --raw > cargo-gtm/references/credits-cost-table.md`.");
+    lines.push("");
+    lines.push(`Generated: ${opts.generatedAt}`);
+    lines.push("");
+    lines.push("| Cost | Provider | Category | Action | Description |");
+    lines.push("|---|---|---|---|---|");
+    for (const row of rows) {
+        lines.push(`| ${row.price} | \`${row.integrationSlug}\` | ${row.category ?? "—"} | ` +
+            `\`${row.actionSlug}\` | ${escapeCell(row.description ?? "")} |`);
+    }
+    const variable = rows.filter((row) => row.variants.length > 0);
+    if (variable.length > 0) {
+        lines.push("");
+        lines.push("## Actions whose price depends on config");
+        lines.push("");
+        lines.push("These bill differently depending on how the node is configured, so the range above is not a quote. " +
+            "Pick the row that matches the config you are about to run.");
+        lines.push("");
+        for (const row of variable) {
+            lines.push(`### \`${row.integrationSlug}.${row.actionSlug}\` — varies by ${row.variesBy
+                .map((field) => `\`${field}\``)
+                .join(", ")}`);
+            lines.push("");
+            lines.push("| Config | Cost |");
+            lines.push("|---|---|");
+            for (const variant of dedupeVariants(row.variants)) {
+                lines.push(`| ${escapeCell(variant.when)} | ${variant.price} |`);
+            }
+            lines.push("");
+        }
+    }
+    return `${lines.join("\n").trimEnd()}\n`;
+}
+/**
+ * One cost entry as a price expression.
+ *
+ * `fixed` bills per call, `unit` bills per unit consumed, and `package` bills
+ * per block of units on top of a flat call cost — an LLM step that charges a
+ * base plus a rate per 1k tokens is the common case.
+ */
+function renderPrice(cost) {
+    const amount = formatAmount(cost.cost ?? 0);
+    if (cost.type === "unit") {
+        const metered = cost.unit === undefined ? amount : `${amount} / ${cost.unit}`;
+        // A per-item rate can sit on top of a flat charge per call — dropping that
+        // base is how a 0.175 + 0.025/item search gets quoted as 0.025.
+        return cost.fixedCost === undefined || cost.fixedCost === 0
+            ? metered
+            : `${formatAmount(cost.fixedCost)} + ${metered}`;
+    }
+    if (cost.type === "package") {
+        const block = formatUnits(cost.unitsCount, cost.unit);
+        const metered = block === undefined ? amount : `${amount} / ${block}`;
+        return cost.fixedCost === undefined || cost.fixedCost === 0
+            ? metered
+            : `${formatAmount(cost.fixedCost)} + ${metered}`;
+    }
+    return amount;
+}
+function renderRange(costs, minCost, maxCost) {
+    const range = minCost === maxCost
+        ? formatAmount(minCost)
+        : `${formatAmount(minCost)}–${formatAmount(maxCost)}`;
+    const first = costs[0];
+    const unit = first !== undefined ? first.unit : undefined;
+    const unitsCount = first !== undefined ? first.unitsCount : undefined;
+    const packageBlock = formatUnits(unitsCount, unit);
+    const metered = costs.some((cost) => cost.type === "package")
+        ? packageBlock !== undefined
+            ? `${range} / ${packageBlock}`
+            : range
+        : costs.every((cost) => cost.type === "unit") && unit !== undefined
+            ? `${range} / ${unit}`
+            : range;
+    const hasBase = costs.some((cost) => cost.fixedCost !== undefined && cost.fixedCost !== 0);
+    return hasBase ? `${metered} + base` : metered;
+}
+/**
+ * The config fields a cost entry keys off, as dotted paths — the answer to
+ * "what do I change to land on a different price".
+ */
+function selectorPaths(schema, prefix = "") {
+    if (schema?.properties === undefined) {
+        return [];
+    }
+    const paths = [];
+    for (const [key, property] of Object.entries(schema.properties)) {
+        const path = prefix === "" ? key : `${prefix}.${key}`;
+        const nested = selectorPaths(property, path);
+        if (nested.length > 0) {
+            paths.push(...nested);
+        }
+        else {
+            paths.push(path);
+        }
+    }
+    return paths;
+}
+function selectorFields(costs) {
+    const fields = new Set();
+    for (const cost of costs) {
+        for (const path of selectorPaths(cost.config?.jsonSchema)) {
+            fields.add(path);
+        }
+    }
+    return [...fields];
+}
+/** A cost entry's selector as `field=value` pairs, e.g. `model=gpt-5-nano`. */
+function describeSelector(schema) {
+    const pairs = selectorPairs(schema);
+    return pairs.length === 0 ? "any config" : pairs.join(", ");
+}
+function selectorPairs(schema, prefix = "") {
+    if (schema?.properties === undefined) {
+        return [];
+    }
+    const pairs = [];
+    for (const [key, property] of Object.entries(schema.properties)) {
+        const path = prefix === "" ? key : `${prefix}.${key}`;
+        const nested = selectorPairs(property, path);
+        if (nested.length > 0) {
+            pairs.push(...nested);
+            continue;
+        }
+        pairs.push(`${path}${describeConstraint(property)}`);
+    }
+    return pairs;
+}
+function describeConstraint(schema) {
+    if (schema.const !== undefined) {
+        return `=${String(schema.const)}`;
+    }
+    if (schema.enum !== undefined) {
+        return `∈ ${schema.enum.map((value) => String(value)).join("|")}`;
+    }
+    if (schema.maxItems === 0) {
+        return " empty";
+    }
+    if (schema.minItems !== undefined && schema.minItems > 0) {
+        return " set";
+    }
+    return " (any)";
+}
+/**
+ * Catalogs sometimes carry the same price twice under selectors that differ
+ * only in a field the reader cannot act on; collapsing them keeps the variant
+ * table readable.
+ */
+function dedupeVariants(variants) {
+    const seen = new Set();
+    const kept = [];
+    for (const variant of variants) {
+        const key = `${variant.when}|${variant.price}`;
+        if (seen.has(key) === true) {
+            continue;
+        }
+        seen.add(key);
+        kept.push(variant);
+    }
+    return kept;
+}
+function formatUnits(unitsCount, unit) {
+    if (unit === undefined) {
+        return undefined;
+    }
+    if (unitsCount === undefined || unitsCount === 1) {
+        return unit;
+    }
+    return unitsCount % 1000 === 0
+        ? `${String(unitsCount / 1000)}k ${unit}`
+        : `${String(unitsCount)} ${unit}`;
+}
+function formatAmount(value) {
+    return String(Number(value.toFixed(6)));
+}
+function truncate(value) {
+    if (value === undefined || value.length <= DESCRIPTION_MAX_LENGTH) {
+        return value;
+    }
+    return `${value.slice(0, DESCRIPTION_MAX_LENGTH).trimEnd()}…`;
+}
+function escapeCell(value) {
+    return value.replace(/\r?\n/g, " ").replace(/\|/g, "\\|");
+}

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAgBxC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA+rB5E"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAgBxC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAuqB5E"}

package/build/commands/orchestration/run.js

@@ -1,4 +1,3 @@
-import { declarePrompt } from "@cargo-ai/cdk/cli";
 import { parseBooleanOption } from "../../utils/booleanOption.js";
 import { loadCompiledWorkflow, resolveCompiledWorkflowFromState, } from "../../utils/loadCompiledWorkflow.js";
 import { ExitCodes, failWith, handleApiCall, info, outputJson, parseJson, pollRunUntilFinished, } from "../runHandler.js";
@@ -6,7 +5,7 @@ export function registerRunCommands(parent, getApi) {
     const run = parent
         .command("run")
         .description("Manage workflow runs (list, get, create, cancel, count, download)");
-    const listRuns = run
+    run
         .command("list")
         .description("List runs")
         .option("--workflow-uuid <uuid>", "Workflow UUID (string). Omit to list the runs of every play and tool, which the API allows only alongside --created-after inside a 30-day window")
@@ -143,7 +142,7 @@ Examples:
         await handleApiCall(() => api.orchestration.run.cancel(payload));
         outputJson({ ok: true });
     });
-    const countRuns = run
+    run
         .command("count")
         .description("Count runs matching the given filters")
         .option("--workflow-uuid <uuid>", "Workflow UUID (string). Omit to count the runs of every play and tool, which the API allows only alongside --created-after inside a 30-day window")
@@ -190,29 +189,6 @@ Examples:
         }));
         outputJson(result);
     });
-    // Both of these take the option or go without it, and going without it is
-    // only legal alongside --created-after. Commander cannot express that, so the
-    // palette would offer a command that fails on the server's own message. The
-    // choice is declared here instead, beside the option it chooses between.
-    for (const command of [listRuns, countRuns]) {
-        declarePrompt(command, {
-            message: "which runs?",
-            choices: [
-                {
-                    label: "One workflow",
-                    hint: "a single play or tool",
-                    flag: "--workflow-uuid",
-                    value: { name: "workflow-uuid", hint: "550e8400-e29b-41d4-a716-…" },
-                },
-                {
-                    label: "Every play and tool",
-                    hint: "needs a start date; the API allows at most a 30-day window",
-                    flag: "--created-after",
-                    value: { name: "created-after", hint: "2026-08-01T00:00:00Z" },
-                },
-            ],
-        });
-    }
     run
         .command("download")
         .description("Download run results as JSON")

package/build/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { BRAND, canRunPalette, fetchCreditsLeft, fetchWorkspaceName, formatWorkspaceSuffix, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
+import { BRAND, canRunPalette, declareSources, fetchCreditsLeft, fetchWorkspaceName, formatWorkspaceSuffix, 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";
@@ -112,6 +112,57 @@ const getApi = () => {
     }
     return createApi({ baseUrl, getAccessToken, workspaceUuid });
 };
+// 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.
+//
+// Nobody knows a uuid. 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
+    // and the workflowUuid, so they are what the menu is built from.
+    "--workflow-uuid": [
+        {
+            argv: ["orchestration", "play", "list"],
+            value: "workflowUuid",
+            label: "name",
+            kind: "play",
+        },
+        {
+            argv: ["orchestration", "tool", "list"],
+            value: "workflowUuid",
+            label: "name",
+            kind: "tool",
+        },
+    ],
+    "--model-uuid": [
+        {
+            argv: ["storage", "model", "list"],
+            value: "uuid",
+            label: "name",
+            hint: "slug",
+        },
+    ],
+    "--agent-uuid": [
+        { argv: ["ai", "agent", "list"], value: "uuid", label: "name" },
+    ],
+    "--connector-uuid": [
+        {
+            argv: ["connection", "connector", "list"],
+            value: "uuid",
+            label: "name",
+            hint: "integrationSlug",
+        },
+    ],
+    // Datasets have no name of their own; the slug is what identifies them.
+    "--dataset-uuid": [
+        { argv: ["storage", "dataset", "list"], value: "uuid", label: "slug" },
+    ],
+    "--segment-uuid": [
+        { argv: ["segmentation", "segment", "list"], value: "uuid", label: "name" },
+    ],
+});
 registerAuthCommands(program, getApi);
 registerVersionCommand(program, version);
 registerDoctorCommand(program, version);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.70",
+  "version": "1.0.72",
   "private": false,
   "license": "UNLICENSED",
   "homepage": "https://getcargo.ai",
@@ -66,7 +66,7 @@
   "dependencies": {
     "@cargo-ai/api": "^1.0.69",
     "@cargo-ai/app-sdk": "^1.0.9",
-    "@cargo-ai/cdk": "^1.0.56",
+    "@cargo-ai/cdk": "^1.0.57",
     "@cargo-ai/types": "^1.0.66",
     "@cargo-ai/worker-sdk": "^1.0.17",
     "@modelcontextprotocol/sdk": "1.29.0",