@agentproto/model-catalog 0.13.2 → 0.14.1

package/dist/cost/index.mjs

@@ -1,11 +1,11 @@
-export { CostUsageKindMismatchError, UnknownModelError, calculateAudioCost, calculateCost, calculateImageCost, calculateLLMCost, calculateVideoCost } from '../chunk-5GIH3O6I.mjs';
-import '../chunk-2P2R2XLK.mjs';
-import '../chunk-P5PQS3SJ.mjs';
-import '../chunk-PKFRG2DA.mjs';
+export { CostUsageKindMismatchError, UnknownModelError, calculateAudioCost, calculateCost, calculateImageCost, calculateLLMCost, calculateVideoCost } from '../chunk-UWURA235.mjs';
+import '../chunk-562U2L7T.mjs';
 import '../chunk-H6JUTF3U.mjs';
+import '../chunk-BQDTFJ4J.mjs';
+import '../chunk-F4BUE3N6.mjs';
 import '../chunk-WG4F6IRS.mjs';
-import '../chunk-FPTLINCV.mjs';
-import '../chunk-5E34CLTH.mjs';
+import '../chunk-7CTQGUR2.mjs';
+import '../chunk-Y2REI5QQ.mjs';
 import '../chunk-QHELXPSL.mjs';
 import '../chunk-2LWYZOWB.mjs';
 import '../chunk-IJZ4XPO2.mjs';

package/dist/curation/index.d.ts

@@ -1,6 +1,6 @@
-import { C as CatalogKind, R as ResolvedModel } from '../index-BZlWH9br.js';
+import { C as CatalogKind, R as ResolvedModel } from '../index-BvzrCBss.js';
 import { CatalogVoice } from '../schema/voice.js';
-import '../catalog-DLa4soLN.js';
+import '../catalog-B2eRnrWD.js';
 import '../base-BaiI72Da.js';
 import 'zod';
 import '../image/index.js';

package/dist/curation/index.mjs

@@ -1,11 +1,11 @@
-export { applyProfile, expandProviders, filterVoicesByProviders, getProviderGroup, getSurfaceProfile, groupForProvider, listProviderGroups, listSurfaceProfiles, listSurfaced, modelMatchesProfile } from '../chunk-ORWNAAFP.mjs';
-import '../chunk-2P2R2XLK.mjs';
-import '../chunk-P5PQS3SJ.mjs';
-import '../chunk-PKFRG2DA.mjs';
+export { applyProfile, expandProviders, filterVoicesByProviders, getProviderGroup, getSurfaceProfile, groupForProvider, listProviderGroups, listSurfaceProfiles, listSurfaced, modelMatchesProfile } from '../chunk-HUNAWSDP.mjs';
+import '../chunk-562U2L7T.mjs';
 import '../chunk-H6JUTF3U.mjs';
+import '../chunk-BQDTFJ4J.mjs';
+import '../chunk-F4BUE3N6.mjs';
 import '../chunk-WG4F6IRS.mjs';
-import '../chunk-FPTLINCV.mjs';
-import '../chunk-5E34CLTH.mjs';
+import '../chunk-7CTQGUR2.mjs';
+import '../chunk-Y2REI5QQ.mjs';
 import '../chunk-QHELXPSL.mjs';
 import '../chunk-2LWYZOWB.mjs';
 import '../chunk-IJZ4XPO2.mjs';

package/dist/evaluate-CYQHJ4Jk.d.ts

