mcp-rubber-duck 1.5.2 → 1.6.0

package/dist/services/pricing.js

@@ -0,0 +1,124 @@
+import { DEFAULT_PRICING } from '../data/default-pricing.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Provider name aliases.
+ * Maps common user-provided names to canonical provider names in pricing data.
+ */
+const PROVIDER_ALIASES = {
+    gemini: 'google',
+};
+/**
+ * PricingService manages token pricing data.
+ *
+ * It merges hardcoded default pricing with optional user config overrides.
+ * User overrides take precedence over defaults.
+ */
+export class PricingService {
+    pricing;
+    constructor(configPricing) {
+        this.pricing = this.mergePricing(DEFAULT_PRICING, configPricing);
+        const providerCount = Object.keys(this.pricing).length;
+        const modelCount = Object.values(this.pricing).reduce((acc, models) => acc + Object.keys(models).length, 0);
+        logger.debug(`PricingService initialized with ${providerCount} providers, ${modelCount} models`);
+    }
+    /**
+     * Deep merge pricing configs. Overrides take precedence.
+     */
+    mergePricing(defaults, overrides) {
+        const result = {};
+        // Deep copy all defaults
+        for (const [provider, models] of Object.entries(defaults)) {
+            result[provider] = {};
+            for (const [model, pricing] of Object.entries(models)) {
+                result[provider][model] = { ...pricing };
+            }
+        }
+        if (!overrides) {
+            return result;
+        }
+        // Apply overrides
+        for (const [provider, models] of Object.entries(overrides)) {
+            if (!result[provider]) {
+                result[provider] = {};
+            }
+            for (const [model, pricing] of Object.entries(models)) {
+                result[provider][model] = { ...pricing };
+            }
+        }
+        return result;
+    }
+    /**
+     * Resolve provider name, checking for aliases.
+     * First checks if provider exists directly, then checks aliases.
+     */
+    resolveProvider(provider) {
+        // Direct match takes precedence
+        if (this.pricing[provider]) {
+            return provider;
+        }
+        // Check aliases
+        return PROVIDER_ALIASES[provider] || provider;
+    }
+    /**
+     * Get pricing for a specific provider and model.
+     * Returns undefined if pricing is not configured.
+     * Supports provider aliases (e.g., "gemini" -> "google").
+     */
+    getPricing(provider, model) {
+        const resolvedProvider = this.resolveProvider(provider);
+        return this.pricing[resolvedProvider]?.[model];
+    }
+    /**
+     * Calculate the cost for a given number of tokens.
+     * Returns null if pricing is not configured for the provider/model.
+     */
+    calculateCost(provider, model, promptTokens, completionTokens) {
+        const pricing = this.getPricing(provider, model);
+        if (!pricing) {
+            return null;
+        }
+        const inputCost = (promptTokens / 1_000_000) * pricing.inputPricePerMillion;
+        const outputCost = (completionTokens / 1_000_000) * pricing.outputPricePerMillion;
+        return {
+            inputCost,
+            outputCost,
+            totalCost: inputCost + outputCost,
+        };
+    }
+    /**
+     * Check if pricing is configured for a provider/model combination.
+     * Supports provider aliases.
+     */
+    hasPricingFor(provider, model) {
+        return this.getPricing(provider, model) !== undefined;
+    }
+    /**
+     * Get all pricing data (for debugging/display).
+     * Returns a deep copy to prevent external mutation.
+     */
+    getAllPricing() {
+        const result = {};
+        for (const [provider, models] of Object.entries(this.pricing)) {
+            result[provider] = {};
+            for (const [model, pricing] of Object.entries(models)) {
+                result[provider][model] = { ...pricing };
+            }
+        }
+        return result;
+    }
+    /**
+     * Get list of all configured providers.
+     */
+    getProviders() {
+        return Object.keys(this.pricing);
+    }
+    /**
+     * Get list of all models for a provider.
+     * Supports provider aliases.
+     */
+    getModelsForProvider(provider) {
+        const resolvedProvider = this.resolveProvider(provider);
+        return Object.keys(this.pricing[resolvedProvider] || {});
+    }
+}
+//# sourceMappingURL=pricing.js.map

