@cargo-ai/cli 1.0.35 → 1.0.37

package/build/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,GAAG,EAAY,MAAM,eAAe,CAAC;AAInD,YAAY,EAAE,GAAG,EAAE,CAAC;AAQpB,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,GAAG,GAAG,CAQN"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,GAAG,EAAY,MAAM,eAAe,CAAC;AAInD,YAAY,EAAE,GAAG,EAAE,CAAC;AAQpB,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,GAAG,GAAG,CAWN"}

package/build/api.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { buildApi } from "@cargo-ai/api";
-import { getProxyTransport } from "./proxy.js";
+import { getProxyFetch } from "./proxy.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const ORIGIN = { name: "cli", version };
@@ -10,6 +10,9 @@ export function createApi(opts) {
         workspaceUuid: opts.workspaceUuid,
         accessToken: opts.accessToken,
         origin: ORIGIN,
-        transport: getProxyTransport(opts.baseUrl),
+        // The client is `fetch`-based; supply a proxy-tunneling `fetch` (undici
+        // `ProxyAgent`) when proxy env vars are set, since Node's global `fetch`
+        // does not honor them. `undefined` when no proxy applies.
+        transport: { fetch: getProxyFetch(opts.baseUrl) },
     });
 }

package/build/commands/auth/index.js

@@ -23,7 +23,7 @@ Examples:
   $ cargo-ai login --oauth --workspace-uuid 550e8400-e29b-41d4-a716-446655440000
 
 Credentials are stored in ~/.config/cargo-ai/credentials.json.
-Environment variables (CARGO_API_TOKEN, CARGO_WORKSPACE_UUID, CARGO_BASE_URL) take precedence over saved credentials.`)
+Environment variables (CARGO_API_TOKEN, CARGO_WORKSPACE_UUID, CARGO_BASE_URL) take precedence over saved credentials, and the nearest project .env (walking up from the current directory) fills them in when they are not already exported.`)
         .action(async (opts) => {
         await runLogin(opts);
     });

package/build/commands/connection/action.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AA+CxC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuHN"}

package/build/commands/connection/action.js

