@suluk/models 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suluk/models",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A weekly, PUBLIC-DATA-ONLY catalog of OpenRouter models + a selector: a suluk skill declares NEEDS (hard filters) + a small PREFERENCE (a named profile), and selectModel picks the best CURRENT model — never a hard-coded id. Decidable OpenRouter facts as numbers; noisy benchmarks as COARSE TIERS with {source, asOf}; no cross-axis composite (blending is the selector's job). CANDIDATE tooling — NOT official OAS.",
   "publishConfig": {
   "access": "public"

package/scripts/refresh.ts

@@ -0,0 +1,15 @@
+/**
+ * Weekly refresh (Class A) — fetch OpenRouter /models, normalize to the fact-cell catalog, and write the committed,
+ * content-addressed artifact `src/openrouter-catalog.json`. Run: `bun scripts/refresh.ts [asOf]`. NETWORK.
+ * The benchmark TIER overlay (Class B) is a separate, lower-cadence, human-reviewed step (see REFRESH.md).
+ */
+import { fetchOpenRouterCatalog, applyTierOverlay, KNOWN_TIERS } from "../src/index";
+
+const asOf = process.argv[2] ?? new Date().toISOString().slice(0, 10);
+let cat = await fetchOpenRouterCatalog(asOf);
+// Class-B bootstrap: overlay the small cited frontier-standings seed onto intel.* (the full curation is the TODO).
+cat = applyTierOverlay(cat, KNOWN_TIERS, { source: "public-leaderboard-consensus", asOf });
+const overlaid = cat.rows.filter((r) => r.intel.reasoning.value !== null).length;
+const out = new URL("../src/openrouter-catalog.json", import.meta.url);
+await Bun.write(out, JSON.stringify(cat) + "\n"); // compact — it ships in the npm package (transitively via @suluk/agents)
+console.log(`@suluk/models: wrote ${cat.rows.length} models (${overlaid} with intel tiers) · asOf ${asOf} · ${cat.snapshotHash}`);

package/src/index.ts

@@ -6,13 +6,19 @@
  * Council wf_729cde52-cc7. CANDIDATE tooling — NOT official OAS. The live weekly fetcher is specified in REFRESH.md
  * (this package ships the schema + selector + a SEED catalog; the 200-row generated catalog is the data-eng spine).
  */
+import type { ModelCatalog } from "./types";
 export type {
   Tier, Cell, DataRetention, ModelRecord, ModelCatalog, HardFilters, Profile, Preferences, RankedModel, SelectResult,
 } from "./types";
 export { SEED_CATALOG } from "./catalog";
+// the committed, content-addressed OpenRouter fact catalog (generated weekly by scripts/refresh.ts): real prices /
+// context / caps for ~300+ models. Benchmark TIER cells (intel.*) stay UNKNOWN until the Class-B overlay lands.
+import OPENROUTER_CATALOG_JSON from "./openrouter-catalog.json";
+export const OPENROUTER_CATALOG = OPENROUTER_CATALOG_JSON as unknown as ModelCatalog;
 export { PROFILES, type ResolvedProfile } from "./profiles";
 export { selectModel, deriveRequirements } from "./select";
 // the weekly fetcher spine: documented tier bucketing rules (red-line) + the pure OpenRouter facts transform + a thin live fetch.
 export { BUCKETING_RULES, applyBucketing, type AxisRule } from "./bucketing";
 export { normalizeOpenRouter, normalizeOpenRouterModel, catalogFrom, snapshotHash, type ORModel } from "./normalize";
 export { fetchOpenRouterCatalog } from "./fetch";
+export { applyTierOverlay, KNOWN_TIERS, type IntelAxis } from "./overlay";

package/src/normalize.ts

@@ -68,9 +68,10 @@ export function normalizeOpenRouter(models: ORModel[], asOf: string): ModelRecor
   return models.map((m) => normalizeOpenRouterModel(m, asOf)).sort((a, b) => a.id.localeCompare(b.id));
 }
 
-/** A content-addressed hash over the rows' load-bearing FACT cells (reproducible pin; ties C027 contentHash). */
+/** A content-addressed hash over the rows' load-bearing SELECTION inputs — facts AND intel tiers (a re-pick under a
+ * different catalog must differ; reproducible pin; ties C027 contentHash). */
 export function snapshotHash(rows: ModelRecord[]): string {
-  const facts = rows.map((r) => [r.id, r.cost.inputPerMtok.value, r.cost.outputPerMtok.value, r.context.maxWindow.value, r.caps.toolCalling.value]);
+  const facts = rows.map((r) => [r.id, r.cost.inputPerMtok.value, r.cost.outputPerMtok.value, r.context.maxWindow.value, r.caps.toolCalling.value, ...Object.values(r.intel).map((c) => c.value)]);
   return "sha256-" + createHash("sha256").update(JSON.stringify(facts), "utf8").digest("hex").slice(0, 16);
 }