@intelligo-dev/executions 1.0.0-beta.2 → 1.0.0-beta.5

package/README.md

@@ -0,0 +1,36 @@
+# @intelligo-dev/executions
+
+The execution lifecycle — admission, running, settlement — and the model cost registry.
+
+Part of [Intelligo](https://github.com/intelligo-mn/framework), an application
+framework and operational platform for vertical AI SaaS products. This package
+is published from that repository and is not meant to be used on its own.
+
+## Install
+
+```bash
+pnpm add @intelligo-dev/executions
+```
+
+## The boundary
+
+Intelligo records what an AI execution cost and whether it was allowed. It does
+not wrap the AI framework: prompts, tools and orchestration stay native
+(ADR-0003).
+
+`createExecutions(ports)` takes four optional ports — `checkEntitlement`,
+`settleUsage`, `findSettlement`, `releaseHold` — so this package never imports
+billing. The lifecycle claims each transition with a compare-and-swap before
+money is spent, and `reconcile` uses `findSettlement` to tell an abandoned run
+from a settled one.
+
+## Model pricing
+
+`@intelligo-dev/executions/pricing` is a deliberate zero-import leaf that
+client bundles can reach. Model ids are registry keys: an unregistered id has
+no price, and guessing one is how a model runs on the cheapest provider and
+bills at the most expensive rate.
+
+## Licence
+
+Apache-2.0

package/dist/db/schema.js

@@ -32,7 +32,7 @@ export const executions = pgTable("executions", {
     }),
     /**
      * What the caller asked for, in the product's own vocabulary:
-     * "career.recommendation", "chat.message". Opaque to Intelligo —
+     * "support.reply", "chat.message". Opaque to Intelligo —
      * used for entitlement decisions, grouping, and admin filtering.
      */
     capability: text("capability").notNull(),

package/dist/index.d.ts

@@ -12,18 +12,18 @@
  *     settleUsage: billingSettlementPort,
  *   });
  */
-export { createExecutions } from "./lifecycle";
-export type { Executions, ExecutionStatus, ExecutionRun, ReconcileResult, BeginExecutionInput, CompleteExecutionInput, } from "./lifecycle";
-export type { ExecutionPorts, EntitlementDecision, EntitlementRequest, UsageSettlement, SettlementResult, SettlementQuery, } from "./ports";
-export { listExecutions, getExecutionByRequestId, summarizeExecutions, findStaleExecutions, summarizeExecutionsByDay, } from "./queries";
-export type { ListExecutionsOptions } from "./queries";
-export { executions } from "./db/schema";
-export type { Execution, InsertExecution } from "./db/schema";
+export { createExecutions } from "./lifecycle.js";
+export type { Executions, ExecutionStatus, ExecutionRun, ReconcileResult, BeginExecutionInput, CompleteExecutionInput, } from "./lifecycle.js";
+export type { ExecutionPorts, EntitlementDecision, EntitlementRequest, UsageSettlement, SettlementResult, SettlementQuery, } from "./ports.js";
+export { listExecutions, getExecutionByRequestId, summarizeExecutions, findStaleExecutions, summarizeExecutionsByDay, } from "./queries.js";
+export type { ListExecutionsOptions } from "./queries.js";
+export { executions } from "./db/schema.js";
+export type { Execution, InsertExecution } from "./db/schema.js";
 /**
  * Model registry and cost accounting. Also reachable as
  * `@intelligo-dev/executions/pricing`, which is the import to use from
  * anything that reaches a browser — this barrel pulls in the database.
  */
-export { MODEL_CONFIGS, MODEL_OUTPUT_BUDGET, DEFAULT_BILLING_MARGIN, DEFAULT_USD_TO_MNT_RATE, calculateCost, calculateChargedMnt, estimateWorstCaseChargedMnt, } from "./pricing";
-export type { ModelId, ChargedAmount } from "./pricing";
+export { DEFAULT_MODELS, UnknownModelError, registerModel, registerModels, getModelPricing, isModelRegistered, listModels, registeredModelIds, clearModels, DEFAULT_BILLING_MARGIN, DEFAULT_USD_TO_MNT_RATE, calculateCost, calculateChargedMnt, estimateWorstCaseChargedMnt, } from "./pricing.js";
+export type { ModelId, ModelPricing, ModelCapabilities, ChargedAmount, } from "./pricing.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;GAIG;AACH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -12,13 +12,13 @@
  *     settleUsage: billingSettlementPort,
  *   });
  */
