@cargo-ai/cli 1.0.1

package/build/commands/expression/recipe.js

@@ -0,0 +1,98 @@
+import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
+export function registerRecipeCommands(parent, getApi) {
+    const recipe = parent.command("recipe").description("Recipe operations");
+    recipe
+        .command("list")
+        .description("List recipes")
+        .option("--tab <tab>", "Tab filter (all, user, workspace, favorites)")
+        .option("--ui-types <types>", "UI types (comma-separated: js, ai)")
+        .option("--categories <cats>", "Categories (comma-separated)")
+        .option("--name <name>", "Filter by name")
+        .option("--limit <n>", "Limit")
+        .option("--offset <n>", "Offset")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.expression.recipe.list({
+            tab: opts.tab,
+            uiTypes: opts.uiTypes !== undefined
+                ? opts.uiTypes.split(",").map((s) => s.trim())
+                : undefined,
+            categories: opts.categories !== undefined
+                ? opts.categories
+                    .split(",")
+                    .map((s) => s.trim())
+                : undefined,
+            name: opts.name,
+            limit: opts.limit !== undefined ? parseInt(opts.limit, 10) : undefined,
+            offset: opts.offset !== undefined ? parseInt(opts.offset, 10) : undefined,
+        }));
+        outputJson(result);
+    });
+    recipe
+        .command("get <uuidOrShortId> [version]")
+        .description("Get recipe by UUID/shortId and optional version")
+        .action(async (uuidOrShortId, version) => {
+        const api = getApi();
+        const ver = version !== undefined ? parseInt(version, 10) : undefined;
+        const result = await handleApiCall(() => ver !== undefined
+            ? api.expression.recipe.get(uuidOrShortId, ver)
+            : api.expression.recipe.getLastVersion(uuidOrShortId));
+        outputJson(result);
+    });
+    recipe
+        .command("create")
+        .description("Create a recipe")
+        .requiredOption("--name <name>", "Recipe name")
+        .requiredOption("--description <text>", "Recipe description")
+        .requiredOption("--category <cat>", "Category (other, classification, cleaning, marketing, sales, event, copywriting)")
+        .requiredOption("--kind <kind>", "Kind (jsExpression or templateExpression)")
+        .requiredOption("--expression <expr>", "Expression")
+        .requiredOption("--instruct-to <value>", "Instruct to (ai or none)")
+        .requiredOption("--placeholders <json>", 'Placeholders (JSON array, e.g. [{"slug":"my_var","label":"My Variable","kind":"text"}])')
+        .option("--is-public", "Make recipe public")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.expression.recipe.create({
+            name: opts.name,
+            description: opts.description,
+            category: opts.category,
+            kind: opts.kind,
+            expression: opts.expression,
+            instructTo: opts.instructTo,
+            placeholders: parseJson(opts.placeholders, "--placeholders"),
+            isPublic: opts.isPublic === true,
+        }));
+        outputJson(result);
+    });
+    recipe
+        .command("create-new-version")
+        .description("Create a new version of a recipe")
+        .requiredOption("--uuid <uuid>", "Recipe UUID")
+        .requiredOption("--name <name>", "Recipe name")
+        .requiredOption("--description <text>", "Recipe description")
+        .requiredOption("--category <cat>", "Category (other, classification, cleaning, marketing, sales, event, copywriting)")
+        .requiredOption("--expression <expr>", "Expression")
+        .requiredOption("--placeholders <json>", 'Placeholders (JSON array, e.g. [{"slug":"my_var","label":"My Variable","kind":"text"}])')
+        .option("--is-public", "Make recipe public")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.expression.recipe.createNewVersion({
+            uuid: opts.uuid,
+            name: opts.name,
+            description: opts.description,
+            category: opts.category,
+            expression: opts.expression,
+            placeholders: parseJson(opts.placeholders, "--placeholders"),
+            isPublic: opts.isPublic === true,
+        }));
+        outputJson(result);
+    });
+    recipe
+        .command("archive <uuid>")
+        .description("Archive a recipe")
+        .action(async (uuid) => {
+        const api = getApi();
+        await handleApiCall(() => api.expression.recipe.archive(uuid));
+        outputJson({ ok: true });
+    });
+}

package/build/commands/init.d.ts

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

package/build/commands/init.d.ts.map

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

package/build/commands/init.js

@@ -0,0 +1,11 @@
+import { handleApiCall, outputJson } from "./runHandler.js";
+export function registerInitCommand(parent, getApi) {
+    parent
+        .command("init")
+        .description("Fetch workspace initialisation (user, workspace, datasets, etc.)")
+        .action(async () => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.getInitialisation());
+        outputJson(result);
+    });
+}

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

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

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

@@ -0,0 +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;AAGxC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAgKN"}

package/build/commands/orchestration/batch.js

