@phuetz/code-buddy 0.1.12 → 0.1.14

package/dist/analytics/budget-alerts.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Budget Alert Manager
+ *
+ * Monitors session and budget costs, emitting alerts when
+ * spending approaches or exceeds configured thresholds.
+ *
+ * Default thresholds:
+ * - Warning at 70% of budget
+ * - Critical at 90% of budget
+ * - Limit reached at 100%
+ *
+ * @module analytics
+ */
+import { EventEmitter } from 'events';
+export interface BudgetAlert {
+    /** Alert severity level */
+    type: 'warning' | 'critical' | 'limit_reached';
+    /** Human-readable alert message */
+    message: string;
+    /** Current accumulated cost in USD */
+    currentCost: number;
+    /** Budget limit in USD */
+    limit: number;
+    /** Percentage of budget consumed (0-100+) */
+    percentage: number;
+}
+export interface BudgetAlertConfig {
+    /** Percentage (0-1) at which to emit a warning alert. Default: 0.7 */
+    warningThreshold: number;
+    /** Percentage (0-1) at which to emit a critical alert. Default: 0.9 */
+    criticalThreshold: number;
+}
+/**
+ * Budget Alert Manager
+ *
+ * Tracks spending against a budget limit and emits alerts
+ * when thresholds are crossed. Alerts are deduplicated so
+ * the same threshold level is only emitted once per session
+ * (until reset).
+ *
+ * Events:
+ * - 'alert' - Emitted with a BudgetAlert when a threshold is crossed
+ */
+export declare class BudgetAlertManager extends EventEmitter {
+    private config;
+    private alerts;
+    private emittedTypes;
+    constructor(config?: Partial<BudgetAlertConfig>);
+    /**
+     * Check current cost against limits and return an alert if a threshold is crossed.
+     *
+     * Alerts are deduplicated: once an alert of a given type has been emitted,
+     * it will not be emitted again until `reset()` is called.
+     *
+     * @param currentCost - Current accumulated cost in USD
+     * @param limit - Budget limit in USD
+     * @returns A BudgetAlert if a threshold was crossed, or null
+     */
+    check(currentCost: number, limit: number): BudgetAlert | null;
+    /**
+     * Get the history of all alerts emitted in this session.
+     */
+    getAlerts(): BudgetAlert[];
+    /**
+     * Reset all alert state, clearing history and deduplication tracking.
+     * This allows alerts to fire again for the same thresholds.
+     */
+    reset(): void;
+    /**
+     * Get the current configuration.
+     */
+    getConfig(): BudgetAlertConfig;
+    /**
+     * Update configuration thresholds.
+     */
+    updateConfig(config: Partial<BudgetAlertConfig>): void;
+    /**
+     * Record an alert and emit the 'alert' event.
+     */
+    private recordAlert;
+}

package/dist/analytics/budget-alerts.js