-export { createExecutions } from "./lifecycle";
-export { listExecutions, getExecutionByRequestId, summarizeExecutions, findStaleExecutions, summarizeExecutionsByDay, } from "./queries";
-export { executions } from "./db/schema";
+export { createExecutions } from "./lifecycle.js";
+export { listExecutions, getExecutionByRequestId, summarizeExecutions, findStaleExecutions, summarizeExecutionsByDay, } from "./queries.js";
+export { executions } from "./db/schema.js";
 /**
  * Model registry and cost accounting. Also reachable as
  * `@intelligo-dev/executions/pricing`, which is the import to use from
  * anything that reaches a browser — this barrel pulls in the database.
  */
-export { MODEL_CONFIGS, MODEL_OUTPUT_BUDGET, DEFAULT_BILLING_MARGIN, DEFAULT_USD_TO_MNT_RATE, calculateCost, calculateChargedMnt, estimateWorstCaseChargedMnt, } from "./pricing";
+export { DEFAULT_MODELS, UnknownModelError, registerModel, registerModels, getModelPricing, isModelRegistered, listModels, registeredModelIds, clearModels, DEFAULT_BILLING_MARGIN, DEFAULT_USD_TO_MNT_RATE, calculateCost, calculateChargedMnt, estimateWorstCaseChargedMnt, } from "./pricing.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAmB/C,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAmB/C,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,WAAW,CAAC"}

package/dist/lifecycle.d.ts

@@ -4,7 +4,7 @@
  *   const run = await executions.begin({ workspaceId, userId, capability });
  *   if (!run.allowed) return refuse(run.reason);
  *   try {
- *     const result = await careerAgent.generate(messages); // native
+ *     const result = await supportAgent.generate(messages); // native
  *     await run.complete({ usage: result.usage, model: result.model });
  *     return result;
  *   } catch (error) {
@@ -22,7 +22,7 @@
  * abort, error) and must be able to fire whichever arrives first
  * without racing.
  */
-import type { ExecutionPorts } from "./ports";
+import type { ExecutionPorts } from "./ports.js";
 /**
  * Row lifecycle. `settling` is non-terminal and deliberate: it marks
  * the window where usage is being charged, so a second complete() or a
@@ -34,7 +34,7 @@ export type ExecutionStatus = "running" | "settling" | "succeeded" | "failed" |
 export type BeginExecutionInput = {
     workspaceId: string;
     userId?: string | null;
-    /** Product-defined verb, e.g. "career.recommendation". */
+    /** Product-defined verb, e.g. "support.reply". */
     capability: string;
     /** Supply to reuse an existing correlation id; generated otherwise. */
     requestId?: string;

package/dist/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD,CAAC;AAMF,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,cAAmB;mBAC7B,mBAAmB,KAAG,OAAO,CAAC,YAAY,CAAC;6BAgQxD,MAAM,YACV;QAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1C,OAAO,CAAC,eAAe,CAAC;EAoI5B;AAED,MAAM,MAAM,eAAe,GACvB;IACE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACH,+DAA+D;GAC7D;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AAC9C,qDAAqD;GACnD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5C,8DAA8D;GAC5D;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD,CAAC;AAMF,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,cAAmB;mBAC7B,mBAAmB,KAAG,OAAO,CAAC,YAAY,CAAC;6BAgQxD,MAAM,YACV;QAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1C,OAAO,CAAC,eAAe,CAAC;EAoI5B;AAED,MAAM,MAAM,eAAe,GACvB;IACE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACH,+DAA+D;GAC7D;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AAC9C,qDAAqD;GACnD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5C,8DAA8D;GAC5D;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/lifecycle.js

@@ -4,7 +4,7 @@
  *   const run = await executions.begin({ workspaceId, userId, capability });
  *   if (!run.allowed) return refuse(run.reason);
  *   try {
- *     const result = await careerAgent.generate(messages); // native
+ *     const result = await supportAgent.generate(messages); // native
  *     await run.complete({ usage: result.usage, model: result.model });
  *     return result;
  *   } catch (error) {
@@ -26,7 +26,7 @@ import { db } from "@intelligo-dev/core/db";
 import { createLogger } from "@intelligo-dev/core/logger";
 import { recordAuditEvent } from "@intelligo-dev/audit";
 import { and, eq } from "drizzle-orm";
-import { executions } from "./db/schema";
+import { executions } from "./db/schema.js";
 const log = createLogger("Executions");
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);

package/dist/pricing.d.ts

@@ -6,107 +6,96 @@
  * boundary records actor, workspace, capability, usage and cost
  * (ADR-0003), and the price of a token is the last of those.
  *
