@agentproto/model-catalog 0.2.0 → 0.3.0

package/dist/{evaluate-DisH3H7u.d.ts → evaluate-BWuQauRR.d.ts}

@@ -1,5 +1,5 @@
-import { R as ResolvedModel } from './index-BICjPG8H.js';
-import { M as ModelKind } from './base-BNHcMifc.js';
+import { R as ResolvedModel } from './index-DL-GcOAF.js';
+import { M as ModelKind } from './base-BJo3zO1J.js';
 
 /**
  * Access control types — workspace-override rules + app scope.

package/dist/{index-D8nL3fPZ.d.ts → index-BgW4RQUV.d.ts}

@@ -1,6 +1,6 @@
-import { A as AccessDecision } from './evaluate-DisH3H7u.js';
-import { a as CatalogPriceTier, L as Lifecycle, M as ModelKind } from './base-BNHcMifc.js';
-import { R as ResolvedModel } from './index-BICjPG8H.js';
+import { A as AccessDecision } from './evaluate-BWuQauRR.js';
+import { a as CatalogPriceTier, L as Lifecycle, M as ModelKind } from './base-BJo3zO1J.js';
+import { R as ResolvedModel } from './index-DL-GcOAF.js';
 
 /**
  * Model enrichment — `catalogPriceTier` / `tags` / `lifecycle` / `actions`

package/dist/{index-BICjPG8H.d.ts → index-DL-GcOAF.d.ts}

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

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, L as LLMCreditCostResult, b as LLMPricing, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, M as MODEL_ALIASES, h as calculateLLMCreditCost, l as resolvePricing } from './catalog-aQHd559b.js';
+export { D as DEFAULT_PRICING, L as LLMCreditCostResult, b as LLMPricing, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, M as MODEL_ALIASES, h as calculateLLMCreditCost, l as resolvePricing } from './catalog-BXCENAMh.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';
 export { AGENT_AUDIO_MODEL_IDS, AGENT_STT_MODEL_IDS, AGENT_TTS_MODEL_IDS, AUDIO_MODEL_CATALOG, AUDIO_MODEL_IDS, AudioBillingUnit, AudioModality, AudioModelDefinition, AudioProvider, DEFAULT_GEMINI_LIVE_MODEL, GEMINI_LIVE_MODEL_IDS, S2S_MODEL_IDS, generateAudioModelTable, isAcceptedGeminiLiveModel } from './audio/index.js';
@@ -9,14 +9,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-DisH3H7u.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-BWuQauRR.js';
 export { CatalogDefaultDecision, evaluateCatalogDefaults } from './access/index.js';
 export { CatalogOverlay, MergedOverlay, clearCatalogOverlays, getMergedOverlay, registerCatalogOverlay } from './overlay/index.js';
-import { R as ResolvedModel } from './index-BICjPG8H.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-BICjPG8H.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-D8nL3fPZ.js';
-export { A as AudioCapabilities, a as AudioCapabilitiesSchema, b as AudioEntry, c as AudioEntrySchema, d as AudioPricing, e as AudioPricingSchema } from './audio-BzVF_wke.js';
-export { a as CatalogPriceTier, b as CatalogPriceTierSchema, C as CatalogProvider, c as CatalogProviderSchema, L as Lifecycle, d as LifecycleSchema, M as ModelKind, e as ModelKindSchema, N as NsfwPolicy, f as NsfwPolicySchema, g as baseEntryShape } from './base-BNHcMifc.js';
+import { R as ResolvedModel } from './index-DL-GcOAF.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-DL-GcOAF.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-BgW4RQUV.js';
+export { A as AudioCapabilities, a as AudioCapabilitiesSchema, b as AudioEntry, c as AudioEntrySchema, d as AudioPricing, e as AudioPricingSchema } from './audio-DcaMq62v.js';
+export { a as CatalogPriceTier, b as CatalogPriceTierSchema, C 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 baseEntryShape } from './base-BJo3zO1J.js';
 import 'zod';
 
 /**

package/dist/index.mjs

@@ -1,14 +1,15 @@
-export { applyProfile, expandProviders, filterVoicesByProviders, getProviderGroup, getSurfaceProfile, groupForProvider, listProviderGroups, listSurfaceProfiles, listSurfaced, modelMatchesProfile } from './chunk-CINXNTU3.mjs';
-export { CostUsageKindMismatchError, UnknownModelError, calculateAudioCost, calculateCost, calculateImageCost, calculateLLMCost, calculateVideoCost } from './chunk-IORIAFK2.mjs';
-import { getModel } from './chunk-GH7PB5FB.mjs';
-export { getModel, getModelsByProvider, getStaticModelProvider, isAgentVisible, listModels, resolveAlias } from './chunk-GH7PB5FB.mjs';
+export { applyProfile, expandProviders, filterVoicesByProviders, getProviderGroup, getSurfaceProfile, groupForProvider, listProviderGroups, listSurfaceProfiles, listSurfaced, modelMatchesProfile } from './chunk-PNWSXXRU.mjs';
+export { CostUsageKindMismatchError, UnknownModelError, calculateAudioCost, calculateCost, calculateImageCost, calculateLLMCost, calculateVideoCost } from './chunk-7FUGMXL4.mjs';
+import { getModel } from './chunk-2LUKUCDK.mjs';
+export { getModel, getModelsByProvider, getStaticModelProvider, isAgentVisible, listModels, resolveAlias } from './chunk-2LUKUCDK.mjs';
 export { shouldDebit } from './chunk-XFDXTFV3.mjs';
 export { evaluateAccess, evaluateCatalogDefaults } from './chunk-HRRG2RZO.mjs';
 import { priceTierForModel } from './chunk-WTHHXXIK.mjs';
 export { assertReservedPrefixDiscipline, getActions, getEnrichment, isActionTag, modelHasAction, modelHasTag, modelMatchesCatalogPriceTier, modelMatchesKind, modelMatchesPriceTier, priceTierForModel } from './chunk-WTHHXXIK.mjs';
 export { clearCatalogOverlays, getMergedOverlay, registerCatalogOverlay } from './chunk-H6JUTF3U.mjs';
-export { AudioCapabilitiesSchema, AudioEntrySchema, AudioPricingSchema, CatalogPriceTierSchema, CatalogProviderSchema, ImageAspectRatioSchema, ImageCapabilitiesSchema, ImageEntrySchema, ImagePricingSchema, ImageReferenceImagesSchema, LLMEntrySchema, LifecycleSchema, LlmPricingSchema, ModelEntrySchema, ModelKindSchema, NsfwPolicySchema, VideoCapabilitiesSchema, VideoCostMultipliersSchema, VideoEntrySchema, VideoPricingSchema, VideoResolutionSchema, baseEntryShape } from './chunk-F7OEHYUI.mjs';
-export { DEFAULT_PRICING, LLM_PRICING_CATALOG, MODEL_ALIASES, calculateLLMCreditCost, resolvePricing } from './chunk-OHAMH3ZE.mjs';
+export { AudioCapabilitiesSchema, AudioEntrySchema, AudioPricingSchema, CatalogPriceTierSchema, CatalogProviderSchema, ImageAspectRatioSchema, ImageCapabilitiesSchema, ImageEntrySchema, ImagePricingSchema, ImageReferenceImagesSchema, LLMEntrySchema, LifecycleSchema, LlmPricingSchema, ModelEntrySchema, ModelKindSchema, NsfwPolicySchema, PROVIDER_KEY_ENV, VideoCapabilitiesSchema, VideoCostMultipliersSchema, VideoEntrySchema, VideoPricingSchema, VideoResolutionSchema, baseEntryShape } from './chunk-XEYWCRAJ.mjs';
+import './chunk-O7TXHU5W.mjs';
+export { DEFAULT_PRICING, LLM_PRICING_CATALOG, MODEL_ALIASES, calculateLLMCreditCost, resolvePricing } from './chunk-OCVWDFVT.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":";;;;;;;;;;;;;;;;;;;;;;;;;AAoEO,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  resolvePricing,\n  calculateLLMCreditCost,\n} from \"./llm/index.js\"\nexport type {\n  LLMPricing,\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":";;;;;;;;;;;;;;;;;;;;;;;;;;AAoEO,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  resolvePricing,\n  calculateLLMCreditCost,\n} from \"./llm/index.js\"\nexport type {\n  LLMPricing,\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"]}

package/dist/llm/index.d.ts

@@ -1,5 +1,5 @@
-export { C as CacheStats, a as CalculateLLMCreditCostOptions, D as DEFAULT_PRICING, K as KnownLlmId, L as LLMCreditCostResult, b as LLMPricing, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, e as LlmModelAlias, f as LlmModelId, M as MODEL_ALIASES, g as ModelRoute, h as calculateLLMCreditCost, i as getCacheStats, j as getModelProvider, r as resolveAlias, k as resolveModelRoute, l as resolvePricing } from '../catalog-aQHd559b.js';
-import '../base-BNHcMifc.js';
+export { C as CacheStats, a as CalculateLLMCreditCostOptions, D as DEFAULT_PRICING, K as KnownLlmId, L as LLMCreditCostResult, b as LLMPricing, c as LLMUsageBreakdown, d as LLM_PRICING_CATALOG, e as LlmModelAlias, f as LlmModelId, M as MODEL_ALIASES, g as ModelRoute, h as calculateLLMCreditCost, i as getCacheStats, j as getModelProvider, r as resolveAlias, k as resolveModelRoute, l as resolvePricing } from '../catalog-BXCENAMh.js';
+import '../base-BJo3zO1J.js';
 import 'zod';
 
 /**

package/dist/llm/index.mjs

@@ -1,4 +1,5 @@
-export { DEFAULT_PRICING, LLM_PRICING_CATALOG, LLM_TIERS, MODEL_ALIASES, OPERATOR_AGENT_MODELS, OPERATOR_DEFAULT_GEMINI, OPERATOR_DEFAULT_PREMIUM, OPERATOR_DEFAULT_STANDARD, WORKFLOW_FAST_MODEL, WORKFLOW_PREMIUM_MODEL, WORKFLOW_TINY_MODEL, calculateLLMCreditCost, getCacheStats, getModelProvider, resolveAlias, resolveModelRoute, resolvePricing } from '../chunk-OHAMH3ZE.mjs';
+export { LLM_TIERS, OPERATOR_AGENT_MODELS, OPERATOR_DEFAULT_GEMINI, OPERATOR_DEFAULT_PREMIUM, OPERATOR_DEFAULT_STANDARD, WORKFLOW_FAST_MODEL, WORKFLOW_PREMIUM_MODEL, WORKFLOW_TINY_MODEL } from '../chunk-O7TXHU5W.mjs';
+export { DEFAULT_PRICING, LLM_PRICING_CATALOG, MODEL_ALIASES, calculateLLMCreditCost, getCacheStats, getModelProvider, resolveAlias, resolveModelRoute, resolvePricing } from '../chunk-OCVWDFVT.mjs';
 import '../chunk-QHELXPSL.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/overlay/index.d.ts

@@ -1,11 +1,11 @@
-import { b as LLMPricing } from '../catalog-aQHd559b.js';
+import { b as LLMPricing } from '../catalog-BXCENAMh.js';
 import { ImageModelDefinition } from '../image/index.js';
 import { VideoModelDefinition } from '../video/index.js';
 import { AudioModelDefinition } from '../audio/index.js';
 import { CatalogVoice } from '../schema/voice.js';
-import '../base-BNHcMifc.js';
+import '../base-BJo3zO1J.js';
 import 'zod';
-import '../audio-BzVF_wke.js';
+import '../audio-DcaMq62v.js';
 
 /**
  * Consumer catalog overlays.

package/dist/picker/index.d.ts

@@ -1,11 +1,11 @@
-import '../evaluate-DisH3H7u.js';
-import '../base-BNHcMifc.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-D8nL3fPZ.js';
-import '../index-BICjPG8H.js';
-import '../catalog-aQHd559b.js';
+import '../evaluate-BWuQauRR.js';
+import '../base-BJo3zO1J.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-BgW4RQUV.js';
+import '../index-DL-GcOAF.js';
+import '../catalog-BXCENAMh.js';
 import '../image/index.js';
 import '../video/index.js';
 import '../audio/index.js';
-import '../audio-BzVF_wke.js';
+import '../audio-DcaMq62v.js';
 import 'zod';
 import '../schema/voice.js';

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

@@ -0,0 +1,157 @@
+import { b as LLMPricing } from '../catalog-BXCENAMh.js';
+import '../base-BJo3zO1J.js';
+import 'zod';
+
+/**
+ * Route-aware model identity.
+ *
+ * Canonical reference syntax:
+ *   vendor/product[@route]
+ *
+ * A model product (who built it + what product) is separate from its serving
+ * route (how we reach it / how we are billed).
+ *
+ * Examples:
+ *   openai/gpt-4o              → vendor openai, product gpt-4o, route openai (direct)
+ *   openai/gpt-4o@openrouter   → same product, routed through OpenRouter
+ *   openai/gpt-4o@agentik-proxy → same product, operator-configured proxy route
+ *
+ * Design invariants:
+ *   - `vendor` is who built the model; `route` is how we reach it.
+ *   - `provider/model` strings parse as vendor/product with implicit route = vendor
+ *     (backward-compatible reference form).
+ *   - Unscoped `xx@yy` is rejected.
+ *   - Route metadata (pricing, limits, transport, availability) is separate from
+ *     product metadata and computed at resolution time.
+ *   - The abstraction is generic across model kinds; only LLM has a concrete
+ *     resolver today.
+ */
+
+interface ModelRef {
+    /** The original, trimmed string. */
+    raw: string;
+    /** Model author / builder (permanent identity). */
+    vendor: string;
+    /** Specific model product. */
+    product: string;
+    /** Routing target — defaults to vendor for direct vendor access. */
+    route: string;
+}
+declare class InvalidModelRefError extends Error {
+    readonly raw: string;
+    readonly name = "InvalidModelRefError";
+    constructor(raw: string, message: string);
+}
+/**
+ * Parse a model reference in `vendor/product[@route]` form.
+ *
+ * - `openai/gpt-4o` → `{ vendor: "openai", product: "gpt-4o", route: "openai" }`
+ * - `openai/gpt-4o@openrouter` → route "openrouter"
+ *
+ * Rejects empty strings, unscoped `@` refs, missing segments, and segments
+ * containing `/` or `@`.
+ */
+declare function parseModelRef(raw: string): ModelRef;
+/**
+ * Format a {@link ModelRef} back to its canonical string.
+ * Implicit direct routes omit the `@route` suffix.
+ */
+declare function formatModelRef(ref: ModelRef): string;
+/** True when `raw` matches the `vendor/product[@route]` shape. */
+declare function isModelRefString(raw: string): boolean;
+interface ModelRouteLimits {
+    contextWindow?: number;
+    maxInputTokens?: number;
+    maxOutputTokens?: number;
+}
+type ModelRouteAvailability = "available" | "preview" | "unavailable";
+interface ModelRouteTransport {
+    /** API/schema flavor: e.g. "openai", "anthropic", "openrouter", "custom". */
+    flavor: string;
+    /** Optional explicit base URL for the route. */
+    baseUrl?: string;
+}
+/** Product metadata — independent of the serving route. */
+interface ModelProductMeta {
+    vendor: string;
+    product: string;
+    /** Canonical product id after alias resolution. */
+    canonicalProductId: string;
+}
+/** Route metadata — pricing, limits, transport, availability. */
+interface ModelRouteMeta<TPricing = unknown> {
+    route: string;
+    transport: ModelRouteTransport;
+    availability: ModelRouteAvailability;
+    limits: ModelRouteLimits;
+    pricing: TPricing;
+}
+/** Fully resolved model route: product identity + route metadata. */
+interface ResolvedModelRoute<TPricing = unknown> extends ModelProductMeta, ModelRouteMeta<TPricing> {
+    /** The parsed reference. */
+    ref: ModelRef;
+}
+type ResolvedLlmModelRoute = ResolvedModelRoute<LLMPricing>;
+/**
+ * Operator-configurable custom route.
+ *
+ * No credential values live here — only the *name* of an env var (`authEnv`)
+ * so adapters can resolve secrets at runtime. `agentik-proxy` is registered
+ * through this shape; it is never hardcoded in the catalog. No private
+ * models, hosts, or prices are committed.
+ */
+interface CustomRouteConfig {
+    label?: string;
+    /** API/schema flavor the route speaks. */
+    flavor?: string;
+    /** Base URL the adapter should hit. */
+    baseUrl?: string;
+    /** Name of the env var holding the API key/secret (not the value). */
+    authEnv?: string;
+    availability?: ModelRouteAvailability;
+    limits?: ModelRouteLimits;
+    /** Route-level pricing override. Unset fields fall back to product pricing. */
+    pricing?: Partial<LLMPricing>;
+}
+declare function registerCustomRoute(id: string, config: CustomRouteConfig): void;
+declare function resolveCustomRoute(id: string): CustomRouteConfig | undefined;
+/** Test helper: clear all registered custom routes. */
+declare function clearCustomRoutes(): void;
+/**
+ * Resolve a model reference to an LLM route, distinguishing direct vendor
+ * access from explicit router/proxy routes.
+ *
+ *   openai/gpt-4o            → direct OpenAI pricing / transport
+ *   openai/gpt-4o@openrouter → OpenRouter route pricing / transport
+ *   openai/gpt-4o@agentik-proxy → custom route config (if registered)
+ *
+ * Bare legacy ids (e.g. `gpt-4o`, `claude-sonnet-4-5`) are also accepted and
+ * resolved through the legacy pricing catalog, with the route inferred from
+ * the catalog entry's provider/vendor.
+ *
+ * Returns `undefined` when the product or route is unknown.
+ */
+declare function resolveLlmModelRoute(input: string | ModelRef): ResolvedLlmModelRoute | undefined;
+interface ModelRefDiagnostic {
+    ref: ModelRef;
+    /** True if this string is a legacy bare id rather than vendor/product. */
+    legacyBareId: boolean;
+    /** True if a direct vendor route exists for the product. */
+    directAvailable: boolean;
+    /** True if an OpenRouter route exists for vendor/product. */
+    openRouterAvailable: boolean;
+    /** True if a custom route is registered for the route segment. */
+    customRouteAvailable: boolean;
+    /** Human-readable note when ambiguity or a deprecation applies. */
+    note?: string;
+}
+/**
+ * Inspect a model reference and report what routes are available for it.
+ *
+ * Useful for CLI/UI warnings when a user types `openai/gpt-4o` and an
+ * explicit `@openrouter` form also exists: the direct form is chosen, but
+ * the note explains how to request the OpenRouter route explicitly.
+ */
+declare function diagnoseModelRef(input: string | ModelRef): ModelRefDiagnostic | undefined;
+
+export { type CustomRouteConfig, InvalidModelRefError, type ModelProductMeta, type ModelRef, type ModelRefDiagnostic, type ModelRouteAvailability, type ModelRouteLimits, type ModelRouteMeta, type ModelRouteTransport, type ResolvedLlmModelRoute, type ResolvedModelRoute, clearCustomRoutes, diagnoseModelRef, formatModelRef, isModelRefString, parseModelRef, registerCustomRoute, resolveCustomRoute, resolveLlmModelRoute };

