@cendor/core 0.2.0

package/dist/json-decimal.js

@@ -0,0 +1,189 @@
+/**
+ * A JSON parser that decodes every number as a `Decimal` instead of an IEEE double — the TS mirror of
+ * Python's `json.loads(text, parse_float=Decimal)`. The price-dataset spec mandates that rates (money)
+ * never round-trip through binary floating point in any language, so both the bundled snapshot and any
+ * `refresh()`ed table are parsed through this. Dependency-free recursive-descent parser.
+ */
+import { Dec } from './decimal.js';
+class Parser {
+    s;
+    i = 0;
+    constructor(s) {
+        this.s = s;
+    }
+    parse() {
+        this.ws();
+        const value = this.value();
+        this.ws();
+        if (this.i !== this.s.length)
+            throw new SyntaxError(`Unexpected trailing content at ${this.i}`);
+        return value;
+    }
+    ws() {
+        while (this.i < this.s.length) {
+            const c = this.s.charCodeAt(this.i);
+            // space, tab, newline, carriage return
+            if (c === 0x20 || c === 0x09 || c === 0x0a || c === 0x0d)
+                this.i++;
+            else
+                break;
+        }
+    }
+    value() {
+        const c = this.s[this.i];
+        if (c === '{')
+            return this.object();
+        if (c === '[')
+            return this.array();
+        if (c === '"')
+            return this.string();
+        if (c === '-' || (c !== undefined && c >= '0' && c <= '9'))
+            return this.number();
+        if (this.s.startsWith('true', this.i)) {
+            this.i += 4;
+            return true;
+        }
+        if (this.s.startsWith('false', this.i)) {
+            this.i += 5;
+            return false;
+        }
+        if (this.s.startsWith('null', this.i)) {
+            this.i += 4;
+            return null;
+        }
+        throw new SyntaxError(`Unexpected token '${c}' at ${this.i}`);
+    }
+    object() {
+        const obj = {};
+        this.i++; // {
+        this.ws();
+        if (this.s[this.i] === '}') {
+            this.i++;
+            return obj;
+        }
+        for (;;) {
+            this.ws();
+            if (this.s[this.i] !== '"')
+                throw new SyntaxError(`Expected key string at ${this.i}`);
+            const key = this.string();
+            this.ws();
+            if (this.s[this.i] !== ':')
+                throw new SyntaxError(`Expected ':' at ${this.i}`);
+            this.i++;
+            this.ws();
+            obj[key] = this.value();
+            this.ws();
+            const ch = this.s[this.i];
+            if (ch === ',') {
+                this.i++;
+                continue;
+            }
+            if (ch === '}') {
+                this.i++;
+                return obj;
+            }
+            throw new SyntaxError(`Expected ',' or '}' at ${this.i}`);
+        }
+    }
+    array() {
+        const arr = [];
+        this.i++; // [
+        this.ws();
+        if (this.s[this.i] === ']') {
+            this.i++;
+            return arr;
+        }
+        for (;;) {
+            this.ws();
+            arr.push(this.value());
+            this.ws();
+            const ch = this.s[this.i];
+            if (ch === ',') {
+                this.i++;
+                continue;
+            }
+            if (ch === ']') {
+                this.i++;
+                return arr;
+            }
+            throw new SyntaxError(`Expected ',' or ']' at ${this.i}`);
+        }
+    }
+    string() {
+        this.i++; // opening quote
+        let out = '';
+        for (;;) {
+            const c = this.s[this.i++];
+            if (c === undefined)
+                throw new SyntaxError('Unterminated string');
+            if (c === '"')
+                return out;
+            if (c === '\\') {
+                const e = this.s[this.i++];
+                switch (e) {
+                    case '"':
+                        out += '"';
+                        break;
+                    case '\\':
+                        out += '\\';
+                        break;
+                    case '/':
+                        out += '/';
+                        break;
+                    case 'b':
+                        out += '\b';
+                        break;
+                    case 'f':
+                        out += '\f';
+                        break;
+                    case 'n':
+                        out += '\n';
+                        break;
+                    case 'r':
+                        out += '\r';
+                        break;
+                    case 't':
+                        out += '\t';
+                        break;
+                    case 'u': {
+                        const hex = this.s.slice(this.i, this.i + 4);
+                        this.i += 4;
+                        out += String.fromCharCode(Number.parseInt(hex, 16));
+                        break;
+                    }
+                    default:
+                        throw new SyntaxError(`Bad escape \\${e}`);
+                }
+            }
+            else {
+                out += c;
+            }
+        }
+    }
+    number() {
+        const start = this.i;
+        if (this.s[this.i] === '-')
+            this.i++;
+        while (this.i < this.s.length) {
+            const c = this.s[this.i];
+            if ((c !== undefined && c >= '0' && c <= '9') ||
+                c === '.' ||
+                c === 'e' ||
+                c === 'E' ||
+                c === '+' ||
+                c === '-') {
+                this.i++;
+            }
+            else {
+                break;
+            }
+        }
+        const token = this.s.slice(start, this.i);
+        // Pass the raw token straight to Decimal so precision is preserved (never through a JS number).
+        return new Dec(token);
+    }
+}
+export function parseDecimalJson(text) {
+    return new Parser(text).parse();
+}
+//# sourceMappingURL=json-decimal.js.map