- * 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.
+ * Still 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` remains something a client bundle
+ * can read a display name or a price from without pulling in Drizzle.
+ *
+ * ## The registry is open
+ *
+ * It used to be a closed `as const` object of six models, with
+ * `ModelId = keyof typeof`. A product that wanted Bedrock, Groq,
+ * Mistral, a self-hosted model — or simply a newer Claude — could not
+ * add one without a pull request to the framework, and an architecture
+ * test enforced that. For a framework meant to underpin ten products
+ * from one cost basis, the list cannot be the framework's to close.
+ *
+ * `registerModels(DEFAULT_MODELS)` from the composition root gets the
+ * old behaviour back in one line. Nothing self-registers: an import
+ * that populates a registry is the side effect ADR-0005 bans, and it
+ * is also how a deployment ends up billing against a catalogue it
+ * never chose.
+ *
+ * ## An unregistered id throws
+ *
+ * The old `calculateCost` warned and priced an unknown id at the
+ * worst-case Claude rate, while the model resolver warned and fell
+ * back to Gemini Flash. So the call ran on the cheapest model and
+ * billed for the most expensive one, and the only symptom was a
+ * console warning on a server nobody reads. Whatever that is, it is
+ * not pricing. An id with no price now throws, at the point where the
+ * price is needed, naming the id and what to do about it.
  */
+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. Was a separate `MODEL_OUTPUT_BUDGET` map, which is one
+     * more list that could disagree with this one.
+     */
+    maxOutputTokens: number;
+    capabilities: ModelCapabilities;
+};
 /**
- * Model configuration with display information and cost tracking
+ * A model id is now any string, because the registry is open.
  *
- * 6 models, 3 providers: Google (2), OpenAI (3), Anthropic (1)
+ * Kept as a named type for the call sites that read better with it.
+ * `Record<ModelId, T>` no longer means anything — which is a useful
+ * compile error in the places that used to enumerate the catalogue.
  */
-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;
-        };
-    };
-};
-export type ModelId = keyof typeof MODEL_CONFIGS;
+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 const DEFAULT_MODELS: readonly ModelPricing[];
+/**
+ * Raw provider cost in USD.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
 export declare function calculateCost(modelId: string, inputTokens: number, outputTokens: number): number;
 /**
@@ -117,11 +106,9 @@ export declare function calculateCost(modelId: string, inputTokens: number, outp
  *
  * 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.
+ *   Keeping gross_margin ≥ 0.65 means multiplier ≥ 1/0.35 ≈ 2.857. The
+ *   current value of 4 yields 75%, leaving buffer above the floor for
+ *   FX moves and provider price rises. `pricing.test.ts` pins it.
  */
 export declare const DEFAULT_BILLING_MARGIN = 4;
 /**
@@ -129,31 +116,29 @@ export declare const DEFAULT_BILLING_MARGIN = 4;
  * billing_settings.usd_to_mnt_rate and is read per request.
  */
 export declare 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 declare const MODEL_OUTPUT_BUDGET: Record<ModelId, number>;
 export type ChargedAmount = {
     rawCostUsd: number;
     chargedMnt: number;
 };
 /**
- * Convert raw model cost to MNT user-facing charged amount.
+ * Convert raw model cost to the user-facing charged amount.
  *
  * chargedMnt = ceil( rawCostUsd × margin × fxRate )
  *
  * The rounding is upward so micro-fractions never let a free request
- * slip through; over-billing per request is at most 1 MNT.
+ * slip through; over-billing per request is at most one unit.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
 export declare function calculateChargedMnt(modelId: string, inputTokens: number, outputTokens: number, fxRate?: number, margin?: number): ChargedAmount;
 /**
- * Worst-case MNT cost estimate for a single chat turn against a given
+ * Worst-case 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.
+ * exceed the remaining balance, before provider tokens are burnt. Uses
+ * the model's own `maxOutputTokens` and a generous 16K input budget to
+ * cover system prompt plus conversation history.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
 export declare function estimateWorstCaseChargedMnt(modelId: string, fxRate?: number, margin?: number): number;
 //# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,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;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,iBAAiB,CAAC;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,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;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAMR;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;GASG;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;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAgC,EACxC,MAAM,GAAE,MAA+B,GACtC,MAAM,CAKR"}

package/dist/pricing.js

@@ -6,26 +6,88 @@
  * boundary records actor, workspace, capability, usage and cost
  * (ADR-0003), and the price of a token is the last of those.
  *
- * 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.
+ * Still 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` remains something a client bundle
+ * can read a display name or a price from without pulling in Drizzle.
+ *
+ * ## The registry is open
+ *
+ * It used to be a closed `as const` object of six models, with
+ * `ModelId = keyof typeof`. A product that wanted Bedrock, Groq,
+ * Mistral, a self-hosted model — or simply a newer Claude — could not
+ * add one without a pull request to the framework, and an architecture
+ * test enforced that. For a framework meant to underpin ten products
+ * from one cost basis, the list cannot be the framework's to close.
+ *
+ * `registerModels(DEFAULT_MODELS)` from the composition root gets the
+ * old behaviour back in one line. Nothing self-registers: an import
+ * that populates a registry is the side effect ADR-0005 bans, and it
+ * is also how a deployment ends up billing against a catalogue it
+ * never chose.
+ *
+ * ## An unregistered id throws
+ *
+ * The old `calculateCost` warned and priced an unknown id at the
+ * worst-case Claude rate, while the model resolver warned and fell
+ * back to Gemini Flash. So the call ran on the cheapest model and
+ * billed for the most expensive one, and the only symptom was a
+ * console warning on a server nobody reads. Whatever that is, it is
+ * not pricing. An id with no price now throws, at the point where the
+ * price is needed, naming the id and what to do about it.
  */
