@pcircle/claude-code-buddy-mcp 2.3.1

package/dist/core/ResourceMonitor.js

@@ -0,0 +1,181 @@
+import os from 'os';
+import { ValidationError } from '../errors/index.js';
+import { logger } from '../utils/logger.js';
+export class ResourceMonitor {
+    activeBackgroundCount = 0;
+    maxBackgroundAgents;
+    thresholds;
+    activeIntervals = new Set();
+    disposed = false;
+    constructor(maxBackgroundAgents = 6, thresholds) {
+        this.maxBackgroundAgents = maxBackgroundAgents;
+        this.thresholds = {
+            maxCPU: thresholds?.maxCPU ?? 70,
+            maxMemory: thresholds?.maxMemory ?? 8192,
+        };
+    }
+    getCurrentResources() {
+        const cpus = os.cpus();
+        const fallbackCores = typeof os.availableParallelism === 'function'
+            ? os.availableParallelism()
+            : 1;
+        const cores = Math.max(cpus.length, fallbackCores, 1);
+        const totalMem = os.totalmem() / (1024 * 1024);
+        const freeMem = os.freemem() / (1024 * 1024);
+        const usedMem = totalMem - freeMem;
+        const loadAvg = os.loadavg()[0];
+        const cpuUsage = Math.min(100, (loadAvg / cores) * 100);
+        return {
+            cpu: {
+                usage: cpuUsage,
+                cores,
+            },
+            memory: {
+                total: totalMem,
+                used: usedMem,
+                available: freeMem,
+                usagePercent: (usedMem / totalMem) * 100,
+            },
+            activeBackgroundAgents: this.activeBackgroundCount,
+        };
+    }
+    canRunBackgroundTask(config) {
+        const resources = this.getCurrentResources();
+        if (resources.activeBackgroundAgents >= this.maxBackgroundAgents) {
+            return {
+                canExecute: false,
+                reason: `Max concurrent background agents reached (${this.maxBackgroundAgents})`,
+                suggestion: 'Wait for existing tasks to complete or use foreground mode',
+                resources,
+            };
+        }
+        if (resources.cpu.usage > this.thresholds.maxCPU) {
+            return {
+                canExecute: false,
+                reason: `CPU usage too high (${resources.cpu.usage.toFixed(1)}% > ${this.thresholds.maxCPU}%)`,
+                suggestion: 'Use foreground mode or wait for CPU usage to decrease',
+                resources,
+            };
+        }
+        if (resources.memory.used > this.thresholds.maxMemory) {
+            return {
+                canExecute: false,
+                reason: `Memory usage too high (${resources.memory.used.toFixed(0)}MB > ${this.thresholds.maxMemory}MB)`,
+                suggestion: 'Close other applications or use foreground mode',
+                resources,
+            };
+        }
+        if (config && config.resourceLimits) {
+            const { maxCPU, maxMemory } = config.resourceLimits;
+            if (maxCPU !== undefined) {
+                const availableCPU = this.thresholds.maxCPU - resources.cpu.usage;
+                if (maxCPU > availableCPU) {
+                    return {
+                        canExecute: false,
+                        reason: `Task requires ${maxCPU}% CPU but only ${availableCPU.toFixed(1)}% available`,
+                        suggestion: 'Reduce task resource requirements or wait',
+                        resources,
+                    };
+                }
+            }
+            if (maxMemory !== undefined) {
+                if (maxMemory > resources.memory.available) {
+                    return {
+                        canExecute: false,
+                        reason: `Task requires ${maxMemory}MB but only ${resources.memory.available.toFixed(0)}MB available`,
+                        suggestion: 'Reduce task memory requirements or wait',
+                        resources,
+                    };
+                }
+            }
+        }
+        return {
+            canExecute: true,
+            resources,
+        };
+    }
+    registerBackgroundTask() {
+        this.activeBackgroundCount++;
+    }
+    unregisterBackgroundTask() {
+        if (this.activeBackgroundCount > 0) {
+            this.activeBackgroundCount--;
+        }
+    }
+    getActiveBackgroundCount() {
+        return this.activeBackgroundCount;
+    }
+    setMaxCPU(percentage) {
+        if (percentage < 0 || percentage > 100) {
+            throw new ValidationError('CPU percentage must be between 0 and 100', {
+                value: percentage,
+                min: 0,
+                max: 100,
+            });
+        }
+        this.thresholds.maxCPU = percentage;
+    }
+    setMaxMemory(megabytes) {
+        if (megabytes < 0) {
+            throw new ValidationError('Memory must be positive', {
+                value: megabytes,
+                min: 0,
+            });
+        }
+        this.thresholds.maxMemory = megabytes;
+    }
+    setMaxBackgroundAgents(count) {
+        if (count < 1) {
+            throw new ValidationError('Max background agents must be at least 1', {
+                value: count,
+                min: 1,
+            });
+        }
+        this.maxBackgroundAgents = count;
+    }
+    dispose() {
+        this.disposed = true;
+        for (const intervalId of this.activeIntervals) {
+            clearInterval(intervalId);
+        }
+        this.activeIntervals.clear();
+        logger.debug('[ResourceMonitor] Disposed all resources');
+    }
+    onThresholdExceeded(threshold, callback) {
+        if (this.disposed) {
+            throw new Error('ResourceMonitor has been disposed');
+        }
+        const intervalId = setInterval(() => {
+            try {
+                const resources = this.getCurrentResources();
+                if (threshold === 'cpu' && resources.cpu.usage > this.thresholds.maxCPU) {
+                    callback(resources);
+                }
+                else if (threshold === 'memory' &&
+                    resources.memory.used > this.thresholds.maxMemory) {
+                    callback(resources);
+                }
+            }
+            catch (error) {
+                logger.error(`[ResourceMonitor] Threshold callback error (${threshold}):`, {
+                    error: error instanceof Error ? error.message : String(error),
+                    threshold,
+                });
+            }
+        }, 5000);
+        this.activeIntervals.add(intervalId);
+        return () => {
+            clearInterval(intervalId);
+            this.activeIntervals.delete(intervalId);
+        };
+    }
+    getStats() {
+        return {
+            activeIntervals: this.activeIntervals.size,
+            activeBackgroundAgents: this.activeBackgroundCount,
+            maxBackgroundAgents: this.maxBackgroundAgents,
+            thresholds: { ...this.thresholds },
+        };
+    }
+}
+//# sourceMappingURL=ResourceMonitor.js.map

