@oxygen-agent/cli 1.987.20 → 1.1010.1

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,10 @@ 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;
+export declare const MANAGED_PHONE_PLAN_TIERS: readonly PlanTier[];
+export declare function planAllowsManagedPhoneEnrichment(tier: string): boolean;
+/** 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;
@@ -312,6 +370,25 @@ export type CreditCycleWindow = {
     /** "July 2026" | "Jun 10 – Jul 10" */
     label: string;
 };
+/**
+ * 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 declare function isStripeManagedSubscription(subscription: {
+    stripeSubscriptionId?: string | null;
+    metadata?: Record<string, unknown> | null;
+}): boolean;
 /**
  * The window the credit-allowance bar measures: "this month's credits", resolved
  * to the boundary at which the plan's grant actually renews.