@@ -0,0 +1,126 @@
+/**
+ * Budget Alert Manager
+ *
+ * Monitors session and budget costs, emitting alerts when
+ * spending approaches or exceeds configured thresholds.
+ *
+ * Default thresholds:
+ * - Warning at 70% of budget
+ * - Critical at 90% of budget
+ * - Limit reached at 100%
+ *
+ * @module analytics
+ */
+import { EventEmitter } from 'events';
+const DEFAULT_CONFIG = {
+    warningThreshold: 0.7,
+    criticalThreshold: 0.9,
+};
+/**
+ * Budget Alert Manager
+ *
+ * Tracks spending against a budget limit and emits alerts
+ * when thresholds are crossed. Alerts are deduplicated so
+ * the same threshold level is only emitted once per session
+ * (until reset).
+ *
+ * Events:
+ * - 'alert' - Emitted with a BudgetAlert when a threshold is crossed
+ */
+export class BudgetAlertManager extends EventEmitter {
+    config;
+    alerts = [];
+    emittedTypes = new Set();
+    constructor(config) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Check current cost against limits and return an alert if a threshold is crossed.
+     *
+     * Alerts are deduplicated: once an alert of a given type has been emitted,
+     * it will not be emitted again until `reset()` is called.
+     *
+     * @param currentCost - Current accumulated cost in USD
+     * @param limit - Budget limit in USD
+     * @returns A BudgetAlert if a threshold was crossed, or null
+     */
+    check(currentCost, limit) {
+        if (limit <= 0) {
+            return null;
+        }
+        const percentage = (currentCost / limit) * 100;
+        // Check from most severe to least severe
+        if (currentCost >= limit && !this.emittedTypes.has('limit_reached')) {
+            const alert = {
+                type: 'limit_reached',
+                message: `Budget limit reached! Spent $${currentCost.toFixed(4)} of $${limit.toFixed(2)} budget (${percentage.toFixed(1)}%).`,
+                currentCost,
+                limit,
+                percentage,
+            };
+            this.recordAlert(alert);
+            return alert;
+        }
+        if (currentCost >= limit * this.config.criticalThreshold &&
+            !this.emittedTypes.has('critical')) {
+            const alert = {
+                type: 'critical',
+                message: `Critical: Approaching budget limit! Spent $${currentCost.toFixed(4)} of $${limit.toFixed(2)} budget (${percentage.toFixed(1)}%).`,
+                currentCost,
+                limit,
+                percentage,
+            };
+            this.recordAlert(alert);
+            return alert;
+        }
+        if (currentCost >= limit * this.config.warningThreshold &&
+            !this.emittedTypes.has('warning')) {
+            const alert = {
+                type: 'warning',
+                message: `Warning: Budget usage at ${percentage.toFixed(1)}%. Spent $${currentCost.toFixed(4)} of $${limit.toFixed(2)} budget.`,
+                currentCost,
+                limit,
+                percentage,
+            };
+            this.recordAlert(alert);
+            return alert;
+        }
+        return null;
+    }
+    /**
+     * Get the history of all alerts emitted in this session.
+     */
+    getAlerts() {
+        return [...this.alerts];
+    }
+    /**
+     * Reset all alert state, clearing history and deduplication tracking.
+     * This allows alerts to fire again for the same thresholds.
+     */
+    reset() {
+        this.alerts = [];
+        this.emittedTypes.clear();
+    }
+    /**
+     * Get the current configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration thresholds.
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Record an alert and emit the 'alert' event.
+     */
+    recordAlert(alert) {
+        this.alerts.push(alert);
+        this.emittedTypes.add(alert.type);
+        this.emit('alert', alert);
+    }
+}
+//# sourceMappingURL=budget-alerts.js.map