package/dist/core/ResourceMonitor.js.map

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

package/dist/core/ResultHandler.d.ts

@@ -0,0 +1,9 @@
+import { BackgroundTask } from './types.js';
+export declare class ResultHandler {
+    handleCompleted(task: BackgroundTask, result: unknown): void;
+    handleFailed(task: BackgroundTask, error: Error): void;
+    handleCancelled(task: BackgroundTask): void;
+    private executeCallback;
+    private sanitizeCallbackError;
+}
+//# sourceMappingURL=ResultHandler.d.ts.map

package/dist/core/ResultHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultHandler.d.ts","sourceRoot":"","sources":["../../src/core/ResultHandler.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsB5C,qBAAa,aAAa;IA8BxB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IA+C5D,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAoCtD,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAmB3C,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,qBAAqB;CAyB9B"}

package/dist/core/ResultHandler.js

@@ -0,0 +1,60 @@
+import { logger } from '../utils/logger.js';
+import { looksLikeSensitive, hashValue } from '../telemetry/sanitization.js';
+export class ResultHandler {
+    handleCompleted(task, result) {
+        task.status = 'completed';
+        task.endTime = new Date();
+        task.result = result;
+        task.progress = {
+            progress: 1.0,
+            currentStage: 'completed',
+        };
+        logger.info(`BackgroundExecutor: Task ${task.taskId} completed`);
+        this.executeCallback(() => {
+            task.config.callbacks?.onComplete?.(result);
+        }, task.taskId, 'onComplete');
+    }
+    handleFailed(task, error) {
+        task.status = 'failed';
+        task.endTime = new Date();
+        task.error = error;
+        logger.error(`BackgroundExecutor: Task ${task.taskId} failed:`, error);
+        this.executeCallback(() => {
+            task.config.callbacks?.onError?.(error);
+        }, task.taskId, 'onError');
+    }
+    handleCancelled(task) {
+        task.status = 'cancelled';
+        task.endTime = new Date();
+        logger.info(`BackgroundExecutor: Task ${task.taskId} cancelled`);
+    }
+    executeCallback(callback, taskId, callbackName) {
+        try {
+            callback();
+        }
+        catch (callbackError) {
+            const sanitizedError = this.sanitizeCallbackError(callbackError);
+            logger.error(`BackgroundExecutor: Error in ${callbackName} callback for task ${taskId}:`, sanitizedError);
+        }
+    }
+    sanitizeCallbackError(error) {
+        if (error instanceof Error) {
+            const message = error.message || '';
+            const sanitized = message
+                .split('\n')
+                .map(line => (looksLikeSensitive(line) ? `[REDACTED:${hashValue(line)}]` : line))
+                .join('\n');
+            return {
+                name: error.name,
+                message: sanitized,
+                stack: error.stack,
+            };
+        }
+        const errorStr = String(error);
+        if (looksLikeSensitive(errorStr)) {
+            return `[REDACTED:${hashValue(errorStr)}]`;
+        }
+        return error;
+    }
+}
+//# sourceMappingURL=ResultHandler.js.map