package/dist/json-decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-decimal.js","sourceRoot":"","sources":["../src/json-decimal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,GAAG,EAAgB,MAAM,cAAc,CAAC;AAUjD,MAAM,MAAM;IAEmB;IADrB,CAAC,GAAG,CAAC,CAAC;IACd,YAA6B,CAAS;QAAT,MAAC,GAAD,CAAC,CAAQ;IAAG,CAAC;IAE1C,KAAK;QACH,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,MAAM,IAAI,WAAW,CAAC,kCAAkC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAChG,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,EAAE;QACR,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpC,uCAAuC;YACvC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,CAAC,EAAE,CAAC;;gBAC9D,MAAM;QACb,CAAC;IACH,CAAC;IAEO,KAAK;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACjF,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,WAAW,CAAC,qBAAqB,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAwC,EAAE,CAAC;QACpD,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QACd,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;YACT,OAAO,GAAG,CAAC;QACb,CAAC;QACD,SAAS,CAAC;YACR,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,MAAM,IAAI,WAAW,CAAC,0BAA0B,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YACtF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,MAAM,IAAI,WAAW,CAAC,mBAAmB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/E,IAAI,CAAC,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,EAAE,CAAC;gBACT,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,EAAE,CAAC;gBACT,OAAO,GAAG,CAAC;YACb,CAAC;YACD,MAAM,IAAI,WAAW,CAAC,0BAA0B,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEO,KAAK;QACX,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QACd,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;YACT,OAAO,GAAG,CAAC;QACb,CAAC;QACD,SAAS,CAAC;YACR,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACvB,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,EAAE,CAAC;gBACT,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,EAAE,CAAC;gBACT,OAAO,GAAG,CAAC;YACb,CAAC;YACD,MAAM,IAAI,WAAW,CAAC,0BAA0B,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,gBAAgB;QAC1B,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,SAAS,CAAC;YACR,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,SAAS;gBAAE,MAAM,IAAI,WAAW,CAAC,qBAAqB,CAAC,CAAC;YAClE,IAAI,CAAC,KAAK,GAAG;gBAAE,OAAO,GAAG,CAAC;YAC1B,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC3B,QAAQ,CAAC,EAAE,CAAC;oBACV,KAAK,GAAG;wBACN,GAAG,IAAI,GAAG,CAAC;wBACX,MAAM;oBACR,KAAK,IAAI;wBACP,GAAG,IAAI,IAAI,CAAC;wBACZ,MAAM;oBACR,KAAK,GAAG;wBACN,GAAG,IAAI,GAAG,CAAC;wBACX,MAAM;oBACR,KAAK,GAAG;wBACN,GAAG,IAAI,IAAI,CAAC;wBACZ,MAAM;oBACR,KAAK,GAAG;wBACN,GAAG,IAAI,IAAI,CAAC;wBACZ,MAAM;oBACR,KAAK,GAAG;wBACN,GAAG,IAAI,IAAI,CAAC;wBACZ,MAAM;oBACR,KAAK,GAAG;wBACN,GAAG,IAAI,IAAI,CAAC;wBACZ,MAAM;oBACR,KAAK,GAAG;wBACN,GAAG,IAAI,IAAI,CAAC;wBACZ,MAAM;oBACR,KAAK,GAAG,CAAC,CAAC,CAAC;wBACT,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;wBAC7C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;wBACZ,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;wBACrD,MAAM;oBACR,CAAC;oBACD;wBACE,MAAM,IAAI,WAAW,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,GAAG,IAAI,CAAC,CAAC;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzB,IACE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC;gBACzC,CAAC,KAAK,GAAG;gBACT,CAAC,KAAK,GAAG;gBACT,CAAC,KAAK,GAAG;gBACT,CAAC,KAAK,GAAG;gBACT,CAAC,KAAK,GAAG,EACT,CAAC;gBACD,IAAI,CAAC,CAAC,EAAE,CAAC;YACX,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,gGAAgG;QAChG,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAClC,CAAC"}

