@cervellaswarm/mcp-server 0.1.0

package/dist/billing/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Billing Types for CervellaSwarm
+ *
+ * Type definitions for usage tracking and tier management.
+ * Schema designed for local JSON storage with future-proofing.
+ *
+ * Copyright 2026 Rafa & Cervella
+ * Licensed under the Apache License, Version 2.0
+ */
+/**
+ * Available subscription tiers
+ */
+export type Tier = "free" | "pro" | "team" | "enterprise";
+/**
+ * Quota check status levels
+ */
+export declare enum QuotaStatus {
+    OK = "ok",// Under 80%
+    WARNING = "warning",// 80-99%
+    EXCEEDED = "exceeded"
+}
+/**
+ * Current billing period data
+ */
+export interface BillingPeriod {
+    /** Period identifier (YYYY-MM format) */
+    month: string;
+    /** Number of successful API calls this period */
+    calls: number;
+    /** Tier snapshot for this period */
+    tier: Tier;
+    /** ISO8601 timestamp of first call */
+    firstCallAt: string | null;
+    /** ISO8601 timestamp of last call */
+    lastCallAt: string | null;
+}
+/**
+ * Historical period record (for analytics)
+ */
+export interface HistoryRecord {
+    /** Period identifier (YYYY-MM format) */
+    month: string;
+    /** Total calls made */
+    calls: number;
+    /** Tier during this period */
+    tier: Tier;
+    /** Limit that was active */
+    limit: number;
+    /** ISO8601 start date */
+    startDate: string;
+    /** ISO8601 end date */
+    endDate: string;
+}
+/**
+ * Complete usage data schema (stored in usage.json)
+ */
+export interface UsageData {
+    /** Schema version for migrations */
+    version: string;
+    /** Current billing period */
+    currentPeriod: BillingPeriod;
+    /** Historical records (last 12 months max) */
+    history: HistoryRecord[];
+    /** Whether warning was shown this period */
+    warningShown: boolean;
+    /** Last sync timestamp (for clock skew detection) */
+    lastSyncTime: number;
+    /** Integrity checksum */
+    _checksum: string;
+}
+/**
+ * Result of quota check
+ */
+export interface QuotaResult {
+    /** Whether the call is allowed */
+    allowed: boolean;
+    /** Current quota status */
+    status: QuotaStatus;
+    /** Calls made this period */
+    used: number;
+    /** Limit for current tier */
+    limit: number;
+    /** Remaining calls */
+    remaining: number;
+    /** Warning message (if status is WARNING) */
+    warning?: string;
+    /** Error message (if status is EXCEEDED) */
+    error?: string;
+    /** When the period resets (ISO8601) */
+    resetsAt: string;
+}
+/**
+ * Usage statistics for check_usage tool
+ */
+export interface UsageStats {
+    /** Current tier */
+    tier: Tier;
+    /** Calls this period */
+    calls: number;
+    /** Period limit */
+    limit: number;
+    /** Remaining calls */
+    remaining: number;
+    /** Usage percentage (0-100) */
+    percentage: number;
+    /** Current period month */
+    period: string;
+    /** When period resets */
+    resetsAt: string;
+    /** Quota status */
+    status: QuotaStatus;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/billing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/billing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;AAE1D;;GAEG;AACH,oBAAY,WAAW;IACrB,EAAE,OAAO,CAAE,YAAY;IACvB,OAAO,YAAY,CAAE,SAAS;IAC9B,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,IAAI,CAAC;IACX,sCAAsC;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qCAAqC;IACrC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB"}

package/dist/billing/types.js

@@ -0,0 +1,19 @@
+/**
+ * Billing Types for CervellaSwarm
+ *
+ * Type definitions for usage tracking and tier management.
+ * Schema designed for local JSON storage with future-proofing.
+ *
+ * Copyright 2026 Rafa & Cervella
+ * Licensed under the Apache License, Version 2.0
+ */
+/**
+ * Quota check status levels
+ */
+export var QuotaStatus;
+(function (QuotaStatus) {
+    QuotaStatus["OK"] = "ok";
+    QuotaStatus["WARNING"] = "warning";
+    QuotaStatus["EXCEEDED"] = "exceeded";
+})(QuotaStatus || (QuotaStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/billing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/billing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;GAEG;AACH,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,wBAAS,CAAA;IACT,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;AACvB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB"}

package/dist/billing/usage.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Usage Tracker for CervellaSwarm
+ *
+ * Tracks API call usage per billing period.
+ * Features:
+ * - Atomic file writes with backup
+ * - Checksum integrity verification
+ * - Serialized writes (race condition safe)
+ * - Lazy monthly reset
+ *
+ * Copyright 2026 Rafa & Cervella
+ * Licensed under the Apache License, Version 2.0
+ */
+import { type Tier, type QuotaResult, QuotaStatus, type UsageStats } from "./types.js";
+export { QuotaStatus };
+/**
+ * Usage Tracker class
+ * Singleton pattern for consistent state
+ */
+declare class UsageTracker {
+    private usagePath;
+    private backupPath;
+    private writeQueue;
+    private tierGetter;
+    constructor(configDir: string, tierGetter: () => Tier);
+    /**
+     * Check quota before making an API call
+     */
+    checkQuota(): Promise<QuotaResult>;
+    /**
+     * Track a successful API call
+     */
+    trackCall(): Promise<void>;
+    /**
+     * Get usage statistics
+     */
+    getStats(): Promise<UsageStats>;
+    /**
+     * Get formatted usage message (for check_usage tool)
+     */
+    getUsageMessage(): Promise<string>;
+    /**
+     * Serialize write operations to prevent race conditions
+     */
+    private enqueueWrite;
+    /**
+     * Load usage data with auto-reset if new period
+     */
+    private loadUsage;
+    /**
+     * Load raw usage data from file
+     */
+    private loadUsageRaw;
+    /**
+     * Save usage data atomically with backup
+     */
+    private saveUsage;
+    /**
+     * Reset to new billing period
+     */
+    private resetPeriod;
+    /**
+     * Create initial usage data
+     */
+    private createInitialUsage;
+    /**
+     * Compute checksum for integrity verification
+     */
+    private computeChecksum;
+    /**
+     * Verify checksum integrity
+     */
+    private verifyChecksum;
+    /**
+     * Get current month in YYYY-MM format
+     */
+    private getCurrentMonth;
+    /**
+     * Get start of month ISO string
+     */
+    private getStartOfMonth;
+    /**
+     * Get end of month ISO string
+     */
+    private getEndOfMonth;
+}
+/**
+ * Get or create the usage tracker instance
+ */
+export declare function getUsageTracker(configDir: string, tierGetter: () => Tier): UsageTracker;
+/**
+ * Reset tracker instance (for testing)
+ */
+export declare function resetUsageTracker(): void;
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/billing/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAIL,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAepB,OAAO,EAAE,WAAW,EAAE,CAAC;AAiCvB;;;GAGG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAAa;gBAEnB,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,IAAI;IAWrD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAoExC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IA8BrC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAcxC;;OAEG;YACW,YAAY;IAQ1B;;OAEG;YACW,SAAS;IAYvB;;OAEG;YACW,YAAY;IA2C1B;;OAEG;YACW,SAAS;IAoBvB;;OAEG;YACW,WAAW;IA2CzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAKtB;AAQD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,IAAI,GACrB,YAAY,CAKd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/billing/usage.js

@@ -0,0 +1,383 @@
+/**
+ * Usage Tracker for CervellaSwarm
+ *
+ * Tracks API call usage per billing period.
+ * Features:
+ * - Atomic file writes with backup
+ * - Checksum integrity verification
+ * - Serialized writes (race condition safe)
+ * - Lazy monthly reset
+ *
+ * Copyright 2026 Rafa & Cervella
+ * Licensed under the Apache License, Version 2.0
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as crypto from "crypto";
+import { z } from "zod";
+import { QuotaStatus, } from "./types.js";
+import { SCHEMA_VERSION, MAX_HISTORY_RECORDS, WARNING_THRESHOLD, getLimitForTier, isUnlimited, } from "./tiers.js";
+import { getWarningMessage, getLimitExceededMessage, getUsageStatusMessage, } from "./messages.js";
+// Re-export QuotaStatus for convenience
+export { QuotaStatus };
+// Checksum secret (machine-specific)
+const CHECKSUM_SECRET = process.env.CERVELLASWARM_SECRET || `cs-${process.env.USER || "user"}-local`;
+// Zod schema for validation
+const BillingPeriodSchema = z.object({
+    month: z.string().regex(/^\d{4}-\d{2}$/),
+    calls: z.number().int().min(0),
+    tier: z.enum(["free", "pro", "team", "enterprise"]),
+    firstCallAt: z.string().nullable(),
+    lastCallAt: z.string().nullable(),
+});
+const HistoryRecordSchema = z.object({
+    month: z.string(),
+    calls: z.number().int().min(0),
+    tier: z.enum(["free", "pro", "team", "enterprise"]),
+    limit: z.number().int().min(0),
+    startDate: z.string(),
+    endDate: z.string(),
+});
+const UsageDataSchema = z.object({
+    version: z.string(),
+    currentPeriod: BillingPeriodSchema,
+    history: z.array(HistoryRecordSchema).max(MAX_HISTORY_RECORDS),
+    warningShown: z.boolean(),
+    lastSyncTime: z.number(),
+    _checksum: z.string(),
+});
+/**
+ * Usage Tracker class
+ * Singleton pattern for consistent state
+ */
+class UsageTracker {
+    usagePath;
+    backupPath;
+    writeQueue = Promise.resolve();
+    tierGetter;
+    constructor(configDir, tierGetter) {
+        this.usagePath = path.join(configDir, "usage.json");
+        this.backupPath = path.join(configDir, "usage.json.backup");
+        this.tierGetter = tierGetter;
+        // Ensure config directory exists
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true, mode: 0o700 });
+        }
+    }
+    /**
+     * Check quota before making an API call
+     */
+    async checkQuota() {
+        const data = await this.loadUsage();
+        const tier = this.tierGetter();
+        const limit = getLimitForTier(tier);
+        // Calculate reset date (end of current month)
+        const resetsAt = this.getEndOfMonth(data.currentPeriod.month);
+        // Unlimited tier
+        if (isUnlimited(tier)) {
+            return {
+                allowed: true,
+                status: QuotaStatus.OK,
+                used: data.currentPeriod.calls,
+                limit,
+                remaining: Infinity,
+                resetsAt,
+            };
+        }
+        const used = data.currentPeriod.calls;
+        const remaining = Math.max(0, limit - used);
+        const percentage = used / limit;
+        // Exceeded
+        if (used >= limit) {
+            return {
+                allowed: false,
+                status: QuotaStatus.EXCEEDED,
+                used,
+                limit,
+                remaining: 0,
+                error: getLimitExceededMessage(tier, limit, resetsAt),
+                resetsAt,
+            };
+        }
+        // Warning (80%+)
+        if (percentage >= WARNING_THRESHOLD && !data.warningShown) {
+            // Mark warning as shown
+            await this.enqueueWrite(async () => {
+                const d = await this.loadUsageRaw();
+                d.warningShown = true;
+                await this.saveUsage(d);
+            });
+            return {
+                allowed: true,
+                status: QuotaStatus.WARNING,
+                used,
+                limit,
+                remaining,
+                warning: getWarningMessage(tier, used, limit),
+                resetsAt,
+            };
+        }
+        // OK
+        return {
+            allowed: true,
+            status: QuotaStatus.OK,
+            used,
+            limit,
+            remaining,
+            resetsAt,
+        };
+    }
+    /**
+     * Track a successful API call
+     */
+    async trackCall() {
+        await this.enqueueWrite(async () => {
+            const data = await this.loadUsageRaw();
+            const now = new Date().toISOString();
+            data.currentPeriod.calls++;
+            data.currentPeriod.lastCallAt = now;
+            if (!data.currentPeriod.firstCallAt) {
+                data.currentPeriod.firstCallAt = now;
+            }
+            data.lastSyncTime = Date.now();
+            await this.saveUsage(data);
+        });
+    }
+    /**
+     * Get usage statistics
+     */
+    async getStats() {
+        const data = await this.loadUsage();
+        const tier = this.tierGetter();
+        const limit = getLimitForTier(tier);
+        const used = data.currentPeriod.calls;
+        const remaining = Math.max(0, limit - used);
+        const percentage = isUnlimited(tier) ? 0 : Math.round((used / limit) * 100);
+        const resetsAt = this.getEndOfMonth(data.currentPeriod.month);
+        let status;
+        if (percentage >= 100) {
+            status = QuotaStatus.EXCEEDED;
+        }
+        else if (percentage >= WARNING_THRESHOLD * 100) {
+            status = QuotaStatus.WARNING;
+        }
+        else {
+            status = QuotaStatus.OK;
+        }
+        return {
+            tier,
+            calls: used,
+            limit,
+            remaining,
+            percentage,
+            period: data.currentPeriod.month,
+            resetsAt,
+            status,
+        };
+    }
+    /**
+     * Get formatted usage message (for check_usage tool)
+     */
+    async getUsageMessage() {
+        const stats = await this.getStats();
+        return getUsageStatusMessage(stats.tier, stats.calls, stats.limit, stats.resetsAt);
+    }
+    // ============================================
+    // PRIVATE METHODS
+    // ============================================
+    /**
+     * Serialize write operations to prevent race conditions
+     */
+    async enqueueWrite(operation) {
+        this.writeQueue = this.writeQueue.then(operation).catch((error) => {
+            console.error("UsageTracker write error:", error);
+            throw error;
+        });
+        return this.writeQueue;
+    }
+    /**
+     * Load usage data with auto-reset if new period
+     */
+    async loadUsage() {
+        let data = await this.loadUsageRaw();
+        // Check if period needs reset
+        const currentMonth = this.getCurrentMonth();
+        if (data.currentPeriod.month !== currentMonth) {
+            data = await this.resetPeriod(data, currentMonth);
+        }
+        return data;
+    }
+    /**
+     * Load raw usage data from file
+     */
+    async loadUsageRaw() {
+        // File doesn't exist - initialize
+        if (!fs.existsSync(this.usagePath)) {
+            const initial = this.createInitialUsage();
+            await this.saveUsage(initial);
+            return initial;
+        }
+        try {
+            const content = fs.readFileSync(this.usagePath, "utf8");
+            const parsed = JSON.parse(content);
+            const validated = UsageDataSchema.parse(parsed);
+            // Verify checksum integrity
+            if (!this.verifyChecksum(validated)) {
+                console.warn("UsageTracker: Checksum mismatch - file may have been tampered");
+                // Continue anyway for MVP, but log warning
+            }
+            return validated;
+        }
+        catch (error) {
+            // Try backup
+            if (fs.existsSync(this.backupPath)) {
+                console.warn("UsageTracker: Primary file corrupted, trying backup");
+                try {
+                    const backup = fs.readFileSync(this.backupPath, "utf8");
+                    const parsed = JSON.parse(backup);
+                    return UsageDataSchema.parse(parsed);
+                }
+                catch {
+                    // Backup also corrupted
+                }
+            }
+            // All corrupted - reinitialize
+            console.error("UsageTracker: All files corrupted, reinitializing");
+            const initial = this.createInitialUsage();
+            await this.saveUsage(initial);
+            return initial;
+        }
+    }
+    /**
+     * Save usage data atomically with backup
+     */
+    async saveUsage(data) {
+        // Update checksum
+        data._checksum = this.computeChecksum(data);
+        // Validate before saving
+        UsageDataSchema.parse(data);
+        // Backup existing file
+        if (fs.existsSync(this.usagePath)) {
+            fs.copyFileSync(this.usagePath, this.backupPath);
+        }
+        // Atomic write (write to temp, then rename)
+        const tempPath = `${this.usagePath}.tmp`;
+        fs.writeFileSync(tempPath, JSON.stringify(data, null, 2), {
+            mode: 0o600,
+        });
+        fs.renameSync(tempPath, this.usagePath);
+    }
+    /**
+     * Reset to new billing period
+     */
+    async resetPeriod(data, newMonth) {
+        const tier = this.tierGetter();
+        const limit = getLimitForTier(tier);
+        // Archive current period if had calls
+        if (data.currentPeriod.calls > 0) {
+            const historyRecord = {
+                month: data.currentPeriod.month,
+                calls: data.currentPeriod.calls,
+                tier: data.currentPeriod.tier,
+                limit: getLimitForTier(data.currentPeriod.tier),
+                startDate: this.getStartOfMonth(data.currentPeriod.month),
+                endDate: this.getEndOfMonth(data.currentPeriod.month),
+            };
+            data.history.unshift(historyRecord);
+            // Keep only last 12 months
+            if (data.history.length > MAX_HISTORY_RECORDS) {
+                data.history = data.history.slice(0, MAX_HISTORY_RECORDS);
+            }
+        }
+        // Reset current period
+        data.currentPeriod = {
+            month: newMonth,
+            calls: 0,
+            tier,
+            firstCallAt: null,
+            lastCallAt: null,
+        };
+        data.warningShown = false;
+        data.lastSyncTime = Date.now();
+        // Save
+        await this.saveUsage(data);
+        return data;
+    }
+    /**
+     * Create initial usage data
+     */
+    createInitialUsage() {
+        const tier = this.tierGetter();
+        const month = this.getCurrentMonth();
+        const data = {
+            version: SCHEMA_VERSION,
+            currentPeriod: {
+                month,
+                calls: 0,
+                tier,
+                firstCallAt: null,
+                lastCallAt: null,
+            },
+            history: [],
+            warningShown: false,
+            lastSyncTime: Date.now(),
+            _checksum: "",
+        };
+        data._checksum = this.computeChecksum(data);
+        return data;
+    }
+    /**
+     * Compute checksum for integrity verification
+     */
+    computeChecksum(data) {
+        const payload = `${data.version}|${data.currentPeriod.month}|${data.currentPeriod.calls}|${data.currentPeriod.tier}|${CHECKSUM_SECRET}`;
+        return crypto.createHash("sha256").update(payload).digest("hex");
+    }
+    /**
+     * Verify checksum integrity
+     */
+    verifyChecksum(data) {
+        const expected = this.computeChecksum(data);
+        return data._checksum === expected;
+    }
+    /**
+     * Get current month in YYYY-MM format
+     */
+    getCurrentMonth() {
+        return new Date().toISOString().substring(0, 7);
+    }
+    /**
+     * Get start of month ISO string
+     */
+    getStartOfMonth(month) {
+        return `${month}-01T00:00:00.000Z`;
+    }
+    /**
+     * Get end of month ISO string
+     */
+    getEndOfMonth(month) {
+        const [year, monthNum] = month.split("-").map(Number);
+        const lastDay = new Date(year, monthNum, 0).getDate();
+        return `${month}-${String(lastDay).padStart(2, "0")}T23:59:59.999Z`;
+    }
+}
+// ============================================
+// SINGLETON INSTANCE
+// ============================================
+let trackerInstance = null;
+/**
+ * Get or create the usage tracker instance
+ */
+export function getUsageTracker(configDir, tierGetter) {
+    if (!trackerInstance) {
+        trackerInstance = new UsageTracker(configDir, tierGetter);
+    }
+    return trackerInstance;
+}
+/**
+ * Reset tracker instance (for testing)
+ */
+export function resetUsageTracker() {
+    trackerInstance = null;
+}
+//# sourceMappingURL=usage.js.map

