@x12i/ai-tools 1.0.4 → 2.0.0

package/dist/cost/index.d.cts

@@ -1,53 +1,13 @@
-import { b as AliasRegistry, h as ModelResolverOptions } from '../types-CX6QFNNy.cjs';
-import { A as AiModelsCatalogClient } from '../AiModelsCatalogClient-CNeqFiFs.cjs';
-import { A as AiModelPricing } from '../types-BYXnCvKx.cjs';
-export { a as AiModelRecord } from '../types-BYXnCvKx.cjs';
-import '@x12i/catalox';
+import { a as AiCostResult, d as AiUsageInput, A as AiCostExtraction, f as ExtractUsageInputResult } from '../resolveUsageModel-C_YmGR1M.cjs';
+export { b as AiCostWarning, c as AiCostWarningCode, C as CostCalculator, e as CostCalculatorOptions, E as ExtractUsageInputOptions, F as FieldProvenance, M as MODEL_FIELD_PRIORITY, T as TokenExtractionProvenance, g as extractUsageInput, r as resolveUsageModel } from '../resolveUsageModel-C_YmGR1M.cjs';
+export { A as AiModelPricing, a as AiModelRecord } from '../types-BrzJWsTU.cjs';
+import '../AiModelsCatalogClient-B5FMI9gj.cjs';
 
-type AiUsageInput = {
-    tokens: {
-        prompt: number;
-        completion: number;
-        total: number;
-        cached?: number;
-        cacheWrite?: number;
-        reasoning?: number;
-        audio?: number;
-        image?: number;
-    };
-    provider: string;
-    modelUsed: string;
-};
-type AiCostResult = {
-    cost: number;
-    breakdown?: {
-        promptCostUsd: number;
-        completionCostUsd: number;
-        cachingCostUsd?: number;
-        reasoningCostUsd?: number;
-        audioCostUsd?: number;
-        imageCostUsd?: number;
-        requestFlatCostUsd?: number;
-    };
-    resolvedModelId: string;
-    routedViaOpenRouter: boolean;
-    isAuthoritative: boolean;
-    pricingSnapshot: AiModelPricing;
-    source: "catalog" | "estimate-fallback";
-};
+declare function toCostExtraction(provenance: ExtractUsageInputResult["provenance"]): AiCostExtraction;
+/** Attach usage, provider, and model fields callers expect on every cost response. */
+declare function enrichCostResult(result: Omit<AiCostResult, "usage" | "provider" | "usedModel" | "model" | "extraction">, input: AiUsageInput, extraction?: AiCostExtraction): AiCostResult;
 
-type CostCalculatorOptions = {
-    aliasRegistry?: AliasRegistry;
-    includeBreakdown?: boolean;
-    resolverOptions?: ModelResolverOptions;
-};
-declare class CostCalculator {
-    private readonly catalog;
-    private readonly aliasRegistry?;
-    private readonly includeBreakdown;
-    private readonly resolverOptions?;
-    constructor(catalog: AiModelsCatalogClient, options?: CostCalculatorOptions);
-    calculate(input: AiUsageInput): Promise<AiCostResult>;
-}
+/** Default OpenRouter platform surcharge when catalog markup fields are absent (5%). */
+declare const DEFAULT_OPENROUTER_MARKUP_RATE = 0.05;
 
-export { type AiCostResult, AiModelPricing, type AiUsageInput, CostCalculator, type CostCalculatorOptions };
+export { AiCostExtraction, AiCostResult, AiUsageInput, DEFAULT_OPENROUTER_MARKUP_RATE, ExtractUsageInputResult, enrichCostResult, toCostExtraction };

package/dist/cost/index.d.ts

@@ -1,53 +1,13 @@
-import { b as AliasRegistry, h as ModelResolverOptions } from '../types-CuiPDcVs.js';
-import { A as AiModelsCatalogClient } from '../AiModelsCatalogClient-nwFoEaqL.js';
-import { A as AiModelPricing } from '../types-BYXnCvKx.js';
-export { a as AiModelRecord } from '../types-BYXnCvKx.js';
-import '@x12i/catalox';
+import { a as AiCostResult, d as AiUsageInput, A as AiCostExtraction, f as ExtractUsageInputResult } from '../resolveUsageModel-BFwf80Hz.js';
+export { b as AiCostWarning, c as AiCostWarningCode, C as CostCalculator, e as CostCalculatorOptions, E as ExtractUsageInputOptions, F as FieldProvenance, M as MODEL_FIELD_PRIORITY, T as TokenExtractionProvenance, g as extractUsageInput, r as resolveUsageModel } from '../resolveUsageModel-BFwf80Hz.js';
+export { A as AiModelPricing, a as AiModelRecord } from '../types-BrzJWsTU.js';
+import '../AiModelsCatalogClient-CPPNI6Ry.js';
 
-type AiUsageInput = {
-    tokens: {
-        prompt: number;
-        completion: number;
-        total: number;
-        cached?: number;
-        cacheWrite?: number;
-        reasoning?: number;
-        audio?: number;
-        image?: number;
-    };
-    provider: string;
-    modelUsed: string;
-};
-type AiCostResult = {
-    cost: number;
-    breakdown?: {
-        promptCostUsd: number;
-        completionCostUsd: number;
-        cachingCostUsd?: number;
-        reasoningCostUsd?: number;
-        audioCostUsd?: number;
-        imageCostUsd?: number;
-        requestFlatCostUsd?: number;
-    };
-    resolvedModelId: string;
-    routedViaOpenRouter: boolean;
-    isAuthoritative: boolean;
-    pricingSnapshot: AiModelPricing;
-    source: "catalog" | "estimate-fallback";
-};
+declare function toCostExtraction(provenance: ExtractUsageInputResult["provenance"]): AiCostExtraction;
+/** Attach usage, provider, and model fields callers expect on every cost response. */
+declare function enrichCostResult(result: Omit<AiCostResult, "usage" | "provider" | "usedModel" | "model" | "extraction">, input: AiUsageInput, extraction?: AiCostExtraction): AiCostResult;
 
