@agentproto/model-catalog 0.13.1 → 0.14.0

package/dist/lists/index.d.ts

@@ -0,0 +1,70 @@
+import { A as AccessTarget } from '../types-DMzMWJeJ.js';
+export { i as isZeroPriced } from '../index-DetGJJ-F.js';
+import '../base-BaiI72Da.js';
+import 'zod';
+import '../index-D8FWHlom.js';
+import '../catalog-BB0uDJh-.js';
+import '../image/index.js';
+import '../video/index.js';
+import '../audio/index.js';
+import '../audio-Do2j3wDC.js';
+import '../schema/voice.js';
+
+/**
+ * Model lists — named, user-editable selections over the model catalog.
+ *
+ * A list is data: a set of include selectors (OR), optional exclusions that
+ * always win, explicit id pins, and an ordering mode. The selector vocabulary
+ * is the existing `AccessTarget` matcher plus the catalog dimensions that have
+ * no access-rule target (price, context window, route variant) and list
+ * composition.
+ *
+ * `zero-cost` (the seed list) is the one way "free" is expressed in code now:
+ * `{ include: [{ kind: "tag", value: "price:zero" }] }`.
+ */
+
+type ModelSelector = AccessTarget | {
+    kind: "price";
+    maxInPer1M?: number;
+    maxOutPer1M?: number;
+} | {
+    kind: "context";
+    min: number;
+} | {
+    kind: "variant";
+    value: string;
+} | {
+    kind: "list";
+    id: string;
+};
+/** A named selection over the model catalog. An uncataloged `ids` pin is only
+ *  removed by a `{ kind: "model" }` exclude; no other selector can match an id
+ *  the catalog does not know. */
+interface ModelList {
+    id: string;
+    label?: string;
+    include?: ModelSelector[];
+    exclude?: ModelSelector[];
+    ids?: string[];
+    order?: "listed" | "cheapest" | "largest-context" | "newest";
+    rotation?: "priority" | "round-robin" | "least-recently-limited";
+}
+interface ModelListSource {
+    get(id: string): ModelList | undefined;
+}
+declare class ModelListError extends Error {
+    readonly name = "ModelListError";
+}
+/** Test/consumer helper after an overlay or route registration changes. */
+declare function clearModelListCache(): void;
+/** Membership without full expansion; uncataloged ids match only via `ids`. */
+declare function inModelList(model: string, id: string, src: ModelListSource): boolean;
+/** Ordered, de-duplicated model ids. Throws ModelListError on unknown id or cycle. */
+declare function resolveModelList(id: string, src: ModelListSource): string[];
+/** Explain: per model, which selector or pin included it. */
+declare function explainModelList(id: string, src: ModelListSource): Array<{
+    model: string;
+    via: string;
+}>;
+
+export { type ModelList, ModelListError, type ModelListSource, type ModelSelector, clearModelListCache, explainModelList, inModelList, resolveModelList };

package/dist/lists/index.mjs