@@ -0,0 +1,49 @@
+import { R as ResolvedModel } from './index-BvzrCBss.js';
+import { a as AppScope, b as AccessRule, A as AccessTarget } from './types-DMzMWJeJ.js';
+
+/**
+ * Access evaluator — resolves whether a workspace can use a given model.
+ *
+ * Resolution order:
+ *   1. App scope — if the app opts out of the model's kind, deny.
+ *   2. Workspace explicit `model:<id>` rule — terminal allow or block.
+ *   3. Workspace tag / provider / priceTier / kind rules — most-specific
+ *      band wins. Within a band, block wins. Specificity ladder:
+ *        tag (4) > provider (3) > priceTier (2) > kind (1).
+ *      Rationale: an explicit `allow tag:image:generate` should beat a
+ *      blanket `block kind:llm`. The tag rule is the more specific
+ *      intent and reflects the operator's allowlist.
+ *   4. Catalog defaults — `lifecycle=stable && agentVisible=true` → allow.
+ *
+ * BYOK relaxation: when `byokActive`, `priceTier=premium` blocks are
+ * bypassed (BYOK users pay providers directly). NSFW / compliance
+ * blocks NEVER bypass.
+ */
+
+interface AccessEvalInput {
+    model: ResolvedModel;
+    appScope?: AppScope;
+    /** Workspace overrides; v1 callers pass `[]`. */
+    rules?: AccessRule[];
+    byokActive?: boolean;
+}
+interface AccessDecision {
+    allowed: boolean;
+    /** Stable token for logs/metrics. */
+    reason: string;
+}
+/**
+ * Returns true iff the target matches the resolved model.
+ *
+ * Tag and priceTier matching go through the enrichment layer
+ * (`@agentproto/model-catalog/enrichment`) — explicit per-model
+ * enrichment wins, heuristic fallback fills the rest.
+ *
+ * Exported as `modelMatchesTarget` so the model-list selector vocabulary can
+ * reuse the exact same matching semantics; `AccessTarget`, `AccessRule` and
+ * `evaluateAccess` stay unchanged.
+ */
+declare function modelMatchesTarget(target: AccessTarget, model: ResolvedModel): boolean;
+declare function evaluateAccess(input: AccessEvalInput): AccessDecision;
+
+export { type AccessDecision as A, type AccessEvalInput as a, evaluateAccess as e, modelMatchesTarget as m };

package/dist/{index-BZlWH9br.d.ts → index-BvzrCBss.d.ts}

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

package/dist/index-Ipv-RcfT.d.ts

