@oxygen-agent/cli 1.1014.951 → 1.1014.985

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.1014.951
+Version: 1.1014.985

package/dist/commands/managed-inboxes.js

@@ -68,34 +68,10 @@ function buildManagedInboxMailboxes(options, forms) {
         mailboxes = locals.map((username) => ({ username }));
     }
     else if (forms.countPrefix && (count !== undefined || prefix)) {
-        if (count === undefined || !prefix) {
-            throw new Error("--count and --prefix must be passed together (e.g. --count 3 --prefix ada).");
-        }
-        const base = prefix.toLowerCase();
-        if (senderProfileId) {
-            // With a sender the shorthand finally has a real identity behind it, so it
-            // generates usernames only — the placeholder names below are exactly what
-            // this flag exists to stop shipping.
-            mailboxes = Array.from({ length: count }, (_entry, index) => ({ username: `${base}${index + 1}` }));
-        }
-        else {
-            // The vendor stamps a first/last name on every mailbox, so there is no
-            // name-less order shape to fall back on — the shorthand invents
-            // placeholders rather than pretending names are optional. Anyone who
-            // wants real human identities on the inboxes passes --sender (best),
-            // or --mailboxes/--file.
-            const label = `${base.charAt(0).toUpperCase()}${base.slice(1)}`;
-            mailboxes = Array.from({ length: count }, (_entry, index) => ({
-                username: `${base}${index + 1}`,
-                first_name: label,
-                last_name: String(index + 1),
-            }));
-        }
+        throw new OxygenError("natural_mailbox_names_required", "Choose natural addresses for the real sender, such as phil, philipp, philipph, philipp.hirte or p.hirte. --count/--prefix no longer generates numbered usernames or placeholder people. Use --locals <names> --sender <id>, or --mailboxes/--file with reviewed names; explicitly requested numeric addresses remain supported there.", { exitCode: 2, details: { next_step: "oxygen senders profiles list --json" } });
     }
     else {
         const spellings = ["--mailboxes <json>", "--file <path>", "--locals <list> --sender <id>"];
-        if (forms.countPrefix)
-            spellings.push("--count <n> --prefix <base>");
         throw new Error(`Provide ${spellings.join(", ")}.`);
     }
     if (!senderProfileId || !Array.isArray(mailboxes))
