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

package/dist/queries.d.ts

@@ -1,9 +1,11 @@
 /**
- * Read models over the executions table — for the product's usage UI
- * and, in Phase 5, the Intelligo admin console.
+ * Read models over the executions table, for the product's usage UI
+ * and the admin console.
  */
+import { type Money } from "@intelligo-dev/core/money";
 export type ListExecutionsOptions = {
-    workspaceId?: string;
+    /** Required: every query is scoped to one tenant. */
+    workspaceId: string;
     userId?: string;
     capability?: string;
     status?: "running" | "settling" | "succeeded" | "failed" | "refused";
@@ -11,7 +13,7 @@ export type ListExecutionsOptions = {
     before?: Date;
     limit?: number;
 };
-export declare function listExecutions(options?: ListExecutionsOptions): Promise<{
+export declare function listExecutions(options: ListExecutionsOptions): Promise<{
     id: string;
     workspaceId: string;
     userId: string | null;
@@ -22,8 +24,9 @@ export declare function listExecutions(options?: ListExecutionsOptions): Promise
     inputTokens: number | null;
     outputTokens: number | null;
     totalTokens: number | null;
-    chargedMnt: number | null;
-    reservedMnt: number | null;
+    chargedMicros: number | null;
+    reservedMicros: number | null;
+    currency: string | null;
     refusalReason: string | null;
     errorMessage: string | null;
     startedAt: Date;
@@ -42,8 +45,9 @@ export declare function getExecutionByRequestId(requestId: string): Promise<{
     inputTokens: number | null;
     outputTokens: number | null;
     totalTokens: number | null;
-    chargedMnt: number | null;
-    reservedMnt: number | null;
+    chargedMicros: number | null;
+    reservedMicros: number | null;
+    currency: string | null;
     refusalReason: string | null;
     errorMessage: string | null;
     startedAt: Date;
@@ -60,17 +64,15 @@ export declare function summarizeExecutions(workspaceId: string, window: {
     from: Date;
     to: Date;
 }): Promise<{
-    byStatus: {
-        [k: string]: {
-            count: number;
-            totalTokens: number;
-            chargedMnt: number;
-        };
-    };
+    byStatus: Record<string, {
+        count: number;
+        totalTokens: number;
+        charged: Money[];
+    }>;
     totals: {
+        charged: Money[];
         count: number;
         totalTokens: number;
-        chargedMnt: number;
     };
 }>;
 /**
@@ -84,24 +86,34 @@ export declare function summarizeExecutions(workspaceId: string, window: {
  *
  * Days with no activity are absent rather than zero — the caller knows
  * the window it asked for, and a gap means "nothing ran", which a
- * chart should draw as zero and a table should leave empty. `date` is
- * a `YYYY-MM-DD` string in UTC, so the series is stable regardless of
- * where the reader is.
+ * chart should draw as zero and a table should leave empty.
+ *
+ * `date` is a `YYYY-MM-DD` string in `timeZone`, which defaults to UTC.
+ * Pass the reader's own zone: bucketing a +08:00 reader's 00:36 turn in
+ * UTC files it on the previous day.
  */
 export declare function summarizeExecutionsByDay(workspaceId: string, window: {
     from: Date;
     to: Date;
+}, options?: {
+    timeZone?: string;
 }): Promise<Array<{
     date: string;
     count: number;
     totalTokens: number;
-    chargedMnt: number;
+    charged: Money[];
 }>>;
 /**
- * Executions stuck in a non-terminal state past a cutoff — a stream
- * that died without reaching complete()/fail() (`running`), or a
- * settlement that threw partway (`settling`). The cleanup cron reports
- * these; they are the operational signal that usage went unrecorded.
+ * Executions stuck in a non-terminal state past a cutoff.
+ *
+ * `running`: the stream died without reaching complete()/fail() —
+ * tokens were consumed and nothing was charged. `settling`: the charge
+ * was claimed but never confirmed — EITHER `settleUsage` threw and the
+ * workspace was not charged, OR the charge committed and the process
+ * died before the final `settling → succeeded` flip, in which case the
+ * workspace WAS charged. A `usage_records` row (or a `settled`
+ * reservation) for the same `requestId` distinguishes the two. This
+ * only reports; `createExecutions().reconcile()` repairs a row.
  */
 export declare function findStaleExecutions(olderThan: Date, limit?: number): Promise<{
     id: string;
@@ -114,8 +126,9 @@ export declare function findStaleExecutions(olderThan: Date, limit?: number): Pr
     inputTokens: number | null;
     outputTokens: number | null;
     totalTokens: number | null;
-    chargedMnt: number | null;
-    reservedMnt: number | null;
+    chargedMicros: number | null;
+    reservedMicros: number | null;
+    currency: string | null;
     refusalReason: string | null;
     errorMessage: string | null;
     startedAt: Date;

package/dist/queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrE,4DAA4D;IAC5D,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;KAmBvE;AAED,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;UAO9D;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE;;;;;;;;;;;;;GAyCjC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAC/B,OAAO,CACR,KAAK,CAAC;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CACH,CA2BA;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,SAAM;;;;;;;;;;;;;;;;;;;KAYrE"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAS,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AA2B9D,MAAM,MAAM,qBAAqB,GAAG;IAClC,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrE,4DAA4D;IAC5D,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;KAiBlE;AAED,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;UAO9D;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE;;eAwBrB,MAAM;qBAAe,MAAM;iBAAW,KAAK,EAAE;;;;;;;GA4BzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CACR,KAAK,CAAC;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,CAAC;CAClB,CAAC,CACH,CA+CA;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,SAAM;;;;;;;;;;;;;;;;;;;;KAYrE"}

package/dist/queries.js

@@ -1,15 +1,35 @@
 /**
- * Read models over the executions table — for the product's usage UI
- * and, in Phase 5, the Intelligo admin console.
+ * Read models over the executions table, for the product's usage UI
+ * and the admin console.
  */
 import { db } from "@intelligo-dev/core/db";
+import { money } from "@intelligo-dev/core/money";
 import { and, desc, eq, gte, inArray, lt, lte, sql } from "drizzle-orm";
-import { executions } from "./db/schema";
-export async function listExecutions(options = {}) {
+import { executions } from "./db/schema.js";
+/**
+ * Charges summed per currency.
+ *
+ * A workspace bills in one currency, so this is normally one entry —
+ * but the rows are what the ledger holds, and adding two currencies
+ * into a single number is how a total starts lying. Rows with no
+ * currency are executions that were never charged.
+ */
+function chargedByCurrency(rows) {
+    const totals = new Map();
+    for (const row of rows) {
+        if (!row.currency)
+            continue;
+        // `sum()` of a bigint column arrives as a string.
+        const amount = Number(row.chargedMicros ?? 0);
+        if (amount === 0)
+            continue;
+        totals.set(row.currency, (totals.get(row.currency) ?? 0) + amount);
+    }
+    return [...totals].map(([code, amount]) => money(amount, code));
+}
+export async function listExecutions(options) {
     const filters = [
-        options.workspaceId
-            ? eq(executions.workspaceId, options.workspaceId)
-            : undefined,
+        eq(executions.workspaceId, options.workspaceId),
         options.userId ? eq(executions.userId, options.userId) : undefined,
         options.capability
             ? eq(executions.capability, options.capability)
@@ -41,28 +61,38 @@ export async function summarizeExecutions(workspaceId, window) {
     const rows = await db
         .select({
         status: executions.status,
+        currency: executions.currency,
         count: sql `count(*)`,
         totalTokens: sql `coalesce(sum(${executions.totalTokens}), 0)`,
-        chargedMnt: sql `coalesce(sum(${executions.chargedMnt}), 0)`,
+        chargedMicros: sql `coalesce(sum(${executions.chargedMicros}), 0)`,
     })
         .from(executions)
         .where(and(eq(executions.workspaceId, workspaceId), gte(executions.startedAt, window.from), lte(executions.startedAt, window.to)))
-        .groupBy(executions.status);
-    const byStatus = Object.fromEntries(rows.map((r) => [
-        r.status,
-        {
-            count: Number(r.count),
-            totalTokens: Number(r.totalTokens),
-            chargedMnt: Number(r.chargedMnt),
-        },
-    ]));
+        .groupBy(executions.status, executions.currency);
+    // A status can arrive as several rows — one per currency — so the
+    // per-status view folds them back together.
+    const byStatus = {};
+    for (const r of rows) {
+        const seen = byStatus[r.status] ?? {
+            count: 0,
+            totalTokens: 0,
+            charged: [],
+        };
+        byStatus[r.status] = {
+            count: seen.count + Number(r.count),
+            totalTokens: seen.totalTokens + Number(r.totalTokens),
+            charged: chargedByCurrency(rows.filter((row) => row.status === r.status)),
+        };
+    }
     return {
         byStatus,
-        totals: rows.reduce((acc, r) => ({
-            count: acc.count + Number(r.count),
-            totalTokens: acc.totalTokens + Number(r.totalTokens),
-            chargedMnt: acc.chargedMnt + Number(r.chargedMnt),
-        }), { count: 0, totalTokens: 0, chargedMnt: 0 }),
+        totals: {
+            ...rows.reduce((acc, r) => ({
+                count: acc.count + Number(r.count),
+                totalTokens: acc.totalTokens + Number(r.totalTokens),
+            }), { count: 0, totalTokens: 0 }),
+            charged: chargedByCurrency(rows),
+        },
     };
 }
 /**
@@ -76,35 +106,62 @@ export async function summarizeExecutions(workspaceId, window) {
  *
  * Days with no activity are absent rather than zero — the caller knows
  * the window it asked for, and a gap means "nothing ran", which a
- * chart should draw as zero and a table should leave empty. `date` is
- * a `YYYY-MM-DD` string in UTC, so the series is stable regardless of
- * where the reader is.
+ * chart should draw as zero and a table should leave empty.
+ *
+ * `date` is a `YYYY-MM-DD` string in `timeZone`, which defaults to UTC.
+ * Pass the reader's own zone: bucketing a +08:00 reader's 00:36 turn in
+ * UTC files it on the previous day.
  */
-export async function summarizeExecutionsByDay(workspaceId, window) {
-    const day = sql `to_char(${executions.startedAt} AT TIME ZONE 'UTC', 'YYYY-MM-DD')`;
+export async function summarizeExecutionsByDay(workspaceId, window, options = {}) {
+    // Bound, not interpolated: the zone reaches here from a cookie the
+    // browser wrote, so it is caller input like any other.
+    //
+    // Two conversions, both needed. `started_at` is a naive timestamp
+    // holding a UTC instant, so `AT TIME ZONE 'UTC'` turns it into an
+    // instant, and the second `AT TIME ZONE` reads that instant as wall
+    // time where the reader is. One conversion would instead *declare*
+    // the stored time to be the reader's, which is a different moment.
+    const timeZone = options.timeZone ?? "UTC";
+    const day = sql `to_char(${executions.startedAt} AT TIME ZONE 'UTC' AT TIME ZONE ${timeZone}, 'YYYY-MM-DD')`;
     const rows = await db
         .select({
         date: day,
+        currency: executions.currency,
         count: sql `count(*)`,
         totalTokens: sql `coalesce(sum(${executions.totalTokens}), 0)`,
-        chargedMnt: sql `coalesce(sum(${executions.chargedMnt}), 0)`,
+        chargedMicros: sql `coalesce(sum(${executions.chargedMicros}), 0)`,
     })
         .from(executions)
         .where(and(eq(executions.workspaceId, workspaceId), gte(executions.startedAt, window.from), lte(executions.startedAt, window.to)))
-        .groupBy(day)
-        .orderBy(day);
-    return rows.map((row) => ({
-        date: row.date,
-        count: Number(row.count),
-        totalTokens: Number(row.totalTokens),
-        chargedMnt: Number(row.chargedMnt),
+        // By ordinal, not by the expression: drizzle inlines the fragment
+        // again for each clause, and with the zone bound as a parameter
+        // that makes three *different* expressions — Postgres then refuses
+        // the grouping. A literal zone matched textually and hid this.
+        .groupBy(sql `1`, executions.currency)
+        .orderBy(sql `1`);
+    // One row per day and currency; the series a chart draws is per day.
+    const byDay = new Map();
+    for (const row of rows) {
+        byDay.set(row.date, [...(byDay.get(row.date) ?? []), row]);
+    }
+    return [...byDay].map(([date, dayRows]) => ({
+        date,
+        count: dayRows.reduce((sum, row) => sum + Number(row.count), 0),
+        totalTokens: dayRows.reduce((sum, row) => sum + Number(row.totalTokens), 0),
+        charged: chargedByCurrency(dayRows),
     }));
 }
 /**
- * Executions stuck in a non-terminal state past a cutoff — a stream
- * that died without reaching complete()/fail() (`running`), or a
- * settlement that threw partway (`settling`). The cleanup cron reports
- * these; they are the operational signal that usage went unrecorded.
+ * Executions stuck in a non-terminal state past a cutoff.
+ *
+ * `running`: the stream died without reaching complete()/fail() —
+ * tokens were consumed and nothing was charged. `settling`: the charge
+ * was claimed but never confirmed — EITHER `settleUsage` threw and the
+ * workspace was not charged, OR the charge committed and the process
+ * died before the final `settling → succeeded` flip, in which case the
+ * workspace WAS charged. A `usage_records` row (or a `settled`
+ * reservation) for the same `requestId` distinguishes the two. This
+ * only reports; `createExecutions().reconcile()` repairs a row.
  */
 export async function findStaleExecutions(olderThan, limit = 100) {
     return db

package/dist/queries.js.map

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

package/package.json

@@ -1,15 +1,28 @@
 {
   "name": "@intelligo-dev/executions",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.13",
+  "description": "The execution lifecycle (admission, running, settlement) and the model cost registry.",
+  "keywords": [
+    "intelligo",
+    "ai-saas",
+    "saas",
+    "typescript",
+    "llm",
+    "usage",
+    "cost",
+    "metering",
+    "execution-boundary"
+  ],
   "license": "Apache-2.0",
+  "author": "Turtuvshin Byambaa <toroo.byamba@gmail.com>",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/intelligo-mn/framework.git",
+    "url": "git+https://github.com/intelligo-dev/intelligo.git",
     "directory": "packages/executions"
   },
-  "homepage": "https://github.com/intelligo-mn/framework#readme",
+  "homepage": "https://intelligo.dev/docs/packages/executions",
   "bugs": {
-    "url": "https://github.com/intelligo-mn/framework/issues"
+    "url": "https://github.com/intelligo-dev/intelligo/issues"
   },
   "type": "module",
   "exports": {
@@ -27,25 +40,40 @@
     }
   },
   "dependencies": {
-    "drizzle-orm": "^0.45.1",
-    "@intelligo-dev/audit": "1.0.0-beta.1",
-    "@intelligo-dev/core": "1.0.0-beta.1"
+    "@intelligo-dev/audit": "1.0.0-beta.13",
+    "@intelligo-dev/core": "1.0.0-beta.13"
+  },
+  "peerDependencies": {
+    "drizzle-orm": "^0.45.1"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/pg": "^8.16.0",
-    "pg": "^8.18.0",
-    "typescript": "^5.7.2"
+    "@types/node": "^26.6.1",
+    "@types/pg": "^8.23.1",
+    "drizzle-orm": "^0.45.2",
+    "pg": "8.18.0",
+    "typescript": "^5.9.3"
   },
   "files": [
-    "dist"
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__/**",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "!dist/**/*.tsbuildinfo"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22.14"
+  },
+  "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"
   }
 }

package/src/db/schema.ts

@@ -0,0 +1,87 @@
+/**
+ * One row per AI execution: who ran what capability, whether it was
+ * 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.
+ *
+ * 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,
+  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(),
+    workspaceId: text("workspace_id")
+      .notNull()
+      .references(() => organization.id, { onDelete: "cascade" }),
+    userId: text("user_id").references(() => users.id, {
+      onDelete: "set null",
+    }),
+    /**
+     * What the caller asked for, in the product's own vocabulary:
+     * "support.reply", "chat.message". Opaque to the framework — used for
+     * entitlement decisions, grouping, and admin filtering.
+     */
+    capability: text("capability").notNull(),
+    /**
+     * Correlation key shared with credit_reservations and
+     * usage_records. Unique per execution attempt.
+     */
+    requestId: text("request_id").notNull().unique(),
+    /**
+     * 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 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. */
+    errorMessage: text("error_message"),
+    startedAt: timestamp("started_at").notNull().defaultNow(),
+    finishedAt: timestamp("finished_at"),
+    durationMs: integer("duration_ms"),
+    metadata: jsonb("metadata").$type<Record<string, unknown>>(),
+  },
+  (table) => [
+    index("executions_workspace_started_idx").on(
+      table.workspaceId,
+      table.startedAt
+    ),
+    index("executions_status_idx").on(table.status, table.startedAt),
+    index("executions_capability_idx").on(table.capability, table.startedAt),
+  ]
+);
+
+export type Execution = typeof executions.$inferSelect;
+export type InsertExecution = typeof executions.$inferInsert;

package/src/index.ts

@@ -0,0 +1,73 @@
+/**
+ * @intelligo-dev/executions — the SaaS execution boundary.
+ *
+ * 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.
+ *
+ * The composition root builds one instance with the ports bound:
+ *
+ *   export const executions = createExecutions({
+ *     checkEntitlement: billingEntitlementPort,
+ *     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";
+
+/**
+ * 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 {
+  DEFAULT_MODELS,
+  UnknownModelError,
+  registerModel,
+  registerModels,
+  getModelPricing,
+  isModelRegistered,
+  listModels,
+  registeredModelIds,
+  clearModels,
+  DEFAULT_MARGIN_BP,
+  PROVIDER_CURRENCY,
+  providerCost,
+  chargeFor,
+  estimateWorstCaseCharge,
+} from "./pricing";
+export type {
+  ModelId,
+  ModelPricing,
+  ModelCapabilities,
+  BillingRate,
+} from "./pricing";