package/dist/analytics/budget-alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-alerts.js","sourceRoot":"","sources":["../../src/analytics/budget-alerts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAsBtC,MAAM,cAAc,GAAsB;IACxC,gBAAgB,EAAE,GAAG;IACrB,iBAAiB,EAAE,GAAG;CACvB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAC1C,MAAM,CAAoB;IAC1B,MAAM,GAAkB,EAAE,CAAC;IAC3B,YAAY,GAA6B,IAAI,GAAG,EAAE,CAAC;IAE3D,YAAY,MAAmC;QAC7C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAmB,EAAE,KAAa;QACtC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;QAE/C,yCAAyC;QACzC,IAAI,WAAW,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;YACpE,MAAM,KAAK,GAAgB;gBACzB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,gCAAgC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;gBAC7H,WAAW;gBACX,KAAK;gBACL,UAAU;aACX,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IACE,WAAW,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB;YACpD,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAClC,CAAC;YACD,MAAM,KAAK,GAAgB;gBACzB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,8CAA8C,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;gBAC3I,WAAW;gBACX,KAAK;gBACL,UAAU;aACX,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IACE,WAAW,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB;YACnD,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EACjC,CAAC;YACD,MAAM,KAAK,GAAgB;gBACzB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,4BAA4B,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;gBAC/H,WAAW;gBACX,KAAK;gBACL,UAAU;aACX,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAkC;QAC7C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAkB;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/analytics/cost-predictor.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Cost Predictor
+ *
+ * Estimates the cost of a request BEFORE execution based on:
+ * - Input token count from messages
+ * - Historical average output tokens (from CostTracker stats)
+ * - Model-specific pricing
+ *
+ * @module analytics
+ */
+import type { CostTracker } from '../utils/cost-tracker.js';
+export interface CostPrediction {
+    /** Estimated number of input tokens */
+    estimatedInputTokens: number;
+    /** Estimated number of output tokens */
+    estimatedOutputTokens: number;
+    /** Estimated cost in USD */
+    estimatedCost: number;
+    /** Model used for the prediction */
+    model: string;
+    /** Confidence level of the prediction */
+    confidence: 'low' | 'medium' | 'high';
+}
+/**
+ * Cost Predictor - Estimates request cost before execution
+ */
+export declare class CostPredictor {
+    private costTracker;
+    constructor(costTracker: CostTracker);
+    /**
+     * Estimate cost based on message history length and model.
+     *
+     * @param messages - The messages array to be sent to the LLM
+     * @param model - The model identifier
+     * @returns A cost prediction with estimated tokens, cost, and confidence
+     */
+    predict(messages: Array<{
+        role: string;
+        content: string;
+    }>, model: string): CostPrediction;
+    /**
+     * Get average cost per request from recorded history.
+     *
+     * @returns Average cost in USD, or 0 if no history exists
+     */
+    getAverageCostPerRequest(): number;
+    /**
+     * Get cost trend based on recent usage history.
+     *
+     * Compares the average cost of the first half of recent usage
+     * to the second half. A >20% change in either direction is
+     * considered increasing or decreasing.
+     *
+     * @returns 'increasing', 'decreasing', or 'stable'
+     */
+    getCostTrend(): 'increasing' | 'decreasing' | 'stable';
+    /**
+     * Estimate input token count from messages.
+     *
+     * Uses a character-based heuristic (approximately 4 characters per token)
+     * as a fast approximation without requiring tiktoken.
+     */
+    private estimateInputTokens;
+    /**
+     * Estimate output tokens based on historical average.
+     *
+     * If the cost tracker has recorded usage, uses the average
+     * output token count. Otherwise falls back to a default estimate.
+     */
+    private estimateOutputTokens;
+    /**
+     * Determine prediction confidence based on available data.
+     *
+     * - high: 5+ recent usage entries (good historical data)
+     * - medium: 1-4 recent entries (some data)
+     * - low: no recent usage (pure estimation)
+     */
+    private determineConfidence;
+}

package/dist/analytics/cost-predictor.js

