@oxygen-agent/cli 1.354.0 → 1.365.3

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

@@ -28,6 +28,12 @@ export type PricingPlanMetadata = Record<string, unknown> | null | undefined;
 export declare const CONTACT_SALES_URL = "https://cal.com/tim-scheuer-mxbib9/45";
 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 = 200000;
+export declare const CREDIT_TOPUP_STEP_CREDITS = 1000;
+export declare const CREDIT_TOPUP_DEFAULT_CREDITS = 20000;
+export declare function isValidCreditTopupCredits(credits: number): boolean;
+export declare function creditTopupUsdCents(credits: number): number | null;
 export declare const AUTOMATION_ACTION_CREDITS = 0.01;
 export declare const CREDIT_TOPUP_PACKS: readonly [{
     readonly id: "10";
@@ -57,7 +63,7 @@ export declare const BASE_PRICING_PLANS: {
         readonly name: "Free";
         readonly monthlyPriceCents: 0;
         readonly monthlyCredits: 10000;
-        readonly weeklyCreditsLimit: 10000;
+        readonly weeklyCreditsLimit: null;
         readonly rolloverCap: 10000;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
@@ -65,14 +71,14 @@ export declare const BASE_PRICING_PLANS: {
         readonly byokEnabled: false;
         readonly description: "Get $10 in credits on us every month — try OXYGEN with managed email, phone enrichment, and AI credits.";
         readonly ctaLabel: "Start free";
-        readonly features: readonly ["$10 in credits every month", "Automation actions at 0.01 credits each", "All integrations", "Workflows", "No card required"];
+        readonly features: readonly ["$10 in credits every month", "All integrations", "Workflows", "No card required"];
     };
     readonly starter: {
         readonly tier: "starter";
         readonly name: "Starter";
         readonly monthlyPriceCents: 9900;
         readonly monthlyCredits: 99000;
-        readonly weeklyCreditsLimit: 40000;
+        readonly weeklyCreditsLimit: null;
         readonly rolloverCap: 99000;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
@@ -80,14 +86,14 @@ export declare const BASE_PRICING_PLANS: {
         readonly byokEnabled: true;
         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 — automation actions at 0.01 credits each", "Bring your own keys", "Standard support"];
+        readonly features: readonly ["99,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Standard support"];
     };
     readonly pro: {
         readonly tier: "pro";
         readonly name: "Pro";
         readonly monthlyPriceCents: 24900;
         readonly monthlyCredits: 249000;
-        readonly weeklyCreditsLimit: 100000;
+        readonly weeklyCreditsLimit: null;
         readonly rolloverCap: 249000;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
@@ -97,14 +103,14 @@ 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 — automation actions at 0.01 credits each", "Bring your own keys", "Standard support"];
+        readonly features: readonly ["249,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Standard support"];
     };
     readonly team: {
         readonly tier: "team";
         readonly name: "Team";
         readonly monthlyPriceCents: 74900;
         readonly monthlyCredits: 749000;
-        readonly weeklyCreditsLimit: 300000;
+        readonly weeklyCreditsLimit: null;
         readonly rolloverCap: 749000;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
@@ -112,14 +118,14 @@ export declare const BASE_PRICING_PLANS: {
         readonly byokEnabled: true;
         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 — automation actions at 0.01 credits each", "Bring your own keys", "Premium support"];
+        readonly features: readonly ["749,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Premium support"];
     };
     readonly scale: {
         readonly tier: "scale";
         readonly name: "Scale";
         readonly monthlyPriceCents: null;
         readonly monthlyCredits: 10000000;
-        readonly weeklyCreditsLimit: 10000000;
+        readonly weeklyCreditsLimit: null;
         readonly rolloverCap: 10000000;
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
@@ -128,7 +134,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: "https://cal.com/tim-scheuer-mxbib9/45";
-        readonly features: readonly ["10,000,000+ managed credits / month", "Automation actions at 0.01 credits each", "Phone number enrichment on managed credits", "Custom provider routing and BYOK policies", "Dedicated onboarding"];
+        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 enterprise: {
         readonly tier: "enterprise";
@@ -152,6 +158,22 @@ export declare const SELF_SERVE_PLAN_TIERS: readonly SelfServePlanTier[];
 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];
+export declare const BILLING_VISIBLE_SUBSCRIPTION_STATUSES: readonly ["active", "trialing", "past_due", "unpaid", "paused", "incomplete"];
+export type BillingVisibleSubscriptionStatus = (typeof BILLING_VISIBLE_SUBSCRIPTION_STATUSES)[number];
+export declare const PAST_DUE_GRACE_DAYS = 7;
+export type SubscriptionEntitlementReason = "active" | "trialing" | "past_due_grace" | "past_due_grace_expired" | "missing_past_due_period_start" | "trial_expired" | "missing_trial_end" | "unpaid" | "paused" | "incomplete" | "canceled" | "incomplete_expired" | "missing_subscription";
+export type SubscriptionEntitlement = {
+    entitled: boolean;
+    reason: SubscriptionEntitlementReason;
+    graceEndsAt: Date | null;
+};
+export declare function resolveSubscriptionEntitlement(input: {
+    status: string | null | undefined;
+    currentPeriodStart?: Date | null;
+    currentPeriodEnd?: Date | null;
+    trialEnd?: Date | null;
+    now?: Date;
+}): SubscriptionEntitlement;
 export type ResolvedPricingPlan = PricingPlanDefinition;
 export declare function resolveBasePricingPlan(tier: string | null | undefined): ResolvedPricingPlan | null;
 export declare function applyPricingPlanMetadataOverrides(// skipcq: JS-R1005

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

@@ -9,6 +9,23 @@ export const CONTACT_SALES_URL = "https://cal.com/tim-scheuer-mxbib9/45";
 // credits bought on demand.
 export const CREDITS_PER_USD = 1_000;
 export const TOPUP_USD_CENTS_PER_1K_CREDITS = 125;
+// Keep on-demand purchases inside the same $10-$250 spend envelope as the
+// original fixed packs, but let customers choose any 1,000-credit increment.
+export const CREDIT_TOPUP_MIN_CREDITS = 8_000;
+export const CREDIT_TOPUP_MAX_CREDITS = 200_000;
+export const CREDIT_TOPUP_STEP_CREDITS = 1_000;
+export const CREDIT_TOPUP_DEFAULT_CREDITS = 20_000;
+export function isValidCreditTopupCredits(credits) {
+    return Number.isInteger(credits)
+        && credits >= CREDIT_TOPUP_MIN_CREDITS
+        && credits <= CREDIT_TOPUP_MAX_CREDITS
+        && credits % CREDIT_TOPUP_STEP_CREDITS === 0;
+}
+export function creditTopupUsdCents(credits) {
+    if (!isValidCreditTopupCredits(credits))
+        return null;
+    return (credits / 1_000) * TOPUP_USD_CENTS_PER_1K_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
 // monthly action allowance + USD overage meter economy is retired (2026-07-14).
@@ -36,7 +53,7 @@ export const BASE_PRICING_PLANS = {
         name: "Free",
         monthlyPriceCents: 0,
         monthlyCredits: 10_000,
-        weeklyCreditsLimit: 10_000,
+        weeklyCreditsLimit: null,
         rolloverCap: 10_000,
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -46,7 +63,6 @@ export const BASE_PRICING_PLANS = {
         ctaLabel: "Start free",
         features: [
             "$10 in credits every month",
-            "Automation actions at 0.01 credits each",
             "All integrations",
             "Workflows",
             "No card required",
@@ -57,7 +73,7 @@ export const BASE_PRICING_PLANS = {
         name: "Starter",
         monthlyPriceCents: 9_900,
         monthlyCredits: 99_000,
-        weeklyCreditsLimit: 40_000,
+        weeklyCreditsLimit: null,
         rolloverCap: 99_000,
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -68,7 +84,7 @@ export const BASE_PRICING_PLANS = {
         features: [
             "99,000 credits every month",
             "All integrations",
-            "Workflows — automation actions at 0.01 credits each",
+            "Workflows",
             "Bring your own keys",
             "Standard support",
         ],
@@ -78,7 +94,7 @@ export const BASE_PRICING_PLANS = {
         name: "Pro",
         monthlyPriceCents: 24_900,
         monthlyCredits: 249_000,
-        weeklyCreditsLimit: 100_000,
+        weeklyCreditsLimit: null,
         rolloverCap: 249_000,
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -91,7 +107,7 @@ export const BASE_PRICING_PLANS = {
         features: [
             "249,000 credits every month",
             "All integrations",
-            "Workflows — automation actions at 0.01 credits each",
+            "Workflows",
             "Bring your own keys",
             "Standard support",
         ],
@@ -101,7 +117,7 @@ export const BASE_PRICING_PLANS = {
         name: "Team",
         monthlyPriceCents: 74_900,
         monthlyCredits: 749_000,
-        weeklyCreditsLimit: 300_000,
+        weeklyCreditsLimit: null,
         rolloverCap: 749_000,
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -112,7 +128,7 @@ export const BASE_PRICING_PLANS = {
         features: [
             "749,000 credits every month",
             "All integrations",
-            "Workflows — automation actions at 0.01 credits each",
+            "Workflows",
             "Bring your own keys",
             "Premium support",
         ],
@@ -122,7 +138,7 @@ export const BASE_PRICING_PLANS = {
         name: "Scale",
         monthlyPriceCents: null,
         monthlyCredits: 10_000_000,
-        weeklyCreditsLimit: 10_000_000,
+        weeklyCreditsLimit: null,
         rolloverCap: 10_000_000,
         monthlyAutomationActions: null,
         automationOverageCentsPerMillion: null,
@@ -133,7 +149,7 @@ export const BASE_PRICING_PLANS = {
         contactHref: CONTACT_SALES_URL,
         features: [
             "10,000,000+ managed credits / month",
-            "Automation actions at 0.01 credits each",
+            "Workflows",
             "Phone number enrichment on managed credits",
             "Custom provider routing and BYOK policies",
             "Dedicated onboarding",
@@ -181,6 +197,52 @@ export const ACTIVE_SUBSCRIPTION_STATUSES = [
     "trialing",
     "past_due",
 ];
+export const BILLING_VISIBLE_SUBSCRIPTION_STATUSES = [
+    ...ACTIVE_SUBSCRIPTION_STATUSES,
+    "unpaid",
+    "paused",
+    "incomplete",
+];
+export const PAST_DUE_GRACE_DAYS = 7;
+export function resolveSubscriptionEntitlement(input) {
+    const now = input.now ?? new Date();
+    if (!input.status) {
+        return { entitled: false, reason: "missing_subscription", graceEndsAt: null };
+    }
+    if (input.status === "active") {
+        return { entitled: true, reason: "active", graceEndsAt: null };
+    }
+    if (input.status === "trialing") {
+        const trialEnd = input.trialEnd ?? input.currentPeriodEnd ?? null;
+        if (!trialEnd) {
+            return { entitled: false, reason: "missing_trial_end", graceEndsAt: null };
+        }
+        return trialEnd.getTime() <= now.getTime()
+            ? { entitled: false, reason: "trial_expired", graceEndsAt: null }
+            : { entitled: true, reason: "trialing", graceEndsAt: null };
+    }
+    if (input.status === "past_due") {
+        if (!input.currentPeriodStart) {
+            return {
+                entitled: false,
+                reason: "missing_past_due_period_start",
+                graceEndsAt: null,
+            };
+        }
+        const graceEndsAt = new Date(input.currentPeriodStart.getTime() + PAST_DUE_GRACE_DAYS * 24 * 60 * 60 * 1000);
+        return graceEndsAt.getTime() > now.getTime()
+            ? { entitled: true, reason: "past_due_grace", graceEndsAt }
+            : { entitled: false, reason: "past_due_grace_expired", graceEndsAt };
+    }
+    if (input.status === "unpaid"
+        || input.status === "paused"
+        || input.status === "incomplete"
+        || input.status === "canceled"
+        || input.status === "incomplete_expired") {
+        return { entitled: false, reason: input.status, graceEndsAt: null };
+    }
+    return { entitled: false, reason: "missing_subscription", graceEndsAt: null };
+}
 const LEGACY_PRICING_PLAN_OVERRIDES = {
     launch_50: {
         ...BASE_PRICING_PLANS.starter,
@@ -280,6 +342,7 @@ plan, metadata) {
         ?? readString(record, "custom_plan_description");
     const monthlyCredits = readCreditLimit(config, "monthlyCredits", "monthly_credits", "monthly_credit_limit");
     const weeklyCreditsLimit = readCreditLimit(config, "weeklyCreditsLimit", "weekly_credits_limit", "weekly_credit_limit");
+    const weeklyCreditsLimitDisabled = hasExplicitNull(config, "weeklyCreditsLimit", "weekly_credits_limit", "weekly_credit_limit");
     const rolloverCap = readCreditLimit(config, "rolloverCap", "rollover_cap", "rollover_credits");
     const monthlyAutomationActions = readCreditLimit(config, "monthlyAutomationActions", "monthly_automation_actions", "automation_actions", "automation_action_limit");
     const automationOverageCentsPerMillion = readCreditLimit(config, "automationOverageCentsPerMillion", "automation_overage_cents_per_million", "automation_action_overage_cents_per_million");
@@ -292,7 +355,9 @@ plan, metadata) {
         ...plan,
         name: name ?? plan.name,
         monthlyCredits: monthlyCredits ?? plan.monthlyCredits,
-        weeklyCreditsLimit: weeklyCreditsLimit ?? plan.weeklyCreditsLimit,
+        weeklyCreditsLimit: weeklyCreditsLimitDisabled
+            ? null
+            : weeklyCreditsLimit ?? plan.weeklyCreditsLimit,
         rolloverCap: rolloverCap ?? plan.rolloverCap,
         monthlyAutomationActions: monthlyAutomationActions ?? plan.monthlyAutomationActions,
         automationOverageCentsPerMillion: automationOverageCentsPerMillion ?? plan.automationOverageCentsPerMillion,
@@ -339,6 +404,9 @@ function readCreditLimit(record, ...keys) {
     }
     return null;
 }
+function hasExplicitNull(record, ...keys) {
+    return keys.some((key) => Object.hasOwn(record, key) && record[key] === null);
+}
 export function getCurrentFreeTierCycleKey(date = new Date()) {
     const year = date.getUTCFullYear();
     const month = String(date.getUTCMonth() + 1).padStart(2, "0");

package/node_modules/@oxygen/shared/dist/copilot-journeys.d.ts

@@ -0,0 +1,12 @@
+export type CopilotJourney = {
+    slug: string;
+    title: string;
+    description: string;
+    /** Existing catalog recipe slugs this journey leans on (advisory only). */
+    recipeSlugs: readonly string[];
+    /** The first user message a journey card seeds into a new session. */
+    seedMessage: string;
+};
+export declare const COPILOT_JOURNEYS: readonly CopilotJourney[];
+export type CopilotJourneySlug = (typeof COPILOT_JOURNEYS)[number]["slug"];
+export declare function getCopilotJourney(slug: string): CopilotJourney | null;

package/node_modules/@oxygen/shared/dist/copilot-journeys.js

@@ -0,0 +1,36 @@
+// Workspace Copilot guided journeys (ADR 0013 §11). One canonical copy shared by
+// the runtime (system-prompt grounding on the named recipes) and the web journey
+// cards (seeding a session's first message) — the data is pure and client-safe.
+// Each journey is a thin descriptor over EXISTING advisory catalog Recipes:
+// journeys add no runtime behavior, and every guardrail (never enroll/send/buy/
+// change DNS without approval) rides those recipes' own approval gates.
+export const COPILOT_JOURNEYS = [
+    {
+        slug: "inbound-led-outbound",
+        title: "Inbound-led outbound",
+        description: "Turn LinkedIn engagement, profile views, and replies into a segmented outreach motion.",
+        recipeSlugs: [
+            "profile-viewer-outreach",
+            "daily-warm-lead-queue",
+            "reply-to-meeting",
+        ],
+        seedMessage: "Help me turn my recent LinkedIn engagement (profile views, post reactions, replies) into a safe, segmented outreach motion. Start by showing me what signals and connected identities I have.",
+    },
+    {
+        slug: "tam-sourcing",
+        title: "Map your market",
+        description: "Source and segment your addressable market from your ICP, starting with a bounded sample.",
+        recipeSlugs: ["icp-to-account-map", "outbound-pilot-50"],
+        seedMessage: "Help me map my total addressable market from my ICP. Ground it in my company profile and website, source a bounded sample first, and show me coverage and credit estimates before expanding.",
+    },
+    {
+        slug: "email-infra-setup",
+        title: "Outbound infrastructure",
+        description: "Domains, inboxes, warmup, sender posture — reviewed and approved before anything is bought or sent.",
+        recipeSlugs: ["email-infra-setup"],
+        seedMessage: "Inspect my current sending setup (domains, inboxes, warmup, senders, caps, deliverability) and propose what's missing for a safe cold-email motion. Show quotes and costs — do not buy or change anything without my approval.",
+    },
+];
+export function getCopilotJourney(slug) {
+    return COPILOT_JOURNEYS.find((journey) => journey.slug === slug) ?? null;
+}

package/node_modules/@oxygen/shared/dist/hosted-ai.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Canonical hosted-AI model registry — the single source of truth for which
+ * OXYGEN-hosted model backs each reasoning tier of each hosted-AI use case, its
+ * human-readable name, its fallback chain, the OpenRouter reasoning effort to
+ * request, and the conservative pre-call price estimates used ONLY to size
+ * credit reservations (billing always settles on the provider's actual
+ * `usage.cost`, never on the numbers here).
+ *
+ * Two use cases share the registry today:
+ *   - `ai_column` — managed AI table columns. Its default model ids are
+ *     re-sourced verbatim by `@oxygen/integrations` (`ai-column-runner.ts`
+ *     `DEFAULT_REASONING_MODELS`) and `@oxygen/tenant-db` (`ai-models.ts`
+ *     `DEFAULT_MANAGED_REASONING_MODELS`). Those modules keep owning the
+ *     `OXYGEN_OPENROUTER_MODEL_*` env-override resolution; this registry only
+ *     supplies the defaults, so AI-column behavior is byte-for-byte unchanged.
+ *   - `copilot` — the hosted copilot. Its model + fallback chain accept Doppler
+ *     overrides (`OXYGEN_COPILOT_MODEL_*` / `OXYGEN_COPILOT_FALLBACK_*`) applied
+ *     here by `resolveHostedAiModel`.
+ *
+ * Kept as a leaf module (mirrors ./pricing-sheet.ts): no imports, so any package
+ * can re-source the catalog without dragging in the shared barrel.
+ */
+export type HostedAiLevel = "low" | "medium" | "high";
+export type HostedAiUseCase = "ai_column" | "copilot";
+export type HostedAiModelSpec = {
+    /** OpenRouter model id, e.g. "deepseek/deepseek-v4-flash". */
+    model: string;
+    /** Human-readable label for dashboards/UI. */
+    displayName: string;
+    /** Ordered fallback model ids tried when `model` is unavailable. */
+    fallbackModels: readonly string[];
+    /**
+     * OpenRouter reasoning effort to request; omit entirely for models that only
+     * support their max mode (Kimi K3) — the request builder sends no reasoning
+     * param for those.
+     */
+    reasoningEffort?: "low" | "medium" | "high";
+    /**
+     * Conservative pre-call estimation prices (USD per 1M tokens). Billing settles
+     * on actual `usage.cost`; these ONLY size credit reservations.
+     */
+    estPromptUsdPerM: number;
+    estCompletionUsdPerM: number;
+    /** Upper bound on completion tokens requested for this tier. */
+    maxOutputTokens: number;
+};
+export declare const HOSTED_AI_MODEL_REGISTRY: Record<HostedAiUseCase, Record<HostedAiLevel, HostedAiModelSpec>>;
+/** The reasoning tier the hosted copilot runs at by default. */
+export declare const COPILOT_DEFAULT_LEVEL: HostedAiLevel;
+/**
+ * Resolve the model spec for a hosted-AI use case + reasoning level.
+ *
+ * For `copilot`, Doppler overrides are applied here:
+ *   - `OXYGEN_COPILOT_MODEL_{LOW,MEDIUM,HIGH}` replaces `.model` (and, since no
+ *     separate label is supplied, `.displayName` falls back to the model id).
+ *   - `OXYGEN_COPILOT_FALLBACK_{LOW,MEDIUM,HIGH}` replaces `.fallbackModels`
+ *     from a comma-separated list.
+ *
+ * For `ai_column`, NO env handling is applied here: `@oxygen/integrations`
+ * `ai-column-runner.ts` (`resolveModel`/`resolveAiColumnTierModels`) and
+ * `@oxygen/tenant-db` `ai-models.ts` (`resolveManagedReasoningModels`) remain
+ * the sole owners of `OXYGEN_OPENROUTER_MODEL_*` resolution, so the AI-column
+ * path is untouched.
+ */
+/**
+ * Look a model id up across the priced registry (same-use-case tiers first).
+ * A session-level model override must land on a spec that carries ITS OWN
+ * pricing/limits — splicing an arbitrary id onto another tier's spec sizes the
+ * credit reservation for the wrong model and breaks the spend ceiling.
+ */
+export declare function findHostedAiModelSpec(model: string, preferredUseCase?: HostedAiUseCase): HostedAiModelSpec | null;
+export declare function resolveHostedAiModel(input: {
+    useCase: HostedAiUseCase;
+    level: HostedAiLevel;
+    env?: Record<string, string | undefined>;
+}): HostedAiModelSpec;
+/**
+ * Convenience map of each reasoning tier's default `.model` id for a use case.
+ * `@oxygen/integrations` and `@oxygen/tenant-db` re-source their AI-column
+ * default catalogs from `hostedAiDefaultModels("ai_column")` so the model ids
+ * live in exactly one place. Returns a fresh object each call.
+ */
+export declare function hostedAiDefaultModels(useCase: HostedAiUseCase): Record<HostedAiLevel, string>;
+/**
+ * Whether the hosted copilot is enabled for this environment. FAIL CLOSED: only
+ * the exact strings "1" or "true" (case-insensitive, trimmed) enable it;
+ * anything else — unset, "", "0", "false" — leaves it off.
+ */
+export declare function isCopilotEnabled(env?: Record<string, string | undefined>): boolean;

package/node_modules/@oxygen/shared/dist/hosted-ai.js

@@ -0,0 +1,182 @@
+/**
+ * Canonical hosted-AI model registry — the single source of truth for which
+ * OXYGEN-hosted model backs each reasoning tier of each hosted-AI use case, its
+ * human-readable name, its fallback chain, the OpenRouter reasoning effort to
+ * request, and the conservative pre-call price estimates used ONLY to size
+ * credit reservations (billing always settles on the provider's actual
+ * `usage.cost`, never on the numbers here).
+ *
+ * Two use cases share the registry today:
+ *   - `ai_column` — managed AI table columns. Its default model ids are
+ *     re-sourced verbatim by `@oxygen/integrations` (`ai-column-runner.ts`
+ *     `DEFAULT_REASONING_MODELS`) and `@oxygen/tenant-db` (`ai-models.ts`
+ *     `DEFAULT_MANAGED_REASONING_MODELS`). Those modules keep owning the
+ *     `OXYGEN_OPENROUTER_MODEL_*` env-override resolution; this registry only
+ *     supplies the defaults, so AI-column behavior is byte-for-byte unchanged.
+ *   - `copilot` — the hosted copilot. Its model + fallback chain accept Doppler
+ *     overrides (`OXYGEN_COPILOT_MODEL_*` / `OXYGEN_COPILOT_FALLBACK_*`) applied
+ *     here by `resolveHostedAiModel`.
+ *
+ * Kept as a leaf module (mirrors ./pricing-sheet.ts): no imports, so any package
+ * can re-source the catalog without dragging in the shared barrel.
+ */
+export const HOSTED_AI_MODEL_REGISTRY = {
+    ai_column: {
+        low: {
+            model: "deepseek/deepseek-v4-flash",
+            displayName: "DeepSeek V4 Flash",
+            fallbackModels: [],
+            estPromptUsdPerM: 0.09,
+            estCompletionUsdPerM: 0.18,
+            maxOutputTokens: 4096,
+        },
+        medium: {
+            model: "deepseek/deepseek-v4-pro",
+            displayName: "DeepSeek V4 Pro",
+            fallbackModels: [],
+            estPromptUsdPerM: 0.435,
+            estCompletionUsdPerM: 0.87,
+            maxOutputTokens: 4096,
+        },
+        high: {
+            model: "moonshotai/kimi-k2.6",
+            displayName: "Kimi K2.6",
+            fallbackModels: [],
+            estPromptUsdPerM: 0.66,
+            estCompletionUsdPerM: 3.41,
+            maxOutputTokens: 4096,
+        },
+    },
+    copilot: {
+        low: {
+            model: "deepseek/deepseek-v4-flash",
+            displayName: "DeepSeek V4 Flash",
+            fallbackModels: [],
+            reasoningEffort: "medium",
+            estPromptUsdPerM: 0.09,
+            estCompletionUsdPerM: 0.18,
+            maxOutputTokens: 8192,
+        },
+        medium: {
+            model: "deepseek/deepseek-v4-pro",
+            displayName: "DeepSeek V4 Pro",
+            fallbackModels: [],
+            reasoningEffort: "high",
+            estPromptUsdPerM: 0.435,
+            estCompletionUsdPerM: 0.87,
+            maxOutputTokens: 8192,
+        },
+        high: {
+            model: "moonshotai/kimi-k3",
+            displayName: "Kimi K3",
+            fallbackModels: ["moonshotai/kimi-k2.6"],
+            // No reasoningEffort: Kimi K3 is max-only; the request builder omits the
+            // reasoning param for this tier.
+            estPromptUsdPerM: 3,
+            estCompletionUsdPerM: 15,
+            maxOutputTokens: 8192,
+        },
+    },
+};
+/** The reasoning tier the hosted copilot runs at by default. */
+export const COPILOT_DEFAULT_LEVEL = "high";
+const LEVEL_ENV_SUFFIX = {
+    low: "LOW",
+    medium: "MEDIUM",
+    high: "HIGH",
+};
+function readTrimmedEnv(env, key) {
+    const raw = env[key];
+    if (typeof raw !== "string")
+        return undefined;
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function parseFallbackCsv(raw) {
+    return raw
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+/**
+ * Resolve the model spec for a hosted-AI use case + reasoning level.
+ *
+ * For `copilot`, Doppler overrides are applied here:
+ *   - `OXYGEN_COPILOT_MODEL_{LOW,MEDIUM,HIGH}` replaces `.model` (and, since no
+ *     separate label is supplied, `.displayName` falls back to the model id).
+ *   - `OXYGEN_COPILOT_FALLBACK_{LOW,MEDIUM,HIGH}` replaces `.fallbackModels`
+ *     from a comma-separated list.
+ *
+ * For `ai_column`, NO env handling is applied here: `@oxygen/integrations`
+ * `ai-column-runner.ts` (`resolveModel`/`resolveAiColumnTierModels`) and
+ * `@oxygen/tenant-db` `ai-models.ts` (`resolveManagedReasoningModels`) remain
+ * the sole owners of `OXYGEN_OPENROUTER_MODEL_*` resolution, so the AI-column
+ * path is untouched.
+ */
+/**
+ * Look a model id up across the priced registry (same-use-case tiers first).
+ * A session-level model override must land on a spec that carries ITS OWN
+ * pricing/limits — splicing an arbitrary id onto another tier's spec sizes the
+ * credit reservation for the wrong model and breaks the spend ceiling.
+ */
+export function findHostedAiModelSpec(model, preferredUseCase) {
+    const useCases = Object.keys(HOSTED_AI_MODEL_REGISTRY);
+    const ordered = preferredUseCase
+        ? [preferredUseCase, ...useCases.filter((u) => u !== preferredUseCase)]
+        : useCases;
+    for (const useCase of ordered) {
+        for (const spec of Object.values(HOSTED_AI_MODEL_REGISTRY[useCase])) {
+            if (spec.model === model)
+                return spec;
+        }
+    }
+    return null;
+}
+export function resolveHostedAiModel(input) {
+    const base = HOSTED_AI_MODEL_REGISTRY[input.useCase][input.level];
+    if (input.useCase !== "copilot")
+        return base;
+    const env = input.env ?? process.env;
+    const suffix = LEVEL_ENV_SUFFIX[input.level];
+    const modelOverride = readTrimmedEnv(env, `OXYGEN_COPILOT_MODEL_${suffix}`);
+    const rawFallback = readTrimmedEnv(env, `OXYGEN_COPILOT_FALLBACK_${suffix}`);
+    const fallbackOverride = rawFallback === undefined ? undefined : parseFallbackCsv(rawFallback);
+    if (modelOverride === undefined && fallbackOverride === undefined)
+        return base;
+    // Spread preserves the absence of `reasoningEffort` on max-only tiers.
+    const resolved = { ...base };
+    if (modelOverride !== undefined) {
+        resolved.model = modelOverride;
+        resolved.displayName = modelOverride;
+    }
+    if (fallbackOverride !== undefined) {
+        resolved.fallbackModels = fallbackOverride;
+    }
+    return resolved;
+}
+/**
+ * Convenience map of each reasoning tier's default `.model` id for a use case.
+ * `@oxygen/integrations` and `@oxygen/tenant-db` re-source their AI-column
+ * default catalogs from `hostedAiDefaultModels("ai_column")` so the model ids
+ * live in exactly one place. Returns a fresh object each call.
+ */
+export function hostedAiDefaultModels(useCase) {
+    const specs = HOSTED_AI_MODEL_REGISTRY[useCase];
+    return {
+        low: specs.low.model,
+        medium: specs.medium.model,
+        high: specs.high.model,
+    };
+}
+/**
+ * Whether the hosted copilot is enabled for this environment. FAIL CLOSED: only
+ * the exact strings "1" or "true" (case-insensitive, trimmed) enable it;
+ * anything else — unset, "", "0", "false" — leaves it off.
+ */
+export function isCopilotEnabled(env = process.env) {
+    const raw = env.OXYGEN_COPILOT_ENABLED;
+    if (typeof raw !== "string")
+        return false;
+    const normalized = raw.trim().toLowerCase();
+    return normalized === "1" || normalized === "true";
+}

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

@@ -8,16 +8,19 @@ export * from "./cli-envelope.js";
 export * from "./cli-login-code.js";
 export * from "./cli-result.js";
 export * from "./column-types.js";
+export * from "./copilot-journeys.js";
 export * from "./credit-guidance.js";
 export * from "./directory.js";
 export * from "./email-tracking-token.js";
 export * from "./email-unsubscribe-token.js";
 export * from "./error-redaction.js";
+export * from "./hosted-ai.js";
 export * from "./identifiers.js";
 export * from "./knowledge-constants.js";
 export * from "./knowledge-links.js";
 export * from "./knowledge-markdown.js";
 export * from "./knowledge-seed-content.js";
+export * from "./linkedin-mentions.js";
 export * from "./linkedin-post-url.js";
 export * from "./linkedin-url.js";
 export * from "./linkedin-sequences.js";