pi-smart-router 0.1.0

package/dist/infrastructure/pricing/litellm-fetch.d.ts

@@ -0,0 +1,46 @@
+/**
+ * LiteLLM pricing fetch — manual refresh path (SP-045).
+ *
+ * Fetches the public LiteLLM model pricing JSON and normalizes chat-model
+ * rates into PriceCatalog.registry_snapshot entries keyed by model id and
+ * provider/model aliases for tri-tier broker lookup.
+ */
+import type { ModelLimits, PriceCatalog } from '../../domain/types/index.js';
+export declare const DEFAULT_LITELLM_PRICING_URL = "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json";
+export interface LitellmFetchResult {
+    readonly registry_snapshot: Readonly<Record<string, number>>;
+    readonly registry_limits_snapshot: Readonly<Record<string, ModelLimits>>;
+    /** Number of LiteLLM chat/completion models normalized (before alias keys). */
+    readonly model_count: number;
+}
+export interface LitellmFetchDeps {
+    readonly fetchFn?: typeof fetch;
+    readonly pricingUrl?: string;
+}
+export declare class LitellmFetchError extends Error {
+    readonly name = "LitellmFetchError";
+}
+/**
+ * Resolve pricing URL from env with documented LiteLLM GitHub default.
+ */
+export declare function getLitellmPricingUrl(env?: NodeJS.ProcessEnv): string;
+/**
+ * Weighted blend of input/output per-token rates → USD per 1M tokens.
+ * Matches the registry-cost formula planned for SP-046.
+ */
+export declare function computeCostPer1MTokens(inputCostPerToken: number, outputCostPerToken: number): number;
+/**
+ * Normalize LiteLLM pricing JSON into registry_snapshot rates.
+ * Validates shape and fails fast with actionable errors.
+ */
+export declare function normalizeLitellmPricing(raw: unknown): LitellmFetchResult;
+export interface LitellmPriceCatalogResult {
+    readonly catalog: PriceCatalog;
+    /** Number of chat/completion models in the LiteLLM source payload. */
+    readonly model_count: number;
+}
+/**
+ * Fetch LiteLLM pricing and build a PriceCatalog payload (does not persist).
+ */
+export declare function fetchLitellmPriceCatalog(deps?: LitellmFetchDeps): Promise<LitellmPriceCatalogResult>;
+//# sourceMappingURL=litellm-fetch.d.ts.map

package/dist/infrastructure/pricing/litellm-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"litellm-fetch.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/pricing/litellm-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE7E,eAAO,MAAM,2BAA2B,gGACuD,CAAC;AAIhG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACzE,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAkB,IAAI,uBAAuB;CAC9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAGjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAIR;AA4CD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CA8DxE;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,yBAAyB,CAAC,CAyCpC"}

package/dist/infrastructure/pricing/litellm-fetch.js

