@oxygen-agent/cli 1.272.83 → 1.274.15

package/README.md

@@ -34,4 +34,4 @@ oxygen update
 
 For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
 
-Version: 1.272.83
+Version: 1.274.15

package/dist/index.js

@@ -4643,6 +4643,52 @@ export function createProgram() {
                 ...(options.approve ? { approve: true } : {}),
             },
         }));
+    }))
+        .addCommand(new Command("register")
+        .description("STAFF: register a manually-purchased egress IP (e.g. IPRoyal ISP-dedicated) into this environment's inventory. Secrets never pass here — --credential-ref names the Doppler family EGRESS_CRED_<REF>_USERNAME/_PASSWORD, set separately in Doppler. Register, then `egress assign`, then enable EGRESS_POOL_ENABLED (pool mode fails closed for unassigned mailboxes).")
+        .requiredOption("--host <host>", "Proxy hostname or IP — bare, no scheme/port/credentials.")
+        .requiredOption("--port <port>", "Proxy port (1-65535).")
+        .requiredOption("--credential-ref <ref>", "Doppler credential-family name (A-Z, 0-9, _), e.g. IPROYAL.")
+        .option("--vendor <vendor>", "Vendor slug for inventory provenance.", "iproyal")
+        .option("--protocol <protocol>", "Proxy protocol: http (default), https, or socks5.")
+        .option("--tier <tier>", "shared (default) or dedicated (requires --dedicated-org).")
+        .option("--dedicated-org <orgId>", "Organization id a dedicated-tier IP is reserved for.")
+        .option("--session-label <label>", "Optional vendor session/order label for provenance.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("egress register", options, () => requestOxygen("/api/cli/egress/register", {
+            method: "POST",
+            body: {
+                host: readOption(options.host),
+                port: Number(readOption(options.port)),
+                credential_ref: readOption(options.credentialRef),
+                vendor: readOption(options.vendor),
+                ...(readOption(options.protocol) ? { protocol: readOption(options.protocol) } : {}),
+                ...(readOption(options.tier) ? { tier: readOption(options.tier) } : {}),
+                ...(readOption(options.dedicatedOrg) ? { dedicated_organization_id: readOption(options.dedicatedOrg) } : {}),
+                ...(readOption(options.sessionLabel) ? { session_label: readOption(options.sessionLabel) } : {}),
+            },
+        }));
+    }))
+        .addCommand(new Command("assign")
+        .description("Assign sending mailboxes to inventoried egress IPs — least-loaded across the active pool, or pinned with --ip. Existing open assignments are kept (stable for life; use rotate to re-home a burned IP). Admin/owner role; no spend, 0 credits.")
+        .option("--mailboxes <list>", "Comma-separated mailbox ids or addresses to assign.")
+        .option("--all", "Assign every sending mailbox in the pool that lacks an open assignment.")
+        .option("--ip <egressIpId>", "Pin the targeted mailboxes to this egress IP id (must be active and org-visible).")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("egress assign", options, () => {
+            const list = readOption(options.mailboxes);
+            const mailboxes = list ? list.split(",").map((entry) => entry.trim()).filter(Boolean) : [];
+            return requestOxygen("/api/cli/egress/assign", {
+                method: "POST",
+                body: {
+                    ...(mailboxes.length > 0 ? { mailboxes } : {}),
+                    ...(options.all ? { all: true } : {}),
+                    ...(readOption(options.ip) ? { egress_ip_id: readOption(options.ip) } : {}),
+                },
+            });
+        });
     })));
     program
         .command("directory")