package/dist/core/ResultHandler.js.map

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

package/dist/core/ServiceLocator.d.ts

@@ -0,0 +1,10 @@
+export declare class ServiceLocator {
+    private static services;
+    static register<T>(key: string, service: T): void;
+    static get<T>(key: string): T;
+    static has(key: string): boolean;
+    static clear(): void;
+    static keys(): string[];
+    static unregister(key: string): boolean;
+}
+//# sourceMappingURL=ServiceLocator.d.ts.map

package/dist/core/ServiceLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceLocator.d.ts","sourceRoot":"","sources":["../../src/core/ServiceLocator.ts"],"names":[],"mappings":"AAkCA,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IAiBjD,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAsBjD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAqB7B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAehC,MAAM,CAAC,KAAK,IAAI,IAAI;IAUpB,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE;IAUvB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAGxC"}

package/dist/core/ServiceLocator.js

@@ -0,0 +1,29 @@
+export class ServiceLocator {
+    static services = new Map();
+    static register(key, service) {
+        if (this.services.has(key)) {
+            console.warn(`ServiceLocator: Overwriting existing service '${key}'`);
+        }
+        this.services.set(key, service);
+    }
+    static get(key) {
+        const service = this.services.get(key);
+        if (!service) {
+            throw new Error(`Service not found: ${key}`);
+        }
+        return service;
+    }
+    static has(key) {
+        return this.services.has(key);
+    }
+    static clear() {
+        this.services.clear();
+    }
+    static keys() {
+        return Array.from(this.services.keys());
+    }
+    static unregister(key) {
+        return this.services.delete(key);
+    }
+}
+//# sourceMappingURL=ServiceLocator.js.map

package/dist/core/ServiceLocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceLocator.js","sourceRoot":"","sources":["../../src/core/ServiceLocator.ts"],"names":[],"mappings":"AAkCA,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAe,CAAC;IAiBjD,MAAM,CAAC,QAAQ,CAAI,GAAW,EAAE,OAAU;QACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,iDAAiD,GAAG,GAAG,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAiBD,MAAM,CAAC,GAAG,CAAI,GAAW;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,OAAY,CAAC;IACtB,CAAC;IAeD,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAaD,MAAM,CAAC,KAAK;QACV,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAQD,MAAM,CAAC,IAAI;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAQD,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC"}

package/dist/core/SessionContextMonitor.d.ts

