@oxygen-agent/cli 1.739.1 → 1.766.0

package/node_modules/@oxygen/shared/dist/pricing-sheet.d.ts

@@ -3,24 +3,52 @@
  * page's "what credits buy" table, the pricing calculator, and docs.
  *
  * Pricing Model 2.0 (founder-ratified 2026-07-14): ONE credit pool pays for
- * everything; 1 USD = 1,000 credits (CREDITS_PER_USD in ./billing.ts).
- * Representative values here mirror the canonical billing sources — the
- * enrichment/AI resolver seed (packages/integrations/src/cogs-rates.ts), the
- * infra cost-plus rules (vendor COGS × 1.25), and the ratified LinkedIn
- * prices — as DISPLAY constants. If a canonical price moves, move it here in
- * the same change.
+ * everything; 1 USD = 1,000 credits.
+ *
+ * THIS FILE NO LONGER DECLARES PRICES. It used to carry hand-copied literals
+ * under a comment asking the next person to remember to update them — which is
+ * how it came to quote 25 credits for web-search grounding that actually
+ * reserved 115. Prices now arrive from exactly two places, and neither of them
+ * is a human retyping a number:
+ *
+ *   ./pricing-snapshot.generated.ts   platform prices, rendered from
+ *                                     packages/control-db/src/pricing/seed.ts by
+ *                                     `npm run pricing:snapshot` and CI-gated.
+ *                                     To change one, edit the SEED.
+ *
+ *   resolver-derived values below     AI column tiers, web-search grounding and
+ *                                     the representative enrichment prices come
+ *                                     from provider_cost_config (seeded by
+ *                                     cogs-rates.ts) — a different source of
+ *                                     truth, pinned by
+ *                                     pricing-sheet-conformance.test.ts in
+ *                                     @oxygen/integrations, which can see both
+ *                                     sides and fails when they diverge.
  *
  * Dependency-free on purpose: this module is imported by "use client"
  * marketing components via the `@oxygen/shared/pricing-sheet` subpath, so it
  * must never drag the shared barrel (async_hooks etc.) into a client bundle.
+ * The generated snapshot holds that property too — it is literals only.
+ *
+ * Anything that CAN await a query should read the control DB via
+ * loadPricingBook() instead of importing this file, so a staff re-price at
+ * /admin/costs takes effect without a deploy.
  */
+export { creditsToUsd, usdToCredits } from "./pricing-snapshot.generated.js";
 export declare const PRICING_SHEET_VERIFIED = "2026-07";
-/** Mirror of CREDITS_PER_USD in ./billing.ts (kept literal: client-safe module). */
 export declare const PRICING_CREDITS_PER_USD = 1000;
 /** On-demand top-up price per 1,000 credits (USD); subscriptions pay $1.00. */
 export declare const TOPUP_USD_PER_1K = 1.25;
 export declare const SUBSCRIPTION_USD_PER_1K = 1;
