@cargo-ai/cli 1.0.9 → 1.0.10

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

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

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

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

package/build/commands/orchestration/action.js

@@ -0,0 +1,64 @@
+import { handleApiCall, outputJson, parseJson, pollBatchUntilFinished, pollRunUntilFinished, } from "../runHandler.js";
+export function registerActionCommands(parent, getApi) {
+    const action = parent
+        .command("action")
+        .description("Execute actions (single run or batch)");
+    action
+        .command("execute")
+        .description("Execute a single action")
+        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-...","config":{}}\'')
+        .requiredOption("--data <json>", "Input data for the run (JSON object, required)")
+        .option("--wait-until-finished", "Poll the run until it reaches a terminal status before returning (boolean flag)")
+        .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai orchestration action execute --action '{"kind":"tool","toolUuid":"550e8400-...","config":{}}' --data '{"email":"user@example.com"}'
+  $ cargo-ai orchestration action execute --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message","config":{}}' --data '{"channel":"#general","text":"hello"}' --wait-until-finished`)
+        .action(async (opts) => {
+        const actionPayload = parseJson(opts.action, "--action");
+        const data = parseJson(opts.data, "--data");
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.action.execute({
+            action: actionPayload,
+            data,
+        }));
+        if (opts.waitUntilFinished === true) {
+            const intervalMs = parseInt(opts.pollingInterval, 10);
+            const finalResult = await pollRunUntilFinished(() => api.orchestration.run.get(result.run.uuid), (r) => r.run.status, intervalMs);
+            outputJson(finalResult);
+            return;
+        }
+        outputJson(result);
+    });
+    action
+        .command("execute-batch")
+        .description("Execute an action as a batch over multiple records")
+        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-...","config":{}}\'')
+        .requiredOption("--records <json>", 'Records to process (JSON array, required). Example: \'[{"email":"a@b.com"},{"email":"c@d.com"}]\'')
+        .option("--webhook-url <url>", "URL to call when the batch completes")
+        .option("--webhook-secret <secret>", "Secret used to sign webhook deliveries")
+        .option("--wait-until-finished", "Poll the batch until it reaches a terminal status before returning (boolean flag)")
+        .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai orchestration action execute-batch --action '{"kind":"tool","toolUuid":"550e8400-...","config":{}}' --records '[{"email":"a@b.com"},{"email":"c@d.com"}]'
+  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message","config":{}}' --records '[{"channel":"#general"}]' --wait-until-finished`)
+        .action(async (opts) => {
+        const actionPayload = parseJson(opts.action, "--action");
+        const records = parseJson(opts.records, "--records");
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.action.executeBatch({
+            action: actionPayload,
+            records,
+            webhookUrl: opts.webhookUrl,
+            webhookSecret: opts.webhookSecret,
+        }));
+        if (opts.waitUntilFinished === true) {
+            const intervalMs = parseInt(opts.pollingInterval, 10);
+            const finalResult = await pollBatchUntilFinished(() => api.orchestration.batch.get(result.batch.uuid), (r) => r.batch.status, intervalMs);
+            outputJson(finalResult);
+            return;
+        }
+        outputJson(result);
+    });
+}

package/build/commands/orchestration/batch.js

@@ -64,7 +64,7 @@ export function registerBatchCommands(parent, getApi) {
         .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("--nodes <json>", "Custom nodes to override the workflow definition (JSON array).")
         .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", `
@@ -114,7 +114,7 @@ Examples:
         .command("download")
         .description("Download batch results")
         .requiredOption("--uuid <uuid>", "Batch UUID (string, required)")
-        .requiredOption("--output-node-slug <slug>", "Output node slug to download from (string, required)")
+        .option("--output-node-slug <slug>", "Output node slug to download from (string)")
         .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;AAaxC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAgBN"}
+{"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;AAcxC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAiBN"}

package/build/commands/orchestration/index.js

@@ -1,3 +1,4 @@
+import { registerActionCommands } from "./action.js";
 import { registerBatchCommands } from "./batch.js";
 import { registerDraftReleaseCommands } from "./draftRelease.js";
 import { registerLogCommands } from "./log.js";
@@ -13,6 +14,7 @@ export function registerOrchestrationCommands(parent, getApi) {
     const orchestration = parent
         .command("orchestration")
         .description("Workflows, plays, runs, batches, tools, templates");
+    registerActionCommands(orchestration, getApi);
     registerWorkflowCommands(orchestration, getApi);
     registerPlayCommands(orchestration, getApi);
     registerRunCommands(orchestration, getApi);

package/build/commands/orchestration/record.js

@@ -138,7 +138,7 @@ export function registerRecordCommands(parent, getApi) {
         .command("download-outputs")
         .description("Download record outputs")
         .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
-        .requiredOption("--output-node-slug <slug>", "Output node slug")
+        .option("--output-node-slug <slug>", "Output node slug")
         .option("--format <format>", "Export format (csv or json)", "csv")
         .option("--ids <list>", "Record IDs (comma-separated)")
         .option("--title <title>", "Record title")

package/build/commands/orchestration/run.js

@@ -69,7 +69,7 @@ Examples:
         .option("--workflow-uuid <uuid>", "Workflow UUID (string)")
         .requiredOption("--data <json>", "Run input data (JSON object, required). The shape depends on your workflow's start node configuration")
         .option("--release-uuid <uuid>", "Release UUID to pin the run 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("--nodes <json>", "Custom nodes to override the workflow definition (JSON array).")
         .option("--wait-until-finished", "Poll the run 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", `
@@ -206,7 +206,7 @@ Examples:
         .command("download-outputs")
         .description("Download outputs from a specific node in matching runs")
         .requiredOption("--workflow-uuid <uuid>", "Workflow UUID (string, required)")
-        .requiredOption("--output-node-slug <slug>", "Output node slug to download from (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("--batch-uuid <uuid>", "Filter by batch UUID (string)")
         .option("--release-uuid <uuid>", "Filter by release UUID (string)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "private": false,
   "description": "Command-line interface for the Cargo API",
   "engines": {
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "commander": "^12.1.0",
-    "@cargo-ai/api": "^1.0.17"
+    "@cargo-ai/api": "^1.0.18"
   },
   "devDependencies": {
     "@cargo-ai/eslint-config": "*",