@@ -0,0 +1,41 @@
+import type { SessionTokenTracker } from './SessionTokenTracker.js';
+export type SessionHealthStatus = 'healthy' | 'warning' | 'critical';
+export type WarningType = 'token-threshold' | 'quality-degradation' | 'context-staleness' | 'system-error';
+export interface SessionWarning {
+    type: WarningType;
+    level: 'info' | 'warning' | 'critical';
+    message: string;
+    data?: Record<string, unknown>;
+}
+export interface MonitorRecommendation {
+    action: string;
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    description: string;
+    reasoning: string;
+}
+export interface SessionHealth {
+    status: SessionHealthStatus;
+    tokenUsagePercentage: number;
+    warnings: SessionWarning[];
+    recommendations: MonitorRecommendation[];
+    timestamp: Date;
+}
+export declare class SessionContextMonitor {
+    private tokenTracker;
+    private static readonly MAX_QUALITY_HISTORY;
+    private static readonly MIN_SCORES_FOR_TREND;
+    private static readonly DEGRADATION_THRESHOLD;
+    private qualityHistory;
+    private lastHealthCheck;
+    constructor(tokenTracker: SessionTokenTracker);
+    checkSessionHealth(): SessionHealth;
+    recordQualityScore(score: number): void;
+    private checkQualityDegradation;
+    private determineStatus;
+    getStats(): {
+        tokenStats: import("./SessionTokenTracker.js").SessionStats;
+        qualityHistory: number[];
+        lastHealthCheck: Date | null;
+    };
+}
+//# sourceMappingURL=SessionContextMonitor.d.ts.map

package/dist/core/SessionContextMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionContextMonitor.d.ts","sourceRoot":"","sources":["../../src/core/SessionContextMonitor.ts"],"names":[],"mappings":"AA8DA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AA4BpE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AA6BrE,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,cAAc,CAAC;AAmCnB,MAAM,WAAW,cAAc;IAE7B,IAAI,EAAE,WAAW,CAAC;IAElB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAEvC,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAmCD,MAAM,WAAW,qBAAqB;IAEpC,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAEjD,WAAW,EAAE,MAAM,CAAC;IAEpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAqDD,MAAM,WAAW,aAAa;IAE5B,MAAM,EAAE,mBAAmB,CAAC;IAE5B,oBAAoB,EAAE,MAAM,CAAC;IAE7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,eAAe,EAAE,qBAAqB,EAAE,CAAC;IAEzC,SAAS,EAAE,IAAI,CAAC;CACjB;AAwDD,qBAAa,qBAAqB;IA4CpB,OAAO,CAAC,YAAY;IA1ChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAM;IAEjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAEjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAQ;IAGrD,OAAO,CAAC,cAAc,CAAgB;IAEtC,OAAO,CAAC,eAAe,CAAqB;gBAiCxB,YAAY,EAAE,mBAAmB;IAkErD,kBAAkB,IAAI,aAAa;IAiJnC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAoEvC,OAAO,CAAC,uBAAuB;IA8F/B,OAAO,CAAC,eAAe;IAgEvB,QAAQ;;;;;CAOT"}

package/dist/core/SessionContextMonitor.js

