@cargo-ai/cli 1.0.59 → 1.0.61

package/README.md

@@ -156,6 +156,7 @@ cargo-ai orchestration workflow --help
 | **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, runtime sandbox, and knowledge graph          | `cargo-ai context repository get`, `cargo-ai context runtime browse --path <path>`, `cargo-ai context graph get`              |
 | **hosting**              | Cargo Hosting apps (Vite SPAs), workers, and deployments          | `cargo-ai hosting app list`, `cargo-ai hosting worker list`, `cargo-ai hosting deployment list --payload '{}'`                |
+| **mailboxManagement**    | Owned sending mailboxes, threads, events, suppressions, pricing   | `cargo-ai mailboxManagement mailbox list`, `cargo-ai mailboxManagement mailbox get-send-allowance <uuid>`                     |
 | **cdk**                  | Declarative IaC: define resources in code, deploy, generate types | `cargo-ai cdk init <dir>`, `cargo-ai cdk types`, `cargo-ai cdk plan`, `cargo-ai cdk deploy`                                   |
 
 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.

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

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

package/build/commands/ai/chat.js

@@ -10,6 +10,7 @@ export function registerChatCommands(parent, getApi) {
         .option("--release-uuid <uuid>", "Filter by release UUID (string)")
         .option("--user-uuid <uuid>", "Filter by user UUID (string)")
         .option("--trigger-type <type>", "Filter by trigger type (string: chat, draft, cron, ...)")
+        .option("--search <text>", "Case-insensitive partial match on chat name or slug")
         .option("--limit <n>", "Max results to return (integer)")
         .option("--offset <n>", "Number of results to skip (integer)")
         .action(async (opts) => {
@@ -19,6 +20,7 @@ export function registerChatCommands(parent, getApi) {
             releaseUuid: opts.releaseUuid,
             userUuid: opts.userUuid,
             triggerType: opts.triggerType,
+            search: opts.search,
             limit: opts.limit !== undefined ? parseInt(opts.limit, 10) : undefined,
             offset: opts.offset !== undefined ? parseInt(opts.offset, 10) : undefined,
         }));

package/build/commands/mailboxManagement/event.d.ts

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

package/build/commands/mailboxManagement/event.d.ts.map

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

package/build/commands/mailboxManagement/event.js

@@ -0,0 +1,38 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+import { csvList, optionalLimit, optionalOffset } from "./options.js";
+export function registerEventCommands(parent, getApi) {
+    const event = parent
+        .command("event")
+        .description("Delivery events on outbound mail (sent, opened, clicked, replied, bounced, unsubscribed)");
+    event
+        .command("list")
+        .description("List mailbox events")
+        .option("--mailbox-uuid <uuid>", "Filter by mailbox")
+        .option("--message-uuid <uuid>", "Filter by outbound message")
+        .option("--thread-uuid <uuid>", "Filter by thread")
+        .option("--kinds <list>", "Filter by kind (comma-separated: sent,opened,clicked,replied,bounced,unsubscribed)")
+        .option("--occurred-after <date>", "Occurred after (ISO 8601)")
+        .option("--occurred-before <date>", "Occurred before (ISO 8601)")
+        .option("--search <text>", "Search actor email or snippet")
+        .option("--limit <n>", "Max results to return (integer)")
+        .option("--offset <n>", "Number of results to skip (integer)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai mailboxManagement event list --mailbox-uuid 550e8400-...
+  $ cargo-ai mailboxManagement event list --kinds replied,unsubscribed --limit 50`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.event.list({
+            mailboxUuid: opts.mailboxUuid,
+            messageUuid: opts.messageUuid,
+            threadUuid: opts.threadUuid,
+            kinds: csvList(opts.kinds),
+            occurredAfter: opts.occurredAfter,
+            occurredBefore: opts.occurredBefore,
+            search: opts.search,
+            limit: optionalLimit(opts.limit),
+            offset: optionalOffset(opts.offset),
+        }));
+        outputJson(result);
+    });
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/mailboxManagement/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAQxC,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAaN"}

package/build/commands/mailboxManagement/index.js

@@ -0,0 +1,17 @@
+import { registerEventCommands } from "./event.js";
+import { registerMailboxCommands } from "./mailbox.js";
+import { registerMessageCommands } from "./message.js";
+import { registerPricingCommands } from "./pricing.js";
+import { registerSuppressionCommands } from "./suppression.js";
+import { registerThreadCommands } from "./thread.js";
+export function registerMailboxManagementCommands(parent, getApi) {
+    const mailboxManagement = parent
+        .command("mailboxManagement")
+        .description("Owned sending mailboxes, threads, events, suppressions, and pricing");
+    registerMailboxCommands(mailboxManagement, getApi);
+    registerMessageCommands(mailboxManagement, getApi);
+    registerThreadCommands(mailboxManagement, getApi);
+    registerEventCommands(mailboxManagement, getApi);
+    registerSuppressionCommands(mailboxManagement, getApi);
+    registerPricingCommands(mailboxManagement, getApi);
+}

package/build/commands/mailboxManagement/mailbox.d.ts

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

package/build/commands/mailboxManagement/mailbox.d.ts.map

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

package/build/commands/mailboxManagement/mailbox.js

@@ -0,0 +1,172 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+import { csvList, optionalCleared, optionalDailyTarget, optionalLimit, optionalOffset, } from "./options.js";
+export function registerMailboxCommands(parent, getApi) {
+    const mailbox = parent
+        .command("mailbox")
+        .description("Owned sending inboxes (provision, warm-up, send allowance). Delivery is sendEmail, not this group.");
+    mailbox
+        .command("list")
+        .description("List mailboxes in this workspace")
+        .option("--domain-uuid <uuid>", "Only mailboxes on this sending domain")
+        .option("--folder-uuid <uuid>", 'Folder UUID, or "none" for mailboxes not in a folder')
+        .option("--statuses <list>", "Filter by statuses (comma-separated: pending,active,inactive)")
+        .option("--limit <n>", "Max results to return (integer)")
+        .option("--offset <n>", "Number of results to skip (integer)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai mailboxManagement mailbox list
+  $ cargo-ai mailboxManagement mailbox list --domain-uuid 550e8400-... --statuses active
+  $ cargo-ai mailboxManagement mailbox list | jq -r '.mailboxes[] | "\\(.email) \\(.uuid)"'`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.list({
+            domainUuid: opts.domainUuid,
+            folderUuid: optionalCleared(opts.folderUuid),
+            statuses: csvList(opts.statuses),
+            limit: optionalLimit(opts.limit),
+            offset: optionalOffset(opts.offset),
+        }));
+        outputJson(result);
+    });
+    mailbox
+        .command("get <uuid>")
+        .description("Get a mailbox by UUID")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai mailboxManagement mailbox get 550e8400-e29b-41d4-a716-446655440000`)
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.get(uuid));
+        outputJson(result);
+    });
+    mailbox
+        .command("create")
+        .description("Provision a mailbox on a sending domain the workspace owns")
+        .requiredOption("--domain-uuid <uuid>", "Sending domain UUID")
+        .requiredOption("--type <type>", "Mailbox flavour: google, shared, or private (outlook cannot deliver yet)")
+        .requiredOption("--username <local-part>", "Local part of the address, e.g. jane for jane@acme.com")
+        .requiredOption("--first-name <name>", "Sender first name in the From header")
+        .requiredOption("--last-name <name>", "Sender last name in the From header")
+        .option("--signature <html>", "HTML signature stored on the mailbox")
+        .option("--folder-uuid <uuid>", "Folder UUID of kind mailbox")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai mailboxManagement mailbox create \\
+      --domain-uuid 550e8400-... --type google --username jane \\
+      --first-name Jane --last-name Doe
+  $ cargo-ai mailboxManagement mailbox create \\
+      --domain-uuid 550e8400-... --type shared --username outreach \\
+      --first-name Cargo --last-name Outreach --folder-uuid 660e8400-...
+
+The mailbox starts pending until the provider issues credentials. Prefer
+defineMailbox in a CDK repo for the inbox itself; this command is the
+imperative counterpart.`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.create({
+            domainUuid: opts.domainUuid,
+            type: opts.type,
+            username: opts.username,
+            firstName: opts.firstName,
+            lastName: opts.lastName,
+            signature: opts.signature,
+            folderUuid: opts.folderUuid,
+        }));
+        outputJson(result);
+    });
+    mailbox
+        .command("update")
+        .description("Update a mailbox's name, signature, or folder")
+        .requiredOption("--uuid <uuid>", "Mailbox UUID")
+        .option("--first-name <name>", "Sender first name in the From header")
+        .option("--last-name <name>", "Sender last name in the From header")
+        .option("--signature <html>", 'HTML signature, or "none" to clear it')
+        .option("--folder-uuid <uuid>", 'Folder UUID, or "none" to move the mailbox to the root')
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai mailboxManagement mailbox update --uuid 550e8400-... --first-name Janet
+  $ cargo-ai mailboxManagement mailbox update --uuid 550e8400-... --folder-uuid none`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.update({
+            uuid: opts.uuid,
+            firstName: opts.firstName,
+            lastName: opts.lastName,
+            signature: optionalCleared(opts.signature),
+            folderUuid: optionalCleared(opts.folderUuid),
+        }));
+        outputJson(result);
+    });
+    mailbox
+        .command("remove <uuid>")
+        .description("Delete a mailbox at the provider and in Cargo")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai mailboxManagement mailbox remove 550e8400-e29b-41d4-a716-446655440000`)
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.remove({ uuid }));
+        outputJson(result);
+    });
+    mailbox
+        .command("refresh-status <uuid>")
+        .description("Re-poll the provider for credentials and status")
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.refreshStatus({ uuid }));
+        outputJson(result);
+    });
+    mailbox
+        .command("start-warmup <uuid>")
+        .description("Start provider warm-up (dummy mail) and the Cargo send ramp")
+        .option("--daily-target <n>", "Warm-up messages per day at full ramp (provider default if omitted)")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai mailboxManagement mailbox start-warmup 550e8400-... --daily-target 40`)
+        .action(async (uuid, opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.startWarmup({
+            uuid,
+            dailyTarget: optionalDailyTarget(opts.dailyTarget),
+        }));
+        outputJson(result);
+    });
+    mailbox
+        .command("update-warmup")
+        .description("Change warm-up daily target or pause/resume the pool")
+        .requiredOption("--uuid <uuid>", "Mailbox UUID")
+        .option("--daily-target <n>", "Warm-up messages per day at full ramp")
+        .option("--status <status>", "Warm-up state: disabled, pending, active, paused, failed")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai mailboxManagement mailbox update-warmup --uuid 550e8400-... --status paused`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.updateWarmup({
+            uuid: opts.uuid,
+            dailyTarget: optionalDailyTarget(opts.dailyTarget),
+            status: opts.status,
+        }));
+        outputJson(result);
+    });
+    mailbox
+        .command("stop-warmup <uuid>")
+        .description("Tear down provider warm-up and reset the Cargo send ramp")
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.stopWarmup({ uuid }));
+        outputJson(result);
+    });
+    mailbox
+        .command("get-send-allowance <uuid>")
+        .description("Today's remaining real sends under the ramp (rolling 24h window)")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai mailboxManagement mailbox get-send-allowance 550e8400-...
+  $ cargo-ai mailboxManagement mailbox get-send-allowance 550e8400-... | jq .allowance`)
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.mailbox.getSendAllowance({ uuid }));
+        outputJson(result);
+    });
+}

package/build/commands/mailboxManagement/message.d.ts

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

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

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

package/build/commands/mailboxManagement/message.js

@@ -0,0 +1,44 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+import { csvList, optionalLimit, optionalOffset } from "./options.js";
+export function registerMessageCommands(parent, getApi) {
+    const message = parent
+        .command("message")
+        .description("Outbound emails sent from a mailbox");
+    message
+        .command("list")
+        .description("List outbound messages")
+        .option("--mailbox-uuid <uuid>", "Filter by mailbox")
+        .option("--thread-uuid <uuid>", "Filter by thread")
+        .option("--statuses <list>", "Filter by list status (comma-separated: pending,error,sent,opened,clicked,replied,bounced,unsubscribed)")
+        .option("--created-after <date>", "Created after (ISO 8601)")
+        .option("--created-before <date>", "Created before (ISO 8601)")
+        .option("--search <text>", "Search subject or recipient")
+        .option("--limit <n>", "Max results to return (integer)")
+        .option("--offset <n>", "Number of results to skip (integer)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai mailboxManagement message list --mailbox-uuid 550e8400-...
+  $ cargo-ai mailboxManagement message list --statuses sent,replied --limit 50`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.message.list({
+            mailboxUuid: opts.mailboxUuid,
+            threadUuid: opts.threadUuid,
+            statuses: csvList(opts.statuses),
+            createdAfter: opts.createdAfter,
+            createdBefore: opts.createdBefore,
+            search: opts.search,
+            limit: optionalLimit(opts.limit),
+            offset: optionalOffset(opts.offset),
+        }));
+        outputJson(result);
+    });
+    message
+        .command("get <uuid>")
+        .description("Get an outbound message by UUID")
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.message.get(uuid));
+        outputJson(result);
+    });
+}

