@jameslovespancakes/pi-plus 1.0.0

package/src/core/anthropic/vendor/xxhash-wasm.LICENSE.md

@@ -0,0 +1,25 @@
+The MIT License (MIT)
+=====================
+
+Copyright © 2017 Michael Jungo
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

package/src/core/anthropic/vendor/xxhash-wasm.js

@@ -0,0 +1,2 @@
+const t=new Uint8Array([0,97,115,109,1,0,0,0,1,48,8,96,3,127,127,127,1,127,96,3,127,127,127,0,96,2,127,127,0,96,1,127,1,127,96,3,127,127,126,1,126,96,3,126,127,127,1,126,96,2,127,126,0,96,1,127,1,126,3,11,10,0,0,2,1,3,4,5,6,1,7,5,3,1,0,1,7,85,9,3,109,101,109,2,0,5,120,120,104,51,50,0,0,6,105,110,105,116,51,50,0,2,8,117,112,100,97,116,101,51,50,0,3,8,100,105,103,101,115,116,51,50,0,4,5,120,120,104,54,52,0,5,6,105,110,105,116,54,52,0,7,8,117,112,100,97,116,101,54,52,0,8,8,100,105,103,101,115,116,54,52,0,9,10,251,22,10,242,1,1,4,127,32,0,32,1,106,33,3,32,1,65,16,79,4,127,32,3,65,16,107,33,6,32,2,65,168,136,141,161,2,106,33,3,32,2,65,137,235,208,208,7,107,33,4,32,2,65,207,140,162,142,6,106,33,5,3,64,32,3,32,0,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,3,32,4,32,0,65,4,106,34,0,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,4,32,2,32,0,65,4,106,34,0,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,2,32,5,32,0,65,4,106,34,0,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,5,32,6,32,0,65,4,106,34,0,79,13,0,11,32,2,65,12,119,32,5,65,18,119,106,32,4,65,7,119,106,32,3,65,1,119,106,5,32,2,65,177,207,217,178,1,106,11,32,1,106,32,0,32,1,65,15,113,16,1,11,146,1,0,32,1,32,2,106,33,2,3,64,32,1,65,4,106,32,2,75,69,4,64,32,0,32,1,40,2,0,65,189,220,202,149,124,108,106,65,17,119,65,175,214,211,190,2,108,33,0,32,1,65,4,106,33,1,12,1,11,11,3,64,32,1,32,2,79,69,4,64,32,0,32,1,45,0,0,65,177,207,217,178,1,108,106,65,11,119,65,177,243,221,241,121,108,33,0,32,1,65,1,106,33,1,12,1,11,11,32,0,32,0,65,15,118,115,65,247,148,175,175,120,108,34,0,65,13,118,32,0,115,65,189,220,202,149,124,108,34,0,65,16,118,32,0,115,11,63,0,32,0,65,8,106,32,1,65,168,136,141,161,2,106,54,2,0,32,0,65,12,106,32,1,65,137,235,208,208,7,107,54,2,0,32,0,65,16,106,32,1,54,2,0,32,0,65,20,106,32,1,65,207,140,162,142,6,106,54,2,0,11,195,4,1,6,127,32,1,32,2,106,33,6,32,0,65,24,106,33,4,32,0,65,40,106,40,2,0,33,3,32,0,32,0,40,2,0,32,2,106,54,2,0,32,0,65,4,106,34,5,32,5,40,2,0,32,2,65,16,79,32,0,40,2,0,65,16,79,114,114,54,2,0,32,2,32,3,106,65,16,73,4,64,32,3,32,4,106,32,1,32,2,252,10,0,0,32,0,65,40,106,32,2,32,3,106,54,2,0,15,11,32,3,4,64,32,3,32,4,106,32,1,65,16,32,3,107,34,2,252,10,0,0,32,0,65,8,106,34,3,32,3,40,2,0,32,4,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,54,2,0,32,0,65,12,106,34,3,32,3,40,2,0,32,4,65,4,106,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,54,2,0,32,0,65,16,106,34,3,32,3,40,2,0,32,4,65,8,106,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,54,2,0,32,0,65,20,106,34,3,32,3,40,2,0,32,4,65,12,106,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,54,2,0,32,0,65,40,106,65,0,54,2,0,32,1,32,2,106,33,1,11,32,1,32,6,65,16,107,77,4,64,32,6,65,16,107,33,8,32,0,65,8,106,40,2,0,33,2,32,0,65,12,106,40,2,0,33,3,32,0,65,16,106,40,2,0,33,5,32,0,65,20,106,40,2,0,33,7,3,64,32,2,32,1,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,2,32,3,32,1,65,4,106,34,1,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,3,32,5,32,1,65,4,106,34,1,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,5,32,7,32,1,65,4,106,34,1,40,2,0,65,247,148,175,175,120,108,106,65,13,119,65,177,243,221,241,121,108,33,7,32,8,32,1,65,4,106,34,1,79,13,0,11,32,0,65,8,106,32,2,54,2,0,32,0,65,12,106,32,3,54,2,0,32,0,65,16,106,32,5,54,2,0,32,0,65,20,106,32,7,54,2,0,11,32,1,32,6,73,4,64,32,4,32,1,32,6,32,1,107,34,1,252,10,0,0,32,0,65,40,106,32,1,54,2,0,11,11,97,1,1,127,32,0,65,16,106,40,2,0,33,1,32,0,65,4,106,40,2,0,4,127,32,1,65,12,119,32,0,65,20,106,40,2,0,65,18,119,106,32,0,65,12,106,40,2,0,65,7,119,106,32,0,65,8,106,40,2,0,65,1,119,106,5,32,1,65,177,207,217,178,1,106,11,32,0,40,2,0,106,32,0,65,24,106,32,0,65,40,106,40,2,0,16,1,11,255,3,2,3,126,1,127,32,0,32,1,106,33,6,32,1,65,32,79,4,126,32,6,65,32,107,33,6,32,2,66,214,235,130,238,234,253,137,245,224,0,124,33,3,32,2,66,177,169,172,193,173,184,212,166,61,125,33,4,32,2,66,249,234,208,208,231,201,161,228,225,0,124,33,5,3,64,32,3,32,0,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,3,32,4,32,0,65,8,106,34,0,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,4,32,2,32,0,65,8,106,34,0,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,2,32,5,32,0,65,8,106,34,0,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,5,32,6,32,0,65,8,106,34,0,79,13,0,11,32,2,66,12,137,32,5,66,18,137,124,32,4,66,7,137,124,32,3,66,1,137,124,32,3,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,32,4,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,32,2,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,32,5,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,5,32,2,66,197,207,217,178,241,229,186,234,39,124,11,32,1,173,124,32,0,32,1,65,31,113,16,6,11,134,2,0,32,1,32,2,106,33,2,3,64,32,2,32,1,65,8,106,79,4,64,32,1,41,3,0,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,32,0,133,66,27,137,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,33,0,32,1,65,8,106,33,1,12,1,11,11,32,1,65,4,106,32,2,77,4,64,32,0,32,1,53,2,0,66,135,149,175,175,152,182,222,155,158,127,126,133,66,23,137,66,207,214,211,190,210,199,171,217,66,126,66,249,243,221,241,153,246,153,171,22,124,33,0,32,1,65,4,106,33,1,11,3,64,32,1,32,2,73,4,64,32,0,32,1,49,0,0,66,197,207,217,178,241,229,186,234,39,126,133,66,11,137,66,135,149,175,175,152,182,222,155,158,127,126,33,0,32,1,65,1,106,33,1,12,1,11,11,32,0,32,0,66,33,136,133,66,207,214,211,190,210,199,171,217,66,126,34,0,32,0,66,29,136,133,66,249,243,221,241,153,246,153,171,22,126,34,0,32,0,66,32,136,133,11,77,0,32,0,65,8,106,32,1,66,214,235,130,238,234,253,137,245,224,0,124,55,3,0,32,0,65,16,106,32,1,66,177,169,172,193,173,184,212,166,61,125,55,3,0,32,0,65,24,106,32,1,55,3,0,32,0,65,32,106,32,1,66,249,234,208,208,231,201,161,228,225,0,124,55,3,0,11,244,4,2,3,127,4,126,32,1,32,2,106,33,5,32,0,65,40,106,33,4,32,0,65,200,0,106,40,2,0,33,3,32,0,32,0,41,3,0,32,2,173,124,55,3,0,32,2,32,3,106,65,32,73,4,64,32,3,32,4,106,32,1,32,2,252,10,0,0,32,0,65,200,0,106,32,2,32,3,106,54,2,0,15,11,32,3,4,64,32,3,32,4,106,32,1,65,32,32,3,107,34,2,252,10,0,0,32,0,65,8,106,34,3,32,3,41,3,0,32,4,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,55,3,0,32,0,65,16,106,34,3,32,3,41,3,0,32,4,65,8,106,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,55,3,0,32,0,65,24,106,34,3,32,3,41,3,0,32,4,65,16,106,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,55,3,0,32,0,65,32,106,34,3,32,3,41,3,0,32,4,65,24,106,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,55,3,0,32,0,65,200,0,106,65,0,54,2,0,32,1,32,2,106,33,1,11,32,1,65,32,106,32,5,77,4,64,32,5,65,32,107,33,2,32,0,65,8,106,41,3,0,33,6,32,0,65,16,106,41,3,0,33,7,32,0,65,24,106,41,3,0,33,8,32,0,65,32,106,41,3,0,33,9,3,64,32,6,32,1,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,6,32,7,32,1,65,8,106,34,1,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,7,32,8,32,1,65,8,106,34,1,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,8,32,9,32,1,65,8,106,34,1,41,3,0,66,207,214,211,190,210,199,171,217,66,126,124,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,33,9,32,2,32,1,65,8,106,34,1,79,13,0,11,32,0,65,8,106,32,6,55,3,0,32,0,65,16,106,32,7,55,3,0,32,0,65,24,106,32,8,55,3,0,32,0,65,32,106,32,9,55,3,0,11,32,1,32,5,73,4,64,32,4,32,1,32,5,32,1,107,34,1,252,10,0,0,32,0,65,200,0,106,32,1,54,2,0,11,11,188,2,1,5,126,32,0,65,24,106,41,3,0,33,1,32,0,41,3,0,34,2,66,32,90,4,126,32,0,65,8,106,41,3,0,34,3,66,1,137,32,0,65,16,106,41,3,0,34,4,66,7,137,124,32,1,66,12,137,32,0,65,32,106,41,3,0,34,5,66,18,137,124,124,32,3,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,32,4,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,32,1,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,32,5,66,207,214,211,190,210,199,171,217,66,126,66,31,137,66,135,149,175,175,152,182,222,155,158,127,126,133,66,135,149,175,175,152,182,222,155,158,127,126,66,157,163,181,234,131,177,141,138,250,0,125,5,32,1,66,197,207,217,178,241,229,186,234,39,124,11,32,2,124,32,0,65,40,106,32,2,66,31,131,167,16,6,11]);async function e(){return function(t){const{exports:{mem:e,xxh32:n,xxh64:r,init32:i,update32:a,digest32:o,init64:s,update64:u,digest64:c}}=t;let h=new Uint8Array(e.buffer);function g(t,n){if(e.buffer.byteLength<t+n){const r=Math.ceil((t+n-e.buffer.byteLength)/65536);e.grow(r),h=new Uint8Array(e.buffer)}}function f(t,e,n,r,i,a){g(t);const o=new Uint8Array(t);return h.set(o),n(0,e),o.set(h.subarray(0,t)),{update(e){let n;return h.set(o),"string"==typeof e?(g(3*e.length,t),n=w.encodeInto(e,h.subarray(t)).written):(g(e.byteLength,t),h.set(e,t),n=e.byteLength),r(0,t,n),o.set(h.subarray(0,t)),this},digest:()=>(h.set(o),a(i(0)))}}function y(t){return t>>>0}const b=2n**64n-1n;function d(t){return t&b}const w=new TextEncoder,l=0,p=0n;function x(t,e=l){return g(3*t.length,0),y(n(0,w.encodeInto(t,h).written,e))}function L(t,e=p){return g(3*t.length,0),d(r(0,w.encodeInto(t,h).written,e))}return{h32:x,h32ToString:(t,e=l)=>x(t,e).toString(16).padStart(8,"0"),h32Raw:(t,e=l)=>(g(t.byteLength,0),h.set(t),y(n(0,t.byteLength,e))),create32:(t=l)=>f(48,t,i,a,o,y),h64:L,h64ToString:(t,e=p)=>L(t,e).toString(16).padStart(16,"0"),h64Raw:(t,e=p)=>(g(t.byteLength,0),h.set(t),d(r(0,t.byteLength,e))),create64:(t=p)=>f(88,t,s,u,c,d)}}((await WebAssembly.instantiate(t)).instance)}export{e as default};
+//# sourceMappingURL=xxhash-wasm.js.map