@@ -7405,31 +7451,35 @@ export function createProgram() {
         await handleAsyncAction("mailboxes oauth-health", options, () => requestOxygen("/api/cli/mailboxes/oauth-health"));
     }))
         .addCommand(new Command("warmup")
-        .description("Mailbox warmup via Instantly (BYOK — Instantly bills your account, 0 Oxygen credits).")
+        .description("Mailbox warmup via Instantly — BYOK over your connected Instantly account, or --billing-mode managed via the OXYGEN-managed Instantly workspace (both 0 Oxygen credits).")
         .addCommand(new Command("enable")
-        .description("Enable Instantly warmup for sending mailboxes and stamp each mailbox's warmup state. Targets the whole pool unless --mailboxes is given.")
+        .description("Enable Instantly warmup for sending mailboxes and stamp each mailbox's warmup state. Targets the whole pool unless --mailboxes is given. Omit --billing-mode for automatic: BYOK when your Instantly is connected, else managed when enabled on the deployment.")
         .option("--mailboxes <list>", "Comma-separated mailbox ids or addresses to warm. Omit to warm the whole pool.")
-        .option("--connection <id>", "Instantly connection id. Defaults to the org's active Instantly connection.")
+        .option("--connection <id>", "Instantly connection id (forces BYOK). Defaults to the org's active Instantly connection.")
+        .option("--billing-mode <mode>", "byok = your Instantly connection; managed = the OXYGEN-managed Instantly workspace.")
         .option("--dry-run", "Simulate without calling Instantly (mailboxes marked pending).")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("mailboxes warmup enable", options, () => {
             const mailboxes = readCsvOption(options.mailboxes);
             const connection = readOption(options.connection);
+            const billingMode = readOption(options.billingMode);
             return requestOxygen("/api/cli/mailboxes/warmup", {
                 method: "POST",
                 body: {
                     ...(mailboxes.length > 0 ? { mailboxes } : {}),
                     ...(connection ? { connection_id: connection } : {}),
+                    ...(billingMode ? { billing_mode: billingMode } : {}),
                     ...(options.dryRun ? { dry_run: true } : {}),
                 },
             });
         });
     }))
         .addCommand(new Command("status")
-        .description("Sync Instantly's warmup analytics into the pool, updating each mailbox's warmup state. Targets the whole pool unless --mailboxes is given.")
+        .description("Sync Instantly's warmup analytics into the pool, updating each mailbox's warmup state. Targets the whole pool unless --mailboxes is given. Omit --billing-mode for automatic: BYOK when connected, else managed when enabled.")
         .option("--mailboxes <list>", "Comma-separated mailbox ids or addresses to sync. Omit to sync the whole pool.")
-        .option("--connection <id>", "Instantly connection id. Defaults to the org's active Instantly connection.")
+        .option("--connection <id>", "Instantly connection id (forces BYOK). Defaults to the org's active Instantly connection.")
+        .option("--billing-mode <mode>", "byok = your Instantly connection; managed = the OXYGEN-managed Instantly workspace.")
         .option("--dry-run", "Skip the Instantly call (mailboxes marked pending).")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
@@ -7441,6 +7491,9 @@ export function createProgram() {
             const connection = readOption(options.connection);
             if (connection)
                 params.set("connection_id", connection);
+            const billingMode = readOption(options.billingMode);
+            if (billingMode)
+                params.set("billing_mode", billingMode);
             if (options.dryRun)
                 params.set("dry_run", "true");
             const suffix = params.toString();
@@ -7497,14 +7550,15 @@ export function createProgram() {
         await handleAsyncAction("mailboxes order-status", options, () => requestOxygen(`/api/cli/mailboxes/orders/${encodeURIComponent(order)}`));
     })));
     program.addCommand(new Command("deliverability")
-        .description("External email deliverability: fleet reputation health and DIRECTIONAL inbox-placement (spam) tests. Placement tests are approval-gated paid runs (managed = 2 credits, BYOK = 0); fail closed with 409 when no health provider is connected.")
+        .description("External email deliverability: fleet reputation health and DIRECTIONAL inbox-placement (spam) tests via EmailGuard or Zapmail. Placement tests are approval-gated paid runs (managed bills Oxygen credits; BYOK = 0 Oxygen credits — Zapmail BYOK bills your Zapmail wallet ~$2/test); fail closed with 409 when no health provider is connected.")
         .addCommand(new Command("placement-test")
         .description("Directional inbox-placement (spam) tests: run, list, and get. Results estimate inbox-vs-spam landing from seed inboxes.")
         .addCommand(new Command("run")
-        .description("Start a placement test for one sending mailbox. Without --approved this returns a PREVIEW (billing mode + credits_required). Re-run with --approved and --max-credits >= credits_required to send.")
+        .description("Start a placement test for one sending mailbox. Without --approved this returns a PREVIEW (billing mode + credits_required). Re-run with --approved and --max-credits >= credits_required to send. Zapmail runs test Zapmail-hosted mailboxes ONLY, compose their own probe (subject/body ignored), and complete async (2-24h).")
         .argument("<mailbox>", "Sending mailbox address to test (e.g. ada@send.acme.com).")
-        .option("--subject <subject>", "Optional subject for the seed message.")
-        .option("--body <text>", "Optional plain-text body for the seed message.")
+        .option("--provider <provider>", "Health provider: emailguard or zapmail. Omit to auto-resolve (Zapmail-hosted mailboxes route to zapmail, else emailguard).")
+        .option("--subject <subject>", "Optional subject for the seed message (zapmail ignores it beyond labeling the test).")
+        .option("--body <text>", "Optional plain-text body for the seed message (ignored by zapmail).")
         .option("--approved", "Actually run the test (otherwise a preview is returned).")
         .option("--max-credits <n>", "Credit cap the caller accepts (must be >= credits_required for managed runs).")
         .option("--json", "Print a JSON envelope.")
@@ -7513,6 +7567,7 @@ export function createProgram() {
             method: "POST",
             body: {
                 mailbox,
+                ...(readOption(options.provider) ? { provider: readOption(options.provider) } : {}),
                 ...(readOption(options.subject) ? { subject: readOption(options.subject) } : {}),
                 ...(readOption(options.body) ? { body_text: readOption(options.body) } : {}),
                 ...(options.approved ? { approved: true } : {}),
@@ -7521,7 +7576,7 @@ export function createProgram() {
         }));
     }))
         .addCommand(new Command("list")
-        .description("List recent directional inbox-placement tests with status, billing mode, seed set, score, and credits used.")
+        .description("List recent directional inbox-placement tests with status, health provider, billing mode, seed set, score, and credits used.")
         .option("--limit <n>", "Max rows (default 50, cap 200).")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
@@ -7531,7 +7586,7 @@ export function createProgram() {
         });
     }))
         .addCommand(new Command("get")
-        .description("Get one directional inbox-placement test by id — status, seed inboxes, per-provider results, and score.")
+        .description("Get one directional inbox-placement test by id — status, health provider, seed inboxes, per-provider results, and score. Zapmail results land async (2-24h); keep polling while status is awaiting_results.")
         .argument("<id>", "Placement test id.")
         .option("--json", "Print a JSON envelope.")
         .action(async (id, options) => {

package/node_modules/@oxygen/shared/dist/billing.d.ts

@@ -119,7 +119,7 @@ export declare const BASE_PRICING_PLANS: {
         readonly description: "Custom procurement, invoicing, limits, and rollout support.";
         readonly ctaLabel: "Talk to us";
         readonly contactHref: "https://cal.com/tim-scheuer-mxbib9/45";
-        readonly features: readonly ["Custom monthly usage pool", "Custom automation action allowance", "Phone number enrichment", "Custom AI-key and provider routing policies", "SSO, invoicing, and procurement support"];
+        readonly features: readonly ["Everything in Team", "Custom usage limits", "Volume pricing", "Custom invoicing and billing", "Dedicated support"];
     };
 };
 export declare const PUBLIC_PLAN_ORDER: readonly PlanTier[];

package/node_modules/@oxygen/shared/dist/billing.js

@@ -126,11 +126,11 @@ export const BASE_PRICING_PLANS = {
         ctaLabel: "Talk to us",
         contactHref: CONTACT_SALES_URL,
         features: [
-            "Custom monthly usage pool",
-            "Custom automation action allowance",
-            "Phone number enrichment",
-            "Custom AI-key and provider routing policies",
-            "SSO, invoicing, and procurement support",
+            "Everything in Team",
+            "Custom usage limits",
+            "Volume pricing",
+            "Custom invoicing and billing",
+            "Dedicated support",
         ],
     },
 };

package/node_modules/@oxygen/shared/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const OXYGEN_VERSION = "1.272.83";
+export declare const OXYGEN_VERSION = "1.274.15";
 export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.181.0";

package/node_modules/@oxygen/shared/dist/version.js

@@ -1,4 +1,4 @@
-export const OXYGEN_VERSION = "1.272.83";
+export const OXYGEN_VERSION = "1.274.15";
 // Bump this only when deployed CLI/API contracts require a newer CLI.
 // 1.181.0: paid table action runs and background columns run require
 // approved=true in addition to max_credits; older CLIs cannot send the flag.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.272.83",
+  "version": "1.274.15",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",