@namzu/zen 2.3.0 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @namzu/zen
 
+## 2.5.0
+
+### Minor Changes
+
+- ab9108b: Derive the Zen and Go model catalogue at run time, opt-in. The new `@namzu/zen/catalogue` subpath exports `fetchZenCatalogue()`, which reads the same five sources the bundled snapshot is generated from (both documentation pages, models.dev and both `/models` answers) with a deadline and byte limit per source, and returns a whole validated catalogue plus a report, or rejects. It never returns a partial list. `buildZenCatalogue()` does the same derivation from texts you fetched yourself, and `parseZenCatalogue()` re-admits a stored copy strictly. A derivation is held to the same checks as a stored copy, so a result is never one its own saved copy would fail to read back.
+
+  Pass the result as the new `ZenConfig.catalogue`, or a function returning it, and the provider checks it before the bundled snapshot for routing, anonymous admission, listing, context windows and effort levels. With a runtime catalogue, a served id that no source gives a wire format for is listed as `<id> (no known wire format)` and can be called only with an explicit `protocol`; the bundled snapshot's entry for such an id, if it has one, is not used. A model name carrying a control, format or line-separator character is refused, in a derivation and in a stored copy.
+
+  Nothing changes unless you opt in. Importing the package, constructing a provider and `getZenModels`/`findZenModel` still read the bundled snapshot and make no network request. Without `catalogue`, `listModels()` returns what it did before. `ZEN_OMITTED_MODELS` (the reviewed omissions the snapshot was generated under) is now exported from `@namzu/zen` and `@namzu/zen/models`. The bundled roster is unchanged: 61 Zen and 28 Go models.
+
+## 2.4.0
+
+### Minor Changes
+
+- 3e43fc2: The Go catalogue carries `grok-4.7` on the Responses protocol, as the Go page
+  routes it. Four ids that both pages route but models.dev does not describe yet —
+  `zen/grok-4.7`, `zen/mimo-v2.6-flash-free`, `go/mimo-v2.6-flash` and
+  `go/mimo-v2.6-pro` — are not carried, because their limits cannot be derived. A
+  caller that needs one names the protocol and limits itself.
+
+### Patch Changes
+
+- 3641102: On the Messages protocol, a cache request now places block-level breakpoints —
+  after the static system text, and on the last message before request-only
+  context — instead of the request-level `cacheControl` option, which the native
+  adapter sends as a top-level `cache_control`. That is Anthropic's automatic
+  caching, which puts its breakpoint on the last block: the request-only context
+  at the tail, which the next request replaces, so no later request read the
+  cached history. Other protocols are unchanged.
+
 ## 2.3.0
 
 ### Minor Changes

package/README.md

@@ -22,7 +22,9 @@ Free (`muse-spark-1.3-contributor-free`). Zen Go still requires its own API key.
 pnpm add @namzu/sdk @namzu/zen zod@^3
 ```
 
-Requires Node.js 20+ and `@namzu/sdk >=36.0.0`. The optional package uses the
+Requires Node.js 20+ and `@namzu/sdk >=36.0.0`; the example below uses the
+`turn` field `runAgent` returns from `@namzu/sdk` 44 on (earlier versions call
+it `run`). The optional package uses the
 official AI SDK provider adapters directly through `LanguageModelV3.doStream`;
 it does not depend on the `ai` orchestration package or another Namzu provider.
 
@@ -32,7 +34,7 @@ import { ZenProvider } from '@namzu/zen'
 
 const sessionId = generateSessionId()
 const provider = new ZenProvider({ sessionId })
-const { output, run, identity } = await runAgent({
+const { output, turn, identity } = await runAgent({
   provider,
   model: 'muse-spark-1.3-contributor-free',
   sessionId,
@@ -41,7 +43,7 @@ const { output, run, identity } = await runAgent({
 })
 
 console.log(output)
-console.log(run.stopReason)
+console.log(turn.stopReason)
 console.log(identity)
 ```
 
