@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/metrics/collaboration-profile.js.map

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

package/dist/metrics/context-composition-tracker.d.ts

@@ -0,0 +1,74 @@
+import type { MetricAggregator } from '../shared/index.js';
+import type { TokenEvent } from '../storage/types.js';
+export type ContextCategory = 'system_prompt' | 'conversation_history' | 'tool_results' | 'injected_file_content' | 'other';
+export interface TurnComposition {
+    readonly turnNumber: number;
+    readonly timestamp: number;
+    readonly totalTokens: number;
+    readonly breakdown: Readonly<Record<ContextCategory, number>>;
+    readonly fillPercent: number;
+    readonly dominantCategory: ContextCategory | null;
+}
+export interface ContextThresholdAlert {
+    readonly threshold: number;
+    readonly fillPercent: number;
+    readonly timestamp: number;
+    readonly turnNumber: number;
+    readonly dominantCategory: ContextCategory;
+    readonly dominantPercent: number;
+}
+export interface CategoryDominanceAlert {
+    readonly category: ContextCategory;
+    readonly percent: number;
+    readonly timestamp: number;
+    readonly turnNumber: number;
+}
+export interface ContextCompositionMetrics {
+    readonly currentFillPercent: number;
+    readonly currentBreakdown: Readonly<Record<ContextCategory, number>>;
+    readonly turnCount: number;
+    readonly thresholdAlerts: readonly ContextThresholdAlert[];
+    readonly dominanceAlerts: readonly CategoryDominanceAlert[];
+    readonly history: readonly TurnComposition[];
+}
+export interface ContextCompositionOptions {
+    readonly modelContextWindow?: number;
+    readonly fillThresholds?: readonly number[];
+    readonly dominanceThreshold?: number;
+    readonly maxHistorySize?: number;
+    readonly onThresholdAlert?: (alert: ContextThresholdAlert) => void;
+    readonly onDominanceAlert?: (alert: CategoryDominanceAlert) => void;
+}
+export interface TurnTokenReport {
+    readonly systemPromptTokens: number;
+    readonly conversationHistoryTokens: number;
+    readonly toolResultTokens: number;
+    readonly injectedFileContentTokens: number;
+    readonly otherTokens: number;
+    readonly totalTokens: number;
+}
+export declare class ContextCompositionTracker {
+    private readonly modelContextWindow;
+    private readonly fillThresholds;
+    private readonly dominanceThreshold;
+    private readonly maxHistorySize;
+    private readonly onThresholdAlert;
+    private readonly onDominanceAlert;
+    private turnCount;
+    private currentBreakdown;
+    private currentTotalTokens;
+    private readonly history;
+    private readonly thresholdAlerts;
+    private readonly dominanceAlerts;
+    private readonly firedThresholds;
+    constructor(options?: ContextCompositionOptions);
+    recordTurn(report: TurnTokenReport): TurnComposition;
+    recordTokenEvent(event: TokenEvent): void;
+    getMetrics(): ContextCompositionMetrics;
+    emitMetrics(aggregator: MetricAggregator): void;
+    reset(_sessionId: string): void;
+    private findDominantCategory;
+    private checkFillThresholds;
+    private checkDominance;
+}
+//# sourceMappingURL=context-composition-tracker.d.ts.map

package/dist/metrics/context-composition-tracker.d.ts.map

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

package/dist/metrics/context-composition-tracker.js

