@oeronteros-1/opencode-orchestra 1.0.22 → 1.0.23

package/dist/pricing/openrouter.js

@@ -0,0 +1,150 @@
+// OpenRouter pricing source. The models list is a public, keyless endpoint;
+// prices arrive as decimal strings in USD per single token and are converted
+// here to USD per 1M tokens, matching the plugin's internal unit everywhere
+// else. Per-request prices (request/image/audio) stay in their own units and
+// are never multiplied by token counts. Fetching is cached with a TTL and
+// single-flight; failures keep the previous snapshot so offline estimation
+// keeps working.
+import { normalizeModelName, splitProviderId } from "./model-match.js";
+function toPrice(value) {
+    if (typeof value !== "string" || value.trim() === "")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;
+}
+/** Convert a per-token string price to USD per 1M, rounded to micro-dollars. */
+function toPerMillion(value) {
+    const parsed = toPrice(value);
+    if (parsed === undefined)
+        return undefined;
+    return Math.round(parsed * 1_000_000 * 1_000_000) / 1_000_000;
+}
+function splitVariant(id) {
+    const idx = id.lastIndexOf(":");
+    if (idx === -1)
+        return { base: id };
+    return { base: id.slice(0, idx), variant: id.slice(idx + 1) };
+}
+/**
+ * Parse an OpenRouter `/api/v1/models` response into normalized models.
+ * Missing or invalid price fields become undefined (never 0, never throws).
+ */
+export function parseOpenRouterModels(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return [];
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return [];
+    const data = parsed.data;
+    if (!Array.isArray(data))
+        return [];
+    const models = [];
+    for (const item of data) {
+        if (typeof item !== "object" || item === null)
+            continue;
+        const raw = item;
+        if (typeof raw.id !== "string" || !raw.id)
+            continue;
+        const { base, variant } = splitVariant(raw.id);
+        const pricingRaw = (typeof raw.pricing === "object" && raw.pricing !== null ? raw.pricing : {});
+        const input = toPerMillion(pricingRaw.prompt);
+        const output = toPerMillion(pricingRaw.completion);
+        const cacheRead = toPerMillion(pricingRaw.input_cache_read);
+        const reasoning = toPerMillion(pricingRaw.internal_reasoning);
+        const request = toPrice(pricingRaw.request);
+        const image = toPrice(pricingRaw.image);
+        const audio = toPrice(pricingRaw.audio);
+        models.push({
+            id: base.toLowerCase(),
+            ...(variant ? { variant } : {}),
+            ...(typeof raw.name === "string" && raw.name ? { name: raw.name } : {}),
+            ...(typeof raw.canonical_slug === "string" && raw.canonical_slug
+                ? { canonicalSlug: splitProviderId(raw.canonical_slug).rest }
+                : {}),
+            ...(typeof raw.context_length === "number" ? { contextLength: raw.context_length } : {}),
+            isFreeVariant: variant === "free",
+            pricing: {
+                ...(input !== undefined ? { input } : {}),
+                ...(output !== undefined ? { output } : {}),
+                ...(cacheRead !== undefined ? { cacheRead } : {}),
+                ...(reasoning !== undefined ? { reasoning } : {}),
+                ...(request !== undefined ? { request } : {}),
+                ...(image !== undefined ? { image } : {}),
+                ...(audio !== undefined ? { audio } : {}),
+            },
+        });
+    }
+    return models;
+}
+/** Build matchModel catalog entries from a parsed OpenRouter list. */
+export function toModelEntries(models) {
+    const entries = [];
+    for (const model of models) {
+        const { provider, rest } = splitProviderId(model.id);
+        const aliases = [];
+        if (model.name)
+            aliases.push(model.name);
+        if (model.canonicalSlug)
+            aliases.push(model.canonicalSlug);
+        entries.push({
+            id: normalizeModelName(rest),
+            ...(provider ? { provider } : {}),
+            ...(aliases.length ? { aliases } : {}),
+        });
+    }
+    return entries;
+}
+export const DEFAULT_OPENROUTER_ENDPOINT = "https://openrouter.ai/api/v1/models";
+/**
+ * TTL-on-data cache over the OpenRouter models list. Concurrent callers
+ * share one in-flight fetch; a failed refresh keeps the previous snapshot.
+ */
+export function createOpenRouterCache(options) {
+    const endpoint = options.endpoint ?? DEFAULT_OPENROUTER_ENDPOINT;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const now = options.now ?? Date.now;
+    let models;
+    let fetchedAt;
+    let lastError;
+    let inFlight;
+    const refresh = () => {
+        inFlight = (async () => {
+            try {
+                const response = await fetchImpl(endpoint);
+                if (!response.ok)
+                    throw new Error(`openrouter ${response.status}`);
+                models = parseOpenRouterModels(await response.text());
+                fetchedAt = now();
+                lastError = undefined;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : String(error);
+            }
+            return models ?? [];
+        })().finally(() => {
+            inFlight = undefined;
+        });
+        return inFlight;
+    };
+    const getModels = (force = false) => {
+        if (inFlight)
+            return inFlight;
+        if (force || models === undefined || now() - (fetchedAt ?? 0) >= options.ttlMs)
+            return refresh();
+        return Promise.resolve(models);
+    };
+    return {
+        getModels,
+        get fetchedAt() {
+            return fetchedAt;
+        },
+        get lastError() {
+            return lastError;
+        },
+    };
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/pricing/openrouter.js.map

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

package/dist/pricing/resolver.d.ts

@@ -0,0 +1,50 @@
+import type { PriceSnapshot } from "../routing/pricing/prices.js";
+import type { ModelCost } from "../config/schema.js";
+import { type MatchMethod } from "./model-match.js";
+import { type OpenRouterModel } from "./openrouter.js";
+import type { PricingResolution } from "./cost.js";
+export interface ModelAliasEntry {
+    /** Canonical model id the aliases point at, e.g. "gpt-5-6-sol". */
+    canonical: string;
+    /** Raw names that map to the canonical id. */
+    aliases: string[];
+}
+export interface OpenRouterSource {
+    getModels(force?: boolean): Promise<OpenRouterModel[]>;
+}
+export interface ResolverConfig {
+    snapshot: PriceSnapshot;
+    aliases?: ModelAliasEntry[];
+    openRouter?: OpenRouterSource;
+}
+export interface ResolverInput {
+    /** Raw id, optionally provider-prefixed ("CX/GPT-5.6 Sol"). */
+    id?: string;
+    providerID?: string;
+    modelID?: string;
+    /** Config-declared cost class when known (routing pools, provider catalog). */
+    declaredCost?: ModelCost;
+    /** Explicit configured USD/1M prices; beat every lookup source. */
+    explicitPrice?: {
+        input: number;
+        output: number;
+    };
+}
+export interface ResolvedPricing extends PricingResolution {
+    /** Canonical normalized model id ("gpt-5-6-sol"). */
+    canonicalId?: string;
+    /** Where the price came from. */
+    source?: "config" | "snapshot" | "openrouter";
+    /** How the model identity was matched. */
+    method?: MatchMethod;
+    familyAmbiguous?: boolean;
+    /** True when the async OpenRouter tier should still be tried. */
+    needsFallback?: boolean;
+}
+/** Sync tier: config declarations + user aliases + the price snapshot. */
+export declare function resolvePricingSync(input: ResolverInput, config: ResolverConfig): ResolvedPricing;
+/**
+ * Full resolution: sync tier first, then the cached OpenRouter catalog when
+ * the price is still unknown. Never fetches when OpenRouter is disabled.
+ */
+export declare function resolvePricing(input: ResolverInput, config: ResolverConfig): Promise<ResolvedPricing>;

package/dist/pricing/resolver.js

@@ -0,0 +1,145 @@
+// Pricing Resolver: turns a raw model id (any spelling, any provider prefix)
+// into a PricingResolution. Precedence, highest first:
+//
+//   1. config-declared cost class (free / subscription)
+//   2. explicit configured price (priceInput/priceOutput)
+//   3. ":free" variant suffix in the raw id
+//   4. user-defined model aliases (they beat every external source)
+//   5. built-in / operator-refreshed price snapshot (provider pricing)
+//   6. OpenRouter fallback (opt-in; cached; async)
+//   7. unknown — tokens still counted, cost null, never silently free
+//
+// Free models and subscription models are priced $0 with their status kept;
+// "unknown" is a distinct state so callers can surface "no price" honestly.
+import { matchModel, normalizeModelName, parseModelId, splitProviderId, } from "./model-match.js";
+import { toModelEntries } from "./openrouter.js";
+function snapshotCatalog(snapshot) {
+    const entries = [];
+    const keyByEntryId = new Map();
+    for (const key of Object.keys(snapshot.prices)) {
+        const { provider, rest } = splitProviderId(key);
+        const entryId = normalizeModelName(rest);
+        entries.push({
+            id: entryId,
+            ...(provider ? { provider: normalizeModelName(provider) } : {}),
+        });
+        keyByEntryId.set(entryId, key);
+    }
+    return { entries, keyByEntryId };
+}
+function rawIdOf(input) {
+    if (input.id)
+        return input.id;
+    if (input.providerID && input.modelID)
+        return `${input.providerID}/${input.modelID}`;
+    return input.modelID ?? "";
+}
+function resolveFromSnapshot(entryId, method, catalog, snapshot) {
+    const key = catalog.keyByEntryId.get(entryId);
+    const price = key ? snapshot.prices[key] : undefined;
+    if (!key || !price) {
+        return { status: "unknown", canonicalId: entryId, method, needsFallback: true };
+    }
+    if (price.input === 0 && price.output === 0) {
+        return { status: "free", canonicalId: entryId, source: "snapshot", method };
+    }
+    return {
+        status: "paid",
+        input: price.input,
+        output: price.output,
+        canonicalId: entryId,
+        source: "snapshot",
+        method,
+    };
+}
+/** Sync tier: config declarations + user aliases + the price snapshot. */
+export function resolvePricingSync(input, config) {
+    const raw = rawIdOf(input);
+    const parsed = parseModelId(raw);
+    if (input.declaredCost === "subscription")
+        return { status: "subscription", canonicalId: parsed.model };
+    if (input.declaredCost === "free")
+        return { status: "free", canonicalId: parsed.model };
+    const explicit = input.explicitPrice;
+    if (explicit && explicit.input >= 0 && explicit.output >= 0) {
+        if (explicit.input === 0 && explicit.output === 0) {
+            return { status: "free", canonicalId: parsed.model, source: "config" };
+        }
+        return {
+            status: "paid",
+            input: explicit.input,
+            output: explicit.output,
+            canonicalId: parsed.model,
+            source: "config",
+        };
+    }
+    if (parsed.variant === "free")
+        return { status: "free", canonicalId: parsed.model };
+    const catalog = snapshotCatalog(config.snapshot);
+    for (const aliasEntry of config.aliases ?? []) {
+        const hit = (aliasEntry.aliases ?? []).some((alias) => normalizeModelName(alias) === parsed.model);
+        if (hit)
+            return resolveFromSnapshot(aliasEntry.canonical, "alias", catalog, config.snapshot);
+    }
+    const match = matchModel(raw, catalog.entries);
+    if (match.method !== "none") {
+        return resolveFromSnapshot(match.canonical, match.method, catalog, config.snapshot);
+    }
+    return {
+        status: "unknown",
+        canonicalId: match.canonical,
+        ...(match.familyAmbiguous ? { familyAmbiguous: true } : {}),
+        needsFallback: true,
+    };
+}
+function classifyOpenRouter(model, match) {
+    const pricing = model.pricing;
+    if (model.isFreeVariant) {
+        return { status: "free", canonicalId: match.canonical, source: "openrouter", method: match.method };
+    }
+    const hasMediaPrice = (pricing.request ?? 0) > 0 || (pricing.image ?? 0) > 0 || (pricing.audio ?? 0) > 0;
+    if (pricing.input !== undefined && pricing.output !== undefined) {
+        if (pricing.input === 0 && pricing.output === 0) {
+            // Zero token prices alone do not prove a model is free: media models
+            // bill per request/image instead. Keep those unknown, never silent $0.
+            if (hasMediaPrice) {
+                return { status: "unknown", canonicalId: match.canonical, source: "openrouter", method: match.method };
+            }
+            return { status: "free", canonicalId: match.canonical, source: "openrouter", method: match.method };
+        }
+        return {
+            status: "paid",
+            input: pricing.input,
+            output: pricing.output,
+            ...(pricing.cacheRead !== undefined ? { cacheRead: pricing.cacheRead } : {}),
+            ...(pricing.reasoning !== undefined ? { reasoning: pricing.reasoning } : {}),
+            canonicalId: match.canonical,
+            source: "openrouter",
+            method: match.method,
+        };
+    }
+    return { status: "unknown", canonicalId: match.canonical, source: "openrouter", method: match.method };
+}
+/**
+ * Full resolution: sync tier first, then the cached OpenRouter catalog when
+ * the price is still unknown. Never fetches when OpenRouter is disabled.
+ */
+export async function resolvePricing(input, config) {
+    const sync = resolvePricingSync(input, config);
+    if (sync.status !== "unknown" || !sync.needsFallback || !config.openRouter)
+        return sync;
+    const models = await config.openRouter.getModels(false);
+    const entries = toModelEntries(models);
+    const match = matchModel(rawIdOf(input), entries);
+    if (match.method === "none")
+        return sync;
+    const modelByEntryId = new Map();
+    for (const model of models) {
+        modelByEntryId.set(normalizeModelName(splitProviderId(model.id).rest), model);
+    }
+    const model = modelByEntryId.get(match.canonical);
+    if (!model)
+        return sync;
+    return classifyOpenRouter(model, { canonical: match.canonical, method: match.method });
+}
+//# sourceMappingURL=resolver.js.map

package/dist/pricing/resolver.js.map

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

package/dist/routing/pricing/estimate.d.ts

@@ -2,6 +2,7 @@ import type { BudgetMode, ModelCandidateInput } from "../../config/schema.js";
 import { resolveModel } from "../model-resolver.js";
 import type { PriceSnapshot } from "./prices.js";
 import type { TaskPlan } from "../planner.js";
+import { type ModelAliasEntry, type OpenRouterSource } from "../../pricing/resolver.js";
 export interface PriceResolution {
     /** Price source used for the estimate (where a paid price was found). */
     source: "snapshot" | "remote";
@@ -34,6 +35,10 @@ export interface CostEstimateInput {
     workerCapabilityOf?: (worker: string) => Parameters<typeof resolveModel>[0]["capability"];
     snapshot: PriceSnapshot;
     tokens?: TokenEstimates;
+    /** User-defined model aliases (config pricing.aliases). */
+    aliases?: ModelAliasEntry[];
+    /** Optional OpenRouter fallback source (config pricing.openrouter). */
+    openRouter?: OpenRouterSource;
 }
 export interface CostBreakdown {
     workers: number;
@@ -43,6 +48,14 @@ export interface CostBreakdown {
     subtotal: number;
     /** Conservative +20% buffer for retries / cache misses / reasoning tokens. */
     total: number;
+    /** Calls whose price could not be determined; excluded from all totals. */
+    unknownCalls: number;
+    /** Calls priced $0 because the model is free (tokens still counted). */
+    freeCalls: number;
+    /** Calls priced $0 because the model runs inside a subscription. */
+    subscriptionCalls: number;
+    /** Calls priced with a known USD rate. */
+    paidCalls: number;
 }
 export interface CostEstimate {
     budget: BudgetMode;
@@ -52,7 +65,7 @@ export interface CostEstimate {
     /** Human-readable summary line for pre-run confirmation. */
     summary: string;
 }
-export declare function estimateCost(input: CostEstimateInput): CostEstimate;
+export declare function estimateCost(input: CostEstimateInput): Promise<CostEstimate>;
 /** Compare an estimate against a warning threshold; returns a pre-run message. */
 export declare function formatEstimateWarning(estimate: CostEstimate, thresholdUSD?: number): string | undefined;
 /** Total combined price for a model id or 0 when unknown/free. */

package/dist/routing/pricing/estimate.js

@@ -1,5 +1,6 @@
-import { normalizeCandidate, resolveModel } from "../model-resolver.js";
-import { lookupPrice, combinedPrice } from "./prices.js";
+import { resolveModel } from "../model-resolver.js";
+import { combinedPrice, lookupPrice } from "./prices.js";
+import { resolvePricing } from "../../pricing/resolver.js";
 export const DEFAULT_TOKEN_ESTIMATES = {
     workerTokens: 4_000,
     leadTokens: 6_000,
@@ -13,7 +14,12 @@ function costOfTokens(price, tokens) {
     const input = tokens * 0.75;
     return (input * price.input + output * price.output) / 1_000_000;
 }
-function resolvePoolPriceId(pool, budget, capability, snapshot) {
+/**
+ * Resolve the pool's chosen model for a budget/capability, then resolve its
+ * pricing through the full ladder (config declarations -> explicit price ->
+ * aliases -> provider snapshot -> OpenRouter fallback).
+ */
+async function resolvePoolPricing(pool, budget, capability, config) {
     const resolved = resolveModel({
         pool,
         capability,
@@ -28,28 +34,78 @@ function resolvePoolPriceId(pool, budget, capability, snapshot) {
     });
     if (!resolved)
         return {};
-    const configuredPrice = resolved.priceInput !== undefined && resolved.priceOutput !== undefined
-        ? { input: resolved.priceInput, output: resolved.priceOutput }
-        : undefined;
-    const price = configuredPrice ?? lookupPrice(snapshot, resolved.id);
-    // Only paid models carry a dollar estimate; free/subscription resolve to 0.
-    const resolvedPrice = resolved.cost === "paid" ? price : undefined;
-    return { id: resolved.id, ...(resolvedPrice ? { price: resolvedPrice } : {}) };
+    const input = {
+        id: resolved.id,
+        declaredCost: resolved.cost,
+        ...(resolved.priceInput !== undefined && resolved.priceOutput !== undefined
+            ? { explicitPrice: { input: resolved.priceInput, output: resolved.priceOutput } }
+            : {}),
+    };
+    const resolution = await resolvePricing(input, config);
+    return { id: resolved.id, resolution };
 }
-export function estimateCost(input) {
+export async function estimateCost(input) {
     const tokens = input.tokens ?? DEFAULT_TOKEN_ESTIMATES;
-    const lead = resolvePoolPriceId(input.leadPool, input.budget, "reasoning", input.snapshot);
-    const judge = resolvePoolPriceId(input.judgePool, input.budget, "review", input.snapshot);
-    const workersCost = input.plan.nodes.reduce((sum, node) => {
+    const config = {
+        snapshot: input.snapshot,
+        ...(input.aliases?.length ? { aliases: input.aliases } : {}),
+        ...(input.openRouter ? { openRouter: input.openRouter } : {}),
+    };
+    const lead = await resolvePoolPricing(input.leadPool, input.budget, "reasoning", config);
+    const judge = await resolvePoolPricing(input.judgePool, input.budget, "review", config);
+    let workersCost = 0;
+    let paidCalls = 0;
+    let freeCalls = 0;
+    let subscriptionCalls = 0;
+    let unknownCalls = 0;
+    for (const node of input.plan.nodes) {
         const poolKey = input.workerPoolOf(node.worker);
         const pool = input.workerPools[poolKey] ?? [];
         const capability = input.workerCapabilityOf?.(node.worker)
             ?? (poolKey === "image" ? "image" : poolKey === "vision" ? "vision" : poolKey === "research" ? "research" : poolKey === "reasoning" ? "reasoning" : "code");
-        const { price } = resolvePoolPriceId(pool, input.budget, capability, input.snapshot);
-        return sum + costOfTokens(price, tokens.workerTokens);
-    }, 0);
-    const leadCost = costOfTokens(lead.price, tokens.leadTokens);
-    const judgeCost = costOfTokens(judge.price, tokens.judgeTokens);
+        const { resolution } = await resolvePoolPricing(pool, input.budget, capability, config);
+        if (!resolution)
+            continue;
+        if (resolution.status === "paid") {
+            workersCost += costOfTokens({ input: resolution.input ?? 0, output: resolution.output ?? 0 }, tokens.workerTokens);
+            paidCalls += 1;
+        }
+        else if (resolution.status === "free") {
+            freeCalls += 1;
+        }
+        else if (resolution.status === "subscription") {
+            subscriptionCalls += 1;
+        }
+        else {
+            unknownCalls += 1;
+        }
+    }
+    const leadCost = lead.resolution?.status === "paid"
+        ? costOfTokens({ input: lead.resolution.input ?? 0, output: lead.resolution.output ?? 0 }, tokens.leadTokens)
+        : 0;
+    const judgeCost = judge.resolution?.status === "paid"
+        ? costOfTokens({ input: judge.resolution.input ?? 0, output: judge.resolution.output ?? 0 }, tokens.judgeTokens)
+        : 0;
+    if (lead.resolution) {
+        if (lead.resolution.status === "paid")
+            paidCalls += 1;
+        else if (lead.resolution.status === "free")
+            freeCalls += 1;
+        else if (lead.resolution.status === "subscription")
+            subscriptionCalls += 1;
+        else
+            unknownCalls += 1;
+    }
+    if (judge.resolution) {
+        if (judge.resolution.status === "paid")
+            paidCalls += 1;
+        else if (judge.resolution.status === "free")
+            freeCalls += 1;
+        else if (judge.resolution.status === "subscription")
+            subscriptionCalls += 1;
+        else
+            unknownCalls += 1;
+    }
     const subtotal = workersCost + leadCost + judgeCost;
     const total = subtotal * 1.2;
     const breakdown = {
@@ -59,12 +115,17 @@ export function estimateCost(input) {
         judgeCost,
         subtotal,
         total,
+        unknownCalls,
+        freeCalls,
+        subscriptionCalls,
+        paidCalls,
     };
+    const unknownNote = unknownCalls > 0 ? `, ${unknownCalls} call(s) with unknown price excluded` : "";
     return {
         budget: input.budget,
         total,
         breakdown,
-        summary: `This task in ${input.budget} mode will cost roughly $${total.toFixed(2)} (${breakdown.workers} worker calls, lead, ${judge.price ? "plus judge" : "no judge"} arbitration).`,
+        summary: `This task in ${input.budget} mode will cost roughly $${total.toFixed(2)} (${breakdown.workers} worker calls, lead, ${judge.resolution?.status === "paid" ? "plus judge" : "no judge"} arbitration${unknownNote}).`,
     };
 }
 /** Compare an estimate against a warning threshold; returns a pre-run message. */

package/dist/routing/pricing/estimate.js.map

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

package/dist/telemetry/ledger.d.ts

@@ -1,4 +1,5 @@
 import type { ModelCandidateInput, ProfileName } from "../config/schema.js";
+import type { PricingStatus } from "../pricing/cost.js";
 export interface TokenUsage {
     input: number;
     output: number;
@@ -17,6 +18,8 @@ export interface MessageUsage {
     completedAt?: number;
     finish?: string;
     tokens: TokenUsage;
+    /** How pricing was classified at record time (unknown = no rate found). */
+    pricingStatus?: PricingStatus;
     /** Opt-in debug text: only recorded when telemetry.storeTexts is enabled. */
     prompt?: string;
     reply?: string;
@@ -27,6 +30,7 @@ export interface SessionLedger {
     premiumEscalations: number;
     estimatedPaidUsage: number;
     freeWorkerCalls: number;
+    unknownPriceCalls: number;
     consensus?: number;
     messages: Record<string, MessageUsage>;
 }
@@ -57,9 +61,10 @@ export declare class Ledger {
     readonly stateFile: string;
     private readonly storeTexts;
     private readonly modelCosts;
+    private readonly pricingStatusOf;
     private state?;
     private queue;
-    constructor(directory: string, telemetryDirectory: string, enabled: boolean, pools: ModelCandidateInput[][], storeTexts?: boolean);
+    constructor(directory: string, telemetryDirectory: string, enabled: boolean, pools: ModelCandidateInput[][], storeTexts?: boolean, pricingStatusOf?: (providerID: string | undefined, modelID: string | undefined) => PricingStatus | undefined);
     private load;
     private save;
     private mutate;