@@ -122,25 +124,44 @@ controls also depend on the wire. See the [SDK guide](../../../docs/sdk/zen.md)
 for configuration and refusal details.
 
 `listModels(signal?)` intersects the live service catalogue with supported
-bundled models and restricts anonymous results to the explicit public set.
-Static limits and USD-per-million-token prices are generated from the
-services' own documentation pages by `scripts/generate-zen-models.mjs`, and
-are estimates rather than invoices: context tiers, caches, Go peak/off-peak
-rates, subscription allowances and promotions can change the effective
-charge. Refresh the catalogue with that script; the CI gate fails when a
-service documents OR SERVES a model the catalogue neither carries nor omits,
-naming it, and the scheduled refresh workflow opens a pull request when
-upstream has moved.
+models and restricts anonymous results to the explicit public set.
+Static limits and USD-per-million-token prices are derived from the
+services' own documentation pages, models.dev and the services' `/models`
+answers, and are estimates rather than invoices: context tiers, caches, Go
+peak/off-peak rates, subscription allowances and promotions can change the
+effective charge.
+
+The package ships a bundled snapshot of that catalogue and never reaches the
+network for it on its own. A host that wants a fresher roster opts in:
+
+```ts
+import { ZenProvider } from '@namzu/zen'
+import { fetchZenCatalogue } from '@namzu/zen/catalogue'
+
+const { catalogue, report } = await fetchZenCatalogue({ timeoutMs: 10_000 })
+const provider = new ZenProvider({ apiKey: process.env.OPENCODE_API_KEY, catalogue })
+console.log(report.servedUndocumented)
+```
+
+`fetchZenCatalogue` reads the five sources with per-source deadlines and byte
+limits, applies the same rules the snapshot is generated with, and either
+returns a whole catalogue or rejects — never a partial list. A runtime
+catalogue takes precedence over the bundled snapshot; an id the service serves
+with no known wire is listed as `<id> (no known wire format)` and is callable
+only with an explicit `protocol`. `parseZenCatalogue` re-admits a stored copy
+with the same strictness. The Namzu CLI refreshes it this way in the
+background on every launch. The bundled snapshot is regenerated by hand with
+`scripts/generate-zen-models.mjs`.
 
 Tests use the real provider adapters with local HTTP/SSE fixtures, including
 tool continuations, signatures, cancellation and error classification.
 An SDK kernel test executes a registered tool and feeds its result into the
-next model request before completing the run.
+next model request before completing the turn.
 On 2026-09-08, live text inference on `muse-spark-1.3-contributor-free`
 succeeded without an account key through installed OpenCode and Namzu's
-driver. A live Namzu `run-stream` call with low effort and production tools
+driver. A live Namzu `run-stream` call (the command is now `namzu exec --json`) with low effort and production tools
 also read `verification.txt`, then returned its exact nonce, absent from
-the prompt, after two model requests. The read succeeded and the run ended
+the prompt, after two model requests. The read succeeded and the turn ended
 with `end_turn`. This validates that model's public text and file-tool path;
 it does not establish every public or paid model, Go access, or billing.
 

package/dist/catalogue/catalogue.d.ts