@@ -0,0 +1,156 @@
+import { StateError, ValidationError } from '../errors/index.js';
+export class SessionContextMonitor {
+    tokenTracker;
+    static MAX_QUALITY_HISTORY = 10;
+    static MIN_SCORES_FOR_TREND = 3;
+    static DEGRADATION_THRESHOLD = 0.15;
+    qualityHistory = [];
+    lastHealthCheck = null;
+    constructor(tokenTracker) {
+        this.tokenTracker = tokenTracker;
+        if (!tokenTracker) {
+            throw new StateError('SessionTokenTracker is required', {
+                component: 'SessionContextMonitor',
+                requiredDependency: 'SessionTokenTracker',
+            });
+        }
+    }
+    checkSessionHealth() {
+        const warnings = [];
+        const recommendations = [];
+        let thresholdWarnings;
+        let usagePercentage;
+        try {
+            thresholdWarnings = this.tokenTracker.checkThresholds();
+            usagePercentage = this.tokenTracker.getUsagePercentage();
+        }
+        catch (error) {
+            const timestamp = new Date();
+            this.lastHealthCheck = timestamp;
+            const errorMessage = error instanceof Error
+                ? error.message
+                : String(error);
+            return {
+                status: 'critical',
+                tokenUsagePercentage: 0,
+                warnings: [
+                    {
+                        type: 'system-error',
+                        level: 'critical',
+                        message: `Token tracker error: ${errorMessage}`,
+                        data: {},
+                    },
+                ],
+                recommendations: [],
+                timestamp,
+            };
+        }
+        for (const tw of thresholdWarnings) {
+            warnings.push({
+                type: 'token-threshold',
+                level: tw.level,
+                message: tw.message,
+                data: {
+                    threshold: tw.threshold,
+                    tokensUsed: tw.tokensUsed,
+                    tokensRemaining: tw.tokensRemaining,
+                },
+            });
+            if (tw.level === 'critical') {
+                recommendations.push({
+                    action: 'reload-claude-md',
+                    priority: 'critical',
+                    description: 'Reload CLAUDE.md to refresh context',
+                    reasoning: `Session approaching token limit (${tw.threshold}% used)`,
+                });
+            }
+            else if (tw.level === 'warning') {
+                recommendations.push({
+                    action: 'review-context',
+                    priority: 'medium',
+                    description: 'Review and optimize context usage',
+                    reasoning: `Session token usage is high (${tw.threshold}% used)`,
+                });
+            }
+        }
+        const qualityWarning = this.checkQualityDegradation();
+        if (qualityWarning) {
+            warnings.push(qualityWarning);
+            recommendations.push({
+                action: 'context-refresh',
+                priority: 'high',
+                description: 'Refresh context to improve quality',
+                reasoning: 'Quality scores showing degradation trend',
+            });
+        }
+        const status = this.determineStatus(warnings);
+        const timestamp = new Date();
+        this.lastHealthCheck = timestamp;
+        return {
+            status,
+            tokenUsagePercentage: usagePercentage,
+            warnings,
+            recommendations,
+            timestamp,
+        };
+    }
+    recordQualityScore(score) {
+        if (!Number.isFinite(score) || score < 0 || score > 1) {
+            throw new ValidationError('Quality score must be a finite number between 0 and 1', {
+                providedScore: score,
+                validRange: { min: 0, max: 1 },
+                mustBeFinite: true,
+            });
+        }
+        this.qualityHistory.push(score);
+        while (this.qualityHistory.length > SessionContextMonitor.MAX_QUALITY_HISTORY) {
+            this.qualityHistory.shift();
+        }
+    }
+    checkQualityDegradation() {
+        if (this.qualityHistory.length < SessionContextMonitor.MIN_SCORES_FOR_TREND) {
+            return null;
+        }
+        const recent = this.qualityHistory.slice(-3);
+        const previous = this.qualityHistory.slice(-6, -3);
+        if (previous.length === 0) {
+            return null;
+        }
+        const recentAvg = recent.reduce((a, b) => a + b, 0) / recent.length;
+        const previousAvg = previous.reduce((a, b) => a + b, 0) / previous.length;
+        if (previousAvg === 0) {
+            return null;
+        }
+        if (recentAvg <
+            previousAvg * (1 - SessionContextMonitor.DEGRADATION_THRESHOLD)) {
+            return {
+                type: 'quality-degradation',
+                level: 'warning',
+                message: `Quality scores declining (${previousAvg.toFixed(2)} → ${recentAvg.toFixed(2)})`,
+                data: {
+                    recentAvg,
+                    previousAvg,
+                    dropPercentage: ((previousAvg - recentAvg) / previousAvg) * 100,
+                },
+            };
+        }
+        return null;
+    }
+    determineStatus(warnings) {
+        const hasCritical = warnings.some((w) => w.level === 'critical');
+        const hasWarning = warnings.some((w) => w.level === 'warning');
+        if (hasCritical)
+            return 'critical';
+        if (hasWarning)
+            return 'warning';
+        return 'healthy';
+    }
+    getStats() {
+        return {
+            tokenStats: this.tokenTracker.getStats(),
+            qualityHistory: [...this.qualityHistory],
+            lastHealthCheck: this.lastHealthCheck,
+        };
+    }
+}
+//# sourceMappingURL=SessionContextMonitor.js.map

package/dist/core/SessionContextMonitor.js.map

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

package/dist/core/SessionTokenTracker.d.ts