@@ -143,8 +119,8 @@ export function registerManagedInboxesFamily(program, handleAsyncAction) {
         .option("--domain <domain>", "Sending domain (alternative to the positional argument).")
         .requiredOption("--provider <provider>", "Mailbox PLATFORM: google, microsoft, or azure. (google/microsoft cap at 5 mailboxes per domain; azure allows 100.)")
         .option("--vendor <vendor>", "Pin the vendor: inboxkit. Omit to let OXYGEN choose. A named vendor with no credential FAILS rather than falling back to another.")
-        .option("--sender <id>", "Sender profile id (from `oxygen senders profiles list`) that OWNS every mailbox in this order: its first name, last name, and profile picture are stamped on each one, so you never retype them. A sender profile is one person's sending identity — their LinkedIn/WhatsApp accounts and email inboxes under one name and photo. One sender can own several addresses on the same domain (see --locals). Any first_name/last_name/profile_picture_url in --mailboxes/--file is dropped for the sender's own values.")
-        .option("--locals <list>", "Comma-separated local parts to create for --sender, e.g. `--locals talia,talia.rosen,t.rosen` on send.acme.com orders talia@, talia.rosen@, and t.rosen@ — all owned by that one person. Requires --sender, because a bare local part carries no name and the vendor's stamp is permanent.")
+        .option("--sender <id>", "Sender profile id (from `oxygen senders profiles list`) that OWNS every mailbox in this order: its first name, last name, and profile picture are stamped on each one, so you never retype them. A sender profile is one person's sending identity — their LinkedIn/WhatsApp accounts and email inboxes under one name and photo. One sender can own several natural addresses on the same domain (see --locals); do not invent people or pad a requested count with numbered aliases. Any first_name/last_name/profile_picture_url in --mailboxes/--file is dropped for the sender's own values.")
+        .option("--locals <list>", "Natural local parts for the real sender; avoid numbered suffixes unless explicitly requested, e.g. `--locals talia,talia.rosen,t.rosen` on send.acme.com orders talia@, talia.rosen@, and t.rosen@ — all owned by that one person. Requires --sender, because a bare local part carries no name and the vendor's stamp is permanent.")
         .option("--mailboxes <json>", "JSON array of mailboxes: [{\"username\",\"first_name\",\"last_name\",\"profile_picture_url\"}], or [{\"username\",\"sender_profile_id\"}] to take the identity from a sender profile per item (mix freely). profile_picture_url is optional and must be a PUBLIC, PERMANENT https URL — the vendor fetches it server-side at provisioning, so an expiring CDN link (e.g. a media.licdn.com URL with e=<epoch>) ships the mailbox faceless. Use `oxygen managed-inboxes upload-avatar <path>` to host one, or --sender / sender_profile_id, whose photo Oxygen already mirrors.")
         .option("--file <path>", "Path to a JSON file { \"mailboxes\": [...] } (alternative to --mailboxes).")
         .addOption(new Option("--preview", "Explicit read-only quote: connects nothing, buys nothing and charges nothing. Cannot be combined with purchase or DNS cleanup approval.").conflicts(["approved", "dnsCleanupApproved"]))
@@ -225,12 +201,12 @@ export function registerManagedInboxesFamily(program, handleAsyncAction) {
         .description("Add mailboxes to a managed domain you ALREADY own — no new domain is registered and there is NO domain registration charge, only the extra inboxes' monthly rate (plus their add-ons). WITHOUT --approved this prints a priced PREVIEW with a quote_id and orders nothing; re-run with --approved --quote <id> to place the order. When the standing OXYGEN Warm-up add-on is enabled and available, preview and approved responses carry `warmup_activation` for only the exact newly added `mailboxes`, with `scope=warmup_only`; it is null when warmup is disabled or unavailable. For InboxKit, Google carries `transport=inboxkit_managed_google_handoff`; Microsoft/Azure carries `transport=inboxkit_sequencer_export`. Both carry `mailbox_credentials_required=false` and `native_send_oauth_separate=true`, so managed warm-up needs no customer-supplied OAuth or mailbox password. Google retrieves the existing managed credential only during activation and never persists or returns it; Microsoft/Azure uses native export. Native sending authorization is separate and may still be required before OXYGEN can send. Verify each exact address with `mailboxes oauth-health --json`; InboxKit's unattended Google domain approval usually lands within minutes and the worker keeps retrying, so a waiting row is not a reason to ask the customer to sign in. The quote authorizes automatic OXYGEN Warm-up activation after provisioning, so do not run a second warmup approval. Capped per domain by the platform the domain was bought on (5 google/microsoft, 100 azure) COUNTING the inboxes already on it. To register a NEW domain use `managed-inboxes subscribe` instead.")
         .argument("[domain]", "A managed domain this workspace already owns (e.g. send.acme.com). May also be passed as --domain.")
         .option("--domain <domain>", "The managed inbox domain (alternative to the positional argument).")
-        .option("--sender <id>", "Sender profile id (from `oxygen senders profiles list`) that OWNS every mailbox in this order: its first name, last name, and profile picture are stamped on each one, so you never retype them. A sender profile is one person's sending identity — their LinkedIn/WhatsApp accounts and email inboxes under one name and photo. One sender can own several addresses on the same domain (see --locals). Any first_name/last_name/profile_picture_url in --mailboxes/--file is dropped for the sender's own values.")
-        .option("--locals <list>", "Comma-separated local parts to add for --sender, e.g. `--locals talia,talia.rosen,t.rosen` adds talia@, talia.rosen@, and t.rosen@ on this domain — all owned by that one person. Requires --sender, because a bare local part carries no name and the vendor's stamp is permanent.")
+        .option("--sender <id>", "Sender profile id (from `oxygen senders profiles list`) that OWNS every mailbox in this order: its first name, last name, and profile picture are stamped on each one, so you never retype them. A sender profile is one person's sending identity — their LinkedIn/WhatsApp accounts and email inboxes under one name and photo. One sender can own several natural addresses on the same domain (see --locals); do not invent people or pad a requested count with numbered aliases. Any first_name/last_name/profile_picture_url in --mailboxes/--file is dropped for the sender's own values.")
+        .option("--locals <list>", "Natural local parts for the real sender; avoid numbered suffixes unless explicitly requested, e.g. `--locals talia,talia.rosen,t.rosen` adds talia@, talia.rosen@, and t.rosen@ on this domain — all owned by that one person. Requires --sender, because a bare local part carries no name and the vendor's stamp is permanent.")
         .option("--mailboxes <json>", "JSON array of mailboxes: [{\"username\",\"first_name\",\"last_name\",\"profile_picture_url\"}], or [{\"username\",\"sender_profile_id\"}] to take the identity from a sender profile per item (mix freely). The vendor stamps the names on each mailbox permanently, so real names belong here. profile_picture_url is optional and must be a PUBLIC, PERMANENT https URL the vendor can fetch at provisioning; `oxygen managed-inboxes upload-avatar <path>` returns one, and a sender profile's mirrored photo already is one.")
         .option("--file <path>", "Path to a JSON file { \"mailboxes\": [...] } (alternative to --mailboxes).")
-        .option("--count <n>", "Shorthand for --mailboxes: how many inboxes to add. Requires --prefix.")
-        .option("--prefix <base>", "Shorthand username base for --count: `--count 3 --prefix ada` adds ada1, ada2, ada3. WITH --sender all three belong to that person, named and pictured as them; WITHOUT --sender they get placeholder names (Ada 1, Ada 2, Ada 3) the vendor can never change. Pass --sender, or --mailboxes/--file with real names.")
+        .addOption(new Option("--count <n>", "Retired: choose natural addresses with --locals and --sender.").hideHelp())
+        .addOption(new Option("--prefix <base>", "Retired: provide reviewed natural local parts through --locals or --mailboxes.").hideHelp())
         .option("--approved", "Place the order (requires --quote). Without it, a priced preview is returned.")
         .option("--quote <id>", "The quote_id from a fresh preview. Required with --approved.")
         .option("--json", "Print a JSON envelope.")

package/dist/commands/people.js

@@ -98,6 +98,7 @@ function readPeopleSearchRunBody(options) {
             ...(options.mode ? { mode: options.mode } : {}),
             ...(maxCreditsNative !== undefined ? { max_credits: maxCreditsNative } : {}),
             ...(nativeTarget !== undefined ? { target_count: nativeTarget } : {}),
+            ...(options.continue ? { continue: true } : {}),
             ...(options.approved ? { approved: true } : {}),
         };
     }
@@ -132,6 +133,7 @@ function readPeopleSearchRunBody(options) {
         ...(filters ? { filters } : {}),
         // Free sizing is on by default when planning from a prompt; --no-estimate opts out.
         ...(prompt ? { estimate: options.estimate !== false } : {}),
+        ...(options.continue ? { continue: true } : {}),
         ...(options.approved ? { approved: true } : {}),
     };
 }
@@ -312,6 +314,7 @@ export function registerPeopleFamily(program, handleAsyncAction) {
         .option("--project <project>", "Folder (project) id or slug the created table lands in. Ignored with --table. Defaults to the workspace default folder.")
         .option("--upsert-key <column>", "Column key used for live upsert. Must match the plan upsert key (linkedin_url).")
         .option("--mode <mode>", "dry_run or live. Defaults to dry_run.")
+        .option("--continue", "With --table: start each search where the last run of the same search into that table stopped, instead of page one, so a repeated run finds new people. Refuses without spending once nothing is left.")
         .option("--max-pages <n>", "Maximum provider pages to ingest. Defaults to the route estimate. With --from-table it means pages per company.")
         .option("--max-credits <n>", "Required credit ceiling for live runs.")
         .option("--target-count <n>", "How many people to source. Omit it to take every match, up to what one query reaches and a tenth of the spendable credits. Single-plan ceiling 50,000.")

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

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1014.951";
+export declare const OXYGEN_BUILD_VERSION = "1.1014.985";

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

@@ -1,2 +1,2 @@
 // GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
-export const OXYGEN_BUILD_VERSION = "1.1014.951";
+export const OXYGEN_BUILD_VERSION = "1.1014.985";

package/package.json

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