@@ -0,0 +1,106 @@
+/**
+ * A Zen catalogue assembled at run time from the same sources, by the same
+ * rules, as the bundled snapshot in `models.ts`.
+ *
+ * Nothing here reaches the network. `buildZenCatalogue` turns source TEXTS
+ * into a catalogue; `fetch.ts` is the one place those texts are fetched, and
+ * only when a caller asks. `parseZenCatalogue` re-admits a catalogue a host
+ * stored earlier, with the same strictness a fresh derivation has: a document
+ * that is not exactly a catalogue is refused whole, never read in part.
+ */
+import { type ZenModel, type ZenService } from '../models.js';
+import { type ZenOmissions } from './derive.js';
+/** The stored shape's version. A document carrying any other is refused. */
+export declare const ZEN_CATALOGUE_VERSION = 1;
+/**
+ * A complete Zen and Go roster.
+ *
+ * `unrouted` lists, per service, the ids the service's own `/models` answer
+ * serves that this catalogue neither carries nor omits by review: no source
+ * states a wire for them (or the rest of what carrying needs), so a driver
+ * lists them as having no known wire format and calls one only when its host
+ * names the protocol explicitly.
+ */
+export interface ZenCatalogue {
+    readonly version: typeof ZEN_CATALOGUE_VERSION;
+    /** When the sources were read, as an ISO 8601 timestamp. */
+    readonly fetchedAt: string;
+    readonly zen: readonly ZenModel[];
+    readonly go: readonly ZenModel[];
+    readonly unrouted: Readonly<Record<ZenService, readonly string[]>>;
+}
+/** What a derivation found and did not carry. Informational: none of it fails a build. */
+export interface ZenCatalogueReport {
+    /** `service/id`: served by the service, documented on no page, omitted by nothing. */
+    readonly servedUndocumented: readonly string[];
+    /** `[service/id, why]`: documented, not carryable, omitted by nothing. */
+    readonly undecided: readonly (readonly [string, string])[];
+    /** `service/id`: omissions upstream neither documents nor serves any more. */
+    readonly stale: readonly string[];
+    /** `service: name`: price rows no route row names. */
+    readonly orphanPrices: readonly string[];
+}
+/** The five upstream documents, as the texts they were served as. */
+export interface ZenCatalogueSources {
+    readonly docs: Readonly<Record<ZenService, string>>;
+    /** `https://models.dev/api.json`. */
+    readonly modelsDev: string;
+    /** Each service's own `/models` answer. */
+    readonly served: Readonly<Record<ZenService, string>>;
+}
+export interface BuildZenCatalogueOptions {
+    /**
+     * Reviewed omissions, as `service/id` keys or the review file's record.
+     * Defaults to the decisions the bundled snapshot was generated under.
+     */
+    readonly omissions?: ZenOmissions;
+    /**
+     * The roster a result is measured against for collapse: fewer than 80% of
+     * its models on either service refuses the result. Defaults to the bundled
+     * snapshot.
+     */
+    readonly baseline?: Readonly<Record<ZenService, readonly unknown[]>>;
+    /** Stamped as `fetchedAt`. Defaults to now. */
+    readonly fetchedAt?: Date;
+}
+export interface ZenCatalogueResult {
+    readonly catalogue: ZenCatalogue;
+    readonly report: ZenCatalogueReport;
+}
+/**
+ * Derive a catalogue from upstream texts, or throw `ZenCatalogueSourceError`.
+ *
+ * All or nothing: a page that moved, a models.dev that changed shape, a served
+ * answer with no ids or a roster that collapsed past the floor refuses the
+ * whole result, so a caller holding an older catalogue keeps it rather than
+ * receiving part of a new one.
+ */
+export declare function buildZenCatalogue(sources: ZenCatalogueSources, options?: BuildZenCatalogueOptions): ZenCatalogueResult;
+/** A stored catalogue that is not exactly a catalogue. */
+export declare class ZenCatalogueFormatError extends Error {
+    readonly name = "ZenCatalogueFormatError";
+}
+/**
+ * Re-admit a catalogue a host stored — the output of `JSON.parse` on what
+ * `JSON.stringify(catalogue)` wrote — or throw `ZenCatalogueFormatError`.
+ *
+ * Every field is checked as strictly as a derivation checks its sources, and a
+ * document with one bad field is refused whole: a cache someone edited, a
+ * truncated write or a file from another version never becomes a partial
+ * roster.
+ */
+export declare function parseZenCatalogue(value: unknown): ZenCatalogue;
+/**
+ * Exact lookup with the runtime catalogue first and the bundled snapshot
+ * second. `catalogue` undefined is the bundled snapshot alone.
+ *
+ * An id the runtime catalogue lists in `unrouted` is found in neither: the
+ * newer sources say the service serves it and state no wire for it, and the
+ * bundled snapshot's older entry is not allowed to answer for them. Falling
+ * back would route the model on a wire nobody states any more, anonymously
+ * too if the old entry said so, and without saying anything.
+ */
+export declare function findZenCatalogueModel(catalogue: ZenCatalogue | undefined, service: ZenService, id: string): ZenModel | undefined;
+/** Whether a runtime catalogue lists `id` as served with no known wire format. */
+export declare function isUnroutedZenModel(catalogue: ZenCatalogue | undefined, service: ZenService, id: string): boolean;
+//# sourceMappingURL=catalogue.d.ts.map

