@oxygen-agent/cli 1.1014.1035 → 1.1014.1132

package/node_modules/@oxygen/shared/dist/guided-onboarding-journey.d.ts

@@ -0,0 +1,147 @@
+/** Full DEV onboarding, approved by Philipp on 2026-10-16.
+ * Browser-safe vocabulary. Native owners, never navigation or caller assertions,
+ * establish research results, billing eligibility and resource authority. */
+export declare const GUIDED_ONBOARDING_JOURNEY_VERSION: 1;
+export declare const GUIDED_ONBOARDING_PART1_STEPS: readonly ["company_context", "company_research", "company_review", "audience_company_size", "audience_markets", "audience_industries", "audience_personas", "signals", "prospects", "trial"];
+export declare const GUIDED_ONBOARDING_PART2_STEPS: readonly ["welcome", "daily_rhythm", "linkedin", "campaign", "sequence", "routines", "tour"];
+export declare const GUIDED_ONBOARDING_STEPS: readonly ["company_context", "company_research", "company_review", "audience_company_size", "audience_markets", "audience_industries", "audience_personas", "signals", "prospects", "trial", "welcome", "daily_rhythm", "linkedin", "campaign", "sequence", "routines", "tour", "complete"];
+export type GuidedOnboardingStep = typeof GUIDED_ONBOARDING_STEPS[number];
+export type GuidedOnboardingPart = "part1" | "part2" | "complete";
+export declare function guidedOnboardingPart(step: GuidedOnboardingStep): GuidedOnboardingPart;
+export type GuidedOnboardingChoice = {
+    values: string[];
+};
+export type GuidedOnboardingSignal = {
+    mode: "none" | "selected";
+    values: string[];
+};
+export declare const GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS: readonly ["uses", "replaces", "integrates_with"];
+export type GuidedOnboardingTechnologyRelationship = typeof GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS[number];
+export type GuidedOnboardingTechnology = {
+    name: string;
+    relationship: GuidedOnboardingTechnologyRelationship;
+};
+export type GuidedOnboardingTechnologySignal = {
+    mode: "none" | "selected";
+    values: GuidedOnboardingTechnology[];
+};
+export type GuidedOnboardingAnswers = {
+    company_context?: {
+        website: string | null;
+        name: string;
+        description: string;
+        context_links: string[];
+        file_ids: string[];
+    };
+    /** Saving a statement alone is not its native confirmation receipt. */
+    company_review?: {
+        statement: string;
+        profile_revision: string;
+    };
+    audience_company_size?: GuidedOnboardingChoice;
+    audience_markets?: GuidedOnboardingChoice;
+    audience_industries?: GuidedOnboardingChoice;
+    audience_personas?: GuidedOnboardingChoice;
+    signals?: {
+        hiring: GuidedOnboardingSignal;
+        technology: GuidedOnboardingTechnologySignal;
+    };
+    prospects?: {
+        decision: "continue" | "refine";
+        feedback: string;
+    };
+    /** Connect is an intent. Only the native sender owner can prove a connection. */
+    linkedin?: {
+        choice: "connect" | "skip";
+    };
+    /** A draft remains a valid outcome on the optional LinkedIn branch. */
+    sequence?: {
+        decision: "review" | "keep_draft";
+    };
+    tour?: {
+        visited: Array<"overview" | "leads" | "sourcing" | "sequence">;
+    };
+};
+export type GuidedOnboardingResearchStatus = "not_started" | "running" | "completed" | "partial" | "unavailable" | "failed" | "credits_exhausted";
+export type GuidedOnboardingResearch = {
+    status: GuidedOnboardingResearchStatus;
+    run_id: string | null;
+    knowledge_page_ids: string[];
+    /** Fixed customer-safe code only. Provider diagnostics remain in their owner. */
+    fault: {
+        code: string;
+        retryable: boolean;
+    } | null;
+};
+export type GuidedOnboardingProspect = {
+    row_id: string;
+    person_key: string;
+    name: string;
+    title: string;
+    company: string;
+    linkedin_url: string | null;
+    sources: Array<{
+        url: string;
+        title: string;
+    }>;
+    fit: {
+        rationale: string;
+        criteria: string[];
+    };
+};
+export type GuidedOnboardingProspectLimitation = {
+    field: string;
+    code: "unsupported_filter";
+    blocking: boolean;
+    message: string;
+    values: string[];
+    suggestions: string[];
+};
+export type GuidedOnboardingProspects = {
+    status: "not_started" | "running" | "ready" | "partial" | "empty" | "unavailable" | "failed" | "credits_exhausted";
+    table_id: string | null;
+    ingestion_run_ids: string[];
+    /** Up to five native source-backed people; an empty array is never success. */
+    people: GuidedOnboardingProspect[];
+    /** Absent in legacy receipts means unknown, never proof of supported filters.
+     * Current D projections supply actual structured diagnostics, including []. */
+    limitations?: GuidedOnboardingProspectLimitation[];
+    fault: {
+        code: string;
+        retryable: boolean;
+    } | null;
+};
+/** Read projection from native billing, not an accepted browser mutation field.
+ * I owns the actual test Checkout/subscription/grant producer and its signatures. */
+export type GuidedOnboardingEligibility = {
+    state: "unverified" | "checkout_required" | "checkout_pending" | "eligible" | "unavailable";
+    basis: "paid" | "trial" | null;
+    subscription_id: string | null;
+    observed_at: string | null;
+    trial_ends_at: string | null;
+};
+export type GuidedOnboardingJourney = {
+    version: typeof GUIDED_ONBOARDING_JOURNEY_VERSION;
+    /** Increments on non-destructive restart; activation revision guards writes. */
+    generation: number;
+    step: GuidedOnboardingStep;
+    completed_steps: GuidedOnboardingStep[];
+    /** Presentation state is authoritative and independent of deduplicated history. */
+    navigation: {
+        paused: boolean;
+        tour_active_stop: "overview" | "leads" | "sourcing" | "sequence" | null;
+    };
+    answers: GuidedOnboardingAnswers;
+    /** Native confirmation binds the actual typed company profile revision. */
+    company_confirmation: {
+        profile_revision: string;
+        statement_digest: string;
+        confirmed_at: string;
+    } | null;
+    research: GuidedOnboardingResearch;
+    prospects: GuidedOnboardingProspects;
+};
+/** Free initialization; creates no research, chat turn, subscription or resource. */
+export declare function createGuidedOnboardingJourney(): GuidedOnboardingJourney;
+/** Old saved v1 records have no current-stop evidence. Never guess from visited[]. */
+export declare function normalizeSavedGuidedOnboardingJourney(journey: GuidedOnboardingJourney): GuidedOnboardingJourney;