+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 +96,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 +112,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 +128,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 +144,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 +160,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,22 +176,21 @@ 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;
+}
 /**
- * Calculate the dollar cost for a given model and token counts.
+ * Raw provider cost in USD.
+ *
+ * @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;
-    }
+    const config = requireModel(modelId);
     return ((inputTokens / 1000000) * config.costPerMInputTokens +
         (outputTokens / 1000000) * config.costPerMOutputTokens);
 }
@@ -133,11 +202,9 @@ export function calculateCost(modelId, inputTokens, outputTokens) {
  *
  * 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.
+ *   Keeping gross_margin ≥ 0.65 means multiplier ≥ 1/0.35 ≈ 2.857. The
+ *   current value of 4 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;
 /**
@@ -146,25 +213,14 @@ export const DEFAULT_BILLING_MARGIN = 4;
  */
 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.
+ * Convert raw model cost to the user-facing charged amount.
  *
  * chargedMnt = ceil( rawCostUsd × margin × fxRate )
  *
  * The rounding is upward so micro-fractions never let a free request
- * slip through; over-billing per request is at most 1 MNT.
+ * slip through; over-billing per request is at most one unit.
+ *
+ * @throws {UnknownModelError} when the id has no registered price.
  */
 export function calculateChargedMnt(modelId, inputTokens, outputTokens, fxRate = DEFAULT_USD_TO_MNT_RATE, margin = DEFAULT_BILLING_MARGIN) {
     const rawCostUsd = calculateCost(modelId, inputTokens, outputTokens);
@@ -172,14 +228,16 @@ export function calculateChargedMnt(modelId, inputTokens, outputTokens, fxRate =
     return { rawCostUsd, chargedMnt };
 }
 /**
- * Worst-case MNT cost estimate for a single chat turn against a given
+ * Worst-case 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.
+ * exceed the remaining balance, before provider tokens are burnt. Uses
+ * the model's own `maxOutputTokens` and a generous 16K input budget to
+ * cover system prompt plus conversation history.
+ *
+ * @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 outputBudget = requireModel(modelId).maxOutputTokens;
     const inputBudget = 16000;
     return calculateChargedMnt(modelId, inputBudget, outputBudget, fxRate, margin)
         .chargedMnt;

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":"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"}

package/dist/queries.js

@@ -4,7 +4,7 @@
  */
 import { db } from "@intelligo-dev/core/db";
 import { and, desc, eq, gte, inArray, lt, lte, sql } from "drizzle-orm";
-import { executions } from "./db/schema";
+import { executions } from "./db/schema.js";
 export async function listExecutions(options = {}) {
     const filters = [
         options.workspaceId

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intelligo-dev/executions",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.5",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -27,25 +27,35 @@
     }
   },
   "dependencies": {
-    "drizzle-orm": "^0.45.1",
-    "@intelligo-dev/audit": "1.0.0-beta.2",
-    "@intelligo-dev/core": "1.0.0-beta.2"
+    "@intelligo-dev/core": "1.0.0-beta.5",
+    "@intelligo-dev/audit": "1.0.0-beta.5"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/pg": "^8.16.0",
+    "drizzle-orm": "^0.45.1",
     "pg": "^8.18.0",
     "typescript": "^5.7.2"
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE",
+    "README.md",
+    "!dist/**/*.tsbuildinfo"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "peerDependencies": {
+    "drizzle-orm": "^0.45.1"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
   "scripts": {
     "type-check": "tsc --noEmit",
     "lint": "eslint .",
-    "build": "tsc -p tsconfig.build.json"
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/fix-esm-extensions.mjs dist"
   }
 }