@@ -0,0 +1,43 @@
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    timestamp?: Date;
+}
+export interface ThresholdConfig {
+    percentage: number;
+    level: 'info' | 'warning' | 'critical';
+}
+export interface ThresholdWarning {
+    threshold: number;
+    level: 'info' | 'warning' | 'critical';
+    tokensUsed: number;
+    tokensRemaining: number;
+    message: string;
+}
+export interface SessionStats {
+    totalTokens: number;
+    tokenLimit: number;
+    usagePercentage: number;
+    tokensRemaining: number;
+    interactionCount: number;
+    triggeredThresholds: number[];
+}
+export interface SessionTokenTrackerConfig {
+    tokenLimit: number;
+    thresholds?: ThresholdConfig[];
+}
+export declare class SessionTokenTracker {
+    private totalTokens;
+    private tokenLimit;
+    private thresholds;
+    private usageHistory;
+    private triggeredThresholds;
+    constructor(config: SessionTokenTrackerConfig);
+    recordUsage(usage: TokenUsage): void;
+    getTotalTokens(): number;
+    getUsagePercentage(): number;
+    checkThresholds(): ThresholdWarning[];
+    getStats(): SessionStats;
+    reset(): void;
+}
+//# sourceMappingURL=SessionTokenTracker.d.ts.map

package/dist/core/SessionTokenTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTokenTracker.d.ts","sourceRoot":"","sources":["../../src/core/SessionTokenTracker.ts"],"names":[],"mappings":"AA+DA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAKD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;CACxC;AAKD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAKD,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAwCD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,mBAAmB,CAA0B;gBAEzC,MAAM,EAAE,yBAAyB;IA6C7C,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAkCpC,cAAc,IAAI,MAAM;IAuBxB,kBAAkB,IAAI,MAAM;IAQ5B,eAAe,IAAI,gBAAgB,EAAE;IA0BrC,QAAQ,IAAI,YAAY;IAcxB,KAAK,IAAI,IAAI;CAKd"}

package/dist/core/SessionTokenTracker.js

@@ -0,0 +1,76 @@
+import { ValidationError } from '../errors/index.js';
+export class SessionTokenTracker {
+    totalTokens = 0;
+    tokenLimit;
+    thresholds;
+    usageHistory = [];
+    triggeredThresholds = new Set();
+    constructor(config) {
+        if (config.tokenLimit <= 0) {
+            throw new ValidationError('Token limit must be positive', {
+                providedValue: config.tokenLimit,
+                expectedCondition: 'positive number (> 0)',
+            });
+        }
+        this.tokenLimit = config.tokenLimit;
+        this.thresholds = config.thresholds || [
+            { percentage: 80, level: 'warning' },
+            { percentage: 90, level: 'critical' },
+        ];
+    }
+    recordUsage(usage) {
+        if (usage.inputTokens < 0 || usage.outputTokens < 0) {
+            throw new ValidationError('Token counts must be non-negative', {
+                inputTokens: usage.inputTokens,
+                outputTokens: usage.outputTokens,
+                expectedCondition: 'non-negative numbers (>= 0)',
+            });
+        }
+        const total = usage.inputTokens + usage.outputTokens;
+        this.totalTokens += total;
+        this.usageHistory.push({
+            ...usage,
+            timestamp: usage.timestamp || new Date(),
+        });
+    }
+    getTotalTokens() {
+        return this.totalTokens;
+    }
+    getUsagePercentage() {
+        return (this.totalTokens / this.tokenLimit) * 100;
+    }
+    checkThresholds() {
+        const percentage = this.getUsagePercentage();
+        const warnings = [];
+        for (const threshold of this.thresholds) {
+            if (percentage >= threshold.percentage &&
+                !this.triggeredThresholds.has(threshold.percentage)) {
+                this.triggeredThresholds.add(threshold.percentage);
+                warnings.push({
+                    threshold: threshold.percentage,
+                    level: threshold.level,
+                    tokensUsed: this.totalTokens,
+                    tokensRemaining: this.tokenLimit - this.totalTokens,
+                    message: `Session token usage at ${threshold.percentage}% (${this.totalTokens}/${this.tokenLimit} tokens)`,
+                });
+            }
+        }
+        return warnings;
+    }
+    getStats() {
+        return {
+            totalTokens: this.totalTokens,
+            tokenLimit: this.tokenLimit,
+            usagePercentage: this.getUsagePercentage(),
+            tokensRemaining: this.tokenLimit - this.totalTokens,
+            interactionCount: this.usageHistory.length,
+            triggeredThresholds: Array.from(this.triggeredThresholds),
+        };
+    }
+    reset() {
+        this.totalTokens = 0;
+        this.usageHistory = [];
+        this.triggeredThresholds.clear();
+    }
+}
+//# sourceMappingURL=SessionTokenTracker.js.map