-type CostCalculatorOptions = {
-    aliasRegistry?: AliasRegistry;
-    includeBreakdown?: boolean;
-    resolverOptions?: ModelResolverOptions;
-};
-declare class CostCalculator {
-    private readonly catalog;
-    private readonly aliasRegistry?;
-    private readonly includeBreakdown;
-    private readonly resolverOptions?;
-    constructor(catalog: AiModelsCatalogClient, options?: CostCalculatorOptions);
-    calculate(input: AiUsageInput): Promise<AiCostResult>;
-}
+/** Default OpenRouter platform surcharge when catalog markup fields are absent (5%). */
+declare const DEFAULT_OPENROUTER_MARKUP_RATE = 0.05;
 
-export { type AiCostResult, AiModelPricing, type AiUsageInput, CostCalculator, type CostCalculatorOptions };
+export { AiCostExtraction, AiCostResult, AiUsageInput, DEFAULT_OPENROUTER_MARKUP_RATE, ExtractUsageInputResult, enrichCostResult, toCostExtraction };

package/dist/cost/index.js

@@ -1,7 +1,22 @@
+import "../chunk-56R4XA2S.js";
 import {
-  CostCalculator
-} from "../chunk-YHO57D2V.js";
+  CostCalculator,
+  DEFAULT_OPENROUTER_MARKUP_RATE,
+  MODEL_FIELD_PRIORITY,
+  enrichCostResult,
+  extractUsageInput,
+  resolveUsageModel,
+  toCostExtraction
+} from "../chunk-U2YDDUVP.js";
+import "../chunk-B3V2EHRY.js";
+import "../chunk-2PTCWPHV.js";
 export {
-  CostCalculator
+  CostCalculator,
+  DEFAULT_OPENROUTER_MARKUP_RATE,
+  MODEL_FIELD_PRIORITY,
+  enrichCostResult,
+  extractUsageInput,
+  resolveUsageModel,
+  toCostExtraction
 };
 //# sourceMappingURL=index.js.map

package/dist/index.cjs

@@ -1,6 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkHN6UAQAEcjs = require('./chunk-HN6UAQAE.cjs');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-5GUKLOEK.cjs');
 
 
 var _chunk5HNFAYTOcjs = require('./chunk-5HNFAYTO.cjs');
@@ -8,53 +6,62 @@ var _chunk5HNFAYTOcjs = require('./chunk-5HNFAYTO.cjs');
 
 
 
-var _chunkLYOU7CA2cjs = require('./chunk-LYOU7CA2.cjs');
+
+var _chunkPRCICORGcjs = require('./chunk-PRCICORG.cjs');
 require('./chunk-3E67S427.cjs');
+require('./chunk-2PYACSZ5.cjs');
 
 
+var _chunkXOKUDUUIcjs = require('./chunk-XOKUDUUI.cjs');
+
+
+
+
+
+var _chunkNF2SKQR7cjs = require('./chunk-NF2SKQR7.cjs');
+
+
+
+var _chunkBAHBDADJcjs = require('./chunk-BAHBDADJ.cjs');
+
 
-var _chunkQWAX7VQOcjs = require('./chunk-QWAX7VQO.cjs');
-require('./chunk-2PYACSZ5.cjs');
 
 
 
+var _chunkYQDSN6R6cjs = require('./chunk-YQDSN6R6.cjs');
 
 
-var _chunkQCRLKVB3cjs = require('./chunk-QCRLKVB3.cjs');
-require('./chunk-C3H7RTFR.cjs');
 
+var _chunkXAWBTX3Ncjs = require('./chunk-XAWBTX3N.cjs');
 
 
 
 
-var _chunkHS74X2OJcjs = require('./chunk-HS74X2OJ.cjs');
 
 
 
 
-var _chunkDKHGWHXPcjs = require('./chunk-DKHGWHXP.cjs');
-require('./chunk-FGP3QXWL.cjs');
 
+var _chunk5XAAMBDOcjs = require('./chunk-5XAAMBDO.cjs');
 
 
 
 
 
 
-var _chunkAV6OE2YQcjs = require('./chunk-AV6OE2YQ.cjs');
 
+var _chunkDXZOL3VNcjs = require('./chunk-DXZOL3VN.cjs');
 
-var _chunkF2F4UEFDcjs = require('./chunk-F2F4UEFD.cjs');
 
 
 
 
+var _chunkEDMCKHO6cjs = require('./chunk-EDMCKHO6.cjs');
 
 
 
 
 
-var _chunkTF4L2NECcjs = require('./chunk-TF4L2NEC.cjs');
 
 
 
@@ -62,11 +69,12 @@ var _chunkTF4L2NECcjs = require('./chunk-TF4L2NEC.cjs');
 
 
 
+var _chunkPADNCGZBcjs = require('./chunk-PADNCGZB.cjs');
+require('./chunk-GS7T56RP.cjs');
 
 
 
 
-var _chunk7Q742NI3cjs = require('./chunk-7Q742NI3.cjs');
 
 
 
@@ -111,5 +119,5 @@ var _chunk7Q742NI3cjs = require('./chunk-7Q742NI3.cjs');
 
 
 