@@ -0,0 +1,150 @@
+/**
+ * Cost Predictor
+ *
+ * Estimates the cost of a request BEFORE execution based on:
+ * - Input token count from messages
+ * - Historical average output tokens (from CostTracker stats)
+ * - Model-specific pricing
+ *
+ * @module analytics
+ */
+// Model pricing lookup (mirrors cost-tracker.ts)
+const MODEL_PRICING = {
+    'grok-3-latest': { inputPer1k: 0.005, outputPer1k: 0.015 },
+    'grok-3-fast': { inputPer1k: 0.003, outputPer1k: 0.009 },
+    'grok-code-fast-1': { inputPer1k: 0.002, outputPer1k: 0.006 },
+    'grok-2-latest': { inputPer1k: 0.002, outputPer1k: 0.010 },
+    'default': { inputPer1k: 0.003, outputPer1k: 0.010 },
+};
+/** Average characters per token (rough heuristic) */
+const CHARS_PER_TOKEN = 4;
+/** Default output token estimate when no history is available */
+const DEFAULT_OUTPUT_TOKENS = 500;
+/**
+ * Cost Predictor - Estimates request cost before execution
+ */
+export class CostPredictor {
+    costTracker;
+    constructor(costTracker) {
+        this.costTracker = costTracker;
+    }
+    /**
+     * Estimate cost based on message history length and model.
+     *
+     * @param messages - The messages array to be sent to the LLM
+     * @param model - The model identifier
+     * @returns A cost prediction with estimated tokens, cost, and confidence
+     */
+    predict(messages, model) {
+        const estimatedInputTokens = this.estimateInputTokens(messages);
+        const estimatedOutputTokens = this.estimateOutputTokens();
+        const pricing = MODEL_PRICING[model] || MODEL_PRICING['default'];
+        const estimatedCost = (estimatedInputTokens / 1000) * pricing.inputPer1k +
+            (estimatedOutputTokens / 1000) * pricing.outputPer1k;
+        const confidence = this.determineConfidence(messages);
+        return {
+            estimatedInputTokens,
+            estimatedOutputTokens,
+            estimatedCost,
+            model,
+            confidence,
+        };
+    }
+    /**
+     * Get average cost per request from recorded history.
+     *
+     * @returns Average cost in USD, or 0 if no history exists
+     */
+    getAverageCostPerRequest() {
+        const report = this.costTracker.getReport();
+        const recentUsage = report.recentUsage;
+        if (recentUsage.length === 0) {
+            return 0;
+        }
+        const totalCost = recentUsage.reduce((sum, u) => sum + u.cost, 0);
+        return totalCost / recentUsage.length;
+    }
+    /**
+     * Get cost trend based on recent usage history.
+     *
+     * Compares the average cost of the first half of recent usage
+     * to the second half. A >20% change in either direction is
+     * considered increasing or decreasing.
+     *
+     * @returns 'increasing', 'decreasing', or 'stable'
+     */
+    getCostTrend() {
+        const report = this.costTracker.getReport();
+        const recentUsage = report.recentUsage;
+        if (recentUsage.length < 4) {
+            return 'stable';
+        }
+        const midpoint = Math.floor(recentUsage.length / 2);
+        const firstHalf = recentUsage.slice(0, midpoint);
+        const secondHalf = recentUsage.slice(midpoint);
+        const firstAvg = firstHalf.reduce((sum, u) => sum + u.cost, 0) / firstHalf.length;
+        const secondAvg = secondHalf.reduce((sum, u) => sum + u.cost, 0) / secondHalf.length;
+        if (firstAvg === 0) {
+            return secondAvg > 0 ? 'increasing' : 'stable';
+        }
+        const changeRatio = (secondAvg - firstAvg) / firstAvg;
+        if (changeRatio > 0.2) {
+            return 'increasing';
+        }
+        else if (changeRatio < -0.2) {
+            return 'decreasing';
+        }
+        return 'stable';
+    }
+    /**
+     * Estimate input token count from messages.
+     *
+     * Uses a character-based heuristic (approximately 4 characters per token)
+     * as a fast approximation without requiring tiktoken.
+     */
+    estimateInputTokens(messages) {
+        let totalChars = 0;
+        for (const message of messages) {
+            // Account for role overhead (~4 tokens per message for role + framing)
+            totalChars += 16;
+            if (message.content) {
+                totalChars += message.content.length;
+            }
+        }
+        return Math.ceil(totalChars / CHARS_PER_TOKEN);
+    }
+    /**
+     * Estimate output tokens based on historical average.
+     *
+     * If the cost tracker has recorded usage, uses the average
+     * output token count. Otherwise falls back to a default estimate.
+     */
+    estimateOutputTokens() {
+        const report = this.costTracker.getReport();
+        const recentUsage = report.recentUsage;
+        if (recentUsage.length === 0) {
+            return DEFAULT_OUTPUT_TOKENS;
+        }
+        const totalOutputTokens = recentUsage.reduce((sum, u) => sum + u.outputTokens, 0);
+        return Math.ceil(totalOutputTokens / recentUsage.length);
+    }
+    /**
+     * Determine prediction confidence based on available data.
+     *
+     * - high: 5+ recent usage entries (good historical data)
+     * - medium: 1-4 recent entries (some data)
+     * - low: no recent usage (pure estimation)
+     */
+    determineConfidence(messages) {
+        const report = this.costTracker.getReport();
+        const recentCount = report.recentUsage.length;
+        if (recentCount >= 5) {
+            return 'high';
+        }
+        else if (recentCount >= 1) {
+            return 'medium';
+        }
+        return 'low';
+    }
+}
+//# sourceMappingURL=cost-predictor.js.map

