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

package/NOTICE

@@ -0,0 +1,6 @@
+Intelligo
+Copyright 2026 Turtuvshin Byambaa and the Intelligo contributors
+
+This product is licensed under the Apache License, Version 2.0 (see
+LICENSE). The Intelligo name and logo are trademarks; see TRADEMARK.md
+in the source repository, https://github.com/intelligo-dev/intelligo.

package/README.md

@@ -0,0 +1,121 @@
+# @intelligo-dev/executions
+
+The execution lifecycle (admission, running, settlement) and the model cost registry.
+
+Part of [Intelligo](https://intelligo.dev), an application framework and
+operational platform for vertical AI SaaS products. Every `@intelligo-dev/*`
+package is released at one version and shares one database schema;
+`pnpm dlx @intelligo-dev/cli@beta create my-app` installs the set an
+application needs. Documentation:
+[intelligo.dev/docs/packages/executions](https://intelligo.dev/docs/packages/executions).
+
+## Install
+
+```bash
+pnpm add @intelligo-dev/executions@beta drizzle-orm
+```
+
+`drizzle-orm` is a peer. The `executions` table is part of the framework's
+schema, which `intelligo migrate` from
+[`@intelligo-dev/cli`](https://www.npmjs.com/package/@intelligo-dev/cli)
+applies.
+
+## 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.
+
+## Use
+
+The composition root builds one instance, with the ports bound:
+
+```ts
+// lib/intelligo.ts
+import {
+  DEFAULT_MODELS,
+  createExecutions,
+  registerModels,
+} from "@intelligo-dev/executions";
+
+registerModels(DEFAULT_MODELS);
+
+export const executions = createExecutions({
+  checkEntitlement, // may this workspace run this model? takes the hold
+  settleUsage, // charge what the run used
+  findSettlement, // did that charge already commit?
+  releaseHold, // the run failed: give the hold back
+});
+```
+
+A run is one `begin`, then exactly one `complete` or `fail`:
+
+```ts
+const run = await executions.begin({
+  workspaceId,
+  userId,
+  capability: "support.reply",
+  model: "google/gemini-2.5-flash",
+});
+if (!run.allowed) return refuse(run.code, run.reason);
+
+try {
+  const result = await agent.generate(messages); // your framework, natively
+  await run.complete({ usage: result.usage, model: "google/gemini-2.5-flash" });
+} catch (error) {
+  await run.fail({ error });
+  throw error;
+}
+```
+
+All four ports are optional, so this package never imports billing; the
+reference composition root binds them to `@intelligo-dev/billing`. The
+lifecycle claims each transition with a compare-and-swap before money is
+spent, so a late `complete` racing a `fail` cannot charge twice or release
+twice.
+
+`executions.reconcile(executionId, { abandonRunningAfterMs? })` repairs a run
+whose process died: it asks `findSettlement` whether the charge committed,
+confirms it onto the row or re-runs settlement from the recorded usage, and
+fails a `running` row that outlived the threshold. `findStaleExecutions` finds
+the candidates; `listExecutions`, `summarizeExecutions` and
+`summarizeExecutionsByDay` read the record for a usage page.
+
+## 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. Pricing throws `UnknownModelError` instead.
+
+Nothing self-registers. `DEFAULT_MODELS` is the catalogue the framework ships,
+as data; a deployment registers it, its own contracted rates, or a model the
+framework has never heard of:
+
+```ts
+import { registerModel } from "@intelligo-dev/executions/pricing";
+
+registerModel({
+  id: "acme/large-1",
+  provider: "acme",
+  model: "large-1-2026-08",
+  displayName: "Acme Large",
+  costPerMInputTokens: 1.25, // USD per million, as the provider quotes it
+  costPerMOutputTokens: 5,
+  maxOutputTokens: 8_192, // sizes the worst-case hold at admission
+  capabilities: {
+    thinking: false,
+    toolCall: true,
+    vision: false,
+    webSearch: false,
+    codeExec: false,
+  },
+});
+```
+
+`providerCost` is what a run cost the deployment; `chargeFor` applies the
+deployment's currency, rate and margin (`BillingRate`) and returns both
+figures as money in micros.
+
+## Licence
+
+Apache-2.0

package/dist/db/schema.d.ts

@@ -1,21 +1,15 @@
 /**
- * @intelligo-dev/executions database schema.
- *
  * One row per AI execution: who ran what capability, whether it was
- * admitted, how it ended, and what it cost. This is the narrow SaaS
- * boundary from ADR-0003 — it deliberately records nothing about
- * agents, tools, workflows, or messages, which stay native to the
- * chosen AI framework.
+ * admitted, how it ended, and what it cost. It deliberately records
+ * nothing about agents, tools, workflows, or messages, which stay
+ * native to the chosen AI framework.
  *
- * Relationship to the existing usage tables (ADR-0004):
- *   - `usage_records` is the per-request usage/cost detail. It IS the
- *     "usage_events"/"cost_events" of the target structure under its
- *     current name; it gains an `execution_id` FK here rather than
- *     being duplicated. The rename happens with the package split.
- *   - `monthly_usage` stays the O(1) rollup.
- *   - `credit_reservations` (owned by credits/billing today) holds the
- *     admission hold; `executions.request_id` is the correlation key
- *     between the two.
+ * Related tables:
+ *   - `usage_records` is the per-request usage/cost detail, linked by
+ *     `execution_id`.
+ *   - `monthly_usage` is the O(1) rollup.
+ *   - `credit_reservations` holds the admission hold;
+ *     `executions.request_id` is the correlation key between the two.
  *
  * Scanned by drizzle-kit alongside the core schema directory — see
  * packages/core/drizzle.config.ts.
@@ -194,11 +188,11 @@ export declare const executions: import("drizzle-orm/pg-core").PgTableWithColumn
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        chargedMnt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "charged_mnt";
+        chargedMicros: import("drizzle-orm/pg-core").PgColumn<{
+            name: "charged_micros";
             tableName: "executions";
             dataType: "number";
-            columnType: "PgInteger";
+            columnType: "PgBigInt53";
             data: number;
             driverParam: string | number;
             notNull: false;
@@ -211,11 +205,11 @@ export declare const executions: import("drizzle-orm/pg-core").PgTableWithColumn
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        reservedMnt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "reserved_mnt";
+        reservedMicros: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reserved_micros";
             tableName: "executions";
             dataType: "number";
-            columnType: "PgInteger";
+            columnType: "PgBigInt53";
             data: number;
             driverParam: string | number;
             notNull: false;
@@ -228,6 +222,23 @@ export declare const executions: import("drizzle-orm/pg-core").PgTableWithColumn
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        currency: import("drizzle-orm/pg-core").PgColumn<{
+            name: "currency";
+            tableName: "executions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         refusalReason: import("drizzle-orm/pg-core").PgColumn<{
             name: "refusal_reason";
             tableName: "executions";

package/dist/db/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAYH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC"}

package/dist/db/schema.js

@@ -1,26 +1,20 @@
 /**
- * @intelligo-dev/executions database schema.
- *
  * One row per AI execution: who ran what capability, whether it was
- * admitted, how it ended, and what it cost. This is the narrow SaaS
- * boundary from ADR-0003 — it deliberately records nothing about
- * agents, tools, workflows, or messages, which stay native to the
- * chosen AI framework.
+ * admitted, how it ended, and what it cost. It deliberately records
+ * nothing about agents, tools, workflows, or messages, which stay
+ * native to the chosen AI framework.
  *
- * Relationship to the existing usage tables (ADR-0004):
- *   - `usage_records` is the per-request usage/cost detail. It IS the
- *     "usage_events"/"cost_events" of the target structure under its
- *     current name; it gains an `execution_id` FK here rather than
- *     being duplicated. The rename happens with the package split.
- *   - `monthly_usage` stays the O(1) rollup.
- *   - `credit_reservations` (owned by credits/billing today) holds the
- *     admission hold; `executions.request_id` is the correlation key
- *     between the two.
+ * Related tables:
+ *   - `usage_records` is the per-request usage/cost detail, linked by
+ *     `execution_id`.
+ *   - `monthly_usage` is the O(1) rollup.
+ *   - `credit_reservations` holds the admission hold;
+ *     `executions.request_id` is the correlation key between the two.
  *
  * Scanned by drizzle-kit alongside the core schema directory — see
  * packages/core/drizzle.config.ts.
  */
-import { pgTable, text, timestamp, integer, jsonb, index, } from "drizzle-orm/pg-core";
+import { pgTable, text, timestamp, integer, bigint, jsonb, index, } from "drizzle-orm/pg-core";
 import { organization, users } from "@intelligo-dev/core/db/schema";
 export const executions = pgTable("executions", {
     id: text("id").primaryKey(),
@@ -32,8 +26,8 @@ export const executions = pgTable("executions", {
     }),
     /**
      * What the caller asked for, in the product's own vocabulary:
-     * "career.recommendation", "chat.message". Opaque to Intelligo —
-     * used for entitlement decisions, grouping, and admin filtering.
+     * "support.reply", "chat.message". Opaque to the framework — used for
+     * entitlement decisions, grouping, and admin filtering.
      */
     capability: text("capability").notNull(),
     /**
@@ -41,17 +35,23 @@ export const executions = pgTable("executions", {
      * usage_records. Unique per execution attempt.
      */
     requestId: text("request_id").notNull().unique(),
-    /** running | succeeded | failed | refused */
+    /**
+     * running | settling | succeeded | failed | refused.
+     * `settling` is the window between claiming the row and confirming
+     * the charge; a row that stays there needs an operator.
+     */
     status: text("status").notNull().default("running"),
     /** Model actually used; null until the run reports one. */
     model: text("model"),
     inputTokens: integer("input_tokens"),
     outputTokens: integer("output_tokens"),
     totalTokens: integer("total_tokens"),
-    /** Authoritative charge in MNT, mirrored from usage_records. */
-    chargedMnt: integer("charged_mnt"),
-    /** Worst-case estimate held at admission. */
-    reservedMnt: integer("reserved_mnt"),
+    /** Authoritative charge in micros of `currency`, mirrored from usage_records. */
+    chargedMicros: bigint("charged_micros", { mode: "number" }),
+    /** Worst-case estimate held at admission, in micros of `currency`. */
+    reservedMicros: bigint("reserved_micros", { mode: "number" }),
+    /** What this row's amounts are denominated in; null until one is set. */
+    currency: text("currency"),
     /** Populated on status=refused: why entitlement said no. */
     refusalReason: text("refusal_reason"),
     /** Populated on status=failed. */

package/dist/db/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,OAAO,EACP,IAAI,EACJ,SAAS,EACT,OAAO,EACP,KAAK,EACL,KAAK,GACN,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAC/B,YAAY,EACZ;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC7D,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE;QACjD,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF;;;;OAIG;IACH,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACxC;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;IAChD,6CAA6C;IAC7C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACnD,2DAA2D;IAC3D,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC;IACtC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC;IACpC,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC;IAClC,6CAA6C;IAC7C,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC;IACpC,4DAA4D;IAC5D,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,kCAAkC;IAClC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IACzD,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;IACpC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,EAA2B;CAC7D,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,kCAAkC,CAAC,CAAC,EAAE,CAC1C,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,SAAS,CAChB;IACD,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IAChE,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC;CACzE,CACF,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,OAAO,EACP,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,KAAK,EACL,KAAK,GACN,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAC/B,YAAY,EACZ;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC7D,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE;QACjD,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF;;;;OAIG;IACH,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACxC;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;IAChD;;;;OAIG;IACH,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACnD,2DAA2D;IAC3D,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC;IACtC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC;IACpC,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC3D,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC7D,yEAAyE;IACzE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;IAC1B,4DAA4D;IAC5D,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,kCAAkC;IAClC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IACzD,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;IACpC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,EAA2B;CAC7D,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,kCAAkC,CAAC,CAAC,EAAE,CAC1C,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,SAAS,CAChB;IACD,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IAChE,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC;CACzE,CACF,CAAC"}

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Wraps a native AI run (Mastra, AI SDK, anything) with entitlement,
  * credit hold, usage/cost recording, and audit — and records nothing
- * about agents, tools, or messages (ADR-0003).
+ * about agents, tools, or messages.
  *
  * The composition root builds one instance with the ports bound:
  *
@@ -12,18 +12,18 @@
  *     settleUsage: billingSettlementPort,
  *   });
  */
-export { createExecutions } from "./lifecycle";
-export type { Executions, ExecutionStatus, ExecutionRun, BeginExecutionInput, CompleteExecutionInput, } from "./lifecycle";
-export type { ExecutionPorts, EntitlementDecision, EntitlementRequest, UsageSettlement, SettlementResult, } 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_MARGIN_BP, PROVIDER_CURRENCY, providerCost, chargeFor, estimateWorstCaseCharge, } from "./pricing.js";
+export type { ModelId, ModelPricing, ModelCapabilities, BillingRate, } 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,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,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,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -3,7 +3,7 @@
  *
  * Wraps a native AI run (Mastra, AI SDK, anything) with entitlement,
  * credit hold, usage/cost recording, and audit — and records nothing
- * about agents, tools, or messages (ADR-0003).
+ * about agents, tools, or messages.
  *
  * The composition root builds one instance with the ports bound:
  *
@@ -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_MARGIN_BP, PROVIDER_CURRENCY, providerCost, chargeFor, estimateWorstCaseCharge, } 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;AAiB/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,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,uBAAuB,GACxB,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) {
@@ -14,7 +14,7 @@
  *
  * The handle knows nothing about agents, tools, messages, or streams —
  * only actor, workspace, capability, entitlement, status, usage, cost,
- * credits, and audit (ADR-0003).
+ * credits, and audit.
  *
  * Every terminal transition is idempotent: calling complete() twice, or
  * fail() after complete(), leaves the first outcome in place. Streaming
@@ -22,7 +22,8 @@
  * abort, error) and must be able to fire whichever arrives first
  * without racing.
  */