package/node_modules/@oxygen/shared/dist/guided-onboarding-journey.fixture.d.ts

@@ -0,0 +1,12 @@
+import { type GuidedOnboardingJourney, type GuidedOnboardingEligibility } from "./guided-onboarding-journey.js";
+/** Synthetic component/test data only. Never substitute this for hosted receipts. */
+export declare const GUIDED_ONBOARDING_FIXTURE_NAMES: readonly ["part1_initial", "research_running", "company_review", "audience_question", "technology_relationships", "prospects_ready", "prospects_partial", "prospects_empty", "prospects_unavailable", "prospects_failed", "research_failed", "credits_exhausted", "checkout_pending", "billing_unavailable", "part2_trial", "part2_paid", "linkedin_skipped", "tour_paused_back", "complete"];
+export type GuidedOnboardingFixtureName = typeof GUIDED_ONBOARDING_FIXTURE_NAMES[number];
+export type GuidedOnboardingFixture = {
+    fixture_only: true;
+    label: string;
+    activation_revision: number;
+    journey: GuidedOnboardingJourney;
+    eligibility: GuidedOnboardingEligibility;
+};
+export declare function createGuidedOnboardingFixture(name: GuidedOnboardingFixtureName): GuidedOnboardingFixture;

package/node_modules/@oxygen/shared/dist/guided-onboarding-journey.fixture.js