package/src/core/anthropic/xxhash64.ts

@@ -0,0 +1,33 @@
+import xxhashInit from "./vendor/xxhash-wasm.js";
+
+/**
+ * xxHash64, from the vendored reference implementation.
+ *
+ * A hand-written BigInt version was attempted first and abandoned: it was
+ * correct for empty and tiny inputs and wrong for every longer one, and four
+ * rounds of fixes never converged. See vendor/README.md.
+ *
+ * The WASM module is instantiated once and shared.
+ */
+
+type RawHasher = (bytes: Uint8Array, seed?: bigint) => bigint;
+
+let hasher: Promise<RawHasher> | undefined;
+
+function load(): Promise<RawHasher> {
+  hasher ??= (async () => {
+    const instance = await (xxhashInit as unknown as () => Promise<{ h64Raw: RawHasher }>)();
+    return instance.h64Raw;
+  })();
+  return hasher;
+}
+
+/** 64-bit hash of `bytes` with an optional seed. */
+export async function xxhash64(bytes: Uint8Array, seed = 0n): Promise<bigint> {
+  return (await load())(bytes, seed);
+}
+
+export async function xxhash64Hex(value: string): Promise<string> {
+  const hash = await xxhash64(new TextEncoder().encode(value));
+  return hash.toString(16).padStart(16, "0").slice(0, 16);
+}