-exports.AIToolbox = _chunk5HNFAYTOcjs.AIToolbox; exports.AI_MODELS_CATALOG_ID = _chunkTF4L2NECcjs.AI_MODELS_CATALOG_ID; exports.AI_MODELS_DESCRIPTOR = _chunkTF4L2NECcjs.AI_MODELS_DESCRIPTOR; exports.AI_TOOLS_APP_ID = _chunkTF4L2NECcjs.AI_TOOLS_APP_ID; exports.AiModelsCatalogClient = _chunkF2F4UEFDcjs.AiModelsCatalogClient; exports.AiModelsService = _chunkQCRLKVB3cjs.AiModelsService; exports.AiToolsError = _chunk7Q742NI3cjs.AiToolsError; exports.AliasConflictError = _chunk7Q742NI3cjs.AliasConflictError; exports.AliasFileParseError = _chunk7Q742NI3cjs.AliasFileParseError; exports.AliasFileWriteError = _chunk7Q742NI3cjs.AliasFileWriteError; exports.AliasInvalidNameError = _chunk7Q742NI3cjs.AliasInvalidNameError; exports.AliasNotFoundError = _chunk7Q742NI3cjs.AliasNotFoundError; exports.AliasRegistry = _chunkQWAX7VQOcjs.AliasRegistry; exports.AliasResolver = _chunkQWAX7VQOcjs.AliasResolver; exports.CatalogSyncJobError = _chunkHS74X2OJcjs.CatalogSyncJobError; exports.CostCalculationError = _chunk7Q742NI3cjs.CostCalculationError; exports.CostCalculator = _chunkHN6UAQAEcjs.CostCalculator; exports.ModelNameResolver = _chunkTF4L2NECcjs.ModelNameResolver; exports.ModelNotFoundError = _chunk7Q742NI3cjs.ModelNotFoundError; exports.ModelResolutionError = _chunk7Q742NI3cjs.ModelResolutionError; exports.OpenRouterSyncProvider = _chunkDKHGWHXPcjs.OpenRouterSyncProvider; exports.REASONING_SUPPORTED_PARAMETERS = _chunkAV6OE2YQcjs.REASONING_SUPPORTED_PARAMETERS; exports.SyncError = _chunk7Q742NI3cjs.SyncError; exports.computeSupportsReasoning = _chunkAV6OE2YQcjs.computeSupportsReasoning; exports.countModels = _chunkQCRLKVB3cjs.countModels; exports.createModelNameResolver = _chunkLYOU7CA2cjs.createModelNameResolver; exports.ensureAiModelsCatalog = _chunkDKHGWHXPcjs.ensureAiModelsCatalog; exports.filterModels = _chunkQCRLKVB3cjs.filterModels; exports.getModelInfo = _chunkQCRLKVB3cjs.getModelInfo; exports.hasReasoningPricing = _chunkAV6OE2YQcjs.hasReasoningPricing; exports.isReasoningModel = _chunkAV6OE2YQcjs.isReasoningModel; exports.isRoutedViaOpenRouter = _chunkLYOU7CA2cjs.isRoutedViaOpenRouter; exports.loadOpenRouterRoutingEnv = _chunkTF4L2NECcjs.loadOpenRouterRoutingEnv; exports.normalizeOpenRouterModel = _chunkAV6OE2YQcjs.normalizeOpenRouterModel; exports.providerIdToEnvKeyPrefix = _chunkTF4L2NECcjs.providerIdToEnvKeyPrefix; exports.pruneStaleCatalogModels = _chunkHS74X2OJcjs.pruneStaleCatalogModels; exports.resolveModel = _chunkLYOU7CA2cjs.resolveModel; exports.runAiModelsCatalogSync = _chunkHS74X2OJcjs.runAiModelsCatalogSync; exports.shouldDefaultRouteViaOpenRouter = _chunkTF4L2NECcjs.shouldDefaultRouteViaOpenRouter; exports.supportsReasoningParameter = _chunkAV6OE2YQcjs.supportsReasoningParameter; exports.syncAiModelsCatalog = _chunkDKHGWHXPcjs.syncAiModelsCatalog; exports.vendorApiKeyEnvName = _chunkTF4L2NECcjs.vendorApiKeyEnvName; exports.verifyAiModelsCatalog = _chunkHS74X2OJcjs.verifyAiModelsCatalog;
+exports.AIToolbox = _chunk5HNFAYTOcjs.AIToolbox; exports.AiModelsCatalogClient = _chunk5XAAMBDOcjs.AiModelsCatalogClient; exports.AiModelsService = _chunkYQDSN6R6cjs.AiModelsService; exports.AiToolsError = _chunkPADNCGZBcjs.AiToolsError; exports.AliasConflictError = _chunkPADNCGZBcjs.AliasConflictError; exports.AliasFileParseError = _chunkPADNCGZBcjs.AliasFileParseError; exports.AliasFileWriteError = _chunkPADNCGZBcjs.AliasFileWriteError; exports.AliasInvalidNameError = _chunkPADNCGZBcjs.AliasInvalidNameError; exports.AliasNotFoundError = _chunkPADNCGZBcjs.AliasNotFoundError; exports.AliasRegistry = _chunkBAHBDADJcjs.AliasRegistry; exports.AliasResolver = _chunkBAHBDADJcjs.AliasResolver; exports.CostCalculationError = _chunkPADNCGZBcjs.CostCalculationError; exports.CostCalculator = _chunkNF2SKQR7cjs.CostCalculator; exports.DEFAULT_CATALOG_CACHE_TTL_MS = _chunk5XAAMBDOcjs.DEFAULT_CATALOG_CACHE_TTL_MS; exports.DEFAULT_DIRECT_CATALOG_URL = _chunk5XAAMBDOcjs.DEFAULT_DIRECT_CATALOG_URL; exports.DEFAULT_OPENROUTER_CATALOG_URL = _chunk5XAAMBDOcjs.DEFAULT_OPENROUTER_CATALOG_URL; exports.MODEL_FIELD_PRIORITY = _chunkNF2SKQR7cjs.MODEL_FIELD_PRIORITY; exports.ModelNameResolver = _chunkDXZOL3VNcjs.ModelNameResolver; exports.ModelNotFoundError = _chunkPADNCGZBcjs.ModelNotFoundError; exports.ModelResolutionError = _chunkPADNCGZBcjs.ModelResolutionError; exports.OpenRouterSyncProvider = _chunkPRCICORGcjs.OpenRouterSyncProvider; exports.REASONING_SUPPORTED_PARAMETERS = _chunkDXZOL3VNcjs.REASONING_SUPPORTED_PARAMETERS; exports.SyncError = _chunkPADNCGZBcjs.SyncError; exports.UnknownModelCostError = _chunkPADNCGZBcjs.UnknownModelCostError; exports.computeSupportsReasoning = _chunkDXZOL3VNcjs.computeSupportsReasoning; exports.countModels = _chunkYQDSN6R6cjs.countModels; exports.createModelNameResolver = _chunkPRCICORGcjs.createModelNameResolver; exports.extractUsageInput = _chunkNF2SKQR7cjs.extractUsageInput; exports.filterModels = _chunkYQDSN6R6cjs.filterModels; exports.getModelInfo = _chunkYQDSN6R6cjs.getModelInfo; exports.hasReasoningPricing = _chunkDXZOL3VNcjs.hasReasoningPricing; exports.invalidateCatalogLoadCache = _chunk5XAAMBDOcjs.invalidateCatalogLoadCache; exports.isReasoningModel = _chunkDXZOL3VNcjs.isReasoningModel; exports.isRoutedViaOpenRouter = _chunkPRCICORGcjs.isRoutedViaOpenRouter; exports.loadCatalogSources = _chunk5XAAMBDOcjs.loadCatalogSources; exports.loadCatalogSourcesCached = _chunk5XAAMBDOcjs.loadCatalogSourcesCached; exports.loadOpenRouterRoutingEnv = _chunkEDMCKHO6cjs.loadOpenRouterRoutingEnv; exports.normalizeOpenRouterModel = _chunkXOKUDUUIcjs.normalizeOpenRouterModel; exports.providerIdToEnvKeyPrefix = _chunkEDMCKHO6cjs.providerIdToEnvKeyPrefix; exports.refreshAiModelsCatalog = _chunkXAWBTX3Ncjs.refreshAiModelsCatalog; exports.resolveCatalogCacheTtlMs = _chunk5XAAMBDOcjs.resolveCatalogCacheTtlMs; exports.resolveModel = _chunkPRCICORGcjs.resolveModel; exports.resolveUsageModel = _chunkNF2SKQR7cjs.resolveUsageModel; exports.shouldDefaultRouteViaOpenRouter = _chunkEDMCKHO6cjs.shouldDefaultRouteViaOpenRouter; exports.supportsReasoningParameter = _chunkDXZOL3VNcjs.supportsReasoningParameter; exports.vendorApiKeyEnvName = _chunkEDMCKHO6cjs.vendorApiKeyEnvName; exports.verifyAiModelsCatalog = _chunkXAWBTX3Ncjs.verifyAiModelsCatalog;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,g4FAAC","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/index.cjs"}
+{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/index.cjs"],"names":[],"mappings":"AAAA,yGAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,guGAAC","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/index.cjs"}

package/dist/index.d.cts

@@ -1,19 +1,14 @@
-export { AiCostResult, AiUsageInput, CostCalculator, CostCalculatorOptions } from './cost/index.cjs';
-export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions } from './AiModelsCatalogClient-CNeqFiFs.cjs';
+export { A as AiCostExtraction, a as AiCostResult, b as AiCostWarning, d as AiUsageInput, C as CostCalculator, e as CostCalculatorOptions, E as ExtractUsageInputOptions, f as ExtractUsageInputResult, M as MODEL_FIELD_PRIORITY, g as extractUsageInput, r as resolveUsageModel } from './resolveUsageModel-C_YmGR1M.cjs';
+export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions, L as LoadCatalogOptions, b as LoadedCatalogs, l as loadCatalogSources } from './AiModelsCatalogClient-B5FMI9gj.cjs';
+import { h as ModelResolutionInput, i as ModelResolutionNotFound } from './types-BrzJWsTU.cjs';
+export { A as AiModelPricing, a as AiModelRecord, b as AliasEntry, c as AliasFileSchema, d as AliasRegistry, e as AliasRegistryOptions, f as AliasValidationReport, M as ModelListFilters, g as ModelListResult, j as ModelResolutionResult, k as ModelResolutionSuccess, l as ModelResolverOptions, m as OpenRouterModelApi, n as OpenRouterModelsQuery, r as OpenRouterRoutingConfig, R as ResolutionStrategy, t as ResolvedModel, u as ResolvedModelRef, v as loadOpenRouterRoutingEnv, w as providerIdToEnvKeyPrefix, x as shouldDefaultRouteViaOpenRouter, y as vendorApiKeyEnvName } from './types-BrzJWsTU.cjs';
+export { C as CatalogRefreshOptions, a as CatalogRefreshResult, c as CatalogVerifyOptions, d as CatalogVerifyReport, D as DEFAULT_CATALOG_CACHE_TTL_MS, e as DEFAULT_DIRECT_CATALOG_URL, f as DEFAULT_OPENROUTER_CATALOG_URL, i as invalidateCatalogLoadCache, l as loadCatalogSourcesCached, r as refreshAiModelsCatalog, h as resolveCatalogCacheTtlMs, v as verifyAiModelsCatalog } from './modelCache-CJftI-Ko.cjs';
 export { AiModelsService, AiModelsServiceOptions, REASONING_SUPPORTED_PARAMETERS, ReasoningModelInput, computeSupportsReasoning, countModels, filterModels, getModelInfo, hasReasoningPricing, isReasoningModel, normalizeOpenRouterModel, supportsReasoningParameter } from './models/index.cjs';
