@intelligo-dev/executions 1.0.0-beta.1

package/dist/pricing.js

@@ -0,0 +1,187 @@
+/**
+ * Model registry and execution cost accounting.
+ *
+ * This lives in `executions` rather than beside the provider clients
+ * because it is not AI code: it is what an execution costs. The
+ * boundary records actor, workspace, capability, usage and cost
+ * (ADR-0003), and the price of a token is the last of those.
+ *
+ * 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.
+ */
+/**
+ * Model configuration with display information and cost tracking
+ *
+ * 6 models, 3 providers: Google (2), OpenAI (3), Anthropic (1)
+ */
+export const MODEL_CONFIGS = {
+    // Google Gemini
+    "google/gemini-2.5-flash": {
+        provider: "google",
+        model: "gemini-2.5-flash",
+        displayName: "Gemini 2.5 Flash",
+        costPerMInputTokens: 0.3,
+        costPerMOutputTokens: 2.5,
+        capabilities: {
+            thinking: true,
+            toolCall: true,
+            vision: true,
+            webSearch: true,
+            codeExec: true,
+        },
+    },
+    "google/gemini-2.5-pro": {
+        provider: "google",
+        model: "gemini-2.5-pro",
+        displayName: "Gemini 2.5 Pro",
+        costPerMInputTokens: 1.25,
+        costPerMOutputTokens: 10,
+        capabilities: {
+            thinking: true,
+            toolCall: true,
+            vision: true,
+            webSearch: true,
+            codeExec: true,
+        },
+    },
+    // OpenAI
+    "openai/gpt-5-mini": {
+        provider: "openai",
+        model: "gpt-5-mini",
+        displayName: "GPT-5 Mini",
+        costPerMInputTokens: 0.25,
+        costPerMOutputTokens: 2.0,
+        capabilities: {
+            thinking: true,
+            toolCall: true,
+            vision: true,
+            webSearch: false,
+            codeExec: false,
+        },
+    },
+    "openai/gpt-5.4-mini": {
+        provider: "openai",
+        model: "gpt-5.4-mini",
+        displayName: "GPT-5.4 Mini",
+        costPerMInputTokens: 0.75,
+        costPerMOutputTokens: 4.5,
+        capabilities: {
+            thinking: true,
+            toolCall: true,
+            vision: true,
+            webSearch: true,
+            codeExec: true,
+        },
+    },
+    "openai/o4-mini": {
+        provider: "openai",
+        model: "o4-mini",
+        displayName: "o4-mini",
+        costPerMInputTokens: 1.1,
+        costPerMOutputTokens: 4.4,
+        capabilities: {
+            thinking: true,
+            toolCall: true,
+            vision: true,
+            webSearch: true,
+            codeExec: true,
+        },
+    },
+    // Anthropic
+    "anthropic/claude-sonnet-4-6": {
+        provider: "anthropic",
+        model: "claude-sonnet-4-6-20260214",
+        displayName: "Claude Sonnet 4.6",
+        costPerMInputTokens: 3.0,
+        costPerMOutputTokens: 15.0,
+        capabilities: {
+            thinking: true,
+            toolCall: true,
+            vision: true,
+            webSearch: true,
+            codeExec: true,
+        },
+    },
+};
+/**
+ * Calculate the dollar cost for a given model and token counts.
+ */
+export function calculateCost(modelId, inputTokens, outputTokens) {
+    const config = MODEL_CONFIGS[modelId];
+    if (!config) {
+        // Loud fallback: an unknown model ID means somewhere upstream is
+        // shipping a stale string that doesn't match MODEL_CONFIGS. We
+        // price it at the highest known rate so we don't accidentally give
+        // away expensive completions for free, but the warning here is the
+        // contract — silent fallback is how we ended up over-billing every
+        // free Gemini turn at Claude prices.
+        console.warn(`[calculateCost] Unknown model "${modelId}" — pricing at worst-case Claude rate ($3/$15 per M). Add it to MODEL_CONFIGS.`);
+        return (inputTokens / 1000000) * 3.0 + (outputTokens / 1000000) * 15.0;
+    }
+    return ((inputTokens / 1000000) * config.costPerMInputTokens +
+        (outputTokens / 1000000) * config.costPerMOutputTokens);
+}
+/**
+ * Default billing margin multiplier applied on top of raw model cost.
+ * Covers infra, tool overhead, FX volatility, and profit. Tunable per
+ * deploy via billing_settings.margin_multiplier; this constant is the
+ * fallback when the DB value is absent.
+ *
+ * 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.
+ */
+export const DEFAULT_BILLING_MARGIN = 4;
+/**
+ * Default USD→MNT exchange rate fallback. Real value lives in
+ * billing_settings.usd_to_mnt_rate and is read per request.
+ */
+export const DEFAULT_USD_TO_MNT_RATE = 3450;
+/**
+ * Per-model maximum output budget used for worst-case pre-request cost
+ * estimation in checkQuota. Numbers are conservative — cap on streamed
+ * output tokens we'd actually let a single chat turn produce.
+ */
+export const MODEL_OUTPUT_BUDGET = {
+    "google/gemini-2.5-flash": 8000,
+    "google/gemini-2.5-pro": 8000,
+    "openai/gpt-5-mini": 8000,
+    "openai/gpt-5.4-mini": 8000,
+    "openai/o4-mini": 8000,
+    "anthropic/claude-sonnet-4-6": 8000,
+};
+/**
+ * Convert raw model cost to MNT user-facing charged amount.
+ *
+ * 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.
+ */
+export function calculateChargedMnt(modelId, inputTokens, outputTokens, fxRate = DEFAULT_USD_TO_MNT_RATE, margin = DEFAULT_BILLING_MARGIN) {
+    const rawCostUsd = calculateCost(modelId, inputTokens, outputTokens);
+    const chargedMnt = Math.ceil(rawCostUsd * margin * fxRate);
+    return { rawCostUsd, chargedMnt };
+}
+/**
+ * Worst-case MNT cost estimate for a single chat turn against a given
+ * model. Used by checkQuota to refuse requests whose ceiling cost would
+ * exceed remaining balance, before we burn provider tokens. Uses the
+ * full MODEL_OUTPUT_BUDGET as the output side and a generous 16K input
+ * budget to cover system prompt + conversation history.
+ */
+export function estimateWorstCaseChargedMnt(modelId, fxRate = DEFAULT_USD_TO_MNT_RATE, margin = DEFAULT_BILLING_MARGIN) {
+    const outputBudget = MODEL_OUTPUT_BUDGET[modelId] ?? 8000;
+    const inputBudget = 16000;
+    return calculateChargedMnt(modelId, inputBudget, outputBudget, fxRate, margin)
+        .chargedMnt;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/queries.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Read models over the executions table — for the product's usage UI
+ * and, in Phase 5, the Intelligo admin console.
+ */
+export type ListExecutionsOptions = {
+    workspaceId?: string;
+    userId?: string;
+    capability?: string;
+    status?: "running" | "settling" | "succeeded" | "failed" | "refused";
+    /** Keyset pagination: rows started strictly before this. */
+    before?: Date;
+    limit?: number;
+};
+export declare function listExecutions(options?: ListExecutionsOptions): Promise<{
+    id: string;
+    workspaceId: string;
+    userId: string | null;
+    capability: string;
+    requestId: string;
+    status: string;
+    model: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    totalTokens: number | null;
+    chargedMnt: number | null;
+    reservedMnt: number | null;
+    refusalReason: string | null;
+    errorMessage: string | null;
+    startedAt: Date;
+    finishedAt: Date | null;
+    durationMs: number | null;
+    metadata: Record<string, unknown> | null;
+}[]>;
+export declare function getExecutionByRequestId(requestId: string): Promise<{
+    id: string;
+    workspaceId: string;
+    userId: string | null;
+    capability: string;
+    requestId: string;
+    status: string;
+    model: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    totalTokens: number | null;
+    chargedMnt: number | null;
+    reservedMnt: number | null;
+    refusalReason: string | null;
+    errorMessage: string | null;
+    startedAt: Date;
+    finishedAt: Date | null;
+    durationMs: number | null;
+    metadata: Record<string, unknown> | null;
+} | null>;
+/**
+ * Aggregate counts, tokens, and charge for a workspace over a window.
+ * Refused executions are counted separately — they consumed no tokens
+ * but they are the signal that a plan's limits are biting.
+ */
+export declare function summarizeExecutions(workspaceId: string, window: {
+    from: Date;
+    to: Date;
+}): Promise<{
+    byStatus: {
+        [k: string]: {
+            count: number;
+            totalTokens: number;
+            chargedMnt: number;
+        };
+    };
+    totals: {
+        count: number;
+        totalTokens: number;
+        chargedMnt: number;
+    };
+}>;
+/**
+ * Per-day totals for a workspace over a window — the read model behind
+ * a usage chart.
+ *
+ * Aggregated in SQL rather than by bucketing rows in the application:
+ * a month of a busy workspace is thousands of rows to ship over the
+ * wire to produce thirty numbers, and any consumer that had to do that
+ * bucketing itself would be writing the query this package should own.
+ *
+ * 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.
+ */
+export declare function summarizeExecutionsByDay(workspaceId: string, window: {
+    from: Date;
+    to: Date;
+}): Promise<Array<{
+    date: string;
+    count: number;
+    totalTokens: number;
+    chargedMnt: number;
+}>>;
+/**
+ * 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.
+ */
+export declare function findStaleExecutions(olderThan: Date, limit?: number): Promise<{
+    id: string;
+    workspaceId: string;
+    userId: string | null;
+    capability: string;
+    requestId: string;
+    status: string;
+    model: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    totalTokens: number | null;
+    chargedMnt: number | null;
+    reservedMnt: number | null;
+    refusalReason: string | null;
+    errorMessage: string | null;
+    startedAt: Date;
+    finishedAt: Date | null;
+    durationMs: number | null;
+    metadata: Record<string, unknown> | null;
+}[]>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/queries.d.ts.map

@@ -0,0 +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"}

package/dist/queries.js

@@ -0,0 +1,117 @@
+/**
+ * Read models over the executions table — for the product's usage UI
+ * and, in Phase 5, the Intelligo admin console.
+ */
+import { db } from "@intelligo-dev/core/db";
+import { and, desc, eq, gte, inArray, lt, lte, sql } from "drizzle-orm";
+import { executions } from "./db/schema";
+export async function listExecutions(options = {}) {
+    const filters = [
+        options.workspaceId
+            ? eq(executions.workspaceId, options.workspaceId)
+            : undefined,
+        options.userId ? eq(executions.userId, options.userId) : undefined,
+        options.capability
+            ? eq(executions.capability, options.capability)
+            : undefined,
+        options.status ? eq(executions.status, options.status) : undefined,
+        options.before ? lt(executions.startedAt, options.before) : undefined,
+    ].filter(Boolean);
+    return db
+        .select()
+        .from(executions)
+        .where(filters.length > 0 ? and(...filters) : undefined)
+        .orderBy(desc(executions.startedAt))
+        .limit(Math.min(options.limit ?? 50, 500));
+}
+export async function getExecutionByRequestId(requestId) {
+    const [row] = await db
+        .select()
+        .from(executions)
+        .where(eq(executions.requestId, requestId))
+        .limit(1);
+    return row ?? null;
+}
+/**
+ * Aggregate counts, tokens, and charge for a workspace over a window.
+ * Refused executions are counted separately — they consumed no tokens
+ * but they are the signal that a plan's limits are biting.
+ */
+export async function summarizeExecutions(workspaceId, window) {
+    const rows = await db
+        .select({
+        status: executions.status,
+        count: sql `count(*)`,
+        totalTokens: sql `coalesce(sum(${executions.totalTokens}), 0)`,
+        chargedMnt: sql `coalesce(sum(${executions.chargedMnt}), 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),
+        },
+    ]));
+    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 }),
+    };
+}
+/**
+ * Per-day totals for a workspace over a window — the read model behind
+ * a usage chart.
+ *
+ * Aggregated in SQL rather than by bucketing rows in the application:
+ * a month of a busy workspace is thousands of rows to ship over the
+ * wire to produce thirty numbers, and any consumer that had to do that
+ * bucketing itself would be writing the query this package should own.
+ *
+ * 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.
+ */
+export async function summarizeExecutionsByDay(workspaceId, window) {
+    const day = sql `to_char(${executions.startedAt} AT TIME ZONE 'UTC', 'YYYY-MM-DD')`;
+    const rows = await db
+        .select({
+        date: day,
+        count: sql `count(*)`,
+        totalTokens: sql `coalesce(sum(${executions.totalTokens}), 0)`,
+        chargedMnt: sql `coalesce(sum(${executions.chargedMnt}), 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),
+    }));
+}
+/**
+ * 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.
+ */
+export async function findStaleExecutions(olderThan, limit = 100) {
+    return db
+        .select()
+        .from(executions)
+        .where(and(inArray(executions.status, ["running", "settling"]), lt(executions.startedAt, olderThan)))
+        .orderBy(desc(executions.startedAt))
+        .limit(limit);
+}
+//# sourceMappingURL=queries.js.map

package/dist/queries.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@intelligo-dev/executions",
+  "version": "1.0.0-beta.1",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligo-mn/framework.git",
+    "directory": "packages/executions"
+  },
+  "homepage": "https://github.com/intelligo-mn/framework#readme",
+  "bugs": {
+    "url": "https://github.com/intelligo-mn/framework/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./pricing": {
+      "types": "./dist/pricing.d.ts",
+      "default": "./dist/pricing.js"
+    },
+    "./db": {
+      "types": "./dist/db/schema.d.ts",
+      "default": "./dist/db/schema.js"
+    }
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.45.1",
+    "@intelligo-dev/audit": "1.0.0-beta.1",
+    "@intelligo-dev/core": "1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.16.0",
+    "pg": "^8.18.0",
+    "typescript": "^5.7.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "build": "tsc -p tsconfig.build.json"
+  }
+}