@intelligo-dev/executions 1.0.0-beta.1 → 1.0.0-beta.13

package/dist/pricing.d.ts

@@ -1,159 +1,129 @@
 /**
  * Model registry and execution cost accounting.
  *
- * This lives in `executions` rather than beside the provider clients
- * because it is not AI code: it is what an execution costs. The
- * boundary records actor, workspace, capability, usage and cost
- * (ADR-0003), and the price of a token is the last of those.
+ * A leaf: no database, no provider SDK. Its one import is
+ * `@intelligo-dev/core/registry`, which is itself dependency-free, so
+ * `@intelligo-dev/executions/pricing` is something a client bundle can
+ * read a display name or a price from without pulling in Drizzle.
  *
- * Deliberately a leaf module — no database, no provider SDK, no
- * imports at all — and reachable as `@intelligo-dev/executions/pricing`
- * so a client bundle can read a display name or a price without
- * pulling in Drizzle. `@intelligo-dev/ai` re-exports it, so the ids that
- * pick a provider and the ids that carry a price stay one list; two
- * lists is how a model runs on Gemini and bills at Claude rates.
+ * The registry is open: a product registers any model it runs, and
+ * `registerModels(DEFAULT_MODELS)` from the composition root registers
+ * the shipped catalogue. Nothing self-registers. An id with no price
+ * throws at the point where the price is needed, naming the id, rather
+ * than billing at a guessed rate.
  */