-export { A as AiModelPricing, a as AiModelRecord, M as ModelListFilters, b as ModelListResult, c as OpenRouterModelApi, d as OpenRouterModelsQuery } from './types-BYXnCvKx.cjs';
-export { AI_MODELS_CATALOG_ID, AI_MODELS_DESCRIPTOR, AI_TOOLS_APP_ID, CatalogSyncJobError, CatalogSyncJobOptions, CatalogSyncJobResult, CatalogVerifyOptions, CatalogVerifyReport, EnsureAiModelsCatalogOptions, PruneStaleCatalogModelsOptions, PruneStaleCatalogModelsResult, ensureAiModelsCatalog, pruneStaleCatalogModels, runAiModelsCatalogSync, verifyAiModelsCatalog } from './catalog/index.cjs';
-export { M as ModelNameResolver, O as OpenRouterSyncProvider, a as OpenRouterSyncProviderOptions, c as createModelNameResolver, i as isRoutedViaOpenRouter, r as resolveModel } from './modelNameResolver-D9V_GfUK.cjs';
-export { S as SyncOptions, a as SyncResult, s as syncAiModelsCatalog } from './syncAiModelsCatalog-CnXRLm2c.cjs';
+export { M as ModelNameResolver, O as OpenRouterSyncProvider, a as OpenRouterSyncProviderOptions, c as createModelNameResolver, i as isRoutedViaOpenRouter, r as resolveModel } from './modelNameResolver-C5CSTGFF.cjs';
 export { AIToolbox, AiToolboxOptions, Fallback, FallbackChain, Guard, GuardConfig, RouteRule, Router, TrackResult, Tracker } from './toolbox/index.cjs';
