@cargo-ai/cli 1.0.73 → 1.0.74

package/build/commands/orchestration/batch.js

@@ -13,12 +13,12 @@ export function registerBatchCommands(parent, getApi) {
         .option("--parent-batch-uuid <uuid>", "Filter by parent batch UUID (string)")
         .option("--parent-run-uuid <uuid>", "Filter by parent run UUID (string)")
         .option("--parent-node-uuid <uuid>", "Filter by parent node UUID (string)")
-        .option("--statuses <list>", "Filter by statuses (comma-separated: pending,syncing,skipped,querying,running,success,cancelling,error,cancelled)")
-        .option("--has-runs [value]", "Only return batches that have runs (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--is-skipped [value]", "Only return skipped batches (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--is-finished [value]", "Only return finished batches (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--included-data-kinds <list>", "Include only these data kinds (comma-separated strings)")
-        .option("--excluded-data-kinds <list>", "Exclude these data kinds (comma-separated strings)")
+        .option("--statuses <pending,syncing,skipped,querying,running,success,cancelling,error,cancelled>", "Filter by statuses")
+        .option("--has-runs [true|false]", "Only return batches that have runs (defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-skipped [true|false]", "Only return skipped batches (defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-finished [true|false]", "Only return finished batches (defaults to true when passed bare)", parseBooleanOption)
+        .option("--included-data-kinds <segment,change,filter,recordIds,watchedRecords,records,file,runs,group,schedule,form>", "Include only these data kinds")
+        .option("--excluded-data-kinds <segment,change,filter,recordIds,watchedRecords,records,file,runs,group,schedule,form>", "Exclude these data kinds")
         .option("--limit <n>", "Max results to return (integer, default: 20)", "20")
         .option("--offset <n>", "Number of results to skip (integer, default: 0)", "0")
         .action(async (opts) => {
@@ -69,7 +69,7 @@ export function registerBatchCommands(parent, getApi) {
         .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.")
-        .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:

package/build/commands/orchestration/node.js

@@ -111,7 +111,7 @@ function registerDiagramCommand(node, getApi) {
         .option("--nodes <json>", "Node definitions (JSON array, or '-' to read from stdin)")
         .option("--file <path>", "Read a JSON payload or node array from a file")
         .option("--workflow-uuid <uuid>", "Diagram a workflow's deployed release (add --draft for its draft)")
-        .option("--draft [value]", "With --workflow-uuid, use the draft release", parseBooleanOption)
+        .option("--draft [true|false]", "With --workflow-uuid, use the draft release", parseBooleanOption)
         .option("--release-uuid <uuid>", "Diagram a specific release")
         .option("--run-uuid <uuid>", "Diagram the graph a run executed (follows the run's release when it has one)")
         .option("--title <text>", "Title rendered above the diagram")
@@ -119,7 +119,7 @@ function registerDiagramCommand(node, getApi) {
         .option("--direction <TD|LR>", "Mermaid flow direction, ignored by --format ascii (default: TD)", "TD")
         .option("--paid <slugs>", "Comma-separated node slugs/uuids that bill credits — marked 💳")
         .option("--highlight <slugs>", "Comma-separated node slugs/uuids to mark (red in Mermaid, ← in ASCII)")
-        .option("--raw [value]", "Print the diagram itself instead of JSON", parseBooleanOption)
+        .option("--raw [true|false]", "Print the diagram itself instead of JSON", parseBooleanOption)
         .addHelpText("after", `
 Free, runs nothing: turns a node graph into a picture so a reviewer can see the
 routing, the fallback paths and which steps bill before approving or deploying

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

@@ -1 +1 @@
-{"version":3,"file":"play.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/play.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAuR7E"}
+{"version":3,"file":"play.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/play.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA2R7E"}

package/build/commands/orchestration/play.js

@@ -9,9 +9,9 @@ export function registerPlayCommands(parent, getApi) {
         .description("List plays (optional filters match GET /orchestration/plays/list)")
         .option("--model-uuid <uuid>", "Only plays for this model UUID")
         .option("--segment-uuid <uuid>", "Only plays for this segment UUID")
-        .option("--schedule-type <type>", "Only plays with this schedule type: dbt | cron | realtime | dependency | watch")
-        .option("--is-enabled [value]", "Only enabled plays (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--is-disabled [value]", "Only disabled plays (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--schedule-type <dbt|cron|realtime|dependency|watch>", "Only plays with this schedule type")
+        .option("--is-enabled [true|false]", "Only enabled plays (defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-disabled [true|false]", "Only disabled plays (defaults to true when passed bare)", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const isEnabledFilter = resolveBooleanPair(opts.isEnabled, opts.isDisabled, { positive: "--is-enabled", negative: "--is-disabled" });
@@ -43,8 +43,8 @@ export function registerPlayCommands(parent, getApi) {
         .description("Create a play")
         .requiredOption("--name <name>", "Play name (string, required)")
         .requiredOption("--model-uuid <uuid>", "Model UUID to trigger on (string, required)")
-        .requiredOption("--change-kinds <kinds>", "Change kinds to trigger on (comma-separated strings, required)")
-        .requiredOption("--run-creation-rule <rule>", "Run creation rule. Allowed values: always, once, noConcurrency")
+        .requiredOption("--change-kinds <added,updated,removed,unchanged>", "Change kinds to trigger on (required)")
+        .requiredOption("--run-creation-rule <always|once|noConcurrency>", "Run creation rule")
         .option("--description <description>", "Play description (string)")
         .option("--folder-uuid <uuid>", "Folder UUID (string)")
         .addHelpText("after", `
@@ -82,10 +82,10 @@ Examples:
         .description("Update a play")
         .option("--name <name>", "Play name")
         .option("--description <description>", "Description")
-        .option("--is-enabled [value]", "Enable the play", parseBooleanOption)
-        .option("--is-disabled [value]", "Disable the play", parseBooleanOption)
-        .option("--change-kinds <kinds>", "Change kinds to trigger on (comma-separated strings)")
-        .option("--run-creation-rule <rule>", "Run creation rule. Allowed values: always, once, noConcurrency")
+        .option("--is-enabled [true|false]", "Enable the play", parseBooleanOption)
+        .option("--is-disabled [true|false]", "Disable the play", parseBooleanOption)
+        .option("--change-kinds <added,updated,removed,unchanged>", "Change kinds to trigger on")
+        .option("--run-creation-rule <always|once|noConcurrency>", "Run creation rule")
         .option("--folder-uuid <uuid>", "Folder UUID")
         .option("--filter <json>", "Filter definition (JSON object, same format as segmentation segment update)")
         .option("--sort <json>", 'Sort definition (JSON object). Shape: {"slug": string, "order": "asc" | "desc"}')

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

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/record.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,CAgbN"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/record.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,CA4bN"}

package/build/commands/orchestration/record.js

@@ -11,11 +11,11 @@ export function registerRecordCommands(parent, getApi) {
         .option("--title-or-id <value>", "Record title or ID")
         .option("--release-uuid <uuid>", "Release UUID")
         .option("--batch-uuid <uuid>", "Batch UUID")
-        .option("--statuses <list>", "Statuses (comma-separated)")
+        .option("--statuses <pending,running,success,error,cancelled,cancelling>", "Statuses")
         .option("--parent-batch-uuid <uuid>", "Parent batch UUID")
         .option("--parent-run-uuid <uuid>", "Parent run UUID")
         .option("--parent-node-uuid <uuid>", "Parent node UUID")
-        .option("--is-group-parent [value]", "Only group parents", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only group parents", parseBooleanOption)
         .option("--executions-filter <json>", 'Executions filter (JSON, e.g. {"conjonction":"and","groups":[{"conjonction":"and","conditions":[{"kind":"node","nodeSlug":"...","status":"pending"}]}]})')
         .option("--created-after <date>", "Created after date")
         .option("--created-before <date>", "Created before date")
@@ -64,11 +64,11 @@ export function registerRecordCommands(parent, getApi) {
         .option("--title-or-id <value>", "Record title or ID")
         .option("--release-uuid <uuid>", "Release UUID")
         .option("--batch-uuid <uuid>", "Batch UUID")
-        .option("--statuses <list>", "Statuses (comma-separated)")
+        .option("--statuses <pending,running,success,error,cancelled,cancelling>", "Statuses")
         .option("--parent-batch-uuid <uuid>", "Parent batch UUID")
         .option("--parent-run-uuid <uuid>", "Parent run UUID")
         .option("--parent-node-uuid <uuid>", "Parent node UUID")
-        .option("--is-group-parent [value]", "Only group parents", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only group parents", parseBooleanOption)
         .option("--executions-filter <json>", 'Executions filter (JSON, e.g. {"conjonction":"and","groups":[{"conjonction":"and","conditions":[{"kind":"node","nodeSlug":"...","status":"pending"}]}]})')
         .option("--created-after <date>", "Created after date")
         .option("--created-before <date>", "Created before date")
@@ -111,11 +111,11 @@ export function registerRecordCommands(parent, getApi) {
         .option("--title-or-id <value>", "Record title or ID")
         .option("--release-uuid <uuid>", "Release UUID")
         .option("--batch-uuid <uuid>", "Batch UUID")
-        .option("--statuses <list>", "Statuses (comma-separated)")
+        .option("--statuses <pending,running,success,error,cancelled,cancelling>", "Statuses")
         .option("--parent-batch-uuid <uuid>", "Parent batch UUID")
         .option("--parent-run-uuid <uuid>", "Parent run UUID")
         .option("--parent-node-uuid <uuid>", "Parent node UUID")
-        .option("--is-group-parent [value]", "Only group parents", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only group parents", parseBooleanOption)
         .option("--executions-filter <json>", 'Executions filter (JSON, e.g. {"conjonction":"and","groups":[{"conjonction":"and","conditions":[{"kind":"node","nodeSlug":"...","status":"pending"}]}]})')
         .option("--created-after <date>", "Created after date")
         .option("--created-before <date>", "Created before date")
@@ -154,17 +154,17 @@ export function registerRecordCommands(parent, getApi) {
         .description("Download record outputs")
         .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
         .option("--output-node-slug <slug>", "Output node slug")
-        .option("--format <format>", "Export format (csv or json)", "csv")
+        .option("--format <csv|json>", "Export format", "csv")
         .option("--ids <list>", "Record IDs (comma-separated)")
         .option("--title <title>", "Record title")
         .option("--title-or-id <value>", "Record title or ID")
         .option("--release-uuid <uuid>", "Release UUID")
         .option("--batch-uuid <uuid>", "Batch UUID")
-        .option("--statuses <list>", "Statuses (comma-separated)")
+        .option("--statuses <pending,running,success,error,cancelled,cancelling>", "Statuses")
         .option("--parent-batch-uuid <uuid>", "Parent batch UUID")
         .option("--parent-run-uuid <uuid>", "Parent run UUID")
         .option("--parent-node-uuid <uuid>", "Parent node UUID")
-        .option("--is-group-parent [value]", "Only group parents", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only group parents", parseBooleanOption)
         .option("--executions-filter <json>", 'Executions filter (JSON, e.g. {"conjonction":"and","groups":[{"conjonction":"and","conditions":[{"kind":"node","nodeSlug":"...","status":"pending"}]}]})')
         .option("--created-after <date>", "Created after date")
         .option("--created-before <date>", "Created before date")
@@ -227,7 +227,7 @@ export function registerRecordCommands(parent, getApi) {
         .option("--parent-batch-uuid <uuid>", "Parent batch UUID")
         .option("--parent-run-uuid <uuid>", "Parent run UUID")
         .option("--parent-node-uuid <uuid>", "Parent node UUID")
-        .option("--is-group-parent [value]", "Only group parents", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only group parents", parseBooleanOption)
         .option("--executions-filter <json>", 'Executions filter (JSON, e.g. {"conjonction":"and","groups":[{"conjonction":"and","conditions":[{"kind":"node","nodeSlug":"...","status":"pending"}]}]})')
         .action(async (opts) => {
         const payload = opts.ids !== undefined

package/build/commands/orchestration/release.js

@@ -91,7 +91,7 @@ export function registerReleaseCommands(parent, getApi) {
         .option("--form-fields <json>", "Form fields (JSON array, or 'null'). Required without --file; rejected with --file.")
         .option("--description <text>", "Release description.")
         .option("--options <json>", "Options (JSON object)")
-        .option("--dry-run [value]", "With --file: compile and print the nodes + form fields without deploying. Ignored without --file.", parseBooleanOption)
+        .option("--dry-run [true|false]", "With --file: compile and print the nodes + form fields without deploying. Ignored without --file.", parseBooleanOption)
         .action(async (opts) => {
         if (opts.file !== undefined) {
             await runFileDeploy(getApi, opts);

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

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

package/build/commands/orchestration/run.js

@@ -11,15 +11,15 @@ export function registerRunCommands(parent, getApi) {
         .option("--workflow-uuid <uuid>", "Workflow UUID (string). Omit to list the runs of every play and tool, which the API allows only alongside --created-after inside a 30-day window")
         .option("--batch-uuid <uuid>", "Filter by batch UUID (string)")
         .option("--release-uuid <uuid>", "Filter by release UUID (string)")
-        .option("--statuses <list>", "Filter by statuses (comma-separated: idle,pending,running,success,error,cancelling,cancelled,skipped)")
+        .option("--statuses <idle,pending,running,success,error,cancelling,cancelled,skipped>", "Filter by statuses")
         .option("--parent-batch-uuid <uuid>", "Filter by parent batch UUID (string)")
         .option("--parent-uuid <uuid>", "Filter by parent run UUID (string)")
         .option("--parent-node-uuid <uuid>", "Filter by parent node UUID (string)")
-        .option("--is-group-parent [value]", "Only return group parents (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only return group parents (defaults to true when passed bare)", parseBooleanOption)
         .option("--record-id <id>", "Filter by record ID (string)")
         .option("--record-title <title>", "Filter by record title (string)")
         .option("--record-title-or-id <value>", "Filter by record title or ID (string)")
-        .option("--is-finished [value]", "Only return finished runs (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-finished [true|false]", "Only return finished runs (defaults to true when passed bare)", parseBooleanOption)
         .option("--executions-filter <json>", 'Filter by node executions (JSON). Example: \'{"conjonction":"and","groups":[{"conjonction":"and","conditions":[{"kind":"node","nodeSlug":"my-node","status":"pending"}]}]}\'')
         .option("--created-after <date>", "Filter runs created after this date (ISO 8601 string)")
         .option("--created-before <date>", "Filter runs created before this date (ISO 8601 string)")
@@ -81,7 +81,7 @@ Examples:
         .option("--release-uuid <uuid>", "Release UUID to pin the run 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.")
-        .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")
         .addHelpText("after", `
 Examples:
@@ -148,15 +148,15 @@ Examples:
         .option("--workflow-uuid <uuid>", "Workflow UUID (string). Omit to count the runs of every play and tool, which the API allows only alongside --created-after inside a 30-day window")
         .option("--batch-uuid <uuid>", "Filter by batch UUID (string)")
         .option("--release-uuid <uuid>", "Filter by release UUID (string)")
-        .option("--statuses <list>", "Filter by statuses (comma-separated: idle,pending,running,success,error,cancelling,cancelled,skipped)")
+        .option("--statuses <idle,pending,running,success,error,cancelling,cancelled,skipped>", "Filter by statuses")
         .option("--parent-batch-uuid <uuid>", "Filter by parent batch UUID (string)")
         .option("--parent-uuid <uuid>", "Filter by parent run UUID (string)")
         .option("--parent-node-uuid <uuid>", "Filter by parent node UUID (string)")
-        .option("--is-group-parent [value]", "Only count group parents (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only count group parents (defaults to true when passed bare)", parseBooleanOption)
         .option("--record-id <id>", "Filter by record ID (string)")
         .option("--record-title <title>", "Filter by record title (string)")
         .option("--record-title-or-id <value>", "Filter by record title or ID (string)")
-        .option("--is-finished [value]", "Only count finished runs (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-finished [true|false]", "Only count finished runs (defaults to true when passed bare)", parseBooleanOption)
         .option("--executions-filter <json>", "Filter by node executions (JSON object, same format as 'run list')")
         .option("--created-after <date>", "Filter runs created after this date (ISO 8601 string)")
         .option("--created-before <date>", "Filter runs created before this date (ISO 8601 string)")
@@ -196,15 +196,15 @@ Examples:
         .option("--uuids <list>", "Only these run UUIDs (comma-separated). Use to export a known set of runs.")
         .option("--batch-uuid <uuid>", "Filter by batch UUID (string)")
         .option("--release-uuid <uuid>", "Filter by release UUID (string)")
-        .option("--statuses <list>", "Filter by statuses (comma-separated: idle,pending,running,success,error,cancelling,cancelled,skipped)")
+        .option("--statuses <idle,pending,running,success,error,cancelling,cancelled,skipped>", "Filter by statuses")
         .option("--parent-batch-uuid <uuid>", "Filter by parent batch UUID (string)")
         .option("--parent-uuid <uuid>", "Filter by parent run UUID (string)")
         .option("--parent-node-uuid <uuid>", "Filter by parent node UUID (string)")
-        .option("--is-group-parent [value]", "Only return group parents (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only return group parents (defaults to true when passed bare)", parseBooleanOption)
         .option("--record-id <id>", "Filter by record ID (string)")
         .option("--record-title <title>", "Filter by record title (string)")
         .option("--record-title-or-id <value>", "Filter by record title or ID (string)")
-        .option("--is-finished [value]", "Only return finished runs (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-finished [true|false]", "Only return finished runs (defaults to true when passed bare)", parseBooleanOption)
         .option("--executions-filter <json>", "Filter by node executions (JSON object, same format as 'run list')")
         .option("--created-after <date>", "Filter runs created after this date (ISO 8601 string)")
         .option("--created-before <date>", "Filter runs created before this date (ISO 8601 string)")
@@ -245,18 +245,18 @@ Examples:
         .description("Download outputs from a specific node in matching runs")
         .requiredOption("--workflow-uuid <uuid>", "Workflow UUID (string, required)")
         .option("--output-node-slug <slug>", "Output node slug to download from (string)")
-        .option("--format <format>", "Export format: csv | json (default: csv)", "csv")
+        .option("--format <csv|json>", "Export format (default: csv)", "csv")
         .option("--batch-uuid <uuid>", "Filter by batch UUID (string)")
         .option("--release-uuid <uuid>", "Filter by release UUID (string)")
-        .option("--statuses <list>", "Filter by statuses (comma-separated: idle,pending,running,success,error,cancelling,cancelled,skipped)")
+        .option("--statuses <idle,pending,running,success,error,cancelling,cancelled,skipped>", "Filter by statuses")
         .option("--parent-batch-uuid <uuid>", "Filter by parent batch UUID (string)")
         .option("--parent-uuid <uuid>", "Filter by parent run UUID (string)")
         .option("--parent-node-uuid <uuid>", "Filter by parent node UUID (string)")
-        .option("--is-group-parent [value]", "Only return group parents (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-group-parent [true|false]", "Only return group parents (defaults to true when passed bare)", parseBooleanOption)
         .option("--record-id <id>", "Filter by record ID (string)")
         .option("--record-title <title>", "Filter by record title (string)")
         .option("--record-title-or-id <value>", "Filter by record title or ID (string)")
-        .option("--is-finished [value]", "Only return finished runs (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--is-finished [true|false]", "Only return finished runs (defaults to true when passed bare)", parseBooleanOption)
         .option("--executions-filter <json>", "Filter by node executions (JSON object, same format as 'run list')")
         .option("--created-after <date>", "Filter runs created after this date (ISO 8601 string)")
         .option("--created-before <date>", "Filter runs created before this date (ISO 8601 string)")

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

@@ -1 +1 @@
-{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA0P7E"}
+{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAoP7E"}

package/build/commands/orchestration/span.js

@@ -13,7 +13,7 @@ export function registerSpanCommands(parent, getApi) {
         .option("--execution-title <text>", "Execution title (ilike)")
         .option("--execution-title-or-error-message <text>", "Execution title or error message (ilike on title or error message)")
         .option("--node-uuid <uuid>", "Node UUID")
-        .option("--node-kind <kind>", "Node kind: native | connector | tool | agent")
+        .option("--node-kind <native|connector|tool|agent|worker>", "Node kind")
         .option("--node-slug <slug>", "Workflow node slug (exact match)")
         .option("--node-integration-slug <slug>", "Connector integration slug (exact match)")
         .option("--node-connector-uuid <uuid>", "Connector UUID")
@@ -22,7 +22,7 @@ export function registerSpanCommands(parent, getApi) {
         .option("--node-tool-uuid <uuid>", "Tool node UUID")
         .option("--node-agent-uuid <uuid>", "Agent node UUID")
         .option("--node-release-uuid <uuid>", "Release UUID on the node")
-        .option("--execution-statuses <list>", "Comma-separated: pending,success,error")
+        .option("--execution-statuses <pending,success,error>", "Filter by execution statuses")
         .option("--parent-run-uuid <uuid>", "Parent run UUID")
         .requiredOption("--execution-started-after <date>", "Execution started after (ISO date)")
         .option("--execution-started-before <date>", "Execution started on or before (ISO date)")
@@ -78,7 +78,7 @@ export function registerSpanCommands(parent, getApi) {
         .option("--execution-title <text>", "Execution title (ilike)")
         .option("--execution-title-or-error-message <text>", "Execution title or error message (ilike on title or error message)")
         .option("--node-uuid <uuid>", "Node UUID")
-        .option("--node-kind <kind>", "Node kind: native | connector | tool | agent")
+        .option("--node-kind <native|connector|tool|agent|worker>", "Node kind")
         .option("--node-slug <slug>", "Workflow node slug (exact match)")
         .option("--node-integration-slug <slug>", "Connector integration slug (exact match)")
         .option("--node-connector-uuid <uuid>", "Connector UUID")
@@ -87,7 +87,7 @@ export function registerSpanCommands(parent, getApi) {
         .option("--node-tool-uuid <uuid>", "Tool node UUID")
         .option("--node-agent-uuid <uuid>", "Agent node UUID")
         .option("--node-release-uuid <uuid>", "Release UUID on the node")
-        .option("--execution-statuses <list>", "Comma-separated: pending,success,error")
+        .option("--execution-statuses <pending,success,error>", "Filter by execution statuses")
         .option("--parent-run-uuid <uuid>", "Parent run UUID")
         .requiredOption("--execution-started-after <date>", "Execution started after (ISO date)")
         .option("--execution-started-before <date>", "Execution started on or before (ISO date)")

package/build/commands/orchestration/tool.js

@@ -13,7 +13,7 @@ export function registerToolCommands(parent, getApi) {
         .command("create")
         .description("Create a tool")
         .requiredOption("--name <name>", "Tool name")
-        .requiredOption("--icon-kind <kind>", "Icon kind (raw or emoji)")
+        .requiredOption("--icon-kind <raw|emoji>", "Icon kind")
         .option("--icon-data <data>", "Icon data (when kind is raw)")
         .option("--icon-emoji-slug <slug>", "Icon emoji slug (when kind is emoji)")
         .option("--description <text>", "Tool description")
@@ -36,7 +36,7 @@ export function registerToolCommands(parent, getApi) {
         .description("Update a tool")
         .requiredOption("--uuid <uuid>", "Tool UUID")
         .option("--name <name>", "Tool name")
-        .option("--icon-kind <kind>", "Icon kind (raw or emoji)")
+        .option("--icon-kind <raw|emoji>", "Icon kind")
         .option("--icon-data <data>", "Icon data (when kind is raw)")
         .option("--icon-emoji-slug <slug>", "Icon emoji slug (when kind is emoji)")
         .option("--description <text>", "Tool description")

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

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/trace.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,CAiHN"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/trace.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,CA2GN"}

package/build/commands/orchestration/trace.js

@@ -7,7 +7,7 @@ export function registerTraceCommands(parent, getApi) {
         .command("list")
         .description("List traces (aggregated over their spans)")
         .option("--workflow-uuid <uuid>", "Workflow UUID (omit to include all workflows in the workspace)")
-        .option("--statuses <list>", "Comma-separated trace statuses (pending, error, degraded, success)")
+        .option("--statuses <pending,error,degraded,success>", "Trace statuses")
         .requiredOption("--started-after <date>", "Trace's first span started after (ISO date)")
         .option("--started-before <date>", "Trace's first span started on or before (ISO date)")
         .option("--limit <n>", "Limit", "30")
@@ -30,7 +30,7 @@ export function registerTraceCommands(parent, getApi) {
         .command("count")
         .description("Count traces matching the filter")
         .option("--workflow-uuid <uuid>", "Workflow UUID (omit to include all workflows in the workspace)")
-        .option("--statuses <list>", "Comma-separated trace statuses (pending, error, degraded, success)")
+        .option("--statuses <pending,error,degraded,success>", "Trace statuses")
         .requiredOption("--started-after <date>", "Trace's first span started after (ISO date)")
         .option("--started-before <date>", "Trace's first span started on or before (ISO date)")
         .action(async (opts) => {

package/build/commands/revenueOrganization/capacity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capacity.d.ts","sourceRoot":"","sources":["../../../src/commands/revenueOrganization/capacity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA4JN"}
+{"version":3,"file":"capacity.d.ts","sourceRoot":"","sources":["../../../src/commands/revenueOrganization/capacity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA+JN"}

package/build/commands/revenueOrganization/capacity.js

@@ -23,7 +23,7 @@ export function registerCapacityCommands(parent, getApi) {
         .command("create")
         .description("Create a capacity")
         .requiredOption("--name <name>", "Capacity name")
-        .requiredOption("--color <color>", "Capacity color")
+        .requiredOption("--color <orange|red|purple|green|yellow|grey>", "Capacity color")
         .option("--description <text>", "Description")
         .option("--model-uuid <uuid>", "Model UUID")
         .option("--id-column-slug <slug>", "ID column slug")
@@ -64,7 +64,7 @@ export function registerCapacityCommands(parent, getApi) {
         .requiredOption("--uuid <uuid>", "Capacity UUID")
         .option("--filter <json>", 'Filter (JSON, use null to clear, e.g. {"conjonction":"and","groups":[]})')
         .option("--name <name>", "Capacity name")
-        .option("--color <color>", "Capacity color")
+        .option("--color <orange|red|purple|green|yellow|grey>", "Capacity color")
         .option("--description <text>", "Description")
         .option("--member-capacity <n>", "Member capacity")
         .option("--model-uuid <uuid>", "Model UUID")

package/build/commands/revenueOrganization/territory.js

@@ -23,7 +23,7 @@ export function registerTerritoryCommands(parent, getApi) {
         .command("create")
         .description("Create a territory")
         .requiredOption("--label <label>", "Territory label")
-        .requiredOption("--color <color>", "Territory color (orange, red, purple, ...)")
+        .requiredOption("--color <orange|red|purple|green|yellow|grey>", "Territory color")
         .requiredOption("--members <json>", 'Members (JSON array, e.g. [{"userUuid":"...","role":"owner"}])')
         .option("--description <text>", "Territory description")
         .option("--fallback-member-uuid <uuid>", "Fallback member UUID")
@@ -51,7 +51,7 @@ export function registerTerritoryCommands(parent, getApi) {
         .description("Update a territory")
         .requiredOption("--uuid <uuid>", "Territory UUID")
         .option("--label <label>", "Territory label")
-        .option("--color <color>", "Territory color (orange, red, purple, ...)")
+        .option("--color <orange|red|purple|green|yellow|grey>", "Territory color")
         .option("--description <text>", "Territory description")
         .option("--members <json>", 'Members (JSON array, e.g. [{"userUuid":"...","role":"owner"}])')
         .option("--fallback-member-uuid <uuid>", "Fallback member UUID")

package/build/commands/segmentation/change.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../../src/commands/segmentation/change.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,CAgGN"}
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../../src/commands/segmentation/change.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,CAuGN"}

package/build/commands/segmentation/change.js

@@ -6,8 +6,8 @@ export function registerChangeCommands(parent, getApi) {
         .command("list")
         .description("List changes")
         .option("--segment-uuid <uuid>", "Segment UUID")
-        .option("--not-empty [value]", "Only non-empty changes", parseBooleanOption)
-        .option("--has-records <kind>", "Has records of kind")
+        .option("--not-empty [true|false]", "Only non-empty changes", parseBooleanOption)
+        .option("--has-records <added|updated|removed|unchanged>", "Has records of kind")
         .option("--limit <n>", "Limit")
         .option("--offset <n>", "Offset")
         .action(async (opts) => {
@@ -33,7 +33,7 @@ export function registerChangeCommands(parent, getApi) {
         .command("download")
         .description("Download change data")
         .requiredOption("--uuid <uuid>", "Change UUID")
-        .requiredOption("--kinds <kinds>", "Change kinds (comma-separated)")
+        .requiredOption("--kinds <added,updated,removed,unchanged>", "Change kinds")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.segmentation.change.download({
@@ -46,7 +46,7 @@ export function registerChangeCommands(parent, getApi) {
         .command("fetch")
         .description("Fetch change data")
         .requiredOption("--uuid <uuid>", "Change UUID")
-        .requiredOption("--kinds <kinds>", "Change kinds (comma-separated)")
+        .requiredOption("--kinds <added,updated,removed,unchanged>", "Change kinds")
         .option("--limit <n>", "Limit")
         .option("--offset <n>", "Offset")
         .action(async (opts) => {

package/build/commands/segmentation/record.js

@@ -9,7 +9,7 @@ export function registerRecordCommands(parent, getApi) {
         .description("Fetch segmentation records")
         .requiredOption("--model-uuid <uuid>", "Model UUID")
         .requiredOption("--ids <ids>", "Record IDs (comma-separated)")
-        .option("--reset-cache [value]", "Reset cache", parseBooleanOption)
+        .option("--reset-cache [true|false]", "Reset cache", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.segmentation.record.fetch({

package/build/commands/segmentation/segment.js

@@ -86,8 +86,8 @@ Filter object shape:
         .option("--limit <n>", "Max records in segment (integer)")
         .option("--fetching-limit <n>", "Max records to fetch per page (integer)")
         .option("--fetching-offset <n>", "Number of records to skip (integer)")
-        .option("--enrich [value]", "Enrich records with additional data (true/false, defaults to true when passed bare)", parseBooleanOption)
-        .option("--sync [value]", "Sync data sources before fetching (true/false, defaults to true when passed bare)", parseBooleanOption)
+        .option("--enrich [true|false]", "Enrich records with additional data (defaults to true when passed bare)", parseBooleanOption)
+        .option("--sync [true|false]", "Sync data sources before fetching (defaults to true when passed bare)", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.segmentation.segment.fetch({

package/build/commands/start/index.js

@@ -53,7 +53,7 @@ export function registerStartCommand(program, getApi, deps) {
         .description("Open a coding agent, run the guided demo, or set up a project — signing you in first if needed")
         .option("--email <email>", "Sign in with a code emailed to this address")
         .option("--code <code>", "The emailed code, to finish a sign-in this command already started (`-` reads it from stdin)")
-        .option("--oauth [value]", "Sign in via browser", parseBooleanOption)
+        .option("--oauth [true|false]", "Sign in via browser", parseBooleanOption)
         .option("--workspace-name <name>", "Workspace to use, created if it does not exist")
         .option("--workspace-uuid <uuid>", "Workspace to use")
         .option("--continue <where>", 'Where to continue: a coding agent ("claude", "cursor", "codex", "gemini"), "code" for a CDK project, "cli" for the palette, "demo" for the guided tour, or "none"')

package/build/commands/storage/query.js

@@ -24,7 +24,7 @@ Examples:
         .command("download")
         .description("Download the result of a SQL query against storage models as files")
         .requiredOption("--query <sql>", "SQL query string")
-        .option("--format <format>", "Download format (csv or parquet)", "csv")
+        .option("--format <csv|parquet>", "Download format", "csv")
         .addHelpText("after", `
 Tables must be referenced as [datasetSlug].[modelSlug] and are rewritten
 to the underlying warehouse table under the hood. Returns signed URLs to

package/build/commands/storage/record.js

@@ -22,8 +22,8 @@ Example:
         .requiredOption("--model-uuid <uuid>", "Model UUID (string, required)")
         .option("--limit <n>", "Max results to return (integer)")
         .option("--offset <n>", "Number of results to skip (integer)")
-        .option("--sort-kind <kind>", "Sort direction. Allowed values: asc, desc")
-        .option("--sort-column-slug <slug>", "Column to sort by. Allowed values: _id, _title, _emitted_at (_emitted_at is only available on models built from ingested records)")
+        .option("--sort-kind <asc|desc>", "Sort direction")
+        .option("--sort-column-slug <_id|_title|_emitted_at>", "Column to sort by (_emitted_at is only available on models built from ingested records)")
         .addHelpText("after", `
 Examples:
   $ cargo-ai storage record list --model-uuid 550e8400-...

package/build/commands/storage/run.js

@@ -21,8 +21,8 @@ export function registerRunCommands(parent, getApi) {
         .command("create")
         .description("Create a storage run")
         .requiredOption("--model-uuid <uuid>", "Model UUID")
-        .option("--is-reset [value]", "Reset the model before running", parseBooleanOption)
-        .option("--is-force [value]", "Force the run", parseBooleanOption)
+        .option("--is-reset [true|false]", "Reset the model before running", parseBooleanOption)
+        .option("--is-force [true|false]", "Force the run", parseBooleanOption)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.storage.run.create({

package/build/commands/systemOfRecordIntegration/log.js

@@ -4,7 +4,7 @@ export function registerLogCommands(parent, getApi) {
     log
         .command("list")
         .description("List logs")
-        .option("--statuses <statuses>", "Statuses (comma-separated)")
+        .option("--statuses <success,error>", "Statuses")
         .option("--query <query>", "Search query")
         .option("--limit <n>", "Limit")
         .option("--offset <n>", "Offset")

package/build/commands/systemOfRecordIntegration/systemOfRecord.js

@@ -36,7 +36,7 @@ export function registerSystemOfRecordCommands(parent, getApi) {
     sor
         .command("create")
         .description("Create a system of record")
-        .requiredOption("--kind <kind>", "System of record kind")
+        .requiredOption("--kind <bigQuery|snowflake>", "System of record kind")
         .option("--config <json>", "Configuration (JSON object)")
         .action(async (opts) => {
         const api = getApi();

package/build/commands/version.js

@@ -6,7 +6,7 @@ export function registerVersionCommand(parent, currentVersion) {
     parent
         .command("version")
         .description("Print the installed CLI version, or check npm for a newer release with --check")
-        .option("--check [value]", "Query the npm registry and report whether a newer version is available", parseBooleanOption)
+        .option("--check [true|false]", "Query the npm registry and report whether a newer version is available", parseBooleanOption)
         .action(async (opts) => {
         if (opts.check !== true) {
             outputJson({ version: currentVersion });

package/build/commands/workspaceManagement/folder.d.ts.map

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

package/build/commands/workspaceManagement/folder.js

@@ -22,7 +22,7 @@ export function registerFolderCommands(parent, getApi) {
         .description("Create a folder")
         .requiredOption("--name <name>", "Folder name")
         .requiredOption("--emoji-slug <slug>", "Emoji slug")
-        .requiredOption("--kind <kind>", "Folder kind")
+        .requiredOption("--kind <tool|play|agent|file|mcpServer|model|app|worker|alert|mailbox>", "Folder kind")
         .option("--parent-uuid <uuid>", "Parent folder UUID")
         .action(async (opts) => {
         const api = getApi();

package/build/commands/workspaceManagement/role.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../src/commands/workspaceManagement/role.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAyF7E"}
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../src/commands/workspaceManagement/role.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAgG7E"}