@cargo-ai/cli 1.0.8 → 1.0.9

package/build/commands/connection/connector.js

@@ -2,7 +2,7 @@ import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
 export function registerConnectorCommands(parent, getApi) {
     const connector = parent
         .command("connector")
-        .description("Connector operations");
+        .description("Manage connectors (list, get, create, update, remove, autocomplete)");
     connector
         .command("list")
         .description("List all connectors")
@@ -40,13 +40,13 @@ export function registerConnectorCommands(parent, getApi) {
     });
     connector
         .command("autocomplete")
-        .description("Autocomplete connector values")
-        .requiredOption("--connector-uuid <uuid>", "Connector UUID")
-        .requiredOption("--slug <slug>", "Slug")
-        .requiredOption("--params <json>", "Params (JSON object)")
-        .option("--value <value>", "Search value")
-        .option("--refresh", "Refresh cached results")
-        .option("--variables <json>", 'Variables (JSON object, e.g. {"key":"value"})')
+        .description("Autocomplete connector values for a given field")
+        .requiredOption("--connector-uuid <uuid>", "Connector UUID (string, required)")
+        .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", "Refresh cached results (boolean flag)")
+        .option("--variables <json>", "Additional variables (JSON object)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.connection.connector.autocomplete({
@@ -63,10 +63,10 @@ export function registerConnectorCommands(parent, getApi) {
     });
     connector
         .command("get-dynamic-schema")