-import { M as ModelResolutionInput, e as ModelResolutionNotFound } from './types-CX6QFNNy.cjs';
-export { A as AliasEntry, a as AliasFileSchema, b as AliasRegistry, c as AliasRegistryOptions, d as AliasValidationReport, f as ModelResolutionResult, g as ModelResolutionSuccess, h as ModelResolverOptions, O as OpenRouterRoutingConfig, R as ResolutionStrategy, i as ResolvedModel, j as ResolvedModelRef, l as loadOpenRouterRoutingEnv, p as providerIdToEnvKeyPrefix, s as shouldDefaultRouteViaOpenRouter, v as vendorApiKeyEnvName } from './types-CX6QFNNy.cjs';
 export { AliasResolver, AliasResolverOptions } from './aliases/index.cjs';
-import '@x12i/catalox';
-import 'firebase-admin/firestore';
-import './upsertAiModelRecord-CjY-sny0.cjs';
 
-type AiToolsErrorCode = "MODEL_NOT_FOUND" | "SYNC_FETCH_FAILED" | "SYNC_UPSERT_FAILED" | "CATALOG_BOOTSTRAP_FAILED" | "COST_CALCULATION_FAILED" | "INVALID_USAGE_INPUT" | "OPENROUTER_AUTH_FAILED" | "OPENROUTER_MODELS_FETCH_FAILED" | "CACHE_READ_ERROR" | "ALIAS_NOT_FOUND" | "ALIAS_INVALID_NAME" | "ALIAS_CONFLICT" | "ALIAS_FILE_PARSE_ERROR" | "ALIAS_FILE_WRITE_ERROR";
+type AiToolsErrorCode = "MODEL_NOT_FOUND" | "SYNC_FETCH_FAILED" | "SYNC_UPSERT_FAILED" | "COST_CALCULATION_FAILED" | "COST_UNKNOWN_MODEL" | "INVALID_USAGE_INPUT" | "OPENROUTER_AUTH_FAILED" | "OPENROUTER_MODELS_FETCH_FAILED" | "CACHE_READ_ERROR" | "ALIAS_NOT_FOUND" | "ALIAS_INVALID_NAME" | "ALIAS_CONFLICT" | "ALIAS_FILE_PARSE_ERROR" | "ALIAS_FILE_WRITE_ERROR";
 declare class AiToolsError extends Error {
     readonly code: AiToolsErrorCode;
     readonly cause?: unknown | undefined;
@@ -48,5 +43,10 @@ declare class SyncError extends AiToolsError {
 declare class CostCalculationError extends AiToolsError {
     constructor(message: string, cause?: unknown);
 }
+declare class UnknownModelCostError extends AiToolsError {
+    readonly model: string;
+    readonly provider: string;
+    constructor(model: string, provider: string);
+}
 
-export { AiToolsError, type AiToolsErrorCode, AliasConflictError, AliasFileParseError, AliasFileWriteError, AliasInvalidNameError, AliasNotFoundError, CostCalculationError, ModelNotFoundError, ModelResolutionError, ModelResolutionInput, SyncError };
+export { AiToolsError, type AiToolsErrorCode, AliasConflictError, AliasFileParseError, AliasFileWriteError, AliasInvalidNameError, AliasNotFoundError, CostCalculationError, ModelNotFoundError, ModelResolutionError, ModelResolutionInput, SyncError, UnknownModelCostError };

package/dist/index.d.ts

@@ -1,19 +1,14 @@
-export { AiCostResult, AiUsageInput, CostCalculator, CostCalculatorOptions } from './cost/index.js';
-export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions } from './AiModelsCatalogClient-nwFoEaqL.js';
+export { A as AiCostExtraction, a as AiCostResult, b as AiCostWarning, d as AiUsageInput, C as CostCalculator, e as CostCalculatorOptions, E as ExtractUsageInputOptions, f as ExtractUsageInputResult, M as MODEL_FIELD_PRIORITY, g as extractUsageInput, r as resolveUsageModel } from './resolveUsageModel-BFwf80Hz.js';
+export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions, L as LoadCatalogOptions, b as LoadedCatalogs, l as loadCatalogSources } from './AiModelsCatalogClient-CPPNI6Ry.js';
+import { h as ModelResolutionInput, i as ModelResolutionNotFound } from './types-BrzJWsTU.js';
+export { A as AiModelPricing, a as AiModelRecord, b as AliasEntry, c as AliasFileSchema, d as AliasRegistry, e as AliasRegistryOptions, f as AliasValidationReport, M as ModelListFilters, g as ModelListResult, j as ModelResolutionResult, k as ModelResolutionSuccess, l as ModelResolverOptions, m as OpenRouterModelApi, n as OpenRouterModelsQuery, r as OpenRouterRoutingConfig, R as ResolutionStrategy, t as ResolvedModel, u as ResolvedModelRef, v as loadOpenRouterRoutingEnv, w as providerIdToEnvKeyPrefix, x as shouldDefaultRouteViaOpenRouter, y as vendorApiKeyEnvName } from './types-BrzJWsTU.js';
+export { C as CatalogRefreshOptions, a as CatalogRefreshResult, c as CatalogVerifyOptions, d as CatalogVerifyReport, D as DEFAULT_CATALOG_CACHE_TTL_MS, e as DEFAULT_DIRECT_CATALOG_URL, f as DEFAULT_OPENROUTER_CATALOG_URL, i as invalidateCatalogLoadCache, l as loadCatalogSourcesCached, r as refreshAiModelsCatalog, h as resolveCatalogCacheTtlMs, v as verifyAiModelsCatalog } from './modelCache-BzRn6t_C.js';
 export { AiModelsService, AiModelsServiceOptions, REASONING_SUPPORTED_PARAMETERS, ReasoningModelInput, computeSupportsReasoning, countModels, filterModels, getModelInfo, hasReasoningPricing, isReasoningModel, normalizeOpenRouterModel, supportsReasoningParameter } from './models/index.js';