package/build/commands/mailboxManagement/options.d.ts

@@ -0,0 +1,10 @@
+/** Comma-separated flag → trimmed list, or omitted. */
+export declare function csvList(value: string | undefined): string[] | undefined;
+/**
+ * Optional UUID / clearable string flags: omit = leave live, `none` = null.
+ */
+export declare function optionalCleared(value: string | undefined): string | null | undefined;
+export declare function optionalLimit(value: string | undefined): number | undefined;
+export declare function optionalOffset(value: string | undefined): number | undefined;
+export declare function optionalDailyTarget(value: string | undefined): number | undefined;
+//# sourceMappingURL=options.d.ts.map

package/build/commands/mailboxManagement/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/commands/mailboxManagement/options.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAGvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,IAAI,GAAG,SAAS,CAI3B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS5E;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,SAAS,CAGpB"}

package/build/commands/mailboxManagement/options.js

@@ -0,0 +1,38 @@
+import { ExitCodes, failWith, parsePositiveInt } from "../runHandler.js";
+/** Comma-separated flag → trimmed list, or omitted. */
+export function csvList(value) {
+    if (value === undefined)
+        return undefined;
+    return value.split(",").map((part) => part.trim());
+}
+/**
+ * Optional UUID / clearable string flags: omit = leave live, `none` = null.
+ */
+export function optionalCleared(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === "none")
+        return null;
+    return value;
+}
+export function optionalLimit(value) {
+    if (value === undefined)
+        return undefined;
+    return parsePositiveInt(value, "--limit");
+}
+export function optionalOffset(value) {
+    if (value === undefined)
+        return undefined;
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) === true || n < 0) {
+        failWith("--offset must be a non-negative integer.", {
+            code: ExitCodes.InvalidUsage,
+        });
+    }
+    return n;
+}
+export function optionalDailyTarget(value) {
+    if (value === undefined)
+        return undefined;
+    return parsePositiveInt(value, "--daily-target");
+}