@@ -0,0 +1,290 @@
+import { getModel, resolveAlias, listModels } from '../chunk-ETI76MOK.mjs';
+import '../chunk-H6JUTF3U.mjs';
+import { stripRouteSuffix, resolveLlmModelRoute, formatModelRef, listRouterLlmRoutes, tryParseModelRef } from '../chunk-BXTZ2EDE.mjs';
+import { modelMatchesTarget } from '../chunk-PVE3WQRH.mjs';
+export { isZeroPriced } from '../chunk-YSEQMLV2.mjs';
+import '../chunk-WG4F6IRS.mjs';
+import '../chunk-IHU6XTXS.mjs';
+import { resolveContextWindow } from '../chunk-MZ23K5W6.mjs';
+import '../chunk-QHELXPSL.mjs';
+import '../chunk-2LWYZOWB.mjs';
+import '../chunk-IJZ4XPO2.mjs';
+import '../chunk-WRUWNKDB.mjs';
+import '../chunk-SGJR6ZQH.mjs';
+import '../chunk-HEDDSOZF.mjs';
+
+/**
+ * @agentproto/model-catalog v0.1.0
+ * Unified model catalog: LLM, image, video, audio entries + cost dispatcher + picker.
+ * Zod-only OSS core; @agstudio/model-catalog layers billing/access/BYOK on top.
+ */
+
+// src/lists/index.ts
+var ModelListError = class extends Error {
+  name = "ModelListError";
+};
+var ROUTERS = [
+  "openrouter",
+  "requesty",
+  "huggingface",
+  "opencode",
+  "opencode-go"
+];
+var candidateCache;
+var candidateIndexCache;
+var subjectIdsCache = /* @__PURE__ */ new Map();
+function candidates() {
+  if (candidateCache) return candidateCache;
+  const out = listModels({ kind: "llm" });
+  const seen = new Set(out.map((model) => model.id));
+  for (const router of ROUTERS) {
+    for (const route of listRouterLlmRoutes(router)) {
+      const id = formatModelRef(route.ref);
+      if (seen.has(id)) continue;
+      seen.add(id);
+      out.push({
+        kind: "llm",
+        id,
+        canonicalId: route.canonicalProductId,
+        pricing: route.pricing,
+        provider: route.pricing.provider
+      });
+    }
+  }
+  candidateCache = out;
+  return out;
+}
+function clearModelListCache() {
+  candidateCache = void 0;
+  candidateIndexCache = void 0;
+  subjectIdsCache.clear();
+}
+function selectorLabel(selector) {
+  switch (selector.kind) {
+    case "model":
+      return `model:${selector.id}`;
+    case "price":
+      return `price:${selector.maxInPer1M ?? "*"}/${selector.maxOutPer1M ?? "*"}`;
+    case "context":
+      return `context:>=${selector.min}`;
+    case "variant":
+      return `variant:${selector.value}`;
+    case "list":
+      return `list:${selector.id}`;
+    default:
+      return `${selector.kind}:${selector.value}`;
+  }
+}
+function isListSelector(selector) {
+  return selector.kind === "list";
+}
+function contextWindowOf(model) {
+  if (model.kind !== "llm") return void 0;
+  return resolveContextWindow(model.id)?.contextWindow ?? resolveContextWindow(model.canonicalId)?.contextWindow;
+}
+function variantOf(id) {
+  const ref = tryParseModelRef(id);
+  return ref?.variant;
+}
+function selectorMatches(selector, model, rawId, src, stack) {
+  if (isListSelector(selector)) {
+    return inList(selector.id, rawId, src, stack);
+  }
+  switch (selector.kind) {
+    case "variant":
+      return variantOf(rawId) === selector.value || model !== void 0 && variantOf(model.id) === selector.value;
+    case "price": {
+      const pricing = model?.kind === "llm" ? model.pricing : void 0;
+      if (!pricing) return false;
+      if (selector.maxInPer1M !== void 0 && pricing.inputPer1M > selector.maxInPer1M) {
+        return false;
+      }
+      if (selector.maxOutPer1M !== void 0 && pricing.outputPer1M > selector.maxOutPer1M) {
+        return false;
+      }
+      return true;
+    }
+    case "context": {
+      if (!model) return false;
+      const window = contextWindowOf(model);
+      return window !== void 0 && window >= selector.min;
+    }
+    default:
+      return model !== void 0 && modelMatchesTarget(selector, model);
+  }
+}
+function excludeMatches(selector, model, rawId, src, stack) {
+  if (selector.kind === "model" && pinsMatch(selector.id, rawId)) {
+    return true;
+  }
+  return selectorMatches(selector, model, rawId, src, stack);
+}
+function candidateIndex() {
+  if (candidateIndexCache) return candidateIndexCache;
+  const index = /* @__PURE__ */ new Map();
+  for (const model of candidates()) index.set(model.id, model);
+  candidateIndexCache = index;
+  return index;
+}
+function subjectIds(raw) {
+  const cached = subjectIdsCache.get(raw);
+  if (cached) return cached;
+  const stripped = stripRouteSuffix(raw);
+  const out = /* @__PURE__ */ new Set([raw, stripped]);
+  const consider = (id) => {
+    out.add(id);
+    const model = getModel(id);
+    if (model) {
+      out.add(model.id);
+      if (model.kind === "llm") out.add(model.canonicalId);
+    }
+    out.add(resolveAlias(id));
+    try {
+      const route = resolveLlmModelRoute(id);
+      if (route) {
+        out.add(formatModelRef(route.ref));
+        out.add(`${route.vendor}/${route.product}`);
+      }
+    } catch {
+    }
+  };
+  consider(stripped);
+  if (!stripped.includes("/")) {
+    const bare = stripped.split(":")[0] ?? stripped;
+    for (const model of candidates()) {
+      const segment = model.id.split("/").pop()?.split(":")[0];
+      if (segment === bare) out.add(model.id);
+    }
+  }
+  const result = [...out];
+  subjectIdsCache.set(raw, result);
+  return result;
+}
+function pinsMatch(pin, id) {
+  if (pin === id) return true;
+  const pinStripped = stripRouteSuffix(pin);
+  const idStripped = stripRouteSuffix(id);
+  return pin === idStripped || pinStripped === id || pinStripped === idStripped;
+}
+function listContains(list, rawId, src, stack) {
+  const index = candidateIndex();
+  const model = index.get(rawId) ?? index.get(stripRouteSuffix(rawId));
+  for (const selector of list.exclude ?? []) {
+    if (excludeMatches(selector, model, rawId, src, stack)) return false;
+  }
+  if ((list.ids ?? []).some((pin) => pinsMatch(pin, rawId))) return true;
+  return (list.include ?? []).some(
+    (selector) => selectorMatches(selector, model, rawId, src, stack)
+  );
+}
+function inList(listId, rawId, src, stack) {
+  const list = src.get(listId);
+  if (!list) throw new ModelListError(`unknown model list "${listId}"`);
+  if (stack.includes(listId)) {
+    throw new ModelListError(
+      `model list cycle: ${[...stack, listId].join(" -> ")}`
+    );
+  }
+  return listContains(list, rawId, src, [...stack, listId]);
+}
+function inModelList(model, id, src) {
+  return subjectIds(model).some(
+    (candidate) => inList(id, candidate, src, [])
+  );
+}
+function insert(entries, model, via) {
+  if (!entries.has(model)) entries.set(model, { model, via });
+}
+function resolveEntries(id, src, stack) {
+  const list = src.get(id);
+  if (!list) throw new ModelListError(`unknown model list "${id}"`);
+  if (stack.includes(id)) {
+    throw new ModelListError(`model list cycle: ${[...stack, id].join(" -> ")}`);
+  }
+  const nextStack = [...stack, id];
+  const entries = /* @__PURE__ */ new Map();
+  const index = candidateIndex();
+  const all = candidates();
+  for (const selector of list.include ?? []) {
+    if (isListSelector(selector)) {
+      for (const entry of resolveEntries(selector.id, src, nextStack)) {
+        insert(entries, entry.model, `list:${selector.id}`);
+      }
+      continue;
+    }
+    for (const model of all) {
+      if (selectorMatches(selector, model, model.id, src, nextStack)) {
+        insert(entries, model.id, selectorLabel(selector));
+      }
+    }
+  }
+  for (const pin of list.ids ?? []) insert(entries, pin, "ids");
+  for (const selector of list.exclude ?? []) {
+    if (isListSelector(selector)) {
+      for (const entry of resolveEntries(selector.id, src, nextStack)) {
+        entries.delete(entry.model);
+      }
+      continue;
+    }
+    for (const model of all) {
+      if (selectorMatches(selector, model, model.id, src, nextStack)) {
+        entries.delete(model.id);
+      }
+    }
+    for (const key of [...entries.keys()]) {
+      if (excludeMatches(selector, index.get(key), key, src, nextStack)) {
+        entries.delete(key);
+      }
+    }
+  }
+  return [...entries.values()];
+}
+function applyOrder(entries, order, index) {
+  if (!order || order === "listed" || entries.length === 0) return entries;
+  const pricingOf = (entry) => {
+    const model = index.get(entry.model);
+    return model?.kind === "llm" ? model.pricing : void 0;
+  };
+  const sorted = [...entries];
+  sorted.sort((a, b) => {
+    const pa = pricingOf(a);
+    const pb = pricingOf(b);
+    if (order === "cheapest") {
+      const ca = pa ? pa.inputPer1M + pa.outputPer1M : Number.POSITIVE_INFINITY;
+      const cb = pb ? pb.inputPer1M + pb.outputPer1M : Number.POSITIVE_INFINITY;
+      return ca - cb;
+    }
+    if (order === "largest-context") {
+      const ma = index.get(a.model);
+      const mb = index.get(b.model);
+      const ca = ma ? contextWindowOf(ma) ?? Number.NEGATIVE_INFINITY : Number.NEGATIVE_INFINITY;
+      const cb = mb ? contextWindowOf(mb) ?? Number.NEGATIVE_INFINITY : Number.NEGATIVE_INFINITY;
+      return cb - ca;
+    }
+    const aa = pa?.addedAt ?? "";
+    const ab = pb?.addedAt ?? "";
+    return aa === ab ? 0 : aa < ab ? 1 : -1;
+  });
+  return sorted;
+}
+function resolveModelList(id, src) {
+  const list = src.get(id);
+  if (!list) throw new ModelListError(`unknown model list "${id}"`);
+  const entries = resolveEntries(id, src, []);
+  return applyOrder(entries, list.order, candidateIndex()).map(
+    (entry) => entry.model
+  );
+}
+function explainModelList(id, src) {
+  const list = src.get(id);
+  if (!list) throw new ModelListError(`unknown model list "${id}"`);
+  const entries = resolveEntries(id, src, []);
+  return applyOrder(entries, list.order, candidateIndex()).map((entry) => ({
+    model: entry.model,
+    via: entry.via
+  }));
+}
+
+export { ModelListError, clearModelListCache, explainModelList, inModelList, resolveModelList };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/lists/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lists/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Model lists — named, user-editable selections over the model catalog.\n *\n * A list is data: a set of include selectors (OR), optional exclusions that\n * always win, explicit id pins, and an ordering mode. The selector vocabulary\n * is the existing `AccessTarget` matcher plus the catalog dimensions that have\n * no access-rule target (price, context window, route variant) and list\n * composition.\n *\n * `zero-cost` (the seed list) is the one way \"free\" is expressed in code now:\n * `{ include: [{ kind: \"tag\", value: \"price:zero\" }] }`.\n */\n\nimport type { AccessTarget } from \"../access/types.js\"\nimport { modelMatchesTarget } from \"../access/evaluate.js\"\nimport { isZeroPriced } from \"../enrichment/index.js\"\nimport { resolveContextWindow } from \"../llm/index.js\"\nimport type { ResolvedModel } from \"../registry/index.js\"\nimport { getModel, listModels, resolveAlias } from \"../registry/index.js\"\nimport {\n  formatModelRef,\n  listRouterLlmRoutes,\n  resolveLlmModelRoute,\n  stripRouteSuffix,\n  tryParseModelRef,\n} from \"../route-identity/index.js\"\n\nexport type ModelSelector =\n  | AccessTarget\n  | { kind: \"price\"; maxInPer1M?: number; maxOutPer1M?: number }\n  | { kind: \"context\"; min: number }\n  | { kind: \"variant\"; value: string }\n  | { kind: \"list\"; id: string }\n\n/** A named selection over the model catalog. An uncataloged `ids` pin is only\n *  removed by a `{ kind: \"model\" }` exclude; no other selector can match an id\n *  the catalog does not know. */\nexport interface ModelList {\n  id: string\n  label?: string\n  include?: ModelSelector[]\n  exclude?: ModelSelector[]\n  ids?: string[]\n  order?: \"listed\" | \"cheapest\" | \"largest-context\" | \"newest\"\n  rotation?: \"priority\" | \"round-robin\" | \"least-recently-limited\"\n}\n\nexport interface ModelListSource {\n  get(id: string): ModelList | undefined\n}\n\nexport class ModelListError extends Error {\n  readonly name = \"ModelListError\"\n}\n\n/** Routers whose generated route tables are part of the catalog surface. */\nconst ROUTERS = [\n  \"openrouter\",\n  \"requesty\",\n  \"huggingface\",\n  \"opencode\",\n  \"opencode-go\",\n] as const\n\n/**\n * Every LLM candidate selectors can match: the registry's own `listModels`\n * view plus each router's generated route table (whose ids, e.g.\n * `opencode/big-pickle`, the bare-id registry deliberately does not carry).\n */\nlet candidateCache: ResolvedModel[] | undefined\nlet candidateIndexCache: Map<string, ResolvedModel> | undefined\nconst subjectIdsCache = new Map<string, string[]>()\n\nfunction candidates(): ResolvedModel[] {\n  if (candidateCache) return candidateCache\n  const out = listModels({ kind: \"llm\" })\n  const seen = new Set(out.map(model => model.id))\n  for (const router of ROUTERS) {\n    for (const route of listRouterLlmRoutes(router)) {\n      const id = formatModelRef(route.ref)\n      if (seen.has(id)) continue\n      seen.add(id)\n      out.push({\n        kind: \"llm\",\n        id,\n        canonicalId: route.canonicalProductId,\n        pricing: route.pricing,\n        provider: route.pricing.provider,\n      })\n    }\n  }\n  candidateCache = out\n  return out\n}\n\n/** Test/consumer helper after an overlay or route registration changes. */\nexport function clearModelListCache(): void {\n  candidateCache = undefined\n  candidateIndexCache = undefined\n  subjectIdsCache.clear()\n}\n\nfunction selectorLabel(selector: ModelSelector): string {\n  switch (selector.kind) {\n    case \"model\":\n      return `model:${selector.id}`\n    case \"price\":\n      return `price:${selector.maxInPer1M ?? \"*\"}/${selector.maxOutPer1M ?? \"*\"}`\n    case \"context\":\n      return `context:>=${selector.min}`\n    case \"variant\":\n      return `variant:${selector.value}`\n    case \"list\":\n      return `list:${selector.id}`\n    default:\n      return `${selector.kind}:${selector.value}`\n  }\n}\n\nfunction isListSelector(\n  selector: ModelSelector,\n): selector is Extract<ModelSelector, { kind: \"list\" }> {\n  return selector.kind === \"list\"\n}\n\nfunction contextWindowOf(model: ResolvedModel): number | undefined {\n  if (model.kind !== \"llm\") return undefined\n  return (\n    resolveContextWindow(model.id)?.contextWindow ??\n    resolveContextWindow(model.canonicalId)?.contextWindow\n  )\n}\n\nfunction variantOf(id: string): string | undefined {\n  const ref = tryParseModelRef(id)\n  return ref?.variant\n}\n\n/**\n * Does a selector match one model? `model` is the catalog candidate when one\n * exists; `rawId` is the id being tested (a route-suffixed or bare spelling\n * may differ from the catalog key). Uncataloged ids only match through an\n * explicit `ids` pin, handled by the caller.\n */\nfunction selectorMatches(\n  selector: ModelSelector,\n  model: ResolvedModel | undefined,\n  rawId: string,\n  src: ModelListSource,\n  stack: string[],\n): boolean {\n  if (isListSelector(selector)) {\n    return inList(selector.id, rawId, src, stack)\n  }\n  switch (selector.kind) {\n    case \"variant\":\n      return variantOf(rawId) === selector.value ||\n        (model !== undefined && variantOf(model.id) === selector.value)\n    case \"price\": {\n      const pricing = model?.kind === \"llm\" ? model.pricing : undefined\n      if (!pricing) return false\n      if (\n        selector.maxInPer1M !== undefined &&\n        pricing.inputPer1M > selector.maxInPer1M\n      ) {\n        return false\n      }\n      if (\n        selector.maxOutPer1M !== undefined &&\n        pricing.outputPer1M > selector.maxOutPer1M\n      ) {\n        return false\n      }\n      return true\n    }\n    case \"context\": {\n      if (!model) return false\n      const window = contextWindowOf(model)\n      return window !== undefined && window >= selector.min\n    }\n    default:\n      return model !== undefined && modelMatchesTarget(selector, model)\n  }\n}\n\n/** Exclusion is a negation: an explicit `model` target must also be able to\n *  remove an uncataloged `ids` pin, which no include selector can match. */\nfunction excludeMatches(\n  selector: ModelSelector,\n  model: ResolvedModel | undefined,\n  rawId: string,\n  src: ModelListSource,\n  stack: string[],\n): boolean {\n  if (\n    selector.kind === \"model\" &&\n    pinsMatch(selector.id, rawId)\n  ) {\n    return true\n  }\n  return selectorMatches(selector, model, rawId, src, stack)\n}\n\nfunction candidateIndex(): Map<string, ResolvedModel> {\n  if (candidateIndexCache) return candidateIndexCache\n  const index = new Map<string, ResolvedModel>()\n  for (const model of candidates()) index.set(model.id, model)\n  candidateIndexCache = index\n  return index\n}\n\n/**\n * Normalize a model id to the catalog spellings it may match. A trailing\n * `@<route>` is stripped; the registry and the route resolver get a chance;\n * and a bare id (`big-pickle`) also matches catalog ids whose last `/`\n * segment equals it (`opencode/big-pickle`).\n */\nfunction subjectIds(raw: string): string[] {\n  const cached = subjectIdsCache.get(raw)\n  if (cached) return cached\n  const stripped = stripRouteSuffix(raw)\n  const out = new Set<string>([raw, stripped])\n  const consider = (id: string): void => {\n    out.add(id)\n    const model = getModel(id)\n    if (model) {\n      out.add(model.id)\n      if (model.kind === \"llm\") out.add(model.canonicalId)\n    }\n    out.add(resolveAlias(id))\n    try {\n      const route = resolveLlmModelRoute(id)\n      if (route) {\n        out.add(formatModelRef(route.ref))\n        out.add(`${route.vendor}/${route.product}`)\n      }\n    } catch {\n      // Not a canonical `vendor/product` ref (e.g. an internal `~vendor/...`\n      // spelling). It can still match through `ids` or a bare-id key.\n    }\n  }\n  consider(stripped)\n  if (!stripped.includes(\"/\")) {\n    const bare = stripped.split(\":\")[0] ?? stripped\n    for (const model of candidates()) {\n      const segment = model.id.split(\"/\").pop()?.split(\":\")[0]\n      if (segment === bare) out.add(model.id)\n    }\n  }\n  const result = [...out]\n  subjectIdsCache.set(raw, result)\n  return result\n}\n\nfunction pinsMatch(pin: string, id: string): boolean {\n  if (pin === id) return true\n  const pinStripped = stripRouteSuffix(pin)\n  const idStripped = stripRouteSuffix(id)\n  return pin === idStripped || pinStripped === id || pinStripped === idStripped\n}\n\nfunction listContains(\n  list: ModelList,\n  rawId: string,\n  src: ModelListSource,\n  stack: string[],\n): boolean {\n  const index = candidateIndex()\n  const model = index.get(rawId) ?? index.get(stripRouteSuffix(rawId))\n  for (const selector of list.exclude ?? []) {\n    if (excludeMatches(selector, model, rawId, src, stack)) return false\n  }\n  if ((list.ids ?? []).some(pin => pinsMatch(pin, rawId))) return true\n  return (list.include ?? []).some(selector =>\n    selectorMatches(selector, model, rawId, src, stack),\n  )\n}\n\n/** Membership of ONE normalized id in a list (no subject expansion). */\nfunction inList(\n  listId: string,\n  rawId: string,\n  src: ModelListSource,\n  stack: string[],\n): boolean {\n  const list = src.get(listId)\n  if (!list) throw new ModelListError(`unknown model list \"${listId}\"`)\n  if (stack.includes(listId)) {\n    throw new ModelListError(\n      `model list cycle: ${[...stack, listId].join(\" -> \")}`,\n    )\n  }\n  return listContains(list, rawId, src, [...stack, listId])\n}\n\n/** Membership without full expansion; uncataloged ids match only via `ids`. */\nexport function inModelList(\n  model: string,\n  id: string,\n  src: ModelListSource,\n): boolean {\n  return subjectIds(model).some(candidate =>\n    inList(id, candidate, src, []),\n  )\n}\n\ninterface ResolvedEntry {\n  model: string\n  via: string\n}\n\nfunction insert(\n  entries: Map<string, ResolvedEntry>,\n  model: string,\n  via: string,\n): void {\n  if (!entries.has(model)) entries.set(model, { model, via })\n}\n\nfunction resolveEntries(\n  id: string,\n  src: ModelListSource,\n  stack: string[],\n): ResolvedEntry[] {\n  const list = src.get(id)\n  if (!list) throw new ModelListError(`unknown model list \"${id}\"`)\n  if (stack.includes(id)) {\n    throw new ModelListError(`model list cycle: ${[...stack, id].join(\" -> \")}`)\n  }\n  const nextStack = [...stack, id]\n  const entries = new Map<string, ResolvedEntry>()\n  const index = candidateIndex()\n  const all = candidates()\n\n  for (const selector of list.include ?? []) {\n    if (isListSelector(selector)) {\n      for (const entry of resolveEntries(selector.id, src, nextStack)) {\n        insert(entries, entry.model, `list:${selector.id}`)\n      }\n      continue\n    }\n    for (const model of all) {\n      if (selectorMatches(selector, model, model.id, src, nextStack)) {\n        insert(entries, model.id, selectorLabel(selector))\n      }\n    }\n  }\n  for (const pin of list.ids ?? []) insert(entries, pin, \"ids\")\n\n  for (const selector of list.exclude ?? []) {\n    if (isListSelector(selector)) {\n      for (const entry of resolveEntries(selector.id, src, nextStack)) {\n        entries.delete(entry.model)\n      }\n      continue\n    }\n    for (const model of all) {\n      if (selectorMatches(selector, model, model.id, src, nextStack)) {\n        entries.delete(model.id)\n      }\n    }\n    for (const key of [...entries.keys()]) {\n      if (excludeMatches(selector, index.get(key), key, src, nextStack)) {\n        entries.delete(key)\n      }\n    }\n  }\n\n  return [...entries.values()]\n}\n\nfunction applyOrder(\n  entries: ResolvedEntry[],\n  order: ModelList[\"order\"],\n  index: Map<string, ResolvedModel>,\n): ResolvedEntry[] {\n  if (!order || order === \"listed\" || entries.length === 0) return entries\n  const pricingOf = (entry: ResolvedEntry) => {\n    const model = index.get(entry.model)\n    return model?.kind === \"llm\" ? model.pricing : undefined\n  }\n  const sorted = [...entries]\n  sorted.sort((a, b) => {\n    const pa = pricingOf(a)\n    const pb = pricingOf(b)\n    if (order === \"cheapest\") {\n      const ca = pa ? pa.inputPer1M + pa.outputPer1M : Number.POSITIVE_INFINITY\n      const cb = pb ? pb.inputPer1M + pb.outputPer1M : Number.POSITIVE_INFINITY\n      return ca - cb\n    }\n    if (order === \"largest-context\") {\n      const ma = index.get(a.model)\n      const mb = index.get(b.model)\n      const ca = ma ? contextWindowOf(ma) ?? Number.NEGATIVE_INFINITY : Number.NEGATIVE_INFINITY\n      const cb = mb ? contextWindowOf(mb) ?? Number.NEGATIVE_INFINITY : Number.NEGATIVE_INFINITY\n      return cb - ca\n    }\n    // newest — a missing `addedAt` sorts last.\n    const aa = pa?.addedAt ?? \"\"\n    const ab = pb?.addedAt ?? \"\"\n    return aa === ab ? 0 : aa < ab ? 1 : -1\n  })\n  return sorted\n}\n\n/** Ordered, de-duplicated model ids. Throws ModelListError on unknown id or cycle. */\nexport function resolveModelList(id: string, src: ModelListSource): string[] {\n  const list = src.get(id)\n  if (!list) throw new ModelListError(`unknown model list \"${id}\"`)\n  const entries = resolveEntries(id, src, [])\n  return applyOrder(entries, list.order, candidateIndex()).map(\n    entry => entry.model,\n  )\n}\n\n/** Explain: per model, which selector or pin included it. */\nexport function explainModelList(\n  id: string,\n  src: ModelListSource,\n): Array<{ model: string; via: string }> {\n  const list = src.get(id)\n  if (!list) throw new ModelListError(`unknown model list \"${id}\"`)\n  const entries = resolveEntries(id, src, [])\n  return applyOrder(entries, list.order, candidateIndex()).map(entry => ({\n    model: entry.model,\n    via: entry.via,\n  }))\n}\n\n/** True iff the model is in a zero-priced list entry; re-exported for convenience. */\nexport { isZeroPriced }\n"]}