@@ -0,0 +1,202 @@
+import { createLogger } from '../shared/index.js';
+const logger = createLogger('context-composition');
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CONTEXT_WINDOW = 200_000;
+const DEFAULT_FILL_THRESHOLDS = [50, 75, 90];
+const DEFAULT_DOMINANCE_THRESHOLD = 60;
+const DEFAULT_MAX_HISTORY = 500;
+// ---------------------------------------------------------------------------
+// ContextCompositionTracker
+// ---------------------------------------------------------------------------
+export class ContextCompositionTracker {
+    modelContextWindow;
+    fillThresholds;
+    dominanceThreshold;
+    maxHistorySize;
+    onThresholdAlert;
+    onDominanceAlert;
+    turnCount = 0;
+    currentBreakdown = {
+        system_prompt: 0,
+        conversation_history: 0,
+        tool_results: 0,
+        injected_file_content: 0,
+        other: 0,
+    };
+    currentTotalTokens = 0;
+    history = [];
+    thresholdAlerts = [];
+    dominanceAlerts = [];
+    firedThresholds = new Set();
+    constructor(options) {
+        this.modelContextWindow = options?.modelContextWindow ?? DEFAULT_CONTEXT_WINDOW;
+        this.fillThresholds = options?.fillThresholds ?? DEFAULT_FILL_THRESHOLDS;
+        this.dominanceThreshold = options?.dominanceThreshold ?? DEFAULT_DOMINANCE_THRESHOLD;
+        this.maxHistorySize = options?.maxHistorySize ?? DEFAULT_MAX_HISTORY;
+        this.onThresholdAlert = options?.onThresholdAlert ?? null;
+        this.onDominanceAlert = options?.onDominanceAlert ?? null;
+    }
+    recordTurn(report) {
+        this.turnCount++;
+        const now = Date.now();
+        this.currentBreakdown = {
+            system_prompt: report.systemPromptTokens,
+            conversation_history: report.conversationHistoryTokens,
+            tool_results: report.toolResultTokens,
+            injected_file_content: report.injectedFileContentTokens,
+            other: report.otherTokens,
+        };
+        this.currentTotalTokens = report.totalTokens;
+        const fillPercent = this.modelContextWindow > 0 ? (report.totalTokens / this.modelContextWindow) * 100 : 0;
+        const dominantCategory = this.findDominantCategory();
+        const composition = {
+            turnNumber: this.turnCount,
+            timestamp: now,
+            totalTokens: report.totalTokens,
+            breakdown: { ...this.currentBreakdown },
+            fillPercent,
+            dominantCategory,
+        };
+        this.history.push(composition);
+        if (this.history.length > this.maxHistorySize) {
+            this.history.shift();
+        }
+        this.checkFillThresholds(fillPercent, now);
+        this.checkDominance(now);
+        return composition;
+    }
+    recordTokenEvent(event) {
+        // Approximate composition from token counts:
+        // - cacheReadTokens = previously cached context (system prompt + conversation history)
+        // - cacheCreationTokens = first-time context being cached this turn
+        // - remainder of inputTokens = new content (tool results + user input)
+        const cachedContext = event.cacheReadTokens;
+        const cacheCreation = event.cacheCreationTokens;
+        const newContent = Math.max(0, event.inputTokens - cachedContext - cacheCreation);
+        const totalInput = event.inputTokens;
+        if (totalInput === 0)
+            return;
+        // cacheCreationTokens are newly-cached conversation context (not just the system prompt),
+        // so bucket them under conversation_history for a less misleading breakdown.
+        this.recordTurn({
+            systemPromptTokens: 0,
+            conversationHistoryTokens: cachedContext + cacheCreation,
+            toolResultTokens: newContent,
+            injectedFileContentTokens: 0,
+            otherTokens: 0,
+            totalTokens: totalInput,
+        });
+    }
+    getMetrics() {
+        const fillPercent = this.modelContextWindow > 0 ? (this.currentTotalTokens / this.modelContextWindow) * 100 : 0;
+        return {
+            currentFillPercent: Math.round(fillPercent * 100) / 100,
+            currentBreakdown: { ...this.currentBreakdown },
+            turnCount: this.turnCount,
+            thresholdAlerts: this.thresholdAlerts,
+            dominanceAlerts: this.dominanceAlerts,
+            history: this.history,
+        };
+    }
+    emitMetrics(aggregator) {
+        const fillPercent = this.modelContextWindow > 0 ? (this.currentTotalTokens / this.modelContextWindow) * 100 : 0;
+        aggregator.record('ai.context.fill_percent', fillPercent);
+        aggregator.record('ai.context.total_tokens', this.currentTotalTokens);
+        for (const [category, tokens] of Object.entries(this.currentBreakdown)) {
+            aggregator.record('ai.context.category_tokens', tokens, { category });
+        }
+    }
+    reset(_sessionId) {
+        this.turnCount = 0;
+        this.currentBreakdown = {
+            system_prompt: 0,
+            conversation_history: 0,
+            tool_results: 0,
+            injected_file_content: 0,
+            other: 0,
+        };
+        this.currentTotalTokens = 0;
+        this.history.length = 0;
+        this.thresholdAlerts.length = 0;
+        this.dominanceAlerts.length = 0;
+        this.firedThresholds.clear();
+    }
+    findDominantCategory() {
+        if (this.currentTotalTokens === 0)
+            return null;
+        let maxCategory = null;
+        let maxPercent = 0;
+        for (const [category, tokens] of Object.entries(this.currentBreakdown)) {
+            const percent = (tokens / this.currentTotalTokens) * 100;
+            if (percent > maxPercent) {
+                maxPercent = percent;
+                maxCategory = category;
+            }
+        }
+        return maxPercent >= this.dominanceThreshold ? maxCategory : null;
+    }
+    checkFillThresholds(fillPercent, now) {
+        for (const threshold of this.fillThresholds) {
+            // Re-arm when fill drops below threshold (e.g. after a compaction) so
+            // the alert can fire again if context rises back to that level.
+            if (fillPercent < threshold) {
+                this.firedThresholds.delete(threshold);
+                continue;
+            }
+            if (fillPercent >= threshold && !this.firedThresholds.has(threshold)) {
+                this.firedThresholds.add(threshold);
+                const dominant = this.findDominantCategory() ?? 'other';
+                const dominantPercent = this.currentTotalTokens > 0
+                    ? (this.currentBreakdown[dominant] / this.currentTotalTokens) * 100
+                    : 0;
+                const alert = {
+                    threshold,
+                    fillPercent: Math.round(fillPercent * 100) / 100,
+                    timestamp: now,
+                    turnNumber: this.turnCount,
+                    dominantCategory: dominant,
+                    dominantPercent: Math.round(dominantPercent * 100) / 100,
+                };
+                this.thresholdAlerts.push(alert);
+                logger.warn(`Context window ${threshold}% full`, {
+                    fillPercent: alert.fillPercent,
+                    dominant,
+                    dominantPercent: alert.dominantPercent,
+                    turn: this.turnCount,
+                });
+                if (this.onThresholdAlert) {
+                    this.onThresholdAlert(alert);
+                }
+            }
+        }
+    }
+    checkDominance(now) {
+        if (this.currentTotalTokens === 0)
+            return;
+        for (const [category, tokens] of Object.entries(this.currentBreakdown)) {
+            const percent = (tokens / this.currentTotalTokens) * 100;
+            if (percent > this.dominanceThreshold) {
+                const alert = {
+                    category: category,
+                    percent: Math.round(percent * 100) / 100,
+                    timestamp: now,
+                    turnNumber: this.turnCount,
+                };
+                if (this.dominanceAlerts.length < this.maxHistorySize) {
+                    this.dominanceAlerts.push(alert);
+                }
+                logger.warn(`Context dominated by ${category}`, {
+                    percent: alert.percent,
+                    turn: this.turnCount,
+                });
+                if (this.onDominanceAlert) {
+                    this.onDominanceAlert(alert);
+                }
+                break; // only one dominant category per turn
+            }
+        }
+    }
+}
+//# sourceMappingURL=context-composition-tracker.js.map