-        .description("Get dynamic schema for a connector")
-        .requiredOption("--connector-uuid <uuid>", "Connector UUID")
-        .requiredOption("--slug <slug>", "Slug")
-        .requiredOption("--params <json>", "Params (JSON object)")
+        .description("Get dynamic schema for a connector action")
+        .requiredOption("--connector-uuid <uuid>", "Connector UUID (string, required)")
+        .requiredOption("--slug <slug>", "Action slug (string, required)")
+        .requiredOption("--params <json>", "Schema parameters (JSON object, required)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.connection.connector.getDynamicSchema({
@@ -79,12 +79,17 @@ export function registerConnectorCommands(parent, getApi) {
     connector
         .command("create")
         .description("Create a connector")
-        .requiredOption("--name <name>", "Connector name")
-        .requiredOption("--slug <slug>", "Connector slug")
-        .requiredOption("--integration-slug <slug>", "Integration slug")
-        .option("--config <json>", "Configuration (JSON object)")
-        .option("--rate-limit <json>", 'Rate limit (JSON, e.g. {"maxRequests":100,"windowMs":60000})')
-        .option("--cache-ttl-milliseconds <n>", "Cache TTL in milliseconds")
+        .requiredOption("--name <name>", "Connector name (string, required)")
+        .requiredOption("--slug <slug>", "Connector slug identifier (string, required)")
+        .requiredOption("--integration-slug <slug>", "Integration slug to connect to (string, required)")
+        .option("--config <json>", "Connector configuration (JSON object, shape depends on integration)")
+        .option("--rate-limit <json>", 'Rate limit configuration (JSON object). Shape: {"maxRequests": integer, "windowMs": integer}')
+        .option("--cache-ttl-milliseconds <n>", "Cache TTL in milliseconds (integer)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai connection connector create --name "HubSpot" --slug hubspot-main --integration-slug hubspot
+  $ cargo-ai connection connector create --name "HubSpot" --slug hubspot-main --integration-slug hubspot \\
+      --rate-limit '{"maxRequests":100,"windowMs":60000}' --cache-ttl-milliseconds 300000`)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.connection.connector.create({

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,CAwFN"}
+{"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,CA2FN"}

package/build/commands/connection/integration.js

@@ -2,15 +2,15 @@ import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
 export function registerIntegrationCommands(parent, getApi) {
     const integration = parent
         .command("integration")
-        .description("Integration operations");
+        .description("Browse and manage integrations");
     integration
         .command("list")
         .description("List all integrations")
-        .option("--category <category>", "Filter by category")
-        .option("--slug <slug>", "Filter by slug")
-        .option("--search <search>", "Search by name (case-insensitive)")
-        .option("--has-actions <bool>", "Filter by presence of actions (true/false)")
-        .option("--has-extractors <bool>", "Filter by presence of extractors (true/false)")
+        .option("--category <category>", "Filter by category (string)")
+        .option("--slug <slug>", "Filter by integration slug (string)")
+        .option("--search <search>", "Search by name, case-insensitive (string)")
+        .option("--has-actions <bool>", 'Filter by presence of actions (string: "true" or "false")')
+        .option("--has-extractors <bool>", 'Filter by presence of extractors (string: "true" or "false")')
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.connection.integration.list({
@@ -48,9 +48,9 @@ export function registerIntegrationCommands(parent, getApi) {
     });
     integration
         .command("complete-oauth")
-        .description("Complete OAuth for an integration")
-        .requiredOption("--slug <slug>", "Integration slug")
-        .requiredOption("--params <json>", "OAuth params (JSON object)")
+        .description("Complete OAuth flow for an integration")
+        .requiredOption("--slug <slug>", "Integration slug (string, required)")
+        .requiredOption("--params <json>", "OAuth callback parameters (JSON object, required)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.connection.integration.completeOauth({

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

@@ -1 +1 @@
-{"version":3,"file":"expressionEval.d.ts","sourceRoot":"","sources":["../../../src/commands/expression/expressionEval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA6CN"}
+{"version":3,"file":"expressionEval.d.ts","sourceRoot":"","sources":["../../../src/commands/expression/expressionEval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAsDN"}

package/build/commands/expression/expressionEval.js

@@ -2,12 +2,15 @@ import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
 export function registerExpressionEvalCommands(parent, getApi) {
     const expr = parent
         .command("eval")
-        .description("Expression evaluate and generate");
+        .description("Evaluate and generate expressions");
     expr
         .command("evaluate")
-        .description("Evaluate an expression")
-        .requiredOption("--expression <json>", "Expression definition (JSON object)")
-        .requiredOption("--variables <json>", 'Variables (JSON object, e.g. {"key":"value"})')
+        .description("Evaluate an expression with given variables")
+        .requiredOption("--expression <json>", "Expression definition (JSON object, required)")
+        .requiredOption("--variables <json>", "Variable bindings for the expression (JSON object, required)")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai expression eval evaluate --expression '{"kind":"template","template":"Hello {{name}}"}' --variables '{"name":"World"}'`)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.expression.expression.evaluate({
@@ -18,9 +21,9 @@ export function registerExpressionEvalCommands(parent, getApi) {
     });
     expr
         .command("generate")
-        .description("Generate an expression")
-        .requiredOption("--prompt <text>", "Prompt")
-        .requiredOption("--variables <json>", 'Variables (JSON object, e.g. {"key":"value"})')
+        .description("Generate an expression from a natural language prompt")
+        .requiredOption("--prompt <text>", "Natural language description of the expression (string, required)")
+        .requiredOption("--variables <json>", "Available variable bindings (JSON object, required)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.expression.expression.generate({

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

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

package/build/commands/orchestration/batch.js

@@ -1,22 +1,24 @@
 import { handleApiCall, outputJson, parseJson, pollBatchUntilFinished, } from "../runHandler.js";
 export function registerBatchCommands(parent, getApi) {
-    const batch = parent.command("batch").description("Batch operations");
+    const batch = parent
+        .command("batch")
+        .description("Manage batch operations (list, get, create, cancel, preview, download)");
     batch
         .command("list")
         .description("List batches")
-        .option("--workflow-uuids <uuids>", "Workflow UUIDs (comma-separated)")
-        .option("--release-uuid <uuid>", "Release UUID")
-        .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("--statuses <list>", "Statuses (comma-separated)")
-        .option("--has-runs", "Only batches with runs")
-        .option("--is-skipped", "Only skipped batches")
-        .option("--is-finished", "Only finished batches")
-        .option("--included-data-kinds <list>", "Included data kinds (comma-separated)")
-        .option("--excluded-data-kinds <list>", "Excluded data kinds (comma-separated)")
-        .option("--limit <n>", "Limit", "20")
-        .option("--offset <n>", "Offset", "0")
+        .option("--workflow-uuids <uuids>", "Filter by workflow UUIDs (comma-separated strings)")
+        .option("--release-uuid <uuid>", "Filter by release UUID (string)")
+        .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,running,finished,failed,cancelled)")
+        .option("--has-runs", "Only return batches that have runs (boolean flag)")
+        .option("--is-skipped", "Only return skipped batches (boolean flag)")
+        .option("--is-finished", "Only return finished batches (boolean flag)")
+        .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("--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) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.batch.list({
@@ -59,12 +61,16 @@ export function registerBatchCommands(parent, getApi) {
     batch
         .command("create")
         .description("Create a batch")
-        .option("--workflow-uuid <uuid>", "Workflow UUID")
-        .requiredOption("--data <json>", 'Batch data (JSON, e.g. {"kind":"segment","segmentUuid":"..."} or {"kind":"file","s3Filename":"..."})')
-        .option("--release-uuid <uuid>", "Release UUID")
-        .option("--nodes <json>", 'Custom nodes to override the workflow definition (JSON array). Must include a start node (slug:"start") and an end node (slug:"end"). E.g. [{"uuid":"a","slug":"start","kind":"native","actionSlug":"start","config":{},"childrenUuids":["b"],"fallbackOnFailure":false,"position":{"x":0,"y":0}},{"uuid":"b","slug":"end","kind":"native","actionSlug":"end","config":{},"childrenUuids":[],"fallbackOnFailure":false,"position":{"x":1,"y":0}}]')
-        .option("--wait-until-finished", "Poll the batch until it reaches a terminal status before returning")
-        .option("--polling-interval <ms>", "Polling interval in milliseconds (used with --wait-until-finished)", "5000")
+        .option("--workflow-uuid <uuid>", "Workflow UUID (string)")
+        .requiredOption("--data <json>", 'Batch data source (JSON object, required). Supported kinds: {"kind":"segment","segmentUuid":"..."} or {"kind":"file","s3Filename":"..."}')
+        .option("--release-uuid <uuid>", "Release UUID to pin the batch to (string)")
+        .option("--nodes <json>", 'Custom nodes to override the workflow definition (JSON array). Must include a start node (slug:"start") and an end node (slug:"end")')
+        .option("--wait-until-finished", "Poll the batch until it reaches a terminal status before returning (boolean flag)")
+        .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai orchestration batch create --data '{"kind":"segment","segmentUuid":"550e8400-..."}'
+  $ cargo-ai orchestration batch create --workflow-uuid 550e8400-... --data '{"kind":"file","s3Filename":"input.csv"}' --wait-until-finished`)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.batch.create({
@@ -93,9 +99,9 @@ export function registerBatchCommands(parent, getApi) {
     });
     batch
         .command("preview")
-        .description("Preview a batch")
-        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
-        .requiredOption("--data <json>", 'Batch data (JSON, e.g. {"kind":"segment","segmentUuid":"..."} or {"kind":"file","s3Filename":"..."})')
+        .description("Preview a batch without creating it")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID (string, required)")
+        .requiredOption("--data <json>", 'Batch data source (JSON object, required). Same format as "batch create --data"')
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.batch.preview({
@@ -107,8 +113,8 @@ export function registerBatchCommands(parent, getApi) {
     batch
         .command("download")
         .description("Download batch results")
-        .requiredOption("--uuid <uuid>", "Batch UUID")
-        .requiredOption("--output-node-slug <slug>", "Output node slug")
+        .requiredOption("--uuid <uuid>", "Batch UUID (string, required)")
+        .requiredOption("--output-node-slug <slug>", "Output node slug to download from (string, required)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.batch.download({

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAYxC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAeN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAaxC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAgBN"}

package/build/commands/orchestration/index.js

@@ -1,5 +1,6 @@
 import { registerBatchCommands } from "./batch.js";
 import { registerDraftReleaseCommands } from "./draftRelease.js";
+import { registerLogCommands } from "./log.js";
 import { registerNodeCommands } from "./node.js";
 import { registerPlayCommands } from "./play.js";
 import { registerRecordCommands } from "./record.js";
@@ -16,6 +17,7 @@ export function registerOrchestrationCommands(parent, getApi) {
     registerPlayCommands(orchestration, getApi);
     registerRunCommands(orchestration, getApi);
     registerBatchCommands(orchestration, getApi);
+    registerLogCommands(orchestration, getApi);
     registerReleaseCommands(orchestration, getApi);
     registerDraftReleaseCommands(orchestration, getApi);
     registerToolCommands(orchestration, getApi);

package/build/commands/orchestration/log.d.ts

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

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

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

package/build/commands/orchestration/log.js

@@ -0,0 +1,122 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+export function registerLogCommands(parent, getApi) {
+    const log = parent.command("log").description("Execution log operations");
+    log
+        .command("list")
+        .description("List execution logs")
+        .option("--workflow-uuid <uuid>", "Workflow UUID (omit to include all workflows in the workspace)")
+        .option("--batch-uuid <uuid>", "Batch UUID")
+        .option("--run-uuid <uuid>", "Run UUID")
+        .option("--record-id <id>", "Record ID")
+        .option("--record-title <title>", "Record title (ilike)")
+        .option("--record-title-or-id <text>", "Record id or title (ilike on id or title, same as run list)")
+        .option("--execution-title <text>", "Execution title (ilike)")
+        .option("--node-uuid <uuid>", "Node UUID")
+        .option("--node-kind <kind>", "Node kind: native | connector | tool | agent")
+        .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")
+        .option("--node-action-slug <slug>", "Node action slug (exact match)")
+        .option("--parent-node-uuid <uuid>", "Parent node UUID on the run")
+        .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("--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)")
+        .option("--limit <n>", "Limit", "30")
+        .option("--offset <n>", "Offset", "0")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.log.list({
+            workflowUuid: opts.workflowUuid,
+            batchUuid: opts.batchUuid,
+            runUuid: opts.runUuid,
+            recordId: opts.recordId,
+            recordTitle: opts.recordTitle,
+            recordTitleOrId: opts.recordTitleOrId,
+            executionTitle: opts.executionTitle,
+            nodeUuid: opts.nodeUuid,
+            nodeKind: opts.nodeKind !== undefined
+                ? opts.nodeKind
+                : undefined,
+            nodeSlug: opts.nodeSlug,
+            nodeIntegrationSlug: opts.nodeIntegrationSlug,
+            nodeConnectorUuid: opts.nodeConnectorUuid,
+            nodeActionSlug: opts.nodeActionSlug,
+            parentNodeUuid: opts.parentNodeUuid,
+            nodeToolUuid: opts.nodeToolUuid,
+            nodeAgentUuid: opts.nodeAgentUuid,
+            nodeReleaseUuid: opts.nodeReleaseUuid,
+            executionStatuses: opts.executionStatuses !== undefined
+                ? opts.executionStatuses
+                    .split(",")
+                    .map((s) => s.trim())
+                : undefined,
+            parentRunUuid: opts.parentRunUuid,
+            executionStartedAfter: opts.executionStartedAfter,
+            executionStartedBefore: opts.executionStartedBefore,
+            limit: opts.limit !== undefined ? parseInt(opts.limit, 10) : undefined,
+            offset: opts.offset !== undefined ? parseInt(opts.offset, 10) : undefined,
+        }));
+        outputJson(result);
+    });
+    log
+        .command("count")
+        .description("Count execution logs")
+        .option("--workflow-uuid <uuid>", "Workflow UUID (omit to include all workflows in the workspace)")
+        .option("--batch-uuid <uuid>", "Batch UUID")
+        .option("--run-uuid <uuid>", "Run UUID")
+        .option("--record-id <id>", "Record ID")
+        .option("--record-title <title>", "Record title (ilike)")
+        .option("--record-title-or-id <text>", "Record id or title (ilike on id or title, same as run list)")
+        .option("--execution-title <text>", "Execution title (ilike)")
+        .option("--node-uuid <uuid>", "Node UUID")
+        .option("--node-kind <kind>", "Node kind: native | connector | tool | agent")
+        .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")
+        .option("--node-action-slug <slug>", "Node action slug (exact match)")
+        .option("--parent-node-uuid <uuid>", "Parent node UUID on the run")
+        .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("--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)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.log.count({
+            workflowUuid: opts.workflowUuid,
+            batchUuid: opts.batchUuid,
+            runUuid: opts.runUuid,
+            recordId: opts.recordId,
+            recordTitle: opts.recordTitle,
+            recordTitleOrId: opts.recordTitleOrId,
+            executionTitle: opts.executionTitle,
+            nodeUuid: opts.nodeUuid,
+            nodeKind: opts.nodeKind !== undefined
+                ? opts.nodeKind
+                : undefined,
+            nodeSlug: opts.nodeSlug,
+            nodeIntegrationSlug: opts.nodeIntegrationSlug,
+            nodeConnectorUuid: opts.nodeConnectorUuid,
+            nodeActionSlug: opts.nodeActionSlug,
+            parentNodeUuid: opts.parentNodeUuid,
+            nodeToolUuid: opts.nodeToolUuid,
+            nodeAgentUuid: opts.nodeAgentUuid,
+            nodeReleaseUuid: opts.nodeReleaseUuid,
+            executionStatuses: opts.executionStatuses !== undefined
+                ? opts.executionStatuses
+                    .split(",")
+                    .map((s) => s.trim())
+                : undefined,
+            parentRunUuid: opts.parentRunUuid,
+            executionStartedAfter: opts.executionStartedAfter,
+            executionStartedBefore: opts.executionStartedBefore,
+        }));
+        outputJson(result);
+    });
+}

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

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

package/build/commands/orchestration/node.js

@@ -1,12 +1,14 @@
 import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
 export function registerNodeCommands(parent, getApi) {
-    const node = parent.command("node").description("Node operations");
+    const node = parent
+        .command("node")
+        .description("Compute, validate, and execute workflow nodes");
     node
         .command("compute")
-        .description("Compute a node")
-        .requiredOption("--node <json>", "Node definition (JSON object)")
-        .requiredOption("--context <json>", "Execution context (JSON object)")
-        .option("--group-context <json>", "Group context (JSON object)")
+        .description("Compute a node's configuration from its definition and context")
+        .requiredOption("--node <json>", "Node definition (JSON object, required)")
+        .requiredOption("--context <json>", "Execution context (JSON object, required)")
+        .option("--group-context <json>", "Group context for grouped nodes (JSON object)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.node.compute({
@@ -20,8 +22,8 @@ export function registerNodeCommands(parent, getApi) {
     });
     node
         .command("validate")
-        .description("Validate nodes")
-        .requiredOption("--nodes <json>", "Array of node definitions (JSON array)")
+        .description("Validate node definitions for correctness")
+        .requiredOption("--nodes <json>", "Node definitions to validate (JSON array, required)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.node.validate({
@@ -31,13 +33,13 @@ export function registerNodeCommands(parent, getApi) {
     });
     node
         .command("execute")
-        .description("Execute a node")
-        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
-        .requiredOption("--release-uuid <uuid>", "Release UUID")
-        .requiredOption("--node <json>", "Node definition (JSON object)")
-        .requiredOption("--computed-config <json>", "Computed config (JSON object)")
-        .requiredOption("--context <json>", "Execution context (JSON object)")
-        .option("--group-context <json>", "Group context (JSON object)")
+        .description("Execute a node within a workflow run")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID (string, required)")
+        .requiredOption("--release-uuid <uuid>", "Release UUID (string, required)")
+        .requiredOption("--node <json>", "Node definition (JSON object, required)")
+        .requiredOption("--computed-config <json>", "Computed configuration from 'node compute' (JSON object, required)")
+        .requiredOption("--context <json>", "Execution context (JSON object, required)")
+        .option("--group-context <json>", "Group context for grouped nodes (JSON object)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.node.execute({

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;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAsF7E"}
+{"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;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAuG7E"}

package/build/commands/orchestration/play.js

@@ -1,6 +1,8 @@
 import { handleApiCall, outputJson } from "../runHandler.js";
 export function registerPlayCommands(parent, getApi) {
-    const play = parent.command("play").description("Play operations");
+    const play = parent
+        .command("play")
+        .description("Manage plays (list, create, update, remove)");
     play
         .command("list")
         .description("List all plays")
@@ -12,12 +14,18 @@ export function registerPlayCommands(parent, getApi) {
     play
         .command("create")
         .description("Create a play")
-        .requiredOption("--name <name>", "Play name")
-        .requiredOption("--model-uuid <uuid>", "Model UUID")
-        .requiredOption("--change-kinds <kinds>", "Change kinds (comma-separated)")
-        .requiredOption("--run-creation-rule <rule>", 'Run creation rule (JSON, e.g. {"kind":"segment","segmentUuid":"..."} or {"kind":"record","record":{}})')
-        .option("--description <description>", "Description")
-        .option("--folder-uuid <uuid>", "Folder UUID")
+        .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")
+        .option("--description <description>", "Play description (string)")
+        .option("--folder-uuid <uuid>", "Folder UUID (string)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai orchestration play create --name "My Play" --model-uuid 550e8400-... \\
+      --change-kinds created,updated --run-creation-rule always
+  $ cargo-ai orchestration play create --name "Dedup" --model-uuid 550e8400-... \\
+      --change-kinds created --run-creation-rule noConcurrency --description "Dedup new records"`)
         .action(async (opts) => {
         const api = getApi();
         const changeKinds = opts.changeKinds

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

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

package/build/commands/orchestration/release.js

@@ -1,12 +1,14 @@
 import { handleApiCall, outputJson } from "../runHandler.js";
 export function registerReleaseCommands(parent, getApi) {
-    const release = parent.command("release").description("Release operations");
+    const release = parent
+        .command("release")
+        .description("Manage workflow releases (list, get)");
     release
         .command("list")
         .description("List releases")
-        .option("--workflow-uuid <uuid>", "Workflow UUID")
-        .option("--limit <n>", "Limit", "20")
-        .option("--offset <n>", "Offset", "0")
+        .option("--workflow-uuid <uuid>", "Filter by workflow UUID (string)")
+        .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) => {
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.release.list({

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;AAQxC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA8Z5E"}
+{"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;AAQxC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAsiB5E"}