package/dist/llm/index.d.ts

@@ -1,4 +1,4 @@
-export { C as CacheStats, f as CalculateLLMCreditCostOptions, g as ContextWindowEntry, D as DEFAULT_PRICING, K as KnownLlmId, a as LLMCreditCostResult, L as LLMPricing, b as LLMPricingTier, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, h as LlmModelAlias, i as LlmModelId, M as MODEL_ALIASES, j as ModelRoute, e as calculateLLMCreditCost, k as getCacheStats, l as getModelProvider, m as isKnownLlmId, n as listNativeModelIds, o as listUnpricedKnownLlmIds, p as resolveAlias, q as resolveContextWindow, t as resolveModelRoute, r as resolvePricing, u as resolvePricingExact, s as selectPricingTier, v as splitContextWindowHint } from '../catalog-DRGEICKV.js';
+export { C as CacheStats, f as CalculateLLMCreditCostOptions, g as ContextWindowEntry, D as DEFAULT_PRICING, K as KnownLlmId, a as LLMCreditCostResult, L as LLMPricing, b as LLMPricingTier, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, h as LlmModelAlias, i as LlmModelId, M as MODEL_ALIASES, j as ModelRoute, e as calculateLLMCreditCost, k as getCacheStats, l as getModelProvider, m as isKnownLlmId, n as listNativeModelIds, o as listUnpricedKnownLlmIds, p as resolveAlias, q as resolveContextWindow, t as resolveModelRoute, r as resolvePricing, u as resolvePricingExact, s as selectPricingTier, v as splitContextWindowHint } from '../catalog-BB0uDJh-.js';
 export { D as DEFAULT_ANTHROPIC_MODEL, L as LLM_TIERS, a as LlmTierName, O as OPERATOR_AGENT_MODELS, b as OPERATOR_DEFAULT_GEMINI, c as OPERATOR_DEFAULT_PREMIUM, d as OPERATOR_DEFAULT_STANDARD, e as OperatorAgentModel, W as WORKFLOW_FAST_MODEL, f as WORKFLOW_PREMIUM_MODEL, g as WORKFLOW_TINY_MODEL } from '../defaults-BDkNRPK8.js';
 import '../base-BaiI72Da.js';
 import 'zod';