package/dist/analytics/cost-predictor.js.map

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

package/dist/analytics/index.d.ts

@@ -14,3 +14,5 @@
 export { PersistentAnalytics, CostBudget, UsageEvent, AnalyticsSummary, CostAlert, getPersistentAnalytics, resetPersistentAnalytics, } from './persistent-analytics.js';
 export { MetricsDashboard, getMetricsDashboard, resetMetricsDashboard, type DashboardMetrics, type TokenMetrics, type CostMetrics, type ToolMetrics, type SessionMetrics, type PerformanceMetrics, } from './metrics-dashboard.js';
 export { ToolAnalytics, getToolAnalytics, resetToolAnalytics, type ToolExecution, type ToolStats, type ToolChain, type ToolSuggestion, type ToolAnalyticsSnapshot, } from './tool-analytics.js';
+export { CostPredictor, type CostPrediction, } from './cost-predictor.js';
+export { BudgetAlertManager, type BudgetAlert, type BudgetAlertConfig, } from './budget-alerts.js';

package/dist/analytics/index.js

@@ -14,4 +14,6 @@
 export { PersistentAnalytics, getPersistentAnalytics, resetPersistentAnalytics, } from './persistent-analytics.js';
 export { MetricsDashboard, getMetricsDashboard, resetMetricsDashboard, } from './metrics-dashboard.js';
 export { ToolAnalytics, getToolAnalytics, resetToolAnalytics, } from './tool-analytics.js';
+export { CostPredictor, } from './cost-predictor.js';
+export { BudgetAlertManager, } from './budget-alerts.js';
 //# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,mBAAmB,EAKnB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GAOtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAMnB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,mBAAmB,EAKnB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GAOtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAMnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,GAEd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC"}