-/**
- * Model configuration with display information and cost tracking
- *
- * 6 models, 3 providers: Google (2), OpenAI (3), Anthropic (1)
- */
-export declare const MODEL_CONFIGS: {
-    readonly "google/gemini-2.5-flash": {
-        readonly provider: "google";
-        readonly model: "gemini-2.5-flash";
-        readonly displayName: "Gemini 2.5 Flash";
-        readonly costPerMInputTokens: 0.3;
-        readonly costPerMOutputTokens: 2.5;
-        readonly capabilities: {
-            readonly thinking: true;
-            readonly toolCall: true;
-            readonly vision: true;
-            readonly webSearch: true;
-            readonly codeExec: true;
-        };
-    };
-    readonly "google/gemini-2.5-pro": {
-        readonly provider: "google";
-        readonly model: "gemini-2.5-pro";
-        readonly displayName: "Gemini 2.5 Pro";
-        readonly costPerMInputTokens: 1.25;
-        readonly costPerMOutputTokens: 10;
-        readonly capabilities: {
-            readonly thinking: true;
-            readonly toolCall: true;
-            readonly vision: true;
-            readonly webSearch: true;
-            readonly codeExec: true;
-        };
-    };
-    readonly "openai/gpt-5-mini": {
-        readonly provider: "openai";
-        readonly model: "gpt-5-mini";
-        readonly displayName: "GPT-5 Mini";
-        readonly costPerMInputTokens: 0.25;
-        readonly costPerMOutputTokens: 2;
-        readonly capabilities: {
-            readonly thinking: true;
-            readonly toolCall: true;
-            readonly vision: true;
-            readonly webSearch: false;
-            readonly codeExec: false;
-        };
-    };
-    readonly "openai/gpt-5.4-mini": {
-        readonly provider: "openai";
-        readonly model: "gpt-5.4-mini";
-        readonly displayName: "GPT-5.4 Mini";
-        readonly costPerMInputTokens: 0.75;
-        readonly costPerMOutputTokens: 4.5;
-        readonly capabilities: {
-            readonly thinking: true;
-            readonly toolCall: true;
-            readonly vision: true;
-            readonly webSearch: true;
-            readonly codeExec: true;
-        };
-    };
-    readonly "openai/o4-mini": {
-        readonly provider: "openai";
-        readonly model: "o4-mini";
-        readonly displayName: "o4-mini";
-        readonly costPerMInputTokens: 1.1;
-        readonly costPerMOutputTokens: 4.4;
-        readonly capabilities: {
-            readonly thinking: true;
-            readonly toolCall: true;
-            readonly vision: true;
-            readonly webSearch: true;
-            readonly codeExec: true;
-        };
-    };
-    readonly "anthropic/claude-sonnet-4-6": {
-        readonly provider: "anthropic";
-        readonly model: "claude-sonnet-4-6-20260214";
-        readonly displayName: "Claude Sonnet 4.6";
-        readonly costPerMInputTokens: 3;
-        readonly costPerMOutputTokens: 15;
-        readonly capabilities: {
-            readonly thinking: true;
-            readonly toolCall: true;
-            readonly vision: true;
-            readonly webSearch: true;
-            readonly codeExec: true;
-        };
-    };
+import { type CurrencyCode, type Money } from "@intelligo-dev/core/money";
+export type ModelCapabilities = {
+    thinking: boolean;
+    toolCall: boolean;
+    vision: boolean;
+    webSearch: boolean;
+    codeExec: boolean;
+};
+export type ModelPricing = {
+    /** Provider-prefixed id, e.g. `google/gemini-2.5-flash`. */
+    id: string;
+    provider: string;
+    /** The id the provider's own SDK expects, which is often dated. */
+    model: string;
+    displayName: string;
+    /** USD per million input tokens, as the provider quotes it. */
+    costPerMInputTokens: number;
+    /** USD per million output tokens. */
+    costPerMOutputTokens: number;
+    /**
+     * The ceiling on streamed output used for worst-case pre-request
+     * estimation.
+     */
+    maxOutputTokens: number;
+    capabilities: ModelCapabilities;
 };
-export type ModelId = keyof typeof MODEL_CONFIGS;
+/** A provider-prefixed model id; any string, because the registry is open. */
+export type ModelId = string;
+export declare class UnknownModelError extends Error {
+    readonly code = "unknown_model";
+    readonly modelId: string;
+    constructor(modelId: string, registered: readonly string[]);
+}
+/** Register (or replace) one model's price and capabilities. */
+export declare function registerModel(pricing: ModelPricing): void;
+export declare function registerModels(pricings: readonly ModelPricing[]): void;
+export declare function getModelPricing(modelId: string): ModelPricing | undefined;
+export declare function isModelRegistered(modelId: string): boolean;
+export declare function listModels(): readonly ModelPricing[];
+export declare function registeredModelIds(): readonly string[];
+/** For tests composing a fresh root. */
+export declare function clearModels(): void;
 /**
- * Calculate the dollar cost for a given model and token counts.
+ * The catalogue the framework ships, as data.
+ *
+ * Prices are the providers' published USD rates and go stale; a
+ * deployment that cares about the third decimal should register its own
+ * contracted rates over these.
  */
-export declare function calculateCost(modelId: string, inputTokens: number, outputTokens: number): number;
+export declare const DEFAULT_MODELS: readonly ModelPricing[];
+/** Providers quote in USD; every cost in this module starts there. */
+export declare const PROVIDER_CURRENCY: CurrencyCode;
 /**
- * Default billing margin multiplier applied on top of raw model cost.
- * Covers infra, tool overhead, FX volatility, and profit. Tunable per
- * deploy via billing_settings.margin_multiplier; this constant is the
- * fallback when the DB value is absent.
+ * What the provider charges for this call, in USD.
  *
- * INVARIANT — 65% gross margin floor (founder contract):
- *   gross_margin = 1 − 1/multiplier
- *   We must keep gross_margin ≥ 0.65 across every model in MODEL_CONFIGS,
- *   which means multiplier ≥ 1/0.35 ≈ 2.857. The current value of 4
- *   yields 75%, leaving comfortable buffer above the floor for FX moves
- *   and unexpected provider price hikes. The Vitest assertion in
- *   models.test.ts pins this — drop below 2.857 at your own risk.
+ * A price quoted per million tokens is, per token, that many millionths
+ * of a dollar — so the micros are `tokens × price`. The price is scaled
+ * to an integer first, because `100 × 1.1` in floating point is
+ * `110.00000000000001` and would round up to a micro nobody used.
+ * Fractions of a micro round up, which keeps the cheapest models from
+ * pricing a real call at nothing.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
-export declare const DEFAULT_BILLING_MARGIN = 4;
+export declare function providerCost(modelId: string, inputTokens: number, outputTokens: number): Money;
 /**
- * Default USD→MNT exchange rate fallback. Real value lives in
- * billing_settings.usd_to_mnt_rate and is read per request.
+ * What a deployment bills in: its currency, what one USD costs in it
+ * (micros, so `1_000_000` is a USD deployment and `920_000` a euro one
+ * at 0.92), and the margin over provider cost in basis points of a
+ * multiplier — `40_000` is 4×.
+ *
+ * Read per request from `billing_settings`; there is no ambient rate,
+ * because a framework that guesses an exchange rate is inventing money.
  */
-export declare const DEFAULT_USD_TO_MNT_RATE = 3450;
+export type BillingRate = {
+    currency: CurrencyCode;
+    usdRateMicros: number;
+    marginBp: number;
+};
 /**
- * Per-model maximum output budget used for worst-case pre-request cost
- * estimation in checkQuota. Numbers are conservative — cap on streamed
- * output tokens we'd actually let a single chat turn produce.
+ * `40_000` bp = 4× provider cost, the fallback margin when a
+ * deployment's `billing_settings` row names none.
+ *
+ * INVARIANT — a 65% gross margin floor:
+ *   gross_margin = 1 − 1/multiplier
+ * Keeping gross_margin ≥ 0.65 means a multiplier ≥ 1/0.35 ≈ 2.857. At
+ * 4× this yields 75%, leaving buffer above the floor for FX moves and
+ * provider price rises. `pricing.test.ts` pins it.
  */
-export declare const MODEL_OUTPUT_BUDGET: Record<ModelId, number>;
-export type ChargedAmount = {
-    rawCostUsd: number;
-    chargedMnt: number;
-};
+export declare const DEFAULT_MARGIN_BP = 40000;
 /**
- * Convert raw model cost to MNT user-facing charged amount.
+ * Provider cost and what the reader is charged for it: cost × margin,
+ * converted into the deployment's currency at its own rate.
  *
- * chargedMnt = ceil( rawCostUsd × margin × fxRate )
+ * Both steps round up, so a charge is at most two micros over — a
+ * millionth of a cent, against a fraction that would otherwise be the
+ * deployment's to eat on every request.
  *
- * The rounding is upward so micro-fractions never let a free request
- * slip through; over-billing per request is at most 1 MNT.
+ * @throws {UnknownModelError} when the id has no registered price.
+ * @throws {MoneyError} when a USD deployment passes a rate that is not 1.
  */
-export declare function calculateChargedMnt(modelId: string, inputTokens: number, outputTokens: number, fxRate?: number, margin?: number): ChargedAmount;
+export declare function chargeFor(modelId: string, inputTokens: number, outputTokens: number, rate: BillingRate): {
+    providerCost: Money;
+    charged: Money;
+};
 /**
- * Worst-case MNT cost estimate for a single chat turn against a given
- * model. Used by checkQuota to refuse requests whose ceiling cost would
- * exceed remaining balance, before we burn provider tokens. Uses the
- * full MODEL_OUTPUT_BUDGET as the output side and a generous 16K input
- * budget to cover system prompt + conversation history.
+ * The ceiling one turn on this model could charge, for admission:
+ * the model's own output limit against a 16K input budget (system
+ * prompt plus history). Refusing on the ceiling is what stops a turn
+ * that cannot be paid for from burning provider tokens first.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
-export declare function estimateWorstCaseChargedMnt(modelId: string, fxRate?: number, margin?: number): number;
+export declare function estimateWorstCaseCharge(modelId: string, rate: BillingRate): Money;
 //# sourceMappingURL=pricing.d.ts.map

package/dist/pricing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwFhB,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,aAAa,CAAC;AAEjD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAkBR;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAOvD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,MAAgC,EACxC,MAAM,GAAE,MAA+B,GACtC,aAAa,CAIf;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAgC,EACxC,MAAM,GAAE,MAA+B,GACtC,MAAM,CAKR"}
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,KAAK,EACX,MAAM,2BAA2B,CAAC;AAGnC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,iBAAiB,CAAC;CACjC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE;CAS3D;AAID,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAEzD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAEtE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,UAAU,IAAI,SAAS,YAAY,EAAE,CAEpD;AAED,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AAED,wCAAwC;AACxC,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAiGjD,CAAC;AASF,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,YAA8B,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,KAAK,CAWP;AAKD;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAIxC;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,WAAW,GAChB;IAAE,YAAY,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAUzC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,GAChB,KAAK,CAGP"}

package/dist/pricing.js

@@ -1,31 +1,70 @@
 /**
  * Model registry and execution cost accounting.
  *
- * This lives in `executions` rather than beside the provider clients
- * because it is not AI code: it is what an execution costs. The
- * boundary records actor, workspace, capability, usage and cost
- * (ADR-0003), and the price of a token is the last of those.
+ * A leaf: no database, no provider SDK. Its one import is
+ * `@intelligo-dev/core/registry`, which is itself dependency-free, so
+ * `@intelligo-dev/executions/pricing` is something a client bundle can
+ * read a display name or a price from without pulling in Drizzle.
  *
- * Deliberately a leaf module — no database, no provider SDK, no
- * imports at all — and reachable as `@intelligo-dev/executions/pricing`
- * so a client bundle can read a display name or a price without
- * pulling in Drizzle. `@intelligo-dev/ai` re-exports it, so the ids that
- * pick a provider and the ids that carry a price stay one list; two
- * lists is how a model runs on Gemini and bills at Claude rates.
+ * The registry is open: a product registers any model it runs, and
+ * `registerModels(DEFAULT_MODELS)` from the composition root registers
+ * the shipped catalogue. Nothing self-registers. An id with no price
+ * throws at the point where the price is needed, naming the id, rather
+ * than billing at a guessed rate.
  */
+import { convert, currency, money, } from "@intelligo-dev/core/money";
+import { createRegistry } from "@intelligo-dev/core/registry";
+export class UnknownModelError extends Error {
+    constructor(modelId, registered) {
+        super(`No price registered for model "${modelId}". ` +
+            `Registered: ${registered.length > 0 ? registered.join(", ") : "none"}. ` +
+            `Call registerModels(DEFAULT_MODELS) — or your own catalogue — from the composition root.`);
+        this.code = "unknown_model";
+        this.name = "UnknownModelError";
+        this.modelId = modelId;
+    }
+}
+const models = createRegistry("executions/model-pricing");
+/** Register (or replace) one model's price and capabilities. */
+export function registerModel(pricing) {
+    models.set(pricing.id, pricing);
+}
+export function registerModels(pricings) {
+    for (const pricing of pricings)
+        registerModel(pricing);
+}
+export function getModelPricing(modelId) {
+    return models.get(modelId);
+}
+export function isModelRegistered(modelId) {
+    return models.has(modelId);
+}
+export function listModels() {
+    return [...models.values()];
+}
+export function registeredModelIds() {
+    return [...models.keys()];
+}
+/** For tests composing a fresh root. */
+export function clearModels() {
+    models.clear();
+}
 /**
- * Model configuration with display information and cost tracking
+ * The catalogue the framework ships, as data.
  *
- * 6 models, 3 providers: Google (2), OpenAI (3), Anthropic (1)
+ * Prices are the providers' published USD rates and go stale; a
+ * deployment that cares about the third decimal should register its own
+ * contracted rates over these.
  */
-export const MODEL_CONFIGS = {
-    // Google Gemini
-    "google/gemini-2.5-flash": {
+export const DEFAULT_MODELS = [
+    {
+        id: "google/gemini-2.5-flash",
         provider: "google",
         model: "gemini-2.5-flash",
         displayName: "Gemini 2.5 Flash",
         costPerMInputTokens: 0.3,
         costPerMOutputTokens: 2.5,
+        maxOutputTokens: 8000,
         capabilities: {
             thinking: true,
             toolCall: true,
@@ -34,12 +73,14 @@ export const MODEL_CONFIGS = {
             codeExec: true,
         },
     },
-    "google/gemini-2.5-pro": {
+    {
+        id: "google/gemini-2.5-pro",
         provider: "google",
         model: "gemini-2.5-pro",
         displayName: "Gemini 2.5 Pro",
         costPerMInputTokens: 1.25,
         costPerMOutputTokens: 10,
+        maxOutputTokens: 8000,
         capabilities: {
             thinking: true,
             toolCall: true,
@@ -48,13 +89,14 @@ export const MODEL_CONFIGS = {
             codeExec: true,
         },
     },
-    // OpenAI
-    "openai/gpt-5-mini": {
+    {
+        id: "openai/gpt-5-mini",
         provider: "openai",
         model: "gpt-5-mini",
         displayName: "GPT-5 Mini",
         costPerMInputTokens: 0.25,
         costPerMOutputTokens: 2.0,
+        maxOutputTokens: 8000,
         capabilities: {
             thinking: true,
             toolCall: true,
@@ -63,12 +105,14 @@ export const MODEL_CONFIGS = {
             codeExec: false,
         },
     },
-    "openai/gpt-5.4-mini": {
+    {
+        id: "openai/gpt-5.4-mini",
         provider: "openai",
         model: "gpt-5.4-mini",
         displayName: "GPT-5.4 Mini",
         costPerMInputTokens: 0.75,
         costPerMOutputTokens: 4.5,
+        maxOutputTokens: 8000,
         capabilities: {
             thinking: true,
             toolCall: true,
@@ -77,12 +121,14 @@ export const MODEL_CONFIGS = {
             codeExec: true,
         },
     },
-    "openai/o4-mini": {
+    {
+        id: "openai/o4-mini",
         provider: "openai",
         model: "o4-mini",
         displayName: "o4-mini",
         costPerMInputTokens: 1.1,
         costPerMOutputTokens: 4.4,
+        maxOutputTokens: 8000,
         capabilities: {
             thinking: true,
             toolCall: true,
@@ -91,13 +137,14 @@ export const MODEL_CONFIGS = {
             codeExec: true,
         },
     },
-    // Anthropic
-    "anthropic/claude-sonnet-4-6": {
+    {
+        id: "anthropic/claude-sonnet-4-6",
         provider: "anthropic",
         model: "claude-sonnet-4-6-20260214",
         displayName: "Claude Sonnet 4.6",
         costPerMInputTokens: 3.0,
         costPerMOutputTokens: 15.0,
+        maxOutputTokens: 8000,
         capabilities: {
             thinking: true,
             toolCall: true,
@@ -106,82 +153,79 @@ export const MODEL_CONFIGS = {
             codeExec: true,
         },
     },
-};
+];
+/** The price of a model, or a loud failure naming the id. */
+function requireModel(modelId) {
+    const pricing = models.get(modelId);
+    if (!pricing)
+        throw new UnknownModelError(modelId, registeredModelIds());
+    return pricing;
+}
+/** Providers quote in USD; every cost in this module starts there. */
+export const PROVIDER_CURRENCY = currency("USD");
 /**
- * Calculate the dollar cost for a given model and token counts.
+ * What the provider charges for this call, in USD.
+ *
+ * A price quoted per million tokens is, per token, that many millionths
+ * of a dollar — so the micros are `tokens × price`. The price is scaled
+ * to an integer first, because `100 × 1.1` in floating point is
+ * `110.00000000000001` and would round up to a micro nobody used.
+ * Fractions of a micro round up, which keeps the cheapest models from
+ * pricing a real call at nothing.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
-export function calculateCost(modelId, inputTokens, outputTokens) {
-    const config = MODEL_CONFIGS[modelId];
-    if (!config) {
-        // Loud fallback: an unknown model ID means somewhere upstream is
-        // shipping a stale string that doesn't match MODEL_CONFIGS. We
-        // price it at the highest known rate so we don't accidentally give
-        // away expensive completions for free, but the warning here is the
-        // contract — silent fallback is how we ended up over-billing every
-        // free Gemini turn at Claude prices.
-        console.warn(`[calculateCost] Unknown model "${modelId}" — pricing at worst-case Claude rate ($3/$15 per M). Add it to MODEL_CONFIGS.`);
-        return (inputTokens / 1000000) * 3.0 + (outputTokens / 1000000) * 15.0;
-    }
-    return ((inputTokens / 1000000) * config.costPerMInputTokens +
-        (outputTokens / 1000000) * config.costPerMOutputTokens);
+export function providerCost(modelId, inputTokens, outputTokens) {
+    const config = requireModel(modelId);
+    const scaled = (price) => Math.round(price * PRICE_SCALE);
+    return money(Math.ceil((inputTokens * scaled(config.costPerMInputTokens) +
+        outputTokens * scaled(config.costPerMOutputTokens)) /
+        PRICE_SCALE), PROVIDER_CURRENCY);
 }
+/** Prices carry at most six decimals of a dollar per million tokens. */
+const PRICE_SCALE = 1000000;
 /**
- * Default billing margin multiplier applied on top of raw model cost.
- * Covers infra, tool overhead, FX volatility, and profit. Tunable per
- * deploy via billing_settings.margin_multiplier; this constant is the
- * fallback when the DB value is absent.
+ * `40_000` bp = 4× provider cost, the fallback margin when a
+ * deployment's `billing_settings` row names none.
  *
- * INVARIANT — 65% gross margin floor (founder contract):
+ * INVARIANT — a 65% gross margin floor:
  *   gross_margin = 1 − 1/multiplier
- *   We must keep gross_margin ≥ 0.65 across every model in MODEL_CONFIGS,
- *   which means multiplier ≥ 1/0.35 ≈ 2.857. The current value of 4
- *   yields 75%, leaving comfortable buffer above the floor for FX moves
- *   and unexpected provider price hikes. The Vitest assertion in
- *   models.test.ts pins this — drop below 2.857 at your own risk.
+ * Keeping gross_margin ≥ 0.65 means a multiplier ≥ 1/0.35 ≈ 2.857. At
+ * 4× this yields 75%, leaving buffer above the floor for FX moves and
+ * provider price rises. `pricing.test.ts` pins it.
  */
-export const DEFAULT_BILLING_MARGIN = 4;
+export const DEFAULT_MARGIN_BP = 40000;
+const BP_PER_MULTIPLE = 10000;
 /**
- * Default USD→MNT exchange rate fallback. Real value lives in
- * billing_settings.usd_to_mnt_rate and is read per request.
- */
-export const DEFAULT_USD_TO_MNT_RATE = 3450;
-/**
- * Per-model maximum output budget used for worst-case pre-request cost
- * estimation in checkQuota. Numbers are conservative — cap on streamed
- * output tokens we'd actually let a single chat turn produce.
- */
-export const MODEL_OUTPUT_BUDGET = {
-    "google/gemini-2.5-flash": 8000,
-    "google/gemini-2.5-pro": 8000,
-    "openai/gpt-5-mini": 8000,
-    "openai/gpt-5.4-mini": 8000,
-    "openai/o4-mini": 8000,
-    "anthropic/claude-sonnet-4-6": 8000,
-};
-/**
- * Convert raw model cost to MNT user-facing charged amount.
+ * Provider cost and what the reader is charged for it: cost × margin,
+ * converted into the deployment's currency at its own rate.
  *
- * chargedMnt = ceil( rawCostUsd × margin × fxRate )
+ * Both steps round up, so a charge is at most two micros over — a
+ * millionth of a cent, against a fraction that would otherwise be the
+ * deployment's to eat on every request.
  *
- * The rounding is upward so micro-fractions never let a free request
- * slip through; over-billing per request is at most 1 MNT.
+ * @throws {UnknownModelError} when the id has no registered price.
+ * @throws {MoneyError} when a USD deployment passes a rate that is not 1.
  */
-export function calculateChargedMnt(modelId, inputTokens, outputTokens, fxRate = DEFAULT_USD_TO_MNT_RATE, margin = DEFAULT_BILLING_MARGIN) {
-    const rawCostUsd = calculateCost(modelId, inputTokens, outputTokens);
-    const chargedMnt = Math.ceil(rawCostUsd * margin * fxRate);
-    return { rawCostUsd, chargedMnt };
+export function chargeFor(modelId, inputTokens, outputTokens, rate) {
+    const cost = providerCost(modelId, inputTokens, outputTokens);
+    const withMargin = money(Math.ceil((cost.amount * rate.marginBp) / BP_PER_MULTIPLE), PROVIDER_CURRENCY);
+    return {
+        providerCost: cost,
+        charged: convert(withMargin, rate.currency, rate.usdRateMicros),
+    };
 }
 /**
- * Worst-case MNT cost estimate for a single chat turn against a given
- * model. Used by checkQuota to refuse requests whose ceiling cost would
- * exceed remaining balance, before we burn provider tokens. Uses the
- * full MODEL_OUTPUT_BUDGET as the output side and a generous 16K input
- * budget to cover system prompt + conversation history.
+ * The ceiling one turn on this model could charge, for admission:
+ * the model's own output limit against a 16K input budget (system
+ * prompt plus history). Refusing on the ceiling is what stops a turn
+ * that cannot be paid for from burning provider tokens first.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
-export function estimateWorstCaseChargedMnt(modelId, fxRate = DEFAULT_USD_TO_MNT_RATE, margin = DEFAULT_BILLING_MARGIN) {
-    const outputBudget = MODEL_OUTPUT_BUDGET[modelId] ?? 8000;
-    const inputBudget = 16000;
-    return calculateChargedMnt(modelId, inputBudget, outputBudget, fxRate, margin)
-        .chargedMnt;
+export function estimateWorstCaseCharge(modelId, rate) {
+    const outputBudget = requireModel(modelId).maxOutputTokens;
+    return chargeFor(modelId, ESTIMATE_INPUT_BUDGET, outputBudget, rate).charged;
 }
+const ESTIMATE_INPUT_BUDGET = 16000;
 //# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,KAAK,GAGN,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAgC9D,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAG1C,YAAY,OAAe,EAAE,UAA6B;QACxD,KAAK,CACH,kCAAkC,OAAO,KAAK;YAC5C,eAAe,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI;YACzE,0FAA0F,CAC7F,CAAC;QAPK,SAAI,GAAG,eAAe,CAAC;QAQ9B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,MAAM,GAAG,cAAc,CAAe,0BAA0B,CAAC,CAAC;AAExE,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,OAAqB;IACjD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAiC;IAC9D,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,aAAa,CAAC,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD;QACE,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,kBAAkB;QAC/B,mBAAmB,EAAE,GAAG;QACxB,oBAAoB,EAAE,GAAG;QACzB,eAAe,EAAE,IAAK;QACtB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;SACf;KACF;IACD;QACE,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,gBAAgB;QAC7B,mBAAmB,EAAE,IAAI;QACzB,oBAAoB,EAAE,EAAE;QACxB,eAAe,EAAE,IAAK;QACtB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;SACf;KACF;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,YAAY;QACzB,mBAAmB,EAAE,IAAI;QACzB,oBAAoB,EAAE,GAAG;QACzB,eAAe,EAAE,IAAK;QACtB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;SAChB;KACF;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,cAAc;QAC3B,mBAAmB,EAAE,IAAI;QACzB,oBAAoB,EAAE,GAAG;QACzB,eAAe,EAAE,IAAK;QACtB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;SACf;KACF;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,SAAS;QACtB,mBAAmB,EAAE,GAAG;QACxB,oBAAoB,EAAE,GAAG;QACzB,eAAe,EAAE,IAAK;QACtB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;SACf;KACF;IACD;QACE,EAAE,EAAE,6BAA6B;QACjC,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,mBAAmB;QAChC,mBAAmB,EAAE,GAAG;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAK;QACtB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,6DAA6D;AAC7D,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAiB,QAAQ,CAAC,KAAK,CAAC,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,WAAmB,EACnB,YAAoB;IAEpB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC;IAClE,OAAO,KAAK,CACV,IAAI,CAAC,IAAI,CACP,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC;QAC/C,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACnD,WAAW,CACd,EACD,iBAAiB,CAClB,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,WAAW,GAAG,OAAS,CAAC;AAiB9B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAM,CAAC;AAExC,MAAM,eAAe,GAAG,KAAM,CAAC;AAE/B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,WAAmB,EACnB,YAAoB,EACpB,IAAiB;IAEjB,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,KAAK,CACtB,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,EAC1D,iBAAiB,CAClB,CAAC;IACF,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC;KAChE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,IAAiB;IAEjB,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC;IAC3D,OAAO,SAAS,CAAC,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC;AAC/E,CAAC;AAED,MAAM,qBAAqB,GAAG,KAAM,CAAC"}