@@ -0,0 +1,78 @@
+import { C as CatalogPriceTier, L as Lifecycle, M as ModelKind } from './base-BaiI72Da.js';
+import { R as ResolvedModel } from './index-BvzrCBss.js';
+
+/**
+ * Model enrichment — `catalogPriceTier` / `tags` / `lifecycle` / `actions`
+ * per model id.
+ *
+ * Bridge between the legacy data shape (`ImageModelDefinition`,
+ * `VideoModelDefinition`, `LLMPricing`) and the v2 access-rule
+ * primitives that target by tier, tag, and action. Without this, rules
+ * like `priceTier:premium` and `tag:nsfw` would never match anything.
+ *
+ * Two layers:
+ *   1. Explicit map for the curated set we know about (overrides win).
+ *   2. Heuristic inference for any model not in the explicit map
+ *      (catalogPriceTier from creditCost / token rates; tags from kind +
+ *      provider).
+ *
+ * Actions (`<kind>:<verb>` — e.g. `image:generate`, `llm:tool_use`) are
+ * computed from per-kind capability objects via `getActions` and merged
+ * into `tags` so existing tag-based access rules match action targets
+ * without any evaluator change. The reserved `<kind>:` prefix is enforced
+ * by `assertReservedPrefixDiscipline` at module load — free-form curation
+ * tags must NOT use it.
+ *
+ * Add an entry to `EXPLICIT_ENRICHMENT` when you want exact control;
+ * skip it when defaults are good enough.
+ */
+
+interface ModelEnrichment {
+    catalogPriceTier: CatalogPriceTier;
+    /** Curation tags + action tags (`<kind>:<verb>`) merged. */
+    tags: readonly string[];
+    lifecycle: Lifecycle;
+    /** Action tags only — convenience subset of `tags`. */
+    actions: readonly string[];
+}
+/** The one zero-price rule: both base token prices are exactly 0 and every
+ *  prompt-length tier is also 0/0. A tiered model whose base is free but whose
+ *  long-prompt tier bills is NOT zero-priced. */
+declare function isZeroPriced(pricing: {
+    inputPer1M: number;
+    outputPer1M: number;
+    tiers?: readonly {
+        aboveInputTokens?: number;
+        inputPer1M: number;
+        outputPer1M: number;
+    }[];
+}): boolean;
+/**
+ * Display price gauge level (1..5) for a model — the **visual** "price
+ * mostly" indicator (Low / Medium / High / Max / Ultra) the pickers and the
+ * estimator render as a bar. Distinct from {@link inferCatalogPriceTier}:
+ * that one drives 4-value *access* rules (`priceTier:premium`) and must stay a
+ * `CatalogPriceTier`; this is cosmetic and free to span 5 bands. Both bucket
+ * the same provider USD cost, so they move together by construction.
+ */
+declare function priceTierForModel(model: ResolvedModel): number;
+/**
+ * Resolve enrichment for any model. Explicit map wins; heuristic fallback
+ * fills the rest. Action tags (`<kind>:<verb>`) are derived from the
+ * model's capability fields and merged into `tags`. Always returns a
+ * value (never undefined).
+ */
+declare function getEnrichment(model: ResolvedModel): ModelEnrichment;
+declare function modelHasTag(model: ResolvedModel, tag: string): boolean;
+declare function modelHasAction(model: ResolvedModel, action: string): boolean;
+declare function modelMatchesCatalogPriceTier(model: ResolvedModel, tier: CatalogPriceTier): boolean;
+/**
+ * @deprecated Use `modelMatchesCatalogPriceTier`. Kept for back-compat
+ * with the v1 evaluator's switch case which still uses the
+ * `priceTier` discriminator string. The function itself routes to the
+ * canonical name.
+ */
+declare function modelMatchesPriceTier(model: ResolvedModel, tier: CatalogPriceTier): boolean;
+declare function modelMatchesKind(model: ResolvedModel, kind: ModelKind): boolean;
+
+export { type ModelEnrichment as M, modelHasTag as a, modelMatchesCatalogPriceTier as b, modelMatchesKind as c, modelMatchesPriceTier as d, getEnrichment as g, isZeroPriced as i, modelHasAction as m, priceTierForModel as p };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { ImageAspectRatio, ImageAspectRatioSchema, ImageCapabilities, ImageCapabilitiesSchema, ImageEntry, ImageEntrySchema, ImagePricing, ImagePricingSchema, ImageReferenceImages, ImageReferenceImagesSchema, LLMEntry, LLMEntrySchema, LlmPricing, LlmPricingSchema, ModelEntry, ModelEntrySchema, VideoCapabilities, VideoCapabilitiesSchema, VideoCostMultipliers, VideoCostMultipliersSchema, VideoEntry, VideoEntrySchema, VideoPricing, VideoPricingSchema, VideoResolution, VideoResolutionSchema } from './schema/index.js';
-export { D as DEFAULT_PRICING, a as LLMCreditCostResult, L as LLMPricing, b as LLMPricingTier, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, M as MODEL_ALIASES, e as calculateLLMCreditCost, r as resolvePricing, s as selectPricingTier } from './catalog-DLa4soLN.js';
+export { D as DEFAULT_PRICING, a as LLMCreditCostResult, L as LLMPricing, b as LLMPricingTier, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, M as MODEL_ALIASES, e as calculateLLMCreditCost, r as resolvePricing, s as selectPricingTier } from './catalog-B2eRnrWD.js';
 export { D as DEFAULT_ANTHROPIC_MODEL } from './defaults-BDkNRPK8.js';
 export { AGENT_EDITABLE_MODEL_IDS, AGENT_GENERATIVE_MODEL_IDS, AGENT_IMAGE_MODEL_IDS, IMAGE_MODEL_CATALOG, IMAGE_MODEL_IDS, ImageModelDefinition, generateImageModelTable } from './image/index.js';
 export { AGENT_VIDEO_MODEL_IDS, VIDEO_MODEL_CATALOG, VIDEO_MODEL_IDS, VideoModelDefinition, generateVideoModelTable } from './video/index.js';
