@x12i/ai-tools 1.0.4 → 2.0.1

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 };

package/dist/sync/index.cjs

@@ -2,14 +2,13 @@
 
 
 
-var _chunkLYOU7CA2cjs = require('../chunk-LYOU7CA2.cjs');
 
+var _chunkPRCICORGcjs = require('../chunk-PRCICORG.cjs');
+require('../chunk-XOKUDUUI.cjs');
 
 
-var _chunkDKHGWHXPcjs = require('../chunk-DKHGWHXP.cjs');
-require('../chunk-FGP3QXWL.cjs');
-require('../chunk-AV6OE2YQ.cjs');
 
+var _chunkDXZOL3VNcjs = require('../chunk-DXZOL3VN.cjs');
 
 
 
@@ -17,9 +16,10 @@ require('../chunk-AV6OE2YQ.cjs');
 
 
 
+var _chunkEDMCKHO6cjs = require('../chunk-EDMCKHO6.cjs');
+require('../chunk-PADNCGZB.cjs');
+require('../chunk-GS7T56RP.cjs');
 
-var _chunkTF4L2NECcjs = require('../chunk-TF4L2NEC.cjs');
-require('../chunk-7Q742NI3.cjs');
 
 
 
@@ -32,7 +32,5 @@ require('../chunk-7Q742NI3.cjs');
 
 
 
-
-
-exports.ModelNameResolver = _chunkTF4L2NECcjs.ModelNameResolver; exports.OpenRouterSyncProvider = _chunkDKHGWHXPcjs.OpenRouterSyncProvider; exports.buildCatalogIndexes = _chunkTF4L2NECcjs.buildCatalogIndexes; exports.createModelNameResolver = _chunkLYOU7CA2cjs.createModelNameResolver; exports.isRoutedViaOpenRouter = _chunkLYOU7CA2cjs.isRoutedViaOpenRouter; exports.loadOpenRouterRoutingEnv = _chunkTF4L2NECcjs.loadOpenRouterRoutingEnv; exports.normalizeProvider = _chunkTF4L2NECcjs.normalizeProvider; exports.normalizeString = _chunkTF4L2NECcjs.normalizeString; exports.providerIdToEnvKeyPrefix = _chunkTF4L2NECcjs.providerIdToEnvKeyPrefix; exports.resolveModel = _chunkLYOU7CA2cjs.resolveModel; exports.shouldDefaultRouteViaOpenRouter = _chunkTF4L2NECcjs.shouldDefaultRouteViaOpenRouter; exports.syncAiModelsCatalog = _chunkDKHGWHXPcjs.syncAiModelsCatalog; exports.vendorApiKeyEnvName = _chunkTF4L2NECcjs.vendorApiKeyEnvName;
+exports.ModelNameResolver = _chunkDXZOL3VNcjs.ModelNameResolver; exports.OpenRouterSyncProvider = _chunkPRCICORGcjs.OpenRouterSyncProvider; exports.buildCatalogIndexes = _chunkDXZOL3VNcjs.buildCatalogIndexes; exports.createModelNameResolver = _chunkPRCICORGcjs.createModelNameResolver; exports.isRoutedViaOpenRouter = _chunkPRCICORGcjs.isRoutedViaOpenRouter; exports.loadOpenRouterRoutingEnv = _chunkEDMCKHO6cjs.loadOpenRouterRoutingEnv; exports.normalizeProvider = _chunkEDMCKHO6cjs.normalizeProvider; exports.normalizeString = _chunkEDMCKHO6cjs.normalizeString; exports.providerIdToEnvKeyPrefix = _chunkEDMCKHO6cjs.providerIdToEnvKeyPrefix; exports.resolveModel = _chunkPRCICORGcjs.resolveModel; exports.shouldDefaultRouteViaOpenRouter = _chunkEDMCKHO6cjs.shouldDefaultRouteViaOpenRouter; exports.vendorApiKeyEnvName = _chunkEDMCKHO6cjs.vendorApiKeyEnvName;
 //# sourceMappingURL=index.cjs.map

package/dist/sync/index.cjs.map

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

package/dist/sync/index.d.cts