package/dist/route-identity/index.mjs

@@ -0,0 +1,177 @@
+import { resolvePricing, resolveAlias, OPENROUTER_ROUTES, DEFAULT_PRICING } from '../chunk-OCVWDFVT.mjs';
+import '../chunk-QHELXPSL.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/route-identity/index.ts
+var SEGMENT_RE = /^[a-zA-Z0-9_.-]+$/;
+var REF_RE = /^([^/@]+)\/([^/@]+)(?:@([^/@]+))?$/;
+var InvalidModelRefError = class extends Error {
+  constructor(raw, message) {
+    super(`Invalid model reference "${raw}": ${message}`);
+    this.raw = raw;
+  }
+  raw;
+  name = "InvalidModelRefError";
+};
+function parseModelRef(raw) {
+  const input = raw.trim();
+  if (input.length === 0) {
+    throw new InvalidModelRefError(raw, "model reference is empty");
+  }
+  if (input.includes("@") && !input.includes("/")) {
+    throw new InvalidModelRefError(
+      raw,
+      "unscoped @ route is not allowed; use vendor/product[@route]"
+    );
+  }
+  const match = REF_RE.exec(input);
+  if (!match) {
+    throw new InvalidModelRefError(
+      raw,
+      "expected vendor/product[@route] (e.g. openai/gpt-4o or openai/gpt-4o@openrouter)"
+    );
+  }
+  const vendor = match[1].trim();
+  const product = match[2].trim();
+  const route = (match[3] ?? vendor).trim();
+  for (const [label, value] of [
+    ["vendor", vendor],
+    ["product", product],
+    ["route", route]
+  ]) {
+    if (value.length === 0) {
+      throw new InvalidModelRefError(raw, `${label} segment is empty`);
+    }
+    if (!SEGMENT_RE.test(value)) {
+      throw new InvalidModelRefError(
+        raw,
+        `${label} "${value}" contains invalid characters (no '/' or '@')`
+      );
+    }
+  }
+  return { raw: input, vendor, product, route };
+}
+function formatModelRef(ref) {
+  if (ref.route === ref.vendor) {
+    return `${ref.vendor}/${ref.product}`;
+  }
+  return `${ref.vendor}/${ref.product}@${ref.route}`;
+}
+function isModelRefString(raw) {
+  try {
+    parseModelRef(raw);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var customRoutes = /* @__PURE__ */ new Map();
+function registerCustomRoute(id, config) {
+  customRoutes.set(id, config);
+}
+function resolveCustomRoute(id) {
+  return customRoutes.get(id);
+}
+function clearCustomRoutes() {
+  customRoutes.clear();
+}
+function resolveLlmModelRoute(input) {
+  const ref = typeof input === "string" ? tryParseOrLegacy(input) : { ref: input, legacy: false };
+  if (!ref) return void 0;
+  const { ref: modelRef, legacy } = ref;
+  const directPricing = resolvePricing(modelRef.product);
+  const canonicalProductId = resolveAlias(modelRef.product);
+  if (modelRef.route === modelRef.vendor) {
+    if (!directPricing) return void 0;
+    return buildLlmRoute(modelRef, canonicalProductId, directPricing, {
+      flavor: modelRef.vendor
+    });
+  }
+  if (modelRef.route === "openrouter") {
+    const key = `${modelRef.vendor}/${modelRef.product}`;
+    const pricing2 = OPENROUTER_ROUTES[key];
+    if (!pricing2) return void 0;
+    return buildLlmRoute(modelRef, canonicalProductId, pricing2, {
+      flavor: "openrouter"
+    });
+  }
+  const custom = resolveCustomRoute(modelRef.route);
+  if (!custom) return void 0;
+  const basePricing = directPricing ?? DEFAULT_PRICING;
+  const pricing = {
+    ...basePricing,
+    ...custom.pricing,
+    vendor: custom.pricing?.vendor ?? basePricing.vendor
+  };
+  return buildLlmRoute(
+    modelRef,
+    canonicalProductId,
+    pricing,
+    {
+      flavor: custom.flavor ?? "custom",
+      baseUrl: custom.baseUrl
+    },
+    custom
+  );
+}
+function buildLlmRoute(ref, canonicalProductId, pricing, transport, custom) {
+  return {
+    ref,
+    vendor: ref.vendor,
+    product: ref.product,
+    canonicalProductId,
+    route: ref.route,
+    transport,
+    availability: custom?.availability ?? "available",
+    limits: custom?.limits ?? {},
+    pricing
+  };
+}
+function tryParseOrLegacy(raw) {
+  if (raw.includes("/")) {
+    return { ref: parseModelRef(raw), legacy: false };
+  }
+  const pricing = resolvePricing(raw);
+  if (!pricing) return void 0;
+  const vendor = pricing.vendor ?? pricing.provider ?? "unknown";
+  const route = pricing.provider ?? vendor;
+  return {
+    ref: { raw, vendor, product: raw, route },
+    legacy: true
+  };
+}
+function diagnoseModelRef(input) {
+  const parsed = typeof input === "string" ? tryParseOrLegacy(input) : { ref: input, legacy: false };
+  if (!parsed) return void 0;
+  const { ref, legacy } = parsed;
+  const directPricing = resolvePricing(ref.product);
+  const openRouterKey = `${ref.vendor}/${ref.product}`;
+  const openRouterPricing = OPENROUTER_ROUTES[openRouterKey];
+  const custom = resolveCustomRoute(ref.route);
+  const directAvailable = !!directPricing;
+  const openRouterAvailable = !!openRouterPricing;
+  const customRouteAvailable = !!custom;
+  let note;
+  if (legacy) {
+    note = `Bare product id "${ref.product}" is a legacy form; prefer ${ref.vendor}/${ref.product}.`;
+  } else if (ref.route === ref.vendor && openRouterAvailable) {
+    note = `Direct vendor route selected. Use ${ref.vendor}/${ref.product}@openrouter for the OpenRouter route.`;
+  }
+  return {
+    ref,
+    legacyBareId: legacy,
+    directAvailable,
+    openRouterAvailable,
+    customRouteAvailable,
+    note
+  };
+}
+
+export { InvalidModelRefError, clearCustomRoutes, diagnoseModelRef, formatModelRef, isModelRefString, parseModelRef, registerCustomRoute, resolveCustomRoute, resolveLlmModelRoute };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/route-identity/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/route-identity/index.ts"],"names":["pricing"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Route-aware model identity.\n *\n * Canonical reference syntax:\n *   vendor/product[@route]\n *\n * A model product (who built it + what product) is separate from its serving\n * route (how we reach it / how we are billed).\n *\n * Examples:\n *   openai/gpt-4o              → vendor openai, product gpt-4o, route openai (direct)\n *   openai/gpt-4o@openrouter   → same product, routed through OpenRouter\n *   openai/gpt-4o@agentik-proxy → same product, operator-configured proxy route\n *\n * Design invariants:\n *   - `vendor` is who built the model; `route` is how we reach it.\n *   - `provider/model` strings parse as vendor/product with implicit route = vendor\n *     (backward-compatible reference form).\n *   - Unscoped `xx@yy` is rejected.\n *   - Route metadata (pricing, limits, transport, availability) is separate from\n *     product metadata and computed at resolution time.\n *   - The abstraction is generic across model kinds; only LLM has a concrete\n *     resolver today.\n */\n\nimport type { LLMPricing } from \"../llm/catalog.js\"\nimport {\n  resolvePricing,\n  resolveAlias,\n  DEFAULT_PRICING,\n} from \"../llm/catalog.js\"\nimport { OPENROUTER_ROUTES } from \"../llm/openrouter-routes.generated.js\"\n\n// ── Parser ─────────────────────────────────────────────────────────────────\n\nconst SEGMENT_RE = /^[a-zA-Z0-9_.-]+$/\nconst REF_RE = /^([^/@]+)\\/([^/@]+)(?:@([^/@]+))?$/\n\nexport interface ModelRef {\n  /** The original, trimmed string. */\n  raw: string\n  /** Model author / builder (permanent identity). */\n  vendor: string\n  /** Specific model product. */\n  product: string\n  /** Routing target — defaults to vendor for direct vendor access. */\n  route: string\n}\n\nexport class InvalidModelRefError extends Error {\n  readonly name = \"InvalidModelRefError\"\n  constructor(\n    public readonly raw: string,\n    message: string\n  ) {\n    super(`Invalid model reference \"${raw}\": ${message}`)\n  }\n}\n\n/**\n * Parse a model reference in `vendor/product[@route]` form.\n *\n * - `openai/gpt-4o` → `{ vendor: \"openai\", product: \"gpt-4o\", route: \"openai\" }`\n * - `openai/gpt-4o@openrouter` → route \"openrouter\"\n *\n * Rejects empty strings, unscoped `@` refs, missing segments, and segments\n * containing `/` or `@`.\n */\nexport function parseModelRef(raw: string): ModelRef {\n  const input = raw.trim()\n  if (input.length === 0) {\n    throw new InvalidModelRefError(raw, \"model reference is empty\")\n  }\n\n  // Reject unscoped `xx@yy` before attempting the slash-based regex.\n  if (input.includes(\"@\") && !input.includes(\"/\")) {\n    throw new InvalidModelRefError(\n      raw,\n      \"unscoped @ route is not allowed; use vendor/product[@route]\"\n    )\n  }\n\n  const match = REF_RE.exec(input)\n  if (!match) {\n    throw new InvalidModelRefError(\n      raw,\n      \"expected vendor/product[@route] (e.g. openai/gpt-4o or openai/gpt-4o@openrouter)\"\n    )\n  }\n\n  const vendor = match[1]!.trim()\n  const product = match[2]!.trim()\n  const route = (match[3] ?? vendor).trim()\n\n  for (const [label, value] of [\n    [\"vendor\", vendor],\n    [\"product\", product],\n    [\"route\", route],\n  ] as const) {\n    if (value.length === 0) {\n      throw new InvalidModelRefError(raw, `${label} segment is empty`)\n    }\n    if (!SEGMENT_RE.test(value)) {\n      throw new InvalidModelRefError(\n        raw,\n        `${label} \"${value}\" contains invalid characters (no '/' or '@')`\n      )\n    }\n  }\n\n  return { raw: input, vendor, product, route }\n}\n\n/**\n * Format a {@link ModelRef} back to its canonical string.\n * Implicit direct routes omit the `@route` suffix.\n */\nexport function formatModelRef(ref: ModelRef): string {\n  if (ref.route === ref.vendor) {\n    return `${ref.vendor}/${ref.product}`\n  }\n  return `${ref.vendor}/${ref.product}@${ref.route}`\n}\n\n/** True when `raw` matches the `vendor/product[@route]` shape. */\nexport function isModelRefString(raw: string): boolean {\n  try {\n    parseModelRef(raw)\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ── Product vs route metadata ──────────────────────────────────────────────\n\nexport interface ModelRouteLimits {\n  contextWindow?: number\n  maxInputTokens?: number\n  maxOutputTokens?: number\n}\n\nexport type ModelRouteAvailability = \"available\" | \"preview\" | \"unavailable\"\n\nexport interface ModelRouteTransport {\n  /** API/schema flavor: e.g. \"openai\", \"anthropic\", \"openrouter\", \"custom\". */\n  flavor: string\n  /** Optional explicit base URL for the route. */\n  baseUrl?: string\n}\n\n/** Product metadata — independent of the serving route. */\nexport interface ModelProductMeta {\n  vendor: string\n  product: string\n  /** Canonical product id after alias resolution. */\n  canonicalProductId: string\n}\n\n/** Route metadata — pricing, limits, transport, availability. */\nexport interface ModelRouteMeta<TPricing = unknown> {\n  route: string\n  transport: ModelRouteTransport\n  availability: ModelRouteAvailability\n  limits: ModelRouteLimits\n  pricing: TPricing\n}\n\n/** Fully resolved model route: product identity + route metadata. */\nexport interface ResolvedModelRoute<TPricing = unknown>\n  extends ModelProductMeta,\n    ModelRouteMeta<TPricing> {\n  /** The parsed reference. */\n  ref: ModelRef\n}\n\nexport type ResolvedLlmModelRoute = ResolvedModelRoute<LLMPricing>\n\n// ── Custom route config ────────────────────────────────────────────────────\n\n/**\n * Operator-configurable custom route.\n *\n * No credential values live here — only the *name* of an env var (`authEnv`)\n * so adapters can resolve secrets at runtime. `agentik-proxy` is registered\n * through this shape; it is never hardcoded in the catalog. No private\n * models, hosts, or prices are committed.\n */\nexport interface CustomRouteConfig {\n  label?: string\n  /** API/schema flavor the route speaks. */\n  flavor?: string\n  /** Base URL the adapter should hit. */\n  baseUrl?: string\n  /** Name of the env var holding the API key/secret (not the value). */\n  authEnv?: string\n  availability?: ModelRouteAvailability\n  limits?: ModelRouteLimits\n  /** Route-level pricing override. Unset fields fall back to product pricing. */\n  pricing?: Partial<LLMPricing>\n}\n\nconst customRoutes = new Map<string, CustomRouteConfig>()\n\nexport function registerCustomRoute(\n  id: string,\n  config: CustomRouteConfig\n): void {\n  customRoutes.set(id, config)\n}\n\nexport function resolveCustomRoute(id: string): CustomRouteConfig | undefined {\n  return customRoutes.get(id)\n}\n\n/** Test helper: clear all registered custom routes. */\nexport function clearCustomRoutes(): void {\n  customRoutes.clear()\n}\n\n// ── LLM route resolution ───────────────────────────────────────────────────\n\n/**\n * Resolve a model reference to an LLM route, distinguishing direct vendor\n * access from explicit router/proxy routes.\n *\n *   openai/gpt-4o            → direct OpenAI pricing / transport\n *   openai/gpt-4o@openrouter → OpenRouter route pricing / transport\n *   openai/gpt-4o@agentik-proxy → custom route config (if registered)\n *\n * Bare legacy ids (e.g. `gpt-4o`, `claude-sonnet-4-5`) are also accepted and\n * resolved through the legacy pricing catalog, with the route inferred from\n * the catalog entry's provider/vendor.\n *\n * Returns `undefined` when the product or route is unknown.\n */\nexport function resolveLlmModelRoute(\n  input: string | ModelRef\n): ResolvedLlmModelRoute | undefined {\n  const ref =\n    typeof input === \"string\"\n      ? tryParseOrLegacy(input)\n      : { ref: input, legacy: false }\n\n  if (!ref) return undefined\n\n  const { ref: modelRef, legacy } = ref\n  const directPricing = resolvePricing(modelRef.product)\n  const canonicalProductId = resolveAlias(modelRef.product)\n\n  // ── Direct vendor route ─────────────────────────────────────────────────\n  if (modelRef.route === modelRef.vendor) {\n    if (!directPricing) return undefined\n    return buildLlmRoute(modelRef, canonicalProductId, directPricing, {\n      flavor: modelRef.vendor,\n    })\n  }\n\n  // ── OpenRouter route ────────────────────────────────────────────────────\n  if (modelRef.route === \"openrouter\") {\n    const key = `${modelRef.vendor}/${modelRef.product}`\n    const pricing = OPENROUTER_ROUTES[key]\n    if (!pricing) return undefined\n    return buildLlmRoute(modelRef, canonicalProductId, pricing, {\n      flavor: \"openrouter\",\n    })\n  }\n\n  // ── Custom route (e.g. agentik-proxy) ───────────────────────────────────\n  const custom = resolveCustomRoute(modelRef.route)\n  if (!custom) return undefined\n\n  const basePricing = directPricing ?? DEFAULT_PRICING\n  const pricing: LLMPricing = {\n    ...basePricing,\n    ...custom.pricing,\n    vendor: custom.pricing?.vendor ?? basePricing.vendor,\n  }\n\n  return buildLlmRoute(\n    modelRef,\n    canonicalProductId,\n    pricing,\n    {\n      flavor: custom.flavor ?? \"custom\",\n      baseUrl: custom.baseUrl,\n    },\n    custom\n  )\n}\n\nfunction buildLlmRoute(\n  ref: ModelRef,\n  canonicalProductId: string,\n  pricing: LLMPricing,\n  transport: ModelRouteTransport,\n  custom?: CustomRouteConfig\n): ResolvedLlmModelRoute {\n  return {\n    ref,\n    vendor: ref.vendor,\n    product: ref.product,\n    canonicalProductId,\n    route: ref.route,\n    transport,\n    availability: custom?.availability ?? \"available\",\n    limits: custom?.limits ?? {},\n    pricing,\n  }\n}\n\ninterface ParseResult {\n  ref: ModelRef\n  legacy: boolean\n}\n\n/**\n * Parse a canonical ref, or interpret a bare legacy id as a product-only ref\n * when it resolves through the legacy catalog.\n */\nfunction tryParseOrLegacy(raw: string): ParseResult | undefined {\n  if (raw.includes(\"/\")) {\n    return { ref: parseModelRef(raw), legacy: false }\n  }\n  const pricing = resolvePricing(raw)\n  if (!pricing) return undefined\n  const vendor = pricing.vendor ?? pricing.provider ?? \"unknown\"\n  const route = pricing.provider ?? vendor\n  return {\n    ref: { raw, vendor, product: raw, route },\n    legacy: true,\n  }\n}\n\n// ── Diagnostics ────────────────────────────────────────────────────────────\n\nexport interface ModelRefDiagnostic {\n  ref: ModelRef\n  /** True if this string is a legacy bare id rather than vendor/product. */\n  legacyBareId: boolean\n  /** True if a direct vendor route exists for the product. */\n  directAvailable: boolean\n  /** True if an OpenRouter route exists for vendor/product. */\n  openRouterAvailable: boolean\n  /** True if a custom route is registered for the route segment. */\n  customRouteAvailable: boolean\n  /** Human-readable note when ambiguity or a deprecation applies. */\n  note?: string\n}\n\n/**\n * Inspect a model reference and report what routes are available for it.\n *\n * Useful for CLI/UI warnings when a user types `openai/gpt-4o` and an\n * explicit `@openrouter` form also exists: the direct form is chosen, but\n * the note explains how to request the OpenRouter route explicitly.\n */\nexport function diagnoseModelRef(\n  input: string | ModelRef\n): ModelRefDiagnostic | undefined {\n  const parsed =\n    typeof input === \"string\" ? tryParseOrLegacy(input) : { ref: input, legacy: false }\n  if (!parsed) return undefined\n\n  const { ref, legacy } = parsed\n  const directPricing = resolvePricing(ref.product)\n  const openRouterKey = `${ref.vendor}/${ref.product}`\n  const openRouterPricing = OPENROUTER_ROUTES[openRouterKey]\n  const custom = resolveCustomRoute(ref.route)\n\n  const directAvailable = !!directPricing\n  const openRouterAvailable = !!openRouterPricing\n  const customRouteAvailable = !!custom\n\n  let note: string | undefined\n  if (legacy) {\n    note = `Bare product id \"${ref.product}\" is a legacy form; prefer ${ref.vendor}/${ref.product}.`\n  } else if (ref.route === ref.vendor && openRouterAvailable) {\n    note = `Direct vendor route selected. Use ${ref.vendor}/${ref.product}@openrouter for the OpenRouter route.`\n  }\n\n  return {\n    ref,\n    legacyBareId: legacy,\n    directAvailable,\n    openRouterAvailable,\n    customRouteAvailable,\n    note,\n  }\n}\n"]}