package/dist/billing/usage.js.map

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

package/dist/config/manager.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Config Manager for MCP Server
+ *
+ * Shares configuration with CLI through `conf` package.
+ * Same config file = CLI and MCP see same settings.
+ *
+ * Copyright 2026 Rafa & Cervella
+ * Licensed under the Apache License, Version 2.0
+ */
+export declare function getApiKey(): string | null;
+export declare function hasApiKey(): boolean;
+export declare function getApiKeySource(): "environment" | "config" | "none";
+export declare function getDefaultModel(): string;
+export declare function getTimeout(): number;
+export declare function getMaxRetries(): number;
+export declare function isVerbose(): boolean;
+export declare function getTier(): "free" | "pro" | "team" | "enterprise";
+export declare function setTier(tier: "free" | "pro" | "team" | "enterprise"): void;
+export declare function getConfigPath(): string;
+export declare function getConfigDir(): string;
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    warning?: string;
+}
+/**
+ * Validate API key by making a minimal test call
+ * Returns { valid: boolean, error?: string, warning?: string }
+ */
+export declare function validateApiKey(key?: string | null): Promise<ValidationResult>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsEH,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAUzC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,eAAe,IAAI,aAAa,GAAG,QAAQ,GAAG,MAAM,CAQnE;AAMD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,OAAO,IAAI,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAEhE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,CAE1E;AAMD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,GAAE,MAAM,GAAG,IAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA6C3B"}