package/src/core/catalog/quality.ts

@@ -0,0 +1,314 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { env } from "../env.ts";
+
+/**
+ * Complete Artificial Analysis model dataset, cached on disk.
+ *
+ * Every field the API returns is stored verbatim: all 17 benchmark
+ * evaluations, all pricing fields, and all latency/throughput measurements.
+ * Derived cost-efficiency ratios are computed on top. All network access
+ * degrades to the cache so routing never blocks on the network.
+ *
+ * Refresh semantics deliberately mirror pi's own remote model catalog
+ * (`dist/core/remote-catalog-provider.js`): restore from disk first, only go to
+ * the network when the entry is older than the refresh interval, and revalidate
+ * with `If-None-Match` so an unchanged dataset costs one 304 instead of a
+ * multi-megabyte download.
+ */
+
+const AA_URL = "https://artificialanalysis.ai/api/v2/data/llms/models";
+/** Matches pi's REMOTE_CATALOG_REFRESH_INTERVAL_MS. */
+export const REFRESH_INTERVAL_MS = 4 * 60 * 60 * 1000;
+const TIMEOUT_MS = 30_000;
+
+export type Confidence = "measured" | "inferred" | "unrated";
+
+/** Every evaluation key Artificial Analysis publishes, with display metadata. */
+export const EVALUATIONS = [
+  { key: "artificial_analysis_intelligence_index", label: "Intelligence Index", scale: "index", group: "composite" },
+  { key: "artificial_analysis_coding_index", label: "Coding Index", scale: "index", group: "composite" },
+  { key: "artificial_analysis_math_index", label: "Math Index", scale: "index", group: "composite" },
+  { key: "terminalbench_hard", label: "Terminal-Bench Hard", scale: "fraction", group: "agentic" },
+  { key: "terminalbench_v2_1", label: "Terminal-Bench 2.1", scale: "fraction", group: "agentic" },
+  { key: "tau2", label: "τ²-bench (agentic tools)", scale: "fraction", group: "agentic" },
+  { key: "tau_banking", label: "τ-bench Banking", scale: "fraction", group: "agentic" },
+  { key: "livecodebench", label: "LiveCodeBench", scale: "fraction", group: "coding" },
+  { key: "scicode", label: "SciCode", scale: "fraction", group: "coding" },
+  { key: "lcr", label: "Long Context Reasoning", scale: "fraction", group: "reasoning" },
+  { key: "gpqa", label: "GPQA Diamond", scale: "fraction", group: "reasoning" },
+  { key: "hle", label: "Humanity's Last Exam", scale: "fraction", group: "reasoning" },
+  { key: "mmlu_pro", label: "MMLU-Pro", scale: "fraction", group: "reasoning" },
+  { key: "ifbench", label: "IFBench (instruction following)", scale: "fraction", group: "reasoning" },
+  { key: "aime_25", label: "AIME 2025", scale: "fraction", group: "math" },
+  { key: "aime", label: "AIME", scale: "fraction", group: "math" },
+  { key: "math_500", label: "MATH-500", scale: "fraction", group: "math" },
+] as const;
+
+export type EvaluationKey = (typeof EVALUATIONS)[number]["key"];
+
+export interface QualityRecord {
+  slug: string;
+  name: string;
+  creator: string;
+  releaseDate?: string;
+  evaluations: Partial<Record<EvaluationKey, number>>;
+  pricing: {
+    inputPer1M?: number;
+    outputPer1M?: number;
+    blended3to1Per1M?: number;
+  };
+  performance: {
+    outputTokensPerSecond?: number;
+    timeToFirstTokenSeconds?: number;
+    timeToFirstAnswerTokenSeconds?: number;
+  };
+}
+
+/**
+ * Same shape as pi's ModelsStoreEntry, so the two caches can be reasoned about
+ * (and debugged) identically.
+ */
+interface QualityStore {
+  records: Record<string, QualityRecord>;
+  /** Unix timestamp of the last completed remote check. */
+  checkedAt?: number;
+  /** Unix timestamp from the remote dataset's Last-Modified header. */
+  lastModified?: number;
+  /** Opaque ETag validator, stored verbatim and echoed back as If-None-Match. */
+  etag?: string;
+  source: string;
+}
+
+let cache: QualityStore | undefined;
+let inFlight: Promise<string[]> | undefined;
+
+function agentDir(): string {
+  return process.env.PI_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+}
+
+function cachePath(): string {
+  return join(agentDir(), "model-quality.json");
+}
+
+function readKey(): string | undefined {
+  return env("ARTIFICIAL_ANALYSIS_API_KEY");
+}
+
+/** `openrouter/z-ai/glm-5.3` -> `glm-5-3`, `openai-codex/gpt-5.6-luna` -> `gpt-5-6-luna`. */
+export function normalizeSlug(modelId: string): string {
+  const bare = modelId.includes("/") ? modelId.slice(modelId.lastIndexOf("/") + 1) : modelId;
+  return bare.toLowerCase().replace(/[._]/g, "-").replace(/-latest$/, "").replace(/-\d{8}$/, "");
+}
+
+function num(value: unknown): number | undefined {
+  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+
+/** Fractions (0-1) are reported as percentages so every metric shares one scale. */
+export function normalizedScore(key: EvaluationKey, value: number | undefined): number | undefined {
+  if (value === undefined) return undefined;
+  const definition = EVALUATIONS.find((entry) => entry.key === key);
+  return definition?.scale === "fraction" ? value * 100 : value;
+}
+
+function loadCache(): void {
+  if (cache) return;
+  try {
+    const parsed = JSON.parse(readFileSync(cachePath(), "utf8")) as QualityStore & { fetchedAt?: number };
+    if (!parsed?.records) return;
+    // Migrate the pre-store format, which only had `fetchedAt`.
+    cache = {
+      records: parsed.records,
+      checkedAt: parsed.checkedAt ?? parsed.fetchedAt,
+      lastModified: parsed.lastModified,
+      etag: parsed.etag,
+      source: parsed.source ?? "artificial-analysis",
+    };
+  } catch { /* first run */ }
+}
+
+function persist(next: QualityStore): void {
+  cache = next;
+  try {
+    writeFileSync(cachePath(), JSON.stringify(next), "utf8");
+  } catch { /* cache write is best effort */ }
+}
+
+export function qualityAgeMs(): number | undefined {
+  loadCache();
+  return cache?.checkedAt !== undefined ? Date.now() - cache.checkedAt : undefined;
+}
+
+/** Cache metadata, for display by /model-info refresh. */
+export function qualityStatus(): { checkedAt?: number; lastModified?: number; records: number; hasEtag: boolean } {
+  loadCache();
+  return {
+    checkedAt: cache?.checkedAt,
+    lastModified: cache?.lastModified,
+    records: Object.keys(cache?.records ?? {}).length,
+    hasEtag: !!cache?.etag,
+  };
+}
+
+export function qualityRecordCount(): number {
+  loadCache();
+  return Object.keys(cache?.records ?? {}).length;
+}
+
+export async function refreshQuality(force = false): Promise<string[]> {
+  loadCache();
+
+  // Restored from disk and still inside the window: nothing to do.
+  const age = qualityAgeMs();
+  if (!force && age !== undefined && age < REFRESH_INTERVAL_MS) return [];
+  if (inFlight) return inFlight;
+
+  inFlight = (async () => {
+    const warnings: string[] = [];
+    const key = readKey();
+    if (!key) return ["artificial-analysis: no API key, run /model-info setup"];
+
+    const stored = cache;
+    // Only revalidate when a cached body backs the validator, so a 304 can never
+    // leave the dataset empty.
+    const validator = stored && Object.keys(stored.records).length > 0 ? stored.etag : undefined;
+
+    try {
+      const response = await fetch(AA_URL, {
+        headers: {
+          "x-api-key": key,
+          ...(validator ? { "if-none-match": validator } : {}),
+        },
+        signal: AbortSignal.timeout(TIMEOUT_MS),
+      });
+
+      const checkedAt = Date.now();
+
+      if (response.status === 304 && stored) {
+        // Unchanged upstream: keep the dataset and the validator, stamp the check.
+        persist({ ...stored, checkedAt });
+        return [];
+      }
+
+      if (!response.ok) {
+        // Drop the etag so the next attempt re-downloads rather than revalidating
+        // against a validator we can no longer trust.
+        if (stored) persist({ ...stored, checkedAt, etag: undefined });
+        return [`artificial-analysis: HTTP ${response.status}`];
+      }
+
+      const body = await response.json() as { data?: any[] };
+      const records: Record<string, QualityRecord> = {};
+
+      for (const model of body.data ?? []) {
+        const slug = String(model.slug ?? "").toLowerCase();
+        if (!slug) continue;
+        const source = model.evaluations ?? {};
+        const evaluations: Partial<Record<EvaluationKey, number>> = {};
+        for (const { key: evaluationKey } of EVALUATIONS) {
+          const value = num(source[evaluationKey]);
+          if (value !== undefined) evaluations[evaluationKey] = value;
+        }
+        const pricing = model.pricing ?? {};
+        records[slug] = {
+          slug,
+          name: String(model.name ?? slug),
+          creator: String(model.model_creator?.name ?? "unknown"),
+          releaseDate: typeof model.release_date === "string" ? model.release_date : undefined,
+          evaluations,
+          pricing: {
+            inputPer1M: num(pricing.price_1m_input_tokens),
+            outputPer1M: num(pricing.price_1m_output_tokens),
+            blended3to1Per1M: num(pricing.price_1m_blended_3_to_1),
+          },
+          performance: {
+            outputTokensPerSecond: num(model.median_output_tokens_per_second),
+            timeToFirstTokenSeconds: num(model.median_time_to_first_token_seconds),
+            timeToFirstAnswerTokenSeconds: num(model.median_time_to_first_answer_token),
+          },
+        };
+      }
+
+      if (Object.keys(records).length === 0) {
+        if (stored) persist({ ...stored, checkedAt, etag: undefined });
+        return ["artificial-analysis: empty dataset"];
+      }
+
+      const lastModifiedHeader = response.headers.get("last-modified");
+      const lastModified = lastModifiedHeader ? Date.parse(lastModifiedHeader) : undefined;
+      persist({
+        records,
+        checkedAt,
+        lastModified: Number.isNaN(lastModified) ? undefined : lastModified,
+        etag: response.headers.get("etag") ?? undefined,
+        source: "artificial-analysis",
+      });
+    } catch (error) {
+      // Network failure keeps the old dataset usable but forces a full re-fetch
+      // next time rather than trusting a stale validator.
+      if (cache) persist({ ...cache, checkedAt: Date.now(), etag: undefined });
+      warnings.push(`artificial-analysis: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return warnings;
+  })().finally(() => { inFlight = undefined; });
+
+  return inFlight;
+}
+
+export interface CostEfficiency {
+  /** Intelligence index per dollar of blended 3:1 spend. */
+  intelligencePerDollar?: number;
+  codingPerDollar?: number;
+  agenticPerDollar?: number;
+}
+
+export function costEfficiency(record: QualityRecord | undefined): CostEfficiency {
+  if (!record) return {};
+  const price = record.pricing.blended3to1Per1M;
+  if (price === undefined || price <= 0) return {};
+  const ratio = (value: number | undefined) => (value === undefined ? undefined : Number((value / price).toFixed(2)));
+  return {
+    intelligencePerDollar: ratio(record.evaluations.artificial_analysis_intelligence_index),
+    codingPerDollar: ratio(record.evaluations.artificial_analysis_coding_index),
+    agenticPerDollar: ratio(normalizedScore("terminalbench_hard", record.evaluations.terminalbench_hard)),
+  };
+}
+
+export interface QualityLookup {
+  record?: QualityRecord;
+  efficiency: CostEfficiency;
+  confidence: Confidence;
+  basis: string;
+}
+
+/**
+ * Resolve a pi model id, preferring the entry matching the requested thinking
+ * level, then the base model, then the closest same-family sibling.
+ */
+export function qualityFor(modelId: string, thinkingLevel?: string): QualityLookup {
+  loadCache();
+  const records = cache?.records ?? {};
+  const base = normalizeSlug(modelId);
+
+  const levelled = thinkingLevel && thinkingLevel !== "off" ? records[`${base}-${thinkingLevel}`] : undefined;
+  if (levelled) return { record: levelled, efficiency: costEfficiency(levelled), confidence: "measured", basis: levelled.slug };
+
+  const exact = records[base];
+  if (exact) return { record: exact, efficiency: costEfficiency(exact), confidence: "measured", basis: exact.slug };
+
+  let best: QualityRecord | undefined;
+  for (const record of Object.values(records)) {
+    if (!base.includes(record.slug) && !record.slug.includes(base)) continue;
+    if (!best || record.slug.length > best.slug.length) best = record;
+  }
+  if (best) return { record: best, efficiency: costEfficiency(best), confidence: "inferred", basis: `nearest match ${best.slug}` };
+
+  return { efficiency: {}, confidence: "unrated", basis: "no Artificial Analysis entry" };
+}
+
+export function allRecords(): QualityRecord[] {
+  loadCache();
+  return Object.values(cache?.records ?? {});
+}

package/src/core/codex/oauth.ts

@@ -0,0 +1,129 @@
+import { generatePkce, generateState, parseCallback } from "../oauth/pkce.ts";
+
+/**
+ * Codex OAuth (ChatGPT account login).
+ *
+ * The client id is the public one the Codex CLI itself uses; it is not a
+ * secret and the flow is PKCE precisely so that no secret is required. The
+ * redirect is a loopback URL, which is what lets a CLI complete the flow.
+ */
+
+const CLIENT_ID = "app_EMoamEEZ73f0CkXaXp7hrann";
+const AUTHORIZE_URL = "https://auth.openai.com/oauth/authorize";
+const TOKEN_URL = "https://auth.openai.com/oauth/token";
+const REDIRECT_URI = "http://localhost:1455/auth/callback";
+const SCOPE = "openid profile email offline_access";
+
+export interface CodexAuthStart {
+  url: string;
+  verifier: string;
+  state: string;
+  redirectUri: string;
+}
+
+export interface CodexTokens {
+  access: string;
+  refresh: string;
+  expires: number;
+}
+
+/** Builds the authorization URL and the PKCE material needed to finish. */
+export async function authorizeCodex(): Promise<CodexAuthStart> {
+  const pkce = await generatePkce();
+  const state = generateState();
+
+  const url = new URL(AUTHORIZE_URL);
+  url.searchParams.set("response_type", "code");
+  url.searchParams.set("client_id", CLIENT_ID);
+  url.searchParams.set("redirect_uri", REDIRECT_URI);
+  url.searchParams.set("scope", SCOPE);
+  url.searchParams.set("code_challenge", pkce.challenge);
+  url.searchParams.set("code_challenge_method", "S256");
+  url.searchParams.set("state", state);
+  // Forces the account chooser, which is the entire point when adding a
+  // SECOND account: without it the browser silently reuses the existing
+  // session and you get a duplicate of the account you already have.
+  url.searchParams.set("prompt", "login");
+
+  return { url: url.toString(), verifier: pkce.verifier, state, redirectUri: REDIRECT_URI };
+}
+
+/** Exchanges the callback URL (or a bare code) for tokens. */
+export async function exchangeCodex(
+  callback: string,
+  verifier: string,
+  redirectUri: string,
+  expectedState?: string,
+): Promise<CodexTokens> {
+  const parsed = parseCallback(callback);
+  const code = parsed?.code ?? callback.trim();
+  if (!code) throw new Error("No authorization code found in the callback.");
+  if (expectedState && parsed?.state && parsed.state !== expectedState) {
+    throw new Error("OAuth state mismatch; the callback does not belong to this login attempt.");
+  }
+
+  const response = await fetch(TOKEN_URL, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      grant_type: "authorization_code",
+      client_id: CLIENT_ID,
+      code,
+      redirect_uri: redirectUri,
+      code_verifier: verifier,
+    }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`Codex token exchange failed (${response.status}): ${(await response.text()).slice(0, 200)}`);
+  }
+
+  const body: any = await response.json();
+  if (!body?.access_token) throw new Error("Codex token exchange returned no access token.");
+  return {
+    access: body.access_token,
+    refresh: body.refresh_token,
+    expires: Date.now() + Number(body.expires_in ?? 3600) * 1000,
+  };
+}
+
+/** Refreshes an expiring token. */
+export async function refreshCodexToken(refresh: string): Promise<CodexTokens> {
+  const response = await fetch(TOKEN_URL, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      grant_type: "refresh_token",
+      client_id: CLIENT_ID,
+      refresh_token: refresh,
+      scope: SCOPE,
+    }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`Codex token refresh failed (${response.status}).`);
+  }
+
+  const body: any = await response.json();
+  if (!body?.access_token) throw new Error("Codex token refresh returned no access token.");
+  return {
+    // OpenAI may omit a rotated refresh token; keeping the old one is correct.
+    access: body.access_token,
+    refresh: body.refresh_token ?? refresh,
+    expires: Date.now() + Number(body.expires_in ?? 3600) * 1000,
+  };
+}
+
+/** A token good for at least a minute, refreshing and persisting if needed. */
+export async function ensureCodexToken(
+  account: { access?: string; refresh?: string; expires?: number },
+  persist: (tokens: CodexTokens) => void,
+): Promise<string | undefined> {
+  if (account.access && typeof account.expires === "number" && Date.now() + 60_000 < account.expires) {
+    return account.access;
+  }
+  if (!account.refresh) return account.access;
+  const tokens = await refreshCodexToken(account.refresh);
+  persist(tokens);
+  return tokens.access;
+}

package/src/core/codex/quota.ts

@@ -0,0 +1,88 @@
+import type { QuotaSnapshot } from "../anthropic/store.ts";
+import { loadCodexAccounts, saveCodexAccount } from "./store.ts";
+
+/**
+ * Codex quota, read from response headers.
+ *
+ * Codex reports usage on every reply through `x-codex-*` headers, so there is
+ * no polling path here at all and no equivalent of Anthropic's usage endpoint
+ * is needed.
+ *
+ * Two differences from Anthropic worth remembering:
+ *   - percentages are ALREADY 0-100 (`x-codex-primary-used-percent: 2`),
+ *     unlike Anthropic's 0-1 fractions, so there is no x100 here;
+ *   - the windows are self-describing via `*-window-minutes` rather than being
+ *     fixed at 5h/7d, so they are mapped by duration instead of by name.
+ */
+
+/** A Codex window lands in the snapshot slot closest to its real duration. */
+const SEVEN_DAY_MINUTES = 7 * 24 * 60;
+
+const num = (value: unknown): number | undefined => {
+  if (value === undefined || value === null || value === "") return undefined;
+  const n = Number(value);
+  return Number.isFinite(n) ? n : undefined;
+};
+
+export function parseCodexQuotaHeaders(
+  headers: Record<string, unknown> | undefined,
+  now = Date.now(),
+): QuotaSnapshot | undefined {
+  if (!headers) return undefined;
+
+  const get = (name: string): unknown => {
+    const key = `x-codex-${name}`;
+    if (headers[key] !== undefined) return headers[key];
+    const found = Object.keys(headers).find((k) => k.toLowerCase() === key);
+    return found === undefined ? undefined : headers[found];
+  };
+
+  const window = (prefix: "primary" | "secondary") => {
+    const used = num(get(`${prefix}-used-percent`));
+    if (used === undefined) return undefined;
+    // A zero-length window is Codex's way of saying "not applicable".
+    const minutes = num(get(`${prefix}-window-minutes`));
+    if (minutes !== undefined && minutes <= 0) return undefined;
+
+    const clamped = Math.min(100, Math.max(0, used));
+    const resetAt = num(get(`${prefix}-reset-at`));
+    return {
+      usedPercent: clamped,
+      remainingPercent: 100 - clamped,
+      resetsAt: resetAt !== undefined && resetAt > 0
+        ? new Date(resetAt * 1000).toISOString()
+        : undefined,
+      checkedAt: now,
+      windowMinutes: minutes,
+    };
+  };
+
+  const primary = window("primary");
+  const secondary = window("secondary");
+  if (!primary && !secondary) return undefined;
+
+  // Map by duration, not by name: the long window is the weekly one.
+  const primaryIsLong = (primary?.windowMinutes ?? SEVEN_DAY_MINUTES) >= SEVEN_DAY_MINUTES;
+
+  return {
+    seven_day: primaryIsLong ? primary : secondary,
+    five_hour: primaryIsLong ? secondary : primary,
+    checkedAt: now,
+    source: "headers",
+    plan: typeof get("plan-type") === "string" ? String(get("plan-type")) : undefined,
+  } as QuotaSnapshot;
+}
+
+/** Merges a header-derived snapshot into the stored account. */
+export function applyCodexQuotaHeaders(
+  accountId: string,
+  headers: Record<string, unknown> | undefined,
+  now = Date.now(),
+): boolean {
+  const quota = parseCodexQuotaHeaders(headers, now);
+  if (!quota) return false;
+  const account = loadCodexAccounts().accounts.find((a) => a.id === accountId);
+  if (!account) return false;
+  saveCodexAccount({ ...account, quota });
+  return true;
+}