@@ -0,0 +1,83 @@
+import { createGuidedOnboardingJourney, GUIDED_ONBOARDING_STEPS, } from "./guided-onboarding-journey.js";
+/** Synthetic component/test data only. Never substitute this for hosted receipts. */
+export const GUIDED_ONBOARDING_FIXTURE_NAMES = [
+    "part1_initial", "research_running", "company_review", "audience_question", "technology_relationships",
+    "prospects_ready", "prospects_partial", "prospects_empty", "prospects_unavailable", "prospects_failed", "research_failed",
+    "credits_exhausted", "checkout_pending", "billing_unavailable", "part2_trial", "part2_paid", "linkedin_skipped", "tour_paused_back", "complete",
+];
+export function createGuidedOnboardingFixture(name) {
+    const fixture = {
+        fixture_only: true, label: `Synthetic onboarding fixture: ${name}`, activation_revision: 7,
+        journey: createGuidedOnboardingJourney(),
+        eligibility: { state: "checkout_required", basis: null, subscription_id: null, observed_at: "2026-10-16T12:00:00.000Z", trial_ends_at: null },
+    };
+    const { journey, eligibility } = fixture;
+    if (name === "research_running") {
+        journey.step = "company_research";
+        journey.research = { status: "running", run_id: "fixture-research-run", knowledge_page_ids: [], fault: null };
+    }
+    else if (name === "company_review") {
+        journey.step = "company_review";
+        journey.answers.company_review = { statement: "Synthetic company statement for panel tests.", profile_revision: "3" };
+        journey.research = { status: "completed", run_id: "fixture-research-run", knowledge_page_ids: ["fixture-company-page"], fault: null };
+    }
+    else if (name === "audience_question") {
+        journey.step = "audience_markets";
+        journey.answers.audience_company_size = { values: ["11–50"] };
+        journey.answers.audience_markets = { values: ["Germany", "Custom test market"] };
+    }
+    else if (name === "technology_relationships") {
+        journey.step = "signals";
+        journey.answers.signals = {
+            hiring: { mode: "selected", values: ["Revenue Operations Manager"] },
+            technology: { mode: "selected", values: [
+                    { name: "Apollo", relationship: "replaces" },
+                    { name: "Apollo", relationship: "integrates_with" },
+                ] },
+        };
+    }
+    else if (name.startsWith("prospects_")) {
+        journey.step = "prospects";
+        journey.prospects.status = name === "prospects_ready" ? "ready" : name === "prospects_partial" ? "partial"
+            : name === "prospects_unavailable" ? "unavailable" : name === "prospects_failed" ? "failed" : "empty";
+        journey.prospects.table_id = "fixture-prospects-table";
+        if (name === "prospects_ready" || name === "prospects_partial") {
+            journey.prospects.ingestion_run_ids = ["fixture-prospects-ingestion"];
+            journey.prospects.people = Array.from({ length: name === "prospects_ready" ? 5 : 2 }, (_, index) => ({
+                row_id: `fixture-person-${index + 1}`, person_key: `fixture-key-${index + 1}`,
+                name: `Example Buyer ${index + 1}`, title: "Example sales leader", company: "Example Company",
+                linkedin_url: null, sources: [{ url: "https://example.test/source", title: "Synthetic source — not provider evidence" }],
+                fit: { rationale: "Synthetic fit explanation for layout tests.", criteria: ["example persona"] },
+            }));
+        }
+    }
+    else if (name === "research_failed" || name === "credits_exhausted") {
+        journey.step = "company_research";
+        journey.research.status = name === "research_failed" ? "failed" : "credits_exhausted";
+        journey.research.fault = { code: name === "research_failed" ? "research_unavailable" : "insufficient_credits", retryable: name === "research_failed" };
+    }
+    else if (name === "checkout_pending" || name === "billing_unavailable") {
+        journey.step = "trial";
+        eligibility.state = name === "checkout_pending" ? "checkout_pending" : "unavailable";
+    }
+    else if (["part2_trial", "part2_paid", "linkedin_skipped", "tour_paused_back", "complete"].includes(name)) {
+        journey.step = name === "complete" ? "complete" : name === "linkedin_skipped" ? "campaign" : name === "tour_paused_back" ? "tour" : "welcome";
+        eligibility.state = "eligible";
+        eligibility.basis = name === "part2_paid" ? "paid" : "trial";
+        eligibility.subscription_id = "fixture-subscription";
+        eligibility.trial_ends_at = eligibility.basis === "trial" ? "2026-10-23T12:00:00.000Z" : null;
+        if (name === "linkedin_skipped")
+            journey.answers.linkedin = { choice: "skip" };
+    }
+    const index = GUIDED_ONBOARDING_STEPS.indexOf(journey.step);
+    journey.completed_steps = GUIDED_ONBOARDING_STEPS.slice(0, index);
+    if (index > GUIDED_ONBOARDING_STEPS.indexOf("company_review")) {
+        journey.answers.company_review = { statement: "Synthetic reviewed company statement.", profile_revision: "3" };
+        journey.company_confirmation = { profile_revision: "3", statement_digest: "a".repeat(64), confirmed_at: "2026-10-16T12:00:00.000Z" };
+    }
+    if (name === "tour_paused_back") {
+        journey.answers.tour = { visited: ["overview", "leads", "sourcing"] };
+        journey.navigation = { paused: true, tour_active_stop: "leads" };
+    }
+    return fixture;
+}