package/dist/prices-snapshot.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The bundled offline price snapshot, embedded verbatim from the Python `cendor-core` `prices.json`
+ * so cost estimation works with zero network and zero filesystem access (edge/browser-safe). Parsed
+ * through {@link parseDecimalJson} so rates stay exact `Decimal`s. Refresh a live table with
+ * `prices.refresh(...)`. Format is pinned by the price-dataset spec (`prices/1`).
+ */
+export declare const PRICES_JSON = "{\n  \"_note\": \"Illustrative offline snapshot of per-token USD rates. Not authoritative \u2014 refresh live via prices.refresh(source='litellm'|'openrouter'|'azure') or prices.refresh(url=...), or replace with your own dated snapshot. See docs/core.md \u00A77.\",\n  \"_updated\": \"2026-06-26\",\n  \"models\": {\n    \"gpt-4o\":            {\"input\": 0.0000025,  \"output\": 0.00001,   \"cached\": 0.00000125},\n    \"gpt-4o-mini\":       {\"input\": 0.00000015, \"output\": 0.0000006, \"cached\": 0.000000075},\n    \"gpt-4.1\":           {\"input\": 0.000002,   \"output\": 0.000008,  \"cached\": 0.0000005},\n    \"gpt-4.1-mini\":      {\"input\": 0.0000004,  \"output\": 0.0000016, \"cached\": 0.0000001},\n    \"gpt-4.1-nano\":      {\"input\": 0.0000001,  \"output\": 0.0000004, \"cached\": 0.000000025},\n    \"o1\":                {\"input\": 0.000015,   \"output\": 0.00006,   \"cached\": 0.0000075},\n    \"o1-mini\":           {\"input\": 0.0000011,  \"output\": 0.0000044, \"cached\": 0.00000055},\n    \"o3\":                {\"input\": 0.000002,   \"output\": 0.000008,  \"cached\": 0.0000005},\n    \"o3-mini\":           {\"input\": 0.0000011,  \"output\": 0.0000044, \"cached\": 0.00000055},\n    \"o4-mini\":           {\"input\": 0.0000011,  \"output\": 0.0000044, \"cached\": 0.000000275},\n    \"gpt-4-turbo\":       {\"input\": 0.00001,    \"output\": 0.00003},\n    \"gpt-3.5-turbo\":     {\"input\": 0.0000005,  \"output\": 0.0000015},\n    \"claude-opus-4-8\":   {\"input\": 0.000005,   \"output\": 0.000025,  \"cached\": 0.0000005, \"cache_write\": 0.00000625},\n    \"claude-sonnet-4-6\": {\"input\": 0.000003,   \"output\": 0.000015,  \"cached\": 0.0000003, \"cache_write\": 0.00000375},\n    \"claude-haiku-4-5\":  {\"input\": 0.0000008,  \"output\": 0.000004,  \"cached\": 0.00000008, \"cache_write\": 0.000001},\n    \"gemini-2.5-pro\":    {\"input\": 0.00000125, \"output\": 0.00001,   \"cached\": 0.0000003125},\n    \"gemini-2.5-flash\":  {\"input\": 0.0000003,  \"output\": 0.0000025, \"cached\": 0.000000075},\n    \"gemini-2.0-flash\":  {\"input\": 0.0000001,  \"output\": 0.0000004},\n    \"gemini-1.5-pro\":    {\"input\": 0.00000125, \"output\": 0.000005},\n    \"llama3\":            {\"input\": 0.0,        \"output\": 0.0}\n  }\n}";
+//# sourceMappingURL=prices-snapshot.d.ts.map

package/dist/prices-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices-snapshot.d.ts","sourceRoot":"","sources":["../src/prices-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,2uEAyBtB,CAAC"}