@@ -0,0 +1,131 @@
+import { ExitCodes, failWith, handleApiCall, outputJson, } from "../runHandler.js";
+const DEFAULT_LIMIT = 20;
+const DESCRIPTION_MAX_LENGTH = 300;
+export function registerActionSearchCommands(parent, getApi) {
+    const action = parent
+        .command("action")
+        .description("Discover integration actions");
+    action
+        .command("search [query...]")
+        .description("Search integration actions by keyword across action slug, name, description, and integration — " +
+        "instead of scanning the full `integration list` payload")
+        .option("--category <category>", "Filter by integration category (string)")
+        .option("--integration <slug>", "Filter by integration slug (string)")
+        .option("--credits-only", "Only return credits-based (paid) actions (boolean flag)")
+        .option("--limit <n>", `Maximum results to return (integer, default: ${String(DEFAULT_LIMIT)})`, String(DEFAULT_LIMIT))
+        .addHelpText("after", `
+All query terms must match somewhere (action slug/name, integration, or description).
+Matches on the action slug or name rank above integration matches, which rank above
+description matches. Without a query, lists actions filtered by the flags alone.
+
+Examples:
+  $ cargo-ai connection action search email verify
+  $ cargo-ai connection action search "job change" --credits-only
+  $ cargo-ai connection action search enrich --integration waterfall
+  $ cargo-ai connection action search --category crm --limit 50`)
+        .action(async (queryTerms, opts) => {
+        const limit = parseInt(opts.limit, 10);
+        if (Number.isNaN(limit) === true || limit < 1) {
+            failWith("--limit must be a positive integer.", {
+                code: ExitCodes.InvalidUsage,
+            });
+        }
+        const api = getApi();
+        const { integrations } = await handleApiCall(() => api.connection.integration.list({
+            hasActions: true,
+            category: opts.category,
+            slug: opts.integration,
+        }));
+        const terms = queryTerms
+            .flatMap((term) => term.split(/\s+/))
+            .map((term) => term.toLowerCase())
+            .filter((term) => term.length > 0);
+        const results = [];
+        for (const integration of integrations) {
+            const actions = integration.actions;
+            if (actions === undefined) {
+                continue;
+            }
+            for (const [actionSlug, actionDef] of Object.entries(actions)) {
+                const costs = actionDef.credits?.costs;
+                if (opts.creditsOnly === true &&
+                    (costs === undefined || costs.length === 0)) {
+                    continue;
+                }
+                const score = scoreAction(terms, {
+                    actionText: `${actionSlug} ${actionDef.name ?? ""}`,
+                    integrationText: `${integration.slug} ${integration.name}`,
+                    descriptionText: actionDef.description ?? "",
+                });
+                if (score === 0) {
+                    continue;
+                }
+                results.push({
+                    integrationSlug: integration.slug,
+                    integrationName: integration.name,
+                    category: integration.category,
+                    actionSlug,
+                    name: actionDef.name,
+                    description: truncate(actionDef.description),
+                    credits: costs?.map((cost) => mapSearchableCreditsCost(cost)),
+                    score,
+                });
+            }
+        }
+        results.sort((a, b) => b.score - a.score || a.actionSlug.localeCompare(b.actionSlug));
+        outputJson({
+            query: terms.join(" "),
+            totalMatches: results.length,
+            results: results.slice(0, limit),
+        });
+    });
+}
+// Every term must match somewhere (AND semantics); the sum of the strongest
+// match per term ranks the result. Action slug/name beats integration beats
+// description.
+function scoreAction(terms, fields) {
+    if (terms.length === 0) {
+        return 1;
+    }
+    const actionText = fields.actionText.toLowerCase();
+    const integrationText = fields.integrationText.toLowerCase();
+    const descriptionText = fields.descriptionText.toLowerCase();
+    let total = 0;
+    for (const term of terms) {
+        if (actionText.includes(term) === true) {
+            total += 3;
+        }
+        else if (integrationText.includes(term) === true) {
+            total += 2;
+        }
+        else if (descriptionText.includes(term) === true) {
+            total += 1;
+        }
+        else {
+            return 0;
+        }
+    }
+    return total;
+}
+function mapSearchableCreditsCost(cost) {
+    const mapped = {
+        type: cost.type,
+        cost: cost.cost,
+    };
+    if (cost.unit !== undefined) {
+        mapped.unit = cost.unit;
+    }
+    if (cost.unitsCount !== undefined) {
+        mapped.unitsCount = cost.unitsCount;
+    }
+    if (cost.fixedCost !== undefined) {
+        mapped.fixedCost = cost.fixedCost;
+    }
+    return mapped;
+}
+function truncate(value) {
+    if (value === undefined || value.length <= DESCRIPTION_MAX_LENGTH) {
+        return value;
+    }
+    return `${value.slice(0, DESCRIPTION_MAX_LENGTH)}…`;
+}

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

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

package/build/commands/connection/index.js

@@ -1,3 +1,4 @@
+import { registerActionSearchCommands } from "./action.js";
 import { registerConnectorCommands } from "./connector.js";
 import { registerCustomIntegrationCommands } from "./customIntegration.js";
 import { registerIntegrationCommands } from "./integration.js";
@@ -8,6 +9,7 @@ export function registerConnectionCommands(parent, getApi) {
         .description("Connectors and integrations");
     registerConnectorCommands(connection, getApi);
     registerIntegrationCommands(connection, getApi);
+    registerActionSearchCommands(connection, getApi);
     registerNativeIntegrationCommands(connection, getApi);
     registerCustomIntegrationCommands(connection, getApi);
 }

package/build/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerDoctorCommand(program: Command, currentVersion: string): void;
+//# sourceMappingURL=doctor.d.ts.map

package/build/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgKzC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,GACrB,IAAI,CAoDN"}

package/build/commands/doctor.js

