@cargo-ai/cli 1.0.72 → 1.0.74

package/README.md

@@ -234,6 +234,27 @@ npm run type:check
 npm run lint:check
 ```
 
+### Declaring an option's values
+
+An option with a closed set of values lists them in its placeholder, never in
+its description:
+
+```ts
+.option("--format <csv|json>", "Export format")
+.option("--statuses <idle,pending,success>", "Filter by statuses")
+.option("--is-finished [true|false]", "Only return finished runs")
+```
+
+A pipe means "one of these", a comma means "any of these, comma-separated", and
+that is the whole grammar. Commander treats the placeholder as a display name,
+so this changes nothing at parse time — but `--help` shows the set, and the
+interactive palette turns it into a menu rather than an empty text field. Values
+written into the description instead are invisible to both.
+
+Use commander's own `.choices()` only when the CLI should _reject_ anything
+else. It usually should not: the API owns these lists, and a value it starts
+accepting would be refused here until someone noticed.
+
 ## License
 
 See the project for license information.

package/build/commands/ai/agent.js

@@ -23,7 +23,7 @@ export function registerAgentCommands(parent, getApi) {
         .command("create")
         .description("Create an agent")
         .requiredOption("--name <name>", "Agent name (string, required)")
-        .requiredOption("--icon-color <color>", "Icon color (string, required). Allowed values: grey, green, purple, yellow, blue, red")
+        .requiredOption("--icon-color <grey|green|purple|yellow|blue|red>", "Icon color (string, required)")
         .requiredOption("--icon-face <face>", "Icon face identifier (string, required)")
         .option("--description <text>", "Agent description (string)")
         .option("--folder-uuid <uuid>", "Folder UUID to place the agent in (string)")
@@ -65,7 +65,7 @@ Trigger object shape:
         .description("Update an agent")
         .requiredOption("--uuid <uuid>", "Agent UUID (string, required)")
         .option("--name <name>", "Agent name (string)")
-        .option("--icon-color <color>", "Icon color (string). Allowed values: grey, green, purple, yellow, blue, red")
+        .option("--icon-color <grey|green|purple|yellow|blue|red>", "Icon color (string)")
         .option("--icon-face <face>", "Icon face identifier (string)")
         .option("--description <text>", "Agent description (string)")
         .option("--folder-uuid <uuid>", "Folder UUID (string)")

package/build/commands/ai/chat.js

@@ -9,7 +9,7 @@ export function registerChatCommands(parent, getApi) {
         .option("--agent-uuid <uuid>", "Filter by agent UUID (string)")
         .option("--release-uuid <uuid>", "Filter by release UUID (string)")
         .option("--user-uuid <uuid>", "Filter by user UUID (string)")
-        .option("--trigger-type <type>", "Filter by trigger type (string: chat, draft, cron, ...)")
+        .option("--trigger-type <chat|connector|draft|web_extension|app|schedule|workflow>", "Filter by trigger type")
         .option("--search <text>", "Case-insensitive partial match on chat name or slug")
         .option("--limit <n>", "Max results to return (integer)")
         .option("--offset <n>", "Number of results to skip (integer)")

package/build/commands/ai/document.js

@@ -30,7 +30,7 @@ export function registerDocumentCommands(parent, getApi) {
         .command("create")
         .description("Create a document")
         .requiredOption("--uuid <uuid>", "Document UUID")
-        .requiredOption("--kind <kind>", "Document kind")
+        .requiredOption("--kind <text|code|image|sheet>", "Document kind")
         .requiredOption("--title <title>", "Document title")
         .requiredOption("--content <content>", "Document content")
         .action(async (opts) => {

package/build/commands/ai/memory.js

@@ -4,7 +4,7 @@ export function registerMemoryCommands(parent, getApi) {
     memory
         .command("list")
         .description("List memories")
-        .requiredOption("--scope <scope>", "Scope (user, agent)")
+        .requiredOption("--scope <user|agent>", "Scope")
         .option("--agent-uuid <uuid>", "Agent UUID (required when scope is agent)")
         .action(async (opts) => {
         const api = getApi();
@@ -18,7 +18,7 @@ export function registerMemoryCommands(parent, getApi) {
         .command("remove")
         .description("Remove a memory")
         .requiredOption("--mem0-id <id>", "Memory ID")
-        .requiredOption("--scope <scope>", "Scope (user, agent)")
+        .requiredOption("--scope <user|agent>", "Scope")
         .option("--agent-uuid <uuid>", "Agent UUID (required when scope is agent)")
         .action(async (opts) => {
         const api = getApi();
@@ -33,7 +33,7 @@ export function registerMemoryCommands(parent, getApi) {
         .description("Update a memory")
         .requiredOption("--mem0-id <id>", "Memory ID")
         .requiredOption("--content <text>", "Memory content")
-        .requiredOption("--scope <scope>", "Scope (user, agent)")
+        .requiredOption("--scope <user|agent>", "Scope")
         .option("--agent-uuid <uuid>", "Agent UUID (required when scope is agent)")
         .action(async (opts) => {
         const api = getApi();

package/build/commands/ai/message.js

@@ -21,14 +21,14 @@ export function registerMessageCommands(parent, getApi) {
         .option("--capabilities <json>", "Capabilities to enable (JSON array of capability objects)")
         .option("--mcp-clients <json>", "MCP clients to connect (JSON array of MCP client objects)")
         .option("--system-prompt <text>", "System prompt override (string)")
-        .option("--with-reasoning [value]", "Enable reasoning mode (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--with-reasoning [true|false]", "Enable reasoning mode (defaults to true when passed bare)", parseBooleanOption)
         .option("--temperature <n>", "Sampling temperature (float, 0.0-1.0)")
         .option("--max-steps <n>", "Maximum number of agentic steps (integer)")
         .option("--integration-slug <slug>", "Integration slug (string)")
         .option("--connector-uuid <uuid>", "Connector UUID (string)")
         .option("--language-model-slug <slug>", "Language model slug (string)")
         .option("--output <json>", 'Output format for the assistant message (JSON object, e.g. \'{"type":"text"}\' or \'{"type":"jsonSchema","jsonSchema":{...}}\'). Defaults to text when omitted.')
-        .option("--wait-until-finished [value]", "Poll the assistant message until finished before returning (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--wait-until-finished [true|false]", "Poll the assistant message until finished 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/ai/release.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA6SN"}
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA0SN"}

package/build/commands/ai/release.js

@@ -9,7 +9,7 @@ export function registerReleaseCommands(parent, getApi) {
         .description("List AI releases")
         .option("--agent-uuid <uuid>", "Filter by agent UUID (string)")
         .option("--user-uuid <uuid>", "Filter by user UUID (string)")
-        .option("--statuses <statuses>", "Filter by statuses (comma-separated: draft,deployed,archived)")
+        .option("--statuses <draft,deployed,archived>", "Filter by statuses")
         .option("--limit <n>", "Max results to return (integer)")
         .option("--offset <n>", "Number of results to skip (integer)")
         .action(async (opts) => {
@@ -57,7 +57,7 @@ export function registerReleaseCommands(parent, getApi) {
         .requiredOption("--agent-uuid <uuid>", "Agent UUID (string, required)")
         .option("--parent-uuid <uuid>", "Parent release UUID to inherit from (string)")
         .option("--system-prompt <text>", "System prompt (string)")
-        .option("--with-reasoning [value]", "Enable reasoning mode (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--with-reasoning [true|false]", "Enable reasoning mode (defaults to true when passed bare)", parseBooleanOption)
         .option("--temperature <n>", "Sampling temperature (float, 0.0-1.0)")
         .option("--max-steps <n>", "Maximum agentic steps (integer)")
         .option("--integration-slug <slug>", "LLM integration slug (string)")
@@ -129,7 +129,7 @@ Set "isReadOnly": false on a model resource to grant the agent write tools (inse
         .requiredOption("--capabilities <json>", "Capabilities to enable (JSON array, required)")
         .requiredOption("--suggested-actions <json>", "Suggested actions for chat UI (JSON array, required)")
         .option("--system-prompt <text>", "System prompt (string)")
-        .option("--with-reasoning [value]", "Enable reasoning mode (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--with-reasoning [true|false]", "Enable reasoning mode (defaults to true when passed bare)", parseBooleanOption)
         .option("--temperature <n>", "Sampling temperature (float, 0.0-1.0)")
         .option("--max-steps <n>", "Maximum agentic steps (integer)")
         .option("--connector-uuid <uuid>", "Connector UUID (string)")

package/build/commands/ai/vote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vote.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/vote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAsC7E"}
+{"version":3,"file":"vote.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/vote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA0C7E"}

package/build/commands/ai/vote.js

@@ -7,7 +7,7 @@ export function registerVoteCommands(parent, getApi) {
         .description("Upsert a vote")
         .requiredOption("--chat-uuid <uuid>", "Chat UUID")
         .requiredOption("--message-uuid <uuid>", "Message UUID")
-        .option("--is-upvoted [value]", "Upvote the message", parseBooleanOption)
+        .option("--is-upvoted [true|false]", "Upvote the message", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.ai.vote.upsert({

package/build/commands/auth/email.d.ts

@@ -1,3 +1,4 @@
+import type { ResolvedWorkspace } from "./workspace.js";
 /** `--code -` reads the code from stdin, keeping it out of shell history. */
 export declare const STDIN_CODE = "-";
 export type EmailLoginOptions = {
@@ -6,11 +7,34 @@ export type EmailLoginOptions = {
     workspaceName?: string;
     workspaceUuid?: string;
     baseUrl?: string;
+    /**
+     * What to re-run when a code was sent but there is no terminal to type it
+     * into. Defaults to the `login` form. `start` passes its own, because
+     * finishing through `login` would sign the user in and stop there, losing
+     * the destination the run was headed for.
+     */
+    resumeCommand?: string;
+};
+export type EmailSignInResult = {
+    outcome: "signedIn";
+    email: string;
+    workspace: ResolvedWorkspace;
+}
+/** The code was sent, but there is no terminal to type it back into. */
+ | {
+    outcome: "codeSent";
+    email: string;
+    next: string;
 };
 /**
  * Signs in with a code emailed by the identity provider, creating the account
  * on first use. This is the only channel that needs neither a browser nor an
  * existing credential.
+ *
+ * Returns rather than prints, because two callers need the same exchange and
+ * report it differently: `login` writes the JSON result a script reads, while
+ * `start` carries on to the next question.
  */
+export declare function signInWithEmail(opts: EmailLoginOptions): Promise<EmailSignInResult>;
 export declare function runEmailLogin(opts: EmailLoginOptions): Promise<void>;
 //# sourceMappingURL=email.d.ts.map

package/build/commands/auth/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/email.ts"],"names":[],"mappings":"AAcA,6EAA6E;AAC7E,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C1E"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/email.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE;AACtE,wEAAwE;GACtE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA8B5B;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1E"}

package/build/commands/auth/email.js

@@ -10,24 +10,22 @@ export const STDIN_CODE = "-";
  * Signs in with a code emailed by the identity provider, creating the account
  * on first use. This is the only channel that needs neither a browser nor an
  * existing credential.
+ *
+ * Returns rather than prints, because two callers need the same exchange and
+ * report it differently: `login` writes the JSON result a script reads, while
+ * `start` carries on to the next question.
  */
-export async function runEmailLogin(opts) {
+export async function signInWithEmail(opts) {
     const email = opts.email;
     if (email === undefined || email.length === 0) {
         failWith("Must pass --email <email>.", { code: ExitCodes.InvalidUsage });
     }
-    const resumeCommand = `cargo-ai login --email ${email} --code <code>`;
+    const resumeCommand = opts.resumeCommand !== undefined
+        ? opts.resumeCommand
+        : `cargo-ai login --email ${email} --code <code>`;
     const code = await resolveCode({ email, code: opts.code, resumeCommand });
     if (code === undefined) {
-        // The code was sent but there is no terminal to type it into. Exit
-        // successfully so an agent can relay the code and re-run non-interactively.
-        outputJson({
-            ok: true,
-            status: "codeSent",
-            email,
-            next: resumeCommand,
-        });
-        return;
+        return { outcome: "codeSent", email, next: resumeCommand };
     }
     const spinner = startSpinner("Verifying code...");
     const tokens = await exchangeEmailOtp({ email, otp: code });
@@ -38,15 +36,30 @@ export async function runEmailLogin(opts) {
         workspaceUuid: opts.workspaceUuid,
         workspaceName: opts.workspaceName,
     });
-    success(`Signed in as ${email}. Workspace: ${workspace.name}.`);
+    return { outcome: "signedIn", email, workspace };
+}
+export async function runEmailLogin(opts) {
+    const result = await signInWithEmail(opts);
+    if (result.outcome === "codeSent") {
+        // Exit successfully so an agent can relay the code and re-run
+        // non-interactively.
+        outputJson({
+            ok: true,
+            status: "codeSent",
+            email: result.email,
+            next: result.next,
+        });
+        return;
+    }
+    success(`Signed in as ${result.email}. Workspace: ${result.workspace.name}.`);
     info(AGENT_SKILLS_NEXT_STEP);
     outputJson({
         ok: true,
         status: "signedIn",
         credentialsFile: getCredentialsPath(),
         baseUrl: resolveBaseUrl(opts.baseUrl),
-        email,
-        workspace,
+        email: result.email,
+        workspace: result.workspace,
         tokenType: "session",
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAGjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA0BxD,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAsIN;AAiGD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,IAAI,EAAE,aAAa,GAClB,cAAc,CAchB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAGjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA2BxD,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAsIN;AA2GD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,IAAI,EAAE,aAAa,GAClB,cAAc,CAchB"}

package/build/commands/auth/index.js

@@ -5,6 +5,7 @@ import { getConfig } from "../../config.js";
 import { clearCredentials, CredentialsNotClearedError, getCredentialsPath, loadCredentials, saveCredentials, } from "../../credentials.js";
 import { parseBooleanOption } from "../../utils/booleanOption.js";
 import { ExitCodes, failWith, handleApiCall, info, outputJson, success, } from "../runHandler.js";
+import { clearStartState } from "../start/state.js";
 import { runEmailLogin } from "./email.js";
 import { selectLoginChannel } from "./loginChannel.js";
 import { runOAuthDeviceFlow } from "./oauth.js";
@@ -15,7 +16,7 @@ export function registerAuthCommands(program, getApi) {
         .description("Sign in to Cargo with an emailed code (--email), via browser (--oauth), or with an existing API token (--token)")
         .option("--email <email>", "Sign in with a code emailed to this address; creates the account on first use")
         .option("--code <code>", 'Verification code from the email, or "-" to read it from stdin; omit to have one sent (--email only)')
-        .option("--oauth [value]", "Sign in via browser using the OAuth 2.0 Device Authorization Flow", parseBooleanOption)
+        .option("--oauth [true|false]", "Sign in via browser using the OAuth 2.0 Device Authorization Flow", parseBooleanOption)
         .option("--token <token>", "Existing Cargo API token")
         .option("--workspace-name <name>", "Workspace to use, created if no workspace of that name exists (skips the workspace prompt)")
         .option("--workspace-uuid <uuid>", "Workspace UUID to sign in for (skips the workspace prompt)")
@@ -82,7 +83,7 @@ Environment variables (CARGO_API_TOKEN, CARGO_WORKSPACE_UUID, CARGO_BASE_URL) ta
     program
         .command("logout")
         .description("Sign out: revoke the saved credential and remove it locally")
-        .option("--keep-token [value]", "Only forget the credentials locally, leaving the session or token valid", parseBooleanOption)
+        .option("--keep-token [true|false]", "Only forget the credentials locally, leaving the session or token valid", parseBooleanOption)
         // The credential is usually a session now, so accept the name people reach
         // for; --keep-token stays the documented spelling for existing scripts.
         .addOption(new Option("--keep-session").hideHelp())
@@ -171,16 +172,21 @@ async function runLogout(opts) {
         }
         throw error;
     }
+    // Not conditional on `removed`: someone whose credential was an environment
+    // variable, or who is signing out a second time, still means "start over".
+    const startStateCleared = clearStartState();
     if (removed === true) {
         success(revoked === true ? "Signed out and revoked access." : "Signed out.");
     }
     else {
-        info("No saved credentials to remove.");
+        info("No saved credentials to remove — nothing was signed in through this CLI.");
+        info("If commands still work, the token is coming from CARGO_API_TOKEN or a project .env.");
     }
     outputJson({
         ok: true,
         removed,
         revoked,
+        startStateCleared,
         credentialsFile: getCredentialsPath(),
     });
 }

package/build/commands/auth/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/workspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAYzD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,mFAAmF;IACnF,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2H/B;AAcD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,mBAAmB,CAAC,SAAS,EAAE,EACpD,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CAY/B"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/workspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAazD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,mFAAmF;IACnF,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAUF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkG/B;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,mBAAmB,CAAC,SAAS,EAAE,EACpD,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CAY/B"}

package/build/commands/auth/workspace.js

@@ -1,7 +1,14 @@
 import * as readline from "node:readline/promises";
+import { askText, isInteractive, selectOne } from "@cargo-ai/cdk/cli";
 import { createApi } from "../../api.js";
 import { askQuestion, openPromptInput } from "../../utils/prompt.js";
 import { ExitCodes, failWith, handleApiCall, info, success, } from "../runHandler.js";
+/**
+ * The "make me a new one" row. A leading space keeps it out of the uuid
+ * namespace, so it can never collide with a real workspace.
+ */
+const CREATE = " create";
+const DEFAULT_WORKSPACE_NAME = "My workspace";
 export async function resolveWorkspace(opts) {
     const accessToken = opts.accessToken;
     const api = createApi({
@@ -34,28 +41,6 @@ export async function resolveWorkspace(opts) {
             wasCreated: false,
         };
     }
-    if (workspaces.length === 0) {
-        const promptInput = openPromptInput();
-        if (promptInput === undefined) {
-            failWith("No workspaces found. Re-run with --workspace-name <name> to create one.", { code: ExitCodes.NotFound });
-        }
-        let name;
-        try {
-            info("You don't have any workspaces yet. Let's create one.");
-            name = await askQuestion(promptInput.stream, "Workspace name (or press Enter to skip): ");
-        }
-        finally {
-            promptInput.close();
-        }
-        if (name === undefined) {
-            failWith("No workspace name provided.", {
-                code: ExitCodes.InvalidUsage,
-            });
-        }
-        const workspace = await createWorkspace(api, name);
-        success(`Created workspace: ${workspace.name} (${workspace.uuid})`);
-        return { workspace, wasCreated: true };
-    }
     if (workspaces.length === 1) {
         const [firstWorkspace] = workspaces;
         if (firstWorkspace === undefined) {
@@ -66,6 +51,15 @@ export async function resolveWorkspace(opts) {
             wasCreated: false,
         };
     }
+    // Picking an existing workspace and creating one are the same decision, so
+    // they are one question rather than two branches with two different pieces
+    // of UI. The readline path below stays for the terminals clack cannot use.
+    if (isInteractive() === true) {
+        return await chooseWorkspace(api, workspaces);
+    }
+    if (workspaces.length === 0) {
+        return await createWorkspaceByAsking(api);
+    }
     const promptInput = openPromptInput();
     if (promptInput === undefined) {
         failWith("Multiple workspaces available and no interactive terminal; pass --workspace-uuid <uuid> (or set CARGO_WORKSPACE_UUID when using install.sh) to select one.", { code: ExitCodes.InvalidUsage });
@@ -82,10 +76,6 @@ export async function resolveWorkspace(opts) {
     }
     return { workspace: selectedWorkspace, wasCreated: false };
 }
-async function createWorkspace(api, name) {
-    const result = await handleApiCall(() => api.workspaceManagement.workspace.create({ name }), { spinner: "Creating workspace..." });
-    return { uuid: result.workspace.uuid, name: result.workspace.name };
-}
 export function findWorkspaceByName(workspaces, name) {
     const wanted = name.trim().toLowerCase();
     const matched = workspaces.find((workspace) => {
@@ -96,6 +86,89 @@ export function findWorkspaceByName(workspaces, name) {
     }
     return { uuid: matched.uuid, name: matched.name };
 }
+/** Pick from the workspaces you have, or name a new one, in one question. */
+async function chooseWorkspace(api, workspaces) {
+    if (workspaces.length === 0) {
+        info("You don't have any workspaces yet. Let's create one.");
+        return {
+            workspace: await createWorkspace(api, await askWorkspaceName()),
+            wasCreated: true,
+        };
+    }
+    const chosen = await selectOne({
+        // First, not last: past a dozen workspaces the list scrolls, and a create
+        // row at the bottom is off-screen — reachable only by someone who already
+        // guessed to type "create". The cursor still starts on the first
+        // workspace, so the row is visible without Enter landing on it.
+        message: "Which workspace should this CLI work in?",
+        recommended: workspaces[0] === undefined ? CREATE : workspaces[0].uuid,
+        choices: [
+            {
+                value: CREATE,
+                label: "+ Create a new workspace",
+                hint: "you name it",
+                fallback: true,
+            },
+            ...workspaces.map((workspace) => ({
+                value: workspace.uuid,
+                label: workspace.name,
+                hint: workspace.uuid,
+            })),
+        ],
+    });
+    if (chosen === CREATE) {
+        return {
+            workspace: await createWorkspace(api, await askWorkspaceName()),
+            wasCreated: true,
+        };
+    }
+    const selected = workspaces.find((workspace) => workspace.uuid === chosen);
+    if (selected === undefined) {
+        failWith("No workspace selected.", { code: ExitCodes.InvalidUsage });
+    }
+    return {
+        workspace: { uuid: selected.uuid, name: selected.name },
+        wasCreated: false,
+    };
+}
+async function askWorkspaceName() {
+    return await askText({
+        message: "Name it",
+        placeholder: DEFAULT_WORKSPACE_NAME,
+        defaultValue: DEFAULT_WORKSPACE_NAME,
+    });
+}
+/**
+ * The zero-workspace path for terminals clack cannot drive — `curl | sh`
+ * installers pipe stdin while the controlling terminal stays reachable through
+ * /dev/tty, and this is what reads it.
+ */
+async function createWorkspaceByAsking(api) {
+    const promptInput = openPromptInput();
+    if (promptInput === undefined) {
+        failWith("No workspaces found. Re-run with --workspace-name <name> to create one.", { code: ExitCodes.NotFound });
+    }
+    let name;
+    try {
+        info("You don't have any workspaces yet. Let's create one.");
+        name = await askQuestion(promptInput.stream, "Workspace name (or press Enter to skip): ");
+    }
+    finally {
+        promptInput.close();
+    }
+    if (name === undefined) {
+        failWith("No workspace name provided.", {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    const workspace = await createWorkspace(api, name);
+    success(`Created workspace: ${workspace.name} (${workspace.uuid})`);
+    return { workspace, wasCreated: true };
+}
+async function createWorkspace(api, name) {
+    const result = await handleApiCall(() => api.workspaceManagement.workspace.create({ name }), { spinner: "Creating workspace..." });
+    return { uuid: result.workspace.uuid, name: result.workspace.name };
+}
 async function promptWorkspaceSelection(workspaces, input) {
     const rl = readline.createInterface({
         input,

package/build/commands/billing/subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/commands/billing/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAwFxC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuSN"}
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/commands/billing/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAwFxC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAoSN"}

package/build/commands/billing/subscription.js

@@ -86,7 +86,7 @@ Example:
         .option("--card-number <number>", "Card number")
         .option("--card-exp <MM/YYYY>", "Card expiry, e.g. 12/2030")
         .option("--card-cvc <cvc>", "Card security code")
-        .option("--card-stdin [value]", 'Read {"number","expMonth","expYear","cvc"} as JSON from stdin', parseBooleanOption)
+        .option("--card-stdin [true|false]", 'Read {"number","expMonth","expYear","cvc"} as JSON from stdin', parseBooleanOption)
         .option("--timeout <seconds>", `Hosted-form mode: how long to wait for the card to change (default: ${String(DEFAULT_TIMEOUT_SECONDS)})`)
         .option("--poll-interval <seconds>", `Hosted-form mode: how often to check for the new card (default: ${String(DEFAULT_POLL_INTERVAL_SECONDS)})`)
         .option("--no-open", "Hosted-form mode: print the URL without launching a browser")
@@ -160,7 +160,7 @@ Example:
         .command("update-plan")
         .description("Change the credit allotment and billing cadence")
         .requiredOption("--credits-count <n>", "Number of credits per period")
-        .requiredOption("--cadence <cadence>", "Billing cadence. Allowed values: monthly, yearly")
+        .requiredOption("--cadence <monthly|yearly>", "Billing cadence")
         .addHelpText("after", `
 Examples:
   $ cargo-ai billing subscription update-plan --credits-count 10000 --cadence monthly
