offrouter-core 0.5.1 → 0.7.0

package/dist/spend.js

@@ -0,0 +1,279 @@
+/**
+ * Estimated paid API-key spend rollup for hard spend caps and `status --costs`.
+ *
+ * Extends the near-limit mechanism: near-limit warns on subscription quota,
+ * spend caps hard-block paid API-key candidates. Both read the same usage
+ * store; subscription and local tiers are never blocked by spend caps.
+ *
+ * Accounting window: the usage store today models a single cumulative window
+ * (per-account token totals persisted in usage.json; no time bucketing), so
+ * rollups cover everything recorded since the usage file was last reset.
+ *
+ * Spend estimation: per-account usage records (`used` = total tokens, keyed
+ * by providerId + accountId, which the delegation runtime sets to the model
+ * id) priced with the catalog PricingHint. When a per-model input/output
+ * breakdown is present, tokens are priced exactly (input rate × input +
+ * output rate × output). The unattributed remainder
+ * (`used - sum(model tokens)`) keeps the conservative max(input, output)
+ * rate treatment and flags costsIncomplete. Where pricing is unknown the
+ * contribution is not guessed: zero for cap math + costsIncomplete. Local
+ * runtimes are known-zero (no paid spend by definition).
+ */
+import { getBuiltinProvider, } from "./providers/catalog-data.js";
+/** Identifier for the accounting window the usage store currently models. */
+export const SPEND_ACCOUNTING_WINDOW = "cumulative";
+/** Catalog pricing hint for a provider/model pair, when documented. */
+export function pricingHintForModel(providerId, modelId) {
+    const provider = getBuiltinProvider(providerId);
+    return provider?.knownModels.find((m) => m.modelId === modelId)?.pricing;
+}
+/**
+ * Estimate USD for a token total under a pricing hint using the higher of
+ * the input/output rates (conservative upper bound). Used for unattributed
+ * remainder / legacy totals where the input/output split is unknown.
+ * Returns undefined when the hint carries no usable rate — unknown pricing
+ * is never guessed.
+ */
+export function estimateTokensCostUsd(totalTokens, hint) {
+    if (!hint)
+        return undefined;
+    const rate = Math.max(hint.inputPer1M ?? 0, hint.outputPer1M ?? 0);
+    if (rate <= 0)
+        return undefined;
+    return (totalTokens / 1_000_000) * rate;
+}
+/**
+ * Estimate USD from an exact input/output split. Falls back to the
+ * single documented rate when only one side is known. Returns undefined
+ * when the hint carries no usable rate.
+ */
+export function estimateSplitTokensCostUsd(inputTokens, outputTokens, hint) {
+    if (!hint)
+        return undefined;
+    const inputRate = hint.inputPer1M;
+    const outputRate = hint.outputPer1M;
+    if ((inputRate === undefined || inputRate <= 0) &&
+        (outputRate === undefined || outputRate <= 0)) {
+        return undefined;
+    }
+    // When only one rate is documented, apply it to both sides rather than
+    // silently dropping the other side.
+    const inRate = inputRate !== undefined && inputRate > 0
+        ? inputRate
+        : outputRate;
+    const outRate = outputRate !== undefined && outputRate > 0
+        ? outputRate
+        : inputRate;
+    return (inputTokens / 1_000_000) * inRate + (outputTokens / 1_000_000) * outRate;
+}
+function attributedTokens(models) {
+    if (!models)
+        return 0;
+    let total = 0;
+    for (const t of Object.values(models)) {
+        total += t.inputTokens + t.outputTokens;
+    }
+    return total;
+}
+function pricePaidTokens(args) {
+    const { providerId, modelId, totalTokens, tier, pricing } = args;
+    const isPaidTier = tier === "api-key" || tier === undefined;
+    if (!isPaidTier) {
+        return { estimatedUsd: 0, pricingKnown: true, exactPricing: true };
+    }
+    if (getBuiltinProvider(providerId)?.defaultAuthTier === "local") {
+        return { estimatedUsd: 0, pricingKnown: true, exactPricing: true };
+    }
+    const hint = pricing(providerId, modelId);
+    const hasSplit = args.inputTokens !== undefined && args.outputTokens !== undefined;
+    let estimatedUsd;
+    let exactPricing = false;
+    if (hint !== undefined) {
+        if (hasSplit) {
+            estimatedUsd = estimateSplitTokensCostUsd(args.inputTokens, args.outputTokens, hint);
+            exactPricing = estimatedUsd !== undefined;
+        }
+        else {
+            estimatedUsd = estimateTokensCostUsd(totalTokens, hint);
+        }
+    }
+    let pricingKnown = estimatedUsd !== undefined;
+    // Legacy records without an authTier are counted, but we cannot be sure
+    // they were truly paid API-key usage, so mark the estimate incomplete.
+    if (tier === undefined) {
+        pricingKnown = false;
+    }
+    return {
+        estimatedUsd: estimatedUsd ?? 0,
+        pricingKnown,
+        exactPricing: exactPricing && pricingKnown,
+    };
+}
+/**
+ * Build a spend rollup from per-account usage records. Pure and
+ * deterministic; providers and models are sorted by id like the usage stores.
+ *
+ * Only API-key usage counts toward paid spend. Subscription and local tiers
+ * are recorded as known-zero. Legacy records with no authTier are counted
+ * conservatively (as paid) but always mark the rollup costsIncomplete.
+ *
+ * When a per-model input/output breakdown is present, those tokens are priced
+ * exactly. Any unattributed remainder (aggregate `used` minus attributed
+ * tokens) is priced at the conservative max rate under the accountId model
+ * and flags costsIncomplete for that remainder.
+ */
+export function buildSpendRollup(accounts, options = {}) {
+    const pricing = options.pricing ?? pricingHintForModel;
+    const caps = options.caps ?? {};
+    const byProvider = new Map();
+    for (const account of accounts) {
+        const { providerId, accountId } = account;
+        const tier = account.authTier;
+        const models = account.models;
+        const linesForAccount = [];
+        if (models && Object.keys(models).length > 0) {
+            const modelIds = Object.keys(models).sort((a, b) => a.localeCompare(b));
+            for (const modelId of modelIds) {
+                const breakdown = models[modelId];
+                const totalTokens = breakdown.inputTokens + breakdown.outputTokens;
+                const priced = pricePaidTokens({
+                    providerId,
+                    modelId,
+                    totalTokens,
+                    inputTokens: breakdown.inputTokens,
+                    outputTokens: breakdown.outputTokens,
+                    tier,
+                    pricing,
+                });
+                linesForAccount.push({
+                    providerId,
+                    modelId,
+                    totalTokens,
+                    inputTokens: breakdown.inputTokens,
+                    outputTokens: breakdown.outputTokens,
+                    estimatedUsd: priced.estimatedUsd,
+                    pricingKnown: priced.pricingKnown,
+                    exactPricing: priced.exactPricing,
+                });
+            }
+            const remainder = Math.max(0, account.used - attributedTokens(models));
+            if (remainder > 0) {
+                // Unattributed remainder: price conservatively under the account's
+                // model id (best available catalog key) but keep a distinct line id
+                // so it never coalesces with an exact-priced attributed line.
+                const priced = pricePaidTokens({
+                    providerId,
+                    modelId: accountId,
+                    totalTokens: remainder,
+                    tier,
+                    pricing,
+                });
+                linesForAccount.push({
+                    providerId,
+                    modelId: `${accountId}#unattributed`,
+                    totalTokens: remainder,
+                    estimatedUsd: priced.estimatedUsd,
+                    // Remainder is definitionally incomplete: we lack the split.
+                    pricingKnown: false,
+                    exactPricing: false,
+                });
+            }
+        }
+        else {
+            // Legacy / no-breakdown path: single line under accountId, conservative.
+            const priced = pricePaidTokens({
+                providerId,
+                modelId: accountId,
+                totalTokens: account.used,
+                tier,
+                pricing,
+            });
+            linesForAccount.push({
+                providerId,
+                modelId: accountId,
+                totalTokens: account.used,
+                estimatedUsd: priced.estimatedUsd,
+                pricingKnown: priced.pricingKnown,
+                exactPricing: false,
+            });
+        }
+        const list = byProvider.get(providerId);
+        if (list) {
+            list.push(...linesForAccount);
+        }
+        else {
+            byProvider.set(providerId, linesForAccount);
+        }
+    }
+    const providers = [];
+    for (const [providerId, rawModels] of byProvider) {
+        // Coalesce lines that share a modelId (e.g. multiple account writes for
+        // the same model, or an exact line plus a remainder under the same key).
+        const coalesced = new Map();
+        for (const line of rawModels) {
+            const existing = coalesced.get(line.modelId);
+            if (!existing) {
+                coalesced.set(line.modelId, { ...line });
+                continue;
+            }
+            existing.totalTokens += line.totalTokens;
+            existing.estimatedUsd += line.estimatedUsd;
+            existing.pricingKnown = existing.pricingKnown && line.pricingKnown;
+            existing.exactPricing = existing.exactPricing && line.exactPricing;
+            if (line.inputTokens !== undefined || existing.inputTokens !== undefined) {
+                existing.inputTokens =
+                    (existing.inputTokens ?? 0) + (line.inputTokens ?? 0);
+            }
+            if (line.outputTokens !== undefined ||
+                existing.outputTokens !== undefined) {
+                existing.outputTokens =
+                    (existing.outputTokens ?? 0) + (line.outputTokens ?? 0);
+            }
+        }
+        const models = [...coalesced.values()].sort((a, b) => a.modelId.localeCompare(b.modelId));
+        const estimatedUsd = models.reduce((sum, m) => sum + m.estimatedUsd, 0);
+        const capUsd = caps.perProviderUsd?.[providerId] ?? caps.globalUsd;
+        providers.push({
+            providerId,
+            totalTokens: models.reduce((sum, m) => sum + m.totalTokens, 0),
+            estimatedUsd,
+            costsIncomplete: models.some((m) => !m.pricingKnown),
+            ...(capUsd !== undefined
+                ? {
+                    capUsd,
+                    remainingUsd: Math.max(0, capUsd - estimatedUsd),
+                    capExceeded: estimatedUsd >= capUsd,
+                }
+                : { capExceeded: false }),
+            models,
+        });
+    }
+    providers.sort((a, b) => a.providerId.localeCompare(b.providerId));
+    const totalUsd = providers.reduce((sum, p) => sum + p.estimatedUsd, 0);
+    const globalCap = caps.globalUsd;
+    return {
+        window: SPEND_ACCOUNTING_WINDOW,
+        totalUsd,
+        costsIncomplete: providers.some((p) => p.costsIncomplete),
+        ...(globalCap !== undefined
+            ? {
+                capUsd: globalCap,
+                remainingUsd: Math.max(0, globalCap - totalUsd),
+                capExceeded: totalUsd >= globalCap,
+            }
+            : { capExceeded: false }),
+        providers,
+    };
+}
+/**
+ * Build the `currentSpendByProviderUsd` map that PolicyConfig expects from a
+ * usage store. Non-fatal on the caller side: this helper throws when the
+ * store cannot be read so the caller can decide whether to swallow the error.
+ */
+export async function buildCurrentSpendByProviderUsd(store, options) {
+    const rollup = buildSpendRollup(await store.listAccountUsage(), {
+        pricing: options?.pricing,
+    });
+    return Object.fromEntries(rollup.providers.map((p) => [p.providerId, p.estimatedUsd]));
+}
+//# sourceMappingURL=spend.js.map