-export { A as AiModelPricing, a as AiModelRecord, M as ModelListFilters, b as ModelListResult, c as OpenRouterModelApi, d as OpenRouterModelsQuery } from './types-BYXnCvKx.js';
-export { AI_MODELS_CATALOG_ID, AI_MODELS_DESCRIPTOR, AI_TOOLS_APP_ID, CatalogSyncJobError, CatalogSyncJobOptions, CatalogSyncJobResult, CatalogVerifyOptions, CatalogVerifyReport, EnsureAiModelsCatalogOptions, PruneStaleCatalogModelsOptions, PruneStaleCatalogModelsResult, ensureAiModelsCatalog, pruneStaleCatalogModels, runAiModelsCatalogSync, verifyAiModelsCatalog } from './catalog/index.js';
-export { M as ModelNameResolver, O as OpenRouterSyncProvider, a as OpenRouterSyncProviderOptions, c as createModelNameResolver, i as isRoutedViaOpenRouter, r as resolveModel } from './modelNameResolver-DqFt7g6W.js';
-export { S as SyncOptions, a as SyncResult, s as syncAiModelsCatalog } from './syncAiModelsCatalog-DpkN_w7S.js';
+export { M as ModelNameResolver, O as OpenRouterSyncProvider, a as OpenRouterSyncProviderOptions, c as createModelNameResolver, i as isRoutedViaOpenRouter, r as resolveModel } from './modelNameResolver-5XkBMctP.js';
 export { AIToolbox, AiToolboxOptions, Fallback, FallbackChain, Guard, GuardConfig, RouteRule, Router, TrackResult, Tracker } from './toolbox/index.js';
-import { M as ModelResolutionInput, e as ModelResolutionNotFound } from './types-CuiPDcVs.js';
-export { A as AliasEntry, a as AliasFileSchema, b as AliasRegistry, c as AliasRegistryOptions, d as AliasValidationReport, f as ModelResolutionResult, g as ModelResolutionSuccess, h as ModelResolverOptions, O as OpenRouterRoutingConfig, R as ResolutionStrategy, i as ResolvedModel, j as ResolvedModelRef, l as loadOpenRouterRoutingEnv, p as providerIdToEnvKeyPrefix, s as shouldDefaultRouteViaOpenRouter, v as vendorApiKeyEnvName } from './types-CuiPDcVs.js';
 export { AliasResolver, AliasResolverOptions } from './aliases/index.js';
-import '@x12i/catalox';
-import 'firebase-admin/firestore';
-import './upsertAiModelRecord-C831wOIF.js';
 
