@cargo-ai/cli 1.0.5 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # Cargo CLI
 
-Command-line interface for the [Cargo API](https://docs.getcargo.ai/api-reference/introduction). Manage workspaces, storage, orchestration, connections, billing, and more from the terminal.
+Command-line interface for the [Cargo API](https://docs.getcargo.ai/api-reference/introduction). Manage workspaces, storage, orchestration, connections, billing, and more from the terminal; for a complete feature overview, see the [Cargo CLI Overview](https://docs.getcargo.ai/reference/cli/overview).
 
 ## Requirements
 
@@ -91,9 +91,18 @@ cargo-ai orchestration workflow --help
 | **system-of-record**     | System of record, client, logs                             | `cargo-ai system-of-record sor list`, `cargo-ai system-of-record log list --payload '{}'`                                     |
 | **user-management**      | Current user (no workspace context)                        | `cargo-ai user-management user get-current`                                                                                   |
 | **ai**                   | AI templates, agents, releases, chats, MCP, files          | `cargo-ai ai template list`, `cargo-ai ai agent list`, `cargo-ai ai file list`                                                |
+| **context**              | Context repository, files, and skills                      | `cargo-ai context skill list`, `cargo-ai context skill get --slug <slug>`, `cargo-ai context file list`                       |
 
 Commands that accept complex payloads use a `--payload <json>` option (e.g. `cargo-ai orchestration play create --payload '{"name":"My Play",...}'`). Use `--help` on any subcommand for options.
 
+## Agent Skills
+
+[Cargo Skills](https://github.com/getcargohq/cargo-skills) teaches AI coding agents (Claude Code, Cursor, Windsurf, GitHub Copilot, etc.) how to use the Cargo CLI. Install the skill to let your agent build, run, and manage revenue automation workflows programmatically:
+
+```bash
+npx skills add getcargohq/cargo-skills
+```
+
 ## Development
 
 ```bash

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAgBxC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAmB3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAexC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAkB3E"}

package/build/commands/ai/index.js

@@ -8,14 +8,13 @@ import { registerMemoryCommands } from "./memory.js";
 import { registerMessageCommands } from "./message.js";
 import { registerPromptCommands } from "./prompt.js";
 import { registerReleaseCommands } from "./release.js";
-import { registerSkillCommands } from "./skill.js";
 import { registerSuggestedActionCommands } from "./suggestedAction.js";
 import { registerTemplateCommands } from "./template.js";
 import { registerVoteCommands } from "./vote.js";
 export function registerAiCommands(parent, getApi) {
     const ai = parent
         .command("ai")
-        .description("AI templates, agents, releases, chats, MCP, files, skills");
+        .description("AI templates, agents, releases, chats, MCP, files");
     registerTemplateCommands(ai, getApi);
     registerAgentCommands(ai, getApi);
     registerReleaseCommands(ai, getApi);
@@ -29,5 +28,4 @@ export function registerAiCommands(parent, getApi) {
     registerPromptCommands(ai, getApi);
     registerMemoryCommands(ai, getApi);
     registerSuggestedActionCommands(ai, getApi);
-    registerSkillCommands(ai, getApi);
 }

package/build/commands/ai/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/message.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,CAyIN"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAQxC,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA0JN"}

package/build/commands/ai/message.js

@@ -1,4 +1,4 @@
-import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
+import { handleApiCall, outputJson, parseJson, pollMessageUntilFinished, } from "../runHandler.js";
 export function registerMessageCommands(parent, getApi) {
     const message = parent.command("message").description("Message operations");
     message
@@ -10,7 +10,6 @@ export function registerMessageCommands(parent, getApi) {
         .option("--resources <json>", 'Resources (JSON array, e.g. [{"slug":"my-resource","kind":"model","modelUuid":"..."}])')
         .option("--capabilities <json>", 'Capabilities (JSON array, e.g. [{"slug":"web-browsing"}])')
         .option("--mcp-clients <json>", 'MCP clients (JSON array, e.g. [{"name":"my-mcp","url":"..."}])')
-        .option("--skill-uuids <uuids>", "Skill UUIDs (comma-separated)")
         .option("--system-prompt <text>", "System prompt")
         .option("--with-reasoning", "Enable reasoning")
         .option("--temperature <n>", "Sampling temperature")
@@ -18,6 +17,8 @@ export function registerMessageCommands(parent, getApi) {
         .option("--integration-slug <slug>", "Integration slug")
         .option("--connector-uuid <uuid>", "Connector UUID")
         .option("--language-model-slug <slug>", "Language model slug")
+        .option("--wait-until-finished", "Poll the assistant message until it reaches a terminal status before returning")
+        .option("--polling-interval <ms>", "Polling interval in milliseconds (used with --wait-until-finished)", "5000")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.ai.message.create({
@@ -35,9 +36,6 @@ export function registerMessageCommands(parent, getApi) {
             mcpClients: opts.mcpClients !== undefined
                 ? parseJson(opts.mcpClients, "--mcp-clients")
                 : undefined,
-            skillUuids: opts.skillUuids !== undefined
-                ? opts.skillUuids.split(",").map((s) => s.trim())
-                : undefined,
             systemPrompt: opts.systemPrompt,
             withReasoning: opts.withReasoning,
             temperature: opts.temperature !== undefined
@@ -50,6 +48,12 @@ export function registerMessageCommands(parent, getApi) {
             connectorUuid: opts.connectorUuid,
             languageModelSlug: opts.languageModelSlug,
         }));
+        if (opts.waitUntilFinished === true) {
+            const intervalMs = parseInt(opts.pollingInterval, 10);
+            const finalResult = await pollMessageUntilFinished(() => api.ai.message.get(result.assistantMessage.uuid), (r) => r.message.finishedAt, intervalMs);
+            outputJson(finalResult);
+            return;
+        }
         outputJson(result);
     });
     message

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

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

package/build/commands/ai/release.js

@@ -114,7 +114,6 @@ export function registerReleaseCommands(parent, getApi) {
         .option("--max-steps <n>", "Max steps")
         .option("--connector-uuid <uuid>", "Connector UUID")
         .option("--description <text>", "Release description")
-        .option("--skill-uuids <uuids>", "Skill UUIDs (comma-separated)")
         .option("--options <json>", "Options (JSON)")
         .action(async (opts) => {
         const api = getApi();
@@ -128,9 +127,6 @@ export function registerReleaseCommands(parent, getApi) {
             resources: parseJson(opts.resources, "--resources"),
             capabilities: parseJson(opts.capabilities, "--capabilities"),
             suggestedActions: parseJson(opts.suggestedActions, "--suggested-actions"),
-            skillUuids: opts.skillUuids !== undefined
-                ? opts.skillUuids.split(",").map((uuid) => uuid.trim())
-                : [],
             systemPrompt: opts.systemPrompt,
             withReasoning: opts.withReasoning,
             temperature: opts.temperature !== undefined

package/build/commands/ai/template.js

@@ -8,7 +8,7 @@ export function registerTemplateCommands(parent, getApi) {
         .description("List all AI templates")
         .action(async () => {
         const api = getApi();
-        const result = await handleApiCall(() => api.ai.template.all());
+        const result = await handleApiCall(() => api.ai.template.list({}));
         outputJson(result);
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA+LN"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/commands/connection/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAkNN"}

package/build/commands/connection/connector.js

@@ -6,9 +6,20 @@ export function registerConnectorCommands(parent, getApi) {
     connector
         .command("list")
         .description("List all connectors")
-        .action(async () => {
+        .option("--integration-slug <slug>", "Filter connectors by integration slug")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.connection.connector.list({
+            integrationSlug: opts.integrationSlug,
+        }));
+        outputJson(result);
+    });
+    connector
+        .command("get <uuid>")
+        .description("Get a connector by UUID")
+        .action(async (uuid) => {
         const api = getApi();
-        const result = await handleApiCall(() => api.connection.connector.all());
+        const result = await handleApiCall(() => api.connection.connector.get({ uuid }));
         outputJson(result);
     });
     connector

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

package/build/commands/connection/integration.js

@@ -6,9 +6,36 @@ export function registerIntegrationCommands(parent, getApi) {
     integration
         .command("list")
         .description("List all integrations")
-        .action(async () => {
+        .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)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.connection.integration.list({
+            category: opts.category,
+            slug: opts.slug,
+            search: opts.search,
+            hasActions: opts.hasActions === "true"
+                ? true
+                : opts.hasActions === "false"
+                    ? false
+                    : undefined,
+            hasExtractors: opts.hasExtractors === "true"
+                ? true
+                : opts.hasExtractors === "false"
+                    ? false
+                    : undefined,
+        }));
+        outputJson(result);
+    });
+    integration
+        .command("get <slug>")
+        .description("Get an integration by slug")
+        .action(async (slug) => {
         const api = getApi();
-        const result = await handleApiCall(() => api.connection.integration.all());
+        const result = await handleApiCall(() => api.connection.integration.get({ slug }));
         outputJson(result);
     });
     integration

package/build/commands/context/file.d.ts

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

package/build/commands/context/file.d.ts.map

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

package/build/commands/context/file.js

@@ -0,0 +1,39 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+export function registerFileCommands(parent, getApi) {
+    const file = parent.command("file").description("Context file operations");
+    file
+        .command("browse")
+        .description("Browse files in the context repository")
+        .option("--path <path>", "Path to browse (omit for root)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.context.file.browse({ path: opts.path }));
+        outputJson(result);
+    });
+    file
+        .command("read")
+        .description("Read a file from the context repository")
+        .requiredOption("--path <path>", "Full path to the file")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.context.file.read({ path: opts.path }));
+        outputJson(result);
+    });
+    file
+        .command("write")
+        .description("Write a file to the context repository")
+        .requiredOption("--path <path>", "Full path to the file")
+        .requiredOption("--content <content>", "Content to write")
+        .option("--commit-message <message>", "Commit message")
+        .option("--sha <sha>", "SHA of the existing file to update")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.context.file.write({
+            path: opts.path,
+            content: opts.content,
+            commitMessage: opts.commitMessage,
+            sha: opts.sha,
+        }));
+        outputJson(result);
+    });
+}

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

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

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

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

package/build/commands/context/index.js

@@ -0,0 +1,11 @@
+import { registerFileCommands } from "./file.js";
+import { registerRepositoryCommands } from "./repository.js";
+import { registerSkillCommands } from "./skill.js";
+export function registerContextCommands(parent, getApi) {
+    const context = parent
+        .command("context")
+        .description("Context repository, files, and skills");
+    registerRepositoryCommands(context, getApi);
+    registerFileCommands(context, getApi);
+    registerSkillCommands(context, getApi);
+}

package/build/commands/context/repository.d.ts

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

package/build/commands/context/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/commands/context/repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA8CN"}

package/build/commands/context/repository.js

@@ -0,0 +1,33 @@
+import { handleApiCall, outputJson, parseJson } from "../runHandler.js";
+export function registerRepositoryCommands(parent, getApi) {
+    const repository = parent
+        .command("repository")
+        .description("Context repository operations");
+    repository
+        .command("get")
+        .description("Get the context repository configuration")
+        .action(async () => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.context.repository.get());
+        outputJson(result);
+    });
+    repository
+        .command("update")
+        .description("Update the context repository configuration")
+        .option("--source <json>", 'Repository source (JSON, e.g. {"kind":"managed"} or {"kind":"custom","connectorUuid":"..."})')
+        .option("--repository-owner <owner>", "GitHub owner (user or org)")
+        .option("--repository-name <name>", "GitHub repository name")
+        .option("--default-branch <branch>", "Default branch (e.g. main)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.context.repository.update({
+            source: opts.source !== undefined
+                ? parseJson(opts.source, "--source")
+                : undefined,
+            repositoryOwner: opts.repositoryOwner,
+            repositoryName: opts.repositoryName,
+            defaultBranch: opts.defaultBranch,
+        }));
+        outputJson(result);
+    });
+}

package/build/commands/context/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/commands/context/skill.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,CAuBN"}

package/build/commands/context/skill.js

@@ -0,0 +1,21 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+export function registerSkillCommands(parent, getApi) {
+    const skill = parent.command("skill").description("Context skill operations");
+    skill
+        .command("list")
+        .description("List all skills in the context repository")
+        .action(async () => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.context.skill.list());
+        outputJson(result);
+    });
+    skill
+        .command("get")
+        .description("Get a skill by slug")
+        .requiredOption("--slug <slug>", "Skill slug (path in the repository)")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.context.skill.get({ slug: opts.slug }));
+        outputJson(result);
+    });
+}

package/build/commands/orchestration/template.js

@@ -8,7 +8,7 @@ export function registerTemplateCommands(parent, getApi) {
         .description("List all templates")
         .action(async () => {
         const api = getApi();
-        const result = await handleApiCall(() => api.orchestration.template.all());
+        const result = await handleApiCall(() => api.orchestration.template.list({}));
         outputJson(result);
     });
     template

package/build/commands/runHandler.d.ts

@@ -3,4 +3,5 @@ export declare function parseJson(value: string, optionName: string): any;
 export declare function handleApiCall<T>(fn: () => Promise<T>): Promise<T | never>;
 export declare function pollRunUntilFinished<T>(getResult: () => Promise<T>, getStatus: (result: T) => string, intervalMs: number): Promise<T>;
 export declare function pollBatchUntilFinished<T>(getResult: () => Promise<T>, getStatus: (result: T) => string, intervalMs: number): Promise<T>;
+export declare function pollMessageUntilFinished<T>(getResult: () => Promise<T>, getFinishedAt: (result: T) => string | null | undefined, intervalMs: number): Promise<T>;
 //# sourceMappingURL=runHandler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"runHandler.d.ts","sourceRoot":"","sources":["../../src/commands/runHandler.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/C;AAGD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAWhE;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAiBpB;AAoBD,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ"}
+{"version":3,"file":"runHandler.d.ts","sourceRoot":"","sources":["../../src/commands/runHandler.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/C;AAGD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAWhE;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAiBpB;AAoBD,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EACvD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/build/commands/runHandler.js

@@ -62,3 +62,12 @@ export async function pollBatchUntilFinished(getResult, getStatus, intervalMs) {
     }
     return result;
 }
+export async function pollMessageUntilFinished(getResult, getFinishedAt, intervalMs) {
+    let result = await handleApiCall(getResult);
+    const finishedAt = getFinishedAt(result);
+    while (finishedAt === null || finishedAt === undefined) {
+        await sleep(intervalMs);
+        result = await handleApiCall(getResult);
+    }
+    return result;
+}

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

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

package/build/commands/storage/record.js

@@ -3,13 +3,44 @@ export function registerRecordCommands(parent, getApi) {
     const record = parent
         .command("record")
         .description("Storage record operations");
+    record
+        .command("get")
+        .description("Get a storage record")
+        .requiredOption("--model-uuid <uuid>", "Model UUID")
+        .requiredOption("--id <id>", "Record ID")
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.storage.record.get({ modelUuid: opts.modelUuid, id: opts.id }));
+        outputJson(result);
+    });
     record
         .command("list")
         .description("List storage records")
         .requiredOption("--model-uuid <uuid>", "Model UUID")
+        .option("--limit <n>", "Limit")
+        .option("--offset <n>", "Offset")
+        .option("--sort-kind <kind>", "Sort direction (asc|desc)")
+        .option("--sort-column-slug <slug>", "Sort column (_id|_title|_emitted_at)")
         .action(async (opts) => {
         const api = getApi();
-        const result = await handleApiCall(() => api.storage.record.list({ modelUuid: opts.modelUuid }));
+        const limit = opts.limit !== undefined ? parseInt(opts.limit, 10) : undefined;
+        const offset = opts.offset !== undefined ? parseInt(opts.offset, 10) : undefined;
+        const sort = opts.sortKind !== undefined || opts.sortColumnSlug !== undefined
+            ? {
+                kind: opts.sortKind !== undefined
+                    ? opts.sortKind
+                    : "asc",
+                columnSlug: opts.sortColumnSlug !== undefined
+                    ? opts.sortColumnSlug
+                    : "_id",
+            }
+            : undefined;
+        const result = await handleApiCall(() => api.storage.record.list({
+            modelUuid: opts.modelUuid,
+            limit,
+            offset,
+            sort,
+        }));
         outputJson(result);
     });
 }

package/build/commands/systemOfRecordIntegration/systemOfRecord.js

@@ -3,7 +3,7 @@ export function registerSystemOfRecordCommands(parent, getApi) {
     const sor = parent.command("sor").description("System of record operations");
     sor
         .command("list")
-        .description("List all system of records")
+        .description("List all systems of record")
         .action(async () => {
         const api = getApi();
         const result = await handleApiCall(() => api.systemOfRecordIntegration.systemOfRecord.all());

package/build/index.js

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { Command } from "commander";
 import { createApi } from "./api.js";
 import { registerAiCommands } from "./commands/ai/index.js";
 import { registerAuthCommands } from "./commands/auth.js";
 import { registerBillingCommands } from "./commands/billing/index.js";
 import { registerConnectionCommands } from "./commands/connection/index.js";
+import { registerContextCommands } from "./commands/context/index.js";
 import { registerExpressionCommands } from "./commands/expression/index.js";
 import { registerInitCommand } from "./commands/init.js";
 import { registerOrchestrationCommands } from "./commands/orchestration/index.js";
@@ -14,8 +16,10 @@ import { registerStorageCommands } from "./commands/storage/index.js";
 import { registerSystemOfRecordIntegrationCommands } from "./commands/systemOfRecordIntegration/index.js";
 import { registerUserManagementCommands } from "./commands/userManagement/index.js";
 import { registerWorkspaceCommands } from "./commands/workspace/index.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 const program = new Command();
-program.name("cargo-ai").description("Cargo API CLI").version("1.0.0");
+program.name("cargo-ai").description("Cargo API CLI").version(version);
 registerAuthCommands(program);
 const getApi = () => createApi();
 registerInitCommand(program, getApi);
@@ -23,6 +27,7 @@ registerOrchestrationCommands(program, getApi);
 registerWorkspaceCommands(program, getApi);
 registerStorageCommands(program, getApi);
 registerConnectionCommands(program, getApi);
+registerContextCommands(program, getApi);
 registerBillingCommands(program, getApi);
 registerSegmentationCommands(program, getApi);
 registerRevenueOrganizationCommands(program, getApi);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "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.11"
+    "@cargo-ai/api": "^1.0.13"
   },
   "devDependencies": {
     "@cargo-ai/eslint-config": "*",

package/build/commands/ai/skill.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/commands/ai/skill.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,CAmJN"}

package/build/commands/ai/skill.js

@@ -1,101 +0,0 @@
-import { handleApiCall, outputJson } from "../runHandler.js";
-export function registerSkillCommands(parent, getApi) {
-    const skill = parent
-        .command("skill")
-        .description("Skill operations (list, get, create, remove, existsBySlug)");
-    skill
-        .command("all")
-        .description("Get all workspace skills")
-        .action(async () => {
-        const api = getApi();
-        const result = await handleApiCall(() => api.ai.skill.all());
-        outputJson(result);
-    });
-    skill
-        .command("get <uuid>")
-        .description("Get skill metadata")
-        .action(async (uuid) => {
-        const api = getApi();
-        const result = await handleApiCall(() => api.ai.skill.get(uuid));
-        outputJson(result);
-    });
-    skill
-        .command("content <uuid>")
-        .description("Get skill with body content and files")
-        .action(async (uuid) => {
-        const api = getApi();
-        const result = await handleApiCall(() => api.ai.skill.getContent(uuid));
-        outputJson(result);
-    });
-    skill
-        .command("create")
-        .description("Create a skill (custom or from a GitHub community source)")
-        .requiredOption("--slug <slug>", "Skill slug (lowercase, underscores)")
-        .option("--name <name>", "Skill display name")
-        .option("--description <description>", "Skill description")
-        .option("--body <body>", "Skill body content")
-        .option("--source-owner <owner>", "GitHub repo owner (community source)")
-        .option("--source-repo <repo>", "GitHub repo name (community source)")
-        .option("--source-path <path>", "Path to skill within the repo (community source)")
-        .action(async (options) => {
-        const api = getApi();
-        const isCommunity = options.sourceOwner !== undefined && options.sourceRepo !== undefined;
-        const source = isCommunity === true
-            ? {
-                kind: "community",
-                owner: options.sourceOwner,
-                repo: options.sourceRepo,
-                path: options.sourcePath,
-            }
-            : { kind: "custom" };
-        const result = await handleApiCall(() => api.ai.skill.create({
-            slug: options.slug,
-            name: options.name,
-            description: options.description,
-            body: options.body,
-            source,
-        }));
-        outputJson(result);
-    });
-    skill
-        .command("update <uuid>")
-        .description("Update a custom skill")
-        .option("--name <name>", "New display name")
-        .option("--description <description>", "New description")
-        .option("--body <body>", "New body content")
-        .option("--files <json>", "JSON array of {path, content} file entries")
-        .action(async (uuid, options) => {
-        const api = getApi();
-        const payload = { uuid };
-        if (options.name !== undefined) {
-            payload.name = options.name;
-        }
-        if (options.description !== undefined) {
-            payload.description = options.description;
-        }
-        if (options.body !== undefined) {
-            payload.body = options.body;
-        }
-        if (options.files !== undefined) {
-            payload.files = JSON.parse(options.files);
-        }
-        const result = await handleApiCall(() => api.ai.skill.update(payload));
-        outputJson(result);
-    });
-    skill
-        .command("exists-by-slug <slug>")
-        .description("Check if a skill with the given slug exists")
-        .action(async (slug) => {
-        const api = getApi();
-        const result = await handleApiCall(() => api.ai.skill.existsBySlug({ slug }));
-        outputJson(result);
-    });
-    skill
-        .command("remove <uuid>")
-        .description("Remove a skill")
-        .action(async (uuid) => {
-        const api = getApi();
-        await handleApiCall(() => api.ai.skill.remove(uuid));
-        outputJson({ outcome: "removed" });
-    });
-}