package/dist/auth/profile-manager.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Auth Profile Manager
+ *
+ * OpenClaw-inspired profile manager with round-robin rotation and
+ * session stickiness. Manages authentication profiles across multiple
+ * providers with exponential backoff cooldowns, billing-aware failure
+ * handling, and persistent state.
+ */
+import { EventEmitter } from 'events';
+/**
+ * Authentication profile credentials
+ */
+export interface AuthProfileCredentials {
+    /** API key for api-key auth */
+    apiKey?: string;
+    /** OAuth access token */
+    accessToken?: string;
+    /** OAuth refresh token */
+    refreshToken?: string;
+}
+/**
+ * Authentication profile metadata
+ */
+export interface AuthProfileMetadata {
+    /** Model to use with this profile */
+    model?: string;
+    /** Base URL override */
+    baseURL?: string;
+    /** Additional metadata */
+    [key: string]: string | undefined;
+}
+/**
+ * Authentication profile
+ */
+export interface AuthProfile {
+    /** Unique profile ID */
+    id: string;
+    /** Provider name (e.g. 'grok', 'openai', 'anthropic') */
+    provider: string;
+    /** Authentication type */
+    type: 'api-key' | 'oauth';
+    /** Credentials */
+    credentials: AuthProfileCredentials;
+    /** Priority (higher = preferred) */
+    priority: number;
+    /** Profile metadata */
+    metadata: AuthProfileMetadata;
+}
+/**
+ * Rotation strategy for profile selection
+ */
+export type RotationStrategy = 'round-robin' | 'priority' | 'random';
+/**
+ * Auth Profile Manager configuration
+ */
+export interface AuthProfileManagerConfig {
+    /** Profiles to manage */
+    profiles: AuthProfile[];
+    /** Strategy for selecting next profile */
+    rotationStrategy: RotationStrategy;
+    /** Stick with a profile once selected for a session */
+    sessionSticky: boolean;
+    /** Base cooldown duration in ms after failure */
+    cooldownMs: number;
+    /** Cooldown duration for billing failures (5 hours) */
+    billingCooldownMs: number;
+    /** Maximum cooldown cap (24 hours) */
+    maxCooldownMs: number;
+    /** Path to persist state */
+    persistPath: string;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_AUTH_PROFILE_MANAGER_CONFIG: AuthProfileManagerConfig;
+/**
+ * Auth Profile Manager
+ *
+ * Manages authentication profiles with round-robin rotation, session
+ * stickiness, and exponential backoff cooldowns. Supports billing-aware
+ * failure handling with separate escalation.
+ *
+ * Events:
+ * - `profile:selected` - Emitted when a profile is selected (profileId, sessionId?)
+ * - `profile:failed` - Emitted when a profile fails (profileId, error)
+ * - `profile:cooldown` - Emitted when a profile enters cooldown (profileId, cooldownMs)
+ * - `profile:recovered` - Emitted when a profile exits cooldown (profileId)
+ */
+export declare class AuthProfileManager extends EventEmitter {
+    private config;
+    private profiles;
+    private cooldownStates;
+    private sessionBindings;
+    private roundRobinIndex;
+    private recoveryTimers;
+    constructor(config?: Partial<AuthProfileManagerConfig>);
+    /**
+     * Add a profile
+     */
+    addProfile(profile: AuthProfile): void;
+    /**
+     * Remove a profile
+     */
+    removeProfile(profileId: string): boolean;
+    /**
+     * Get a profile by ID
+     */
+    getProfile(profileId: string): AuthProfile | undefined;
+    /**
+     * Get all registered profiles
+     */
+    getAllProfiles(): AuthProfile[];
+    /**
+     * Get the next available profile, optionally sticky to a session.
+     *
+     * If sessionSticky is enabled and a session already has a bound profile
+     * that is healthy, that profile is returned. Otherwise a new profile is
+     * selected using the configured rotation strategy.
+     */
+    getNextProfile(sessionId?: string): AuthProfile | null;
+    /**
+     * Get the sticky profile for a session (without selecting a new one)
+     */
+    getProfileForSession(sessionId: string): AuthProfile | null;
+    /**
+     * Get all profiles not currently in cooldown
+     */
+    getHealthyProfiles(): AuthProfile[];
+    /**
+     * Mark a profile as failed with exponential backoff cooldown.
+     *
+     * Normal failures: 1min -> 5min -> 25min -> 1h (max)
+     * Billing failures: 5h -> 10h -> 20h -> 24h (max)
+     *
+     * The backoff multiplier is 5x for normal and 2x for billing.
+     */
+    markFailed(profileId: string, error: string, isBilling?: boolean): void;
+    /**
+     * Mark a profile as successful, resetting its failure count
+     */
+    markSuccess(profileId: string): void;
+    /**
+     * Release a session's sticky profile binding
+     */
+    releaseSession(sessionId: string): void;
+    /**
+     * Round-robin selection across healthy profiles
+     */
+    private selectRoundRobin;
+    /**
+     * Priority-based selection (highest priority first)
+     */
+    private selectByPriority;
+    /**
+     * Random selection
+     */
+    private selectRandom;
+    /**
+     * Check if a profile is currently in cooldown
+     */
+    private isInCooldown;
+    /**
+     * Recover a profile from cooldown
+     */
+    private recoverProfile;
+    /**
+     * Schedule automatic recovery after cooldown expires
+     */
+    private scheduleRecovery;
+    /**
+     * Save cooldown states to disk
+     */
+    private saveState;
+    /**
+     * Load cooldown states from disk
+     */
+    private loadState;
+    /**
+     * Get status of all profiles
+     */
+    getStatus(): Array<{
+        profileId: string;
+        provider: string;
+        type: 'api-key' | 'oauth';
+        priority: number;
+        healthy: boolean;
+        failureCount: number;
+        inCooldown: boolean;
+        cooldownRemainingMs: number;
+        lastError?: string;
+    }>;
+    /**
+     * Shutdown - clear all timers
+     */
+    shutdown(): void;
+}
+/**
+ * Get the auth profile manager singleton
+ */
+export declare function getAuthProfileManager(config?: Partial<AuthProfileManagerConfig>): AuthProfileManager;
+/**
+ * Reset the auth profile manager singleton
+ */
+export declare function resetAuthProfileManager(): void;
+export default AuthProfileManager;