@@ -1,11 +1,6 @@
-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';
-import { C as CatalogIndexes } from '../types-CX6QFNNy.cjs';
-export { M as ModelResolutionInput, f as ModelResolutionResult, g as ModelResolutionSuccess, h as ModelResolverOptions, O as OpenRouterRoutingConfig, R as ResolutionStrategy, i as ResolvedModel, l as loadOpenRouterRoutingEnv, p as providerIdToEnvKeyPrefix, s as shouldDefaultRouteViaOpenRouter, v as vendorApiKeyEnvName } from '../types-CX6QFNNy.cjs';
-import { a as AiModelRecord } from '../types-BYXnCvKx.cjs';
-import '@x12i/catalox';
-import 'firebase-admin/firestore';
-import '../upsertAiModelRecord-CjY-sny0.cjs';
+export { M as ModelNameResolver, O as OpenRouterSyncProvider, a as OpenRouterSyncProviderOptions, c as createModelNameResolver, i as isRoutedViaOpenRouter, r as resolveModel } from '../modelNameResolver-C5CSTGFF.cjs';
+import { a as AiModelRecord, C as CatalogIndexes } from '../types-BrzJWsTU.cjs';
+export { h as ModelResolutionInput, j as ModelResolutionResult, k as ModelResolutionSuccess, l as ModelResolverOptions, r as OpenRouterRoutingConfig, R as ResolutionStrategy, t as ResolvedModel, v as loadOpenRouterRoutingEnv, w as providerIdToEnvKeyPrefix, x as shouldDefaultRouteViaOpenRouter, y as vendorApiKeyEnvName } from '../types-BrzJWsTU.cjs';
 
 declare function buildCatalogIndexes(catalog: Map<string, AiModelRecord>): CatalogIndexes;
 

package/dist/sync/index.d.ts

@@ -1,11 +1,6 @@
-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';
-import { C as CatalogIndexes } from '../types-CuiPDcVs.js';
-export { M as ModelResolutionInput, f as ModelResolutionResult, g as ModelResolutionSuccess, h as ModelResolverOptions, O as OpenRouterRoutingConfig, R as ResolutionStrategy, i as ResolvedModel, l as loadOpenRouterRoutingEnv, p as providerIdToEnvKeyPrefix, s as shouldDefaultRouteViaOpenRouter, v as vendorApiKeyEnvName } from '../types-CuiPDcVs.js';
-import { a as AiModelRecord } from '../types-BYXnCvKx.js';
-import '@x12i/catalox';
-import 'firebase-admin/firestore';
-import '../upsertAiModelRecord-C831wOIF.js';
+export { M as ModelNameResolver, O as OpenRouterSyncProvider, a as OpenRouterSyncProviderOptions, c as createModelNameResolver, i as isRoutedViaOpenRouter, r as resolveModel } from '../modelNameResolver-5XkBMctP.js';
+import { a as AiModelRecord, C as CatalogIndexes } from '../types-BrzJWsTU.js';
+export { h as ModelResolutionInput, j as ModelResolutionResult, k as ModelResolutionSuccess, l as ModelResolverOptions, r as OpenRouterRoutingConfig, R as ResolutionStrategy, t as ResolvedModel, v as loadOpenRouterRoutingEnv, w as providerIdToEnvKeyPrefix, x as shouldDefaultRouteViaOpenRouter, y as vendorApiKeyEnvName } from '../types-BrzJWsTU.js';
 
 declare function buildCatalogIndexes(catalog: Map<string, AiModelRecord>): CatalogIndexes;
 

package/dist/sync/index.js

@@ -1,25 +1,23 @@
 import {
+  OpenRouterSyncProvider,
   createModelNameResolver,
   isRoutedViaOpenRouter,
   resolveModel
-} from "../chunk-G2G4KSC5.js";
-import {
-  OpenRouterSyncProvider,
-  syncAiModelsCatalog
-} from "../chunk-VRFVF5RH.js";
-import "../chunk-HYGXZY25.js";
-import "../chunk-6QGDZTGH.js";
+} from "../chunk-6BQBKROR.js";
+import "../chunk-SIH4GPV4.js";
 import {
   ModelNameResolver,
-  buildCatalogIndexes,
+  buildCatalogIndexes
+} from "../chunk-EYHMQVAL.js";
+import {
   loadOpenRouterRoutingEnv,
   normalizeProvider,
   normalizeString,
   providerIdToEnvKeyPrefix,
   shouldDefaultRouteViaOpenRouter,
   vendorApiKeyEnvName
-} from "../chunk-DJ5SWJDY.js";
-import "../chunk-AJEKEWWB.js";
+} from "../chunk-B3V2EHRY.js";
+import "../chunk-2PTCWPHV.js";
 export {
   ModelNameResolver,
   OpenRouterSyncProvider,
@@ -32,7 +30,6 @@ export {
   providerIdToEnvKeyPrefix,
   resolveModel,
   shouldDefaultRouteViaOpenRouter,
-  syncAiModelsCatalog,
   vendorApiKeyEnvName
 };
 //# sourceMappingURL=index.js.map

package/dist/toolbox/index.cjs

@@ -1,6 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 var _chunk5HNFAYTOcjs = require('../chunk-5HNFAYTO.cjs');
+require('../chunk-GS7T56RP.cjs');
 
 
 exports.AIToolbox = _chunk5HNFAYTOcjs.AIToolbox;

package/dist/toolbox/index.cjs.map

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