package/dist/spend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend.js","sourceRoot":"","sources":["../src/spend.ts"],"names":[],"mappings":"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"}

package/dist/task-classifier.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Deterministic task classifier — routing *signal*, never authority.
+ *
+ * Policy still decides what is allowed. This module only recommends a logical
+ * model family (`fast-coder` | `frontier-coder`) from cheap, local heuristics
+ * over a prompt preview / length. No network, no LLM, no config keys.
+ *
+ * Default bias: when the input is ambiguous, prefer `frontier-coder` with
+ * `confidence: "low"`. Never under-serve a task by quietly routing complex work
+ * to a fast/cheap model. Callers must treat medium/low confidence as
+ * informational only — the router only applies a within-tier preference bump
+ * when confidence is `"high"`.
+ */
+/** Character threshold above which a prompt is treated as "long". */
+export declare const LONG_PROMPT_CHARS = 2000;
+/** Minimum distinct code fences (``` pairs counted as openings) for multi-fence. */
+export declare const MULTI_CODE_FENCE_THRESHOLD = 2;
+/** Minimum multi-step keyword hits required to fire the multi-step signal. */
+export declare const MULTI_STEP_HIT_THRESHOLD = 1;
+/** Short-prompt ceiling for the mechanical / fast path (chars). */
+export declare const SHORT_PROMPT_CHARS = 280;
+export type ClassifierFamily = "fast-coder" | "frontier-coder";
+export type ClassifierConfidence = "low" | "medium" | "high";
+export interface TaskClassification {
+    recommendedFamily: ClassifierFamily;
+    confidence: ClassifierConfidence;
+    /** Short stable rule ids that fired; safe for explain/audit (no prompt text). */
+    signals: string[];
+}
+export interface ClassifyTaskInput {
+    /** Optional short preview of the prompt (may be truncated upstream). */
+    promptPreview?: string;
+    /**
+     * Optional full prompt length in characters. Prefer this over preview length
+     * when available so truncation of the preview does not hide a long prompt.
+     */
+    promptLengthChars?: number;
+}
+/**
+ * Classify a task from prompt preview / length using deterministic heuristics.
+ *
+ * Same inputs always produce the same output. Never throws on empty input.
+ */
+export declare function classifyTask(input?: ClassifyTaskInput): TaskClassification;
+//# sourceMappingURL=task-classifier.d.ts.map