@@ -0,0 +1,106 @@
+import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
+export function registerBatchCommands(parent, getApi) {
+    const batch = parent.command("batch").description("Batch operations");
+    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")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.batch.list({
+            workflowUuids: opts.workflowUuids !== undefined
+                ? opts.workflowUuids.split(",").map((s) => s.trim())
+                : undefined,
+            releaseUuid: opts.releaseUuid,
+            parentBatchUuid: opts.parentBatchUuid,
+            parentRunUuid: opts.parentRunUuid,
+            parentNodeUuid: opts.parentNodeUuid,
+            statuses: opts.statuses !== undefined
+                ? opts.statuses.split(",").map((s) => s.trim())
+                : undefined,
+            hasRuns: opts.hasRuns,
+            isSkipped: opts.isSkipped,
+            isFinished: opts.isFinished,
+            includedDataKinds: opts.includedDataKinds !== undefined
+                ? opts.includedDataKinds
+                    .split(",")
+                    .map((s) => s.trim())
+                : undefined,
+            excludedDataKinds: opts.excludedDataKinds !== undefined
+                ? opts.excludedDataKinds
+                    .split(",")
+                    .map((s) => s.trim())
+                : undefined,
+            limit: opts.limit !== undefined ? parseInt(opts.limit, 10) : undefined,
+            offset: opts.offset !== undefined ? parseInt(opts.offset, 10) : undefined,
+        }));
+        outputJson(result);
+    });
+    batch
+        .command("get <uuid>")
+        .description("Get a batch by UUID")
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.batch.get(uuid));
+        outputJson(result);
+    });
+    batch
+        .command("create")
+        .description("Create a batch")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
+        .requiredOption("--data <json>", 'Batch data (JSON, e.g. {"kind":"segment","segmentUuid":"..."} or {"kind":"file","s3Filename":"..."})')
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.batch.create({
+            workflowUuid: opts.workflowUuid,
+            data: parseJson(opts.data, "--data"),
+        }));
+        outputJson(result);
+    });
+    batch
+        .command("cancel <uuid>")
+        .description("Cancel a batch")
+        .action(async (uuid) => {
+        const api = getApi();
+        await handleApiCall(() => api.orchestration.batch.cancel(uuid));
+        outputJson({ ok: true });
+    });
+    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":"..."})')
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.batch.preview({
+            workflowUuid: opts.workflowUuid,
+            data: parseJson(opts.data, "--data"),
+        }));
+        outputJson(result);
+    });
+    batch
+        .command("download")
+        .description("Download batch results")
+        .requiredOption("--uuid <uuid>", "Batch UUID")
+        .requiredOption("--output-node-slug <slug>", "Output node slug")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.batch.download({
+            uuid: opts.uuid,
+            outputNodeSlug: opts.outputNodeSlug,
+        }));
+        outputJson(result);
+    });
+}

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

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

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

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

package/build/commands/orchestration/draftRelease.js

@@ -0,0 +1,73 @@
+import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
+export function registerDraftReleaseCommands(parent, getApi) {
+    const draftRelease = parent
+        .command("draft-release")
+        .description("Draft release operations");
+    draftRelease
+        .command("get")
+        .description("Get draft release for a workflow")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.draftRelease.get({
+            workflowUuid: opts.workflowUuid,
+        }));
+        outputJson(result);
+    });
+    draftRelease
+        .command("deploy")
+        .description("Deploy draft release")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
+        .requiredOption("--version <version>", "Release version")
+        .requiredOption("--nodes <json>", "Nodes (JSON array of node definitions)")
+        .requiredOption("--form-fields <json>", "Form fields (JSON array, or 'null')")
+        .option("--description <text>", "Release description")
+        .option("--options <json>", "Options (JSON object)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.draftRelease.deploy({
+            workflowUuid: opts.workflowUuid,
+            version: opts.version,
+            nodes: parseJson(opts.nodes, "--nodes"),
+            formFields: opts.formFields === "null"
+                ? null
+                : parseJson(opts.formFields, "--form-fields"),
+            description: opts.description,
+            options: opts.options !== undefined
+                ? parseJson(opts.options, "--options")
+                : undefined,
+        }));
+        outputJson(result);
+    });
+    draftRelease
+        .command("update")
+        .description("Update draft release")
+        .requiredOption("--workflow-uuid <uuid>", "Workflow UUID")
+        .option("--parent-uuid <uuid>", "Parent release UUID")
+        .option("--nodes <json>", "Nodes (JSON array of node definitions)")
+        .option("--test-records <json>", "Test records (JSON array)")
+        .option("--form-fields <json>", "Form fields (JSON array, or 'null')")
+        .option("--options <json>", "Options (JSON object)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.draftRelease.update({
+            workflowUuid: opts.workflowUuid,
+            parentUuid: opts.parentUuid,
+            nodes: opts.nodes !== undefined
+                ? parseJson(opts.nodes, "--nodes")
+                : undefined,
+            testRecords: opts.testRecords !== undefined
+                ? parseJson(opts.testRecords, "--test-records")
+                : undefined,
+            formFields: opts.formFields === "null"
+                ? null
+                : opts.formFields !== undefined
+                    ? parseJson(opts.formFields, "--form-fields")
+                    : undefined,
+            options: opts.options !== undefined
+                ? parseJson(opts.options, "--options")
+                : undefined,
+        }));
+        outputJson(result);
+    });
+}

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

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

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