package/dist/prices-snapshot.js

@@ -0,0 +1,33 @@
+/**
+ * The bundled offline price snapshot, embedded verbatim from the Python `cendor-core` `prices.json`
+ * so cost estimation works with zero network and zero filesystem access (edge/browser-safe). Parsed
+ * through {@link parseDecimalJson} so rates stay exact `Decimal`s. Refresh a live table with
+ * `prices.refresh(...)`. Format is pinned by the price-dataset spec (`prices/1`).
+ */
+export const PRICES_JSON = `{
+  "_note": "Illustrative offline snapshot of per-token USD rates. Not authoritative — refresh live via prices.refresh(source='litellm'|'openrouter'|'azure') or prices.refresh(url=...), or replace with your own dated snapshot. See docs/core.md §7.",
+  "_updated": "2026-06-26",
+  "models": {
+    "gpt-4o":            {"input": 0.0000025,  "output": 0.00001,   "cached": 0.00000125},
+    "gpt-4o-mini":       {"input": 0.00000015, "output": 0.0000006, "cached": 0.000000075},
+    "gpt-4.1":           {"input": 0.000002,   "output": 0.000008,  "cached": 0.0000005},
+    "gpt-4.1-mini":      {"input": 0.0000004,  "output": 0.0000016, "cached": 0.0000001},
+    "gpt-4.1-nano":      {"input": 0.0000001,  "output": 0.0000004, "cached": 0.000000025},
+    "o1":                {"input": 0.000015,   "output": 0.00006,   "cached": 0.0000075},
+    "o1-mini":           {"input": 0.0000011,  "output": 0.0000044, "cached": 0.00000055},
+    "o3":                {"input": 0.000002,   "output": 0.000008,  "cached": 0.0000005},
+    "o3-mini":           {"input": 0.0000011,  "output": 0.0000044, "cached": 0.00000055},
+    "o4-mini":           {"input": 0.0000011,  "output": 0.0000044, "cached": 0.000000275},
+    "gpt-4-turbo":       {"input": 0.00001,    "output": 0.00003},
+    "gpt-3.5-turbo":     {"input": 0.0000005,  "output": 0.0000015},
+    "claude-opus-4-8":   {"input": 0.000005,   "output": 0.000025,  "cached": 0.0000005, "cache_write": 0.00000625},
+    "claude-sonnet-4-6": {"input": 0.000003,   "output": 0.000015,  "cached": 0.0000003, "cache_write": 0.00000375},
+    "claude-haiku-4-5":  {"input": 0.0000008,  "output": 0.000004,  "cached": 0.00000008, "cache_write": 0.000001},
+    "gemini-2.5-pro":    {"input": 0.00000125, "output": 0.00001,   "cached": 0.0000003125},
+    "gemini-2.5-flash":  {"input": 0.0000003,  "output": 0.0000025, "cached": 0.000000075},
+    "gemini-2.0-flash":  {"input": 0.0000001,  "output": 0.0000004},
+    "gemini-1.5-pro":    {"input": 0.00000125, "output": 0.000005},
+    "llama3":            {"input": 0.0,        "output": 0.0}
+  }
+}`;
+//# sourceMappingURL=prices-snapshot.js.map

package/dist/prices-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices-snapshot.js","sourceRoot":"","sources":["../src/prices-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;EAyBzB,CAAC"}