package/build/commands/mailboxManagement/pricing.d.ts

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

package/build/commands/mailboxManagement/pricing.d.ts.map

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

package/build/commands/mailboxManagement/pricing.js

@@ -0,0 +1,18 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+export function registerPricingCommands(parent, getApi) {
+    const pricing = parent
+        .command("pricing")
+        .description("Monthly credit cost of each mailbox flavour");
+    pricing
+        .command("get")
+        .description("Get monthly credits charged per mailbox type")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai mailboxManagement pricing get
+  $ cargo-ai mailboxManagement pricing get | jq .monthlyCredits`)
+        .action(async () => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.pricing.get());
+        outputJson(result);
+    });
+}

package/build/commands/mailboxManagement/suppression.d.ts

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

package/build/commands/mailboxManagement/suppression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppression.d.ts","sourceRoot":"","sources":["../../../src/commands/mailboxManagement/suppression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA2DN"}

package/build/commands/mailboxManagement/suppression.js

@@ -0,0 +1,38 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+import { csvList, optionalLimit, optionalOffset } from "./options.js";
+export function registerSuppressionCommands(parent, getApi) {
+    const suppression = parent
+        .command("suppression")
+        .description("Workspace-wide addresses that must not receive mail (unsubscribed, bounced, complained, manual)");
+    suppression
+        .command("list")
+        .description("List suppressions")
+        .option("--reasons <list>", "Filter by reason (comma-separated: unsubscribed,bounced,complained,manual)")
+        .option("--limit <n>", "Max results to return (integer)")
+        .option("--offset <n>", "Number of results to skip (integer)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai mailboxManagement suppression list
+  $ cargo-ai mailboxManagement suppression list --reasons unsubscribed,manual`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.suppression.list({
+            reasons: csvList(opts.reasons),
+            limit: optionalLimit(opts.limit),
+            offset: optionalOffset(opts.offset),
+        }));
+        outputJson(result);
+    });
+    suppression
+        .command("create")
+        .description("Manually suppress an address (workspace-wide)")
+        .requiredOption("--email <email>", "Address that should stop receiving mail")
+        .addHelpText("after", `
+Example:
+  $ cargo-ai mailboxManagement suppression create --email opted-out@acme.com`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.suppression.create({ email: opts.email }));
+        outputJson(result);
+    });
+}