package/dist/llm/index.mjs

@@ -1,5 +1,5 @@
-export { DEFAULT_ANTHROPIC_MODEL, LLM_TIERS, OPERATOR_AGENT_MODELS, OPERATOR_DEFAULT_GEMINI, OPERATOR_DEFAULT_PREMIUM, OPERATOR_DEFAULT_STANDARD, WORKFLOW_FAST_MODEL, WORKFLOW_PREMIUM_MODEL, WORKFLOW_TINY_MODEL, formatTokens, listOpencodeAnthropicModelRefs, listOpencodeModelRefs } from '../chunk-UOOTUH6N.mjs';
-export { DEFAULT_PRICING, LLM_PRICING_CATALOG, MODEL_ALIASES, calculateLLMCreditCost, getCacheStats, getModelProvider, isKnownLlmId, listNativeModelIds, listUnpricedKnownLlmIds, resolveAlias, resolveContextWindow, resolveModelRoute, resolvePricing, resolvePricingExact, selectPricingTier, splitContextWindowHint } from '../chunk-TVXNRUJM.mjs';
+export { DEFAULT_ANTHROPIC_MODEL, LLM_TIERS, OPERATOR_AGENT_MODELS, OPERATOR_DEFAULT_GEMINI, OPERATOR_DEFAULT_PREMIUM, OPERATOR_DEFAULT_STANDARD, WORKFLOW_FAST_MODEL, WORKFLOW_PREMIUM_MODEL, WORKFLOW_TINY_MODEL, formatTokens, listOpencodeAnthropicModelRefs, listOpencodeModelRefs } from '../chunk-IHU6XTXS.mjs';
+export { DEFAULT_PRICING, LLM_PRICING_CATALOG, MODEL_ALIASES, calculateLLMCreditCost, getCacheStats, getModelProvider, isKnownLlmId, listNativeModelIds, listUnpricedKnownLlmIds, resolveAlias, resolveContextWindow, resolveModelRoute, resolvePricing, resolvePricingExact, selectPricingTier, splitContextWindowHint } from '../chunk-MZ23K5W6.mjs';
 import '../chunk-QHELXPSL.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/overlay/index.d.ts

