@oxygen-agent/cli 1.1011.493 → 1.1011.607

package/dist/sender-limits-flags.js

@@ -3,12 +3,14 @@
 // MCP tool and the route use too. This overlay only keeps the flag names and
 // help text the command shipped with before the contract existed.
 import { OxygenError } from "@oxygen/shared/cli-result";
-import { LINKEDIN_SENDER_LIMIT_DEFAULTS, LINKEDIN_SENDER_LIMIT_MAXIMUMS, } from "@oxygen/shared/linkedin-sequences";
+import { LINKEDIN_SENDER_LIMIT_DEFAULTS, LINKEDIN_SENDER_LIMIT_MAXIMUMS, linkedInSenderLimitCautionLevel, } from "@oxygen/shared/linkedin-sequences";
 import { SENDER_LIMITS_PATCH_CONTRACT } from "@oxygen/shared/contracts/sender-limits";
 import { readContractFlags } from "./contract-flags.js";
 /** "<text> (default N, max M)." for a LinkedIn sender limit flag, from the enforced constants. */
 function linkedInLimitHelp(key, text) {
-    return `${text} (default ${LINKEDIN_SENDER_LIMIT_DEFAULTS[key]}, max ${LINKEDIN_SENDER_LIMIT_MAXIMUMS[key]}).`;
+    const caution = linkedInSenderLimitCautionLevel(key);
+    const risk = caution === undefined ? "" : ` Above ${caution} raises the risk of a LinkedIn restriction.`;
+    return `${text} (default ${LINKEDIN_SENDER_LIMIT_DEFAULTS[key]}, max ${LINKEDIN_SENDER_LIMIT_MAXIMUMS[key]}).${risk}`;
 }
 const LIMIT_FLAG_HELP = {
     invites_per_day: "Daily LinkedIn connection invites cap",
@@ -31,8 +33,8 @@ const LIMIT_FLAG_HELP = {
     sales_nav_search_results_per_day: "Daily cap on Sales Navigator search result rows fetched",
     api_reads_per_day: "Daily cap on all other LinkedIn API reads",
     total_reads_per_day: "Daily cap across all read units",
-    min_action_spacing_seconds: "Minimum seconds between actions",
-    action_spacing_jitter_seconds: "Random jitter seconds added to action spacing",
+    min_action_spacing_seconds: "Minimum seconds between automated actions. Campaigns also spread each day's limit across the working hours (20 invites in 07:00-22:00 go out 30-45 minutes apart), so this is a floor",
+    action_spacing_jitter_seconds: "Random jitter seconds added to action spacing; a spread campaign gap adds up to half of itself",
     interactive_min_spacing_seconds: "Minimum seconds between human-sent Unibox actions",
     interactive_spacing_jitter_seconds: "Random jitter seconds added to human-sent Unibox action spacing",
     interactive_sends_per_hour: "Hourly cap on human-sent Unibox actions",

package/dist/settings-commands.js

@@ -1,6 +1,6 @@
-// `oxygen settings`: workspace settings every member reads and admins change.
-// Its family today is `settings pages`, the web app's sidebar pages a workspace
-// hides for everyone (Settings → Customise). The set command's flags come from
+// `oxygen settings`: your own settings in a workspace. Its family today is
+// `settings pages`, the web app's sidebar pages you hide for yourself there
+// (Settings → Customise; per user since 2026-10-02). The set command's flags come from
 // the shared contract that also generates `oxygen_settings_pages_update` and
 // validates the route, so the CLI and MCP cannot disagree about what can be set.
 import { Command } from "commander";
@@ -12,7 +12,7 @@ const list = WORKSPACE_PAGES_GET_OPERATION;
 const update = WORKSPACE_PAGES_UPDATE_OPERATION;
 export const WORKSPACE_PAGES_FLAG_OVERLAY = {
     hide: {
-        help: "Pages to hide from the sidebar for everyone, comma-separated, each by its path (/unibox) or name (Unibox) from `settings pages list`. Hiding a section hides its sub-pages.",
+        help: "Pages to hide from your own sidebar, comma-separated, each by its path (/unibox) or name (Unibox) from `settings pages list`. Hiding a section hides its sub-pages.",
         valueName: "<pages>",
     },
     show: {
@@ -32,20 +32,20 @@ function names(value) {
 export function buildWorkspacePagesBody(options) {
     const body = readContractFlags(options, update.contract, WORKSPACE_PAGES_FLAG_OVERLAY);
     if (!names(body.hide) && !names(body.show) && body.show_all !== true) {
-        throw new OxygenError("invalid_request", "Nothing to change: pass --hide <pages> to hide pages for everyone, --show <pages> to show hidden ones again, or --show-all. `settings pages list` names every page.", { exitCode: 1 });
+        throw new OxygenError("invalid_request", "Nothing to change: pass --hide <pages> to hide pages from your sidebar, --show <pages> to show hidden ones again, or --show-all. `settings pages list` names every page.", { exitCode: 1 });
     }
     return body;
 }
 export function registerSettingsCommands(program, handle) {
     const settings = program
         .command("settings")
-        .description("Workspace settings: what every member of this workspace sees. "
-        + "`settings pages` is Settings → Customise in the web app: hide or show pages in the sidebar navigation (the left menu) for everyone. "
-        + "`settings pages list` shows each page and whether it is hidden; an admin or owner changes it with `settings pages set --hide <pages>`, `--show <pages>` or `--show-all`. "
-        + "Nothing is deleted: a hidden page stays reachable by URL. Free.");
+        .description("Settings in this workspace, each with its own scope. "
+        + "`settings pages` is Settings → Customise in the web app and yours alone: hide or show pages in your own sidebar navigation (the left menu); teammates keep theirs. "
+        + "`settings pages list` shows each page and whether you hid it; change it with `settings pages set --hide <pages>`, `--show <pages>` or `--show-all`. Nothing is deleted: a hidden page stays reachable by URL. "
+        + "`settings beta-features` is workspace-wide: early-access features for everyone, changed by admins and owners. Free.");
     const pages = new Command("pages")
-        .description("The web app's sidebar pages this workspace hides for every member (Settings → Customise): page visibility in the navigation menu. "
-        + "`list` shows every page with its section and whether it is hidden or visible; `set` hides or shows pages (admins and owners only). "
+        .description("The web app's sidebar pages you hide for yourself in this workspace (Settings → Customise): page visibility in your navigation menu; teammates keep their own. "
+        + "`list` shows every page with its section and whether it is hidden or visible; `set` hides or shows pages. "
         + "Hiding a section hides its sub-pages. Presentation only: nothing is deleted, and a hidden page stays reachable by URL and deep-link. Every response carries its `web_url`.");
     pages.addCommand(new Command(list.cli.path.at(-1) ?? "list")
         .description(list.cli.summary)

package/dist/whatsapp-account-flags.d.ts

@@ -0,0 +1,4 @@
+import { type ContractFlagOverlay } from "./contract-flags.js";
+/** Preserve the shipped status/tag coercion and --no-usage spelling. */
+export declare const WHATSAPP_ACCOUNT_FLAGS: ContractFlagOverlay;
+export declare function whatsappAccountQuery(options: Record<string, unknown>): URLSearchParams;

package/dist/whatsapp-account-flags.js

@@ -0,0 +1,18 @@
+import { WHATSAPP_ACCOUNTS_READ_CONTRACT, whatsappReadQueryParams } from "@oxygen/shared/contracts/whatsapp-reads";
+import { readContractFlags } from "./contract-flags.js";
+/** Preserve the shipped status/tag coercion and --no-usage spelling. */
+export const WHATSAPP_ACCOUNT_FLAGS = {
+    status: { valueName: "<status>", parse: raw => raw.trim() },
+    include_usage: { flag: "usage", negateHelp: "Skip today's per-account usage counts." },
+    tag: { valueName: "<tags>", parse: raw => raw.split(",").map(value => value.trim()).filter(Boolean).join(",") },
+    limit: { valueName: "<n>" }, offset: { valueName: "<n>" }, max_chars: { valueName: "<n>" },
+};
+export function whatsappAccountQuery(options) {
+    const input = readContractFlags(options, WHATSAPP_ACCOUNTS_READ_CONTRACT, WHATSAPP_ACCOUNT_FLAGS);
+    input.include_usage ??= true;
+    if (!input.status)
+        delete input.status;
+    if (!input.tag)
+        delete input.tag;
+    return whatsappReadQueryParams(input);
+}

package/node_modules/@oxygen/cli-ugc/dist/commands.js

@@ -512,7 +512,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "sponsor",
                     kind: "boolean",
-                    description: "Sponsor each creator's LinkedIn account when they accept: your workspace pays its monthly credit reservation (shown in the preview), from when they connect LinkedIn. With --link-only, preview first, then create the links with --approved --preview-token.",
+                    description: "Sponsor each creator's LinkedIn account when they accept: your workspace pays its monthly credit reservation (shown in the preview), from when they connect LinkedIn; nothing is charged if they never accept or connect. With --link-only, the first call previews; repeat it with --approved --preview-token <that preview's token> to create the links.",
                     required: false,
                 },
                 {
@@ -1005,7 +1005,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         {
             action: "sponsorship_preview",
             command: "sponsorship preview",
-            description: "Preview sponsoring creators as a signed-in master admin: funding is card (seat plus 10,000-credit grant) or credits (one LinkedIn reservation per creator). Org API keys cannot quote.",
+            description: "Preview sponsoring creators who already joined, as a signed-in master admin: funding is card (seat plus 10,000-credit grant) or credits (one LinkedIn reservation per creator). Org API keys cannot quote. To sponsor creators who have not joined yet, invite them with creators invite --sponsor.",
             fields: [
                 {
                     name: "program_id",

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

@@ -532,6 +532,47 @@ export declare const ANNUAL_BILLING_MONTHS_CHARGED = 10;
 export declare function annualPlanPriceCents(monthlyPriceCents: number): number;
 /** How often a plan Price bills. Credits are granted monthly on both. */
 export type PlanBillingInterval = "month" | "year";
+/** Commitment and payment frequency are separate: annual commitments bill monthly. */
+export type PlanCommitmentTerm = "month" | "year";
+export declare const ANNUAL_MONTHLY_TERMS_VERSION = "2026-10-02";
+export declare function annualMonthlyPriceCents(monthlyPriceCents: number): number;
+/** Read-only comparison; annual totals reflect twelve rounded monthly payments. */
+export declare function purchasablePlanComparison(annualMonthlyAvailable: boolean): {
+    plan_key: "oxygen_199" | "oxygen_1999" | "oxygen_49" | "oxygen_499" | "oxygen_99" | "oxygen_999";
+    currency: string;
+    monthly_credits: number;
+    volume_bonus_percent: number;
+    monthly: {
+        payment_cents: number;
+        billing_interval: string;
+        commitment_months: number;
+    };
+    yearly: {
+        payment_cents: number;
+        billing_interval: string;
+        commitment_months: number;
+        total_payment_cents: number;
+        saving_cents: number;
+        prices_before_tax: boolean;
+    } | null;
+}[];
+export declare const ANNUAL_MONTHLY_PLAN_TERMS: {
+    readonly terms_version: "2026-10-02";
+    readonly commitment_months: 12;
+    readonly billing_interval: "month";
+    readonly credits_granted: "monthly_after_payment";
+    readonly renewal: "automatically_for_another_12_months";
+    readonly cancellation: "Stops annual renewal; monthly payments continue through the current term.";
+    readonly upgrades: "Immediate with proration; the current annual term end stays the same.";
+    readonly switch_from_monthly: "Starts at the next monthly billing boundary. The first discounted monthly payment starts the 12-month commitment; the current plan and credits stay until then.";
+    readonly downgrades_or_switch_to_monthly: "Take effect at the annual term end.";
+};
+export declare function readPlanCommitmentTerm(value: unknown): PlanCommitmentTerm | null;
+/** Anchor arithmetic preserves Jan 31 and Feb 29 rather than drifting on clamps. */
+export declare function annualCommitmentWindow(anchorSeconds: number, nowSeconds: number): {
+    start: number;
+    end: number;
+};
 export declare const PLAN_BILLING_INTERVALS: readonly PlanBillingInterval[];
 /**
  * A billing interval as a customer or an agent types it. `month`/`monthly` and

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

@@ -1059,6 +1059,62 @@ export const ANNUAL_BILLING_MONTHS_CHARGED = 10;
 export function annualPlanPriceCents(monthlyPriceCents) {
     return monthlyPriceCents * ANNUAL_BILLING_MONTHS_CHARGED;
 }
+export const ANNUAL_MONTHLY_TERMS_VERSION = "2026-10-02";
+export function annualMonthlyPriceCents(monthlyPriceCents) {
+    return Math.round(annualPlanPriceCents(monthlyPriceCents) / 12);
+}
+/** Read-only comparison; annual totals reflect twelve rounded monthly payments. */
+export function purchasablePlanComparison(annualMonthlyAvailable) {
+    return PURCHASABLE_PLAN_KEYS.map((key) => {
+        const plan = resolveBasePricingPlan(key);
+        const monthly = plan.monthlyPriceCents;
+        const annualPayment = annualMonthlyPriceCents(monthly);
+        return {
+            plan_key: key,
+            currency: "usd",
+            monthly_credits: plan.monthlyCredits,
+            volume_bonus_percent: planVolumeBonusPercent(key),
+            monthly: { payment_cents: monthly, billing_interval: "month", commitment_months: 1 },
+            yearly: annualMonthlyAvailable ? {
+                payment_cents: annualPayment,
+                billing_interval: "month",
+                commitment_months: 12,
+                total_payment_cents: annualPayment * 12,
+                saving_cents: monthly * 12 - annualPayment * 12,
+                prices_before_tax: true,
+            } : null,
+        };
+    });
+}
+export const ANNUAL_MONTHLY_PLAN_TERMS = {
+    terms_version: ANNUAL_MONTHLY_TERMS_VERSION,
+    commitment_months: 12,
+    billing_interval: "month",
+    credits_granted: "monthly_after_payment",
+    renewal: "automatically_for_another_12_months",
+    cancellation: "Stops annual renewal; monthly payments continue through the current term.",
+    upgrades: "Immediate with proration; the current annual term end stays the same.",
+    switch_from_monthly: "Starts at the next monthly billing boundary. The first discounted monthly payment starts the 12-month commitment; the current plan and credits stay until then.",
+    downgrades_or_switch_to_monthly: "Take effect at the annual term end.",
+};
+export function readPlanCommitmentTerm(value) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    return parsePlanBillingInterval(value);
+}
+/** Anchor arithmetic preserves Jan 31 and Feb 29 rather than drifting on clamps. */
+export function annualCommitmentWindow(anchorSeconds, nowSeconds) {
+    const anchor = new Date(anchorSeconds * 1000);
+    const boundary = (years) => {
+        const year = anchor.getUTCFullYear() + years;
+        const day = Math.min(anchor.getUTCDate(), new Date(Date.UTC(year, anchor.getUTCMonth() + 1, 0)).getUTCDate());
+        return Date.UTC(year, anchor.getUTCMonth(), day, anchor.getUTCHours(), anchor.getUTCMinutes(), anchor.getUTCSeconds()) / 1000;
+    };
+    let years = Math.max(0, new Date(nowSeconds * 1000).getUTCFullYear() - anchor.getUTCFullYear());
+    if (boundary(years) > nowSeconds)
+        years = Math.max(0, years - 1);
+    return { start: boundary(years), end: boundary(years + 1) };
+}
 export const PLAN_BILLING_INTERVALS = ["month", "year"];
 /**
  * A billing interval as a customer or an agent types it. `month`/`monthly` and

package/node_modules/@oxygen/shared/dist/capability-discovery.d.ts

@@ -216,6 +216,26 @@ export declare const CAPABILITY_ROUTE_MCP_CALLS: {
             family: string;
         };
     };
+    rowFanOut: () => {
+        tool: string;
+        arguments: {
+            source: string;
+            target: string;
+            flatten: {
+                column: string;
+                path: string;
+            };
+            mapping: {
+                target: string;
+                source: {
+                    type: string;
+                    key: string;
+                };
+                path: string;
+            }[];
+            dry_run: boolean;
+        };
+    };
     linkedinKeywordPosts: () => {
         tool: string;
         arguments: {
@@ -245,3 +265,4 @@ export declare const LOCAL_BUSINESS_SCRAPE_COMMAND = "oxygen companies search pr
  * column through `columns add`, which the route recommends next.
  */
 export declare const ROW_CLASSIFICATION_COMMAND = "oxygen columns catalog --family classification";
+export declare const ROW_FAN_OUT_COMMAND = "oxygen tables send <source> <target> --flatten <column> --flatten-path <path> --mapping '[{\"target\":\"<column>\",\"source\":{\"type\":\"column\",\"key\":\"$element\"},\"path\":\"<field>\"}]' --dry-run";