package/dist/services/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/services/pricing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C;;;GAGG;AACH,MAAM,gBAAgB,GAA2B;IAC/C,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,CAAgB;IAE/B,YAAY,aAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CACnD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EACjD,CAAC,CACF,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,mCAAmC,aAAa,eAAe,UAAU,SAAS,CAAC,CAAC;IACnG,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,QAAuB,EAAE,SAAyB;QACrE,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,yBAAyB;QACzB,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,kBAAkB;QAClB,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YACxB,CAAC;YACD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,QAAgB;QACtC,gCAAgC;QAChC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,gBAAgB;QAChB,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,QAAgB,EAAE,KAAa;QACxC,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,QAAgB,EAChB,KAAa,EACb,YAAoB,EACpB,gBAAwB;QAExB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;QAC5E,MAAM,UAAU,GAAG,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;QAElF,OAAO;YACL,SAAS;YACT,UAAU;YACV,SAAS,EAAE,SAAS,GAAG,UAAU;SAClC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,QAAgB,EAAE,KAAa;QAC3C,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,SAAS,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,QAAgB;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/services/usage.d.ts

@@ -0,0 +1,48 @@
+import { UsageData, UsageTimePeriod, UsageStatsResult } from '../config/types.js';
+import { PricingService } from './pricing.js';
+/**
+ * UsageService tracks token usage per model per day.
+ *
+ * Data is stored in ~/.mcp-rubber-duck/data/usage.json
+ * Writes are debounced to avoid excessive disk I/O.
+ */
+export declare class UsageService {
+    private usagePath;
+    private data;
+    private pricingService;
+    private pendingWrites;
+    private writeDebounceTimer;
+    private debounceMs;
+    constructor(pricingService: PricingService, options?: {
+        dataDir?: string;
+        debounceMs?: number;
+    });
+    private ensureDirectoryExists;
+    private loadUsage;
+    private saveUsage;
+    private scheduleSave;
+    private getTodayKey;
+    /**
+     * Record usage for a provider/model.
+     */
+    recordUsage(provider: string, model: string, promptTokens: number, completionTokens: number, cacheHit?: boolean, error?: boolean): void;
+    /**
+     * Get usage statistics for a time period.
+     */
+    getStats(period: UsageTimePeriod): UsageStatsResult;
+    private formatDate;
+    /**
+     * Flush pending writes immediately. Call on shutdown.
+     */
+    shutdown(): void;
+    /**
+     * Get raw usage data (for testing/debugging).
+     * Returns a deep copy to prevent external mutation.
+     */
+    getRawData(): UsageData;
+    /**
+     * Clear all usage data (for testing).
+     */
+    clearData(): void;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/services/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/services/usage.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EAGT,eAAe,EACf,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,kBAAkB,CAA8C;IACxE,OAAO,CAAC,UAAU,CAAS;gBAEf,cAAc,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAY/F,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,GAAE,OAAe,EACzB,KAAK,GAAE,OAAe,GACrB,IAAI;IAkCP;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB;IAyGnD,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAYhB;;;OAGG;IACH,UAAU,IAAI,SAAS;IAIvB;;OAEG;IACH,SAAS,IAAI,IAAI;CAIlB"}

package/dist/services/usage.js

@@ -0,0 +1,243 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { logger } from '../utils/logger.js';
+const USAGE_DATA_VERSION = 1;
+const DEFAULT_DEBOUNCE_MS = 5000;
+/**
+ * UsageService tracks token usage per model per day.
+ *
+ * Data is stored in ~/.mcp-rubber-duck/data/usage.json
+ * Writes are debounced to avoid excessive disk I/O.
+ */
+export class UsageService {
+    usagePath;
+    data;
+    pricingService;
+    pendingWrites = 0;
+    writeDebounceTimer = null;
+    debounceMs;
+    constructor(pricingService, options) {
+        this.pricingService = pricingService;
+        this.debounceMs = options?.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+        const dataDir = options?.dataDir ?? join(homedir(), '.mcp-rubber-duck', 'data');
+        this.ensureDirectoryExists(dataDir);
+        this.usagePath = join(dataDir, 'usage.json');
+        this.data = this.loadUsage();
+        logger.debug(`UsageService initialized, data path: ${this.usagePath}`);
+    }
+    ensureDirectoryExists(dir) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+            logger.debug(`Created data directory: ${dir}`);
+        }
+    }
+    loadUsage() {
+        try {
+            if (existsSync(this.usagePath)) {
+                const raw = readFileSync(this.usagePath, 'utf-8');
+                const data = JSON.parse(raw);
+                // Validate structure
+                if (typeof data !== 'object' || data === null) {
+                    throw new Error('Invalid usage data: not an object');
+                }
+                if (typeof data.daily !== 'object' || data.daily === null) {
+                    throw new Error('Invalid usage data: missing daily object');
+                }
+                logger.debug(`Loaded usage data from ${this.usagePath}`);
+                return data;
+            }
+        }
+        catch (error) {
+            logger.warn('Failed to load usage data, starting fresh:', error);
+        }
+        return { version: USAGE_DATA_VERSION, daily: {} };
+    }
+    saveUsage() {
+        try {
+            writeFileSync(this.usagePath, JSON.stringify(this.data, null, 2));
+            logger.debug(`Saved usage data to ${this.usagePath}`);
+        }
+        catch (error) {
+            logger.error('Failed to save usage data:', error);
+        }
+    }
+    scheduleSave() {
+        this.pendingWrites++;
+        if (this.writeDebounceTimer) {
+            clearTimeout(this.writeDebounceTimer);
+        }
+        this.writeDebounceTimer = setTimeout(() => {
+            this.saveUsage();
+            this.pendingWrites = 0;
+            this.writeDebounceTimer = null;
+        }, this.debounceMs);
+    }
+    getTodayKey() {
+        // Use local date to match getStats() behavior
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
+    /**
+     * Record usage for a provider/model.
+     */
+    recordUsage(provider, model, promptTokens, completionTokens, cacheHit = false, error = false) {
+        const today = this.getTodayKey();
+        // Initialize nested structure if needed
+        if (!this.data.daily[today]) {
+            this.data.daily[today] = {};
+        }
+        if (!this.data.daily[today][provider]) {
+            this.data.daily[today][provider] = {};
+        }
+        if (!this.data.daily[today][provider][model]) {
+            this.data.daily[today][provider][model] = {
+                requests: 0,
+                promptTokens: 0,
+                completionTokens: 0,
+                cacheHits: 0,
+                errors: 0,
+            };
+        }
+        const stats = this.data.daily[today][provider][model];
+        stats.requests++;
+        stats.promptTokens += promptTokens;
+        stats.completionTokens += completionTokens;
+        if (cacheHit)
+            stats.cacheHits++;
+        if (error)
+            stats.errors++;
+        logger.debug(`Recorded usage: ${provider}/${model} +${promptTokens}/${completionTokens} tokens`);
+        this.scheduleSave();
+    }
+    /**
+     * Get usage statistics for a time period.
+     */
+    getStats(period) {
+        const today = new Date();
+        today.setHours(0, 0, 0, 0);
+        let startDate;
+        switch (period) {
+            case 'today':
+                startDate = today;
+                break;
+            case '7d':
+                startDate = new Date(today.getTime() - 6 * 24 * 60 * 60 * 1000);
+                break;
+            case '30d':
+                startDate = new Date(today.getTime() - 29 * 24 * 60 * 60 * 1000);
+                break;
+            case 'all':
+                startDate = new Date(0);
+                break;
+        }
+        const aggregated = {};
+        const totals = {
+            requests: 0,
+            promptTokens: 0,
+            completionTokens: 0,
+            cacheHits: 0,
+            errors: 0,
+        };
+        const costByProvider = {};
+        let totalCost = 0;
+        let hasCostData = false;
+        for (const [dateKey, dayData] of Object.entries(this.data.daily)) {
+            // Parse dateKey as local date (not UTC) to match getTodayKey() format
+            // dateKey is "YYYY-MM-DD", we need to parse it as local midnight
+            const [year, month, day] = dateKey.split('-').map(Number);
+            const date = new Date(year, month - 1, day); // month is 0-indexed
+            // Skip invalid dates or dates outside range
+            if (isNaN(date.getTime()) || date < startDate || date > today)
+                continue;
+            for (const [provider, providerData] of Object.entries(dayData)) {
+                if (!aggregated[provider]) {
+                    aggregated[provider] = {};
+                    costByProvider[provider] = 0;
+                }
+                for (const [model, stats] of Object.entries(providerData)) {
+                    if (!aggregated[provider][model]) {
+                        aggregated[provider][model] = {
+                            requests: 0,
+                            promptTokens: 0,
+                            completionTokens: 0,
+                            cacheHits: 0,
+                            errors: 0,
+                        };
+                    }
+                    const agg = aggregated[provider][model];
+                    agg.requests += stats.requests;
+                    agg.promptTokens += stats.promptTokens;
+                    agg.completionTokens += stats.completionTokens;
+                    agg.cacheHits += stats.cacheHits;
+                    agg.errors += stats.errors;
+                    totals.requests += stats.requests;
+                    totals.promptTokens += stats.promptTokens;
+                    totals.completionTokens += stats.completionTokens;
+                    totals.cacheHits += stats.cacheHits;
+                    totals.errors += stats.errors;
+                    // Calculate cost if pricing available
+                    const cost = this.pricingService.calculateCost(provider, model, stats.promptTokens, stats.completionTokens);
+                    if (cost) {
+                        totalCost += cost.totalCost;
+                        costByProvider[provider] += cost.totalCost;
+                        hasCostData = true;
+                    }
+                }
+            }
+        }
+        const result = {
+            period,
+            startDate: this.formatDate(startDate),
+            endDate: this.formatDate(today),
+            usage: aggregated,
+            totals: {
+                ...totals,
+            },
+        };
+        if (hasCostData) {
+            result.totals.estimatedCostUSD = totalCost;
+            result.costByProvider = costByProvider;
+        }
+        return result;
+    }
+    formatDate(date) {
+        // Use local date components to match getTodayKey() and date filtering
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        const day = String(date.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
+    /**
+     * Flush pending writes immediately. Call on shutdown.
+     */
+    shutdown() {
+        if (this.writeDebounceTimer) {
+            clearTimeout(this.writeDebounceTimer);
+            this.writeDebounceTimer = null;
+        }
+        if (this.pendingWrites > 0) {
+            this.saveUsage();
+            this.pendingWrites = 0;
+        }
+        logger.debug('UsageService shutdown complete');
+    }
+    /**
+     * Get raw usage data (for testing/debugging).
+     * Returns a deep copy to prevent external mutation.
+     */
+    getRawData() {
+        return JSON.parse(JSON.stringify(this.data));
+    }
+    /**
+     * Clear all usage data (for testing).
+     */
+    clearData() {
+        this.data = { version: USAGE_DATA_VERSION, daily: {} };
+        this.scheduleSave();
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/services/usage.js.map

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

package/dist/tools/get-usage-stats.d.ts

@@ -0,0 +1,8 @@
+import { UsageService } from '../services/usage.js';
+export declare function getUsageStatsTool(usageService: UsageService, args: Record<string, unknown>): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=get-usage-stats.d.ts.map

package/dist/tools/get-usage-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-usage-stats.d.ts","sourceRoot":"","sources":["../../src/tools/get-usage-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOpD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;EA4E9B"}

package/dist/tools/get-usage-stats.js

@@ -0,0 +1,92 @@
+import { duckArt } from '../utils/ascii-art.js';
+import { logger } from '../utils/logger.js';
+const VALID_PERIODS = ['today', '7d', '30d', 'all'];
+export function getUsageStatsTool(usageService, args) {
+    const { period = 'today' } = args;
+    // Validate period
+    if (!VALID_PERIODS.includes(period)) {
+        throw new Error(`Invalid period "${period}". Valid options: ${VALID_PERIODS.join(', ')}`);
+    }
+    const stats = usageService.getStats(period);
+    // Format output
+    let output = `${duckArt.panel}\n\n`;
+    output += `📊 Usage Statistics: ${formatPeriodLabel(period)}\n`;
+    output += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+    output += `Period: ${stats.startDate} to ${stats.endDate}\n\n`;
+    // Totals section
+    output += `📈 TOTALS\n`;
+    output += `─────────────────────\n`;
+    output += `Requests: ${stats.totals.requests.toLocaleString()}\n`;
+    output += `Prompt Tokens: ${stats.totals.promptTokens.toLocaleString()}\n`;
+    output += `Completion Tokens: ${stats.totals.completionTokens.toLocaleString()}\n`;
+    output += `Total Tokens: ${(stats.totals.promptTokens + stats.totals.completionTokens).toLocaleString()}\n`;
+    output += `Cache Hits: ${stats.totals.cacheHits.toLocaleString()}\n`;
+    output += `Errors: ${stats.totals.errors.toLocaleString()}\n`;
+    if (stats.totals.estimatedCostUSD !== undefined) {
+        output += `💰 Estimated Cost: $${formatCost(stats.totals.estimatedCostUSD)} USD\n`;
+    }
+    // Per-provider breakdown
+    const providers = Object.keys(stats.usage);
+    if (providers.length > 0) {
+        output += `\n🦆 BY PROVIDER\n`;
+        output += `─────────────────────\n`;
+        for (const provider of providers) {
+            const models = stats.usage[provider];
+            output += `\n**${provider}**\n`;
+            for (const [model, modelStats] of Object.entries(models)) {
+                output += `  ${model}:\n`;
+                output += `    Requests: ${modelStats.requests.toLocaleString()}\n`;
+                output += `    Tokens: ${modelStats.promptTokens.toLocaleString()} in / ${modelStats.completionTokens.toLocaleString()} out\n`;
+                if (modelStats.cacheHits > 0) {
+                    output += `    Cache Hits: ${modelStats.cacheHits.toLocaleString()}\n`;
+                }
+                if (modelStats.errors > 0) {
+                    output += `    Errors: ${modelStats.errors.toLocaleString()}\n`;
+                }
+            }
+            if (stats.costByProvider && stats.costByProvider[provider] !== undefined) {
+                output += `  💰 Provider Cost: $${formatCost(stats.costByProvider[provider])}\n`;
+            }
+        }
+    }
+    else {
+        output += `\nNo usage data for this period.\n`;
+    }
+    // Footer note about cost
+    if (stats.totals.estimatedCostUSD === undefined && stats.totals.requests > 0) {
+        output += `\n💡 Cost estimates not available. Configure pricing in config.json or update to latest version.\n`;
+    }
+    logger.info(`Retrieved usage stats for period: ${period}`);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: output,
+            },
+        ],
+    };
+}
+function formatPeriodLabel(period) {
+    switch (period) {
+        case 'today':
+            return 'Today';
+        case '7d':
+            return 'Last 7 Days';
+        case '30d':
+            return 'Last 30 Days';
+        case 'all':
+            return 'All Time';
+    }
+}
+function formatCost(cost) {
+    if (cost < 0.01) {
+        return cost.toFixed(6);
+    }
+    else if (cost < 1) {
+        return cost.toFixed(4);
+    }
+    else {
+        return cost.toFixed(2);
+    }
+}
+//# sourceMappingURL=get-usage-stats.js.map

package/dist/tools/get-usage-stats.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-rubber-duck",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "An MCP server that bridges to multiple OpenAI-compatible LLMs - your AI rubber duck debugging panel",
   "main": "dist/index.js",
   "type": "module",

package/src/config/types.ts

@@ -33,6 +33,16 @@ export const MCPBridgeConfigSchema = z.object({
   mcp_servers: z.array(MCPServerConfigSchema).default([]),
 });
 
+export const ModelPricingSchema = z.object({
+  inputPricePerMillion: z.number().min(0),
+  outputPricePerMillion: z.number().min(0),
+});
+
+export const PricingConfigSchema = z.record(
+  z.string(), // provider name
+  z.record(z.string(), ModelPricingSchema) // model name -> pricing
+);
+
 export const ConfigSchema = z.object({
   providers: z.record(z.string(), ProviderConfigSchema),
   default_provider: z.string().optional(),
@@ -41,11 +51,14 @@ export const ConfigSchema = z.object({
   enable_failover: z.boolean().default(true),
   log_level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
   mcp_bridge: MCPBridgeConfigSchema.optional(),
+  pricing: PricingConfigSchema.optional(),
 });
 
 export type ProviderConfig = z.infer<typeof ProviderConfigSchema>;
 export type MCPServerConfig = z.infer<typeof MCPServerConfigSchema>;
 export type MCPBridgeConfig = z.infer<typeof MCPBridgeConfigSchema>;
+export type ModelPricing = z.infer<typeof ModelPricingSchema>;
+export type PricingConfig = z.infer<typeof PricingConfigSchema>;
 export type Config = z.infer<typeof ConfigSchema>;
 
 export interface ConversationMessage {
@@ -178,4 +191,42 @@ export interface DebateResult {
   synthesis: string;
   synthesizer: string;
   totalRounds: number;
+}
+
+// Usage Statistics Types
+export interface ModelUsageStats {
+  requests: number;
+  promptTokens: number;
+  completionTokens: number;
+  cacheHits: number;
+  errors: number;
+}
+
+export interface DailyUsage {
+  [provider: string]: {
+    [model: string]: ModelUsageStats;
+  };
+}
+
+export interface UsageData {
+  version: number;
+  daily: Record<string, DailyUsage>;
+}
+
+export type UsageTimePeriod = 'today' | '7d' | '30d' | 'all';
+
+export interface UsageStatsResult {
+  period: UsageTimePeriod;
+  startDate: string;
+  endDate: string;
+  usage: DailyUsage;
+  totals: {
+    requests: number;
+    promptTokens: number;
+    completionTokens: number;
+    cacheHits: number;
+    errors: number;
+    estimatedCostUSD?: number;
+  };
+  costByProvider?: Record<string, number>;
 }