@@ -0,0 +1,155 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { determineIfIsFetcherError } from "@cargo-ai/api";
+import { createApi } from "../api.js";
+import { getConfig } from "../config.js";
+import { getCredentialsPath } from "../credentials.js";
+import { fetchLatestVersion, isOutdated } from "../version.js";
+import { ExitCodes, outputJson } from "./runHandler.js";
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+$/;
+function getSkillsPinCandidates() {
+    const home = os.homedir();
+    const envDir = process.env["CARGO_SKILLS_DIR"];
+    const candidates = [];
+    if (envDir !== undefined && envDir.length > 0) {
+        candidates.push(path.join(envDir, "cargo", "cli-version"));
+    }
+    candidates.push(path.join(home, ".claude", "skills", "cargo", "cli-version"), path.join(home, ".claude", "plugins", "marketplaces", "cargo", "cargo", "cli-version"), path.join(home, ".openclaw", "skills", "cargo", "cli-version"));
+    return candidates;
+}
+function readSkillsPin() {
+    for (const candidate of getSkillsPinCandidates()) {
+        try {
+            const raw = fs.readFileSync(candidate, "utf8").trim();
+            if (SEMVER_PATTERN.test(raw)) {
+                return { version: raw, path: candidate };
+            }
+        }
+        catch {
+            // Missing or unreadable — try the next candidate.
+        }
+    }
+    return undefined;
+}
+function buildCliCheck(currentVersion, latestVersion) {
+    if (latestVersion === undefined) {
+        return { current: currentVersion, latest: null, upToDate: null };
+    }
+    return {
+        current: currentVersion,
+        latest: latestVersion,
+        upToDate: !isOutdated(currentVersion, latestVersion),
+    };
+}
+function buildSkillsPinCheck(currentVersion) {
+    const pin = readSkillsPin();
+    if (pin === undefined) {
+        return { found: false };
+    }
+    return {
+        found: true,
+        pinned: pin.version,
+        path: pin.path,
+        matchesCli: pin.version === currentVersion,
+    };
+}
+async function checkApi(config) {
+    if (config.accessToken === undefined) {
+        return {
+            check: {
+                ok: false,
+                error: {
+                    status: "no-credentials",
+                    message: 'Not authenticated. Run "cargo-ai login --token <token>" or "cargo-ai login --oauth".',
+                },
+            },
+            exitCode: ExitCodes.NotAuthenticated,
+        };
+    }
+    const client = createApi({
+        baseUrl: config.baseUrl,
+        accessToken: config.accessToken,
+        workspaceUuid: config.workspaceUuid,
+    });
+    try {
+        const { user } = await client.userManagement.user.getCurrent();
+        const { workspace } = await client.workspaceManagement.workspace.getCurrent();
+        return {
+            check: {
+                ok: true,
+                user: { uuid: user.uuid, email: user.email },
+                workspace: { uuid: workspace.uuid, name: workspace.name },
+            },
+            exitCode: ExitCodes.Success,
+        };
+    }
+    catch (error) {
+        const status = determineIfIsFetcherError(error)
+            ? (error.status ?? 0)
+            : 0;
+        let exitCode;
+        if (status === 401) {
+            exitCode = ExitCodes.NotAuthenticated;
+        }
+        else if (status === 403) {
+            exitCode = ExitCodes.PermissionDenied;
+        }
+        else {
+            exitCode = ExitCodes.GenericError;
+        }
+        return {
+            check: {
+                ok: false,
+                error: {
+                    status,
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            },
+            exitCode,
+        };
+    }
+}
+export function registerDoctorCommand(program, currentVersion) {
+    program
+        .command("doctor")
+        .description("Diagnose the CLI setup: version vs latest and the skills-bundle pin, credentials, and API reachability")
+        .addHelpText("after", `
+Runs every check and reports all results as one JSON object, then exits with the
+most severe failure:
+
+  0  healthy (an outdated CLI or a pin mismatch is reported but never fails the check)
+  1  API unreachable or returned an unexpected error
+  3  not authenticated (no credentials, or the API rejected them)
+  4  permission denied for the configured workspace
+
+Scripts and agents should branch on the exit code and read the JSON for details.
+
+Examples:
+  $ cargo-ai doctor
+  $ cargo-ai doctor || echo "exit: $?"`)
+        .action(async () => {
+        let latestVersion;
+        try {
+            latestVersion = await fetchLatestVersion();
+        }
+        catch {
+            latestVersion = undefined;
+        }
+        const cli = buildCliCheck(currentVersion, latestVersion);
+        const skillsPin = buildSkillsPinCheck(currentVersion);
+        const config = getConfig();
+        const credentials = {
+            source: config.source,
+            baseUrl: config.baseUrl,
+            workspaceUuid: config.workspaceUuid !== undefined ? config.workspaceUuid : null,
+            credentialsFile: getCredentialsPath(),
+        };
+        const { check: api, exitCode } = await checkApi(config);
+        outputJson({
+            ok: exitCode === ExitCodes.Success,
+            checks: { cli, skillsPin, credentials, api },
+        });
+        process.exit(exitCode);
+    });
+}

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;AASxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA8JN"}
+{"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;AAaxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA+KN"}

package/build/commands/orchestration/action.js

@@ -1,4 +1,4 @@
-import { handleApiCall, outputJson, parseJson, pollBatchUntilFinished, pollRunUntilFinished, } from "../runHandler.js";
+import { applyRecordsLimit, ExitCodes, failWith, handleApiCall, outputJson, parseJson, parsePositiveInt, pollBatchUntilFinished, pollRunUntilFinished, } from "../runHandler.js";
 export function registerActionCommands(parent, getApi) {
     const action = parent
         .command("action")
@@ -37,15 +37,26 @@ Examples:
         .requiredOption("--records <json>", 'Records to process (JSON array, required). Example: \'[{"email":"a@b.com"},{"email":"c@d.com"}]\'')
         .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", "Poll the batch until it reaches a terminal status before returning (boolean flag)")
         .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
         .addHelpText("after", `
 Examples:
   $ cargo-ai orchestration action execute-batch --action '{"kind":"tool","toolUuid":"550e8400-...","config":{}}' --records '[{"email":"a@b.com"},{"email":"c@d.com"}]'
-  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message","config":{}}' --records '[{"channel":"#general"}]' --wait-until-finished`)
+  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message","config":{}}' --records '[{"channel":"#general"}]' --wait-until-finished
+  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"waterfall","actionSlug":"findEmail","config":{}}' --records "$(cat records.json)" --limit 1 --wait-until-finished`)
         .action(async (opts) => {
         const actionPayload = parseJson(opts.action, "--action");
-        const records = parseJson(opts.records, "--records");
+        let records = parseJson(opts.records, "--records");
+        if (opts.limit !== undefined) {
+            const limit = parsePositiveInt(opts.limit, "--limit");
+            if (Array.isArray(records) === false) {
+                failWith("--limit requires --records to be a JSON array.", {
+                    code: ExitCodes.InvalidUsage,
+                });
+            }
+            records = applyRecordsLimit(records, limit).records;
+        }
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.action.executeBatch({
             action: actionPayload,

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

@@ -1 +1 @@
-{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAexC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA2QN"}
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAexC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAgRN"}

package/build/commands/orchestration/batch.js

@@ -64,7 +64,7 @@ export function registerBatchCommands(parent, getApi) {
         .description("Create a batch. Pass --file to test-run a Workflow SDK module (compiled and " +
         "run as custom nodes, with @cargo-ai/cdk handles resolved from cargo.state.json — no deploy).")
         .option("--workflow-uuid <uuid>", "Workflow UUID (string)")
-        .requiredOption("--data <json>", 'Batch data source (JSON object, required). Supported kinds: {"kind":"segment","segmentUuid":"..."} or {"kind":"file","s3Filename":"..."}')
+        .requiredOption("--data <json>", 'Batch data source (JSON object, required). Kinds: {"kind":"segment","segmentUuid"}, {"kind":"file","s3Filename","mappings?"}, {"kind":"filter","modelUuid","filter?","sort?","limit?"}, {"kind":"recordIds","modelUuid","ids"}, {"kind":"records","records"}, {"kind":"change","changeUuid","changeKinds"}, {"kind":"runs","filter","reset"}')
         .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.")
@@ -93,11 +93,12 @@ Examples:
             nodes = parseJson(opts.nodes, "--nodes");
         }
         const api = getApi();
+        const data = parseJson(opts.data, "--data");
         const result = await handleApiCall(() => api.orchestration.batch.create({
             workflowUuid: opts.workflowUuid,
             releaseUuid: opts.releaseUuid,
             nodes,
-            data: parseJson(opts.data, "--data"),
+            data,
         }));
         if (opts.waitUntilFinished === true) {
             const intervalMs = parseInt(opts.pollingInterval, 10);

package/build/commands/runHandler.d.ts

@@ -31,6 +31,12 @@ export type Spinner = {
 };
 export declare function startSpinner(message: string): Spinner;
 export declare function parseJson(value: string, optionName: string): any;
+export declare function parsePositiveInt(value: string, optionName: string): number;
+export declare function applyRecordsLimit<T>(records: T[], limit: number): {
+    records: T[];
+    wasTruncated: boolean;
+    total: number;
+};
 type HandleApiCallOpts = {
     spinner?: string | false;
 };

package/build/commands/runHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runHandler.d.ts","sourceRoot":"","sources":["../../src/commands/runHandler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAclE,eAAO,MAAM,MAAM;aACR,MAAM,KAAG,MAAM;eACb,MAAM,KAAG,MAAM;gBACd,MAAM,KAAG,MAAM;cACjB,MAAM,KAAG,MAAM;aAChB,MAAM,KAAG,MAAM;cACd,MAAM,KAAG,MAAM;CAC1B,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM/C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAID,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhE;AAED,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,CAyBpE;AAKD,MAAM,MAAM,OAAO,GAAG;IAEpB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAGlC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA6CrD;AAGD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAQhE;AAKD,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC1B,CAAC;AAEF,wBAAsB,aAAa,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,CAAC,CAAC,CAiDZ;AAmFD,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EACvD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAWZ"}
+{"version":3,"file":"runHandler.d.ts","sourceRoot":"","sources":["../../src/commands/runHandler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAclE,eAAO,MAAM,MAAM;aACR,MAAM,KAAG,MAAM;eACb,MAAM,KAAG,MAAM;gBACd,MAAM,KAAG,MAAM;cACjB,MAAM,KAAG,MAAM;aAChB,MAAM,KAAG,MAAM;cACd,MAAM,KAAG,MAAM;CAC1B,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM/C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAID,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhE;AAED,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,CAyBpE;AAKD,MAAM,MAAM,OAAO,GAAG;IAEpB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAGlC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA6CrD;AAGD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAQhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,CAAC,EAAE,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASxD;AAKD,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC1B,CAAC;AAEF,wBAAsB,aAAa,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,CAAC,CAAC,CAiDZ;AAmFD,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EACvD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/build/commands/runHandler.js

@@ -131,6 +131,23 @@ export function parseJson(value, optionName) {
         });
     }
 }
+export function parsePositiveInt(value, optionName) {
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) === true || n < 1) {
+        failWith(`${optionName} must be a positive integer.`, {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    return n;
+}
+export function applyRecordsLimit(records, limit) {
+    const total = records.length;
+    if (limit < total) {
+        info(`Piloting: submitting the first ${String(limit)} of ${String(total)} record(s). Re-run without --limit for the full set.`);
+        return { records: records.slice(0, limit), wasTruncated: true, total };
+    }
+    return { records, wasTruncated: false, total };
+}
 const SPINNER_DELAY_MS = 200;
 const DEFAULT_SPINNER_MESSAGE = "Loading...";
 export async function handleApiCall(fn, opts) {

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAEvE,MAAM,MAAM,MAAM,GAAG;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAIF,wBAAgB,SAAS,IAAI,MAAM,CA4BlC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAEvE,MAAM,MAAM,MAAM,GAAG;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,wBAAgB,SAAS,IAAI,MAAM,CAclC"}

package/build/config.js

@@ -1,47 +1,15 @@
+import { loadProjectEnv, resolveAuthConfig } from "@cargo-ai/cdk/cli";
 import { loadCredentials } from "./credentials.js";
-const DEFAULT_BASE_URL = "https://api.getcargo.io";
 export function getConfig() {
+    // Fold project `.env` into the environment first (never overriding explicit
+    // exports): a repo pinned to one workspace must win over a personal login.
+    loadProjectEnv();
     const credentials = loadCredentials();
-    const envToken = process.env["CARGO_API_TOKEN"];
-    let accessToken;
-    let source;
-    if (envToken !== undefined) {
-        accessToken = envToken;
-        source = "environment";
-    }
-    else if (credentials !== undefined &&
-        credentials.accessToken !== undefined) {
-        accessToken = credentials.accessToken;
-        source = "credentials-file";
-    }
-    else {
-        accessToken = undefined;
-        source = "none";
-    }
+    const resolved = resolveAuthConfig(process.env, credentials);
     return {
-        accessToken,
-        baseUrl: getBaseUrl(credentials),
-        workspaceUuid: getWorkspaceUuid(credentials),
-        source,
+        accessToken: resolved.accessToken,
+        baseUrl: resolved.baseUrl,
+        workspaceUuid: resolved.workspaceUuid,
+        source: resolved.tokenSource,
     };
 }
-const getBaseUrl = (credentials) => {
-    const envUrl = process.env["CARGO_BASE_URL"];
-    if (envUrl !== undefined) {
-        return envUrl;
-    }
-    if (credentials !== undefined && credentials.baseUrl !== undefined) {
-        return credentials.baseUrl;
-    }
-    return DEFAULT_BASE_URL;
-};
-const getWorkspaceUuid = (credentials) => {
-    const envUuid = process.env["CARGO_WORKSPACE_UUID"];
-    if (envUuid !== undefined) {
-        return envUuid;
-    }
-    if (credentials !== undefined) {
-        return credentials.workspaceUuid;
-    }
-    return undefined;
-};

package/build/index.js

@@ -9,6 +9,7 @@ import { registerBillingCommands } from "./commands/billing/index.js";
 import { registerConnectionCommands } from "./commands/connection/index.js";
 import { registerContentCommands } from "./commands/content/index.js";
 import { registerContextCommands } from "./commands/context/index.js";
+import { registerDoctorCommand } from "./commands/doctor.js";
 import { registerExpressionCommands } from "./commands/expression/index.js";
 import { registerHostingCommands } from "./commands/hosting/index.js";
 import { registerInitCommand } from "./commands/init.js";
@@ -59,6 +60,7 @@ const getApi = () => {
 };
 registerAuthCommands(program, getApi);
 registerVersionCommand(program, version);
+registerDoctorCommand(program, version);
 registerInitCommand(program, getApi);
 registerOrchestrationCommands(program, getApi);
 registerWorkspaceManagementCommands(program, getApi);

package/build/proxy.d.ts

@@ -1,22 +1,7 @@
-import type { ClientTransport } from "@cargo-ai/api";
-/**
- * Build Axios transport overrides that tunnel requests through an
- * HTTP/HTTPS proxy when one is configured via the standard proxy env
- * vars (`HTTPS_PROXY`, `HTTP_PROXY`, `ALL_PROXY`, honoring `NO_PROXY`).
- *
- * This works around Axios' unreliable built-in proxy handling, which can
- * fall into a 308 redirect loop (`ERR_FR_TOO_MANY_REDIRECTS`) for HTTPS
- * targets inside proxied environments such as cloud agent sandboxes. We
- * disable Axios' env-based proxy (`proxy: false`) and tunnel via the
- * dedicated proxy agents instead.
- *
- * Returns `undefined` when no proxy applies, so the client keeps its
- * default direct-egress behavior.
- */
-export declare const getProxyTransport: (targetUrl: string) => ClientTransport | undefined;
 /**
  * Build a `fetch` implementation that tunnels through an HTTP/HTTPS proxy
- * when one is configured via the same env vars as {@link getProxyTransport}.
+ * when one is configured via the standard proxy env vars (`HTTPS_PROXY`,
+ * `HTTP_PROXY`, `ALL_PROXY`, honoring `NO_PROXY`).
  *
  * Node's built-in `fetch` (and therefore MCP's `StreamableHTTPClientTransport`)
  * does not honor `HTTPS_PROXY` / `HTTP_PROXY` on its own. Callers that need

package/build/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAmErD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,cACjB,MAAM,KAChB,eAAe,GAAG,SAWpB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,cACb,MAAM,YAER,MAAM,GAAG,GAAG,SAAS,WAAW,KAAK,QAAQ,QAAQ,CAAC,aAchE,CAAC"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAgEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,cACb,MAAM,YAER,MAAM,GAAG,GAAG,SAAS,WAAW,KAAK,QAAQ,QAAQ,CAAC,aAchE,CAAC"}

package/build/proxy.js

@@ -1,5 +1,3 @@
-import { HttpProxyAgent } from "http-proxy-agent";
-import { HttpsProxyAgent } from "https-proxy-agent";
 import { fetch as undiciFetch, ProxyAgent, } from "undici";
 const getEnv = (...names) => {
     for (const name of names) {
@@ -48,34 +46,10 @@ const resolveProxyUrl = (targetUrl) => {
         ? getEnv("HTTPS_PROXY", "https_proxy", "ALL_PROXY", "all_proxy")
         : getEnv("HTTP_PROXY", "http_proxy", "ALL_PROXY", "all_proxy");
 };
-/**
- * Build Axios transport overrides that tunnel requests through an
- * HTTP/HTTPS proxy when one is configured via the standard proxy env
- * vars (`HTTPS_PROXY`, `HTTP_PROXY`, `ALL_PROXY`, honoring `NO_PROXY`).
- *
- * This works around Axios' unreliable built-in proxy handling, which can
- * fall into a 308 redirect loop (`ERR_FR_TOO_MANY_REDIRECTS`) for HTTPS
- * targets inside proxied environments such as cloud agent sandboxes. We
- * disable Axios' env-based proxy (`proxy: false`) and tunnel via the
- * dedicated proxy agents instead.
- *
- * Returns `undefined` when no proxy applies, so the client keeps its
- * default direct-egress behavior.
- */
-export const getProxyTransport = (targetUrl) => {
-    const proxyUrl = resolveProxyUrl(targetUrl);
-    if (proxyUrl === undefined) {
-        return undefined;
-    }
-    return {
-        httpAgent: new HttpProxyAgent(proxyUrl),
-        httpsAgent: new HttpsProxyAgent(proxyUrl),
-        proxy: false,
-    };
-};
 /**
  * Build a `fetch` implementation that tunnels through an HTTP/HTTPS proxy
- * when one is configured via the same env vars as {@link getProxyTransport}.
+ * when one is configured via the standard proxy env vars (`HTTPS_PROXY`,
+ * `HTTP_PROXY`, `ALL_PROXY`, honoring `NO_PROXY`).
  *
  * Node's built-in `fetch` (and therefore MCP's `StreamableHTTPClientTransport`)
  * does not honor `HTTPS_PROXY` / `HTTP_PROXY` on its own. Callers that need

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.35",
+  "version": "1.0.37",
   "private": false,
   "license": "UNLICENSED",
   "description": "Command-line interface for the Cargo API",
@@ -30,17 +30,15 @@
     "format:check": "prettier --check ."
   },
   "dependencies": {
-    "@cargo-ai/api": "^1.0.42",
+    "@cargo-ai/api": "^1.0.47",
     "@cargo-ai/app-sdk": "^1.0.5",
     "@cargo-ai/cdk": "*",
     "@cargo-ai/types": "*",
-    "@cargo-ai/worker-sdk": "^1.0.6",
+    "@cargo-ai/worker-sdk": "^1.0.10",
     "@modelcontextprotocol/sdk": "1.29.0",
     "commander": "^12.1.0",
-    "http-proxy-agent": "^9.1.0",
-    "https-proxy-agent": "^9.1.0",
     "tsx": "^4.19.2",
-    "undici": "^7.24.8"
+    "undici": "^7.28.0"
   },
   "devDependencies": {
     "@cargo-ai/eslint-config": "*",