@oxygen-agent/cli 1.987.20 → 1.1010.1

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

@@ -1,34 +1,62 @@
-import { AUTOMATION_ACTION_CREDITS as SNAPSHOT_AUTOMATION_ACTION_CREDITS, CREDITS_PER_USD as SNAPSHOT_CREDITS_PER_USD, PRICING_PLAN_SNAPSHOT, TOPUP_USD_CENTS_PER_1K_CREDITS as SNAPSHOT_TOPUP_USD_CENTS_PER_1K_CREDITS, } from "./pricing-snapshot.generated.js";
+import { AUTOMATION_ACTION_CREDITS as SNAPSHOT_AUTOMATION_ACTION_CREDITS, CREDITS_PER_USD as SNAPSHOT_CREDITS_PER_USD, PRICING_PLAN_SNAPSHOT, TOPUP_USD_CENTS_PER_100_CREDITS as SNAPSHOT_TOPUP_USD_CENTS_PER_100_CREDITS, } from "./pricing-snapshot.generated.js";
 import { freeTierEntitlementEnabled } from "./plan-capabilities.js";
+import { asRecordOrNull } from "./type-guards.js";
 export const WEEKLY_USAGE_WINDOW_DAYS = 7;
 export const BILLING_CURRENCIES = ["usd"];
 export const DEFAULT_BILLING_CURRENCY = "usd";
+/**
+ * The SIX purchasable rungs of the one "Oxygen" product (founder 2026-09-19).
+ *
+ * These are plan KEYS — what Stripe sells and what `subscriptions.tier` stores —
+ * not tiers. They all share the single `oxygen` entitlement tier, which is the
+ * coarse rung plan-limits.ts and spend-safety.ts enforce against.
+ *
+ * Why keys and not six tiers: six tiers would force six new columns into every
+ * `Record<PlanTier, …>` ladder (plan limits, trigger ceilings, BYOK caps), i.e.
+ * ~40 invented numbers on an axis nobody ratified. Why not reuse starter/pro/team
+ * instead: then `plan.tier` would be ambiguous between a grandfathered $99
+ * Starter and a $49 Oxygen, and plan-change.ts — which refuses when
+ * `currentTier === targetTier` — would call a real $49 -> $99 upgrade
+ * `plan_unchanged`.
+ */
+export const OXYGEN_PLAN_KEYS = [
+    "oxygen_49",
+    "oxygen_99",
+    "oxygen_199",
+    "oxygen_499",
+    "oxygen_999",
+    "oxygen_1999",
+];
 // Scale/Enterprise contact routes to the shared support inbox, not to a
 // founder's calendar. priority@oxygen-agent.com is the Plain Email channel
 // (PLAIN_SUPPORT_EMAIL_ADDRESS), so an enterprise enquiry lands in the support
 // queue as a Thread that either founder can pick up, instead of hard-coding one
 // person's booking page into every public pricing card.
 export const CONTACT_SALES_URL = "mailto:priority@oxygen-agent.com";
-// One Oxygen credit is worth $0.001 of managed work: $1 = 1,000 credits.
+// One Oxygen credit is worth $0.01 of managed work: $1 = 100 credits.
 // Subscription plans convert at face value — every subscription dollar grants
-// exactly 1,000 credits — while on-demand top-up packs price the same credit
-// at $1.25 per 1,000, making subscription credits exactly 20% cheaper than
+// exactly 100 credits — while on-demand top-up packs price the same credit
+// at $1.25 per 100, making subscription credits exactly 20% cheaper than
 // credits bought on demand.
 //
+// Re-denominated from $1 = 1,000 credits on 2026-09-19. That was a PURE unit
+// change: every credit-denominated price divided by 10 in the same release, so
+// the USD cost of every action is unchanged.
+//
 // Sourced from the generated snapshot rather than declared here: this pair was
 // previously written down in seven production modules, and if any two ever
 // disagreed every markup-derived price would be silently wrong by the ratio.
 // Change them in packages/control-db/src/pricing/seed.ts.
 export const CREDITS_PER_USD = SNAPSHOT_CREDITS_PER_USD;