package/dist/metrics/context-composition-tracker.js.map

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

package/dist/metrics/context-tracker.d.ts

@@ -0,0 +1,78 @@
+import type { TokenEvent, ToolCallRecord } from '../storage/types.js';
+export interface ContextBreakdown {
+    readonly system: number;
+    readonly tools: number;
+    readonly user: number;
+    readonly assistant: number;
+}
+export interface ContextTurnSnapshot {
+    readonly turnNumber: number;
+    readonly timestamp: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheCreationTokens: number;
+    readonly fillPercent: number;
+    readonly breakdown: ContextBreakdown;
+}
+export interface ContextGrowthSummary {
+    readonly startTokens: number;
+    readonly currentTokens: number;
+    readonly deltaTokens: number;
+}
+export interface ToolContextContribution {
+    readonly tool: string;
+    readonly totalBytes: number;
+    readonly estimatedTokens: number;
+    readonly percentOfToolOutput: number;
+}
+export interface ContextTrackerMetrics {
+    readonly turnCount: number;
+    readonly growth: ContextGrowthSummary;
+    readonly currentBreakdown: ContextBreakdown;
+    readonly fillPercent: number;
+    readonly contextWindow: number;
+    readonly toolContributions: readonly ToolContextContribution[];
+    readonly history: readonly ContextTurnSnapshot[];
+}
+export interface ContextTrackerOptions {
+    readonly modelContextWindow?: number;
+    readonly maxHistorySize?: number;
+    readonly bytesPerToken?: number;
+}
+export declare class ContextTracker {
+    private modelContextWindow;
+    private readonly maxHistorySize;
+    private readonly bytesPerToken;
+    private turnCount;
+    private firstTurnInputTokens;
+    private currentInputTokens;
+    private systemBaseline;
+    private cumulativeAssistantTokens;
+    private readonly toolOutputBytes;
+    private readonly history;
+    constructor(options?: ContextTrackerOptions);
+    recordToolCall(record: ToolCallRecord): void;
+    recordTurn(event: TokenEvent): ContextTurnSnapshot;
+    getGrowth(): ContextGrowthSummary;
+    getToolContributions(): ToolContextContribution[];
+    getMetrics(): ContextTrackerMetrics;
+    reset(_sessionId: string): void;
+    private getCurrentBreakdown;
+    private estimateBreakdown;
+}
+export declare class ContextTrackerRegistry {
+    private readonly trackers;
+    private readonly options;
+    private readonly maxSessions;
+    constructor(options?: ContextTrackerOptions & {
+        maxSessions?: number;
+    });
+    private getOrCreate;
+    recordToolCall(record: ToolCallRecord): void;
+    recordTurn(event: TokenEvent): ContextTurnSnapshot | null;
+    getMetrics(sessionId?: string): ContextTrackerMetrics;
+    getTracker(sessionId: string): ContextTracker | undefined;
+    getSessionIds(): string[];
+}
+//# sourceMappingURL=context-tracker.d.ts.map