package/dist/task-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-classifier.d.ts","sourceRoot":"","sources":["../src/task-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AAEvC,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAsB1C,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,UAAU,EAAE,oBAAoB,CAAC;IACjC,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAsBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,iBAAsB,GAAG,kBAAkB,CAyF9E"}

package/dist/task-classifier.js

@@ -0,0 +1,153 @@
+/**
+ * Deterministic task classifier — routing *signal*, never authority.
+ *
+ * Policy still decides what is allowed. This module only recommends a logical
+ * model family (`fast-coder` | `frontier-coder`) from cheap, local heuristics
+ * over a prompt preview / length. No network, no LLM, no config keys.
+ *
+ * Default bias: when the input is ambiguous, prefer `frontier-coder` with
+ * `confidence: "low"`. Never under-serve a task by quietly routing complex work
+ * to a fast/cheap model. Callers must treat medium/low confidence as
+ * informational only — the router only applies a within-tier preference bump
+ * when confidence is `"high"`.
+ */
+/** Character threshold above which a prompt is treated as "long". */
+export const LONG_PROMPT_CHARS = 2_000;
+/** Minimum distinct code fences (``` pairs counted as openings) for multi-fence. */
+export const MULTI_CODE_FENCE_THRESHOLD = 2;
+/** Minimum multi-step keyword hits required to fire the multi-step signal. */
+export const MULTI_STEP_HIT_THRESHOLD = 1;
+const MULTI_STEP_PATTERNS = [
+    { id: "multi_step:refactor", re: /\brefactor(?:ing|s|ed)?\b/i },
+    { id: "multi_step:architect", re: /\barchitect(?:ure|ing|ed|s)?\b/i },
+    { id: "multi_step:migrate", re: /\bmigrat(?:e|ion|ing|ed|es)\b/i },
+    { id: "multi_step:design", re: /\bdesign(?:ing|ed|s)?\b/i },
+    // "debug across" is intentionally multi-word to avoid every "debug this" hit.
+    { id: "multi_step:debug_across", re: /\bdebug\s+across\b/i },
+    { id: "multi_step:investigate", re: /\binvestigat(?:e|ion|ing|ed|es)\b/i },
+];
+const FAST_MECHANICAL_PATTERNS = [
+    { id: "mechanical:rename", re: /\brename\b/i },
+    { id: "mechanical:format", re: /\bformat\b/i },
+    { id: "mechanical:typo", re: /\btypos?\b/i },
+    { id: "mechanical:bump", re: /\bbump\b/i },
+    { id: "mechanical:list", re: /\blist\b/i },
+    // "extract single" stays multi-word so "extract the auth module" stays open.
+    { id: "mechanical:extract_single", re: /\bextract\s+single\b/i },
+];
+/** Short-prompt ceiling for the mechanical / fast path (chars). */
+export const SHORT_PROMPT_CHARS = 280;
+function countCodeFenceOpenings(text) {
+    // Count opening fences only; a lone ``` still counts as one fence block.
+    const matches = text.match(/```/g);
+    if (!matches)
+        return 0;
+    // Each fence token is one marker; a complete block uses two. Treat every pair
+    // of markers as one fence and a trailing orphan as another block start.
+    return Math.ceil(matches.length / 2);
+}
+function collectHits(text, patterns) {
+    const hits = [];
+    for (const { id, re } of patterns) {
+        if (re.test(text))
+            hits.push(id);
+    }
+    return hits;
+}
+/**
+ * Classify a task from prompt preview / length using deterministic heuristics.
+ *
+ * Same inputs always produce the same output. Never throws on empty input.
+ */
+export function classifyTask(input = {}) {
+    const preview = input.promptPreview ?? "";
+    const length = typeof input.promptLengthChars === "number" &&
+        Number.isFinite(input.promptLengthChars) &&
+        input.promptLengthChars >= 0
+        ? Math.floor(input.promptLengthChars)
+        : preview.length;
+    const signals = [];
+    let frontierScore = 0;
+    let fastScore = 0;
+    // --- Frontier signals ----------------------------------------------------
+    if (length > LONG_PROMPT_CHARS) {
+        signals.push("long_prompt");
+        frontierScore += 2;
+    }
+    const multiStepHits = collectHits(preview, MULTI_STEP_PATTERNS);
+    if (multiStepHits.length >= MULTI_STEP_HIT_THRESHOLD) {
+        signals.push(...multiStepHits);
+        signals.push("multi_step");
+        frontierScore += 1 + Math.min(multiStepHits.length, 2);
+    }
+    const fenceCount = countCodeFenceOpenings(preview);
+    if (fenceCount >= MULTI_CODE_FENCE_THRESHOLD) {
+        signals.push("multi_code_fence");
+        frontierScore += 2;
+    }
+    // --- Fast / mechanical signals -------------------------------------------
+    const mechanicalHits = collectHits(preview, FAST_MECHANICAL_PATTERNS);
+    const isShort = length > 0 && length <= SHORT_PROMPT_CHARS;
+    if (isShort) {
+        signals.push("short_prompt");
+    }
+    if (mechanicalHits.length > 0 && frontierScore === 0) {
+        signals.push(...mechanicalHits);
+        signals.push("mechanical_verb");
+        fastScore += 1 + Math.min(mechanicalHits.length, 2);
+        if (isShort)
+            fastScore += 1;
+    }
+    else if (mechanicalHits.length > 0 && frontierScore > 0) {
+        // Still record mechanical hits for explainability, but do not let them
+        // cancel a frontier signal (never under-serve).
+        signals.push(...mechanicalHits);
+    }
+    // Empty / whitespace-only input → ambiguous.
+    if (preview.trim().length === 0 && length === 0) {
+        return {
+            recommendedFamily: "frontier-coder",
+            confidence: "low",
+            signals: ["ambiguous_empty"],
+        };
+    }
+    if (frontierScore > 0 && frontierScore > fastScore) {
+        const confidence = frontierScore >= 3 ? "high" : frontierScore === 2 ? "medium" : "low";
+        return {
+            recommendedFamily: "frontier-coder",
+            confidence,
+            signals: dedupe(signals),
+        };
+    }
+    if (fastScore > 0 && fastScore > frontierScore) {
+        // High only when short + clear mechanical verb(s) and no frontier signal.
+        const confidence = fastScore >= 2 && isShort ? "high" : "medium";
+        return {
+            recommendedFamily: "fast-coder",
+            confidence,
+            signals: dedupe(signals),
+        };
+    }
+    // Ambiguous: mixed, missing, or equal signal weight. Default to frontier so
+    // we never under-serve. Confidence stays low so the router does not reorder.
+    if (!signals.includes("ambiguous")) {
+        signals.push("ambiguous");
+    }
+    return {
+        recommendedFamily: "frontier-coder",
+        confidence: "low",
+        signals: dedupe(signals),
+    };
+}
+function dedupe(signals) {
+    const seen = new Set();
+    const out = [];
+    for (const s of signals) {
+        if (seen.has(s))
+            continue;
+        seen.add(s);
+        out.push(s);
+    }
+    return out;
+}
+//# sourceMappingURL=task-classifier.js.map

package/dist/task-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-classifier.js","sourceRoot":"","sources":["../src/task-classifier.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -10,7 +10,7 @@ export type FallbackReason = "primary" | "subscription_exhausted" | "subscriptio
 export type HarnessKind = "claude" | "codex" | "gemini" | "grok" | "cursor" | "pi" | "other";
 export type TaskKind = "explain" | "code" | "review" | "plan" | "research" | "image" | "tools" | "other";
 export type RiskLevel = "low" | "medium" | "high";
-export type PolicyDenialCode = "profile_not_allowlisted" | "work_profile_denied" | "provider_denied" | "project_untrusted" | "privacy_label_denied" | "local_only_required" | "cost_cap_exceeded" | "api_key_blocked_by_subscription_first_policy" | "subscription_scope_denied" | "capability_missing";
+export type PolicyDenialCode = "profile_not_allowlisted" | "work_profile_denied" | "provider_denied" | "project_untrusted" | "privacy_label_denied" | "local_only_required" | "cost_cap_exceeded" | "spend_cap_exceeded" | "api_key_blocked_by_subscription_first_policy" | "subscription_scope_denied" | "capability_missing" | "model_not_allowed" | "api_spend_approval_required" | "subscription_switch_requires_ack";
 export type PolicyDenialTarget = "profile" | "provider" | "model" | "workspace" | "candidate";
 export interface PolicyDenial {
     code: PolicyDenialCode;
@@ -18,6 +18,8 @@ export interface PolicyDenial {
     id: string;
     message: string;
 }
+/** Logical model family shared across auth tiers (mirrors catalog). */
+export type LogicalModelFamily = "frontier-coder" | "fast-coder" | "local-coder" | "vision-helper";
 export interface ProviderCandidate {
     providerId: string;
     modelId: string;
@@ -35,6 +37,11 @@ export interface ProviderCandidate {
     contextWindowTokens?: number;
     maxOutputTokens?: number;
     estimatedCostUsd?: number;
+    /**
+     * Optional logical family used by the heuristic classifier as a same-tier
+     * preference signal. Omitted candidates never receive a family preference bump.
+     */
+    family?: LogicalModelFamily;
 }
 export interface HarnessRef {
     kind: HarnessKind;
@@ -85,7 +92,25 @@ export interface FallbackChainEntry {
     model: string;
     authTier: AuthTier;
     reason: FallbackReason;
+    /**
+     * Recent-outcome health score used for same-tier re-ordering when a health
+     * tracker is attached to routeRequest. Higher is healthier. Unknown /
+     * unobserved pairs use the tracker neutral score (0). Omitted when no
+     * tracker was provided.
+     */
+    healthScore?: number;
 }
+/**
+ * Heuristic task classification attached to a route decision for explain/audit.
+ * Contains only family / confidence / stable signal ids — never prompt text.
+ */
+export interface RouteClassification {
+    recommendedFamily: "fast-coder" | "frontier-coder";
+    confidence: "low" | "medium" | "high";
+    signals: string[];
+}
+/** Which classifier produced the routing signal recorded in audit/decision. */
+export type ClassifierName = "heuristic" | "llm" | "llm-fallback-heuristic";
 export interface RouteDecision {
     protocolVersion: "offrouter.route.v1";
     decisionId: string;
@@ -105,6 +130,26 @@ export interface RouteDecision {
     needsConfiguration?: boolean;
     /** Warning when the selected route is a near-limit subscription with no healthy alternative. */
     nearLimitWarning?: string;
+    /**
+     * Optional classifier signal used during scoring. Present when the caller
+     * supplied a classification (or delegation computed one). Never carries
+     * prompt text — family / confidence / signal ids only.
+     */
+    classification?: RouteClassification;
+    /**
+     * Which classifier produced the classification signal. Present when the
+     * decision carries a classification. Never prompt text.
+     */
+    classifierName?: ClassifierName;
+    /**
+     * When a user-defined routing rule matched, the rule index and matched keys.
+     * Absent when no rule matched (auto routing).
+     */
+    routingRule?: {
+        index: number;
+        matchedKeys: ("role" | "family")[];
+        target: "model" | "provider" | "tier";
+    };
 }
 /**
  * Outcome of evaluatePolicy: filtered candidates plus structured denials.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/usage-file.d.ts

@@ -1,5 +1,5 @@
 import { chmod, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
-import { type AccountUsageSnapshot, type PaidFallbackExplanation, type ProviderUsageSnapshot, type RecordUsageResult, type UsageEvent, type UsageStore } from "./usage.js";
+import { type AccountUsageSnapshot, type PaidFallbackExplanation, type ProviderUsageSnapshot, type RecordUsageInput, type RecordUsageResult, type UsageEvent, type UsageStore } from "./usage.js";
 export { DEFAULT_NEAR_LIMIT_THRESHOLD } from "./usage.js";
 export { InMemoryUsageStore } from "./usage.js";
 export type { UsageStore } from "./usage.js";
@@ -45,11 +45,7 @@ export declare class FileUsageStore implements UsageStore {
     explainPaidFallback(providerId: string, options?: {
         hasApiKeyCandidate?: boolean;
     }): Promise<PaidFallbackExplanation>;
-    recordUsage(providerId: string, accountId: string, input: {
-        used?: number;
-        limit?: number;
-        at?: Date;
-    }): Promise<AccountUsageSnapshot>;
+    recordUsage(providerId: string, accountId: string, input: RecordUsageInput): Promise<AccountUsageSnapshot>;
     isNearLimit(providerId: string, accountId: string, threshold?: number): Promise<boolean>;
     getNearLimitAccounts(threshold?: number): Promise<AccountUsageSnapshot[]>;
     getAccountUsage(providerId: string, accountId: string): Promise<AccountUsageSnapshot | undefined>;

package/dist/usage-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-file.d.ts","sourceRoot":"","sources":["../src/usage-file.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC/C,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAoFD;;;GAGG;AACH,qBAAa,cAAe,YAAW,UAAU;;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBASd,OAAO,EAAE,qBAAqB;IA6I1C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAI3E,aAAa,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAIjD,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,YAAY,EAAE,kBAAkB,CAAC;QACjD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,EAAE,CAAC,EAAE,IAAI,CAAC;KACX,GACA,OAAO,CAAC,qBAAqB,CAAC;IAIjC,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,GACzC,OAAO,CAAC,uBAAuB,CAAC;IAM7B,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,IAAI,CAAA;KAAE,GAClD,OAAO,CAAC,oBAAoB,CAAC;IAuB1B,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IASb,oBAAoB,CACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAgB5B,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAStC,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAezD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC"}
+{"version":3,"file":"usage-file.d.ts","sourceRoot":"","sources":["../src/usage-file.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAKL,KAAK,oBAAoB,EAEzB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC/C,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAgJD;;;GAGG;AACH,qBAAa,cAAe,YAAW,UAAU;;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBASd,OAAO,EAAE,qBAAqB;IA4J1C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAI3E,aAAa,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAIjD,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,YAAY,EAAE,kBAAkB,CAAC;QACjD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,EAAE,CAAC,EAAE,IAAI,CAAC;KACX,GACA,OAAO,CAAC,qBAAqB,CAAC;IAIjC,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,GACzC,OAAO,CAAC,uBAAuB,CAAC;IAM7B,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAqB1B,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IASb,oBAAoB,CACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAgB5B,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAStC,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAezD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC"}