@cargo-ai/cli 1.0.73 → 1.0.75

package/build/commands/orchestration/costTable.js

@@ -1,363 +0,0 @@
-/**
- * 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, "\\|");
-}