@x12i/ai-tools 1.0.4 → 2.0.0

package/dist/modelCache-CJftI-Ko.d.cts

@@ -0,0 +1,113 @@
+import { L as LoadCatalogOptions, b as LoadedCatalogs } from './AiModelsCatalogClient-B5FMI9gj.cjs';
+
+/** 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 };

package/dist/{modelNameResolver-DqFt7g6W.d.ts → modelNameResolver-5XkBMctP.d.ts}

@@ -1,5 +1,4 @@
-import { d as OpenRouterModelsQuery, a as AiModelRecord } from './types-BYXnCvKx.js';
-import { h as ModelResolverOptions, M as ModelResolutionInput, f as ModelResolutionResult, g as ModelResolutionSuccess, b as AliasRegistry, i as ResolvedModel } from './types-CuiPDcVs.js';
+import { n as OpenRouterModelsQuery, a as AiModelRecord, l as ModelResolverOptions, h as ModelResolutionInput, j as ModelResolutionResult, k as ModelResolutionSuccess, d as AliasRegistry, t as ResolvedModel } from './types-BrzJWsTU.js';
 
 type OpenRouterSyncProviderOptions = {
     /** Optional — public GET /models needs no key. */
@@ -37,7 +36,6 @@ declare class ModelNameResolver {
     private inferProviderFromSlug;
     private providerPrefixInjection;
     private crossProviderCorrection;
-    private stripVersionSuffixes;
     private dateSuffixMatch;
     private findLatestVersioned;
     private shorthandMap;
@@ -47,9 +45,7 @@ declare class ModelNameResolver {
 }
 
 declare function createModelNameResolver(catalog: Map<string, AiModelRecord>, options?: ModelResolverOptions): ModelNameResolver;
-/**
- * @deprecated Prefer `ModelNameResolver.resolve()` for full resolution metadata.
- */
+/** Resolve a model string; returns catalog record only (no resolution metadata). */
 declare function resolveModel(input: string, models: Map<string, AiModelRecord>, aliasRegistry?: AliasRegistry, provider?: string): ResolvedModel | null;
 declare function isRoutedViaOpenRouter(provider: string | undefined, model: AiModelRecord, matchedKey: string): boolean;
 

package/dist/{modelNameResolver-D9V_GfUK.d.cts → modelNameResolver-C5CSTGFF.d.cts}

@@ -1,5 +1,4 @@
-import { d as OpenRouterModelsQuery, a as AiModelRecord } from './types-BYXnCvKx.cjs';
-import { h as ModelResolverOptions, M as ModelResolutionInput, f as ModelResolutionResult, g as ModelResolutionSuccess, b as AliasRegistry, i as ResolvedModel } from './types-CX6QFNNy.cjs';
+import { n as OpenRouterModelsQuery, a as AiModelRecord, l as ModelResolverOptions, h as ModelResolutionInput, j as ModelResolutionResult, k as ModelResolutionSuccess, d as AliasRegistry, t as ResolvedModel } from './types-BrzJWsTU.cjs';
 
 type OpenRouterSyncProviderOptions = {
     /** Optional — public GET /models needs no key. */
@@ -37,7 +36,6 @@ declare class ModelNameResolver {
     private inferProviderFromSlug;
     private providerPrefixInjection;
     private crossProviderCorrection;
-    private stripVersionSuffixes;
     private dateSuffixMatch;
     private findLatestVersioned;
     private shorthandMap;
@@ -47,9 +45,7 @@ declare class ModelNameResolver {
 }
 
 declare function createModelNameResolver(catalog: Map<string, AiModelRecord>, options?: ModelResolverOptions): ModelNameResolver;
-/**
- * @deprecated Prefer `ModelNameResolver.resolve()` for full resolution metadata.
- */
+/** Resolve a model string; returns catalog record only (no resolution metadata). */
 declare function resolveModel(input: string, models: Map<string, AiModelRecord>, aliasRegistry?: AliasRegistry, provider?: string): ResolvedModel | null;
 declare function isRoutedViaOpenRouter(provider: string | undefined, model: AiModelRecord, matchedKey: string): boolean;
 

package/dist/models/index.cjs

@@ -2,22 +2,24 @@
 
 
 
+var _chunkXOKUDUUIcjs = require('../chunk-XOKUDUUI.cjs');
 
 
-var _chunkQCRLKVB3cjs = require('../chunk-QCRLKVB3.cjs');
 
 
 
+var _chunkYQDSN6R6cjs = require('../chunk-YQDSN6R6.cjs');
+require('../chunk-5XAAMBDO.cjs');
 
 
 
 
 
-var _chunkAV6OE2YQcjs = require('../chunk-AV6OE2YQ.cjs');
-require('../chunk-F2F4UEFD.cjs');
-require('../chunk-TF4L2NEC.cjs');
-require('../chunk-7Q742NI3.cjs');
 
+var _chunkDXZOL3VNcjs = require('../chunk-DXZOL3VN.cjs');
+require('../chunk-EDMCKHO6.cjs');
+require('../chunk-PADNCGZB.cjs');
+require('../chunk-GS7T56RP.cjs');
 
 
 
@@ -29,5 +31,6 @@ require('../chunk-7Q742NI3.cjs');
 
 
 
-exports.AiModelsService = _chunkQCRLKVB3cjs.AiModelsService; exports.REASONING_SUPPORTED_PARAMETERS = _chunkAV6OE2YQcjs.REASONING_SUPPORTED_PARAMETERS; exports.computeSupportsReasoning = _chunkAV6OE2YQcjs.computeSupportsReasoning; exports.countModels = _chunkQCRLKVB3cjs.countModels; exports.extractProviderId = _chunkAV6OE2YQcjs.extractProviderId; exports.filterModels = _chunkQCRLKVB3cjs.filterModels; exports.getModelInfo = _chunkQCRLKVB3cjs.getModelInfo; exports.hasReasoningPricing = _chunkAV6OE2YQcjs.hasReasoningPricing; exports.isReasoningModel = _chunkAV6OE2YQcjs.isReasoningModel; exports.normalizeOpenRouterModel = _chunkAV6OE2YQcjs.normalizeOpenRouterModel; exports.supportsReasoningParameter = _chunkAV6OE2YQcjs.supportsReasoningParameter;
+
+exports.AiModelsService = _chunkYQDSN6R6cjs.AiModelsService; exports.REASONING_SUPPORTED_PARAMETERS = _chunkDXZOL3VNcjs.REASONING_SUPPORTED_PARAMETERS; exports.computeSupportsReasoning = _chunkDXZOL3VNcjs.computeSupportsReasoning; exports.countModels = _chunkYQDSN6R6cjs.countModels; exports.extractProviderId = _chunkXOKUDUUIcjs.extractProviderId; exports.filterModels = _chunkYQDSN6R6cjs.filterModels; exports.getModelInfo = _chunkYQDSN6R6cjs.getModelInfo; exports.hasReasoningPricing = _chunkDXZOL3VNcjs.hasReasoningPricing; exports.isReasoningModel = _chunkDXZOL3VNcjs.isReasoningModel; exports.normalizeOpenRouterModel = _chunkXOKUDUUIcjs.normalizeOpenRouterModel; exports.supportsReasoningParameter = _chunkDXZOL3VNcjs.supportsReasoningParameter;
 //# sourceMappingURL=index.cjs.map

package/dist/models/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/models/index.cjs"],"names":[],"mappings":"AAAA,0GAA8B;AAC9B;AACE;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,gvBAAC","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/models/index.cjs"}
+{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/models/index.cjs"],"names":[],"mappings":"AAAA,0GAA8B;AAC9B;AACE;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,gvBAAC","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/models/index.cjs"}

package/dist/models/index.d.cts

@@ -1,44 +1,22 @@
-import { f as ModelResolutionResult } from '../types-CX6QFNNy.cjs';
-import { Catalox, CatalogQueryOptions } from '@x12i/catalox';
-import { a as AiModelRecord, M as ModelListFilters, b as ModelListResult, c as OpenRouterModelApi } from '../types-BYXnCvKx.cjs';
-export { A as AiModelPricing, O as OpenRouterArchitectureApi, d as OpenRouterModelsQuery, e as OpenRouterModelsResponse, f as OpenRouterOutputModality, g as OpenRouterPricingApi, h as OpenRouterTopProviderApi } from '../types-BYXnCvKx.cjs';
+import { a as AiModelRecord, M as ModelListFilters, g as ModelListResult, j as ModelResolutionResult, m as OpenRouterModelApi } from '../types-BrzJWsTU.cjs';
+export { A as AiModelPricing, O as OpenRouterArchitectureApi, n as OpenRouterModelsQuery, o as OpenRouterModelsResponse, p as OpenRouterOutputModality, q as OpenRouterPricingApi, s as OpenRouterTopProviderApi } from '../types-BrzJWsTU.cjs';
+import { a as AiModelsCatalogClientOptions } from '../AiModelsCatalogClient-B5FMI9gj.cjs';
 
-type AiModelsServiceOptions = {
-    catalox: Catalox;
-    appId?: string;
-    catalogId?: string;
-    cacheTtlMs?: number;
-};
+type AiModelsServiceOptions = AiModelsCatalogClientOptions;
 /**
  * High-level model catalog API — list, filter, count, and get full model info.
  */
 declare class AiModelsService {
     private readonly client;
-    private readonly catalox;
-    private readonly appId;
-    private readonly catalogId;
-    constructor(options: AiModelsServiceOptions);
-    private context;
-    /** Load all models (cached). */
+    constructor(options?: AiModelsServiceOptions);
     getAllModels(): Promise<Map<string, AiModelRecord>>;
-    /** List models with in-memory filters (fast after cache warm). */
     listModels(filters?: ModelListFilters): Promise<ModelListResult>;
-    /** Count models matching filters. */
     countModels(filters?: Omit<ModelListFilters, "limit" | "offset">): Promise<number>;
-    /**
-     * Full model record by id or alias (same resolution as cost calculator).
-     */
-    getModelInfo(modelIdOrAlias: string): Promise<AiModelRecord | null>;
-    /**
-     * Query via Catalox indexed fields (provider, status, output modality, tools).
-     * Falls back to in-memory filter when Catalox returns partial pages.
-     */
-    listModelsFromCatalog(filters?: ModelListFilters, options?: CatalogQueryOptions): Promise<ModelListResult>;
+    getModelInfo(modelIdOrAlias: string, provider?: string): Promise<AiModelRecord | null>;
     resolve(modelIdOrAlias: string, provider?: string): Promise<ModelResolutionResult>;
     refresh(): Promise<void>;
 }
-/** Convenience: getModelInfo */
-declare function getModelInfo(service: AiModelsService, modelIdOrAlias: string): Promise<AiModelRecord | null>;
+declare function getModelInfo(modelIdOrAlias: string, options?: AiModelsServiceOptions, provider?: string): Promise<AiModelRecord | null>;
 
 declare function filterModels(models: Iterable<AiModelRecord>, filters?: ModelListFilters): AiModelRecord[];
 declare function countModels(models: Iterable<AiModelRecord>, filters?: Omit<ModelListFilters, "limit" | "offset">): number;
@@ -62,13 +40,13 @@ declare function supportsReasoningParameter(model: Pick<AiModelRecord, "supporte
  */
 declare function hasReasoningPricing(model: Pick<AiModelRecord, "pricing" | "openRouterPricing">): boolean;
 /**
- * Compute `supportsReasoning` from catalog fields (used during sync normalization).
+ * Compute `supportsReasoning` from catalog fields (used when normalizing catalog entries).
  */
 declare function computeSupportsReasoning(model: ReasoningModelInput): boolean;
 /**
  * True when the model supports reasoning tokens (API param and/or separate reasoning pricing).
  *
- * Prefer `model.supportsReasoning` on {@link AiModelRecord} after catalog sync;
+ * Prefer `model.supportsReasoning` on {@link AiModelRecord} after catalog load;
  * this helper also works when only partial fields are available.
  */
 declare function isReasoningModel(model: ReasoningModelInput): boolean;

package/dist/models/index.d.ts

@@ -1,44 +1,22 @@
-import { f as ModelResolutionResult } from '../types-CuiPDcVs.js';
-import { Catalox, CatalogQueryOptions } from '@x12i/catalox';
-import { a as AiModelRecord, M as ModelListFilters, b as ModelListResult, c as OpenRouterModelApi } from '../types-BYXnCvKx.js';
-export { A as AiModelPricing, O as OpenRouterArchitectureApi, d as OpenRouterModelsQuery, e as OpenRouterModelsResponse, f as OpenRouterOutputModality, g as OpenRouterPricingApi, h as OpenRouterTopProviderApi } from '../types-BYXnCvKx.js';
+import { a as AiModelRecord, M as ModelListFilters, g as ModelListResult, j as ModelResolutionResult, m as OpenRouterModelApi } from '../types-BrzJWsTU.js';
+export { A as AiModelPricing, O as OpenRouterArchitectureApi, n as OpenRouterModelsQuery, o as OpenRouterModelsResponse, p as OpenRouterOutputModality, q as OpenRouterPricingApi, s as OpenRouterTopProviderApi } from '../types-BrzJWsTU.js';
+import { a as AiModelsCatalogClientOptions } from '../AiModelsCatalogClient-CPPNI6Ry.js';
 
-type AiModelsServiceOptions = {
-    catalox: Catalox;
-    appId?: string;
-    catalogId?: string;
-    cacheTtlMs?: number;
-};
+type AiModelsServiceOptions = AiModelsCatalogClientOptions;
 /**
  * High-level model catalog API — list, filter, count, and get full model info.
  */
 declare class AiModelsService {
     private readonly client;
-    private readonly catalox;
-    private readonly appId;
-    private readonly catalogId;
-    constructor(options: AiModelsServiceOptions);
-    private context;
-    /** Load all models (cached). */
+    constructor(options?: AiModelsServiceOptions);
     getAllModels(): Promise<Map<string, AiModelRecord>>;
-    /** List models with in-memory filters (fast after cache warm). */
     listModels(filters?: ModelListFilters): Promise<ModelListResult>;
-    /** Count models matching filters. */
     countModels(filters?: Omit<ModelListFilters, "limit" | "offset">): Promise<number>;
-    /**
-     * Full model record by id or alias (same resolution as cost calculator).
-     */
-    getModelInfo(modelIdOrAlias: string): Promise<AiModelRecord | null>;
-    /**
-     * Query via Catalox indexed fields (provider, status, output modality, tools).
-     * Falls back to in-memory filter when Catalox returns partial pages.
-     */
-    listModelsFromCatalog(filters?: ModelListFilters, options?: CatalogQueryOptions): Promise<ModelListResult>;
+    getModelInfo(modelIdOrAlias: string, provider?: string): Promise<AiModelRecord | null>;
     resolve(modelIdOrAlias: string, provider?: string): Promise<ModelResolutionResult>;
     refresh(): Promise<void>;
 }
-/** Convenience: getModelInfo */
-declare function getModelInfo(service: AiModelsService, modelIdOrAlias: string): Promise<AiModelRecord | null>;
+declare function getModelInfo(modelIdOrAlias: string, options?: AiModelsServiceOptions, provider?: string): Promise<AiModelRecord | null>;
 
 declare function filterModels(models: Iterable<AiModelRecord>, filters?: ModelListFilters): AiModelRecord[];
 declare function countModels(models: Iterable<AiModelRecord>, filters?: Omit<ModelListFilters, "limit" | "offset">): number;
@@ -62,13 +40,13 @@ declare function supportsReasoningParameter(model: Pick<AiModelRecord, "supporte
  */
 declare function hasReasoningPricing(model: Pick<AiModelRecord, "pricing" | "openRouterPricing">): boolean;
 /**
- * Compute `supportsReasoning` from catalog fields (used during sync normalization).
+ * Compute `supportsReasoning` from catalog fields (used when normalizing catalog entries).
  */
 declare function computeSupportsReasoning(model: ReasoningModelInput): boolean;
 /**
  * True when the model supports reasoning tokens (API param and/or separate reasoning pricing).
  *
- * Prefer `model.supportsReasoning` on {@link AiModelRecord} after catalog sync;
+ * Prefer `model.supportsReasoning` on {@link AiModelRecord} after catalog load;
  * this helper also works when only partial fields are available.
  */
 declare function isReasoningModel(model: ReasoningModelInput): boolean;

package/dist/models/index.js

@@ -1,22 +1,24 @@
 import "../chunk-COK34C6P.js";
+import {
+  extractProviderId,
+  normalizeOpenRouterModel
+} from "../chunk-SIH4GPV4.js";
 import {
   AiModelsService,
   countModels,
   filterModels,
   getModelInfo
-} from "../chunk-4NAY6HRP.js";
+} from "../chunk-VJHLO2R3.js";
+import "../chunk-OPN6BGNH.js";
 import {
   REASONING_SUPPORTED_PARAMETERS,
   computeSupportsReasoning,
-  extractProviderId,
   hasReasoningPricing,
   isReasoningModel,
-  normalizeOpenRouterModel,
   supportsReasoningParameter
-} from "../chunk-6QGDZTGH.js";
-import "../chunk-KQOALKKX.js";
-import "../chunk-DJ5SWJDY.js";
-import "../chunk-AJEKEWWB.js";
+} from "../chunk-EYHMQVAL.js";
+import "../chunk-B3V2EHRY.js";
+import "../chunk-2PTCWPHV.js";
 export {
   AiModelsService,
   REASONING_SUPPORTED_PARAMETERS,

package/dist/resolveUsageModel-BFwf80Hz.d.ts

@@ -0,0 +1,140 @@
+import { A as AiModelPricing, d as AliasRegistry, l as ModelResolverOptions } from './types-BrzJWsTU.js';
+import { A as AiModelsCatalogClient } from './AiModelsCatalogClient-CPPNI6Ry.js';
+
+type AiUsageInput = {
+    tokens: {
+        prompt: number;
+        completion: number;
+        total: number;
+        cached?: number;
+        cacheWrite?: number;
+        reasoning?: number;
+        audio?: number;
+        image?: number;
+    };
+    provider: string;
+    /** Runtime model id from the provider response (highest priority). */
+    usedModel?: string;
+    /** Alias of `usedModel` (same priority). */
+    modelUsed?: string;
+    /** Requested / configured model id; used when runtime id fields are absent. */
+    model?: string;
+};
+type AiCostExtraction = {
+    model: {
+        field: string;
+        path: string;
+    };
+    modelUsed?: {
+        field: string;
+        path: string;
+    };
+    provider?: {
+        field: string;
+        path: string;
+    };
+    tokens: {
+        source: string;
+        path: string;
+        estimated?: boolean;
+    };
+};
+type AiCostWarningCode = "UNKNOWN_MODEL" | "LOCAL_PROVIDER_NO_PRICING" | "AI_PROFILES_ESTIMATE" | "OPENROUTER_MARKUP_ESTIMATED" | "ESTIMATED_TOKEN_USAGE" | "VERSION_SUFFIX_PRICING";
+type AiCostWarning = {
+    code: AiCostWarningCode;
+    message: string;
+};
+type AiCostResult = {
+    cost: number;
+    /** Model id used for pricing (after resolution). */
+    resolvedModelId: string;
+    /** Runtime model id when present on input. */
+    usedModel?: string;
+    /** Requested model id when distinct from runtime. */
+    model?: string;
+    provider: string;
+    usage: AiUsageInput["tokens"];
+    extraction?: AiCostExtraction;
+    breakdown?: {
+        promptCostUsd: number;
+        completionCostUsd: number;
+        cachingCostUsd?: number;
+        reasoningCostUsd?: number;
+        audioCostUsd?: number;
+        imageCostUsd?: number;
+        requestFlatCostUsd?: number;
+    };
+    routedViaOpenRouter: boolean;
+    isAuthoritative: boolean;
+    pricingSnapshot: AiModelPricing;
+    source: "catalog" | "ai-profiles" | "local" | "estimate-fallback";
+    /** Present when pricing could not be resolved (zero-cost fallback). */
+    unknownModel?: boolean;
+    warnings?: AiCostWarning[];
+};
+
+/** Model id field priority (higher wins). Runtime ids beat request/config aliases. */
+declare const MODEL_FIELD_PRIORITY: readonly {
+    key: string;
+    score: number;
+}[];
+type FieldProvenance = {
+    field: string;
+    path: string;
+    score: number;
+};
+type TokenExtractionProvenance = {
+    source: "usage" | "tokens" | "diagnostics" | "estimated";
+    path: string;
+    estimated?: boolean;
+};
+type ExtractUsageInputResult = {
+    input: AiUsageInput;
+    provenance: {
+        model: FieldProvenance;
+        modelUsed?: FieldProvenance;
+        provider?: FieldProvenance;
+        tokens: TokenExtractionProvenance;
+    };
+};
+type ExtractUsageInputOptions = {
+    /** Default when no provider field is found (default: `openrouter`). */
+    defaultProvider?: string;
+};
+/**
+ * Extract {@link AiUsageInput} from activity logs, gateway records, MongoDB exports,
+ * or any nested JSON shape (e.g. `outer.input`, `config`, `metadata.diagnostics`).
+ */
+declare function extractUsageInput(record: unknown, options?: ExtractUsageInputOptions): ExtractUsageInputResult;
+
+type CostCalculatorOptions = {
+    aliasRegistry?: AliasRegistry;
+    includeBreakdown?: boolean;
+    resolverOptions?: ModelResolverOptions;
+    /** When true, throw {@link UnknownModelCostError} instead of zero-cost fallback. */
+    throwOnUnknownModel?: boolean;
+};
+declare class CostCalculator {
+    private readonly catalog;
+    private readonly aliasRegistry?;
+    private readonly includeBreakdown;
+    private readonly resolverOptions?;
+    private readonly throwOnUnknownModel;
+    constructor(catalog: AiModelsCatalogClient, options?: CostCalculatorOptions);
+    /**
+     * Extract model, provider, and token usage from an activity / gateway record
+     * (MongoDB export, nested `outer`, `config`, `metadata.diagnostics`, etc.)
+     * then run {@link calculate}.
+     */
+    calculateFromRecord(record: unknown, extractOptions?: ExtractUsageInputOptions): Promise<AiCostResult>;
+    calculate(input: AiUsageInput): Promise<AiCostResult>;
+    private versionSuffixWarnings;
+    private finish;
+    private localProviderResult;
+    private unknownModelResult;
+}
+
+/** Prefer runtime id (`usedModel` / `modelUsed`); fall back to `model`. */
+declare function resolveUsageModel(input: AiUsageInput): string;
+
+export { type AiCostExtraction as A, CostCalculator as C, type ExtractUsageInputOptions as E, type FieldProvenance as F, MODEL_FIELD_PRIORITY as M, type TokenExtractionProvenance as T, type AiCostResult as a, type AiCostWarning as b, type AiCostWarningCode as c, type AiUsageInput as d, type CostCalculatorOptions as e, type ExtractUsageInputResult as f, extractUsageInput as g, resolveUsageModel as r };

package/dist/resolveUsageModel-C_YmGR1M.d.cts

@@ -0,0 +1,140 @@
+import { A as AiModelPricing, d as AliasRegistry, l as ModelResolverOptions } from './types-BrzJWsTU.cjs';
+import { A as AiModelsCatalogClient } from './AiModelsCatalogClient-B5FMI9gj.cjs';
+
+type AiUsageInput = {
+    tokens: {
+        prompt: number;
+        completion: number;
+        total: number;
+        cached?: number;
+        cacheWrite?: number;
+        reasoning?: number;
+        audio?: number;
+        image?: number;
+    };
+    provider: string;
+    /** Runtime model id from the provider response (highest priority). */
+    usedModel?: string;
+    /** Alias of `usedModel` (same priority). */
+    modelUsed?: string;
+    /** Requested / configured model id; used when runtime id fields are absent. */
+    model?: string;
+};
+type AiCostExtraction = {
+    model: {
+        field: string;
+        path: string;
+    };
+    modelUsed?: {
+        field: string;
+        path: string;
+    };
+    provider?: {
+        field: string;
+        path: string;
+    };
+    tokens: {
+        source: string;
+        path: string;
+        estimated?: boolean;
+    };
+};
+type AiCostWarningCode = "UNKNOWN_MODEL" | "LOCAL_PROVIDER_NO_PRICING" | "AI_PROFILES_ESTIMATE" | "OPENROUTER_MARKUP_ESTIMATED" | "ESTIMATED_TOKEN_USAGE" | "VERSION_SUFFIX_PRICING";
+type AiCostWarning = {
+    code: AiCostWarningCode;
+    message: string;
+};
+type AiCostResult = {
+    cost: number;
+    /** Model id used for pricing (after resolution). */
+    resolvedModelId: string;
+    /** Runtime model id when present on input. */
+    usedModel?: string;
+    /** Requested model id when distinct from runtime. */
+    model?: string;
+    provider: string;
+    usage: AiUsageInput["tokens"];
+    extraction?: AiCostExtraction;
+    breakdown?: {
+        promptCostUsd: number;
+        completionCostUsd: number;
+        cachingCostUsd?: number;
+        reasoningCostUsd?: number;
+        audioCostUsd?: number;
+        imageCostUsd?: number;
+        requestFlatCostUsd?: number;
+    };
+    routedViaOpenRouter: boolean;
+    isAuthoritative: boolean;
+    pricingSnapshot: AiModelPricing;
+    source: "catalog" | "ai-profiles" | "local" | "estimate-fallback";
+    /** Present when pricing could not be resolved (zero-cost fallback). */
+    unknownModel?: boolean;
+    warnings?: AiCostWarning[];
+};
+
+/** Model id field priority (higher wins). Runtime ids beat request/config aliases. */
+declare const MODEL_FIELD_PRIORITY: readonly {
+    key: string;
+    score: number;
+}[];
+type FieldProvenance = {
+    field: string;
+    path: string;
+    score: number;
+};
+type TokenExtractionProvenance = {
+    source: "usage" | "tokens" | "diagnostics" | "estimated";
+    path: string;
+    estimated?: boolean;
+};
+type ExtractUsageInputResult = {
+    input: AiUsageInput;
+    provenance: {
+        model: FieldProvenance;
+        modelUsed?: FieldProvenance;
+        provider?: FieldProvenance;
+        tokens: TokenExtractionProvenance;
+    };
+};
+type ExtractUsageInputOptions = {
+    /** Default when no provider field is found (default: `openrouter`). */
+    defaultProvider?: string;
+};
+/**
+ * Extract {@link AiUsageInput} from activity logs, gateway records, MongoDB exports,
+ * or any nested JSON shape (e.g. `outer.input`, `config`, `metadata.diagnostics`).
+ */
+declare function extractUsageInput(record: unknown, options?: ExtractUsageInputOptions): ExtractUsageInputResult;
+
+type CostCalculatorOptions = {
+    aliasRegistry?: AliasRegistry;
+    includeBreakdown?: boolean;
+    resolverOptions?: ModelResolverOptions;
+    /** When true, throw {@link UnknownModelCostError} instead of zero-cost fallback. */
+    throwOnUnknownModel?: boolean;
+};
+declare class CostCalculator {
+    private readonly catalog;
+    private readonly aliasRegistry?;
+    private readonly includeBreakdown;
+    private readonly resolverOptions?;
+    private readonly throwOnUnknownModel;
+    constructor(catalog: AiModelsCatalogClient, options?: CostCalculatorOptions);
+    /**
+     * Extract model, provider, and token usage from an activity / gateway record
+     * (MongoDB export, nested `outer`, `config`, `metadata.diagnostics`, etc.)
+     * then run {@link calculate}.
+     */
+    calculateFromRecord(record: unknown, extractOptions?: ExtractUsageInputOptions): Promise<AiCostResult>;
+    calculate(input: AiUsageInput): Promise<AiCostResult>;
+    private versionSuffixWarnings;
+    private finish;
+    private localProviderResult;
+    private unknownModelResult;
+}
+
+/** Prefer runtime id (`usedModel` / `modelUsed`); fall back to `model`. */
+declare function resolveUsageModel(input: AiUsageInput): string;
+
+export { type AiCostExtraction as A, CostCalculator as C, type ExtractUsageInputOptions as E, type FieldProvenance as F, MODEL_FIELD_PRIORITY as M, type TokenExtractionProvenance as T, type AiCostResult as a, type AiCostWarning as b, type AiCostWarningCode as c, type AiUsageInput as d, type CostCalculatorOptions as e, type ExtractUsageInputResult as f, extractUsageInput as g, resolveUsageModel as r };