package/dist/schema/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-export { a as CatalogPriceTier, b as CatalogPriceTierSchema, C as CatalogProvider, c as CatalogProviderSchema, L as Lifecycle, d as LifecycleSchema, M as ModelKind, e as ModelKindSchema, N as NsfwPolicy, f as NsfwPolicySchema, g as baseEntryShape } from '../base-BNHcMifc.js';
-export { A as AudioCapabilities, a as AudioCapabilitiesSchema, b as AudioEntry, c as AudioEntrySchema, d as AudioPricing, e as AudioPricingSchema } from '../audio-BzVF_wke.js';
+export { a as CatalogPriceTier, b as CatalogPriceTierSchema, C 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 baseEntryShape } from '../base-BJo3zO1J.js';
+export { A as AudioCapabilities, a as AudioCapabilitiesSchema, b as AudioEntry, c as AudioEntrySchema, d as AudioPricing, e as AudioPricingSchema } from '../audio-DcaMq62v.js';
 export { CatalogVoice, CatalogVoiceProvider, CatalogVoiceProviderSchema, CatalogVoiceSchema } from './voice.js';
 
 /**
@@ -49,6 +49,7 @@ declare const LLMEntrySchema: z.ZodObject<{
         "openai-realtime": "openai-realtime";
         openrouter: "openrouter";
         replicate: "replicate";
+        xai: "xai";
     }>;
     providerId: z.ZodString;
     agentVisible: z.ZodDefault<z.ZodBoolean>;
@@ -180,6 +181,7 @@ declare const ImageEntrySchema: z.ZodObject<{
         "openai-realtime": "openai-realtime";
         openrouter: "openrouter";
         replicate: "replicate";
+        xai: "xai";
     }>;
     providerId: z.ZodString;
     agentVisible: z.ZodDefault<z.ZodBoolean>;
@@ -319,6 +321,7 @@ declare const VideoEntrySchema: z.ZodObject<{
         "openai-realtime": "openai-realtime";
         openrouter: "openrouter";
         replicate: "replicate";
+        xai: "xai";
     }>;
     providerId: z.ZodString;
     agentVisible: z.ZodDefault<z.ZodBoolean>;
@@ -375,6 +378,7 @@ declare const ModelEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "openai-realtime": "openai-realtime";
         openrouter: "openrouter";
         replicate: "replicate";
+        xai: "xai";
     }>;
     providerId: z.ZodString;
     agentVisible: z.ZodDefault<z.ZodBoolean>;
@@ -453,6 +457,7 @@ declare const ModelEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "openai-realtime": "openai-realtime";
         openrouter: "openrouter";
         replicate: "replicate";
+        xai: "xai";
     }>;
     providerId: z.ZodString;
     agentVisible: z.ZodDefault<z.ZodBoolean>;
@@ -536,6 +541,7 @@ declare const ModelEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "openai-realtime": "openai-realtime";
         openrouter: "openrouter";
         replicate: "replicate";
+        xai: "xai";
     }>;
     providerId: z.ZodString;
     agentVisible: z.ZodDefault<z.ZodBoolean>;
@@ -599,6 +605,7 @@ declare const ModelEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "openai-realtime": "openai-realtime";
         openrouter: "openrouter";
         replicate: "replicate";
+        xai: "xai";
     }>;
     providerId: z.ZodString;
     agentVisible: z.ZodDefault<z.ZodBoolean>;

package/dist/schema/index.mjs

@@ -1,4 +1,4 @@
-export { AudioCapabilitiesSchema, AudioEntrySchema, AudioPricingSchema, CatalogPriceTierSchema, CatalogProviderSchema, ImageAspectRatioSchema, ImageCapabilitiesSchema, ImageEntrySchema, ImagePricingSchema, ImageReferenceImagesSchema, LLMEntrySchema, LifecycleSchema, LlmPricingSchema, ModelEntrySchema, ModelKindSchema, NsfwPolicySchema, VideoCapabilitiesSchema, VideoCostMultipliersSchema, VideoEntrySchema, VideoPricingSchema, VideoResolutionSchema, baseEntryShape } from '../chunk-F7OEHYUI.mjs';
+export { AudioCapabilitiesSchema, AudioEntrySchema, AudioPricingSchema, CatalogPriceTierSchema, CatalogProviderSchema, ImageAspectRatioSchema, ImageCapabilitiesSchema, ImageEntrySchema, ImagePricingSchema, ImageReferenceImagesSchema, LLMEntrySchema, LifecycleSchema, LlmPricingSchema, ModelEntrySchema, ModelKindSchema, NsfwPolicySchema, PROVIDER_KEY_ENV, VideoCapabilitiesSchema, VideoCostMultipliersSchema, VideoEntrySchema, VideoPricingSchema, VideoResolutionSchema, baseEntryShape } from '../chunk-XEYWCRAJ.mjs';
 export { CatalogVoiceProviderSchema, CatalogVoiceSchema } from '../chunk-HEDDSOZF.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/model-catalog",
-  "version": "0.2.0",
+  "version": "0.3.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",
@@ -18,7 +18,7 @@
   "bugs": {
     "url": "https://github.com/agentproto/ts/issues"
   },
-  "license": "MIT",
+  "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -111,6 +111,11 @@
       "types": "./dist/overlay/index.d.ts",
       "import": "./dist/overlay/index.mjs",
       "default": "./dist/overlay/index.mjs"
+    },
+    "./route-identity": {
+      "types": "./dist/route-identity/index.d.ts",
+      "import": "./dist/route-identity/index.mjs",
+      "default": "./dist/route-identity/index.mjs"
     }
   },
   "dependencies": {