@@ -1,4 +1,4 @@
-import { L as LLMPricing } from '../catalog-DRGEICKV.js';
+import { L as LLMPricing } from '../catalog-BB0uDJh-.js';
 import { ImageModelDefinition } from '../image/index.js';
 import { VideoModelDefinition } from '../video/index.js';
 import { AudioModelDefinition } from '../audio/index.js';

package/dist/picker/index.d.ts

@@ -1,11 +1,118 @@
-import '../evaluate-B-irutMW.js';
-import '../base-BaiI72Da.js';
-export { A as AvailableConnector, a as AvailableModel, b as AvailableModelCapabilities, c as AvailableModelsActor, d as AvailableModelsResponse, L as ListAvailableModelsParams, P as PRICE_TIER_NAMES, j as PRICE_TIER_SLOTS, k as priceTierBar, l as priceTierName } from '../index-kbLggJk1.js';
-import '../index-VuUTv1ft.js';
-import '../catalog-DRGEICKV.js';
+import { A as AccessDecision } from '../evaluate-BjSlZsJf.js';
+import { M as ModelKind } from '../base-BaiI72Da.js';
+import { M as ModelEnrichment } from '../index-DetGJJ-F.js';
+import '../index-D8FWHlom.js';
+import '../catalog-BB0uDJh-.js';
 import '../image/index.js';
 import '../video/index.js';
 import '../audio/index.js';
 import '../audio-Do2j3wDC.js';
 import 'zod';
 import '../schema/voice.js';