@@ -0,0 +1,145 @@
+/**
+ * LiteLLM pricing fetch — manual refresh path (SP-045).
+ *
+ * Fetches the public LiteLLM model pricing JSON and normalizes chat-model
+ * rates into PriceCatalog.registry_snapshot entries keyed by model id and
+ * provider/model aliases for tri-tier broker lookup.
+ */
+export const DEFAULT_LITELLM_PRICING_URL = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json';
+const CHAT_MODES = new Set(['chat', 'completion']);
+export class LitellmFetchError extends Error {
+    name = 'LitellmFetchError';
+}
+/**
+ * Resolve pricing URL from env with documented LiteLLM GitHub default.
+ */
+export function getLitellmPricingUrl(env = process.env) {
+    const configured = env.LITELLM_PRICING_URL?.trim();
+    return configured && configured.length > 0 ? configured : DEFAULT_LITELLM_PRICING_URL;
+}
+/**
+ * Weighted blend of input/output per-token rates → USD per 1M tokens.
+ * Matches the registry-cost formula planned for SP-046.
+ */
+export function computeCostPer1MTokens(inputCostPerToken, outputCostPerToken) {
+    const inputPer1M = inputCostPerToken * 1_000_000;
+    const outputPer1M = outputCostPerToken * 1_000_000;
+    return (inputPer1M + outputPer1M) / 2;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readNumberField(entry, field) {
+    const value = entry[field];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function readStringField(entry, field) {
+    const value = entry[field];
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function readPositiveIntField(entry, field) {
+    const value = entry[field];
+    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+function parseModelLimits(entry) {
+    const maxInputTokens = readPositiveIntField(entry, 'max_input_tokens');
+    const maxOutputTokens = readPositiveIntField(entry, 'max_output_tokens') ?? readPositiveIntField(entry, 'max_tokens');
+    if (maxInputTokens === undefined && maxOutputTokens === undefined) {
+        return undefined;
+    }
+    return {
+        ...(maxInputTokens !== undefined ? { max_input_tokens: maxInputTokens } : {}),
+        ...(maxOutputTokens !== undefined ? { max_output_tokens: maxOutputTokens } : {}),
+    };
+}
+function storeLimitsAlias(registry_limits_snapshot, key, limits) {
+    registry_limits_snapshot[key] = limits;
+}
+/**
+ * Normalize LiteLLM pricing JSON into registry_snapshot rates.
+ * Validates shape and fails fast with actionable errors.
+ */
+export function normalizeLitellmPricing(raw) {
+    if (!isRecord(raw)) {
+        throw new LitellmFetchError('LiteLLM pricing response must be a JSON object. Check LITELLM_PRICING_URL points at model_prices_and_context_window.json.');
+    }
+    const registry_snapshot = {};
+    const registry_limits_snapshot = {};
+    let modelCount = 0;
+    for (const [modelKey, entry] of Object.entries(raw)) {
+        if (modelKey === 'sample_spec') {
+            continue;
+        }
+        if (!isRecord(entry)) {
+            throw new LitellmFetchError(`LiteLLM pricing entry "${modelKey}" must be an object. Received ${typeof entry}.`);
+        }
+        const mode = readStringField(entry, 'mode');
+        if (mode !== undefined && !CHAT_MODES.has(mode)) {
+            continue;
+        }
+        const inputCost = readNumberField(entry, 'input_cost_per_token');
+        const outputCost = readNumberField(entry, 'output_cost_per_token');
+        if (inputCost === undefined || outputCost === undefined) {
+            continue;
+        }
+        const costPer1M = computeCostPer1MTokens(inputCost, outputCost);
+        registry_snapshot[modelKey] = costPer1M;
+        modelCount += 1;
+        const limits = parseModelLimits(entry);
+        if (limits !== undefined) {
+            storeLimitsAlias(registry_limits_snapshot, modelKey, limits);
+        }
+        const provider = readStringField(entry, 'litellm_provider');
+        if (provider !== undefined) {
+            registry_snapshot[`${provider}/${modelKey}`] = costPer1M;
+            if (limits !== undefined) {
+                storeLimitsAlias(registry_limits_snapshot, `${provider}/${modelKey}`, limits);
+            }
+        }
+    }
+    if (Object.keys(registry_snapshot).length === 0) {
+        throw new LitellmFetchError('LiteLLM pricing response contained no chat models with input/output token costs.');
+    }
+    return {
+        registry_snapshot,
+        registry_limits_snapshot,
+        model_count: modelCount,
+    };
+}
+/**
+ * Fetch LiteLLM pricing and build a PriceCatalog payload (does not persist).
+ */
+export async function fetchLitellmPriceCatalog(deps = {}) {
+    const fetchFn = deps.fetchFn ?? fetch;
+    const url = deps.pricingUrl ?? getLitellmPricingUrl();
+    let response;
+    try {
+        response = await fetchFn(url);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new LitellmFetchError(`Failed to fetch LiteLLM pricing from ${url}: ${detail}`);
+    }
+    if (!response.ok) {
+        throw new LitellmFetchError(`LiteLLM pricing fetch failed (${response.status} ${response.statusText}) from ${url}`);
+    }
+    let raw;
+    try {
+        raw = await response.json();
+    }
+    catch {
+        throw new LitellmFetchError(`LiteLLM pricing response from ${url} is not valid JSON.`);
+    }
+    const normalized = normalizeLitellmPricing(raw);
+    return {
+        catalog: {
+            registry_snapshot: normalized.registry_snapshot,
+            registry_limits_snapshot: normalized.registry_limits_snapshot,
+            user_overrides: {},
+            last_updated: new Date().toISOString(),
+            source: 'registry',
+        },
+        model_count: normalized.model_count,
+    };
+}
+//# sourceMappingURL=litellm-fetch.js.map

package/dist/infrastructure/pricing/litellm-fetch.js.map

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

package/dist/infrastructure/pricing/price-broker.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tri-tier price broker — FR-019 (T053).
+ *
+ * Resolves per-model pricing using a strict priority cascade:
+ *   1. Operator overrides (highest priority)
+ *   2. Registry snapshot (refreshed external data)
+ *   3. YAML/catalog fallback (ModelProfile.pricing.fallback_cost_per_1m)
+ *
+ * The broker is a pure function layer; it reads from the PriceCatalog
+ * and ModelProfile without side effects.
+ */
+import type { ModelProfile, ModelLimits, PriceCatalog, PriceSource } from '../../domain/types/index.js';
+export interface ResolvedPrice {
+    readonly model_id: string;
+    readonly cost_per_1m_tokens: number;
+    readonly source: PriceSource;
+}
+export interface ResolvedLimits {
+    readonly model_id: string;
+    readonly limits: ModelLimits;
+}
+/**
+ * Resolve effective context limits for a model.
+ *
+ * Priority: YAML/profile override → LiteLLM registry snapshot → tier default.
+ */
+export declare function resolveLimits(model: ModelProfile, catalog: PriceCatalog | null): ResolvedLimits;
+/**
+ * Apply resolved context limits to fleet profiles for routing gates (SP-092).
+ */
+export declare function applyCatalogLimitsToFleet(fleet: readonly ModelProfile[], catalog: PriceCatalog | null): ModelProfile[];
+/**
+ * Resolve the effective price for a single model.
+ *
+ * Priority: operator override → registry snapshot → catalog fallback.
+ * Always returns a price — the fallback from ModelProfile is guaranteed
+ * by schema to exist.
+ */
+export declare function resolvePrice(model: ModelProfile, catalog: PriceCatalog | null): ResolvedPrice;
+/**
+ * Resolve prices for the entire fleet in a single pass.
+ *
+ * Returns a Map keyed by model ID for O(1) lookup during scoring.
+ */
+export declare function resolveFleetPrices(fleet: readonly ModelProfile[], catalog: PriceCatalog | null): ReadonlyMap<string, ResolvedPrice>;
+/**
+ * Apply tri-tier resolved prices and context limits to fleet profiles.
+ * When no catalog is loaded, applies tier default limits only.
+ */
+export declare function applyCatalogPricesToFleet(fleet: readonly ModelProfile[], catalog: PriceCatalog | null): ModelProfile[];
+/**
+ * Resolve per-request cost rate for frugality scoring and telemetry (SP-096).
+ * Subscription-quota virtual cost takes precedence over API/catalog rates.
+ */
+export declare function resolveFrugalityCostPer1M(model: ModelProfile, catalog: PriceCatalog | null): number;
+//# sourceMappingURL=price-broker.d.ts.map

package/dist/infrastructure/pricing/price-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-broker.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/pricing/price-broker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGxG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAeD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,cAAc,CAkBhB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,YAAY,EAAE,CAQhB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,aAAa,CA2Bf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAMpC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,YAAY,EAAE,CAuBhB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,MAAM,CAKR"}

package/dist/infrastructure/pricing/price-broker.js

@@ -0,0 +1,133 @@
+/**
+ * Tri-tier price broker — FR-019 (T053).
+ *
+ * Resolves per-model pricing using a strict priority cascade:
+ *   1. Operator overrides (highest priority)
+ *   2. Registry snapshot (refreshed external data)
+ *   3. YAML/catalog fallback (ModelProfile.pricing.fallback_cost_per_1m)
+ *
+ * The broker is a pure function layer; it reads from the PriceCatalog
+ * and ModelProfile without side effects.
+ */
+import { getDefaultLimitsForTier } from '../../config/pi-model-mapper.js';
+function lookupRegistryLimits(model, catalog) {
+    const snapshot = catalog.registry_limits_snapshot;
+    if (!snapshot) {
+        return undefined;
+    }
+    const registryKey = model.pricing.registry_key ?? model.id;
+    return snapshot[registryKey] ?? snapshot[model.id];
+}
+/**
+ * Resolve effective context limits for a model.
+ *
+ * Priority: YAML/profile override → LiteLLM registry snapshot → tier default.
+ */
+export function resolveLimits(model, catalog) {
+    const yamlLimits = model.limits;
+    const registryLimits = catalog ? lookupRegistryLimits(model, catalog) : undefined;
+    const defaults = getDefaultLimitsForTier(model.tier);
+    return {
+        model_id: model.id,
+        limits: {
+            max_input_tokens: yamlLimits?.max_input_tokens ??
+                registryLimits?.max_input_tokens ??
+                defaults.max_input_tokens,
+            max_output_tokens: yamlLimits?.max_output_tokens ??
+                registryLimits?.max_output_tokens ??
+                defaults.max_output_tokens,
+        },
+    };
+}
+/**
+ * Apply resolved context limits to fleet profiles for routing gates (SP-092).
+ */
+export function applyCatalogLimitsToFleet(fleet, catalog) {
+    return fleet.map((profile) => {
+        const resolved = resolveLimits(profile, catalog);
+        return {
+            ...profile,
+            limits: resolved.limits,
+        };
+    });
+}
+/**
+ * Resolve the effective price for a single model.
+ *
+ * Priority: operator override → registry snapshot → catalog fallback.
+ * Always returns a price — the fallback from ModelProfile is guaranteed
+ * by schema to exist.
+ */
+export function resolvePrice(model, catalog) {
+    if (catalog) {
+        const override = catalog.user_overrides[model.id];
+        if (override !== undefined) {
+            return {
+                model_id: model.id,
+                cost_per_1m_tokens: override,
+                source: 'override',
+            };
+        }
+        const registryKey = model.pricing.registry_key ?? model.id;
+        const registryPrice = catalog.registry_snapshot[registryKey];
+        if (registryPrice !== undefined) {
+            return {
+                model_id: model.id,
+                cost_per_1m_tokens: registryPrice,
+                source: 'registry',
+            };
+        }
+    }
+    return {
+        model_id: model.id,
+        cost_per_1m_tokens: model.pricing.fallback_cost_per_1m,
+        source: 'yaml_fallback',
+    };
+}
+/**
+ * Resolve prices for the entire fleet in a single pass.
+ *
+ * Returns a Map keyed by model ID for O(1) lookup during scoring.
+ */
+export function resolveFleetPrices(fleet, catalog) {
+    const prices = new Map();
+    for (const model of fleet) {
+        prices.set(model.id, resolvePrice(model, catalog));
+    }
+    return prices;
+}
+/**
+ * Apply tri-tier resolved prices and context limits to fleet profiles.
+ * When no catalog is loaded, applies tier default limits only.
+ */
+export function applyCatalogPricesToFleet(fleet, catalog) {
+    if (!catalog) {
+        return applyCatalogLimitsToFleet(fleet, catalog);
+    }
+    const prices = resolveFleetPrices(fleet, catalog);
+    const priced = fleet.map((profile) => {
+        const resolved = prices.get(profile.id);
+        if (!resolved || resolved.source === 'yaml_fallback') {
+            return profile;
+        }
+        return {
+            ...profile,
+            pricing: {
+                ...profile.pricing,
+                fallback_cost_per_1m: resolved.cost_per_1m_tokens,
+            },
+        };
+    });
+    return applyCatalogLimitsToFleet(priced, catalog);
+}
+/**
+ * Resolve per-request cost rate for frugality scoring and telemetry (SP-096).
+ * Subscription-quota virtual cost takes precedence over API/catalog rates.
+ */
+export function resolveFrugalityCostPer1M(model, catalog) {
+    if (model.pricing.quota_cost_per_1m !== undefined) {
+        return model.pricing.quota_cost_per_1m;
+    }
+    return resolvePrice(model, catalog).cost_per_1m_tokens;
+}
+//# sourceMappingURL=price-broker.js.map

package/dist/infrastructure/pricing/price-broker.js.map

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

package/dist/infrastructure/pricing/pricing-monitor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pricing staleness monitor — FR-020 (T054).
+ *
+ * Checks whether the PriceCatalog's last_updated timestamp exceeds a
+ * configurable staleness threshold (default: 14 days). When stale,
+ * emits a structured warning for operator visibility.
+ *
+ * The monitor is stateless and side-effect-free beyond returning a
+ * diagnostic result. Callers (gateway, CLI, health-check) decide how
+ * to surface the warning.
+ */
+import type { PriceCatalog } from '../../domain/types/index.js';
+export interface StalenessResult {
+    readonly stale: boolean;
+    readonly age_days: number;
+    readonly threshold_days: number;
+    readonly warning?: string;
+}
+/**
+ * Evaluate pricing freshness against the configured threshold.
+ *
+ * @param catalog       Current price catalog, or null if none loaded.
+ * @param stalenessDays Operator-configured threshold (default 14).
+ * @param now           Reference time for testability.
+ */
+export declare function checkStaleness(catalog: PriceCatalog | null, stalenessDays?: number, now?: Date): StalenessResult;
+//# sourceMappingURL=pricing-monitor.d.ts.map

package/dist/infrastructure/pricing/pricing-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-monitor.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/pricing/pricing-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,aAAa,GAAE,MAAW,EAC1B,GAAG,GAAE,IAAiB,GACrB,eAAe,CA8BjB"}

package/dist/infrastructure/pricing/pricing-monitor.js

@@ -0,0 +1,46 @@
+/**
+ * Pricing staleness monitor — FR-020 (T054).
+ *
+ * Checks whether the PriceCatalog's last_updated timestamp exceeds a
+ * configurable staleness threshold (default: 14 days). When stale,
+ * emits a structured warning for operator visibility.
+ *
+ * The monitor is stateless and side-effect-free beyond returning a
+ * diagnostic result. Callers (gateway, CLI, health-check) decide how
+ * to surface the warning.
+ */
+const MS_PER_DAY = 86_400_000;
+/**
+ * Evaluate pricing freshness against the configured threshold.
+ *
+ * @param catalog       Current price catalog, or null if none loaded.
+ * @param stalenessDays Operator-configured threshold (default 14).
+ * @param now           Reference time for testability.
+ */
+export function checkStaleness(catalog, stalenessDays = 14, now = new Date()) {
+    if (!catalog) {
+        return {
+            stale: true,
+            age_days: Infinity,
+            threshold_days: stalenessDays,
+            warning: 'No pricing catalog loaded. Model costs will use YAML fallback values.',
+        };
+    }
+    const lastUpdated = new Date(catalog.last_updated);
+    const ageDays = (now.getTime() - lastUpdated.getTime()) / MS_PER_DAY;
+    if (ageDays > stalenessDays) {
+        return {
+            stale: true,
+            age_days: Math.round(ageDays * 10) / 10,
+            threshold_days: stalenessDays,
+            warning: `Pricing data is ${Math.round(ageDays)} days old (threshold: ${stalenessDays} days). ` +
+                'Consider refreshing registry rates to ensure accurate cost estimation.',
+        };
+    }
+    return {
+        stale: false,
+        age_days: Math.round(ageDays * 10) / 10,
+        threshold_days: stalenessDays,
+    };
+}
+//# sourceMappingURL=pricing-monitor.js.map

package/dist/infrastructure/pricing/pricing-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-monitor.js","sourceRoot":"","sources":["../../../src/infrastructure/pricing/pricing-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,UAAU,GAAG,UAAU,CAAC;AAS9B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA4B,EAC5B,gBAAwB,EAAE,EAC1B,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,QAAQ;YAClB,cAAc,EAAE,aAAa;YAC7B,OAAO,EACL,uEAAuE;SAC1E,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;IAErE,IAAI,OAAO,GAAG,aAAa,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE;YACvC,cAAc,EAAE,aAAa;YAC7B,OAAO,EACL,mBAAmB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,yBAAyB,aAAa,UAAU;gBACtF,wEAAwE;SAC3E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE;QACvC,cAAc,EAAE,aAAa;KAC9B,CAAC;AACJ,CAAC"}

package/dist/infrastructure/telemetry/dataset-limits.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared retention bounds for routing dataset records (in-memory and SQLite).
+ * GitHub #8: 30 days / 10k rows.
+ */
+import type { RoutingDatasetRecord } from '../../domain/types/index.js';
+export declare const DATASET_WINDOW_DAYS = 30;
+export declare const DATASET_WINDOW_MS: number;
+export declare const DATASET_MAX_ENTRIES = 10000;
+/** Remove dataset entries older than the rolling window. */
+export declare function evictExpiredDatasetEntries(entries: RoutingDatasetRecord[], windowMs?: number): void;
+/** Make room for one more dataset entry before append. */
+export declare function makeDatasetRoom(entries: RoutingDatasetRecord[], maxEntries?: number, windowMs?: number): void;
+//# sourceMappingURL=dataset-limits.d.ts.map

package/dist/infrastructure/telemetry/dataset-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-limits.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/telemetry/dataset-limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,iBAAiB,QAA4C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,4DAA4D;AAC5D,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,QAAQ,GAAE,MAA0B,GACnC,IAAI,CAWN;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,oBAAoB,EAAE,EAC/B,UAAU,GAAE,MAA4B,EACxC,QAAQ,GAAE,MAA0B,GACnC,IAAI,CAKN"}

package/dist/infrastructure/telemetry/dataset-limits.js

@@ -0,0 +1,28 @@
+/**
+ * Shared retention bounds for routing dataset records (in-memory and SQLite).
+ * GitHub #8: 30 days / 10k rows.
+ */
+export const DATASET_WINDOW_DAYS = 30;
+export const DATASET_WINDOW_MS = DATASET_WINDOW_DAYS * 24 * 60 * 60 * 1000;
+export const DATASET_MAX_ENTRIES = 10_000;
+/** Remove dataset entries older than the rolling window. */
+export function evictExpiredDatasetEntries(entries, windowMs = DATASET_WINDOW_MS) {
+    const cutoff = Date.now() - windowMs;
+    while (entries.length > 0) {
+        const oldest = entries[0];
+        if (new Date(oldest.timestamp).getTime() < cutoff) {
+            entries.shift();
+        }
+        else {
+            break;
+        }
+    }
+}
+/** Make room for one more dataset entry before append. */
+export function makeDatasetRoom(entries, maxEntries = DATASET_MAX_ENTRIES, windowMs = DATASET_WINDOW_MS) {
+    evictExpiredDatasetEntries(entries, windowMs);
+    while (entries.length >= maxEntries) {
+        entries.shift();
+    }
+}
+//# sourceMappingURL=dataset-limits.js.map

package/dist/infrastructure/telemetry/dataset-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-limits.js","sourceRoot":"","sources":["../../../src/infrastructure/telemetry/dataset-limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,UAAU,0BAA0B,CACxC,OAA+B,EAC/B,WAAmB,iBAAiB;IAEpC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;IAErC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC3B,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;YAClD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAC7B,OAA+B,EAC/B,aAAqB,mBAAmB,EACxC,WAAmB,iBAAiB;IAEpC,0BAA0B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/infrastructure/telemetry/dataset-recorder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Privacy-safe routing dataset recorder (SP-058).
+ *
+ * Maps routing decisions and feature sidecars to RoutingDatasetRecord when
+ * SMART_ROUTER_DATASET=1. Never stores prompt text, messages, or tool arguments.
+ *
+ * Optional install-local prompt fingerprints (SP-061) when
+ * SMART_ROUTER_DATASET_FINGERPRINT=1.
+ */
+import type { RoutingDatasetRecord, RoutingDecision, RoutingRequest } from '../../domain/types/index.js';
+import type { TierFeatureDatasetScalars } from '../../domain/routing/tier-features.js';
+import { type ContextFitObservabilityInput } from './routing-telemetry.js';
+export declare const DATASET_ENABLED_NOTIFY_MESSAGE = "Smart Router dataset mode is enabled. Recording routing metadata and feature fields only \u2014 prompt text, messages, and tool arguments are never stored.";
+export declare const DATASET_STATE_DIR = ".pi-smart-router";
+export declare const DATASET_PEPPER_FILENAME = ".dataset-key";
+export declare function isDatasetRecordingEnabled(): boolean;
+export declare function isDatasetFingerprintEnabled(): boolean;
+export declare function getDatasetPepperPath(cwd?: string): string;
+/** Load or create the install-local dataset pepper (never exported). */
+export declare function loadOrCreateDatasetPepper(cwd?: string): Buffer;
+/** Collapse whitespace and trim for stable duplicate detection. */
+export declare function normalizePromptForFingerprint(prompt: string): string;
+export declare function computePromptFingerprint(pepper: Buffer, prompt: string): string;
+export interface DatasetRecorderOptions {
+    readonly clock?: () => string;
+    readonly onRecord?: (record: RoutingDatasetRecord) => void;
+    readonly onFirstEnable?: () => void;
+    readonly cwd?: string;
+    readonly loadPepper?: (cwd: string) => Buffer;
+    readonly contextFitInput?: Omit<ContextFitObservabilityInput, 'request' | 'decision'>;
+}
+/** Map a completed routing decision to a privacy-safe dataset row. */
+export declare function buildDatasetRecord(request: RoutingRequest, decision: RoutingDecision, timestamp: string, promptFingerprint?: string | null, tierScalars?: TierFeatureDatasetScalars, contextFitInput?: Omit<ContextFitObservabilityInput, 'request' | 'decision'>): RoutingDatasetRecord;
+export declare class DatasetRecorder {
+    private readonly clock;
+    private readonly onRecord;
+    private readonly onFirstEnable;
+    private readonly cwd;
+    private readonly loadPepper;
+    private readonly contextFitInput;
+    private enabledNotified;
+    private pepper;
+    constructor(options?: DatasetRecorderOptions);
+    private getPepper;
+    /** Record a routing decision when dataset mode is enabled; no-op when off. */
+    record(request: RoutingRequest, decision: RoutingDecision): RoutingDatasetRecord | null;
+}
+//# sourceMappingURL=dataset-recorder.d.ts.map

package/dist/infrastructure/telemetry/dataset-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-recorder.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/telemetry/dataset-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,8BAA8B,gKAC+G,CAAC;AAE3J,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAItD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,2BAA2B,IAAI,OAAO,CAKrD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAExE;AAED,wEAAwE;AACxE,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAY7E;AAED,mEAAmE;AACnE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI/E;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;CACvF;AAmBD,sEAAsE;AACtE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,iBAAiB,GAAE,MAAM,GAAG,IAAW,EACvC,WAAW,CAAC,EAAE,yBAAyB,EACvC,eAAe,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,GAAG,UAAU,CAAC,GAC3E,oBAAoB,CAmDtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuD;IAChF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyE;IACzG,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,CAAC,EAAE,sBAAsB;IAS5C,OAAO,CAAC,SAAS;IAOjB,8EAA8E;IAC9E,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,GAAG,oBAAoB,GAAG,IAAI;CAyBxF"}