@@ -0,0 +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"}

package/build/commands/orchestration/index.js

@@ -0,0 +1,25 @@
+import { registerBatchCommands } from "./batch.js";
+import { registerDraftReleaseCommands } from "./draftRelease.js";
+import { registerNodeCommands } from "./node.js";
+import { registerPlayCommands } from "./play.js";
+import { registerRecordCommands } from "./record.js";
+import { registerReleaseCommands } from "./release.js";
+import { registerRunCommands } from "./run.js";
+import { registerTemplateCommands } from "./template.js";
+import { registerToolCommands } from "./tool.js";
+import { registerWorkflowCommands } from "./workflow.js";
+export function registerOrchestrationCommands(parent, getApi) {
+    const orchestration = parent
+        .command("orchestration")
+        .description("Workflows, plays, runs, batches, tools, templates");
+    registerWorkflowCommands(orchestration, getApi);
+    registerPlayCommands(orchestration, getApi);
+    registerRunCommands(orchestration, getApi);
+    registerBatchCommands(orchestration, getApi);
+    registerReleaseCommands(orchestration, getApi);
+    registerDraftReleaseCommands(orchestration, getApi);
+    registerToolCommands(orchestration, getApi);
+    registerRecordCommands(orchestration, getApi);
+    registerTemplateCommands(orchestration, getApi);
+    registerNodeCommands(orchestration, getApi);
+}

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

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

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

@@ -0,0 +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,CAiE7E"}

package/build/commands/orchestration/node.js

@@ -0,0 +1,44 @@
+import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
+export function registerNodeCommands(parent, getApi) {
+    const node = parent.command("node").description("Node operations");
+    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)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.node.compute({
+            node: parseJson(opts.node, "--node"),
+            context: parseJson(opts.context, "--context"),
+            groupContext: opts.groupContext !== undefined
+                ? parseJson(opts.groupContext, "--group-context")
+                : undefined,
+        }));
+        outputJson(result);
+    });
+    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)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.node.execute({
+            workflowUuid: opts.workflowUuid,
+            releaseUuid: opts.releaseUuid,
+            node: parseJson(opts.node, "--node"),
+            computedConfig: parseJson(opts.computedConfig, "--computed-config"),
+            context: parseJson(opts.context, "--context"),
+            groupContext: opts.groupContext !== undefined
+                ? parseJson(opts.groupContext, "--group-context")
+                : undefined,
+        }));
+        outputJson(result);
+    });
+}

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

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

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

@@ -0,0 +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"}

package/build/commands/orchestration/play.js

@@ -0,0 +1,63 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+export function registerPlayCommands(parent, getApi) {
+    const play = parent.command("play").description("Play operations");
+    play
+        .command("list")
+        .description("List all plays")
+        .action(async () => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.play.all());
+        outputJson(result);
+    });
+    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")
+        .action(async (opts) => {
+        const api = getApi();
+        const changeKinds = opts.changeKinds
+            .split(",")
+            .map((s) => s.trim());
+        const validRules = [
+            "always",
+            "once",
+            "noConcurrency",
+        ];
+        const runCreationRule = opts.runCreationRule;
+        if (validRules.includes(runCreationRule) === false) {
+            throw new Error(`--run-creation-rule must be one of: ${validRules.join(", ")}`);
+        }
+        const result = await handleApiCall(() => api.orchestration.play.create({
+            name: opts.name,
+            modelUuid: opts.modelUuid,
+            changeKinds,
+            runCreationRule,
+            description: opts.description,
+            folderUuid: opts.folderUuid,
+        }));
+        outputJson(result);
+    });
+    play
+        .command("update <uuid>")
+        .description("Update a play")
+        .option("--name <name>", "Play name")
+        .option("--description <description>", "Description")
+        .action(async (uuid, opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.orchestration.play.update({ uuid, ...opts }));
+        outputJson(result);
+    });
+    play
+        .command("remove <uuid>")
+        .description("Remove a play")
+        .action(async (uuid) => {
+        const api = getApi();
+        await handleApiCall(() => api.orchestration.play.remove(uuid));
+        outputJson({ ok: true });
+    });
+}

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

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

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

@@ -0,0 +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;AAGxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuTN"}