@cargo-ai/cli 1.0.73 → 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/index.js

@@ -16,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)")
@@ -83,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())

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.js

@@ -49,7 +49,7 @@ export function registerConnectorCommands(parent, getApi) {
         .requiredOption("--slug <slug>", "Field slug to autocomplete (string, required)")
         .requiredOption("--params <json>", "Autocomplete parameters (JSON object, required)")
         .option("--value <value>", "Search value to filter results (string)")
-        .option("--refresh [value]", "Refresh cached results (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--refresh [true|false]", "Refresh cached results (defaults to true when passed bare)", parseBooleanOption)
         .option("--variables <json>", "Additional variables (JSON object)")
         .action(async (opts) => {
         const api = getApi();

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

@@ -1 +1 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAoGN"}
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuGN"}

package/build/commands/connection/integration.js

@@ -6,7 +6,7 @@ export function registerIntegrationCommands(parent, getApi) {
     integration
         .command("list")
         .description("List all integrations")
-        .option("--category <category>", "Filter by category (string)")
+        .option("--category <engagement|marketing|sales|finance|analytics|freeform|success|support|enrichment|storage|custom>", "Filter by category")
         .option("--slugs <list>", "Filter by integration slugs (comma-separated strings)")
         .option("--search <search>", "Search by name, case-insensitive (string)")
         .option("--has-actions <bool>", 'Filter by presence of actions (string: "true" or "false")')

package/build/commands/content/library.js

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

package/build/commands/context/runtime.js

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

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

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

package/build/commands/expression/recipe.js

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

package/build/commands/mailboxManagement/event.js

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

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

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

package/build/commands/mailboxManagement/mailbox.js

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

package/build/commands/mailboxManagement/message.js

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

package/build/commands/mailboxManagement/suppression.js

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

package/build/commands/mailboxManagement/thread.js

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

package/build/commands/observability/alert.js

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

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

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

package/build/commands/orchestration/action.js

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