-export const TOPUP_USD_CENTS_PER_1K_CREDITS = SNAPSHOT_TOPUP_USD_CENTS_PER_1K_CREDITS;
+export const TOPUP_USD_CENTS_PER_100_CREDITS = SNAPSHOT_TOPUP_USD_CENTS_PER_100_CREDITS;
 // On-demand purchases start at the original fixed packs' $10 floor and run up
-// to a $1,250 ceiling, in any 1,000-credit increment. The ceiling is a
+// to a $1,250 ceiling, in any 100-credit increment. The ceiling is a
 // single-checkout guard rail, not a spend cap: a workspace that needs more
 // tops up again (purchased credits never expire).
-export const CREDIT_TOPUP_MIN_CREDITS = 8_000;
-export const CREDIT_TOPUP_MAX_CREDITS = 1_000_000;
-export const CREDIT_TOPUP_STEP_CREDITS = 1_000;
-export const CREDIT_TOPUP_DEFAULT_CREDITS = 20_000;
+export const CREDIT_TOPUP_MIN_CREDITS = 800;
+export const CREDIT_TOPUP_MAX_CREDITS = 100_000;
+export const CREDIT_TOPUP_STEP_CREDITS = 100;
+export const CREDIT_TOPUP_DEFAULT_CREDITS = 2_000;
 export function isValidCreditTopupCredits(credits) {
     return Number.isInteger(credits)
         && credits >= CREDIT_TOPUP_MIN_CREDITS
@@ -58,7 +86,7 @@ export function creditTopupAmountForShortfall(credits) {
 export function creditTopupUsdCents(credits) {
     if (!isValidCreditTopupCredits(credits))
         return null;
-    return (credits / 1_000) * TOPUP_USD_CENTS_PER_1K_CREDITS;
+    return (credits / 100) * TOPUP_USD_CENTS_PER_100_CREDITS;
 }
 // Workflow/automation actions (steps, tool calls, row writes, retries) draw
 // from the same credit pool at a flat capacity-guard rate — the old separate
@@ -101,12 +129,12 @@ export const CREDIT_COMMITMENT_KINDS = [
  * Gmail and Microsoft inboxes included — and it STACKS on Oxygen-sold mailboxes,
  * which additionally pay their own mailbox/warmup/placement lines.
  */
-export const SENDING_MAILBOX_MONTHLY_CREDITS = 1_000;
+export const SENDING_MAILBOX_MONTHLY_CREDITS = 100;
 /**
  * Oxygen-sold managed mailbox per month, in credits ($3.00). Flat, superseding
  * the dynamic vendor-COGS x 1.25 quote for the recurring mailbox line.
  */
-export const MANAGED_MAILBOX_MONTHLY_CREDITS = 3_000;
+export const MANAGED_MAILBOX_MONTHLY_CREDITS = 300;
 /**
  * Grace window after a commitment goes past_due before the owning subsystem may
  * suspend the resource. Notify -> pause -> lapse; never auto-cancel. Aligned with
@@ -168,10 +196,10 @@ export function ratifiedCommitmentCredits(kind) {
     }
 }
 export const CREDIT_TOPUP_PACKS = [
-    { id: "10", usdCents: 1_000, credits: 8_000 },
-    { id: "25", usdCents: 2_500, credits: 20_000 },
-    { id: "100", usdCents: 10_000, credits: 80_000 },
-    { id: "250", usdCents: 25_000, credits: 200_000 },
+    { id: "10", usdCents: 1_000, credits: 800 },
+    { id: "25", usdCents: 2_500, credits: 2_000 },
+    { id: "100", usdCents: 10_000, credits: 8_000 },
+    { id: "250", usdCents: 25_000, credits: 20_000 },
 ];
 export function resolveCreditTopupPack(id) {
     if (!id)
@@ -184,7 +212,7 @@ export function resolveCreditTopupPack(id) {
 // to that paid plan on credit exhaustion or when the trial clock elapses,
 // whichever comes first. Starter remains the signup default.
 export const TRIAL_PERIOD_DAYS = 7;
-export const TRIAL_CREDIT_GRANT = 20_000;
+export const TRIAL_CREDIT_GRANT = 2_000;
 /**
  * Free-tier entry (founder-ratified 2026-08-16; grant collapsed to a single
  * 10,000-credit signup grant 2026-08-26).
@@ -210,7 +238,7 @@ export const TRIAL_CREDIT_GRANT = 20_000;
  * mints it a second time. Top-ups stay purchasable on free, which is what keeps
  * the metered surface open-ended rather than capped at the grant.
  */
-export const FREE_SIGNUP_GRANT_CREDITS = 10_000;
+export const FREE_SIGNUP_GRANT_CREDITS = 1_000;
 export const FREE_TIER_GRANTS_ENABLED_ENV_VAR = "OXYGEN_FREE_TIER_GRANTS_ENABLED";
 /**
  * Fail-closed rollout switch for the free-tier grants, matching the staged
@@ -236,8 +264,8 @@ export function freeTierGrantsEnabled(env = process.env) {
 // "start scraping engagers" step may spend at most this many credits on the
 // managed cookieless scraper (founder-approved budget; the rest of the kickoff
 // is free connected-account reads).
-export const WALKTHROUGH_COMPLETION_BONUS_CREDITS = 1_000;
-export const WALKTHROUGH_SCRAPE_MAX_CREDITS = 2_000;
+export const WALKTHROUGH_COMPLETION_BONUS_CREDITS = 100;
+export const WALKTHROUGH_SCRAPE_MAX_CREDITS = 200;
 /**
  * The five NUMERIC fields of a plan, read from the generated pricing snapshot.
  *
@@ -262,6 +290,20 @@ function planPricing(planKey) {
         byokEnabled: row.byokEnabled,
     };
 }
+/**
+ * The monthly-credit feature bullet, DERIVED rather than written down.
+ *
+ * These strings used to be hand-typed literals ("99,000 credits every month").
+ * A re-denomination then had to find and retype every one of them, which is
+ * exactly how a price sheet ends up quoting a number the product does not
+ * charge. Never reintroduce a literal here.
+ */
+function monthlyCreditsFeature(planKey) {
+    const credits = planPricing(planKey).monthlyCredits;
+    if (credits === null)
+        return "Custom monthly credits";
+    return `${credits.toLocaleString("en-US")} credits every month`;
+}
 export const BASE_PRICING_PLANS = {
     // The ENTRY tier since 2026-08-16, superseding the 2026-07-22 retirement that
     // left this as the unentitled fallback for churned / never-subscribed orgs.
@@ -294,9 +336,33 @@ export const BASE_PRICING_PLANS = {
             "Credits for enrichment and AI, topped up any time",
         ],
     },
+    // The one purchasable product since 2026-09-19. Its numbers are the ENTRY
+    // rung ($49); the other five live in OXYGEN_PLAN_OVERRIDES and share this
+    // tier. Anything that needs a rung's real allowance must resolve the plan
+    // KEY (resolveBasePricingPlan("oxygen_499")), never this representative row.
+    oxygen: {
+        tier: "oxygen",
+        name: "Oxygen",
+        ...planPricing("oxygen_49"),
+        monthlyAutomationActions: null,
+        automationOverageCentsPerMillion: null,
+        automationOverageEnabledDefault: false,
+        description: "Your whole GTM stack. One plan — choose the credits you need.",
+        badge: "Your whole GTM stack",
+        highlighted: true,
+        ctaLabel: "Get started",
+        features: [
+            monthlyCreditsFeature("oxygen_49"),
+            "All integrations",
+            "Workflows",
+            "Bring your own keys",
+            "Standard support",
+        ],
+    },
     starter: {
         tier: "starter",
         name: "Starter",
+        isLegacy: true,
         ...planPricing("starter"),
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -304,7 +370,7 @@ export const BASE_PRICING_PLANS = {
         description: "For founders running focused managed enrichment and AI columns.",
         ctaLabel: "Choose Starter",
         features: [
-            "99,000 credits every month",
+            monthlyCreditsFeature("starter"),
             "All integrations",
             "Workflows",
             "Bring your own keys",
@@ -314,6 +380,7 @@ export const BASE_PRICING_PLANS = {
     pro: {
         tier: "pro",
         name: "Pro",
+        isLegacy: true,
         ...planPricing("pro"),
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -323,7 +390,7 @@ export const BASE_PRICING_PLANS = {
         highlighted: true,
         ctaLabel: "Choose Pro",
         features: [
-            "249,000 credits every month",
+            monthlyCreditsFeature("pro"),
             "All integrations",
             "Workflows",
             "Bring your own keys",
@@ -333,6 +400,7 @@ export const BASE_PRICING_PLANS = {
     team: {
         tier: "team",
         name: "Team",
+        isLegacy: true,
         ...planPricing("team"),
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -340,7 +408,7 @@ export const BASE_PRICING_PLANS = {
         description: "For small GTM teams and agencies running shared workflows with their own AI keys.",
         ctaLabel: "Choose Team",
         features: [
-            "749,000 credits every month",
+            monthlyCreditsFeature("team"),
             "All integrations",
             "Workflows",
             "Bring your own keys",
@@ -358,7 +426,7 @@ export const BASE_PRICING_PLANS = {
         ctaLabel: "Contact sales",
         contactHref: CONTACT_SALES_URL,
         features: [
-            "10,000,000+ managed credits / month",
+            monthlyCreditsFeature("scale"),
             "Workflows",
             "Phone number enrichment on managed credits",
             "Custom provider routing and BYOK policies",
@@ -383,16 +451,22 @@ export const BASE_PRICING_PLANS = {
         ],
     },
 };
-export const PUBLIC_PLAN_ORDER = [
-    "starter",
-    "pro",
-    "team",
-];
+/** One public card; the six rungs are a selector inside it. */
+export const PUBLIC_PLAN_ORDER = ["oxygen"];
+/**
+ * Tiers whose Stripe prices must still RESOLVE. Deliberately wider than what is
+ * purchasable: starter/pro/team are grandfathered, so a live subscription on one
+ * of their prices must keep mapping to a plan. Use PURCHASABLE_PLAN_KEYS for
+ * anything that offers a plan for sale.
+ */
 export const SELF_SERVE_PLAN_TIERS = [
+    "oxygen",
     "starter",
     "pro",
     "team",
 ];
+/** What a customer can actually buy or switch to, cheapest first. */
+export const PURCHASABLE_PLAN_KEYS = OXYGEN_PLAN_KEYS;
 export const CONTACT_SALES_PLAN_TIERS = [
     "scale",
     "enterprise",
@@ -465,6 +539,37 @@ export function resolveSubscriptionEntitlement(input) {
     }
     return { entitled: false, reason: "missing_subscription", graceEndsAt: null };
 }
+/**
+ * The six purchasable rungs, keyed by plan key.
+ *
+ * Each is the representative `oxygen` plan with that rung's real price and
+ * allowance substituted in. `tier` stays "oxygen" for all six — the rung is the
+ * key, the entitlement is the tier.
+ */
+const OXYGEN_PLAN_OVERRIDES = {
+    oxygen_49: oxygenRung("oxygen_49"),
+    oxygen_99: oxygenRung("oxygen_99"),
+    oxygen_199: oxygenRung("oxygen_199"),
+    oxygen_499: oxygenRung("oxygen_499"),
+    oxygen_999: oxygenRung("oxygen_999"),
+    oxygen_1999: oxygenRung("oxygen_1999"),
+};
+function oxygenRung(planKey) {
+    const pricing = planPricing(planKey);
+    const dollars = pricing.monthlyPriceCents === null
+        ? null
+        : Math.round(pricing.monthlyPriceCents / 100);
+    return {
+        ...BASE_PRICING_PLANS.oxygen,
+        ...pricing,
+        name: dollars === null ? "Oxygen" : `Oxygen $${dollars.toLocaleString("en-US")}`,
+        ctaLabel: dollars === null ? "Get started" : `Choose $${dollars.toLocaleString("en-US")}`,
+        features: [
+            monthlyCreditsFeature(planKey),
+            ...BASE_PRICING_PLANS.oxygen.features.slice(1),
+        ],
+    };
+}
 const LEGACY_PRICING_PLAN_OVERRIDES = {
     launch_50: {
         ...BASE_PRICING_PLANS.starter,
@@ -515,6 +620,12 @@ const LEGACY_PRICING_PLAN_OVERRIDES = {
 export function resolveBasePricingPlan(tier) {
     if (!tier)
         return null;
+    // Plan KEYS before tiers: `subscriptions.tier` stores "oxygen_499", and the
+    // rung's own allowance — not the representative $49 row — is what the
+    // customer paid for.
+    const oxygen = OXYGEN_PLAN_OVERRIDES[tier];
+    if (oxygen)
+        return oxygen;
     if (tier in BASE_PRICING_PLANS) {
         return BASE_PRICING_PLANS[tier];
     }
@@ -523,13 +634,13 @@ export function resolveBasePricingPlan(tier) {
 }
 export function applyPricingPlanMetadataOverrides(// skipcq: JS-R1005
 plan, metadata) {
-    const record = readRecord(metadata);
+    const record = asRecordOrNull(metadata);
     if (!record)
         return plan;
-    const config = readRecord(record.billing_plan)
-        ?? readRecord(record.custom_plan)
-        ?? readRecord(record.custom_limits)
-        ?? readRecord(record.plan_limits)
+    const config = asRecordOrNull(record.billing_plan)
+        ?? asRecordOrNull(record.custom_plan)
+        ?? asRecordOrNull(record.custom_limits)
+        ?? asRecordOrNull(record.plan_limits)
         ?? record;
     const name = readString(config, "name")
         ?? readString(config, "plan_name")
@@ -567,17 +678,33 @@ plan, metadata) {
 export function isSelfServePlanTier(value) {
     return SELF_SERVE_PLAN_TIERS.includes(value);
 }
+// Keyed by PlanTier so a new tier is a compile error here until someone decides
+// it. The hand-typed list this replaced predated the 2026-09-19 "oxygen" tier,
+// so every customer on the one purchasable plan was refused managed phone
+// enrichment that Free and the grandfathered plans still had.
+const MANAGED_PHONE_PLAN_TIER_ALLOWED = {
+    free: true,
+    oxygen: true,
+    starter: true,
+    pro: true,
+    team: true,
+    scale: true,
+    enterprise: true,
+};
+export const MANAGED_PHONE_PLAN_TIERS = Object.keys(MANAGED_PHONE_PLAN_TIER_ALLOWED).filter((tier) => MANAGED_PHONE_PLAN_TIER_ALLOWED[tier]);
+export function planAllowsManagedPhoneEnrichment(tier) {
+    return MANAGED_PHONE_PLAN_TIERS.includes(tier);
+}
+/** True for the six rungs a customer may buy or switch to. */
+export function isPurchasablePlanKey(value) {
+    return PURCHASABLE_PLAN_KEYS.includes(value);
+}
 export function isBillingCurrency(value) {
     return BILLING_CURRENCIES.includes(value);
 }
 export function normalizeBillingCurrency(value) {
     return value && isBillingCurrency(value) ? value : DEFAULT_BILLING_CURRENCY;
 }
-function readRecord(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return null;
-    return value;
-}
 function readString(record, key) {
     const value = record[key];
     return typeof value === "string" && value.trim() ? value.trim() : null;
@@ -645,6 +772,34 @@ function formatUtcDay(date) {
         timeZone: "UTC",
     });
 }
+/**
+ * Whether a subscription row has a real Stripe object behind it that Stripe's
+ * own APIs (retrieve, update, invoice preview, portal flows) can act on.
+ *
+ * Three kinds of row say no: a staff-invoiced manual contract (`manual_contract_`
+ * id and/or `off_stripe` in either spelling the codebase has written), a
+ * control-plane-only internal grant (`internal_dogfood_…`), and a hand-inserted
+ * synthetic row that DOES carry a `sub_` prefix but marks itself
+ * `metadata.synthetic: true`. That last shape is why the id prefix alone is not
+ * the test: the dev dogfood org's `sub_synthetic_dev_dogfood_…` row passed every
+ * `startsWith("sub_")` check and reached `stripe.subscriptions.retrieve`, where
+ * Stripe answered "No such subscription" and the customer read the generic
+ * "Unable to preview the plan change." Every self-serve Stripe mutation must
+ * refuse these rows before it calls Stripe, with a message that names the fix.
+ */
+export function isStripeManagedSubscription(subscription) {
+    // A row with no usable id is not something Stripe manages; answer false
+    // rather than throw, because this runs inside read-only pages (the billing
+    // summary) where a throw becomes a 500 for the whole page.
+    if (typeof subscription.stripeSubscriptionId !== "string")
+        return false;
+    if (!subscription.stripeSubscriptionId.startsWith("sub_"))
+        return false;
+    const metadata = subscription.metadata ?? {};
+    return (metadata.off_stripe !== true
+        && metadata.off_stripe !== "true"
+        && metadata.synthetic !== true);
+}
 /**
  * The window the credit-allowance bar measures: "this month's credits", resolved
  * to the boundary at which the plan's grant actually renews.

package/node_modules/@oxygen/shared/dist/byok-connect.js

@@ -72,13 +72,18 @@ export const NATIVE_API_KEY_CONNECT_INTEGRATION_IDS = new Set([
     // Native api-key connect added in catalog.ts (2026-09-10): connect writes an
     // integration_secrets api_key row the native parallel.* runner reads. T-104.
     "parallel",
+    "pipedrive",
     "predictleads",
     "prospeo",
     "scalelist",
+    // scrapeli / up2data (2026-09-25): the company-followers and LinkedIn post lanes
+    // offer "Bring your own API key"; both connect forms live in catalog.ts.
+    "scrapeli",
     // scraper: dev v1.920.2 added the HarvestAPI workspace-key connect (native api-key form).
     "scraper",
     "serper",
     "signalbase",
+    "up2data",
     "zapmail",
     "zerobounce",
 ]);

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

@@ -1,3 +1,4 @@
+import { type EnrichmentIntentTaxonomyEntry } from "./enrichment-intents.js";
 import { type RecipePrimitive } from "./recipes.js";
 export type CapabilityLayer = "Control" | "Knowledge" | "Data" | "Action" | "External";
 export type CapabilityPosture = "read_only" | "workspace_write" | "paid_read" | "external_write" | "mixed";
@@ -29,6 +30,22 @@ export type CapabilityRouteMatch = {
      * intent is that narrow; `recommendedCommands[0]` is the same command.
      */
     exactCommand?: string;
+    /**
+     * The opinionated enrichment catalogue row a data-type ask resolves to
+     * ("get the funding round" -> enrich_company:funding). Present only when
+     * the ask names a data type; the catalogue command is then the first
+     * recommendation, ahead of any raw provider tool.
+     */
+    catalogIntent?: {
+        id: string;
+        label: string;
+        status: EnrichmentIntentTaxonomyEntry["status"];
+        group: EnrichmentIntentTaxonomyEntry["group"];
+        /** The catalogue-first path: read the row, then add/preview; `exactCommand` names the row. */
+        tools: string[];
+        commands: string[];
+        exactCommand: string;
+    };
 };
 export type PrimitiveRouteMatch = CapabilityRouteMatch & {
     card: PrimitiveRouteCard;
@@ -40,5 +57,15 @@ export declare function getCapabilityRouteMatch(id: string): CapabilityRouteMatc
 export declare function inferCapabilityRoute(query: string): CapabilityRouteMatch | null;
 export declare function inferPrimitiveRoute(query: string): PrimitiveRouteMatch | null;
 export declare function serializeCapabilityRoute(route: CapabilityRouteMatch | null): Record<string, unknown> | null;
+export declare const COMPANY_PAGE_FOLLOWERS_COMMAND = "oxygen tables followers check --company <linkedin company page URL> --records <n> --json";
 /** The exact `companies search plan` invocation for the url_recovery intent. */
 export declare const COMPANY_URL_RECOVERY_COMMAND = "oxygen companies search plan --prompt \"Find the websites for these companies: <company names>\" --source-intent url_recovery";
+/** The free native preview for Google Maps businesses; import follows its reviewed quote. */
+export declare const LOCAL_BUSINESS_SCRAPE_COMMAND = "oxygen companies search preview --source google_maps --filters-json '{\"q\":\"<category> in <city, region>\"}'";
+/**
+ * The free list of classification columns. Production answers it with its one
+ * classification template (B2B or B2C); a deployment that runs the native
+ * Classify column lists that entry here too. Any other scheme is an AI prompt
+ * column through `columns add`, which the route recommends next.
+ */
+export declare const ROW_CLASSIFICATION_COMMAND = "oxygen columns catalog --family classification";