@@ -176,7 +176,7 @@ Examples:
     subscription
         .command("update-topup")
         .description("Configure automatic credit top-ups")
-        .option("--enabled [value]", "Enable automatic top-ups (omit to disable)", parseBooleanOption)
+        .option("--enabled [true|false]", "Enable automatic top-ups (omit to disable)", parseBooleanOption)
         .requiredOption("--credits-count <n>", "Number of credits to add per top-up")
         .requiredOption("--threshold <n>", "Trigger top-up when remaining credits drop below this number")
         .addHelpText("after", `

package/build/commands/billing/usage.d.ts.map

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

package/build/commands/billing/usage.js

@@ -13,7 +13,7 @@ export function registerUsageCommands(parent, getApi) {
         .option("--slug <slug>", "Slug")
         .option("--agent-uuid <uuid>", "Agent UUID")
         .option("--group-by <value>", "Group by field")
-        .option("--unit <unit>", "Usage unit")
+        .option("--unit <billing.credits|storage.records|orchestration.executions>", "Usage unit")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.billing.usage.getMetrics({

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

@@ -1 +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,CAwHN"}
+{"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,CA2HN"}

package/build/commands/connection/action.js

@@ -9,7 +9,7 @@ export function registerActionSearchCommands(parent, getApi) {
         .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("--category <engagement|marketing|sales|finance|analytics|freeform|success|support|enrichment|storage|custom>", "Filter by integration category")
         .option("--integration <slug>", "Filter by integration slug (string)")
         .option("--credits-only", "Only return credits-based (paid) actions (presence flag)")
         .option("--limit <n>", `Maximum results to return (integer, default: ${String(DEFAULT_LIMIT)})`, String(DEFAULT_LIMIT))

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

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAwPN"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/connector.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAcxC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA6TN"}