@oxygen-agent/cli 1.987.20 → 1.1003.12

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

@@ -2,13 +2,38 @@ export declare const WEEKLY_USAGE_WINDOW_DAYS = 7;
 export declare const BILLING_CURRENCIES: readonly ["usd"];
 export type BillingCurrency = (typeof BILLING_CURRENCIES)[number];
 export declare const DEFAULT_BILLING_CURRENCY: BillingCurrency;
-export type SelfServePlanTier = "starter" | "pro" | "team";
+/**
+ * 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 declare const OXYGEN_PLAN_KEYS: readonly ["oxygen_49", "oxygen_99", "oxygen_199", "oxygen_499", "oxygen_999", "oxygen_1999"];
+export type OxygenPlanKey = (typeof OXYGEN_PLAN_KEYS)[number];
+/**
+ * starter/pro/team were the self-serve catalog until 2026-09-19. They are no
+ * longer purchasable, but live subscriptions still bill against their Stripe
+ * prices, so they remain resolvable tiers forever.
+ */
+export type LegacySelfServePlanTier = "starter" | "pro" | "team";
+export type SelfServePlanTier = "oxygen" | LegacySelfServePlanTier;
 export type ContactSalesPlanTier = "scale" | "enterprise";
 export type PlanTier = "free" | SelfServePlanTier | ContactSalesPlanTier;
 export type UsageLimitedPlanTier = Exclude<PlanTier, "enterprise">;
 export type PricingPlanDefinition = {
     tier: PlanTier;
     name: string;
+    /** Grandfathered: still resolves and still bills, never offered for purchase. */
+    isLegacy?: boolean;
     monthlyPriceCents: number | null;
     monthlyCredits: number | null;
     weeklyCreditsLimit: number | null;
@@ -26,12 +51,12 @@ export type PricingPlanDefinition = {
 };
 export type PricingPlanMetadata = Record<string, unknown> | null | undefined;
 export declare const CONTACT_SALES_URL = "mailto:priority@oxygen-agent.com";
-export declare const CREDITS_PER_USD = 1000;
-export declare const TOPUP_USD_CENTS_PER_1K_CREDITS = 125;
-export declare const CREDIT_TOPUP_MIN_CREDITS = 8000;
-export declare const CREDIT_TOPUP_MAX_CREDITS = 1000000;
-export declare const CREDIT_TOPUP_STEP_CREDITS = 1000;
-export declare const CREDIT_TOPUP_DEFAULT_CREDITS = 20000;
+export declare const CREDITS_PER_USD = 100;
+export declare const TOPUP_USD_CENTS_PER_100_CREDITS = 125;
+export declare const CREDIT_TOPUP_MIN_CREDITS = 800;
+export declare const CREDIT_TOPUP_MAX_CREDITS = 100000;
+export declare const CREDIT_TOPUP_STEP_CREDITS = 100;
+export declare const CREDIT_TOPUP_DEFAULT_CREDITS = 2000;
 export declare function isValidCreditTopupCredits(credits: number): boolean;
 /**
  * A shortfall expressed as an amount `oxygen billing topup` will actually SELL:
@@ -51,7 +76,7 @@ export declare function isValidCreditTopupCredits(credits: number): boolean;
  */
 export declare function creditTopupAmountForShortfall(credits: number): number;
 export declare function creditTopupUsdCents(credits: number): number | null;
-export declare const AUTOMATION_ACTION_CREDITS = 0.01;
+export declare const AUTOMATION_ACTION_CREDITS = 0.001;
 /** Kinds of resource that carry a fixed monthly credit commitment. */
 export declare const CREDIT_COMMITMENT_KINDS: readonly ["sending_mailbox", "managed_mailbox", "mailbox_warmup", "deliverability_unit", "linkedin_account", "whatsapp_account"];
 export type CreditCommitmentKind = (typeof CREDIT_COMMITMENT_KINDS)[number];
@@ -61,12 +86,12 @@ export type CreditCommitmentKind = (typeof CREDIT_COMMITMENT_KINDS)[number];
  * Gmail and Microsoft inboxes included — and it STACKS on Oxygen-sold mailboxes,
  * which additionally pay their own mailbox/warmup/placement lines.
  */
-export declare const SENDING_MAILBOX_MONTHLY_CREDITS = 1000;
+export declare 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 declare const MANAGED_MAILBOX_MONTHLY_CREDITS = 3000;
+export declare 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
@@ -109,25 +134,25 @@ export declare function ratifiedCommitmentCredits(kind: CreditCommitmentKind): n
 export declare const CREDIT_TOPUP_PACKS: readonly [{
     readonly id: "10";
     readonly usdCents: 1000;
-    readonly credits: 8000;
+    readonly credits: 800;
 }, {
     readonly id: "25";
     readonly usdCents: 2500;
-    readonly credits: 20000;
+    readonly credits: 2000;
 }, {
     readonly id: "100";
     readonly usdCents: 10000;
-    readonly credits: 80000;
+    readonly credits: 8000;
 }, {
     readonly id: "250";
     readonly usdCents: 25000;
-    readonly credits: 200000;
+    readonly credits: 20000;
 }];
 export type CreditTopupPack = (typeof CREDIT_TOPUP_PACKS)[number];
 export type CreditTopupPackId = CreditTopupPack["id"];
 export declare function resolveCreditTopupPack(id: string | null | undefined): CreditTopupPack | null;
 export declare const TRIAL_PERIOD_DAYS = 7;
-export declare const TRIAL_CREDIT_GRANT = 20000;
+export declare const TRIAL_CREDIT_GRANT = 2000;
 /**
  * Free-tier entry (founder-ratified 2026-08-16; grant collapsed to a single
  * 10,000-credit signup grant 2026-08-26).
@@ -153,7 +178,7 @@ export declare const TRIAL_CREDIT_GRANT = 20000;
  * 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 declare const FREE_SIGNUP_GRANT_CREDITS = 10000;
+export declare const FREE_SIGNUP_GRANT_CREDITS = 1000;
 export declare const FREE_TIER_GRANTS_ENABLED_ENV_VAR = "OXYGEN_FREE_TIER_GRANTS_ENABLED";
 /**
  * Fail-closed rollout switch for the free-tier grants, matching the staged
@@ -168,8 +193,8 @@ export declare const FREE_TIER_GRANTS_ENABLED_ENV_VAR = "OXYGEN_FREE_TIER_GRANTS
  * population before the cutover posture is decided.
  */
 export declare function freeTierGrantsEnabled(env?: Record<string, string | undefined>): boolean;
-export declare const WALKTHROUGH_COMPLETION_BONUS_CREDITS = 1000;
-export declare const WALKTHROUGH_SCRAPE_MAX_CREDITS = 2000;
+export declare const WALKTHROUGH_COMPLETION_BONUS_CREDITS = 100;
+export declare const WALKTHROUGH_SCRAPE_MAX_CREDITS = 200;
 export declare const BASE_PRICING_PLANS: {
     readonly free: {
         readonly monthlyPriceCents: number | null;
@@ -186,6 +211,23 @@ export declare const BASE_PRICING_PLANS: {
         readonly ctaLabel: "Upgrade";
         readonly features: readonly ["CRM, Tables, Workflows, and Knowledge — unmetered", "Sequences: author, preview, and enroll", "Agents and Workspace Copilot", "Credits for enrichment and AI, topped up any time"];
     };
+    readonly oxygen: {
+        readonly monthlyPriceCents: number | null;
+        readonly monthlyCredits: number | null;
+        readonly weeklyCreditsLimit: number | null;
+        readonly rolloverCap: number | null;
+        readonly byokEnabled: boolean;
+        readonly tier: "oxygen";
+        readonly name: "Oxygen";
+        readonly monthlyAutomationActions: null;
+        readonly automationOverageCentsPerMillion: null;
+        readonly automationOverageEnabledDefault: false;
+        readonly description: "Your whole GTM stack. One plan — choose the credits you need.";
+        readonly badge: "Your whole GTM stack";
+        readonly highlighted: true;
+        readonly ctaLabel: "Get started";
+        readonly features: readonly [string, "All integrations", "Workflows", "Bring your own keys", "Standard support"];
+    };
     readonly starter: {
         readonly monthlyPriceCents: number | null;
         readonly monthlyCredits: number | null;
@@ -194,12 +236,13 @@ export declare const BASE_PRICING_PLANS: {
         readonly byokEnabled: boolean;
         readonly tier: "starter";
         readonly name: "Starter";
+        readonly isLegacy: true;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
         readonly description: "For founders running focused managed enrichment and AI columns.";
         readonly ctaLabel: "Choose Starter";
-        readonly features: readonly ["99,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Standard support"];
+        readonly features: readonly [string, "All integrations", "Workflows", "Bring your own keys", "Standard support"];
     };
     readonly pro: {
         readonly monthlyPriceCents: number | null;
@@ -209,6 +252,7 @@ export declare const BASE_PRICING_PLANS: {
         readonly byokEnabled: boolean;
         readonly tier: "pro";
         readonly name: "Pro";
+        readonly isLegacy: true;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
@@ -216,7 +260,7 @@ export declare const BASE_PRICING_PLANS: {
         readonly badge: "Most popular";
         readonly highlighted: true;
         readonly ctaLabel: "Choose Pro";
-        readonly features: readonly ["249,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Standard support"];
+        readonly features: readonly [string, "All integrations", "Workflows", "Bring your own keys", "Standard support"];
     };
     readonly team: {
         readonly monthlyPriceCents: number | null;
@@ -226,12 +270,13 @@ export declare const BASE_PRICING_PLANS: {
         readonly byokEnabled: boolean;
         readonly tier: "team";
         readonly name: "Team";
+        readonly isLegacy: true;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
         readonly description: "For small GTM teams and agencies running shared workflows with their own AI keys.";
         readonly ctaLabel: "Choose Team";
-        readonly features: readonly ["749,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Premium support"];
+        readonly features: readonly [string, "All integrations", "Workflows", "Bring your own keys", "Premium support"];
     };
     readonly scale: {
         readonly monthlyPriceCents: number | null;
@@ -247,7 +292,7 @@ export declare const BASE_PRICING_PLANS: {
         readonly description: "For high-volume GTM teams that need custom limits and rollout support.";
         readonly ctaLabel: "Contact sales";
         readonly contactHref: "mailto:priority@oxygen-agent.com";
-        readonly features: readonly ["10,000,000+ managed credits / month", "Workflows", "Phone number enrichment on managed credits", "Custom provider routing and BYOK policies", "Dedicated onboarding"];
+        readonly features: readonly [string, "Workflows", "Phone number enrichment on managed credits", "Custom provider routing and BYOK policies", "Dedicated onboarding"];
     };
     readonly enterprise: {
         readonly monthlyPriceCents: number | null;
@@ -266,8 +311,17 @@ export declare const BASE_PRICING_PLANS: {
         readonly features: readonly ["Everything in Team", "Custom usage limits", "Volume pricing", "Dedicated support"];
     };
 };
+/** One public card; the six rungs are a selector inside it. */
 export declare const PUBLIC_PLAN_ORDER: readonly PlanTier[];
+/**
+ * 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 declare const SELF_SERVE_PLAN_TIERS: readonly SelfServePlanTier[];
+/** What a customer can actually buy or switch to, cheapest first. */
+export declare const PURCHASABLE_PLAN_KEYS: readonly OxygenPlanKey[];
 export declare const CONTACT_SALES_PLAN_TIERS: readonly ContactSalesPlanTier[];
 export declare const ACTIVE_SUBSCRIPTION_STATUSES: readonly ["active", "trialing", "past_due"];
 export type ActiveSubscriptionStatus = (typeof ACTIVE_SUBSCRIPTION_STATUSES)[number];
@@ -294,6 +348,8 @@ export declare function resolveBasePricingPlan(tier: string | null | undefined):
 export declare function applyPricingPlanMetadataOverrides(// skipcq: JS-R1005
 plan: PricingPlanDefinition, metadata: PricingPlanMetadata): PricingPlanDefinition;
 export declare function isSelfServePlanTier(value: string): value is SelfServePlanTier;
+/** True for the six rungs a customer may buy or switch to. */
+export declare function isPurchasablePlanKey(value: string): value is OxygenPlanKey;
 export declare function isBillingCurrency(value: string): value is BillingCurrency;
 export declare function normalizeBillingCurrency(value: string | null | undefined): BillingCurrency;
 export declare function getCurrentFreeTierCycleKey(date?: Date): string;

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,16 @@ plan, metadata) {
 export function isSelfServePlanTier(value) {
     return SELF_SERVE_PLAN_TIERS.includes(value);
 }
+/** 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;

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;