package/dist/metrics/context-tracker.d.ts.map

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

package/dist/metrics/context-tracker.js

@@ -0,0 +1,222 @@
+import { resolveModelPricing } from '../shared/index.js';
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CONTEXT_WINDOW = 200_000;
+const DEFAULT_MAX_HISTORY = 500;
+const DEFAULT_BYTES_PER_TOKEN = 4;
+// ---------------------------------------------------------------------------
+// ContextTracker
+// ---------------------------------------------------------------------------
+export class ContextTracker {
+    // Initial cap from the constructor option (or default). Each recorded turn
+    // can refine this via the model name in the TokenEvent — e.g. claude-opus-4-7
+    // is a 1M-token window; without the lookup the bar would read 100% at 200K.
+    // Invariant: this value is monotonically non-decreasing within a session
+    // (max-only update, never shrink). A mid-session sub-agent dispatch to a
+    // smaller model must not collapse the cap, because cached history is still
+    // indexed against the larger context window.
+    modelContextWindow;
+    maxHistorySize;
+    bytesPerToken;
+    turnCount = 0;
+    firstTurnInputTokens = 0;
+    currentInputTokens = 0;
+    systemBaseline = 0;
+    cumulativeAssistantTokens = 0;
+    toolOutputBytes = new Map();
+    history = [];
+    constructor(options) {
+        this.modelContextWindow = options?.modelContextWindow ?? DEFAULT_CONTEXT_WINDOW;
+        this.maxHistorySize = options?.maxHistorySize ?? DEFAULT_MAX_HISTORY;
+        this.bytesPerToken = options?.bytesPerToken ?? DEFAULT_BYTES_PER_TOKEN;
+    }
+    recordToolCall(record) {
+        const bytes = record.outputSizeBytes;
+        if (bytes == null || bytes <= 0)
+            return;
+        const current = this.toolOutputBytes.get(record.toolName) ?? 0;
+        this.toolOutputBytes.set(record.toolName, current + bytes);
+    }
+    recordTurn(event) {
+        this.turnCount++;
+        const now = event.timestamp;
+        // Refine the context window from the model on this event. Anthropic
+        // returns the model in usage metadata (e.g. claude-opus-4-7 → 1M window).
+        // Without this lookup, a 250K-token Opus 4.7 conversation would render
+        // as 125% fill against the 200K default.
+        //
+        // Take the max — never shrink. The cap can grow during a session
+        // (default 200K → resolved 1M on first Opus turn) but must not shrink
+        // when a smaller-window model (e.g. Haiku sub-agent at 200K) follows
+        // a larger one (Opus at 1M). Cached history is still indexed against
+        // the larger context, so a 605K-token snapshot would otherwise read as
+        // 302% fillPercent against a shrunken 200K cap.
+        if (event.model) {
+            const pricing = resolveModelPricing(event.model);
+            if (pricing && pricing.contextWindow > this.modelContextWindow) {
+                this.modelContextWindow = pricing.contextWindow;
+            }
+        }
+        // Total context = new tokens + cached tokens (Anthropic reports input_tokens
+        // as only the uncached portion; cache_read + cache_creation are the rest)
+        const totalContext = event.inputTokens + event.cacheReadTokens + event.cacheCreationTokens;
+        if (this.turnCount === 1) {
+            this.firstTurnInputTokens = totalContext;
+            // Heuristic: on a cold session cacheCreationTokens holds the newly-cached
+            // system prompt and is a reasonable system baseline. On warm-cache sessions
+            // (resumed conversation) cacheCreationTokens is 0 because the prompt is
+            // already cached, so the system baseline is unknown and we leave it at 0.
+            // Using cacheReadTokens as a fallback would overshoot: it contains the
+            // full prior context (system + all history), not just the system prompt.
+            this.systemBaseline = event.cacheCreationTokens;
+        }
+        this.currentInputTokens = totalContext;
+        const fillPercent = this.modelContextWindow > 0 ? (totalContext / this.modelContextWindow) * 100 : 0;
+        const breakdown = this.estimateBreakdown(totalContext);
+        const snapshot = {
+            turnNumber: this.turnCount,
+            timestamp: now,
+            inputTokens: totalContext,
+            outputTokens: event.outputTokens,
+            cacheReadTokens: event.cacheReadTokens,
+            cacheCreationTokens: event.cacheCreationTokens,
+            fillPercent: Math.round(fillPercent * 100) / 100,
+            breakdown,
+        };
+        this.history.push(snapshot);
+        if (this.history.length > this.maxHistorySize) {
+            this.history.shift();
+        }
+        // Output tokens from this turn become part of next turn's context
+        this.cumulativeAssistantTokens += event.outputTokens;
+        return snapshot;
+    }
+    getGrowth() {
+        return {
+            startTokens: this.firstTurnInputTokens,
+            currentTokens: this.currentInputTokens,
+            deltaTokens: this.currentInputTokens - this.firstTurnInputTokens,
+        };
+    }
+    getToolContributions() {
+        const totalBytes = [...this.toolOutputBytes.values()].reduce((sum, b) => sum + b, 0);
+        if (totalBytes === 0)
+            return [];
+        return [...this.toolOutputBytes.entries()]
+            .map(([tool, bytes]) => ({
+            tool,
+            totalBytes: bytes,
+            estimatedTokens: Math.round(bytes / this.bytesPerToken),
+            percentOfToolOutput: Math.round((bytes / totalBytes) * 10000) / 100,
+        }))
+            .sort((a, b) => b.totalBytes - a.totalBytes);
+    }
+    getMetrics() {
+        const fillPercent = this.modelContextWindow > 0 ? (this.currentInputTokens / this.modelContextWindow) * 100 : 0;
+        return {
+            turnCount: this.turnCount,
+            growth: this.getGrowth(),
+            currentBreakdown: this.getCurrentBreakdown(),
+            fillPercent: Math.round(fillPercent * 100) / 100,
+            contextWindow: this.modelContextWindow,
+            toolContributions: this.getToolContributions(),
+            history: this.history,
+        };
+    }
+    reset(_sessionId) {
+        this.turnCount = 0;
+        this.firstTurnInputTokens = 0;
+        this.currentInputTokens = 0;
+        this.systemBaseline = 0;
+        this.cumulativeAssistantTokens = 0;
+        this.toolOutputBytes.clear();
+        this.history.length = 0;
+    }
+    getCurrentBreakdown() {
+        if (this.turnCount === 0) {
+            return { system: 0, tools: 0, user: 0, assistant: 0 };
+        }
+        return this.history[this.history.length - 1].breakdown;
+    }
+    estimateBreakdown(totalContext) {
+        const total = totalContext;
+        if (total === 0)
+            return { system: 0, tools: 0, user: 0, assistant: 0 };
+        const system = Math.min(this.systemBaseline, total);
+        const totalToolBytes = [...this.toolOutputBytes.values()].reduce((sum, b) => sum + b, 0);
+        const toolEstimate = Math.round(totalToolBytes / this.bytesPerToken);
+        const tools = Math.min(toolEstimate, total - system);
+        const assistant = Math.min(this.cumulativeAssistantTokens, total - system - tools);
+        const user = Math.max(0, total - system - tools - assistant);
+        return { system, tools, user, assistant };
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-session registry
+// ---------------------------------------------------------------------------
+export class ContextTrackerRegistry {
+    trackers = new Map();
+    options;
+    maxSessions;
+    constructor(options) {
+        this.options = options;
+        this.maxSessions = options?.maxSessions ?? 50;
+    }
+    getOrCreate(sessionId) {
+        let tracker = this.trackers.get(sessionId);
+        if (tracker) {
+            // Move to end for LRU ordering
+            this.trackers.delete(sessionId);
+            this.trackers.set(sessionId, tracker);
+            return tracker;
+        }
+        if (this.trackers.size >= this.maxSessions) {
+            const oldest = this.trackers.keys().next().value;
+            if (oldest !== undefined)
+                this.trackers.delete(oldest);
+        }
+        tracker = new ContextTracker(this.options);
+        this.trackers.set(sessionId, tracker);
+        return tracker;
+    }
+    recordToolCall(record) {
+        const sessionId = record.sessionId;
+        if (!sessionId)
+            return;
+        this.getOrCreate(sessionId).recordToolCall(record);
+    }
+    recordTurn(event) {
+        const sessionId = event.sessionId;
+        if (!sessionId)
+            return null;
+        return this.getOrCreate(sessionId).recordTurn(event);
+    }
+    getMetrics(sessionId) {
+        const empty = {
+            turnCount: 0,
+            growth: { startTokens: 0, currentTokens: 0, deltaTokens: 0 },
+            currentBreakdown: { system: 0, tools: 0, user: 0, assistant: 0 },
+            fillPercent: 0,
+            contextWindow: this.options?.modelContextWindow ?? DEFAULT_CONTEXT_WINDOW,
+            toolContributions: [],
+            history: [],
+        };
+        if (sessionId) {
+            const tracker = this.trackers.get(sessionId);
+            return tracker ? tracker.getMetrics() : empty;
+        }
+        // No sessionId specified — return most recently active tracker
+        const entries = [...this.trackers.entries()];
+        if (entries.length === 0)
+            return empty;
+        return entries[entries.length - 1][1].getMetrics();
+    }
+    getTracker(sessionId) {
+        return this.trackers.get(sessionId);
+    }
+    getSessionIds() {
+        return [...this.trackers.keys()];
+    }
+}
+//# sourceMappingURL=context-tracker.js.map

package/dist/metrics/context-tracker.js.map

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

package/dist/metrics/context-window-tracker.d.ts

@@ -0,0 +1,18 @@
+import type { ToolCallRecord } from '../storage/types.js';
+export interface ContextWindowMetrics {
+    readonly uniqueFilesRead: number;
+    readonly totalReadOperations: number;
+    readonly repeatedReadCount: number;
+    readonly repeatedReadRatio: number | null;
+    readonly topRepeatedFiles: ReadonlyArray<{
+        file: string;
+        readCount: number;
+    }>;
+}
+export declare class ContextWindowTracker {
+    private fileReadCounts;
+    recordToolCall(record: ToolCallRecord): void;
+    getMetrics(): ContextWindowMetrics;
+    reset(_sessionId: string): void;
+}
+//# sourceMappingURL=context-window-tracker.d.ts.map