patchwork-os 0.2.0-beta.10.canary.110 → 0.2.0-beta.10.canary.111

package/dist/recipes/pricing/priceTable.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Model price table — cost-aware routing Phase 2 (dormant data).
+ *
+ * A `(model id) → USD-per-million-tokens` table plus a loader. Nothing
+ * consumes it yet; Phase 3 wires `costUsd()` into RunBudget so `budget.usdMax`
+ * can be enforced for *measured* (API) drivers. Lands separately so the price
+ * data can be reviewed for accuracy on its own.
+ *
+ * Design notes (docs/design/cost-aware-routing.md):
+ *   - Prices are DATA, not code, and OVERRIDABLE without a release:
+ *       precedence  env `PATCHWORK_PRICE_TABLE` (path)  >
+ *                   `~/.patchwork/prices.json`          >
+ *                   the built-in table below.
+ *   - FAIL-OPEN everywhere: an unknown model, a malformed override, or a
+ *     missing file never throws — `costUsd` just returns `undefined` (and the
+ *     budget layer treats that as "unpriceable → don't enforce").
+ *   - The built-in default lives here as a TS const (compiled into dist, so it
+ *     is always available at runtime); overrides are JSON read from disk.
+ *   - NO runtime network calls. Prices drift; refresh the const below and bump
+ *     `_generatedAt`. `isPriceTableStale()` is provided for a scheduled check.
+ */
+/** USD per 1,000,000 tokens, split by input vs output. */
+export interface ModelPrice {
+    input: number;
+    output: number;
+}
+export interface PriceTableMeta {
+    /** ISO date (YYYY-MM-DD) the built-in prices were last reviewed. */
+    _generatedAt: string;
+    _unit: "usd_per_million_tokens";
+    _source: string;
+    _note: string;
+    /** Set by the loader when an override file was merged in. */
+    _override?: string;
+}
+export interface PriceTable {
+    _meta: PriceTableMeta;
+    /** Keyed by exact model id (e.g. "gpt-4o", "claude-haiku-4-5-20251001"). */
+    prices: Record<string, ModelPrice>;
+}
+/**
+ * Built-in default prices. **Approximate public list prices** (USD / 1M tokens)
+ * as of `_generatedAt` — VERIFY before relying on a USD cap; they drift, and a
+ * subscription/CLI driver's spend is notional, not real money out. Override via
+ * `~/.patchwork/prices.json` or `PATCHWORK_PRICE_TABLE`.
+ */
+export declare const BUILTIN_PRICE_TABLE: PriceTable;
+/**
+ * Load the effective price table: the built-in default with any override file
+ * merged over its `prices`. Fail-open — an unreadable / malformed override is
+ * ignored and the built-in is returned unchanged.
+ *
+ * Override file shape: `{ "prices": { "<model>": { "input": N, "output": N } } }`
+ * (a bare `{ "<model>": { ... } }` map is also accepted for convenience).
+ */
+export declare function loadPriceTable(opts?: {
+    env?: NodeJS.ProcessEnv;
+    homeDir?: string;
+}): PriceTable;
+/** Price for one model, or undefined if the table does not list it. */
+export declare function priceFor(model: string, table?: PriceTable): ModelPrice | undefined;
+/**
+ * USD cost of a call given its token usage, or `undefined` when the model is
+ * not priced (fail-open: the budget layer then declines to enforce on it).
+ */
+export declare function costUsd(model: string, usage: {
+    inputTokens: number;
+    outputTokens: number;
+}, table?: PriceTable): number | undefined;
+/**
+ * True when the table's `_generatedAt` is unparseable, in the future, or older
+ * than `maxAgeDays` (default 548 ≈ 18 months). Pure — caller supplies `now` —
+ * so a scheduled job can fail loudly without baking a wall-clock time-bomb into
+ * every PR's test run.
+ */
+export declare function isPriceTableStale(generatedAt: string, now: number, maxAgeDays?: number): boolean;

package/dist/recipes/pricing/priceTable.js