-import type { ExecutionPorts } from "./ports";
+import type { Money } from "@intelligo-dev/core/money";
+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 +35,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;
@@ -56,9 +57,12 @@ export type ExecutionRun = {
     requestId: string;
     /** False when entitlement refused; complete()/fail() are then no-ops. */
     allowed: boolean;
+    /** Stable refusal code from the entitlement port; set when allowed is false. */
+    code?: string;
     /** Set when allowed is false. */
     reason?: string;
-    estimatedMnt?: number;
+    /** The hold entitlement took for this run. */
+    estimated?: Money;
     usingTrialCredits: boolean;
     complete(input?: CompleteExecutionInput): Promise<void>;
     fail(input: {
@@ -67,6 +71,28 @@ export type ExecutionRun = {
 };
 export declare function createExecutions(ports?: ExecutionPorts): {
     begin: (input: BeginExecutionInput) => Promise<ExecutionRun>;
+    reconcile: (executionId: string, options?: {
+        abandonRunningAfterMs?: number;
+    }) => Promise<ReconcileResult>;
+};
+export type ReconcileResult = {
+    action: "noop";
+    status: ExecutionStatus | "missing";
+    reason?: string;
+}
+/** The ledger already held the charge; the row now says so. */
+ | {
+    action: "confirmed";
+    charged?: Money;
+}
+/** Settlement was re-run from the recorded usage. */
+ | {
+    action: "settled";
+    charged?: Money;
+}
+/** A stale `running` row was failed and its hold released. */
+ | {
+    action: "abandoned";
 };
 export type Executions = ReturnType<typeof createExecutions>;
 //# sourceMappingURL=lifecycle.d.ts.map

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,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;EAkOxE;AAED,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;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAKvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACzB,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D,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,8CAA8C;IAC9C,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,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;6BAoRxD,MAAM,YACV;QAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1C,OAAO,CAAC,eAAe,CAAC;EA8I5B;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,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE;AAC1C,qDAAqD;GACnD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE;AACxC,8DAA8D;GAC5D;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}