@@ -10,12 +10,14 @@ export { ProviderGroup, SurfaceProfile, applyProfile, expandProviders, filterVoi
 export { CC_USD_RATE, CREDIT_USD_RATE, DEFAULT_PRICING_FLOORS, DEFAULT_PRICING_MARKUP, PricingCategory, PricingMarkup, computeCenticredits, pricingRegistry } from './pricing/index.js';
 export { CalculateCostOptions, CostResult, CostUsage, CostUsageKindMismatchError, UnknownModelError, calculateAudioCost, calculateCost, calculateImageCost, calculateLLMCost, calculateVideoCost } from './cost/index.js';
 export { ShouldDebitDecision, ShouldDebitInput, shouldDebit } from './byok/index.js';
-export { A as AccessDecision, a as AccessEffect, b as AccessEvalInput, c as AccessRule, d as AccessTarget, e as AppScope, f as evaluateAccess } from './evaluate-DYz38I9t.js';
+export { A as AccessDecision, a as AccessEvalInput, e as evaluateAccess, m as modelMatchesTarget } from './evaluate-CYQHJ4Jk.js';
 export { CatalogDefaultDecision, evaluateCatalogDefaults } from './access/index.js';
+export { c as AccessEffect, b as AccessRule, A as AccessTarget, a as AppScope } from './types-DMzMWJeJ.js';
 export { CatalogOverlay, MergedOverlay, clearCatalogOverlays, getMergedOverlay, registerCatalogOverlay } from './overlay/index.js';
-import { R as ResolvedModel } from './index-BZlWH9br.js';
-export { C as CatalogKind, L as ListModelsFilter, g as getModel, a as getModelsByProvider, b as getStaticModelProvider, i as isAgentVisible, l as listModels, r as resolveAlias } from './index-BZlWH9br.js';
-export { A as AvailableConnector, a as AvailableModel, b as AvailableModelCapabilities, c as AvailableModelsActor, d as AvailableModelsResponse, L as ListAvailableModelsParams, M as ModelEnrichment, g as getEnrichment, m as modelHasAction, e as modelHasTag, f as modelMatchesCatalogPriceTier, h as modelMatchesKind, i as modelMatchesPriceTier, p as priceTierForModel } from './index-CwIGbZai.js';
+import { R as ResolvedModel } from './index-BvzrCBss.js';
+export { C as CatalogKind, L as ListModelsFilter, g as getModel, a as getModelsByProvider, b as getStaticModelProvider, i as isAgentVisible, l as listModels, r as resolveAlias } from './index-BvzrCBss.js';
+export { M as ModelEnrichment, g as getEnrichment, i as isZeroPriced, m as modelHasAction, a as modelHasTag, b as modelMatchesCatalogPriceTier, c as modelMatchesKind, d as modelMatchesPriceTier, p as priceTierForModel } from './index-Ipv-RcfT.js';
+export { AvailableConnector, AvailableModel, AvailableModelCapabilities, AvailableModelsActor, AvailableModelsResponse, ListAvailableModelsParams } from './picker/index.js';
 export { A as AudioCapabilities, a as AudioCapabilitiesSchema, b as AudioEntry, c as AudioEntrySchema, d as AudioPricing, e as AudioPricingSchema } from './audio-Do2j3wDC.js';
 export { C as CatalogPriceTier, a as CatalogPriceTierSchema, b as CatalogProvider, c as CatalogProviderSchema, L as Lifecycle, d as LifecycleSchema, M as ModelKind, e as ModelKindSchema, N as NsfwPolicy, f as NsfwPolicySchema, P as PROVIDER_KEY_ENV, g as PROVIDER_KEY_ENV_ALIASES, h as baseEntryShape } from './base-BaiI72Da.js';
 import 'zod';

package/dist/index.mjs

@@ -1,17 +1,18 @@
-export { applyProfile, expandProviders, filterVoicesByProviders, getProviderGroup, getSurfaceProfile, groupForProvider, listProviderGroups, listSurfaceProfiles, listSurfaced, modelMatchesProfile } from './chunk-ORWNAAFP.mjs';
-export { CostUsageKindMismatchError, UnknownModelError, calculateAudioCost, calculateCost, calculateImageCost, calculateLLMCost, calculateVideoCost } from './chunk-5GIH3O6I.mjs';
-import { getModel } from './chunk-2P2R2XLK.mjs';
-export { getModel, getModelsByProvider, getStaticModelProvider, isAgentVisible, listModels, resolveAlias } from './chunk-2P2R2XLK.mjs';
-import './chunk-P5PQS3SJ.mjs';
+export { applyProfile, expandProviders, filterVoicesByProviders, getProviderGroup, getSurfaceProfile, groupForProvider, listProviderGroups, listSurfaceProfiles, listSurfaced, modelMatchesProfile } from './chunk-HUNAWSDP.mjs';
+export { CostUsageKindMismatchError, UnknownModelError, calculateAudioCost, calculateCost, calculateImageCost, calculateLLMCost, calculateVideoCost } from './chunk-UWURA235.mjs';
 export { shouldDebit } from './chunk-XFDXTFV3.mjs';
-export { evaluateAccess, evaluateCatalogDefaults } from './chunk-POKSD3S3.mjs';
-import { priceTierForModel } from './chunk-PKFRG2DA.mjs';
-export { assertReservedPrefixDiscipline, getActions, getEnrichment, isActionTag, modelHasAction, modelHasTag, modelMatchesCatalogPriceTier, modelMatchesKind, modelMatchesPriceTier, priceTierForModel } from './chunk-PKFRG2DA.mjs';
+import './chunk-HFPX2DNR.mjs';
+import { getModel } from './chunk-562U2L7T.mjs';
+export { getModel, getModelsByProvider, getStaticModelProvider, isAgentVisible, listModels, resolveAlias } from './chunk-562U2L7T.mjs';
 export { clearCatalogOverlays, getMergedOverlay, registerCatalogOverlay } from './chunk-H6JUTF3U.mjs';
+import './chunk-BQDTFJ4J.mjs';
+export { evaluateAccess, evaluateCatalogDefaults, modelMatchesTarget } from './chunk-5LO27OWU.mjs';
+import { priceTierForModel } from './chunk-F4BUE3N6.mjs';
+export { assertReservedPrefixDiscipline, getActions, getEnrichment, isActionTag, isZeroPriced, modelHasAction, modelHasTag, modelMatchesCatalogPriceTier, modelMatchesKind, modelMatchesPriceTier, priceTierForModel } from './chunk-F4BUE3N6.mjs';
 export { AudioCapabilitiesSchema, AudioEntrySchema, AudioPricingSchema, ImageAspectRatioSchema, ImageCapabilitiesSchema, ImageEntrySchema, ImagePricingSchema, ImageReferenceImagesSchema, LLMEntrySchema, LlmPricingSchema, ModelEntrySchema, VideoCapabilitiesSchema, VideoCostMultipliersSchema, VideoEntrySchema, VideoPricingSchema, VideoResolutionSchema } from './chunk-7U7XGVHP.mjs';
 export { CatalogPriceTierSchema, CatalogProviderSchema, LifecycleSchema, ModelKindSchema, NsfwPolicySchema, PROVIDER_KEY_ENV, PROVIDER_KEY_ENV_ALIASES, baseEntryShape } from './chunk-WG4F6IRS.mjs';
-export { DEFAULT_ANTHROPIC_MODEL } from './chunk-FPTLINCV.mjs';
-export { DEFAULT_PRICING, LLM_PRICING_CATALOG, MODEL_ALIASES, calculateLLMCreditCost, resolvePricing, selectPricingTier } from './chunk-5E34CLTH.mjs';
+export { DEFAULT_ANTHROPIC_MODEL } from './chunk-7CTQGUR2.mjs';
+export { DEFAULT_PRICING, LLM_PRICING_CATALOG, MODEL_ALIASES, calculateLLMCreditCost, resolvePricing, selectPricingTier } from './chunk-Y2REI5QQ.mjs';
 export { CC_USD_RATE, CREDIT_USD_RATE, DEFAULT_PRICING_FLOORS, DEFAULT_PRICING_MARKUP, computeCenticredits, pricingRegistry } from './chunk-QHELXPSL.mjs';
 export { AGENT_EDITABLE_MODEL_IDS, AGENT_GENERATIVE_MODEL_IDS, AGENT_IMAGE_MODEL_IDS, IMAGE_MODEL_CATALOG, IMAGE_MODEL_IDS, generateImageModelTable } from './chunk-2LWYZOWB.mjs';
 export { AGENT_VIDEO_MODEL_IDS, VIDEO_MODEL_CATALOG, VIDEO_MODEL_IDS, generateVideoModelTable } from './chunk-IJZ4XPO2.mjs';

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEO,SAAS,oBAAoB,EAAA,EAAoB;AACtD,EAAA,MAAM,KAAA,GAAQ,SAAS,EAAE,CAAA;AACzB,EAAA,OAAO,KAAA,GAAQ,iBAAA,CAA0B,KAAK,CAAA,GAAI,CAAA;AACpD","file":"index.mjs","sourcesContent":["/**\n * @agentproto/model-catalog — unified model catalog.\n *\n * Single source of truth for LLM, image, video, audio, and voice model\n * entries. Owns cost dispatch, BYOK policy, and access control evaluation.\n * Zod-only OSS core; @agentproto/model-catalog layers billing/access/BYOK\n * policy on top.\n *\n * Subpath imports for tree-shaking:\n *   import { LLM_PRICING_CATALOG } from \"@agentproto/model-catalog/llm\"\n *   import { calculateCost } from \"@agentproto/model-catalog/cost\"\n *   import { shouldDebit } from \"@agentproto/model-catalog/byok\"\n *   import { evaluateAccess } from \"@agentproto/model-catalog/access\"\n *   import { VOICE_CATALOG } from \"@agentproto/model-catalog/voice\"\n *   import { listSurfaced } from \"@agentproto/model-catalog/curation\"\n */\n\nexport * from \"./schema/index.js\"\n// LLM has its own `resolveAlias` (legacy back-compat for the app legacy pricing module).\n// At the top level we prefer the cross-kind `resolveAlias` from the registry.\nexport {\n  LLM_PRICING_CATALOG,\n  MODEL_ALIASES,\n  DEFAULT_PRICING,\n  DEFAULT_ANTHROPIC_MODEL,\n  resolvePricing,\n  calculateLLMCreditCost,\n  selectPricingTier,\n} from \"./llm/index.js\"\nexport type {\n  LLMPricing,\n  LLMPricingTier,\n  LLMUsageBreakdown,\n  LLMCreditCostResult,\n} from \"./llm/index.js\"\nexport * from \"./image/index.js\"\nexport * from \"./video/index.js\"\nexport * from \"./audio/index.js\"\nexport * from \"./voice/index.js\"\nexport * from \"./curation/index.js\"\nexport * from \"./pricing/index.js\"\nexport * from \"./cost/index.js\"\nexport * from \"./byok/index.js\"\nexport * from \"./access/index.js\"\nexport * from \"./overlay/index.js\"\nexport * from \"./registry/index.js\"\nexport {\n  getActions,\n  isActionTag,\n  assertReservedPrefixDiscipline,\n} from \"./registry/actions.js\"\nexport {\n  getEnrichment,\n  modelHasTag,\n  modelHasAction,\n  modelMatchesCatalogPriceTier,\n  modelMatchesPriceTier,\n  modelMatchesKind,\n  priceTierForModel,\n  type ModelEnrichment,\n} from \"./enrichment/index.js\"\n\nimport { getModel } from \"./registry/index.js\"\nimport { priceTierForModel as priceTierForModelInternal } from \"./enrichment/index.js\"\n\n/**\n * Display price gauge level (1..5) for a model id — resolves the catalog\n * entry then defers to {@link priceTierForModel}. 0 for an unknown id.\n * The id→level convenience used by the WhatsApp / slash pickers, which carry\n * a model id rather than a resolved model.\n */\nexport function priceTierForModelId(id: string): number {\n  const model = getModel(id)\n  return model ? priceTierForModelInternal(model) : 0\n}\nexport type {\n  AvailableModel,\n  AvailableModelCapabilities,\n  AvailableConnector,\n  AvailableModelsActor,\n  AvailableModelsResponse,\n  ListAvailableModelsParams,\n} from \"./picker/index.js\"\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEO,SAAS,oBAAoB,EAAA,EAAoB;AACtD,EAAA,MAAM,KAAA,GAAQ,SAAS,EAAE,CAAA;AACzB,EAAA,OAAO,KAAA,GAAQ,iBAAA,CAA0B,KAAK,CAAA,GAAI,CAAA;AACpD","file":"index.mjs","sourcesContent":["/**\n * @agentproto/model-catalog — unified model catalog.\n *\n * Single source of truth for LLM, image, video, audio, and voice model\n * entries. Owns cost dispatch, BYOK policy, and access control evaluation.\n * Zod-only OSS core; @agentproto/model-catalog layers billing/access/BYOK\n * policy on top.\n *\n * Subpath imports for tree-shaking:\n *   import { LLM_PRICING_CATALOG } from \"@agentproto/model-catalog/llm\"\n *   import { calculateCost } from \"@agentproto/model-catalog/cost\"\n *   import { shouldDebit } from \"@agentproto/model-catalog/byok\"\n *   import { evaluateAccess } from \"@agentproto/model-catalog/access\"\n *   import { VOICE_CATALOG } from \"@agentproto/model-catalog/voice\"\n *   import { listSurfaced } from \"@agentproto/model-catalog/curation\"\n */\n\nexport * from \"./schema/index.js\"\n// LLM has its own `resolveAlias` (legacy back-compat for the app legacy pricing module).\n// At the top level we prefer the cross-kind `resolveAlias` from the registry.\nexport {\n  LLM_PRICING_CATALOG,\n  MODEL_ALIASES,\n  DEFAULT_PRICING,\n  DEFAULT_ANTHROPIC_MODEL,\n  resolvePricing,\n  calculateLLMCreditCost,\n  selectPricingTier,\n} from \"./llm/index.js\"\nexport type {\n  LLMPricing,\n  LLMPricingTier,\n  LLMUsageBreakdown,\n  LLMCreditCostResult,\n} from \"./llm/index.js\"\nexport * from \"./image/index.js\"\nexport * from \"./video/index.js\"\nexport * from \"./audio/index.js\"\nexport * from \"./voice/index.js\"\nexport * from \"./curation/index.js\"\nexport * from \"./pricing/index.js\"\nexport * from \"./cost/index.js\"\nexport * from \"./byok/index.js\"\nexport * from \"./access/index.js\"\nexport * from \"./overlay/index.js\"\nexport * from \"./registry/index.js\"\nexport {\n  getActions,\n  isActionTag,\n  assertReservedPrefixDiscipline,\n} from \"./registry/actions.js\"\nexport {\n  getEnrichment,\n  isZeroPriced,\n  modelHasTag,\n  modelHasAction,\n  modelMatchesCatalogPriceTier,\n  modelMatchesPriceTier,\n  modelMatchesKind,\n  priceTierForModel,\n  type ModelEnrichment,\n} from \"./enrichment/index.js\"\n\nimport { getModel } from \"./registry/index.js\"\nimport { priceTierForModel as priceTierForModelInternal } from \"./enrichment/index.js\"\n\n/**\n * Display price gauge level (1..5) for a model id — resolves the catalog\n * entry then defers to {@link priceTierForModel}. 0 for an unknown id.\n * The id→level convenience used by the WhatsApp / slash pickers, which carry\n * a model id rather than a resolved model.\n */\nexport function priceTierForModelId(id: string): number {\n  const model = getModel(id)\n  return model ? priceTierForModelInternal(model) : 0\n}\nexport type {\n  AvailableModel,\n  AvailableModelCapabilities,\n  AvailableConnector,\n  AvailableModelsActor,\n  AvailableModelsResponse,\n  ListAvailableModelsParams,\n} from \"./picker/index.js\"\n"]}

package/dist/lists/index.d.ts

@@ -0,0 +1,70 @@
+import { A as AccessTarget } from '../types-DMzMWJeJ.js';
+export { i as isZeroPriced } from '../index-Ipv-RcfT.js';
+import '../base-BaiI72Da.js';
+import 'zod';
+import '../index-BvzrCBss.js';
+import '../catalog-B2eRnrWD.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-562U2L7T.mjs';
+import '../chunk-H6JUTF3U.mjs';
+import { stripRouteSuffix, resolveLlmModelRoute, formatModelRef, listRouterLlmRoutes, tryParseModelRef } from '../chunk-BQDTFJ4J.mjs';
+import { modelMatchesTarget } from '../chunk-5LO27OWU.mjs';
+export { isZeroPriced } from '../chunk-F4BUE3N6.mjs';
+import '../chunk-WG4F6IRS.mjs';
+import '../chunk-7CTQGUR2.mjs';
+import { resolveContextWindow } from '../chunk-Y2REI5QQ.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