@agentproto/model-catalog 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+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 { 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';
+export { CatalogVoice, CatalogVoiceProvider, CatalogVoiceProviderSchema, CatalogVoiceSchema } from './schema/voice.js';
+export { BAKED_VOICE_PREVIEWS, CatalogVoiceId, ELEVENLABS_VOICES, GEMINI_LIVE_VOICES, MINIMAX_VOICES, NativeVoice, OPENAI_REALTIME_VOICES, VOICE_CATALOG, VOICE_PREVIEW_BASE, VOICE_PREVIEW_LOCALES, VoiceCurationOverrides, VoiceRef, curateVoice, getFeaturedVoices, getProviderForVoice, getVoiceByCatalogId, getVoiceById, getVoiceByProviderVoiceId, getVoiceCatalog, resolveVoice, slugifyVoiceId, voicePreviewUrl } from './voice/index.js';
+export { ProviderGroup, SurfaceProfile, applyProfile, expandProviders, filterVoicesByProviders, getProviderGroup, getSurfaceProfile, groupForProvider, listProviderGroups, listSurfaceProfiles, listSurfaced, modelMatchesProfile } from './curation/index.js';
+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 { 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 'zod';
+
+/**
+ * Action projection — `<kind>:<verb>` namespaced strings derived from
+ * each model's per-kind capability object.
+ *
+ * Convention:
+ *   - `image:generate`, `image:edit`, `image:upscale`, `image:reference`
+ *   - `video:text_to`, `video:image_to`, `video:subject_reference`,
+ *     `video:audio`
+ *   - `audio:tts`, `audio:stt`, `audio:realtime`
+ *   - `llm:vision`, `llm:tool_use`, `llm:reasoning`, `llm:long_context`
+ *
+ * Always `<kind>:<verb_or_modifier>`, snake_case.
+ *
+ * Action tags share a string array with curation tags but live behind the
+ * reserved `<kind>:` prefix. Curation tags MUST NOT use the prefix —
+ * `assertReservedPrefixDiscipline` enforces this at module load.
+ *
+ * The reason this lives in the catalog package (not enrichment) is that
+ * actions are intrinsic to a model — derived from its capability fields,
+ * not subjectively curated. Keeping the projection separate makes it
+ * trivially callable from anywhere (e.g. a UI badge component) without
+ * pulling the heuristic enrichment table.
+ */
+
+/**
+ * Compute the action tags a model supports. Returns an empty array for
+ * models with no recognized capability bits (defensive — never throws).
+ */
+declare function getActions(model: ResolvedModel): string[];
+/**
+ * Validate that a string array intended as curation tags does not use a
+ * reserved `<kind>:` prefix. Run at module load on the explicit
+ * enrichment map; throws on violation so the offending entry is caught
+ * before any access decision is made.
+ *
+ * Caller pattern (in tests / module-load init):
+ *   for (const e of Object.values(EXPLICIT_ENRICHMENT))
+ *     assertReservedPrefixDiscipline(e.tags)
+ */
+declare function assertReservedPrefixDiscipline(curationTags: readonly string[]): void;
+/**
+ * Returns true iff the given tag is in the reserved action-tag namespace.
+ * Useful for callers that need to display curation tags only (e.g.
+ * an admin UI) without hardcoding the prefix list.
+ */
+declare function isActionTag(tag: string): boolean;
+
+/**
+ * @agentproto/model-catalog — unified model catalog.
+ *
+ * Single source of truth for LLM, image, video, audio, and voice model
+ * entries. Owns cost dispatch, BYOK policy, and access control evaluation.
+ * Zod-only OSS core; @agentproto/model-catalog layers billing/access/BYOK
+ * policy on top.
+ *
+ * Subpath imports for tree-shaking:
+ *   import { LLM_PRICING_CATALOG } from "@agentproto/model-catalog/llm"
+ *   import { calculateCost } from "@agentproto/model-catalog/cost"
+ *   import { shouldDebit } from "@agentproto/model-catalog/byok"
+ *   import { evaluateAccess } from "@agentproto/model-catalog/access"
+ *   import { VOICE_CATALOG } from "@agentproto/model-catalog/voice"
+ *   import { listSurfaced } from "@agentproto/model-catalog/curation"
+ */
+
+/**
+ * Display price gauge level (1..5) for a model id — resolves the catalog
+ * entry then defers to {@link priceTierForModel}. 0 for an unknown id.
+ * The id→level convenience used by the WhatsApp / slash pickers, which carry
+ * a model id rather than a resolved model.
+ */
+declare function priceTierForModelId(id: string): number;
+
+export { ResolvedModel, assertReservedPrefixDiscipline, getActions, isActionTag, priceTierForModelId };

package/dist/index.mjs

@@ -0,0 +1,33 @@
+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 { 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 { 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';
+export { AGENT_AUDIO_MODEL_IDS, AGENT_STT_MODEL_IDS, AGENT_TTS_MODEL_IDS, AUDIO_MODEL_CATALOG, AUDIO_MODEL_IDS, DEFAULT_GEMINI_LIVE_MODEL, GEMINI_LIVE_MODEL_IDS, S2S_MODEL_IDS, generateAudioModelTable, isAcceptedGeminiLiveModel } from './chunk-WRUWNKDB.mjs';
+export { BAKED_VOICE_PREVIEWS, ELEVENLABS_VOICES, GEMINI_LIVE_VOICES, MINIMAX_VOICES, OPENAI_REALTIME_VOICES, VOICE_CATALOG, VOICE_PREVIEW_BASE, VOICE_PREVIEW_LOCALES, curateVoice, getFeaturedVoices, getProviderForVoice, getVoiceByCatalogId, getVoiceById, getVoiceByProviderVoiceId, getVoiceCatalog, resolveVoice, slugifyVoiceId, voicePreviewUrl } from './chunk-SGJR6ZQH.mjs';
+export { CatalogVoiceProviderSchema, CatalogVoiceSchema } from './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/index.ts
+function priceTierForModelId(id) {
+  const model = getModel(id);
+  return model ? priceTierForModel(model) : 0;
+}
+
+export { priceTierForModelId };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"]}

package/dist/llm/index.d.ts

@@ -0,0 +1,48 @@
+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';
+import 'zod';
+
+/**
+ * Curated, SDK-ready LLM model ids.
+ *
+ * Centralizes the version-specific provider ids used at runtime so call
+ * sites stop carrying string literals. Pricing for each is resolved
+ * automatically through `MODEL_ALIASES` in `catalog.ts` (e.g.
+ * `claude-sonnet-4-6` → `claude-sonnet-4-5`).
+ *
+ * Update one constant here when bumping the platform-wide default —
+ * every workflow step and operator config picks up the new id with a
+ * single rebuild.
+ */
+/** Fast workhorse for content workflows (outline, post, sections). */
+declare const WORKFLOW_FAST_MODEL: "claude-sonnet-4-6";
+/** Premium tier for high-stakes generation (rarely used in workflows). */
+declare const WORKFLOW_PREMIUM_MODEL: "claude-opus-4-6";
+/** Cheap-and-quick for short outputs like titles. */
+declare const WORKFLOW_TINY_MODEL: "claude-haiku-4-5-20251001";
+/**
+ * Models eligible for operator agents (an app). Keep in sync with the
+ * agent-framework's model-provider config. The literal tuple drives the
+ * `OperatorAgentModel` union type below.
+ */
+declare const OPERATOR_AGENT_MODELS: readonly ["claude-opus-4-5", "claude-sonnet-4-5", "gemini-3.1-pro-preview"];
+type OperatorAgentModel = (typeof OPERATOR_AGENT_MODELS)[number];
+/** Default operator model when no explicit choice is made. */
+declare const OPERATOR_DEFAULT_PREMIUM: OperatorAgentModel;
+declare const OPERATOR_DEFAULT_STANDARD: OperatorAgentModel;
+declare const OPERATOR_DEFAULT_GEMINI: OperatorAgentModel;
+declare const LLM_TIERS: {
+    /** Cheap-and-quick. Single-model fallback. */
+    readonly nano: readonly ["mistral-small-creative-latest"];
+    /** Low-cost, agentic-capable. Direct alt-providers. */
+    readonly mini: readonly ["MiniMax-M2.5", "MiniMax-M2.1", "MiniMax-M2", "mistral-large-latest"];
+    /** Medium cost, fast inference + good general perf. OpenRouter-routed. */
+    readonly lite: readonly ["x-ai/grok-4-fast", "xiaomi/mimo-v2-flash", "google/gemini-3-flash-preview"];
+    /** High quality, premium features. Mix of direct + OpenRouter. */
+    readonly plus: readonly ["claude-sonnet-4-5", "gpt-4o", "kimi-k2.5", "deepseek/deepseek-v3.2"];
+    /** Top-tier, best performance. */
+    readonly pro: readonly ["claude-opus-4-5", "google/gemini-3.1-pro-preview", "kimi-k2-thinking"];
+};
+type LlmTierName = keyof typeof LLM_TIERS;
+
+export { LLM_TIERS, type LlmTierName, OPERATOR_AGENT_MODELS, OPERATOR_DEFAULT_GEMINI, OPERATOR_DEFAULT_PREMIUM, OPERATOR_DEFAULT_STANDARD, type OperatorAgentModel, WORKFLOW_FAST_MODEL, WORKFLOW_PREMIUM_MODEL, WORKFLOW_TINY_MODEL };

package/dist/llm/index.mjs

@@ -0,0 +1,4 @@
+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';
+import '../chunk-QHELXPSL.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/llm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/overlay/index.d.ts

@@ -0,0 +1,67 @@
+import { b as LLMPricing } from '../catalog-aQHd559b.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 'zod';
+import '../audio-BzVF_wke.js';
+
+/**
+ * Consumer catalog overlays.
+ *
+ * The OSS core ships only generated, provider-native data. Anything
+ * app-specific — legacy alias slugs persisted in an app's DB (e.g. a product's
+ * legacy voice ids), a private fine-tune, a renamed model — is registered
+ * by the consumer at boot as an **overlay**, never patched into the core data.
+ *
+ *   import { registerCatalogOverlay } from "@agentproto/model-catalog/overlay"
+ *   registerCatalogOverlay({
+ *     aliases: { "legacy-voice-1": "minimax-french-female-anchor" },
+ *     image: { "my-finetune": { …ImageModelDefinition } },
+ *   })
+ *
+ * The registry (`getModel` / `resolveAlias` / `listModels`) consults the merged
+ * overlay first, then falls through to the generated catalogs. Registration is
+ * additive and idempotent-by-key (a later overlay overrides an earlier one for
+ * the same id). `clearCatalogOverlays()` resets — used by tests.
+ */
+
+interface CatalogOverlay {
+    /**
+     * Extra alias → canonical-id mappings, any kind. Resolution is followed
+     * (chains collapse), so `{ "legacy-voice-1": "minimax-…" }` makes `getModel`,
+     * `resolveAlias`, and `isAgentVisible` all treat `legacy-voice-1` as the minimax
+     * voice. The target should be a real id in the core catalog or this overlay.
+     */
+    aliases?: Record<string, string>;
+    /** Extra or overriding LLM pricing entries, keyed by model id. */
+    llm?: Record<string, LLMPricing>;
+    /** Extra or overriding image model entries, keyed by model id. */
+    image?: Record<string, ImageModelDefinition>;
+    /** Extra or overriding video model entries, keyed by model id. */
+    video?: Record<string, VideoModelDefinition>;
+    /** Extra or overriding audio model entries, keyed by model id. */
+    audio?: Record<string, AudioModelDefinition>;
+    /** Extra voices (matched by catalogId / providerVoiceId / their aliases). */
+    voice?: CatalogVoice[];
+}
+/** The merged, registered overlay state. Same shape as a single overlay but
+ *  with all registrations folded in (last-write-wins per key). */
+interface MergedOverlay {
+    aliases: Record<string, string>;
+    llm: Record<string, LLMPricing>;
+    image: Record<string, ImageModelDefinition>;
+    video: Record<string, VideoModelDefinition>;
+    audio: Record<string, AudioModelDefinition>;
+    voice: CatalogVoice[];
+}
+/** Register a consumer overlay. Folds into the merged state; later
+ *  registrations override earlier ones for the same id. */
+declare function registerCatalogOverlay(overlay: CatalogOverlay): void;
+/** The current merged overlay. Read-only snapshot for the registry. */
+declare function getMergedOverlay(): MergedOverlay;
+/** Reset all overlays (tests / re-init). */
+declare function clearCatalogOverlays(): void;
+
+export { type CatalogOverlay, type MergedOverlay, clearCatalogOverlays, getMergedOverlay, registerCatalogOverlay };

package/dist/overlay/index.mjs

@@ -0,0 +1,3 @@
+export { clearCatalogOverlays, getMergedOverlay, registerCatalogOverlay } from '../chunk-H6JUTF3U.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/overlay/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/picker/index.d.ts

@@ -0,0 +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 '../image/index.js';
+import '../video/index.js';
+import '../audio/index.js';
+import '../audio-BzVF_wke.js';
+import 'zod';
+import '../schema/voice.js';

package/dist/picker/index.mjs

@@ -0,0 +1,26 @@
+/**
+ * @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/picker/index.ts
+var PRICE_TIER_SLOTS = 5;
+var PRICE_TIER_NAMES = [
+  "Low",
+  "Medium",
+  "High",
+  "Max",
+  "Ultra"
+];
+function priceTierName(level) {
+  return PRICE_TIER_NAMES[level - 1] ?? "";
+}
+function priceTierBar(level, slots = PRICE_TIER_SLOTS) {
+  const n = Math.max(0, Math.min(level, slots));
+  return "\u25B0".repeat(n) + "\u25B1".repeat(slots - n);
+}
+
+export { PRICE_TIER_NAMES, PRICE_TIER_SLOTS, priceTierBar, priceTierName };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/picker/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/picker/index.ts"],"names":[],"mappings":";;;;;;;AA4EO,IAAM,gBAAA,GAAmB;AAMzB,IAAM,gBAAA,GAAmB;AAAA,EAC9B,KAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF;AAGO,SAAS,cAAc,KAAA,EAAuB;AACnD,EAAA,OAAO,gBAAA,CAAiB,KAAA,GAAQ,CAAC,CAAA,IAAK,EAAA;AACxC;AAMO,SAAS,YAAA,CAAa,KAAA,EAAe,KAAA,GAAQ,gBAAA,EAA0B;AAC5E,EAAA,MAAM,CAAA,GAAI,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,GAAA,CAAI,KAAA,EAAO,KAAK,CAAC,CAAA;AAC5C,EAAA,OAAO,SAAI,MAAA,CAAO,CAAC,IAAI,QAAA,CAAI,MAAA,CAAO,QAAQ,CAAC,CAAA;AAC7C","file":"index.mjs","sourcesContent":["/**\n * Picker subpath — wire shapes returned by the per-app\n * `GET /models/available` route. Single source of truth shared by:\n *   - the server-side helper (an app-side model-access helper)\n *   - the per-app SDK clients (e.g. an app SDK client)\n *   - the cross-app picker hook (an app picker hook)\n *\n * Without this single source the hook + SDK previously drifted from\n * the API contract and a fetcher in the app silently kept calling\n * with a stale auth pattern after the cookie-auth migration.\n */\n\nimport type { AccessDecision } from \"../access/index.js\"\nimport type { ModelEnrichment } from \"../enrichment/index.js\"\nimport type { ModelKind } from \"../schema/index.js\"\n\nexport interface AvailableModelCapabilities {\n  generate?: boolean\n  edit?: boolean\n  upscale?: boolean\n  textToVideo?: boolean\n  imageToVideo?: boolean\n  audio?: boolean\n  subjectReference?: boolean\n  tts?: boolean\n  stt?: boolean\n  s2s?: boolean\n}\n\nexport interface AvailableModel {\n  id: string\n  /** Canonical model id (LLM aliases collapse here). */\n  canonicalId: string\n  /**\n   * Priced model kind. Typed `ModelKind` (not `CatalogKind`) on purpose: the\n   * picker never surfaces `voice` rows as `AvailableModel` — voices reach the\n   * UI through a separate path — so `voice` is intentionally out of range here.\n   */\n  kind: ModelKind\n  displayName: string\n  description: string\n  enrichment: ModelEnrichment\n  decision: AccessDecision\n  capabilities: AvailableModelCapabilities\n  /** Recommended pricing display (per provider unit). */\n  pricingHint?: string\n  /**\n   * Audio models only: cost normalized to **per minute of speech**, the\n   * intuitive unit for the voice picker. TTS (billed per 1k chars) is\n   * converted via an assumed speaking rate; per-minute models pass through.\n   */\n  voiceHint?: string\n  /**\n   * Relative price gauge level (1..{@link PRICE_TIER_SLOTS}) from\n   * `priceTierForModel` — the visual \"price mostly\" indicator the picker\n   * renders as a segmented bar instead of a raw number. 0 when unknown.\n   */\n  priceTier?: number\n  /** Localized-agnostic tier name for `priceTier` (e.g. `\"High\"`). */\n  priceTierName?: string\n}\n\nexport interface AvailableConnector {\n  id: string\n  name: string\n  /** Whether the actor's guild/workspace has a connected credential for this provider. */\n  byokAvailable: boolean\n  models: AvailableModel[]\n}\n\n// ── Price-tier gauge ─────────────────────────────────────────────────────────\n// A relative, comparative price indicator (\"price mostly\") — a 1..N level\n// (from `priceTierForModel`) shown as a filled/empty bar instead of an exact\n// number. This module owns the gauge's shape: slot count, names, rendering.\n\n/** Number of segments in the price gauge. */\nexport const PRICE_TIER_SLOTS = 5\n\n/**\n * Display names for levels 1..{@link PRICE_TIER_SLOTS}, ascending price. Kept\n * as brand tokens (not localized) so the gauge reads the same everywhere.\n */\nexport const PRICE_TIER_NAMES = [\n  \"Low\",\n  \"Medium\",\n  \"High\",\n  \"Max\",\n  \"Ultra\",\n] as const\n\n/** Name for a gauge level (1-based); empty string when out of range. */\nexport function priceTierName(level: number): string {\n  return PRICE_TIER_NAMES[level - 1] ?? \"\"\n}\n\n/**\n * Unicode price gauge (e.g. `▰▰▱▱▱`) for text-only surfaces (WhatsApp, logs).\n * Rich UIs read {@link AvailableModel.priceTier} and render styled segments.\n */\nexport function priceTierBar(level: number, slots = PRICE_TIER_SLOTS): string {\n  const n = Math.max(0, Math.min(level, slots))\n  return \"▰\".repeat(n) + \"▱\".repeat(slots - n)\n}\n\nexport interface AvailableModelsActor {\n  appId: string\n  userId: string\n  tier?: string\n  guildId?: string\n}\n\nexport interface AvailableModelsResponse {\n  success: true\n  actor: AvailableModelsActor\n  connectors: AvailableConnector[]\n}\n\nexport interface ListAvailableModelsParams {\n  /** Restrict to one or more kinds. Empty = all kinds. */\n  kind?: ModelKind | ModelKind[]\n  /** Guild scope — joins guild-level connectors for BYOK badges. */\n  guildId?: string\n  /** Include rules-blocked models (decision.allowed=false). Default true. */\n  includeBlocked?: boolean\n  /** Include catalog entries with agentVisible=false. Default false. */\n  includeHidden?: boolean\n  /**\n   * Curation surface-profile id (`voice-s2s`, `images`, …) the app exposes.\n   * Resolved server-side via `getSurfaceProfile`. Omitted = full catalog.\n   */\n  surface?: string\n}\n"]}

package/dist/pricing/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Pricing registry — single source of truth for the formula that turns
+ * a provider's USD cost into centicredits charged to the user.
+ *
+ *   centicredits = max(floor_cc, ceil(baseCost × markup / CC_USD_RATE))
+ *
+ * Unit: **centicredits (cc)** throughout. 1 displayed credit = 100 cc.
+ * Internal ledger column (`credit_transactions.credits`) stores cc, so
+ * dispatcher output flows straight into the ledger with no per-call
+ * `× 100` conversion. UI surfaces format cc → displayed credits at the
+ * render boundary via `displayCredits(cc) → cr`.
+ *
+ * Why a registry (not constants):
+ *   - The DEFAULTS work across apps. Most consumers (image gen, STT,
+ *     etc.) need exactly the same markup ratios regardless of which
+ *     app called them.
+ *   - But apps want overrides — one app might want a lower video markup
+ *     during a promo, another a higher one because their
+ *     users skew heavier. `registerApp(appId, { video: 1.8 })` slots
+ *     in without changing the catalog or the cost dispatcher.
+ *   - Per-model `overrideCreditCost` is the third lever — a specific
+ *     model can opt out of the formula entirely for strategic reasons
+ *     (subsidized adoption, partner pricing).
+ *
+ * Lever priority (highest to lowest):
+ *   1. `model.overrideCreditCost` — explicit cc-per-call, catalog entry
+ *   2. app-scoped markup       — `registerApp(appId, partial)`
+ *   3. core default markup     — `DEFAULT_PRICING_MARKUP`
+ *
+ * Currency: all provider rates are USD. 1 displayed credit = €0.01
+ * retail ≈ $0.0108. Multi-currency selling prices live in per-app
+ * plans-data — the markup formula itself stays USD-anchored.
+ */
+/**
+ * Conversion: USD ↔ displayed credit. 1 displayed credit = €0.01
+ * retail at pack rate. Prefer `CC_USD_RATE` for credit math — it
+ * matches the cc unit the dispatcher emits.
+ */
+declare const CREDIT_USD_RATE = 0.0108;
+/**
+ * USD per centicredit. 1 cc = 1/100 of a displayed credit, so
+ * `CC_USD_RATE = CREDIT_USD_RATE / 100`. Pre-computed once so the hot
+ * `× markup / CC_USD_RATE` divide doesn't repeat the constant math.
+ */
+declare const CC_USD_RATE: number;
+type PricingCategory = "image" | "video" | "audio" | "text" | "search";
+interface PricingMarkup {
+    /** Per-category markup applied to `baseCost` before USD→cc conversion. */
+    markup: Partial<Record<PricingCategory, number>>;
+    /**
+     * Minimum centicredits debited per action (protects against
+     * fractional rounding). Default 1 cc = 0.01 displayed credit.
+     */
+    floor: Partial<Record<PricingCategory, number>>;
+}
+/**
+ * Core defaults — what every app gets if it doesn't register
+ * overrides. Tuned for ~50%+ gross margin at pack-rate revenue.
+ *
+ * Adjusting these affects EVERY app — don't tweak without coordinating
+ * across apps. Per-app drift goes through
+ * `registerApp()`.
+ */
+declare const DEFAULT_PRICING_MARKUP: Required<PricingMarkup["markup"]>;
+declare const DEFAULT_PRICING_FLOORS: Required<PricingMarkup["floor"]>;
+/**
+ * Registry of app-scoped pricing overrides. Defaults flow through when
+ * an app doesn't register; partial overrides merge per-category.
+ */
+declare class PricingRegistry {
+    private apps;
+    registerApp(appId: string, overrides: PricingMarkup): void;
+    unregisterApp(appId: string): void;
+    /**
+     * Remove all registered app overrides, restoring core defaults.
+     * Call in `afterEach` hooks to prevent cross-test contamination
+     * (the singleton persists across tests in the same Vitest worker).
+     */
+    reset(): void;
+    getMarkup(category: PricingCategory, appId?: string): number;
+    getFloor(category: PricingCategory, appId?: string): number;
+    /** Resolve the full PricingMarkup for an app (with defaults filled in). */
+    resolve(appId?: string): Required<PricingMarkup>;
+}
+declare const pricingRegistry: PricingRegistry;
+/**
+ * Formula — turn provider USD cost into **centicredits**.
+ *
+ * Honors (in priority): `overrideCreditCost` → app markup → default
+ * markup. Always applies the floor (in cc).
+ *
+ * Returns: cc per call (e.g. 53 cc = 0.53 displayed credits).
+ */
+declare function computeCenticredits(args: {
+    baseCostUsd: number;
+    category: PricingCategory;
+    /**
+     * Per-model centicredit override. When set, bypasses the formula —
+     * use for strategic deviations (subsidized adoption, partner
+     * pricing). Unit: cc per call.
+     */
+    overrideCreditCost?: number;
+    appId?: string;
+}): number;
+
+export { CC_USD_RATE, CREDIT_USD_RATE, DEFAULT_PRICING_FLOORS, DEFAULT_PRICING_MARKUP, type PricingCategory, type PricingMarkup, computeCenticredits, pricingRegistry };

package/dist/pricing/index.mjs

@@ -0,0 +1,3 @@
+export { CC_USD_RATE, CREDIT_USD_RATE, DEFAULT_PRICING_FLOORS, DEFAULT_PRICING_MARKUP, computeCenticredits, pricingRegistry } from '../chunk-QHELXPSL.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/pricing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/providers/index.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { CatalogVoice } from '../schema/voice.js';
+
+/**
+ * ElevenLabs raw → CatalogVoice mapper.
+ *
+ * The single source of "how an ElevenLabs `/v1/voices` entry becomes a
+ * `CatalogVoice`". Used in two places:
+ *   - build time, by `@agentproto/catalog-sync` to emit the full baseline
+ *     voice list from a pinned snapshot;
+ *   - runtime, by the live-on-setup path (`agentproto auth provider set
+ *     elevenlabs`) to turn a freshly-fetched account voice library into the
+ *     local overlay cache.
+ *
+ * Pure + deterministic — no network, no fs. The raw schema validates both the
+ * pinned snapshot and a live response so a provider shape-change surfaces as a
+ * parse error, not silent data loss.
+ */
+
+declare const ElevenLabsRawVoiceSchema: z.ZodObject<{
+    voice_id: z.ZodString;
+    name: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    labels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    preview_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+type ElevenLabsRawVoice = z.infer<typeof ElevenLabsRawVoiceSchema>;
+declare const ElevenLabsVoicesSnapshotSchema: z.ZodObject<{
+    voices: z.ZodArray<z.ZodObject<{
+        voice_id: z.ZodString;
+        name: z.ZodString;
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        labels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        preview_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+type ElevenLabsVoicesSnapshot = z.infer<typeof ElevenLabsVoicesSnapshotSchema>;
+/** Map one raw ElevenLabs voice to a `CatalogVoice`. */
+declare function mapElevenLabsVoice(raw: ElevenLabsRawVoice): CatalogVoice;
+/** Map a full `/v1/voices` snapshot to the baseline voice list. */
+declare function mapElevenLabsVoices(snapshot: ElevenLabsVoicesSnapshot): CatalogVoice[];
+
+/**
+ * MiniMax raw → CatalogVoice mapper.
+ *
+ * Single source of "how a MiniMax `/v1/get_voice` system voice becomes a
+ * `CatalogVoice`". Shared by `@agentproto/catalog-sync` (build-time baseline
+ * emit) and the runtime live-on-setup path. Pure + deterministic.
+ */
+
+declare const MinimaxSystemVoiceSchema: z.ZodObject<{
+    voice_id: z.ZodString;
+    voice_name: z.ZodString;
+    description: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    created_time: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type MinimaxSystemVoice = z.infer<typeof MinimaxSystemVoiceSchema>;
+declare const MinimaxVoicesSnapshotSchema: z.ZodObject<{
+    system_voice: z.ZodArray<z.ZodObject<{
+        voice_id: z.ZodString;
+        voice_name: z.ZodString;
+        description: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        created_time: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    base_resp: z.ZodOptional<z.ZodObject<{
+        status_code: z.ZodNumber;
+        status_msg: z.ZodString;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type MinimaxVoicesSnapshot = z.infer<typeof MinimaxVoicesSnapshotSchema>;
+/** Map one raw MiniMax system voice to a `CatalogVoice`. */
+declare function mapMinimaxVoice(raw: MinimaxSystemVoice): CatalogVoice;
+/** Map a full `/v1/get_voice` snapshot to the baseline voice list. */
+declare function mapMinimaxVoices(snapshot: MinimaxVoicesSnapshot): CatalogVoice[];
+
+export { type ElevenLabsRawVoice, ElevenLabsRawVoiceSchema, type ElevenLabsVoicesSnapshot, ElevenLabsVoicesSnapshotSchema, type MinimaxSystemVoice, MinimaxSystemVoiceSchema, type MinimaxVoicesSnapshot, MinimaxVoicesSnapshotSchema, mapElevenLabsVoice, mapElevenLabsVoices, mapMinimaxVoice, mapMinimaxVoices };