+import '../types-DMzMWJeJ.js';
+
+/**
+ * Picker subpath — wire shapes returned by the per-app
+ * `GET /models/available` route. Single source of truth shared by:
+ *   - the server-side helper (an app-side model-access helper)
+ *   - the per-app SDK clients (e.g. an app SDK client)
+ *   - the cross-app picker hook (an app picker hook)
+ *
+ * Without this single source the hook + SDK previously drifted from
+ * the API contract and a fetcher in the app silently kept calling
+ * with a stale auth pattern after the cookie-auth migration.
+ */
+
+interface AvailableModelCapabilities {
+    generate?: boolean;
+    edit?: boolean;
+    upscale?: boolean;
+    textToVideo?: boolean;
+    imageToVideo?: boolean;
+    audio?: boolean;
+    subjectReference?: boolean;
+    tts?: boolean;
+    stt?: boolean;
+    s2s?: boolean;
+}
+interface AvailableModel {
+    id: string;
+    /** Canonical model id (LLM aliases collapse here). */
+    canonicalId: string;
+    /**
+     * Priced model kind. Typed `ModelKind` (not `CatalogKind`) on purpose: the
+     * picker never surfaces `voice` rows as `AvailableModel` — voices reach the
+     * UI through a separate path — so `voice` is intentionally out of range here.
+     */
+    kind: ModelKind;
+    displayName: string;
+    description: string;
+    enrichment: ModelEnrichment;
+    decision: AccessDecision;
+    capabilities: AvailableModelCapabilities;
+    /** Recommended pricing display (per provider unit). */
+    pricingHint?: string;
+    /**
+     * Audio models only: cost normalized to **per minute of speech**, the
+     * intuitive unit for the voice picker. TTS (billed per 1k chars) is
+     * converted via an assumed speaking rate; per-minute models pass through.
+     */
+    voiceHint?: string;
+    /**
+     * Relative price gauge level (1..{@link PRICE_TIER_SLOTS}) from
+     * `priceTierForModel` — the visual "price mostly" indicator the picker
+     * renders as a segmented bar instead of a raw number. 0 when unknown.
+     */
+    priceTier?: number;
+    /** Localized-agnostic tier name for `priceTier` (e.g. `"High"`). */
+    priceTierName?: string;
+}
+interface AvailableConnector {
+    id: string;
+    name: string;
+    /** Whether the actor's guild/workspace has a connected credential for this provider. */
+    byokAvailable: boolean;
+    models: AvailableModel[];
+}
+/** Number of segments in the price gauge. */
+declare const PRICE_TIER_SLOTS = 5;
+/**
+ * Display names for levels 1..{@link PRICE_TIER_SLOTS}, ascending price. Kept
+ * as brand tokens (not localized) so the gauge reads the same everywhere.
+ */
+declare const PRICE_TIER_NAMES: readonly ["Low", "Medium", "High", "Max", "Ultra"];
+/** Name for a gauge level (1-based); empty string when out of range. */
+declare function priceTierName(level: number): string;
+/**
+ * Unicode price gauge (e.g. `▰▰▱▱▱`) for text-only surfaces (WhatsApp, logs).
+ * Rich UIs read {@link AvailableModel.priceTier} and render styled segments.
+ */
+declare function priceTierBar(level: number, slots?: number): string;
+interface AvailableModelsActor {
+    appId: string;
+    userId: string;
+    tier?: string;
+    guildId?: string;
+}
+interface AvailableModelsResponse {
+    success: true;
+    actor: AvailableModelsActor;
+    connectors: AvailableConnector[];
+}
+interface ListAvailableModelsParams {
+    /** Restrict to one or more kinds. Empty = all kinds. */
+    kind?: ModelKind | ModelKind[];
+    /** Guild scope — joins guild-level connectors for BYOK badges. */
+    guildId?: string;
+    /** Include rules-blocked models (decision.allowed=false). Default true. */
+    includeBlocked?: boolean;
+    /** Include catalog entries with agentVisible=false. Default false. */
+    includeHidden?: boolean;
+    /**
+     * Curation surface-profile id (`voice-s2s`, `images`, …) the app exposes.
+     * Resolved server-side via `getSurfaceProfile`. Omitted = full catalog.
+     */
+    surface?: string;
+}
+
+export { type AvailableConnector, type AvailableModel, type AvailableModelCapabilities, type AvailableModelsActor, type AvailableModelsResponse, type ListAvailableModelsParams, PRICE_TIER_NAMES, PRICE_TIER_SLOTS, priceTierBar, priceTierName };