package/build/commands/mailboxManagement/thread.d.ts

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

package/build/commands/mailboxManagement/thread.d.ts.map

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

package/build/commands/mailboxManagement/thread.js

@@ -0,0 +1,42 @@
+import { handleApiCall, outputJson } from "../runHandler.js";
+import { csvList, optionalLimit, optionalOffset } from "./options.js";
+export function registerThreadCommands(parent, getApi) {
+    const thread = parent
+        .command("thread")
+        .description("Conversations of outbound sends and their inbound replies");
+    thread
+        .command("list")
+        .description("List threads")
+        .option("--mailbox-uuid <uuid>", "Filter by mailbox")
+        .option("--statuses <list>", "Filter by latest list status (comma-separated: pending,error,sent,opened,clicked,replied,bounced,unsubscribed)")
+        .option("--created-after <date>", "Created after (ISO 8601)")
+        .option("--created-before <date>", "Created before (ISO 8601)")
+        .option("--search <text>", "Search subject or recipient")
+        .option("--limit <n>", "Max results to return (integer)")
+        .option("--offset <n>", "Number of results to skip (integer)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai mailboxManagement thread list --mailbox-uuid 550e8400-...
+  $ cargo-ai mailboxManagement thread list --search acme --limit 20`)
+        .action(async (opts) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.thread.list({
+            mailboxUuid: opts.mailboxUuid,
+            statuses: csvList(opts.statuses),
+            createdAfter: opts.createdAfter,
+            createdBefore: opts.createdBefore,
+            search: opts.search,
+            limit: optionalLimit(opts.limit),
+            offset: optionalOffset(opts.offset),
+        }));
+        outputJson(result);
+    });
+    thread
+        .command("get <uuid>")
+        .description("Get a thread by UUID")
+        .action(async (uuid) => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.mailboxManagement.thread.get(uuid));
+        outputJson(result);
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAsZN"}
+{"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,CA4ZN"}

package/build/commands/orchestration/record.js

@@ -20,6 +20,7 @@ export function registerRecordCommands(parent, getApi) {
         .option("--created-before <date>", "Created before date")
         .option("--updated-after <date>", "Updated after date")
         .option("--updated-before <date>", "Updated before date")
+        .option("--search <text>", "Case-insensitive partial match on record title or ID")
         .option("--limit <n>", "Limit", "20")
         .option("--offset <n>", "Offset", "0")
         .action(async (opts) => {
@@ -31,6 +32,7 @@ export function registerRecordCommands(parent, getApi) {
                 : undefined,
             title: opts.title,
             titleOrId: opts.titleOrId,
+            search: opts.search,
             releaseUuid: opts.releaseUuid,
             batchUuid: opts.batchUuid,
             statuses: opts.statuses !== undefined

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;AAexC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA+nB5E"}
+{"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;AAexC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAqoB5E"}

package/build/commands/orchestration/run.js

@@ -24,6 +24,7 @@ export function registerRunCommands(parent, getApi) {
         .option("--created-before <date>", "Filter runs created before this date (ISO 8601 string)")
         .option("--updated-after <date>", "Filter runs updated after this date (ISO 8601 string)")
         .option("--updated-before <date>", "Filter runs updated before this date (ISO 8601 string)")
+        .option("--search <text>", "Case-insensitive partial match on record title or ID")
         .option("--limit <n>", "Max results to return (integer, default: 20)", "20")
         .option("--offset <n>", "Number of results to skip (integer, default: 0)", "0")
         .addHelpText("after", `
@@ -47,6 +48,7 @@ Examples:
             recordId: opts.recordId,
             recordTitle: opts.recordTitle,
             recordTitleOrId: opts.recordTitleOrId,
+            search: opts.search,
             isFinished: opts.isFinished,
             executionsFilter: opts.executionsFilter !== undefined
                 ? parseJson(opts.executionsFilter, "--executions-filter")

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

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

package/build/commands/orchestration/span.js

@@ -26,6 +26,7 @@ export function registerSpanCommands(parent, getApi) {
         .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("--search <text>", "Case-insensitive partial match on record title, record ID, execution title, or error message")
         .option("--limit <n>", "Limit", "30")
         .option("--offset <n>", "Offset", "0")
         .action(async (opts) => {
@@ -39,6 +40,7 @@ export function registerSpanCommands(parent, getApi) {
             recordTitleOrId: opts.recordTitleOrId,
             executionTitle: opts.executionTitle,
             executionTitleOrErrorMessage: opts.executionTitleOrErrorMessage,
+            search: opts.search,
             nodeUuid: opts.nodeUuid,
             nodeKind: opts.nodeKind !== undefined
                 ? opts.nodeKind

package/build/index.js

@@ -14,6 +14,7 @@ import { registerDoctorCommand } from "./commands/doctor.js";
 import { registerExpressionCommands } from "./commands/expression/index.js";
 import { registerHostingCommands } from "./commands/hosting/index.js";
 import { registerInitCommand } from "./commands/init.js";
+import { registerMailboxManagementCommands } from "./commands/mailboxManagement/index.js";
 import { registerMcpCommand } from "./commands/mcp.js";
 import { registerObservabilityCommands } from "./commands/observability/index.js";
 import { registerOrchestrationCommands } from "./commands/orchestration/index.js";
@@ -91,6 +92,7 @@ registerSystemOfRecordIntegrationCommands(program, getApi);
 registerUserManagementCommands(program, getApi);
 registerAiCommands(program, getApi);
 registerHostingCommands(program, getApi);
+registerMailboxManagementCommands(program, getApi);
 registerMcpCommand(program, getApi);
 registerCdkCommands(program
     .command("cdk")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.59",
+  "version": "1.0.61",
   "private": false,
   "license": "UNLICENSED",
   "homepage": "https://getcargo.ai",
@@ -59,11 +59,11 @@
     "format:check": "prettier --check ."
   },
   "dependencies": {
-    "@cargo-ai/api": "^1.0.62",
-    "@cargo-ai/app-sdk": "^1.0.6",
-    "@cargo-ai/cdk": "^1.0.48",
-    "@cargo-ai/types": "^1.0.61",
-    "@cargo-ai/worker-sdk": "^1.0.12",
+    "@cargo-ai/api": "^1.0.64",
+    "@cargo-ai/app-sdk": "^1.0.8",
+    "@cargo-ai/cdk": "^1.0.51",
+    "@cargo-ai/types": "^1.0.63",
+    "@cargo-ai/worker-sdk": "^1.0.16",
     "@modelcontextprotocol/sdk": "1.29.0",
     "commander": "^12.1.0",
     "tsx": "^4.19.2",