-type AiToolsErrorCode = "MODEL_NOT_FOUND" | "SYNC_FETCH_FAILED" | "SYNC_UPSERT_FAILED" | "CATALOG_BOOTSTRAP_FAILED" | "COST_CALCULATION_FAILED" | "INVALID_USAGE_INPUT" | "OPENROUTER_AUTH_FAILED" | "OPENROUTER_MODELS_FETCH_FAILED" | "CACHE_READ_ERROR" | "ALIAS_NOT_FOUND" | "ALIAS_INVALID_NAME" | "ALIAS_CONFLICT" | "ALIAS_FILE_PARSE_ERROR" | "ALIAS_FILE_WRITE_ERROR";
+type AiToolsErrorCode = "MODEL_NOT_FOUND" | "SYNC_FETCH_FAILED" | "SYNC_UPSERT_FAILED" | "COST_CALCULATION_FAILED" | "COST_UNKNOWN_MODEL" | "INVALID_USAGE_INPUT" | "OPENROUTER_AUTH_FAILED" | "OPENROUTER_MODELS_FETCH_FAILED" | "CACHE_READ_ERROR" | "ALIAS_NOT_FOUND" | "ALIAS_INVALID_NAME" | "ALIAS_CONFLICT" | "ALIAS_FILE_PARSE_ERROR" | "ALIAS_FILE_WRITE_ERROR";
 declare class AiToolsError extends Error {
     readonly code: AiToolsErrorCode;
     readonly cause?: unknown | undefined;
@@ -48,5 +43,10 @@ declare class SyncError extends AiToolsError {
 declare class CostCalculationError extends AiToolsError {
     constructor(message: string, cause?: unknown);
 }
+declare class UnknownModelCostError extends AiToolsError {
+    readonly model: string;
+    readonly provider: string;
+    constructor(model: string, provider: string);
+}
 
-export { AiToolsError, type AiToolsErrorCode, AliasConflictError, AliasFileParseError, AliasFileWriteError, AliasInvalidNameError, AliasNotFoundError, CostCalculationError, ModelNotFoundError, ModelResolutionError, ModelResolutionInput, SyncError };
+export { AiToolsError, type AiToolsErrorCode, AliasConflictError, AliasFileParseError, AliasFileWriteError, AliasInvalidNameError, AliasNotFoundError, CostCalculationError, ModelNotFoundError, ModelResolutionError, ModelResolutionInput, SyncError, UnknownModelCostError };

package/dist/index.js

@@ -1,60 +1,62 @@
-import {
-  CostCalculator
-} from "./chunk-YHO57D2V.js";
+import "./chunk-56R4XA2S.js";
 import {
   AIToolbox
 } from "./chunk-XRBZQQQU.js";
 import {
+  OpenRouterSyncProvider,
   createModelNameResolver,
   isRoutedViaOpenRouter,
   resolveModel
-} from "./chunk-G2G4KSC5.js";
+} from "./chunk-6BQBKROR.js";
 import "./chunk-KHODXGPV.js";
+import "./chunk-COK34C6P.js";
+import {
+  normalizeOpenRouterModel
+} from "./chunk-SIH4GPV4.js";
+import {
+  CostCalculator,
+  MODEL_FIELD_PRIORITY,
+  extractUsageInput,
+  resolveUsageModel
+} from "./chunk-U2YDDUVP.js";
 import {
   AliasRegistry,
   AliasResolver
-} from "./chunk-O2A6OVEH.js";
-import "./chunk-COK34C6P.js";
+} from "./chunk-ANVONYJF.js";
 import {
   AiModelsService,
   countModels,
   filterModels,
   getModelInfo
-} from "./chunk-4NAY6HRP.js";
-import "./chunk-M5TMA73F.js";
+} from "./chunk-VJHLO2R3.js";
 import {
-  CatalogSyncJobError,
-  pruneStaleCatalogModels,
-  runAiModelsCatalogSync,
+  refreshAiModelsCatalog,
   verifyAiModelsCatalog
-} from "./chunk-MX3AMQFC.js";
+} from "./chunk-AB5GNXJ4.js";
 import {
-  OpenRouterSyncProvider,
-  ensureAiModelsCatalog,
-  syncAiModelsCatalog
-} from "./chunk-VRFVF5RH.js";
-import "./chunk-HYGXZY25.js";
+  AiModelsCatalogClient,
+  DEFAULT_CATALOG_CACHE_TTL_MS,
+  DEFAULT_DIRECT_CATALOG_URL,
+  DEFAULT_OPENROUTER_CATALOG_URL,
+  invalidateCatalogLoadCache,
+  loadCatalogSources,
+  loadCatalogSourcesCached,
+  resolveCatalogCacheTtlMs
+} from "./chunk-OPN6BGNH.js";
 import {
+  ModelNameResolver,
   REASONING_SUPPORTED_PARAMETERS,
   computeSupportsReasoning,
   hasReasoningPricing,
   isReasoningModel,
-  normalizeOpenRouterModel,
   supportsReasoningParameter
-} from "./chunk-6QGDZTGH.js";
+} from "./chunk-EYHMQVAL.js";
 import {
-  AiModelsCatalogClient
-} from "./chunk-KQOALKKX.js";
-import {
-  AI_MODELS_CATALOG_ID,
-  AI_MODELS_DESCRIPTOR,
-  AI_TOOLS_APP_ID,
-  ModelNameResolver,
   loadOpenRouterRoutingEnv,
   providerIdToEnvKeyPrefix,
   shouldDefaultRouteViaOpenRouter,
   vendorApiKeyEnvName
-} from "./chunk-DJ5SWJDY.js";
+} from "./chunk-B3V2EHRY.js";
 import {
   AiToolsError,
   AliasConflictError,
@@ -65,13 +67,11 @@ import {
   CostCalculationError,
   ModelNotFoundError,
   ModelResolutionError,
-  SyncError
-} from "./chunk-AJEKEWWB.js";
+  SyncError,
+  UnknownModelCostError
+} from "./chunk-2PTCWPHV.js";
 export {
   AIToolbox,
-  AI_MODELS_CATALOG_ID,
-  AI_MODELS_DESCRIPTOR,
-  AI_TOOLS_APP_ID,
   AiModelsCatalogClient,
   AiModelsService,
   AiToolsError,
@@ -82,33 +82,40 @@ export {
   AliasNotFoundError,
   AliasRegistry,
   AliasResolver,
-  CatalogSyncJobError,
   CostCalculationError,
   CostCalculator,
+  DEFAULT_CATALOG_CACHE_TTL_MS,
+  DEFAULT_DIRECT_CATALOG_URL,
+  DEFAULT_OPENROUTER_CATALOG_URL,
+  MODEL_FIELD_PRIORITY,
   ModelNameResolver,
   ModelNotFoundError,
   ModelResolutionError,
   OpenRouterSyncProvider,
   REASONING_SUPPORTED_PARAMETERS,
   SyncError,
+  UnknownModelCostError,
   computeSupportsReasoning,
   countModels,
   createModelNameResolver,
-  ensureAiModelsCatalog,
+  extractUsageInput,
   filterModels,
   getModelInfo,
   hasReasoningPricing,
+  invalidateCatalogLoadCache,
   isReasoningModel,
   isRoutedViaOpenRouter,
+  loadCatalogSources,
+  loadCatalogSourcesCached,
   loadOpenRouterRoutingEnv,
   normalizeOpenRouterModel,
   providerIdToEnvKeyPrefix,
-  pruneStaleCatalogModels,
+  refreshAiModelsCatalog,
+  resolveCatalogCacheTtlMs,
   resolveModel,
-  runAiModelsCatalogSync,
+  resolveUsageModel,
   shouldDefaultRouteViaOpenRouter,
   supportsReasoningParameter,
-  syncAiModelsCatalog,
   vendorApiKeyEnvName,
   verifyAiModelsCatalog
 };

package/dist/modelCache-BzRn6t_C.d.ts

@@ -0,0 +1,113 @@
+import { L as LoadCatalogOptions, b as LoadedCatalogs } from './AiModelsCatalogClient-CPPNI6Ry.js';
+
+/** Remote catalog URLs (primary). */
+declare const DEFAULT_DIRECT_CATALOG_URL = "https://open-assets.x12i.com/models-catalog.json";
+declare const DEFAULT_OPENROUTER_CATALOG_URL = "https://open-assets.x12i.com/openrouter-models-catalog.json";
+type CatalogSourceKind = "direct" | "openrouter";
+type X12iCatalogPricing = {
+    input?: number | null;
+    output?: number | null;
+    cachedInput?: number | null;
+    cacheHit?: number | null;
+    cacheWrite?: number | null;
+    cacheWrite5m?: number | null;
+    cacheWrite1h?: number | null;
+    textInput?: number | null;
+    textOutput?: number | null;
+    audioInput?: number | null;
+    imageInput?: number | null;
+    internalReasoning?: number | null;
+    webSearchPerRequest?: number | null;
+    inputBelow200k?: number | null;
+    inputAbove200k?: number | null;
+    outputBelow200k?: number | null;
+    outputAbove200k?: number | null;
+    [key: string]: unknown;
+};
+type X12iCatalogModelEntry = {
+    provider: string;
+    modelId: string;
+    displayName?: string;
+    canonicalSlug?: string;
+    family?: string;
+    status?: string;
+    modalities?: string[] | {
+        input?: string[];
+        output?: string[];
+    };
+    contextWindow?: number;
+    maxCompletionTokens?: number;
+    pricing?: X12iCatalogPricing;
+    capabilities?: {
+        reasoning?: boolean | string;
+        toolCalling?: boolean;
+        structuredOutputs?: boolean;
+    };
+    aliases?: string[];
+    sourceUrl?: string;
+};
+/**
+ * Raw catalog JSON from open-assets.x12i.com (or bundled `src/data`).
+ *
+ * `schema` and `version` are publisher metadata only — this library never reads or
+ * compares them. Remote catalogs are always treated as the latest pricing source.
+ */
+type X12iModelsCatalogFile = {
+    /** Publisher schema id (informational). */
+    schema?: string;
+    /** Publisher catalog revision (informational; not used for cache or compatibility). */
+    version?: string;
+    verifiedAt?: string;
+    models: X12iCatalogModelEntry[];
+    [key: string]: unknown;
+};
+
+declare function invalidateCatalogLoadCache(cacheKey?: string): void;
+type LoadCatalogCachedOptions = {
+    cacheKey?: string;
+    ttlMs?: number;
+    /** Bypass cache and fetch again (e.g. `catalog refresh`). */
+    forceRefresh?: boolean;
+};
+/**
+ * Load catalogs with a process-wide in-memory cache.
+ * Remote fetches run at most once per TTL window (default 24h); concurrent callers share one in-flight request.
+ */
+declare function loadCatalogSourcesCached(options?: LoadCatalogOptions, cacheOptions?: LoadCatalogCachedOptions): Promise<LoadedCatalogs>;
+
+type CatalogRefreshOptions = LoadCatalogOptions & {
+    cacheKey?: string;
+    cacheTtlMs?: number;
+};
+type CatalogRefreshResult = {
+    ok: true;
+    directCount: number;
+    openRouterCount: number;
+    directSource: "remote" | "bundled";
+    openRouterSource: "remote" | "bundled";
+};
+/** Fetch remote catalogs and warm the in-memory cache (forces a network load). */
+declare function refreshAiModelsCatalog(options?: CatalogRefreshOptions): Promise<CatalogRefreshResult>;
+type CatalogVerifyOptions = LoadCatalogOptions & {
+    cacheKey?: string;
+    cacheTtlMs?: number;
+};
+type CatalogVerifyReport = {
+    ok: boolean;
+    directCount: number;
+    openRouterCount: number;
+    directSource: "remote" | "bundled";
+    openRouterSource: "remote" | "bundled";
+    directUrl: string;
+    openRouterUrl: string;
+};
+/** Load and validate both catalogs (uses cache unless `forceRefresh`). */
+declare function verifyAiModelsCatalog(options?: CatalogVerifyOptions & {
+    forceRefresh?: boolean;
+}): Promise<CatalogVerifyReport>;
+
+/** Default in-memory catalog cache lifetime (24 hours). */
+declare const DEFAULT_CATALOG_CACHE_TTL_MS: number;
+declare function resolveCatalogCacheTtlMs(override?: number): number;
+
+export { type CatalogRefreshOptions as C, DEFAULT_CATALOG_CACHE_TTL_MS as D, type LoadCatalogCachedOptions as L, type X12iCatalogModelEntry as X, type CatalogRefreshResult as a, type CatalogSourceKind as b, type CatalogVerifyOptions as c, type CatalogVerifyReport as d, DEFAULT_DIRECT_CATALOG_URL as e, DEFAULT_OPENROUTER_CATALOG_URL as f, type X12iModelsCatalogFile as g, resolveCatalogCacheTtlMs as h, invalidateCatalogLoadCache as i, loadCatalogSourcesCached as l, refreshAiModelsCatalog as r, verifyAiModelsCatalog as v };