package/dist/route-identity/index.d.ts

@@ -1,4 +1,4 @@
-import { L as LLMPricing } from '../catalog-DRGEICKV.js';
+import { L as LLMPricing } from '../catalog-BB0uDJh-.js';
 import '../base-BaiI72Da.js';
 import 'zod';
 

package/dist/route-identity/index.mjs

@@ -1,6 +1,6 @@
-export { InvalidModelRefError, OPENROUTER_VARIANTS, clearCustomRoutes, diagnoseModelRef, formatModelRef, isModelRefString, listRouterLlmRoutes, parseModelRef, registerCustomRoute, resolveCustomRoute, resolveLlmModelRoute, stripAnthropicNativeVendor, stripFixedNativeVendor, stripRouteSuffix, tryParseModelRef } from '../chunk-ALUIW3QO.mjs';
+export { InvalidModelRefError, OPENROUTER_VARIANTS, clearCustomRoutes, diagnoseModelRef, formatModelRef, isModelRefString, listRouterLlmRoutes, parseModelRef, registerCustomRoute, resolveCustomRoute, resolveLlmModelRoute, stripAnthropicNativeVendor, stripFixedNativeVendor, stripRouteSuffix, tryParseModelRef } from '../chunk-BXTZ2EDE.mjs';
 import '../chunk-WG4F6IRS.mjs';