-/** AI column runs, honest 5× of modeled tier COGS. */
+/**
+ * AI column runs, honest 5× of modeled tier COGS.
+ *
+ * RESOLVER-DERIVED, not seed-derived: the canonical values live in
+ * packages/integrations/src/cogs-rates.ts and are served per-workspace from
+ * provider_cost_config. pricing-sheet-conformance.test.ts pins these literals
+ * against the live estimator, so a tier re-price fails a test rather than
+ * quietly mispricing the page.
+ */
 export declare const AI_COLUMN_CREDITS: {
     readonly low: 15;
     readonly medium: 75;
@@ -38,11 +66,7 @@ export declare const AI_COLUMN_CREDITS: {
  * with parallel as its one fallback (WEB_SEARCH_ENGINES), so a row costs 35 when
  * the primary answers and reserves 40 for the case where both lanes fire.
  *
- * LITERAL ON PURPOSE, like PRICING_CREDITS_PER_USD above: this module ships to the
- * marketing client bundle and cannot import @oxygen/integrations (which depends on
- * @oxygen/shared). `pricing-sheet-conformance.test.ts` in @oxygen/integrations —
- * which can see both — pins these numbers to the live resolver, so drift fails a
- * test instead of quietly mispricing the page again.
+ * Resolver-derived like AI_COLUMN_CREDITS above, and pinned by the same test.
  */
 export declare const AI_COLUMN_WEB_SEARCH_TYPICAL_CREDITS = 35;
 export declare const AI_COLUMN_WEB_SEARCH_RESERVED_CREDITS = 40;
@@ -50,12 +74,9 @@ export declare const AI_COLUMN_WEB_SEARCH_RESERVED_CREDITS = 40;
 export declare const AUTOMATION_ACTION_CREDITS = 0.01;
 /**
  * Managed email inboxes: founder-ratified flat price (2026-07-25), superseding
- * the earlier dynamic vendor-COGS × 1.25 range (InboxKit $2.48–3.99 Google /
- * flat $5 Microsoft rate card, ×1.25 → 3,100–6,250 cr). The Oxygen-sold managed
- * mailbox line is now a flat $3.00/month (3,000 credits) regardless of vendor
- * tier. Kept as an object (min/typical/max all equal) rather than a bare number
- * so existing callers that destructure any of the three fields need no shape
- * change.
+ * the earlier dynamic vendor-COGS × 1.25 range. Kept as an object (min/typical/max
+ * all equal) rather than a bare number so existing callers that destructure any
+ * of the three fields need no shape change.
  */
 export declare const MANAGED_INBOX_MARKUP = 1.25;
 export declare const MANAGED_INBOX_CREDITS_PER_MONTH: {
@@ -77,15 +98,8 @@ export declare const MANAGED_INBOX_CREDITS_PER_MONTH: {
  * Costing only the outbound leg undercharges every call by 29%.
  */
 export declare const VOICE_MARKUP = 5;
-/**
- * Flat $5.00/mo per number (founder decision 2026-07-26). Twilio's US/CA local
- * DID costs $1.15, so this is ~4.3× — priced as a round number rather than a
- * computed markup, the way a customer actually reads a price.
- */
 export declare const VOICE_NUMBER_CREDITS_PER_MONTH = 5000;
-/** Both legs, $0.018/min × 5 → $0.09/min. */
 export declare const VOICE_CREDITS_PER_MINUTE = 90;
-/** Answering-machine detection is per CALL, not per minute — it bills on no-answers too. */
 export declare const VOICE_CREDITS_PER_AMD_CALL = 38;
 /** Managed domains: registrar at-cost × 1.25 (≈ a $10.44 .com → ~13,050 credits/yr). */
 export declare const MANAGED_DOMAIN_MARKUP = 1.25;
@@ -97,18 +111,6 @@ export declare const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = 13050;
  * inbox-placement (spam) tests; tests beyond the allowance bill the per-test
  * price.
  *
- * All three are DISPLAY mirrors, per this file's contract. The canonical values
- * live where they are enforced, and seed-parity.test.ts binds them so a mirror
- * can never quietly drift from the number actually billed:
- *   seat      DELIVERABILITY_UNIT_MONTHLY_CREDITS       (@oxygen/control-db,
- *             also PRICING_SEED commitment.deliverability_unit) — 1,000 credits
- *             ($1.00), restored by the founder on 2026-07-30 after reviewing the
- *             Agency-plan unit economics, superseding the 2026-07-26 signature
- *             of 2,000.
- *   allowance DELIVERABILITY_INCLUDED_TESTS_PER_INBOX  (@oxygen/control-db)
- *   overage   EMAILGUARD_MANAGED_PLACEMENT_CREDITS     (@oxygen/providers,
- *             derived from the Agency plan rather than typed in)
- *
  * THE ALLOWANCE IS LOAD-BEARING, not a perk. Placement COGS is per TEST
  * ($0.1327 on EmailGuard's Agency plan), not per inbox, so an unbounded seat
  * inverts its own margin: at $1.00/inbox-month the EIGHTH test in a cycle is
@@ -118,14 +120,12 @@ export declare const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = 13050;
  */
 export declare const DELIVERABILITY_SEAT_CREDITS_PER_MONTH = 1000;
 export declare const DELIVERABILITY_INCLUDED_TESTS_PER_INBOX = 2;
-/** Overage placement test: $0.1327 EmailGuard COGS × 1.25, rounded up. */
 export declare const PLACEMENT_TEST_OVERAGE_CREDITS = 166;
 /**
  * LinkedIn accounts: founder decision (2026-07-25) — a PURE seat model. The
- * flat monthly connection fee per connected account is now the WHOLE LinkedIn
- * price (10,000 credits, up from the 7,000-credit 2026-07-14 Pricing Model 2.0
- * figure); every per-action charge below is 0. Per-MESSAGE sends on email and
- * WhatsApp stay 0 too — but a connected WhatsApp NUMBER carries its own monthly
+ * flat monthly connection fee per connected account is the WHOLE LinkedIn
+ * price; every per-action charge is 0. Per-MESSAGE sends on email and WhatsApp
+ * stay 0 too — but a connected WhatsApp NUMBER carries its own monthly
  * connection fee, see WHATSAPP_ACCOUNT_CREDITS_PER_MONTH.
  */
 export declare const LINKEDIN_ACCOUNT_CREDITS_PER_MONTH = 10000;
@@ -138,23 +138,16 @@ export declare const LINKEDIN_ACTION_CREDITS: {
     readonly like_post: 0;
     readonly comment_post: 0;
 };
-/**
- * Editable calculator default: a warmed account's typical monthly action mix.
- * 0 under the pure seat model (2026-07-25) — actions no longer add to the
- * LinkedIn line regardless of volume, so this default carries no credits.
- * Kept (not deleted) because PRICING_CALCULATOR_DEFAULTS.linkedinActionCreditsPerAccount
- * still reads it as its default value.
- */
 export declare const LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH = 0;
 /**
  * WhatsApp numbers: flat monthly connection fee per connected number, the same
- * seat shape as LinkedIn ($10 × 1,000 credits/$). Billed off the rolling-30d peak,
- * so a number connected part-way through a month still bills the full cycle.
- * WhatsApp message sends themselves remain 0 credits.
+ * seat shape as LinkedIn. Billed off the rolling-30d peak, so a number connected
+ * part-way through a month still bills the full cycle. WhatsApp message sends
+ * themselves remain 0 credits.
  */
 export declare const WHATSAPP_ACCOUNT_CREDITS_PER_MONTH = 10000;
 /** Dedicated egress IP add-on. */
-export declare const EGRESS_IP_CREDITS_PER_MONTH = 15000;
+export declare const EGRESS_IP_CREDITS_PER_MONTH = 25000;
 /**
  * Email + WhatsApp sends cost nothing per message — the pool pays for inboxes and
  * connected accounts, not for sends.
@@ -164,6 +157,9 @@ export declare const SEND_CREDITS = 0;
  * Representative enrichment prices (5× provider COGS via the resolver; the
  * live per-operation table is served by /api/pricing/customer-credit-prices).
  * "typical" = the cheap-first waterfall's common case, used by the calculator.
+ *
+ * Resolver-derived, like AI_COLUMN_CREDITS: these mirror cogs-rates.ts, not the
+ * pricing seed.
  */
 export declare const ENRICHMENT_CREDITS: {
     readonly email_verify: 2.245;
@@ -176,5 +172,3 @@ export declare const ENRICHMENT_CREDITS: {
 };
 /** Editable calculator default: blended credits per fully-enriched row. */
 export declare const ENRICHMENT_CREDITS_PER_ROW_TYPICAL = 100;
-export declare function creditsToUsd(credits: number): number;
-export declare function usdToCredits(usd: number): number;

package/node_modules/@oxygen/shared/dist/pricing-sheet.js

@@ -3,24 +3,53 @@
  * page's "what credits buy" table, the pricing calculator, and docs.
  *
  * Pricing Model 2.0 (founder-ratified 2026-07-14): ONE credit pool pays for
- * everything; 1 USD = 1,000 credits (CREDITS_PER_USD in ./billing.ts).
- * Representative values here mirror the canonical billing sources — the
- * enrichment/AI resolver seed (packages/integrations/src/cogs-rates.ts), the
- * infra cost-plus rules (vendor COGS × 1.25), and the ratified LinkedIn
- * prices — as DISPLAY constants. If a canonical price moves, move it here in
- * the same change.
+ * everything; 1 USD = 1,000 credits.
+ *
+ * THIS FILE NO LONGER DECLARES PRICES. It used to carry hand-copied literals
+ * under a comment asking the next person to remember to update them — which is
+ * how it came to quote 25 credits for web-search grounding that actually
+ * reserved 115. Prices now arrive from exactly two places, and neither of them
+ * is a human retyping a number:
+ *
+ *   ./pricing-snapshot.generated.ts   platform prices, rendered from
+ *                                     packages/control-db/src/pricing/seed.ts by
+ *                                     `npm run pricing:snapshot` and CI-gated.
+ *                                     To change one, edit the SEED.
+ *
+ *   resolver-derived values below     AI column tiers, web-search grounding and
+ *                                     the representative enrichment prices come
+ *                                     from provider_cost_config (seeded by
+ *                                     cogs-rates.ts) — a different source of
+ *                                     truth, pinned by
+ *                                     pricing-sheet-conformance.test.ts in
+ *                                     @oxygen/integrations, which can see both
+ *                                     sides and fails when they diverge.
  *
  * Dependency-free on purpose: this module is imported by "use client"
  * marketing components via the `@oxygen/shared/pricing-sheet` subpath, so it
  * must never drag the shared barrel (async_hooks etc.) into a client bundle.
+ * The generated snapshot holds that property too — it is literals only.
+ *
+ * Anything that CAN await a query should read the control DB via
+ * loadPricingBook() instead of importing this file, so a staff re-price at
+ * /admin/costs takes effect without a deploy.
  */
-export const PRICING_SHEET_VERIFIED = "2026-07";
-/** Mirror of CREDITS_PER_USD in ./billing.ts (kept literal: client-safe module). */
-export const PRICING_CREDITS_PER_USD = 1_000;
+import { AUTOMATION_ACTION_CREDITS as SNAPSHOT_AUTOMATION_ACTION_CREDITS, CREDITS_PER_USD as SNAPSHOT_CREDITS_PER_USD, DELIVERABILITY_INCLUDED_TESTS_PER_INBOX as SNAPSHOT_DELIVERABILITY_INCLUDED_TESTS_PER_INBOX, DELIVERABILITY_SEAT_CREDITS_PER_MONTH as SNAPSHOT_DELIVERABILITY_SEAT_CREDITS_PER_MONTH, EGRESS_IP_CREDITS_PER_MONTH as SNAPSHOT_EGRESS_IP_CREDITS_PER_MONTH, ENRICHMENT_CREDITS_PER_ROW_TYPICAL as SNAPSHOT_ENRICHMENT_CREDITS_PER_ROW_TYPICAL, LINKEDIN_ACCOUNT_CREDITS_PER_MONTH as SNAPSHOT_LINKEDIN_ACCOUNT_CREDITS_PER_MONTH, LINKEDIN_ACTION_CREDITS as SNAPSHOT_LINKEDIN_ACTION_CREDITS, LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH as SNAPSHOT_LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH, MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL as SNAPSHOT_MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL, MANAGED_DOMAIN_MARKUP as SNAPSHOT_MANAGED_DOMAIN_MARKUP, MANAGED_INBOX_CREDITS_PER_MONTH as SNAPSHOT_MANAGED_INBOX_CREDITS_PER_MONTH, MANAGED_INBOX_MARKUP as SNAPSHOT_MANAGED_INBOX_MARKUP, PLACEMENT_TEST_OVERAGE_CREDITS as SNAPSHOT_PLACEMENT_TEST_OVERAGE_CREDITS, PRICE_SHEET_VERIFIED as SNAPSHOT_PRICE_SHEET_VERIFIED, SEND_CREDITS as SNAPSHOT_SEND_CREDITS, SUBSCRIPTION_USD_PER_1K as SNAPSHOT_SUBSCRIPTION_USD_PER_1K, TOPUP_USD_PER_1K as SNAPSHOT_TOPUP_USD_PER_1K, VOICE_CREDITS_PER_AMD_CALL as SNAPSHOT_VOICE_CREDITS_PER_AMD_CALL, VOICE_CREDITS_PER_MINUTE as SNAPSHOT_VOICE_CREDITS_PER_MINUTE, VOICE_MARKUP as SNAPSHOT_VOICE_MARKUP, VOICE_NUMBER_CREDITS_PER_MONTH as SNAPSHOT_VOICE_NUMBER_CREDITS_PER_MONTH, WHATSAPP_ACCOUNT_CREDITS_PER_MONTH as SNAPSHOT_WHATSAPP_ACCOUNT_CREDITS_PER_MONTH, } from "./pricing-snapshot.generated.js";
+export { creditsToUsd, usdToCredits } from "./pricing-snapshot.generated.js";
+export const PRICING_SHEET_VERIFIED = SNAPSHOT_PRICE_SHEET_VERIFIED;
+export const PRICING_CREDITS_PER_USD = SNAPSHOT_CREDITS_PER_USD;
 /** On-demand top-up price per 1,000 credits (USD); subscriptions pay $1.00. */
-export const TOPUP_USD_PER_1K = 1.25;
-export const SUBSCRIPTION_USD_PER_1K = 1.0;
-/** AI column runs, honest 5× of modeled tier COGS. */
+export const TOPUP_USD_PER_1K = SNAPSHOT_TOPUP_USD_PER_1K;
+export const SUBSCRIPTION_USD_PER_1K = SNAPSHOT_SUBSCRIPTION_USD_PER_1K;
+/**
+ * AI column runs, honest 5× of modeled tier COGS.
+ *
+ * RESOLVER-DERIVED, not seed-derived: the canonical values live in
+ * packages/integrations/src/cogs-rates.ts and are served per-workspace from
+ * provider_cost_config. pricing-sheet-conformance.test.ts pins these literals
+ * against the live estimator, so a tier re-price fails a test rather than
+ * quietly mispricing the page.
+ */
 export const AI_COLUMN_CREDITS = { low: 15, medium: 75, high: 250 };
 /**
  * Web-search grounding, billed per SEARCH on top of the model — not a flat adder.
@@ -34,27 +63,24 @@ export const AI_COLUMN_CREDITS = { low: 15, medium: 75, high: 250 };
  * with parallel as its one fallback (WEB_SEARCH_ENGINES), so a row costs 35 when
  * the primary answers and reserves 40 for the case where both lanes fire.
  *
- * LITERAL ON PURPOSE, like PRICING_CREDITS_PER_USD above: this module ships to the
- * marketing client bundle and cannot import @oxygen/integrations (which depends on
- * @oxygen/shared). `pricing-sheet-conformance.test.ts` in @oxygen/integrations —
- * which can see both — pins these numbers to the live resolver, so drift fails a
- * test instead of quietly mispricing the page again.
+ * Resolver-derived like AI_COLUMN_CREDITS above, and pinned by the same test.
  */
 export const AI_COLUMN_WEB_SEARCH_TYPICAL_CREDITS = 35;
 export const AI_COLUMN_WEB_SEARCH_RESERVED_CREDITS = 40;
 /** Workflow/automation actions (steps, tool calls, row writes) — capacity guard. */
-export const AUTOMATION_ACTION_CREDITS = 0.01;
+export const AUTOMATION_ACTION_CREDITS = SNAPSHOT_AUTOMATION_ACTION_CREDITS;
 /**
  * Managed email inboxes: founder-ratified flat price (2026-07-25), superseding
- * the earlier dynamic vendor-COGS × 1.25 range (InboxKit $2.48–3.99 Google /
- * flat $5 Microsoft rate card, ×1.25 → 3,100–6,250 cr). The Oxygen-sold managed
- * mailbox line is now a flat $3.00/month (3,000 credits) regardless of vendor
- * tier. Kept as an object (min/typical/max all equal) rather than a bare number
- * so existing callers that destructure any of the three fields need no shape
- * change.
+ * the earlier dynamic vendor-COGS × 1.25 range. Kept as an object (min/typical/max
+ * all equal) rather than a bare number so existing callers that destructure any
+ * of the three fields need no shape change.
  */
-export const MANAGED_INBOX_MARKUP = 1.25;
-export const MANAGED_INBOX_CREDITS_PER_MONTH = { min: 3_000, typical: 3_000, max: 3_000 };
+export const MANAGED_INBOX_MARKUP = SNAPSHOT_MANAGED_INBOX_MARKUP;
+export const MANAGED_INBOX_CREDITS_PER_MONTH = {
+    min: SNAPSHOT_MANAGED_INBOX_CREDITS_PER_MONTH,
+    typical: SNAPSHOT_MANAGED_INBOX_CREDITS_PER_MONTH,
+    max: SNAPSHOT_MANAGED_INBOX_CREDITS_PER_MONTH,
+};
 /**
  * VOICE (the call channel). Marked up 5×, not the 1.25× infra rule the inbox and
  * domain rails use: a phone number carries ongoing reputation work (warm-up,
@@ -68,20 +94,13 @@ export const MANAGED_INBOX_CREDITS_PER_MONTH = { min: 3_000, typical: 3_000, max
  *                                       $0.0180 / min
  * Costing only the outbound leg undercharges every call by 29%.
  */
-export const VOICE_MARKUP = 5;
-/**
- * Flat $5.00/mo per number (founder decision 2026-07-26). Twilio's US/CA local
- * DID costs $1.15, so this is ~4.3× — priced as a round number rather than a
- * computed markup, the way a customer actually reads a price.
- */
-export const VOICE_NUMBER_CREDITS_PER_MONTH = 5_000;
-/** Both legs, $0.018/min × 5 → $0.09/min. */
-export const VOICE_CREDITS_PER_MINUTE = 90;
-/** Answering-machine detection is per CALL, not per minute — it bills on no-answers too. */
-export const VOICE_CREDITS_PER_AMD_CALL = 38;
+export const VOICE_MARKUP = SNAPSHOT_VOICE_MARKUP;
+export const VOICE_NUMBER_CREDITS_PER_MONTH = SNAPSHOT_VOICE_NUMBER_CREDITS_PER_MONTH;
+export const VOICE_CREDITS_PER_MINUTE = SNAPSHOT_VOICE_CREDITS_PER_MINUTE;
+export const VOICE_CREDITS_PER_AMD_CALL = SNAPSHOT_VOICE_CREDITS_PER_AMD_CALL;
 /** Managed domains: registrar at-cost × 1.25 (≈ a $10.44 .com → ~13,050 credits/yr). */
-export const MANAGED_DOMAIN_MARKUP = 1.25;
-export const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = 13_050;
+export const MANAGED_DOMAIN_MARKUP = SNAPSHOT_MANAGED_DOMAIN_MARKUP;
+export const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = SNAPSHOT_MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL;
 /**
  * Inbox deliverability (EmailGuard placement seat). A flat monthly price per
  * SUBSCRIBED inbox covering continuous deliverability monitoring (blacklist,
@@ -89,18 +108,6 @@ export const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = 13_050;
  * inbox-placement (spam) tests; tests beyond the allowance bill the per-test
  * price.
  *
- * All three are DISPLAY mirrors, per this file's contract. The canonical values
- * live where they are enforced, and seed-parity.test.ts binds them so a mirror
- * can never quietly drift from the number actually billed:
- *   seat      DELIVERABILITY_UNIT_MONTHLY_CREDITS       (@oxygen/control-db,
- *             also PRICING_SEED commitment.deliverability_unit) — 1,000 credits
- *             ($1.00), restored by the founder on 2026-07-30 after reviewing the
- *             Agency-plan unit economics, superseding the 2026-07-26 signature
- *             of 2,000.
- *   allowance DELIVERABILITY_INCLUDED_TESTS_PER_INBOX  (@oxygen/control-db)
- *   overage   EMAILGUARD_MANAGED_PLACEMENT_CREDITS     (@oxygen/providers,
- *             derived from the Agency plan rather than typed in)
- *
  * THE ALLOWANCE IS LOAD-BEARING, not a perk. Placement COGS is per TEST
  * ($0.1327 on EmailGuard's Agency plan), not per inbox, so an unbounded seat
  * inverts its own margin: at $1.00/inbox-month the EIGHTH test in a cycle is
@@ -108,54 +115,40 @@ export const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = 13_050;
  * revenue — a ~73% margin — and everything past them bills
  * PLACEMENT_TEST_OVERAGE_CREDITS. Orgs on their own EmailGuard key (BYOK) pay 0.
  */
-export const DELIVERABILITY_SEAT_CREDITS_PER_MONTH = 1_000;
-export const DELIVERABILITY_INCLUDED_TESTS_PER_INBOX = 2;
-/** Overage placement test: $0.1327 EmailGuard COGS × 1.25, rounded up. */
-export const PLACEMENT_TEST_OVERAGE_CREDITS = 166;
+export const DELIVERABILITY_SEAT_CREDITS_PER_MONTH = SNAPSHOT_DELIVERABILITY_SEAT_CREDITS_PER_MONTH;
+export const DELIVERABILITY_INCLUDED_TESTS_PER_INBOX = SNAPSHOT_DELIVERABILITY_INCLUDED_TESTS_PER_INBOX;
+export const PLACEMENT_TEST_OVERAGE_CREDITS = SNAPSHOT_PLACEMENT_TEST_OVERAGE_CREDITS;
 /**
  * LinkedIn accounts: founder decision (2026-07-25) — a PURE seat model. The
- * flat monthly connection fee per connected account is now the WHOLE LinkedIn
- * price (10,000 credits, up from the 7,000-credit 2026-07-14 Pricing Model 2.0
- * figure); every per-action charge below is 0. Per-MESSAGE sends on email and
- * WhatsApp stay 0 too — but a connected WhatsApp NUMBER carries its own monthly
+ * flat monthly connection fee per connected account is the WHOLE LinkedIn
+ * price; every per-action charge is 0. Per-MESSAGE sends on email and WhatsApp
+ * stay 0 too — but a connected WhatsApp NUMBER carries its own monthly
  * connection fee, see WHATSAPP_ACCOUNT_CREDITS_PER_MONTH.
  */
-export const LINKEDIN_ACCOUNT_CREDITS_PER_MONTH = 10_000;
-export const LINKEDIN_ACTION_CREDITS = {
-    visit_profile: 0,
-    invite: 0,
-    message: 0,
-    inmail: 0,
-    follow: 0,
-    like_post: 0,
-    comment_post: 0,
-};
-/**
- * Editable calculator default: a warmed account's typical monthly action mix.
- * 0 under the pure seat model (2026-07-25) — actions no longer add to the
- * LinkedIn line regardless of volume, so this default carries no credits.
- * Kept (not deleted) because PRICING_CALCULATOR_DEFAULTS.linkedinActionCreditsPerAccount
- * still reads it as its default value.
- */
-export const LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH = 0;
+export const LINKEDIN_ACCOUNT_CREDITS_PER_MONTH = SNAPSHOT_LINKEDIN_ACCOUNT_CREDITS_PER_MONTH;
+export const LINKEDIN_ACTION_CREDITS = SNAPSHOT_LINKEDIN_ACTION_CREDITS;
+export const LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH = SNAPSHOT_LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH;
 /**
  * WhatsApp numbers: flat monthly connection fee per connected number, the same
- * seat shape as LinkedIn ($10 × 1,000 credits/$). Billed off the rolling-30d peak,
- * so a number connected part-way through a month still bills the full cycle.
- * WhatsApp message sends themselves remain 0 credits.
+ * seat shape as LinkedIn. Billed off the rolling-30d peak, so a number connected
+ * part-way through a month still bills the full cycle. WhatsApp message sends
+ * themselves remain 0 credits.
  */
-export const WHATSAPP_ACCOUNT_CREDITS_PER_MONTH = 10_000;
+export const WHATSAPP_ACCOUNT_CREDITS_PER_MONTH = SNAPSHOT_WHATSAPP_ACCOUNT_CREDITS_PER_MONTH;
 /** Dedicated egress IP add-on. */
-export const EGRESS_IP_CREDITS_PER_MONTH = 15_000;
+export const EGRESS_IP_CREDITS_PER_MONTH = SNAPSHOT_EGRESS_IP_CREDITS_PER_MONTH;
 /**
  * Email + WhatsApp sends cost nothing per message — the pool pays for inboxes and
  * connected accounts, not for sends.
  */
-export const SEND_CREDITS = 0;
+export const SEND_CREDITS = SNAPSHOT_SEND_CREDITS;
 /**
  * Representative enrichment prices (5× provider COGS via the resolver; the
  * live per-operation table is served by /api/pricing/customer-credit-prices).
  * "typical" = the cheap-first waterfall's common case, used by the calculator.
+ *
+ * Resolver-derived, like AI_COLUMN_CREDITS: these mirror cogs-rates.ts, not the
+ * pricing seed.
  */
 export const ENRICHMENT_CREDITS = {
     email_verify: 2.245, // MillionVerifier first pass (exactly 5x COGS)
@@ -167,10 +160,4 @@ export const ENRICHMENT_CREDITS = {
     linkedin_profile_scrape: 25.5, // HarvestAPI Basic full-profile job, exactly 5x COGS
 };
 /** Editable calculator default: blended credits per fully-enriched row. */
-export const ENRICHMENT_CREDITS_PER_ROW_TYPICAL = 100;
-export function creditsToUsd(credits) {
-    return credits / PRICING_CREDITS_PER_USD;
-}
-export function usdToCredits(usd) {
-    return usd * PRICING_CREDITS_PER_USD;
-}
+export const ENRICHMENT_CREDITS_PER_ROW_TYPICAL = SNAPSHOT_ENRICHMENT_CREDITS_PER_ROW_TYPICAL;

package/node_modules/@oxygen/shared/dist/pricing-snapshot.generated.d.ts

@@ -0,0 +1,62 @@
+/** Period the customer-facing price sheet was last reconciled end to end. */
+export declare const PRICE_SHEET_VERIFIED = "2026-07";
+/** $1 = 1_000 credits (Pricing Model 2.0). */
+export declare const CREDITS_PER_USD = 1000;
+/** The divisor in the markup formula; exact inverse of CREDITS_PER_USD. */
+export declare const CREDIT_USD_VALUE = 0.001;
+/** On-demand top-up, in USD cents per 1,000 credits. */
+export declare const TOPUP_USD_CENTS_PER_1K_CREDITS = 125;
+/** On-demand top-up price per 1,000 credits, in USD. */
+export declare const TOPUP_USD_PER_1K = 1.25;
+/** Subscription credits convert at face value, making them exactly 20% cheaper. */
+export declare const SUBSCRIPTION_USD_PER_1K = 1;
+export declare const MANAGED_INBOX_MARKUP = 1.25;
+export declare const MANAGED_DOMAIN_MARKUP = 1.25;
+export declare const VOICE_MARKUP = 5;
+/** Applied to actual provider inference cost at settle time. */
+export declare const COPILOT_CREDIT_MARKUP_MULTIPLIER = 5;
+export declare const LINKEDIN_ACCOUNT_CREDITS_PER_MONTH = 10000;
+export declare const WHATSAPP_ACCOUNT_CREDITS_PER_MONTH = 10000;
+export declare const EGRESS_IP_CREDITS_PER_MONTH = 25000;
+export declare const SENDING_MAILBOX_CREDITS_PER_MONTH = 1000;
+export declare const MANAGED_INBOX_CREDITS_PER_MONTH = 3000;
+export declare const MAILBOX_WARMUP_CREDITS_PER_MONTH = 3000;
+export declare const DELIVERABILITY_SEAT_CREDITS_PER_MONTH = 1000;
+/** Included inbox-placement tests per subscribed inbox per cycle. */
+export declare const DELIVERABILITY_INCLUDED_TESTS_PER_INBOX = 2;
+/** A placement test beyond the included allowance. */
+export declare const PLACEMENT_TEST_OVERAGE_CREDITS = 166;
+/** Representative, not billed: a typical .com at MANAGED_DOMAIN_MARKUP. */
+export declare const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = 13050;
+export declare const VOICE_NUMBER_CREDITS_PER_MONTH = 5000;
+export declare const VOICE_CREDITS_PER_MINUTE = 90;
+export declare const VOICE_CREDITS_PER_AMD_CALL = 38;
+/** Workflow steps, tool calls and row writes — a capacity guard, not a margin line. */
+export declare const AUTOMATION_ACTION_CREDITS = 0.01;
+/** Email, LinkedIn and WhatsApp sends are free; the pool pays for seats and inboxes. */
+export declare const SEND_CREDITS = 0;
+/** Every LinkedIn action is 0 under the pure seat model. */
+export declare const LINKEDIN_ACTION_CREDITS: {
+    readonly visit_profile: 0;
+    readonly invite: 0;
+    readonly message: 0;
+    readonly inmail: 0;
+    readonly follow: 0;
+    readonly like_post: 0;
+    readonly comment_post: 0;
+};
+export declare const ENRICHMENT_CREDITS_PER_ROW_TYPICAL = 100;
+export declare const LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH = 0;
+export type PricingPlanSnapshot = {
+    readonly planKey: string;
+    readonly tier: string;
+    readonly isLegacy: boolean;
+    readonly monthlyPriceCents: number | null;
+    readonly monthlyCredits: number | null;
+    readonly weeklyCreditsLimit: number | null;
+    readonly rolloverCap: number | null;
+    readonly byokEnabled: boolean;
+};
+export declare const PRICING_PLAN_SNAPSHOT: readonly PricingPlanSnapshot[];
+export declare function creditsToUsd(credits: number): number;
+export declare function usdToCredits(usd: number): number;

package/node_modules/@oxygen/shared/dist/pricing-snapshot.generated.js

@@ -0,0 +1,91 @@
+// GENERATED FROM packages/control-db/src/pricing/seed.ts — DO NOT HAND-EDIT.
+//
+// Regenerate with `npm run pricing:snapshot`. CI runs
+// `npm run pricing:snapshot -- --check` and fails when this file and the seed
+// disagree, so a hand-edit here is reverted rather than shipped.
+//
+// To change a price, edit the SEED. This file is a rendering of it, kept for the
+// consumers that cannot query the control DB: @oxygen/shared (no @oxygen/*
+// dependencies by design), the "use client" marketing and in-product components,
+// and module-level catalogs built at import time.
+//
+// Everything that CAN await a query reads the database instead, via
+// loadPricingBook() — a staff re-price at /admin/costs moves those with no deploy
+// and does NOT move this file.
+/** Period the customer-facing price sheet was last reconciled end to end. */
+export const PRICE_SHEET_VERIFIED = "2026-07";
+// --- conversion -------------------------------------------------------------
+/** $1 = 1_000 credits (Pricing Model 2.0). */
+export const CREDITS_PER_USD = 1_000;
+/** The divisor in the markup formula; exact inverse of CREDITS_PER_USD. */
+export const CREDIT_USD_VALUE = 0.001;
+/** On-demand top-up, in USD cents per 1,000 credits. */
+export const TOPUP_USD_CENTS_PER_1K_CREDITS = 125;
+/** On-demand top-up price per 1,000 credits, in USD. */
+export const TOPUP_USD_PER_1K = 1.25;
+/** Subscription credits convert at face value, making them exactly 20% cheaper. */
+export const SUBSCRIPTION_USD_PER_1K = 1;
+// --- markups ----------------------------------------------------------------
+export const MANAGED_INBOX_MARKUP = 1.25;
+export const MANAGED_DOMAIN_MARKUP = 1.25;
+export const VOICE_MARKUP = 5;
+/** Applied to actual provider inference cost at settle time. */
+export const COPILOT_CREDIT_MARKUP_MULTIPLIER = 5;
+// --- seats and recurring charges --------------------------------------------
+export const LINKEDIN_ACCOUNT_CREDITS_PER_MONTH = 10_000;
+export const WHATSAPP_ACCOUNT_CREDITS_PER_MONTH = 10_000;
+export const EGRESS_IP_CREDITS_PER_MONTH = 25_000;
+export const SENDING_MAILBOX_CREDITS_PER_MONTH = 1_000;
+export const MANAGED_INBOX_CREDITS_PER_MONTH = 3_000;
+export const MAILBOX_WARMUP_CREDITS_PER_MONTH = 3_000;
+export const DELIVERABILITY_SEAT_CREDITS_PER_MONTH = 1_000;
+/** Included inbox-placement tests per subscribed inbox per cycle. */
+export const DELIVERABILITY_INCLUDED_TESTS_PER_INBOX = 2;
+/** A placement test beyond the included allowance. */
+export const PLACEMENT_TEST_OVERAGE_CREDITS = 166;
+/** Representative, not billed: a typical .com at MANAGED_DOMAIN_MARKUP. */
+export const MANAGED_DOMAIN_CREDITS_PER_YEAR_TYPICAL = 13_050;
+// --- voice ------------------------------------------------------------------
+export const VOICE_NUMBER_CREDITS_PER_MONTH = 5_000;
+export const VOICE_CREDITS_PER_MINUTE = 90;
+export const VOICE_CREDITS_PER_AMD_CALL = 38;
+// --- per-action -------------------------------------------------------------
+/** Workflow steps, tool calls and row writes — a capacity guard, not a margin line. */
+export const AUTOMATION_ACTION_CREDITS = 0.01;
+/** Email, LinkedIn and WhatsApp sends are free; the pool pays for seats and inboxes. */
+export const SEND_CREDITS = 0;
+/** Every LinkedIn action is 0 under the pure seat model. */
+export const LINKEDIN_ACTION_CREDITS = {
+    visit_profile: 0,
+    invite: 0,
+    message: 0,
+    inmail: 0,
+    follow: 0,
+    like_post: 0,
+    comment_post: 0,
+};
+// --- pricing-calculator defaults (not prices) -------------------------------
+export const ENRICHMENT_CREDITS_PER_ROW_TYPICAL = 100;
+export const LINKEDIN_TYPICAL_ACTIONS_CREDITS_PER_MONTH = 0;
+export const PRICING_PLAN_SNAPSHOT = [
+    { planKey: "free", tier: "free", isLegacy: false, monthlyPriceCents: 0, monthlyCredits: 0, weeklyCreditsLimit: null, rolloverCap: null, byokEnabled: false },
+    { planKey: "starter", tier: "starter", isLegacy: false, monthlyPriceCents: 9_900, monthlyCredits: 99_000, weeklyCreditsLimit: null, rolloverCap: 99_000, byokEnabled: true },
+    { planKey: "pro", tier: "pro", isLegacy: false, monthlyPriceCents: 24_900, monthlyCredits: 249_000, weeklyCreditsLimit: null, rolloverCap: 249_000, byokEnabled: true },
+    { planKey: "team", tier: "team", isLegacy: false, monthlyPriceCents: 74_900, monthlyCredits: 749_000, weeklyCreditsLimit: null, rolloverCap: 749_000, byokEnabled: true },
+    { planKey: "scale", tier: "scale", isLegacy: false, monthlyPriceCents: null, monthlyCredits: 10_000_000, weeklyCreditsLimit: null, rolloverCap: 10_000_000, byokEnabled: true },
+    { planKey: "enterprise", tier: "enterprise", isLegacy: false, monthlyPriceCents: null, monthlyCredits: null, weeklyCreditsLimit: null, rolloverCap: null, byokEnabled: true },
+    { planKey: "launch_50", tier: "starter", isLegacy: true, monthlyPriceCents: 5_000, monthlyCredits: 200_000, weeklyCreditsLimit: 200_000, rolloverCap: 200_000, byokEnabled: true },
+    { planKey: "starter_50", tier: "starter", isLegacy: true, monthlyPriceCents: 5_000, monthlyCredits: 200_000, weeklyCreditsLimit: 200_000, rolloverCap: 200_000, byokEnabled: true },
+    { planKey: "pro_149", tier: "pro", isLegacy: true, monthlyPriceCents: 14_900, monthlyCredits: 1_000_000, weeklyCreditsLimit: 1_000_000, rolloverCap: 1_000_000, byokEnabled: true },
+    { planKey: "team_399", tier: "team", isLegacy: true, monthlyPriceCents: 39_900, monthlyCredits: 3_000_000, weeklyCreditsLimit: 3_000_000, rolloverCap: 3_000_000, byokEnabled: true },
+    { planKey: "growth_250", tier: "pro", isLegacy: true, monthlyPriceCents: 25_000, monthlyCredits: 250_000, weeklyCreditsLimit: 100_000, rolloverCap: 250_000, byokEnabled: true },
+    { planKey: "scale_750", tier: "team", isLegacy: true, monthlyPriceCents: 75_000, monthlyCredits: 750_000, weeklyCreditsLimit: 300_000, rolloverCap: 750_000, byokEnabled: true },
+    { planKey: "starter_legacy", tier: "starter", isLegacy: true, monthlyPriceCents: null, monthlyCredits: 200_000, weeklyCreditsLimit: null, rolloverCap: 200_000, byokEnabled: true },
+    { planKey: "scale_legacy", tier: "scale", isLegacy: true, monthlyPriceCents: null, monthlyCredits: 1_200_000, weeklyCreditsLimit: null, rolloverCap: 2_400_000, byokEnabled: true },
+];
+export function creditsToUsd(credits) {
+    return credits / CREDITS_PER_USD;
+}
+export function usdToCredits(usd) {
+    return usd * CREDITS_PER_USD;
+}

package/node_modules/@oxygen/shared/dist/provider-funding-errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * One vocabulary for "the provider refused because of money".
+ *
+ * A provider 402 has reached customers wearing four different costumes:
+ *   - `provider_credits_exhausted`        (tool runner, managed pool)
+ *   - `connection_credits_exhausted`      (tool runner, BYOK connection)
+ *   - `provider_insufficient_credits`     (enrichment column runner + waterfall)
+ *   - `provider_credit_exhausted`         (worker lane exclusion, singular)
+ * plus `provider_plan_limit` for the adjacent "your plan does not include this"
+ * refusal, which is also a money problem and also not retryable.
+ *
+ * Only the first two were known to the run-bottleneck classifier. The others
+ * fell through to a `/rate|limit|429/` test — which `provider_plan_limit`
+ * matches on the substring "limit" — or to the deferral branch, so a hard 402
+ * surfaced to the customer as `bottlenecks: [provider_rate_limit]`. That reads
+ * as "wait and retry": a partner agency spent hours lowering concurrency against
+ * an account that was simply out of credits, and the real 402 was only visible
+ * through a different command.
+ *
+ * The distinction that matters operationally: a rate limit clears by waiting, a
+ * funding failure never does. Anything that decides "should the customer wait?"
+ * must ask this predicate, not a regex over the code string.
+ */
+/** Codes meaning the provider refused for funding/entitlement reasons. Never retryable by waiting. */
+export declare const PROVIDER_FUNDING_ERROR_CODES: readonly ["provider_credits_exhausted", "provider_credits_exhausted_deferred", "connection_credits_exhausted", "provider_insufficient_credits", "provider_credit_exhausted", "provider_plan_limit", "blocked_provider_funding"];
+export type ProviderFundingErrorCode = (typeof PROVIDER_FUNDING_ERROR_CODES)[number];
+/**
+ * True when the code means "this failed over money", in any of its spellings.
+ *
+ * Matches on the exact code first, then falls back to a narrow shape test so a
+ * provider-specific variant (`peopledatalabs_credits_exhausted`) is still
+ * classified as funding rather than silently treated as retryable. Deliberately
+ * does NOT match on "limit" alone — `rate_limit_exceeded` is a real rate limit.
+ */
+export declare function isProviderFundingErrorCode(code: string | null | undefined): boolean;
+/**
+ * True for a genuine rate limit — one that clears by waiting.
+ *
+ * A funding failure always wins: `provider_plan_limit` contains "limit" and
+ * would otherwise read as retryable.
+ */
+export declare function isProviderRateLimitErrorCode(code: string | null | undefined): boolean;
+/** The customer-facing next step for a funding refusal, by credential ownership. */
+export declare function providerFundingNextStep(credentialMode: "managed" | "byok" | null | undefined): string;