package/dist/catalogue/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../src/catalogue/catalogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAEN,KAAK,QAAQ,EAEb,KAAK,UAAU,EAGf,MAAM,cAAc,CAAA;AACrB,OAAO,EAKN,KAAK,YAAY,EAMjB,MAAM,aAAa,CAAA;AAEpB,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,qBAAqB,CAAA;IAC9C,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,QAAQ,EAAE,CAAA;IACjC,QAAQ,CAAC,EAAE,EAAE,SAAS,QAAQ,EAAE,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;CAClE;AAED,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;IAClC,sFAAsF;IACtF,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;IAC1D,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;IACnD,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;CACrD;AAED,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,CAAA;IACpE,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,wBAA6B,GACpC,kBAAkB,CAiFpB;AA6ED,0DAA0D;AAC1D,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,SAAkB,IAAI,6BAA4B;CAClD;AAsGD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAmD9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,YAAY,GAAG,SAAS,EACnC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,MAAM,GACR,QAAQ,GAAG,SAAS,CAKtB;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,YAAY,GAAG,SAAS,EACnC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,MAAM,GACR,OAAO,CAET"}

package/dist/catalogue/catalogue.js

@@ -0,0 +1,325 @@
+/**
+ * A Zen catalogue assembled at run time from the same sources, by the same
+ * rules, as the bundled snapshot in `models.ts`.
+ *
+ * Nothing here reaches the network. `buildZenCatalogue` turns source TEXTS
+ * into a catalogue; `fetch.ts` is the one place those texts are fetched, and
+ * only when a caller asks. `parseZenCatalogue` re-admits a catalogue a host
+ * stored earlier, with the same strictness a fresh derivation has: a document
+ * that is not exactly a catalogue is refused whole, never read in part.
+ */
+import { ZEN_OMITTED_MODELS, findZenModel, getZenModels, } from '../models.js';
+import { ZEN_SERVICES, ZenCatalogueSourceError, checkRosterFloor, derive, isDisplayableName, parsePage, parseServed, } from './derive.js';
+/** The stored shape's version. A document carrying any other is refused. */
+export const ZEN_CATALOGUE_VERSION = 1;
+/**
+ * Derive a catalogue from upstream texts, or throw `ZenCatalogueSourceError`.
+ *
+ * All or nothing: a page that moved, a models.dev that changed shape, a served
+ * answer with no ids or a roster that collapsed past the floor refuses the
+ * whole result, so a caller holding an older catalogue keeps it rather than
+ * receiving part of a new one.
+ */
+export function buildZenCatalogue(sources, options = {}) {
+    const omissions = options.omissions ?? new Set(ZEN_OMITTED_MODELS);
+    const omitted = omissions instanceof Set ? omissions : new Set(Object.keys(omissions));
+    let modelsDev;
+    try {
+        modelsDev = JSON.parse(sources.modelsDev);
+    }
+    catch (error) {
+        throw new ZenCatalogueSourceError(`models.dev is not JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const carried = { zen: [], go: [] };
+    const unrouted = { zen: [], go: [] };
+    const servedUndocumented = [];
+    const undecided = [];
+    const stale = [];
+    const orphanPrices = [];
+    for (const { service, page, provider } of ZEN_SERVICES) {
+        const parsed = parsePage(sources.docs[service], { page, service });
+        const served = parseServed(service, sources.served[service]);
+        const entry = modelsDev !== null && typeof modelsDev === 'object'
+            ? modelsDev[provider]
+            : undefined;
+        const models = entry !== null && typeof entry === 'object'
+            ? entry.models
+            : undefined;
+        if (models === null || typeof models !== 'object' || Array.isArray(models)) {
+            throw new ZenCatalogueSourceError(`models.dev has no \`${provider}\` provider entry.`);
+        }
+        const derived = derive(service, parsed, provider, { models }, omitted, served);
+        carried[service] = derived.models.map(toZenModel);
+        const ids = new Set(carried[service].map((model) => model.id));
+        unrouted[service] = [...served]
+            .filter((id) => !ids.has(id) && !omitted.has(`${service}/${id}`))
+            .sort();
+        servedUndocumented.push(...derived.servedUncurried.map((id) => `${service}/${id}`));
+        undecided.push(...derived.undecided);
+        stale.push(...derived.stale.map((id) => `${service}/${id}`));
+        orphanPrices.push(...derived.orphanPrices.map((name) => `${service}: ${name}`));
+    }
+    checkRosterFloor(carried, options.baseline ?? { zen: getZenModels('zen'), go: getZenModels('go') });
+    // The result is admitted by the same checks a stored copy of it will face.
+    // A derivation that yields something `parseZenCatalogue` would refuse on the
+    // next launch — a NaN rate, a repeated id, a name no picker can show — is
+    // refused now, whole, instead of becoming this session's roster.
+    let catalogue;
+    try {
+        catalogue = parseZenCatalogue({
+            version: ZEN_CATALOGUE_VERSION,
+            fetchedAt: (options.fetchedAt ?? new Date()).toISOString(),
+            zen: carried.zen,
+            go: carried.go,
+            unrouted,
+        });
+    }
+    catch (error) {
+        if (!(error instanceof ZenCatalogueFormatError))
+            throw error;
+        throw new ZenCatalogueSourceError(`The derived catalogue is not one a stored copy could be read back as: ${error.message}`);
+    }
+    return {
+        catalogue,
+        report: Object.freeze({
+            servedUndocumented: Object.freeze(servedUndocumented),
+            undecided: Object.freeze(undecided.map((pair) => Object.freeze(pair))),
+            stale: Object.freeze(stale),
+            orphanPrices: Object.freeze(orphanPrices),
+        }),
+    };
+}
+/** The shape the bundled snapshot uses: streaming stated, anonymity only when true. */
+function toZenModel(model) {
+    return {
+        id: model.id,
+        name: model.name,
+        protocol: model.protocol,
+        contextWindow: model.contextWindow,
+        maxOutputTokens: model.maxOutputTokens,
+        inputModalities: [...model.inputModalities],
+        inputPrice: model.inputPrice,
+        outputPrice: model.outputPrice,
+        supportsToolUse: model.supportsToolUse,
+        supportsStreaming: true,
+        effortLevels: [...model.effortLevels],
+        ...(model.supportsAnonymousAccess ? { supportsAnonymousAccess: true } : {}),
+    };
+}
+function freezeCatalogue(catalogue) {
+    for (const service of ['zen', 'go']) {
+        for (const model of catalogue[service]) {
+            if (model.inputModalities)
+                Object.freeze(model.inputModalities);
+            if (model.effortLevels)
+                Object.freeze(model.effortLevels);
+            Object.freeze(model);
+        }
+        Object.freeze(catalogue[service]);
+        Object.freeze(catalogue.unrouted[service]);
+    }
+    Object.freeze(catalogue.unrouted);
+    return Object.freeze(catalogue);
+}
+const MODEL_ID = /^[a-z0-9][a-z0-9.-]*$/;
+const PROTOCOLS = new Set([
+    'chat',
+    'responses',
+    'messages',
+    'google',
+]);
+const INPUT_MODALITIES = new Set([
+    'text',
+    'image',
+    'document',
+]);
+const EFFORTS = new Set([
+    'none',
+    'minimal',
+    'low',
+    'medium',
+    'high',
+    'xhigh',
+    'max',
+    'ultra',
+]);
+const MODEL_KEYS = new Set([
+    'id',
+    'name',
+    'protocol',
+    'contextWindow',
+    'maxOutputTokens',
+    'inputModalities',
+    'inputPrice',
+    'outputPrice',
+    'supportsToolUse',
+    'supportsStreaming',
+    'effortLevels',
+    'supportsAnonymousAccess',
+]);
+/** A stored catalogue that is not exactly a catalogue. */
+export class ZenCatalogueFormatError extends Error {
+    name = 'ZenCatalogueFormatError';
+}
+function invalid(where, why) {
+    throw new ZenCatalogueFormatError(`${where} ${why}.`);
+}
+function record(value, where) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        invalid(where, 'is not an object');
+    }
+    return value;
+}
+function onlyKeys(value, keys, where) {
+    for (const key of Object.keys(value)) {
+        if (!keys.has(key))
+            invalid(`${where}.${key}`, 'is not a catalogue field');
+    }
+}
+function positiveInteger(value, where) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value <= 0) {
+        invalid(where, 'is not a positive integer');
+    }
+    return value;
+}
+function price(value, where) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+        invalid(where, 'is not a non-negative price');
+    }
+    return value;
+}
+function members(value, allowed, where, nonEmpty) {
+    if (!Array.isArray(value))
+        invalid(where, 'is not a list');
+    if (nonEmpty && value.length === 0)
+        invalid(where, 'is empty');
+    for (const item of value) {
+        if (typeof item !== 'string' || !allowed.has(item)) {
+            invalid(where, `names ${JSON.stringify(item)}, which is not one it may name`);
+        }
+    }
+    if (new Set(value).size !== value.length)
+        invalid(where, 'repeats an entry');
+    return [...value];
+}
+function parseModel(value, service, where) {
+    const raw = record(value, where);
+    onlyKeys(raw, MODEL_KEYS, where);
+    const id = raw.id;
+    if (typeof id !== 'string' || !MODEL_ID.test(id))
+        invalid(`${where}.id`, 'is not a model id');
+    const name = raw.name;
+    if (typeof name !== 'string' ||
+        name.trim().length === 0 ||
+        name.length > 200 ||
+        !isDisplayableName(name)) {
+        invalid(`${where}.name`, 'is not a model name');
+    }
+    const protocol = raw.protocol;
+    if (typeof protocol !== 'string' || !PROTOCOLS.has(protocol)) {
+        invalid(`${where}.protocol`, 'is not a Zen protocol');
+    }
+    if (typeof raw.supportsToolUse !== 'boolean') {
+        invalid(`${where}.supportsToolUse`, 'is not true or false');
+    }
+    if (raw.supportsStreaming !== true)
+        invalid(`${where}.supportsStreaming`, 'is not true');
+    const anonymous = raw.supportsAnonymousAccess;
+    if (anonymous !== undefined && (anonymous !== true || service !== 'zen')) {
+        invalid(`${where}.supportsAnonymousAccess`, 'is only ever `true`, and only on zen');
+    }
+    return {
+        id,
+        name,
+        protocol: protocol,
+        contextWindow: positiveInteger(raw.contextWindow, `${where}.contextWindow`),
+        maxOutputTokens: positiveInteger(raw.maxOutputTokens, `${where}.maxOutputTokens`),
+        inputModalities: members(raw.inputModalities, INPUT_MODALITIES, `${where}.inputModalities`, true),
+        inputPrice: price(raw.inputPrice, `${where}.inputPrice`),
+        outputPrice: price(raw.outputPrice, `${where}.outputPrice`),
+        supportsToolUse: raw.supportsToolUse,
+        supportsStreaming: true,
+        effortLevels: members(raw.effortLevels, EFFORTS, `${where}.effortLevels`, false),
+        ...(anonymous === true ? { supportsAnonymousAccess: true } : {}),
+    };
+}
+/**
+ * Re-admit a catalogue a host stored — the output of `JSON.parse` on what
+ * `JSON.stringify(catalogue)` wrote — or throw `ZenCatalogueFormatError`.
+ *
+ * Every field is checked as strictly as a derivation checks its sources, and a
+ * document with one bad field is refused whole: a cache someone edited, a
+ * truncated write or a file from another version never becomes a partial
+ * roster.
+ */
+export function parseZenCatalogue(value) {
+    const raw = record(value, 'catalogue');
+    onlyKeys(raw, new Set(['version', 'fetchedAt', 'zen', 'go', 'unrouted']), 'catalogue');
+    if (raw.version !== ZEN_CATALOGUE_VERSION) {
+        invalid('catalogue.version', `is not ${ZEN_CATALOGUE_VERSION}`);
+    }
+    const fetchedAt = raw.fetchedAt;
+    if (typeof fetchedAt !== 'string' ||
+        Number.isNaN(Date.parse(fetchedAt)) ||
+        new Date(fetchedAt).toISOString() !== fetchedAt) {
+        invalid('catalogue.fetchedAt', 'is not an ISO 8601 timestamp');
+    }
+    const unroutedRaw = record(raw.unrouted, 'catalogue.unrouted');
+    onlyKeys(unroutedRaw, new Set(['zen', 'go']), 'catalogue.unrouted');
+    const carried = { zen: [], go: [] };
+    const unrouted = { zen: [], go: [] };
+    for (const service of ['zen', 'go']) {
+        const list = raw[service];
+        if (!Array.isArray(list) || list.length === 0) {
+            invalid(`catalogue.${service}`, 'is not a non-empty list of models');
+        }
+        carried[service] = list.map((entry, index) => parseModel(entry, service, `catalogue.${service}[${index}]`));
+        const ids = new Set(carried[service].map((model) => model.id));
+        if (ids.size !== carried[service].length)
+            invalid(`catalogue.${service}`, 'repeats a model id');
+        const names = unroutedRaw[service];
+        if (!Array.isArray(names))
+            invalid(`catalogue.unrouted.${service}`, 'is not a list');
+        for (const id of names) {
+            if (typeof id !== 'string' || !MODEL_ID.test(id)) {
+                invalid(`catalogue.unrouted.${service}`, `names ${JSON.stringify(id)}, which is not a model id`);
+            }
+            if (ids.has(id))
+                invalid(`catalogue.unrouted.${service}`, `names the carried model "${id}"`);
+        }
+        if (new Set(names).size !== names.length) {
+            invalid(`catalogue.unrouted.${service}`, 'repeats an id');
+        }
+        unrouted[service] = [...names];
+    }
+    return freezeCatalogue({
+        version: ZEN_CATALOGUE_VERSION,
+        fetchedAt,
+        zen: carried.zen,
+        go: carried.go,
+        unrouted,
+    });
+}
+/**
+ * Exact lookup with the runtime catalogue first and the bundled snapshot
+ * second. `catalogue` undefined is the bundled snapshot alone.
+ *
+ * An id the runtime catalogue lists in `unrouted` is found in neither: the
+ * newer sources say the service serves it and state no wire for it, and the
+ * bundled snapshot's older entry is not allowed to answer for them. Falling
+ * back would route the model on a wire nobody states any more, anonymously
+ * too if the old entry said so, and without saying anything.
+ */
+export function findZenCatalogueModel(catalogue, service, id) {
+    const runtime = catalogue?.[service].find((model) => model.id === id);
+    if (runtime)
+        return runtime;
+    if (isUnroutedZenModel(catalogue, service, id))
+        return undefined;
+    return findZenModel(service, id);
+}
+/** Whether a runtime catalogue lists `id` as served with no known wire format. */
+export function isUnroutedZenModel(catalogue, service, id) {
+    return catalogue?.unrouted[service].includes(id) === true;
+}
+//# sourceMappingURL=catalogue.js.map

package/dist/catalogue/catalogue.js.map

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