package/node_modules/@oxygen/shared/dist/guided-onboarding-journey.js

@@ -0,0 +1,44 @@
+/** Full DEV onboarding, approved by Philipp on 2026-10-16.
+ * Browser-safe vocabulary. Native owners, never navigation or caller assertions,
+ * establish research results, billing eligibility and resource authority. */
+export const GUIDED_ONBOARDING_JOURNEY_VERSION = 1;
+export const GUIDED_ONBOARDING_PART1_STEPS = [
+    "company_context", "company_research", "company_review",
+    "audience_company_size", "audience_markets", "audience_industries", "audience_personas",
+    "signals", "prospects", "trial",
+];
+export const GUIDED_ONBOARDING_PART2_STEPS = [
+    "welcome", "daily_rhythm", "linkedin", "campaign", "sequence", "routines", "tour",
+];
+export const GUIDED_ONBOARDING_STEPS = [
+    ...GUIDED_ONBOARDING_PART1_STEPS, ...GUIDED_ONBOARDING_PART2_STEPS, "complete",
+];
+export function guidedOnboardingPart(step) {
+    if (step === "complete")
+        return "complete";
+    if (GUIDED_ONBOARDING_PART1_STEPS.includes(step))
+        return "part1";
+    if (GUIDED_ONBOARDING_PART2_STEPS.includes(step))
+        return "part2";
+    throw new TypeError("Unknown onboarding step.");
+}
+export const GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS = ["uses", "replaces", "integrates_with"];
+/** Free initialization; creates no research, chat turn, subscription or resource. */
+export function createGuidedOnboardingJourney() {
+    return {
+        version: GUIDED_ONBOARDING_JOURNEY_VERSION, generation: 1, step: "company_context",
+        completed_steps: [], navigation: { paused: false, tour_active_stop: null }, answers: {}, company_confirmation: null,
+        research: { status: "not_started", run_id: null, knowledge_page_ids: [], fault: null },
+        prospects: { status: "not_started", table_id: null, ingestion_run_ids: [], people: [], fault: null },
+    };
+}
+/** Old saved v1 records have no current-stop evidence. Never guess from visited[]. */
+export function normalizeSavedGuidedOnboardingJourney(journey) {
+    if (journey.navigation === undefined)
+        return { ...journey, navigation: { paused: false, tour_active_stop: null } };
+    const navigation = journey.navigation;
+    if (!navigation || typeof navigation.paused !== "boolean" || (navigation.tour_active_stop !== null
+        && !["overview", "leads", "sourcing", "sequence"].includes(navigation.tour_active_stop)))
+        throw new TypeError("Invalid saved onboarding navigation.");
+    return journey;
+}

package/node_modules/@oxygen/shared/dist/guided-onboarding-prospects.d.ts

@@ -0,0 +1,7 @@
+import type { GuidedOnboardingProspectLimitation, GuidedOnboardingProspects } from "./guided-onboarding-journey.js";
+/** Bind actual D result.targeting.limitations, never infer support from success,
+ * an empty people list, a legacy absence, or a general fault. Preserve native
+ * result status/fit/source/ingestion truth and the compatible fault unchanged. */
+export declare function projectGuidedOnboardingProspects(prospects: GuidedOnboardingProspects, limitations: unknown): GuidedOnboardingProspects & {
+    limitations: GuidedOnboardingProspectLimitation[];
+};

package/node_modules/@oxygen/shared/dist/guided-onboarding-prospects.js

@@ -0,0 +1,13 @@
+import { OxygenError } from "./cli-result.js";
+import { arr, bool, enumOf, obj, str, validateContract } from "./contracts/schema.js";
+const limitationsContract = obj({ limitations: arr(obj({ field: str({ minLength: 1 }), code: enumOf(["unsupported_filter"]),
+        blocking: bool(), message: str({ minLength: 1 }), values: arr(str()), suggestions: arr(str()) }, { required: ["field", "code", "blocking", "message", "values", "suggestions"] })) }, { required: ["limitations"] });
+/** Bind actual D result.targeting.limitations, never infer support from success,
+ * an empty people list, a legacy absence, or a general fault. Preserve native
+ * result status/fit/source/ingestion truth and the compatible fault unchanged. */
+export function projectGuidedOnboardingProspects(prospects, limitations) {
+    const checked = validateContract(limitationsContract, { limitations }, { unknown: "reject", overMax: "reject" });
+    if (!checked.ok)
+        throw new OxygenError("onboarding_preview_diagnostics_invalid", "The preview could not describe its supported targeting. Review your saved criteria before retrying.");
+    return { ...prospects, limitations: checked.value.limitations.map(item => ({ ...item, values: [...item.values], suggestions: [...item.suggestions] })) };
+}