-import '../chunk-TVXNRUJM.mjs';
+import '../chunk-MZ23K5W6.mjs';
 import '../chunk-QHELXPSL.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/types-DMzMWJeJ.d.ts

@@ -0,0 +1,50 @@
+import { M as ModelKind } from './base-BaiI72Da.js';
+
+/**
+ * Access control types — workspace-override rules + app scope.
+ *
+ * v1 ships the evaluator + types; the DB-backed `model_access_rules`
+ * table follows in v2 (the MCP gen layer reads rows and threads them
+ * through `evaluateAccess` per workspace).
+ */
+
+type AccessEffect = "allow" | "block";
+type AccessTarget = {
+    kind: "model";
+    id: string;
+} | {
+    kind: "tag";
+    value: string;
+} | {
+    kind: "provider";
+    value: string;
+}
+/**
+ * `kind: "priceTier"` is the persisted DB discriminator string for
+ * catalog-price-tier targets (`low | mid | high | premium`). The
+ * conceptual name is `catalogPriceTier`; the literal stays `priceTier`
+ * to avoid breaking existing rows in `*_model_access_rules` tables.
+ */
+ | {
+    kind: "priceTier";
+    value: "low" | "mid" | "high" | "premium";
+} | {
+    kind: "kind";
+    value: ModelKind;
+};
+interface AccessRule {
+    effect: AccessEffect;
+    target: AccessTarget;
+    /** Audit reason; surfaced in decision.reason. */
+    reason?: string;
+}
+/**
+ * Per-product opt-in: the app declares which kinds it surfaces. Lets
+ * one app hide LLMs, another hide video, etc. Empty `kinds` means the app
+ * does not constrain by kind (admin / catalog-browser scope).
+ */
+interface AppScope {
+    kinds: ModelKind[];
+}
+
+export type { AccessTarget as A, AppScope as a, AccessRule as b, AccessEffect as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/model-catalog",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Unified, dependency-light model catalog: LLM, image, video, audio entries + cost dispatcher + picker. Zod-only; the OSS core that @agstudio/model-catalog layers billing/access/BYOK on top of.",
   "keywords": [
     "agentproto",
@@ -102,6 +102,11 @@
       "import": "./dist/access/index.mjs",
       "default": "./dist/access/index.mjs"
     },
+    "./lists": {
+      "types": "./dist/lists/index.d.ts",
+      "import": "./dist/lists/index.mjs",
+      "default": "./dist/lists/index.mjs"
+    },
     "./picker": {
       "types": "./dist/picker/index.d.ts",
       "import": "./dist/picker/index.mjs",
@@ -126,8 +131,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^3.2.7",
-    "@agentproto/provider-presets": "0.7.1",
-    "@agentproto/tooling": "0.1.0"
+    "@agentproto/tooling": "0.1.0",
+    "@agentproto/provider-presets": "0.7.2"
   },
   "engines": {
     "node": ">=20.9.0"