@peakinfer/cli 1.0.133

package/dist/connectors/types.js

@@ -0,0 +1,98 @@
+/**
+ * Shared types for runtime data connectors
+ *
+ * These types define the normalized format for runtime events
+ * from various sources (Helicone, LangSmith, etc.)
+ */
+export class ConnectorError extends Error {
+    source;
+    statusCode;
+    code;
+    constructor(message, source, statusCode, code) {
+        super(message);
+        this.source = source;
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = 'ConnectorError';
+    }
+}
+// Helper functions for calculating summary statistics
+export function calculatePercentile(values, percentile) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const index = Math.ceil((percentile / 100) * sorted.length) - 1;
+    return sorted[Math.max(0, index)];
+}
+export function calculateSummary(events) {
+    if (events.length === 0) {
+        return {
+            total_requests: 0,
+            total_cost_usd: 0,
+            avg_latency_ms: 0,
+            p50_latency_ms: 0,
+            p95_latency_ms: 0,
+            p99_latency_ms: 0,
+            error_rate: 0,
+            streaming_rate: 0,
+            by_model: {},
+            by_provider: {},
+            time_range: { start: '', end: '' },
+        };
+    }
+    const latencies = events.map(e => e.latency_ms).filter(l => l > 0);
+    const costs = events.map(e => e.cost_usd || 0);
+    const errors = events.filter(e => !e.success).length;
+    const streaming = events.filter(e => e.streaming).length;
+    // Group by model
+    const byModel = {};
+    for (const event of events) {
+        const model = event.model || 'unknown';
+        if (!byModel[model]) {
+            byModel[model] = { count: 0, cost: 0, avg_latency_ms: 0, p95_latency_ms: 0, error_rate: 0 };
+        }
+        byModel[model].count++;
+        byModel[model].cost += event.cost_usd || 0;
+    }
+    // Calculate per-model stats
+    for (const model of Object.keys(byModel)) {
+        const modelEvents = events.filter(e => (e.model || 'unknown') === model);
+        const modelLatencies = modelEvents.map(e => e.latency_ms).filter(l => l > 0);
+        const modelErrors = modelEvents.filter(e => !e.success).length;
+        byModel[model].avg_latency_ms = modelLatencies.length > 0
+            ? Math.round(modelLatencies.reduce((a, b) => a + b, 0) / modelLatencies.length)
+            : 0;
+        byModel[model].p95_latency_ms = calculatePercentile(modelLatencies, 95);
+        byModel[model].error_rate = modelEvents.length > 0 ? modelErrors / modelEvents.length : 0;
+    }
+    // Group by provider
+    const byProvider = {};
+    for (const event of events) {
+        const provider = event.provider || 'unknown';
+        if (!byProvider[provider]) {
+            byProvider[provider] = { count: 0, cost: 0 };
+        }
+        byProvider[provider].count++;
+        byProvider[provider].cost += event.cost_usd || 0;
+    }
+    // Time range
+    const timestamps = events.map(e => new Date(e.timestamp).getTime()).filter(t => !isNaN(t));
+    const timeRange = {
+        start: timestamps.length > 0 ? new Date(Math.min(...timestamps)).toISOString() : '',
+        end: timestamps.length > 0 ? new Date(Math.max(...timestamps)).toISOString() : '',
+    };
+    return {
+        total_requests: events.length,
+        total_cost_usd: costs.reduce((a, b) => a + b, 0),
+        avg_latency_ms: latencies.length > 0 ? Math.round(latencies.reduce((a, b) => a + b, 0) / latencies.length) : 0,
+        p50_latency_ms: calculatePercentile(latencies, 50),
+        p95_latency_ms: calculatePercentile(latencies, 95),
+        p99_latency_ms: calculatePercentile(latencies, 99),
+        error_rate: events.length > 0 ? errors / events.length : 0,
+        streaming_rate: events.length > 0 ? streaming / events.length : 0,
+        by_model: byModel,
+        by_provider: byProvider,
+        time_range: timeRange,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/connectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connectors/types.ts"],"names":[],"mappings":"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"}

package/dist/cost-estimator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Cost Estimation Module for PeakInfer CLI
+ *
+ * Estimates LLM API costs before running analysis to prevent surprise bills
+ * on large repositories. Uses LiteLLM pricing data with 24hr cache.
+ *
+ * PRD v1.9.3 Section 2.3: Cost Estimation (Pre-Analysis Transparency)
+ */
+export interface CostEstimate {
+    model: string;
+    filesToScan: number;
+    estimatedInputTokens: number;
+    estimatedOutputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    totalCost: number;
+    pricing: {
+        inputPerMillion: number;
+        outputPerMillion: number;
+        source: 'litellm' | 'fallback';
+    };
+    warnings: CostWarning[];
+}
+export interface CostWarning {
+    level: 'yellow' | 'red' | 'critical';
+    message: string;
+}
+/**
+ * Estimate the cost of analyzing a codebase before running the analysis.
+ *
+ * @param path - Path to the codebase to analyze
+ * @param options - Optional model override
+ * @returns Cost estimate with warnings
+ */
+export declare function estimateAnalysisCost(path: string, options?: {
+    model?: string;
+}): Promise<CostEstimate>;
+/**
+ * Check if estimated cost exceeds a threshold.
+ *
+ * @param estimate - Cost estimate to check
+ * @param maxCost - Maximum allowed cost in USD
+ * @returns true if cost exceeds threshold
+ */
+export declare function exceedsMaxCost(estimate: CostEstimate, maxCost: number): boolean;
+//# sourceMappingURL=cost-estimator.d.ts.map

package/dist/cost-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../src/cost-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;KAChC,CAAC;IACF,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AA4BD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,YAAY,CAAC,CA6DvB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE/E"}

package/dist/cost-estimator.js

@@ -0,0 +1,104 @@
+/**
+ * Cost Estimation Module for PeakInfer CLI
+ *
+ * Estimates LLM API costs before running analysis to prevent surprise bills
+ * on large repositories. Uses LiteLLM pricing data with 24hr cache.
+ *
+ * PRD v1.9.3 Section 2.3: Cost Estimation (Pre-Analysis Transparency)
+ */
+import { scan } from './scanner.js';
+import { loadPricing, getModelCost } from './costs.js';
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+// Token estimation constants (based on empirical analysis of codebases)
+const AVG_TOKENS_PER_FILE = 2000; // Average input tokens per code file
+const AVG_OUTPUT_RATIO = 0.35; // Output tokens as ratio of input
+// Warning thresholds (in USD)
+const WARNING_THRESHOLD_YELLOW = 5;
+const WARNING_THRESHOLD_RED = 20;
+const WARNING_THRESHOLD_CRITICAL = 100;
+// Default model if not specified (matches agent.ts default)
+const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
+// Fallback pricing if LiteLLM fetch fails (Claude Sonnet pricing)
+const FALLBACK_PRICING = {
+    input: 3.00, // $3.00 per 1M input tokens
+    output: 15.00, // $15.00 per 1M output tokens
+};
+// =============================================================================
+// MAIN FUNCTION
+// =============================================================================
+/**
+ * Estimate the cost of analyzing a codebase before running the analysis.
+ *
+ * @param path - Path to the codebase to analyze
+ * @param options - Optional model override
+ * @returns Cost estimate with warnings
+ */
+export async function estimateAnalysisCost(path, options = {}) {
+    const model = options.model || DEFAULT_MODEL;
+    // Step 1: Scan codebase to count files
+    const scanResult = await scan(path);
+    const filesToScan = scanResult.summary.totalFiles;
+    // Step 2: Estimate tokens
+    const estimatedInputTokens = filesToScan * AVG_TOKENS_PER_FILE;
+    const estimatedOutputTokens = Math.round(estimatedInputTokens * AVG_OUTPUT_RATIO);
+    // Step 3: Load pricing data
+    await loadPricing();
+    const modelCost = getModelCost(model);
+    // Determine if using LiteLLM or fallback
+    const useFallback = modelCost.input === 0 && modelCost.output === 0;
+    const pricing = useFallback
+        ? { input: FALLBACK_PRICING.input, output: FALLBACK_PRICING.output }
+        : { input: modelCost.input, output: modelCost.output };
+    // Step 4: Calculate costs
+    const inputCost = (estimatedInputTokens * pricing.input) / 1_000_000;
+    const outputCost = (estimatedOutputTokens * pricing.output) / 1_000_000;
+    const totalCost = inputCost + outputCost;
+    // Step 5: Generate warnings based on cost
+    const warnings = [];
+    if (totalCost > WARNING_THRESHOLD_CRITICAL) {
+        warnings.push({
+            level: 'critical',
+            message: 'Very high cost estimate. Strongly recommend limiting scope.',
+        });
+    }
+    else if (totalCost > WARNING_THRESHOLD_RED) {
+        warnings.push({
+            level: 'red',
+            message: 'High cost estimate. Consider analyzing a subdirectory.',
+        });
+    }
+    else if (totalCost > WARNING_THRESHOLD_YELLOW) {
+        warnings.push({
+            level: 'yellow',
+            message: 'Moderate cost. Consider analyzing a subdirectory for faster results.',
+        });
+    }
+    return {
+        model,
+        filesToScan,
+        estimatedInputTokens,
+        estimatedOutputTokens,
+        inputCost,
+        outputCost,
+        totalCost,
+        pricing: {
+            inputPerMillion: pricing.input,
+            outputPerMillion: pricing.output,
+            source: useFallback ? 'fallback' : 'litellm',
+        },
+        warnings,
+    };
+}
+/**
+ * Check if estimated cost exceeds a threshold.
+ *
+ * @param estimate - Cost estimate to check
+ * @param maxCost - Maximum allowed cost in USD
+ * @returns true if cost exceeds threshold
+ */
+export function exceedsMaxCost(estimate, maxCost) {
+    return estimate.totalCost > maxCost;
+}
+//# sourceMappingURL=cost-estimator.js.map

package/dist/cost-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.js","sourceRoot":"","sources":["../src/cost-estimator.ts"],"names":[],"mappings":"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"}

package/dist/costs.d.ts

@@ -0,0 +1,57 @@
+export interface ModelCost {
+    input: number;
+    output: number;
+}
+export interface PricingProvider {
+    name: string;
+    fetch(): Promise<Record<string, ModelCost>>;
+}
+/**
+ * Set a custom pricing provider.
+ * Call this before loadPricing() to use a different data source.
+ *
+ * Example:
+ *   setPricingProvider({ name: 'local', fetch: async () => ({ ... }) });
+ */
+export declare function setPricingProvider(provider: PricingProvider): void;
+export declare function isCacheValid(): boolean;
+export declare function loadPricing(): Promise<void>;
+export declare function getModelCost(model: string): ModelCost;
+export declare function calculateCost(model: string, inputTokens: number, outputTokens: number): number;
+export declare function setTestPricing(data: Record<string, {
+    input: number;
+    output: number;
+}>): void;
+/**
+ * Pricing tier classification based on cost per 1M tokens
+ */
+export type PricingTier = 'expensive' | 'moderate' | 'cheap' | 'unknown';
+/**
+ * Classify a model into pricing tiers
+ */
+export declare function classifyModelCost(model: string): PricingTier;
+/**
+ * Get pricing context for LLM analysis
+ * Returns a condensed pricing map for models used in the data
+ */
+export interface PricingContext {
+    models: Record<string, {
+        input: number;
+        output: number;
+        tier: PricingTier;
+    }>;
+    thresholds: {
+        expensive: number;
+        moderate: number;
+    };
+}
+export declare function getPricingContext(models: string[]): PricingContext;
+/**
+ * Calculate total cost for a set of events
+ */
+export declare function calculateTotalCost(events: Array<{
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+}>): number;
+//# sourceMappingURL=costs.d.ts.map

package/dist/costs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../src/costs.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC7C;AAqFD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAIlE;AAqCD,wBAAgB,YAAY,IAAI,OAAO,CAKtC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAmCrD;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAM5F;AAMD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAKzE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAgB5D;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,WAAW,CAAC;KACnB,CAAC,CAAC;IACH,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAmBlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,GAAG,MAAM,CAIV"}

package/dist/costs.js

@@ -0,0 +1,251 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+// =============================================================================
+// LITELLM PROVIDER (Default)
+// =============================================================================
+const LITELLM_PRICING_URL = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json';
+function normalizeLiteLLMPricing(litellmData) {
+    const result = {};
+    for (const [model, info] of Object.entries(litellmData)) {
+        if (typeof info !== 'object' || info === null)
+            continue;
+        const data = info;
+        const inputCost = data.input_cost_per_token;
+        const outputCost = data.output_cost_per_token;
+        if (typeof inputCost === 'number' && typeof outputCost === 'number') {
+            // Convert per-token to per-1M-tokens
+            result[model] = {
+                input: inputCost * 1_000_000,
+                output: outputCost * 1_000_000,
+            };
+        }
+    }
+    return result;
+}
+const litellmProvider = {
+    name: 'litellm',
+    async fetch() {
+        const response = await fetch(LITELLM_PRICING_URL);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+        }
+        const rawData = await response.json();
+        return normalizeLiteLLMPricing(rawData);
+    },
+};
+// =============================================================================
+// LOCAL PROVIDER (Ready for future use)
+// =============================================================================
+// Uncomment and populate to use local pricing instead of LiteLLM.
+// Then call: setPricingProvider(localProvider)
+/*
+const localProvider: PricingProvider = {
+  name: 'local',
+  async fetch(): Promise<Record<string, ModelCost>> {
+    // Local pricing data - $/1M tokens
+    return {
+      'gpt-4o': { input: 2.50, output: 10.00 },
+      'gpt-4o-mini': { input: 0.15, output: 0.60 },
+      'gpt-4-turbo': { input: 10.00, output: 30.00 },
+      'claude-3-5-sonnet': { input: 3.00, output: 15.00 },
+      'claude-3-haiku': { input: 0.25, output: 1.25 },
+      'claude-sonnet-4-20250514': { input: 3.00, output: 15.00 },
+      // Add more models as needed
+    };
+  },
+};
+*/
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CACHE_DIR = '.peakinfer/cache';
+const CACHE_FILE = 'pricing.json';
+// =============================================================================
+// STATE
+// =============================================================================
+let pricingCache = null;
+let activeProvider = litellmProvider;
+// =============================================================================
+// PROVIDER MANAGEMENT
+// =============================================================================
+/**
+ * Set a custom pricing provider.
+ * Call this before loadPricing() to use a different data source.
+ *
+ * Example:
+ *   setPricingProvider({ name: 'local', fetch: async () => ({ ... }) });
+ */
+export function setPricingProvider(provider) {
+    activeProvider = provider;
+    // Invalidate cache when provider changes
+    pricingCache = null;
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+function getCachePath() {
+    return join(process.cwd(), CACHE_DIR, CACHE_FILE);
+}
+function loadCacheFromDisk() {
+    const cachePath = getCachePath();
+    if (!existsSync(cachePath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(cachePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function saveCacheToDisk(cache) {
+    const cachePath = getCachePath();
+    const cacheDir = join(process.cwd(), CACHE_DIR);
+    if (!existsSync(cacheDir)) {
+        mkdirSync(cacheDir, { recursive: true });
+    }
+    writeFileSync(cachePath, JSON.stringify(cache, null, 2));
+}
+// =============================================================================
+// PUBLIC API
+// =============================================================================
+export function isCacheValid() {
+    if (!pricingCache)
+        return false;
+    // Also invalidate if provider changed
+    if (pricingCache.source !== activeProvider.name)
+        return false;
+    return Date.now() - pricingCache.fetchedAt < CACHE_TTL_MS;
+}
+export async function loadPricing() {
+    // Check memory cache
+    if (isCacheValid()) {
+        return;
+    }
+    // Check disk cache (only if same provider)
+    const diskCache = loadCacheFromDisk();
+    if (diskCache &&
+        diskCache.source === activeProvider.name &&
+        Date.now() - diskCache.fetchedAt < CACHE_TTL_MS) {
+        pricingCache = diskCache;
+        return;
+    }
+    // Fetch from active provider
+    try {
+        const data = await activeProvider.fetch();
+        pricingCache = {
+            data,
+            fetchedAt: Date.now(),
+            source: activeProvider.name,
+        };
+        saveCacheToDisk(pricingCache);
+    }
+    catch (error) {
+        // Fall back to stale cache if available and same provider
+        if (diskCache && diskCache.source === activeProvider.name) {
+            console.warn(`[costs] Failed to fetch from ${activeProvider.name}, using stale cache`);
+            pricingCache = diskCache;
+            return;
+        }
+        // No cache at all - use empty with warning
+        console.warn(`[costs] Failed to fetch from ${activeProvider.name}, no cache available`);
+        pricingCache = {
+            data: {},
+            fetchedAt: Date.now(),
+            source: activeProvider.name,
+        };
+    }
+}
+export function getModelCost(model) {
+    if (!pricingCache) {
+        return { input: 0, output: 0 };
+    }
+    // Try exact match
+    if (pricingCache.data[model]) {
+        return pricingCache.data[model];
+    }
+    // Try with provider prefix variations
+    const variations = [
+        model,
+        `openai/${model}`,
+        `anthropic/${model}`,
+        `azure/${model}`,
+        `together_ai/${model}`,
+        `fireworks_ai/${model}`,
+    ];
+    for (const variant of variations) {
+        if (pricingCache.data[variant]) {
+            return pricingCache.data[variant];
+        }
+    }
+    // Try partial match (model name contains)
+    const lowerModel = model.toLowerCase();
+    for (const [key, cost] of Object.entries(pricingCache.data)) {
+        if (key.toLowerCase().includes(lowerModel)) {
+            return cost;
+        }
+    }
+    return { input: 0, output: 0 };
+}
+export function calculateCost(model, inputTokens, outputTokens) {
+    const cost = getModelCost(model);
+    return (inputTokens * cost.input + outputTokens * cost.output) / 1_000_000;
+}
+export function setTestPricing(data) {
+    pricingCache = {
+        data,
+        fetchedAt: Date.now(),
+        source: 'test',
+    };
+}
+const EXPENSIVE_THRESHOLD = 10.0; // >$10/1M = expensive
+const MODERATE_THRESHOLD = 1.0; // $1-10/1M = moderate
+/**
+ * Classify a model into pricing tiers
+ */
+export function classifyModelCost(model) {
+    const cost = getModelCost(model);
+    if (cost.input === 0 && cost.output === 0) {
+        return 'unknown';
+    }
+    // Use average of input/output cost for classification
+    const avgCost = (cost.input + cost.output) / 2;
+    if (avgCost > EXPENSIVE_THRESHOLD) {
+        return 'expensive';
+    }
+    else if (avgCost > MODERATE_THRESHOLD) {
+        return 'moderate';
+    }
+    else {
+        return 'cheap';
+    }
+}
+export function getPricingContext(models) {
+    const result = {
+        models: {},
+        thresholds: {
+            expensive: EXPENSIVE_THRESHOLD,
+            moderate: MODERATE_THRESHOLD,
+        },
+    };
+    for (const model of models) {
+        const cost = getModelCost(model);
+        result.models[model] = {
+            input: cost.input,
+            output: cost.output,
+            tier: classifyModelCost(model),
+        };
+    }
+    return result;
+}
+/**
+ * Calculate total cost for a set of events
+ */
+export function calculateTotalCost(events) {
+    return events.reduce((total, event) => {
+        return total + calculateCost(event.model, event.input_tokens, event.output_tokens);
+    }, 0);
+}
+//# sourceMappingURL=costs.js.map

package/dist/costs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.js","sourceRoot":"","sources":["../src/costs.ts"],"names":[],"mappings":"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"}

package/dist/counterfactuals.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Counterfactual Insights Module (v1.5)
+ *
+ * Generates "what if" optimization scenarios for inference points based on:
+ * - Model alternatives (cheaper/faster models)
+ * - Pattern opportunities (batching, caching, streaming)
+ * - Provider alternatives (cloud vs self-hosted)
+ *
+ * Shows the road not taken and its potential impact,
+ * enabling informed optimization decisions.
+ */
+import type { InferenceMap, Counterfactual, CounterfactualResult } from './types.js';
+/**
+ * Generate counterfactual insights for inference points.
+ */
+export declare function generateCounterfactuals(inferenceMap: InferenceMap): CounterfactualResult;
+/**
+ * Format counterfactual summary for display.
+ */
+export declare function formatCounterfactualSummary(result: CounterfactualResult): string;
+/**
+ * Check if there are significant counterfactual opportunities.
+ */
+export declare function hasSignificantOpportunities(result: CounterfactualResult): boolean;
+/**
+ * Rank counterfactuals by a specific priority.
+ */
+export declare function rankCounterfactuals(result: CounterfactualResult, priority: 'latency' | 'cost' | 'balanced'): Counterfactual[];
+//# sourceMappingURL=counterfactuals.d.ts.map

package/dist/counterfactuals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counterfactuals.d.ts","sourceRoot":"","sources":["../src/counterfactuals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,YAAY,EACZ,cAAc,EACd,oBAAoB,EAKrB,MAAM,YAAY,CAAC;AA4XpB;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,YAAY,GAAG,oBAAoB,CAqBxF;AAuCD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAehF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAGjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,GACxC,cAAc,EAAE,CAiBlB"}