@@ -0,0 +1,137 @@
+/**
+ * Model price table — cost-aware routing Phase 2 (dormant data).
+ *
+ * A `(model id) → USD-per-million-tokens` table plus a loader. Nothing
+ * consumes it yet; Phase 3 wires `costUsd()` into RunBudget so `budget.usdMax`
+ * can be enforced for *measured* (API) drivers. Lands separately so the price
+ * data can be reviewed for accuracy on its own.
+ *
+ * Design notes (docs/design/cost-aware-routing.md):
+ *   - Prices are DATA, not code, and OVERRIDABLE without a release:
+ *       precedence  env `PATCHWORK_PRICE_TABLE` (path)  >
+ *                   `~/.patchwork/prices.json`          >
+ *                   the built-in table below.
+ *   - FAIL-OPEN everywhere: an unknown model, a malformed override, or a
+ *     missing file never throws — `costUsd` just returns `undefined` (and the
+ *     budget layer treats that as "unpriceable → don't enforce").
+ *   - The built-in default lives here as a TS const (compiled into dist, so it
+ *     is always available at runtime); overrides are JSON read from disk.
+ *   - NO runtime network calls. Prices drift; refresh the const below and bump
+ *     `_generatedAt`. `isPriceTableStale()` is provided for a scheduled check.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Built-in default prices. **Approximate public list prices** (USD / 1M tokens)
+ * as of `_generatedAt` — VERIFY before relying on a USD cap; they drift, and a
+ * subscription/CLI driver's spend is notional, not real money out. Override via
+ * `~/.patchwork/prices.json` or `PATCHWORK_PRICE_TABLE`.
+ */
+export const BUILTIN_PRICE_TABLE = {
+    _meta: {
+        _generatedAt: "2026-06-03",
+        _unit: "usd_per_million_tokens",
+        _source: "provider public list prices",
+        _note: "Approximate list prices (USD per 1M tokens). Review before relying on budget.usdMax; override via ~/.patchwork/prices.json or PATCHWORK_PRICE_TABLE.",
+    },
+    prices: {
+        // Anthropic (Claude 4.x)
+        "claude-opus-4-8": { input: 15, output: 75 },
+        "claude-sonnet-4-6": { input: 3, output: 15 },
+        "claude-haiku-4-5-20251001": { input: 1, output: 5 },
+        // OpenAI
+        "gpt-4o": { input: 2.5, output: 10 },
+        "gpt-4o-mini": { input: 0.15, output: 0.6 },
+        // xAI (Grok)
+        "grok-2-latest": { input: 2, output: 10 },
+        // Google (Gemini, API-keyed)
+        "gemini-2.5-pro": { input: 1.25, output: 10 },
+        "gemini-2.5-flash": { input: 0.3, output: 2.5 },
+    },
+};
+const MS_PER_DAY = 86_400_000;
+/** Resolve the override file path per the precedence rule (or undefined). */
+function resolveOverridePath(env, homeDir) {
+    const envPath = env.PATCHWORK_PRICE_TABLE;
+    if (typeof envPath === "string" && envPath.trim())
+        return envPath.trim();
+    const filePath = join(homeDir, ".patchwork", "prices.json");
+    return existsSync(filePath) ? filePath : undefined;
+}
+/** Extract a valid `{input, output}` price from an unknown override entry. */
+function coercePrice(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const v = value;
+    if (typeof v.input === "number" && typeof v.output === "number") {
+        return { input: v.input, output: v.output };
+    }
+    return undefined;
+}
+/**
+ * Load the effective price table: the built-in default with any override file
+ * merged over its `prices`. Fail-open — an unreadable / malformed override is
+ * ignored and the built-in is returned unchanged.
+ *
+ * Override file shape: `{ "prices": { "<model>": { "input": N, "output": N } } }`
+ * (a bare `{ "<model>": { ... } }` map is also accepted for convenience).
+ */
+export function loadPriceTable(opts = {}) {
+    const env = opts.env ?? process.env;
+    const homeDir = opts.homeDir ?? homedir();
+    const overridePath = resolveOverridePath(env, homeDir);
+    if (!overridePath)
+        return BUILTIN_PRICE_TABLE;
+    try {
+        const parsed = JSON.parse(readFileSync(overridePath, "utf8"));
+        const root = (parsed ?? {});
+        const rawPrices = root.prices && typeof root.prices === "object" ? root.prices : root;
+        const merged = {
+            ...BUILTIN_PRICE_TABLE.prices,
+        };
+        for (const [model, entry] of Object.entries(rawPrices)) {
+            const price = coercePrice(entry);
+            if (price)
+                merged[model] = price;
+        }
+        return {
+            _meta: { ...BUILTIN_PRICE_TABLE._meta, _override: overridePath },
+            prices: merged,
+        };
+    }
+    catch {
+        // Malformed / unreadable override → fail open to the built-in table.
+        return BUILTIN_PRICE_TABLE;
+    }
+}
+/** Price for one model, or undefined if the table does not list it. */
+export function priceFor(model, table = loadPriceTable()) {
+    return table.prices[model];
+}
+/**
+ * USD cost of a call given its token usage, or `undefined` when the model is
+ * not priced (fail-open: the budget layer then declines to enforce on it).
+ */
+export function costUsd(model, usage, table = loadPriceTable()) {
+    const price = priceFor(model, table);
+    if (!price)
+        return undefined;
+    return ((usage.inputTokens / 1_000_000) * price.input +
+        (usage.outputTokens / 1_000_000) * price.output);
+}
+/**
+ * True when the table's `_generatedAt` is unparseable, in the future, or older
+ * than `maxAgeDays` (default 548 ≈ 18 months). Pure — caller supplies `now` —
+ * so a scheduled job can fail loudly without baking a wall-clock time-bomb into
+ * every PR's test run.
+ */
+export function isPriceTableStale(generatedAt, now, maxAgeDays = 548) {
+    const t = Date.parse(generatedAt);
+    if (Number.isNaN(t))
+        return true;
+    if (t > now)
+        return true;
+    return now - t > maxAgeDays * MS_PER_DAY;
+}
+//# sourceMappingURL=priceTable.js.map

package/dist/recipes/pricing/priceTable.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "patchwork-os",
-  "version": "0.2.0-beta.10.canary.110",
+  "version": "0.2.0-beta.10.canary.111",
   "description": "Your personal AI runtime, local-first. Patchwork OS gives any AI model a consistent set of tools, YAML recipes, a delegation policy with approval queue, and a durable trace memory — all on your machine, all under your policy.",
   "type": "module",
   "main": "dist/index.js",