package/dist/prices.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Offline-first price registry: a bundled snapshot plus an optional live `refresh()`. The TS mirror of
+ * `cendor.core.prices`. Costs are exact `Decimal` `Money` — never IEEE floats (price-dataset spec
+ * `prices/1`). `refresh()` is async here (JS is async-first; Python's sync `urllib` becomes `fetch`).
+ */
+import { type Decimal, type DecimalValue } from './decimal.js';
+import { type DecimalJsonValue } from './json-decimal.js';
+import { Money } from './types.js';
+/** Raised when a model id is not present in the price table. */
+export declare class UnknownModelError extends Error {
+    constructor(model: string);
+}
+type Rates = Record<string, Decimal>;
+interface Table {
+    _updated?: string;
+    models: Record<string, Rates>;
+}
+/** Default static snapshot location used by `refresh()` when no url or source is given. */
+export declare const SNAPSHOT_URL = "https://raw.githubusercontent.com/cendorhq/cendor-libs/main/packages/cendor-core/src/cendor/core/prices.json";
+export declare const LITELLM_URL = "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json";
+export declare const OPENROUTER_URL = "https://openrouter.ai/api/v1/models";
+export declare const AZURE_URL = "https://prices.azure.com/api/retail/prices?api-version=2023-01-01-preview&$filter=productName eq 'Azure OpenAI'";
+export interface EstimateOptions {
+    outputTokens?: number;
+    cachedTokens?: number;
+    cacheWriteTokens?: number;
+}
+/**
+ * Estimate the cost of a call from the price snapshot, as exact `Decimal` `Money`. `cachedTokens` is a
+ * subset of `inputTokens`, billed once: `input*(input−cached) + cached*cachedRate`. Unknown model
+ * throws {@link UnknownModelError}. Mirrors `cendor.core.prices.estimate`.
+ */
+export declare function estimate(model: string, inputTokens: number, opts?: EstimateOptions): Money;
+export interface RegisterRates {
+    input: DecimalValue;
+    output?: DecimalValue;
+    cached?: DecimalValue;
+    cache_write?: DecimalValue;
+}
+/**
+ * Register (or overwrite) a model's **per-token** rates in the active price table, so a model absent
+ * from the bundled snapshot (a custom/deployment/Hub id) is costed and USD budgets bind on it.
+ * Rates are exact `Decimal`. The higher-level `@cendor/sdk` `registerModelPrice` handles per-1M/1K
+ * unit conversion before calling this. Dropped by {@link _reset}.
+ */
+export declare function register(model: string, rates: RegisterRates): void;
+/** Sorted list of model ids known to the current price table. */
+export declare function models(): string[];
+/** The `_updated` date of the loaded snapshot, or `null`. */
+export declare function snapshotDate(): string | null;
+/** `"bundled"` or `"refreshed"` — where the active table came from. */
+export declare function source(): string;
+/** Finer provenance: `"bundled"` | `"litellm"` | `"openrouter"` | `"azure"` | `"custom"` | `"default"`. */
+export declare function sourceName(): string;
+/** The URL the active table was fetched from, or `null` if it's the bundled snapshot. */
+export declare function sourceUrl(): string | null;
+/** Age of the active table in days (today − `_updated`), or `null` if undatable. */
+export declare function ageDays(today?: Date): number | null;
+/** `true` if the table is older than `maxAgeDays` (an undatable table is never stale). */
+export declare function isStale(maxAgeDays?: number): boolean;
+type Mapper = (raw: DecimalJsonValue) => Table;
+/** Names of the built-in live price sources accepted by `refresh({ source })`. */
+export declare function sources(): string[];
+export interface RefreshOptions {
+    source?: string;
+    mapper?: Mapper;
+    timeout?: number;
+}
+/**
+ * Replace the table from a live source or static JSON URL. Never throws; offline-safe. Returns `true`
+ * if the table was updated, `false` if the fetch/parse/map failed (the current table stays active).
+ * Mirrors `cendor.core.prices.refresh` (async here: uses `fetch`).
+ */
+export declare function refresh(url?: string, opts?: RefreshOptions): Promise<boolean>;
+/** Test helper: drop the loaded table so the bundled snapshot reloads. */
+export declare function _reset(): void;
+export {};
+//# sourceMappingURL=prices.d.ts.map

package/dist/prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.d.ts","sourceRoot":"","sources":["../src/prices.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAO,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,gEAAgE;AAChE,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,MAAM;CAI1B;AAED,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrC,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/B;AAOD,2FAA2F;AAC3F,eAAO,MAAM,YAAY,iHACuF,CAAC;AACjH,eAAO,MAAM,WAAW,gGACuE,CAAC;AAChG,eAAO,MAAM,cAAc,wCAAwC,CAAC;AACpE,eAAO,MAAM,SAAS,oHAC6F,CAAC;AAmBpH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,KAAK,CAiB9F;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAalE;AAED,iEAAiE;AACjE,wBAAgB,MAAM,IAAI,MAAM,EAAE,CAEjC;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,uEAAuE;AACvE,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,2GAA2G;AAC3G,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,yFAAyF;AACzF,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAUnD;AAED,0FAA0F;AAC1F,wBAAgB,OAAO,CAAC,UAAU,SAAK,GAAG,OAAO,CAGhD;AA6GD,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,KAAK,CAAC;AAO/C,kFAAkF;AAClF,wBAAgB,OAAO,IAAI,MAAM,EAAE,CAElC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwCvF;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,IAAI,IAAI,CAK7B"}

package/dist/prices.js

@@ -0,0 +1,311 @@
+/**
+ * Offline-first price registry: a bundled snapshot plus an optional live `refresh()`. The TS mirror of
+ * `cendor.core.prices`. Costs are exact `Decimal` `Money` — never IEEE floats (price-dataset spec
+ * `prices/1`). `refresh()` is async here (JS is async-first; Python's sync `urllib` becomes `fetch`).
+ */
+import { Dec } from './decimal.js';
+import { parseDecimalJson } from './json-decimal.js';
+import { PRICES_JSON } from './prices-snapshot.js';
+import { Money } from './types.js';
+/** Raised when a model id is not present in the price table. */
+export class UnknownModelError extends Error {
+    constructor(model) {
+        super(model);
+        this.name = 'UnknownModelError';
+    }
+}
+let table = null;
+let sourceKind = 'bundled'; // "bundled" | "refreshed"
+let sourceNameValue = 'bundled'; // "bundled" | "litellm" | "openrouter" | "azure" | "custom" | "default"
+let sourceUrlValue = null;
+/** Default static snapshot location used by `refresh()` when no url or source is given. */
+export const SNAPSHOT_URL = 'https://raw.githubusercontent.com/cendorhq/cendor-libs/main/packages/cendor-core/src/cendor/core/prices.json';
+export const LITELLM_URL = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json';
+export const OPENROUTER_URL = 'https://openrouter.ai/api/v1/models';
+export const AZURE_URL = "https://prices.azure.com/api/retail/prices?api-version=2023-01-01-preview&$filter=productName eq 'Azure OpenAI'";
+/** Optional explicit id aliases applied after prefix-stripping (extend as needed). */
+const ALIASES = {};
+function ensureLoaded() {
+    if (table === null) {
+        table = parseDecimalJson(PRICES_JSON);
+    }
+    return table;
+}
+function ratesFor(model) {
+    const models = ensureLoaded().models ?? {};
+    const r = models[model];
+    if (r === undefined)
+        throw new UnknownModelError(model);
+    return r;
+}
+/**
+ * Estimate the cost of a call from the price snapshot, as exact `Decimal` `Money`. `cachedTokens` is a
+ * subset of `inputTokens`, billed once: `input*(input−cached) + cached*cachedRate`. Unknown model
+ * throws {@link UnknownModelError}. Mirrors `cendor.core.prices.estimate`.
+ */
+export function estimate(model, inputTokens, opts = {}) {
+    const outputTokens = opts.outputTokens ?? 0;
+    const cachedTokens = opts.cachedTokens ?? 0;
+    const cacheWriteTokens = opts.cacheWriteTokens ?? 0;
+    const r = ratesFor(model);
+    const cached = Math.min(Math.max(cachedTokens, 0), inputTokens); // cached ⊆ input; clamp defensively
+    const inputRate = r.input;
+    if (inputRate === undefined)
+        throw new UnknownModelError(model);
+    const cachedRate = 'cached' in r ? r.cached : inputRate;
+    const writeRate = 'cache_write' in r ? r.cache_write : inputRate.times('1.25');
+    const outputRate = r.output ?? new Dec(0);
+    const amount = inputRate
+        .times(inputTokens - cached)
+        .plus(outputRate.times(outputTokens))
+        .plus(cachedRate.times(cached))
+        .plus(writeRate.times(Math.max(cacheWriteTokens, 0)));
+    return new Money(amount);
+}
+/**
+ * Register (or overwrite) a model's **per-token** rates in the active price table, so a model absent
+ * from the bundled snapshot (a custom/deployment/Hub id) is costed and USD budgets bind on it.
+ * Rates are exact `Decimal`. The higher-level `@cendor/sdk` `registerModelPrice` handles per-1M/1K
+ * unit conversion before calling this. Dropped by {@link _reset}.
+ */
+export function register(model, rates) {
+    const t = ensureLoaded();
+    if (!t.models)
+        t.models = {};
+    const r = { input: rates.input instanceof Dec ? rates.input : new Dec(rates.input) };
+    if (rates.output !== undefined)
+        r.output = rates.output instanceof Dec ? rates.output : new Dec(rates.output);
+    if (rates.cached !== undefined)
+        r.cached = rates.cached instanceof Dec ? rates.cached : new Dec(rates.cached);
+    if (rates.cache_write !== undefined) {
+        r.cache_write =
+            rates.cache_write instanceof Dec ? rates.cache_write : new Dec(rates.cache_write);
+    }
+    t.models[model] = r;
+}
+/** Sorted list of model ids known to the current price table. */
+export function models() {
+    return Object.keys(ensureLoaded().models ?? {}).sort();
+}
+/** The `_updated` date of the loaded snapshot, or `null`. */
+export function snapshotDate() {
+    return ensureLoaded()._updated ?? null;
+}
+/** `"bundled"` or `"refreshed"` — where the active table came from. */
+export function source() {
+    return sourceKind;
+}
+/** Finer provenance: `"bundled"` | `"litellm"` | `"openrouter"` | `"azure"` | `"custom"` | `"default"`. */
+export function sourceName() {
+    return sourceNameValue;
+}
+/** The URL the active table was fetched from, or `null` if it's the bundled snapshot. */
+export function sourceUrl() {
+    return sourceUrlValue;
+}
+/** Age of the active table in days (today − `_updated`), or `null` if undatable. */
+export function ageDays(today) {
+    const d = snapshotDate();
+    if (!d)
+        return null;
+    const parts = d.split('-').map((x) => Number.parseInt(x, 10));
+    if (parts.length !== 3 || parts.some((n) => Number.isNaN(n)))
+        return null;
+    const [y, m, dd] = parts;
+    const ref = today ?? new Date();
+    const refUtc = Date.UTC(ref.getUTCFullYear(), ref.getUTCMonth(), ref.getUTCDate());
+    const snapUtc = Date.UTC(y, m - 1, dd);
+    return Math.floor((refUtc - snapUtc) / 86_400_000);
+}
+/** `true` if the table is older than `maxAgeDays` (an undatable table is never stale). */
+export function isStale(maxAgeDays = 30) {
+    const a = ageDays();
+    return a !== null && a > maxAgeDays;
+}
+// --------------------------------------------------------------------------- live-source adapters
+function normalizeModelId(mid) {
+    let s = mid.trim();
+    if (s.includes('/'))
+        s = s.slice(s.indexOf('/') + 1);
+    s = s.toLowerCase();
+    return ALIASES[s] ?? s;
+}
+function dec(value) {
+    return value instanceof Dec ? value : new Dec(value);
+}
+function mapLitellm(raw) {
+    const out = {};
+    const obj = raw;
+    for (const [mid, rec] of Object.entries(obj)) {
+        if (rec === null || typeof rec !== 'object' || Array.isArray(rec))
+            continue;
+        const r = rec;
+        if (!('input_cost_per_token' in r))
+            continue;
+        const rates = { input: dec(r.input_cost_per_token) };
+        if (r.output_cost_per_token != null)
+            rates.output = dec(r.output_cost_per_token);
+        if (r.cache_read_input_token_cost != null)
+            rates.cached = dec(r.cache_read_input_token_cost);
+        out[normalizeModelId(mid)] = rates;
+    }
+    return { models: out };
+}
+function mapOpenrouter(raw) {
+    const out = {};
+    const data = raw.data;
+    if (!Array.isArray(data))
+        return { models: out };
+    for (const rec of data) {
+        if (rec === null || typeof rec !== 'object' || Array.isArray(rec))
+            continue;
+        const r = rec;
+        const mid = r.id;
+        const pricing = (r.pricing ?? {});
+        if (typeof mid !== 'string' || pricing.prompt == null)
+            continue;
+        const rates = { input: dec(pricing.prompt) };
+        if (pricing.completion != null)
+            rates.output = dec(pricing.completion);
+        const cached = pricing.input_cache_read;
+        if (cached != null && dec(cached).greaterThan(0))
+            rates.cached = dec(cached);
+        out[normalizeModelId(mid)] = rates;
+    }
+    return { models: out };
+}
+function azureUnitDivisor(unitOfMeasure) {
+    const u = (unitOfMeasure || '').toUpperCase().replace(/ /g, '');
+    if (u.includes('1M') || u.includes('1000000'))
+        return new Dec(1_000_000);
+    return new Dec(1000);
+}
+function mapAzure(raw) {
+    const byModel = {};
+    let latest = null;
+    const items = raw.Items;
+    if (!Array.isArray(items))
+        return { models: {} };
+    for (const item of items) {
+        if (item === null || typeof item !== 'object' || Array.isArray(item))
+            continue;
+        const it = item;
+        const eff = String(it.effectiveStartDate ?? '').slice(0, 10);
+        if (eff.length === 10 && (latest === null || eff > latest))
+            latest = eff;
+        const sku = String(it.skuName ?? '');
+        const low = sku.toLowerCase();
+        let direction;
+        if (low.includes('input') || low.includes(' inp') || low.endsWith('inp'))
+            direction = 'input';
+        else if (low.includes('output') || low.includes('outp'))
+            direction = 'output';
+        else
+            continue;
+        const meterName = String(it.meterName ?? '').toLowerCase();
+        if (!low.includes('global') && `${low} ${meterName}`.includes('regional'))
+            continue;
+        const price = it.retailPrice;
+        if (price == null)
+            continue;
+        const perToken = dec(price).dividedBy(azureUnitDivisor(String(it.unitOfMeasure ?? '')));
+        let head = low;
+        for (const cut of [' inp', ' input', ' outp', ' output']) {
+            if (head.includes(cut)) {
+                head = head.slice(0, head.indexOf(cut));
+                break;
+            }
+        }
+        const words = head.trim().split(/\s+/).filter(Boolean);
+        while (words.length &&
+            /^\d+$/.test(words[words.length - 1]) &&
+            [3, 4].includes(words[words.length - 1].length)) {
+            words.pop();
+        }
+        const mid = normalizeModelId(words.join('-'));
+        let rates = byModel[mid];
+        if (rates === undefined) {
+            rates = {};
+            byModel[mid] = rates;
+        }
+        const existing = rates[direction];
+        if (existing === undefined || perToken.lessThan(existing))
+            rates[direction] = perToken;
+    }
+    const out = {};
+    for (const [mid, r] of Object.entries(byModel))
+        if ('input' in r)
+            out[mid] = r;
+    const result = { models: out };
+    if (latest !== null)
+        result._updated = latest;
+    return result;
+}
+const SOURCES = {
+    litellm: [LITELLM_URL, mapLitellm],
+    openrouter: [OPENROUTER_URL, mapOpenrouter],
+    azure: [AZURE_URL, mapAzure],
+};
+/** Names of the built-in live price sources accepted by `refresh({ source })`. */
+export function sources() {
+    return Object.keys(SOURCES).sort();
+}
+/**
+ * Replace the table from a live source or static JSON URL. Never throws; offline-safe. Returns `true`
+ * if the table was updated, `false` if the fetch/parse/map failed (the current table stays active).
+ * Mirrors `cendor.core.prices.refresh` (async here: uses `fetch`).
+ */
+export async function refresh(url, opts = {}) {
+    const { source: sourceArg, mapper, timeout = 5.0 } = opts;
+    let target;
+    let adapter;
+    let name;
+    if (sourceArg != null) {
+        const entry = SOURCES[sourceArg];
+        if (entry === undefined)
+            return false;
+        target = entry[0];
+        adapter = mapper ?? entry[1];
+        name = sourceArg;
+    }
+    else {
+        target = url || SNAPSHOT_URL;
+        adapter = mapper;
+        name = url ? 'custom' : 'default';
+    }
+    if (!target || !/^https?:\/\//i.test(target))
+        return false;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout * 1000);
+        let text;
+        try {
+            const resp = await fetch(target, { signal: controller.signal });
+            text = await resp.text();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const raw = parseDecimalJson(text);
+        const data = adapter ? adapter(raw) : raw;
+        if (data && typeof data === 'object' && data.models && Object.keys(data.models).length > 0) {
+            table = data;
+            sourceKind = 'refreshed';
+            sourceNameValue = name;
+            sourceUrlValue = target;
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+    return false;
+}
+/** Test helper: drop the loaded table so the bundled snapshot reloads. */
+export function _reset() {
+    table = null;
+    sourceKind = 'bundled';
+    sourceNameValue = 'bundled';
+    sourceUrlValue = null;
+}
+//# sourceMappingURL=prices.js.map