package/node_modules/@oxygen/shared/dist/guided-onboarding-signals.d.ts

@@ -0,0 +1,4 @@
+import type { GuidedOnboardingAnswers } from "./guided-onboarding-journey.js";
+/** Same product with distinct relationships is intentional, not a duplicate.
+ * This normalizes saved intent, never claims that a provider supports a filter. */
+export declare function normalizeGuidedOnboardingSignals(value: unknown): NonNullable<GuidedOnboardingAnswers["signals"]>;

package/node_modules/@oxygen/shared/dist/guided-onboarding-signals.js

@@ -0,0 +1,34 @@
+import { OxygenError } from "./cli-result.js";
+import { validateContract } from "./contracts/schema.js";
+import { GUIDED_ONBOARDING_SIGNALS_CONTRACT } from "./contracts/guided-onboarding-journey.js";
+const fail = () => {
+    throw new OxygenError("invalid_onboarding_answer", "Choose hiring roles and technologies with uses, replaces or integrates_with, or explicitly choose none.", { exitCode: 2 });
+};
+const displayName = (name) => name.normalize("NFKC").trim().replace(/\s+/gu, " ");
+/** Same product with distinct relationships is intentional, not a duplicate.
+ * This normalizes saved intent, never claims that a provider supports a filter. */
+export function normalizeGuidedOnboardingSignals(value) {
+    const parsed = validateContract(GUIDED_ONBOARDING_SIGNALS_CONTRACT, value, { unknown: "reject", overMax: "reject" });
+    if (!parsed.ok)
+        return fail();
+    const { hiring, technology } = parsed.value;
+    if ((hiring.mode === "none") !== (hiring.values.length === 0)
+        || (technology.mode === "none") !== (technology.values.length === 0))
+        return fail();
+    const roles = hiring.values.map(displayName);
+    if (roles.some(role => !role))
+        return fail();
+    const seen = new Set();
+    const technologies = [];
+    for (const item of technology.values) {
+        const name = displayName(item.name);
+        if (!name)
+            return fail();
+        const key = JSON.stringify([name.toLowerCase(), item.relationship]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        technologies.push({ name, relationship: item.relationship });
+    }
+    return { hiring: { mode: hiring.mode, values: roles }, technology: { mode: technology.mode, values: technologies } };
+}

package/node_modules/@oxygen/shared/dist/guided-trial-billing.d.ts

@@ -0,0 +1,26 @@
+/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+export declare const GUIDED_TRIAL_OFFER: {
+    readonly key: "guided_onboarding_v2";
+    readonly plan: "oxygen_49";
+    readonly currency: "usd";
+    readonly trial_days: 7;
+    readonly trial_credits: 2000;
+    readonly amount_due_now_cents: 0;
+    readonly monthly_price_cents: 4900;
+    readonly card_required: true;
+    readonly early_charge_allowed: false;
+};
+export declare function guidedTrialAcquisitionEnabled(env?: Record<string, string | undefined>): boolean;
+export declare function isGuidedTrialSubscription(metadata: Record<string, unknown> | null | undefined): boolean;
+export type GuidedTrialBilling = {
+    offer: typeof GUIDED_TRIAL_OFFER;
+    eligible: boolean;
+    checkout_allowed: boolean;
+    state: "trial" | "paid" | "checkout_required" | "trial_unavailable" | "subscription_pending";
+    billing_owner_organization_id: string;
+    subscription_id: string | null;
+    trial_ends_at: string | null;
+    cancellation_scheduled: boolean;
+    spendable_credits: number;
+    funded_work_paused: boolean;
+};

package/node_modules/@oxygen/shared/dist/guided-trial-billing.js

@@ -0,0 +1,19 @@
+import { guidedActivationEnabled } from "./guided-activation.js";
+/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+export const GUIDED_TRIAL_OFFER = {
+    key: "guided_onboarding_v2",
+    plan: "oxygen_49",
+    currency: "usd",
+    trial_days: 7,
+    trial_credits: 2_000,
+    amount_due_now_cents: 0,
+    monthly_price_cents: 4_900,
+    card_required: true,
+    early_charge_allowed: false,
+};
+export function guidedTrialAcquisitionEnabled(env = process.env) {
+    return guidedActivationEnabled(env);
+}
+export function isGuidedTrialSubscription(metadata) {
+    return metadata?.oxygen_trial_offer === GUIDED_TRIAL_OFFER.key;
+}

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

@@ -22,6 +22,101 @@
  * can re-source the catalog without dragging the barrel in.
  */
 import { copilotAudience, isCopilotFlagOn } from "./copilot-access.js";
+/**
+ * The Copilot's tiers, which an Oxygent's own chat runs at. Hoisted out of the
+ * registry so the Agent use case can share the same spec objects.
+ */
+const COPILOT_MODEL_SPECS = {
+    /**
+     * "Oxygen Auto" -- the earlier default, retained as an explicit choice.
+     * Its conversation thread stays fixed for its whole life. It is NOT a router: the
+     * model never changes mid-session, because an OpenRouter prompt cache is
+     * model-scoped and a mid-turn switch would turn a ~66% cache HIT rate into a
+     * cache WRITE on a fresh model, ten times a turn. Models only change below
+     * this thread, where the context is fresh -- see COPILOT_ERRAND_LEVEL.
+     *
+     * Before the 2026-10-10 Sol refresh, Auto ran Kimi K3. Its
+     * `reasoningEffort: "medium"` made that tier worth shipping.
+     * Until 2026-09-21 Kimi was sent with NO `reasoning` field at
+     * all, on a registry comment asserting K3 was max-reasoning-only. Measured
+     * against the live API on the same prompt and tool schema, that claim was
+     * false and the omission was the expensive case:
+     *
+     *   omitted -> 412 reasoning tokens, $0.00779, 10.0s
+     *   low     -> 206,                  $0.00566,  9.2s
+     *   medium  -> 124,                  $0.00342,  4.8s   <- 56% cheaper, 2.1x faster
+     *   high    -> 528,                  $0.01075, 14.8s
+     *
+     * All four returned the same answer. Reasoning was 38% of output tokens on a
+     * surface where output is ~61% of the bill.
+     */
+    auto: {
+        model: "openai/gpt-6.1-sol",
+        displayName: "Oxygen Auto",
+        // Approved 2026-10-10 for NEW sessions. Existing sessions retain their
+        // persisted resolved_model; Kimi's priced spec survives in the legacy map.
+        fallbackModels: ["anthropic/claude-sonnet-5.5"],
+        reasoningEffort: "medium",
+        estPromptUsdPerM: 2,
+        estCompletionUsdPerM: 10,
+        // Reasoning tokens count against this cap, so 8,192 left a long tool call
+        // (a full sequence draft, a wide table write) to be cut off mid-argument,
+        // which fails the turn on the second time. Credit holds are sized from the
+        // expected output (billing.ts), so this moves only the conservative clamp.
+        maxOutputTokens: 16_384,
+    },
+    low: {
+        // The errand model: sub-agents, compaction summaries and auto-titles. A
+        // child builds its own Agent with its own messages, so it starts cold on
+        // any model -- which is why a switch is free HERE and nowhere above it.
+        //
+        // This was deepseek/deepseek-v4.1-flash for about an hour, chosen for
+        // being newer and measured correct on a one-tool arithmetic probe. Probed
+        // again against the REAL runtime tool schemas from tools.ts
+        // (capability_search + capability_run, nested `args`, optional approval
+        // fields) under the same provider.require_parameters=true the transport
+        // always sends, it returned `finish_reason: "error"` with zero tool calls
+        // on 1 of 5 attempts, every one served by the Relace endpoint. v4-flash
+        // went 5/5 clean on StreamLake, is CHEAPER on both axes, and is already
+        // what auto-titles run on -- so the newer model was worse on reliability
+        // and on price, and the only thing recommending it was its version number.
+        //
+        // A child that emits no tool call returns nothing for what it spent, and
+        // the transport does not retry `finish_reason: "error"` on the primary
+        // (classifyModelError sends it straight to the next model), so a 20%
+        // error rate here is a 20% double round trip on every delegation.
+        model: "deepseek/deepseek-v4-flash",
+        displayName: "Oxygen Fast",
+        // v4.1-flash earns its place HERE: it works 4 times in 5 and it is a
+        // genuinely different endpoint on a different provider, which is the one
+        // thing a fallback has to be.
+        fallbackModels: ["deepseek/deepseek-v4.1-flash"],
+        reasoningEffort: "low",
+        estPromptUsdPerM: 0.09,
+        estCompletionUsdPerM: 0.18,
+        maxOutputTokens: 8192,
+    },
+    medium: {
+        model: "anthropic/claude-haiku-5.5",
+        displayName: "Oxygen Balanced",
+        fallbackModels: ["deepseek/deepseek-v4.1-flash"],
+        reasoningEffort: "medium",
+        estPromptUsdPerM: 0.1,
+        estCompletionUsdPerM: 0.5,
+        // A conversation tier (the default since #5225), so Auto's cap (see Auto).
+        maxOutputTokens: 16_384,
+    },
+    high: {
+        model: "openai/gpt-6.1-sol",
+        displayName: "Oxygen Max",
+        fallbackModels: ["anthropic/claude-sonnet-5.5"],
+        reasoningEffort: "medium",
+        estPromptUsdPerM: 2,
+        estCompletionUsdPerM: 10,
+        // A conversation tier, so Auto's cap (see Auto).
+        maxOutputTokens: 16_384,
+    },
+};
 export const HOSTED_AI_MODEL_REGISTRY = {
     /**
      * Historical calibration of the September AI-column tiers, re-picked
@@ -112,124 +207,20 @@ export const HOSTED_AI_MODEL_REGISTRY = {
             maxOutputTokens: 4096,
         },
     },
-    copilot: {
-        /**
-         * "Oxygen Auto" -- the earlier default, retained as an explicit choice.
-         * Its conversation thread stays fixed for its whole life. It is NOT a router: the
-         * model never changes mid-session, because an OpenRouter prompt cache is
-         * model-scoped and a mid-turn switch would turn a ~66% cache HIT rate into a
-         * cache WRITE on a fresh model, ten times a turn. Models only change below
-         * this thread, where the context is fresh -- see COPILOT_ERRAND_LEVEL.
-         *
-         * Before the 2026-10-10 Sol refresh, Auto ran Kimi K3. Its
-         * `reasoningEffort: "medium"` made that tier worth shipping.
-         * Until 2026-09-21 Kimi was sent with NO `reasoning` field at
-         * all, on a registry comment asserting K3 was max-reasoning-only. Measured
-         * against the live API on the same prompt and tool schema, that claim was
-         * false and the omission was the expensive case:
-         *
-         *   omitted -> 412 reasoning tokens, $0.00779, 10.0s
-         *   low     -> 206,                  $0.00566,  9.2s
-         *   medium  -> 124,                  $0.00342,  4.8s   <- 56% cheaper, 2.1x faster
-         *   high    -> 528,                  $0.01075, 14.8s
-         *
-         * All four returned the same answer. Reasoning was 38% of output tokens on a
-         * surface where output is ~61% of the bill.
-         */
-        auto: {
-            model: "openai/gpt-6.1-sol",
-            displayName: "Oxygen Auto",
-            // Approved 2026-10-10 for NEW sessions. Existing sessions retain their
-            // persisted resolved_model; Kimi's priced spec survives in the legacy map.
-            fallbackModels: ["anthropic/claude-sonnet-5.5"],
-            reasoningEffort: "medium",
-            estPromptUsdPerM: 2,
-            estCompletionUsdPerM: 10,
-            // Reasoning tokens count against this cap, so 8,192 left a long tool call
-            // (a full sequence draft, a wide table write) to be cut off mid-argument,
-            // which fails the turn on the second time. Credit holds are sized from the
-            // expected output (billing.ts), so this moves only the conservative clamp.
-            maxOutputTokens: 16_384,
-        },
-        low: {
-            // The errand model: sub-agents, compaction summaries and auto-titles. A
-            // child builds its own Agent with its own messages, so it starts cold on
-            // any model -- which is why a switch is free HERE and nowhere above it.
-            //
-            // This was deepseek/deepseek-v4.1-flash for about an hour, chosen for
-            // being newer and measured correct on a one-tool arithmetic probe. Probed
-            // again against the REAL runtime tool schemas from tools.ts
-            // (capability_search + capability_run, nested `args`, optional approval
-            // fields) under the same provider.require_parameters=true the transport
-            // always sends, it returned `finish_reason: "error"` with zero tool calls
-            // on 1 of 5 attempts, every one served by the Relace endpoint. v4-flash
-            // went 5/5 clean on StreamLake, is CHEAPER on both axes, and is already
-            // what auto-titles run on -- so the newer model was worse on reliability
-            // and on price, and the only thing recommending it was its version number.
-            //
-            // A child that emits no tool call returns nothing for what it spent, and
-            // the transport does not retry `finish_reason: "error"` on the primary
-            // (classifyModelError sends it straight to the next model), so a 20%
-            // error rate here is a 20% double round trip on every delegation.
-            model: "deepseek/deepseek-v4-flash",
-            displayName: "Oxygen Fast",
-            // v4.1-flash earns its place HERE: it works 4 times in 5 and it is a
-            // genuinely different endpoint on a different provider, which is the one
-            // thing a fallback has to be.
-            fallbackModels: ["deepseek/deepseek-v4.1-flash"],
-            reasoningEffort: "low",
-            estPromptUsdPerM: 0.09,
-            estCompletionUsdPerM: 0.18,
-            maxOutputTokens: 8192,
-        },
-        medium: {
-            model: "anthropic/claude-haiku-5.5",
-            displayName: "Oxygen Balanced",
-            fallbackModels: ["deepseek/deepseek-v4.1-flash"],
-            reasoningEffort: "medium",
-            estPromptUsdPerM: 0.1,
-            estCompletionUsdPerM: 0.5,
-            // A conversation tier (the default since #5225), so Auto's cap (see Auto).
-            maxOutputTokens: 16_384,
-        },
-        high: {
-            model: "openai/gpt-6.1-sol",
-            displayName: "Oxygen Max",
-            fallbackModels: ["anthropic/claude-sonnet-5.5"],
-            reasoningEffort: "medium",
-            estPromptUsdPerM: 2,
-            estCompletionUsdPerM: 10,
-            // A conversation tier, so Auto's cap (see Auto).
-            maxOutputTokens: 16_384,
-        },
-    },
+    copilot: COPILOT_MODEL_SPECS,
+    /**
+     * An Oxygent's background tasks and routines run on the very models its chat
+     * does, so one tier means one model wherever the Oxygent works (Philipp,
+     * 2026-10-17). Until then Agents kept their September tiers (DeepSeek V4
+     * Flash / V4 Pro / Kimi K2.6), which the 2026-10-10 refresh left out of scope.
+     * Shared by reference, so a Copilot tier refresh moves Agents with it;
+     * `OXYGEN_AGENT_MODEL_*` still overrides Agents alone. Retired ids keep
+     * their tier label through LEGACY_MANAGED_AI_COLUMN_MODELS.
+     */
     agent: {
-        low: {
-            model: "deepseek/deepseek-v4-flash",
-            displayName: "Oxygen Fast",
-            fallbackModels: [],
-            reasoningEffort: "medium",
-            estPromptUsdPerM: 0.09,
-            estCompletionUsdPerM: 0.18,
-            maxOutputTokens: 8192,
-        },
-        medium: {
-            model: "deepseek/deepseek-v4-pro",
-            displayName: "Oxygen Balanced",
-            fallbackModels: ["deepseek/deepseek-v4-flash"],
-            reasoningEffort: "high",
-            estPromptUsdPerM: 0.435,
-            estCompletionUsdPerM: 0.87,
-            maxOutputTokens: 8192,
-        },
-        high: {
-            model: "moonshotai/kimi-k2.6",
-            displayName: "Oxygen Max",
-            fallbackModels: ["deepseek/deepseek-v4-pro"],
-            estPromptUsdPerM: 0.66,
-            estCompletionUsdPerM: 3.41,
-            maxOutputTokens: 8192,
-        },
+        low: COPILOT_MODEL_SPECS.low,
+        medium: COPILOT_MODEL_SPECS.medium,
+        high: COPILOT_MODEL_SPECS.high,
     },
 };
 /** Persisted conversations keep their original pricing, effort and fallbacks. */
@@ -449,7 +440,6 @@ export const IMAGE_INPUT_MODELS = new Set([
     "anthropic/claude-sonnet-5.5",
     "anthropic/claude-haiku-5.5",
     "moonshotai/kimi-k3",
-    "moonshotai/kimi-k2.6",
     "deepseek/deepseek-v4.1-flash",
     "google/gemini-3.8-flash",
 ]);