@newrelic/preflight 0.0.1-pre.1 → 1.0.1

package/dist/metrics/trend-analyzer.js

@@ -0,0 +1,293 @@
+/**
+ * Cross-Session Trend Analysis — computes longitudinal metrics from stored
+ * session data for weekly trends, comparisons, and text summaries.
+ *
+ * Operates on `FullSessionSummary[]` loaded from `SessionStore`, grouping
+ * by ISO week to compute efficiency, cost, task success, tool call, and
+ * anti-pattern trends over time.
+ */
+import { createLogger } from '../shared/index.js';
+import { getIsoWeekId, getWeekDateRange } from '../storage/weekly-summary.js';
+const logger = createLogger('trend-analyzer');
+// ---------------------------------------------------------------------------
+// Statistical helpers
+// ---------------------------------------------------------------------------
+/**
+ * Simple moving average over a series of values.
+ * For indices where the full window is not available, uses whatever
+ * values are available (partial window at the start).
+ */
+export function movingAverage(values, windowSize) {
+    if (values.length === 0 || windowSize <= 0)
+        return [];
+    const result = [];
+    for (let i = 0; i < values.length; i++) {
+        const start = Math.max(0, i - windowSize + 1);
+        let sum = 0;
+        for (let j = start; j <= i; j++) {
+            sum += values[j];
+        }
+        result.push(round(sum / (i - start + 1), 4));
+    }
+    return result;
+}
+/**
+ * Percentage change from old to new value.
+ * Returns null when oldValue is 0 and newValue is non-zero (undefined growth from zero baseline).
+ * Returns 0 when both are 0.
+ */
+export function percentChange(oldValue, newValue) {
+    if (oldValue === 0)
+        return newValue === 0 ? 0 : null;
+    return round(((newValue - oldValue) / Math.abs(oldValue)) * 100, 1);
+}
+/**
+ * Detects whether the last value in the array is a significant outlier.
+ * Uses z-score: computes mean and std of all values except the last,
+ * then checks if the last value is beyond `threshold` standard deviations.
+ */
+export function significantChange(values, threshold = 2.0) {
+    if (values.length < 3)
+        return false;
+    const previous = values.slice(0, -1);
+    const last = values[values.length - 1];
+    let sum = 0;
+    for (const v of previous)
+        sum += v;
+    const mean = sum / previous.length;
+    let sqDiffSum = 0;
+    for (const v of previous)
+        sqDiffSum += (v - mean) ** 2;
+    const stdDev = Math.sqrt(sqDiffSum / previous.length);
+    if (stdDev === 0)
+        return last !== mean;
+    const zScore = Math.abs(last - mean) / stdDev;
+    return zScore >= threshold;
+}
+function aggregateWeek(sessions) {
+    let totalCost = 0;
+    let totalTestsRun = 0;
+    let totalTestsPassed = 0;
+    let totalToolCalls = 0;
+    let totalTasks = 0;
+    let efficiencySum = 0;
+    let efficiencyCount = 0;
+    const antiPatterns = {};
+    for (const s of sessions) {
+        totalCost += s.estimatedCostUsd ?? 0;
+        totalTestsRun += s.testRunCount;
+        totalTestsPassed += s.testPassCount;
+        totalToolCalls += s.toolCallCount;
+        totalTasks += s.taskCount;
+        if (s.efficiencyScore !== null) {
+            efficiencySum += s.efficiencyScore;
+            efficiencyCount++;
+        }
+        for (const ap of s.antiPatterns) {
+            antiPatterns[ap.type] = (antiPatterns[ap.type] ?? 0) + ap.count;
+        }
+    }
+    return {
+        efficiency: efficiencyCount > 0 ? round(efficiencySum / efficiencyCount, 3) : null,
+        cost: round(totalCost, 4),
+        taskSuccess: totalTestsRun > 0 ? round(totalTestsPassed / totalTestsRun, 3) : 0,
+        toolCallsPerTask: totalTasks > 0 ? round(totalToolCalls / totalTasks, 1) : 0,
+        antiPatterns,
+    };
+}
+function groupByWeek(sessions) {
+    const groups = new Map();
+    for (const s of sessions) {
+        const week = getIsoWeekId(new Date(s.startTime));
+        const list = groups.get(week) ?? [];
+        list.push(s);
+        groups.set(week, list);
+    }
+    return groups;
+}
+// ---------------------------------------------------------------------------
+// TrendAnalyzer
+// ---------------------------------------------------------------------------
+export class TrendAnalyzer {
+    sessionStore;
+    constructor(options) {
+        this.sessionStore = options.sessionStore;
+    }
+    computeTrends(options) {
+        const sessions = this.sessionStore.loadAllSessions({
+            since: options?.since,
+            developer: options?.developer,
+        });
+        const weekGroups = groupByWeek(sessions);
+        const sortedWeeks = [...weekGroups.keys()].sort();
+        const weeklyEfficiencyTrend = [];
+        const weeklyCostTrend = [];
+        const weeklyTaskSuccessTrend = [];
+        const weeklyToolCallTrend = [];
+        const weeklyAntiPatternTrend = [];
+        for (const week of sortedWeeks) {
+            const agg = aggregateWeek(weekGroups.get(week));
+            if (agg.efficiency !== null) {
+                weeklyEfficiencyTrend.push({ week, value: agg.efficiency });
+            }
+            weeklyCostTrend.push({ week, value: agg.cost });
+            weeklyTaskSuccessTrend.push({ week, value: agg.taskSuccess });
+            weeklyToolCallTrend.push({ week, value: agg.toolCallsPerTask });
+            weeklyAntiPatternTrend.push({ week, counts: agg.antiPatterns });
+        }
+        return {
+            weeklyEfficiencyTrend,
+            weeklyCostTrend,
+            weeklyTaskSuccessTrend,
+            weeklyToolCallTrend,
+            weeklyAntiPatternTrend,
+        };
+    }
+    compareWeeks(weekA, weekB) {
+        const aggA = this.loadWeekAggregate(weekA);
+        const aggB = this.loadWeekAggregate(weekB);
+        const effA = aggA.efficiency;
+        const effB = aggB.efficiency;
+        return {
+            weekA,
+            weekB,
+            efficiencyDelta: effA !== null && effB !== null ? round(effB - effA, 3) : null,
+            efficiencyPctChange: effA !== null && effB !== null ? percentChange(effA, effB) : null,
+            costDelta: round(aggB.cost - aggA.cost, 4),
+            costPctChange: percentChange(aggA.cost, aggB.cost),
+            taskSuccessDelta: round(aggB.taskSuccess - aggA.taskSuccess, 3),
+            taskSuccessPctChange: percentChange(aggA.taskSuccess, aggB.taskSuccess),
+            toolCallDelta: round(aggB.toolCallsPerTask - aggA.toolCallsPerTask, 1),
+            toolCallPctChange: percentChange(aggA.toolCallsPerTask, aggB.toolCallsPerTask),
+        };
+    }
+    compareDeveloperToTeam(developer, weekId) {
+        const { start, end } = getWeekDateRange(weekId);
+        const allSessions = this.sessionStore.loadAllSessions({ since: start });
+        const weekSessions = allSessions.filter((s) => s.startTime >= start.getTime() && s.startTime < end.getTime());
+        const devSessions = weekSessions.filter((s) => s.developer === developer);
+        const teamSessions = weekSessions;
+        const devAgg = aggregateWeek(devSessions);
+        const teamAgg = aggregateWeek(teamSessions);
+        return {
+            developer,
+            week: weekId,
+            developerEfficiency: devAgg.efficiency,
+            teamEfficiency: teamAgg.efficiency,
+            developerCost: devAgg.cost,
+            teamCost: teamAgg.cost,
+            developerTaskSuccess: devAgg.taskSuccess,
+            teamTaskSuccess: teamAgg.taskSuccess,
+        };
+    }
+    detectModelMigrationImpact(modelA, modelB) {
+        const allSessions = this.sessionStore.loadAllSessions();
+        const sessionsA = allSessions.filter((s) => s.model !== null && s.model.includes(modelA));
+        const sessionsB = allSessions.filter((s) => s.model !== null && s.model.includes(modelB));
+        const aggA = aggregateWeek(sessionsA);
+        const aggB = aggregateWeek(sessionsB);
+        // Per-session average cost
+        const avgCostA = sessionsA.length > 0 ? round(aggA.cost / sessionsA.length, 4) : 0;
+        const avgCostB = sessionsB.length > 0 ? round(aggB.cost / sessionsB.length, 4) : 0;
+        return {
+            modelA,
+            modelB,
+            modelACost: avgCostA,
+            modelBCost: avgCostB,
+            modelAEfficiency: aggA.efficiency,
+            modelBEfficiency: aggB.efficiency,
+            modelASessionCount: sessionsA.length,
+            modelBSessionCount: sessionsB.length,
+        };
+    }
+    generateWeekSummary(weekId) {
+        const agg = this.loadWeekAggregate(weekId);
+        // Try to load previous week for comparison
+        const prevWeekId = getPreviousWeekId(weekId);
+        const prevAgg = this.loadWeekAggregate(prevWeekId);
+        const hasPrev = prevAgg.cost > 0 || prevAgg.efficiency !== null;
+        const parts = [`Week ${weekId}:`];
+        // Efficiency
+        if (agg.efficiency !== null) {
+            let effStr = `avg efficiency ${agg.efficiency}`;
+            if (hasPrev && prevAgg.efficiency !== null) {
+                const pct = percentChange(prevAgg.efficiency, agg.efficiency);
+                if (pct !== null) {
+                    const arrow = pct >= 0 ? '\u2191' : '\u2193';
+                    effStr += ` (${arrow}${Math.abs(pct)}% vs prev)`;
+                }
+            }
+            parts.push(effStr);
+        }
+        // Cost
+        {
+            let costStr = `total cost $${agg.cost}`;
+            if (hasPrev && prevAgg.cost > 0) {
+                const pct = percentChange(prevAgg.cost, agg.cost);
+                if (pct !== null) {
+                    const arrow = pct >= 0 ? '\u2191' : '\u2193';
+                    costStr += ` (${arrow}${Math.abs(pct)}% vs prev)`;
+                }
+            }
+            parts.push(costStr);
+        }
+        // Task success
+        {
+            const rate = round(agg.taskSuccess * 100, 1);
+            let successStr = `task success ${rate}%`;
+            if (hasPrev) {
+                const deltaPp = round((agg.taskSuccess - prevAgg.taskSuccess) * 100, 1);
+                const arrow = deltaPp >= 0 ? '\u2191' : '\u2193';
+                successStr += ` (${arrow}${Math.abs(deltaPp)}pp vs prev)`;
+            }
+            parts.push(successStr);
+        }
+        return parts.join(', ');
+    }
+    emitWeeklySummaryEvent(weekId, aggregator) {
+        const { start, end } = getWeekDateRange(weekId);
+        const allSessions = this.sessionStore.loadAllSessions({ since: start });
+        const weekSessions = allSessions.filter((s) => s.startTime >= start.getTime() && s.startTime < end.getTime());
+        // Group by developer
+        const byDeveloper = new Map();
+        for (const s of weekSessions) {
+            const list = byDeveloper.get(s.developer) ?? [];
+            list.push(s);
+            byDeveloper.set(s.developer, list);
+        }
+        for (const [developer, sessions] of byDeveloper) {
+            const agg = aggregateWeek(sessions);
+            const attrs = { developer, week: weekId };
+            if (agg.efficiency !== null) {
+                aggregator.record('ai.trend.efficiency_score_weekly', agg.efficiency, attrs);
+            }
+            aggregator.record('ai.trend.cost_weekly', agg.cost, attrs);
+            aggregator.record('ai.trend.task_success_rate_weekly', agg.taskSuccess, attrs);
+        }
+        logger.debug('Weekly trend metrics emitted', { weekId, developers: byDeveloper.size });
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    loadWeekAggregate(weekId) {
+        const { start, end } = getWeekDateRange(weekId);
+        const allSessions = this.sessionStore.loadAllSessions({ since: start });
+        const weekSessions = allSessions.filter((s) => s.startTime >= start.getTime() && s.startTime < end.getTime());
+        return aggregateWeek(weekSessions);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function round(value, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(value * factor) / factor;
+}
+function getPreviousWeekId(weekId) {
+    const { start } = getWeekDateRange(weekId);
+    // Subtract 7 days and add 12 h to land at noon UTC, keeping the result inside
+    // the previous ISO week regardless of the local timezone offset.
+    const prevDate = new Date(start.getTime() - 7 * 86_400_000 + 43_200_000);
+    return getIsoWeekId(prevDate);
+}
+//# sourceMappingURL=trend-analyzer.js.map

package/dist/metrics/trend-analyzer.js.map

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

package/dist/metrics/turn-cost-attributor.d.ts

@@ -0,0 +1,41 @@
+import type { ToolCallRecord, TokenEvent } from '../storage/types.js';
+export interface TurnCostAttribution {
+    readonly turnId: string;
+    readonly startTime: number;
+    readonly endTime: number;
+    readonly toolCalls: string[];
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly model: string;
+    readonly estimatedCostUsd: number;
+    readonly costPerToolCall: number;
+}
+export interface ToolTypeCostEntry {
+    readonly totalCost: number;
+    readonly callCount: number;
+    readonly avgCost: number;
+}
+export interface CostAttributionMetrics {
+    readonly turns: TurnCostAttribution[];
+    readonly costByToolType: Record<string, ToolTypeCostEntry>;
+    readonly totalAttributedCost: number;
+    readonly attributionRate: number;
+}
+export declare class TurnCostAttributor {
+    private turns;
+    private pendingTurn;
+    private costByToolType;
+    private totalAttributedCost;
+    private totalToolCalls;
+    private attributedToolCalls;
+    recordToolCall(record: ToolCallRecord, turnId?: string): void;
+    recordTokenEvent(event: TokenEvent): void;
+    getCostForToolCall(toolUseId: string): {
+        estimatedTurnCostUsd: number;
+        costPerToolCallUsd: number;
+    } | null;
+    getMetrics(): CostAttributionMetrics;
+    reset(_sessionId?: string): void;
+}
+//# sourceMappingURL=turn-cost-attributor.d.ts.map

package/dist/metrics/turn-cost-attributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-cost-attributor.d.ts","sourceRoot":"","sources":["../../src/metrics/turn-cost-attributor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAyBD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,cAAc,CAA+D;IACrF,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,mBAAmB,CAAK;IAEhC,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAoB7D,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAmDzC,kBAAkB,CAChB,SAAS,EAAE,MAAM,GAChB;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAYtE,UAAU,IAAI,sBAAsB;IAkBpC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;CAQjC"}

package/dist/metrics/turn-cost-attributor.js

@@ -0,0 +1,118 @@
+import { randomUUID } from 'node:crypto';
+import { calculateCost } from '../shared/index.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const TURN_GAP_MS = 2_000;
+const TOKEN_MATCH_WINDOW_MS = 5_000;
+const MAX_TURNS = 200;
+// ---------------------------------------------------------------------------
+// TurnCostAttributor
+// ---------------------------------------------------------------------------
+export class TurnCostAttributor {
+    turns = [];
+    pendingTurn = null;
+    costByToolType = new Map();
+    totalAttributedCost = 0;
+    totalToolCalls = 0;
+    attributedToolCalls = 0;
+    recordToolCall(record, turnId) {
+        this.totalToolCalls++;
+        const endTime = record.timestamp + (record.durationMs ?? 0);
+        if (this.pendingTurn && record.timestamp - this.pendingTurn.endTime <= TURN_GAP_MS) {
+            this.pendingTurn.endTime = endTime;
+            this.pendingTurn.toolCalls.push({
+                toolUseId: record.toolUseId,
+                toolName: record.toolName,
+            });
+        }
+        else {
+            this.pendingTurn = {
+                turnId: turnId ?? randomUUID(),
+                startTime: record.timestamp,
+                endTime,
+                toolCalls: [{ toolUseId: record.toolUseId, toolName: record.toolName }],
+            };
+        }
+    }
+    recordTokenEvent(event) {
+        if (!this.pendingTurn)
+            return;
+        const timeSinceLastTool = event.timestamp - this.pendingTurn.endTime;
+        if (timeSinceLastTool < 0 || timeSinceLastTool > TOKEN_MATCH_WINDOW_MS)
+            return;
+        const usage = {
+            inputTokens: event.inputTokens,
+            outputTokens: event.outputTokens,
+            thinkingTokens: 0,
+            cacheReadTokens: event.cacheReadTokens,
+            cacheCreationTokens: event.cacheCreationTokens,
+            totalTokens: event.inputTokens + event.outputTokens,
+        };
+        const breakdown = calculateCost(event.model, usage);
+        const costUsd = breakdown.totalUsd;
+        const toolCount = this.pendingTurn.toolCalls.length;
+        const costPerTool = toolCount > 0 ? costUsd / toolCount : 0;
+        const attribution = {
+            turnId: this.pendingTurn.turnId,
+            startTime: this.pendingTurn.startTime,
+            endTime: this.pendingTurn.endTime,
+            toolCalls: this.pendingTurn.toolCalls.map((tc) => tc.toolUseId),
+            inputTokens: event.inputTokens,
+            outputTokens: event.outputTokens,
+            cacheReadTokens: event.cacheReadTokens,
+            model: event.model,
+            estimatedCostUsd: costUsd,
+            costPerToolCall: costPerTool,
+        };
+        this.turns.push(attribution);
+        if (this.turns.length > MAX_TURNS) {
+            this.turns.shift();
+        }
+        this.totalAttributedCost += costUsd;
+        this.attributedToolCalls += toolCount;
+        for (const tc of this.pendingTurn.toolCalls) {
+            const entry = this.costByToolType.get(tc.toolName) ?? { totalCost: 0, callCount: 0 };
+            entry.totalCost += costPerTool;
+            entry.callCount += 1;
+            this.costByToolType.set(tc.toolName, entry);
+        }
+        this.pendingTurn = null;
+    }
+    getCostForToolCall(toolUseId) {
+        for (const turn of this.turns) {
+            if (turn.toolCalls.includes(toolUseId)) {
+                return {
+                    estimatedTurnCostUsd: turn.estimatedCostUsd,
+                    costPerToolCallUsd: turn.costPerToolCall,
+                };
+            }
+        }
+        return null;
+    }
+    getMetrics() {
+        const costByToolType = {};
+        for (const [tool, entry] of this.costByToolType) {
+            costByToolType[tool] = {
+                totalCost: entry.totalCost,
+                callCount: entry.callCount,
+                avgCost: entry.callCount > 0 ? entry.totalCost / entry.callCount : 0,
+            };
+        }
+        return {
+            turns: [...this.turns],
+            costByToolType,
+            totalAttributedCost: this.totalAttributedCost,
+            attributionRate: this.totalToolCalls > 0 ? this.attributedToolCalls / this.totalToolCalls : 0,
+        };
+    }
+    reset(_sessionId) {
+        this.turns = [];
+        this.pendingTurn = null;
+        this.costByToolType = new Map();
+        this.totalAttributedCost = 0;
+        this.totalToolCalls = 0;
+        this.attributedToolCalls = 0;
+    }
+}
+//# sourceMappingURL=turn-cost-attributor.js.map

package/dist/metrics/turn-cost-attributor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-cost-attributor.js","sourceRoot":"","sources":["../../src/metrics/turn-cost-attributor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAkCnD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,qBAAqB,GAAG,KAAK,CAAC;AACpC,MAAM,SAAS,GAAG,GAAG,CAAC;AAatB,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,OAAO,kBAAkB;IACrB,KAAK,GAA0B,EAAE,CAAC;IAClC,WAAW,GAAuB,IAAI,CAAC;IACvC,cAAc,GAAG,IAAI,GAAG,EAAoD,CAAC;IAC7E,mBAAmB,GAAG,CAAC,CAAC;IACxB,cAAc,GAAG,CAAC,CAAC;IACnB,mBAAmB,GAAG,CAAC,CAAC;IAEhC,cAAc,CAAC,MAAsB,EAAE,MAAe;QACpD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,WAAW,EAAE,CAAC;YACnF,IAAI,CAAC,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;YACnC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,GAAG;gBACjB,MAAM,EAAE,MAAM,IAAI,UAAU,EAAE;gBAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO;gBACP,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;aACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,KAAiB;QAChC,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAE9B,MAAM,iBAAiB,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;QACrE,IAAI,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,GAAG,qBAAqB;YAAE,OAAO;QAE/E,MAAM,KAAK,GAAe;YACxB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;YAC9C,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,YAAY;SACpD,CAAC;QAEF,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC;QACpD,MAAM,WAAW,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5D,MAAM,WAAW,GAAwB;YACvC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;YAC/B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS;YACrC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO;YACjC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC;YAC/D,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,gBAAgB,EAAE,OAAO;YACzB,eAAe,EAAE,WAAW;SAC7B,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,mBAAmB,IAAI,OAAO,CAAC;QACpC,IAAI,CAAC,mBAAmB,IAAI,SAAS,CAAC;QAEtC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;YACrF,KAAK,CAAC,SAAS,IAAI,WAAW,CAAC;YAC/B,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,kBAAkB,CAChB,SAAiB;QAEjB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvC,OAAO;oBACL,oBAAoB,EAAE,IAAI,CAAC,gBAAgB;oBAC3C,kBAAkB,EAAE,IAAI,CAAC,eAAe;iBACzC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU;QACR,MAAM,cAAc,GAAsC,EAAE,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAChD,cAAc,CAAC,IAAI,CAAC,GAAG;gBACrB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;aACrE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YACtB,cAAc;YACd,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,eAAe,EAAE,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;SAC9F,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAmB;QACvB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,49 @@
+import type { ToolCallRecord } from '../storage/types.js';
+export interface ConversationTurn {
+    readonly turnId: string;
+    readonly turnNumber: number;
+    readonly startTime: number;
+    readonly endTime: number;
+    readonly durationMs: number;
+    readonly toolCalls: Array<{
+        readonly toolName: string;
+        readonly toolUseId: string;
+        readonly success: boolean;
+        readonly durationMs: number | null;
+    }>;
+    readonly toolCount: number;
+    readonly parallelism: number;
+    readonly uniqueTools: string[];
+}
+export interface TurnMetrics {
+    readonly totalTurns: number;
+    readonly avgToolsPerTurn: number;
+    readonly maxToolsPerTurn: number;
+    readonly avgTurnDurationMs: number;
+    readonly avgParallelism: number;
+    readonly recentTurns: ConversationTurn[];
+    readonly turnsByToolCount: Record<number, number>;
+}
+export interface TurnTrackerOptions {
+    gapThresholdMs?: number;
+}
+export declare class TurnTracker {
+    private readonly gapThresholdMs;
+    private turns;
+    private turnCounter;
+    private currentTurnCalls;
+    private currentTurnEnd;
+    constructor(options?: TurnTrackerOptions);
+    recordToolCall(record: ToolCallRecord): string;
+    getMetrics(): TurnMetrics;
+    getCurrentTurnId(): string;
+    getCurrentTurnNumber(): number;
+    reset(_sessionId: string): void;
+    private cachedTurnId;
+    private buildTurnId;
+    private finalizeTurn;
+    private getAllTurns;
+    private computeCallEnd;
+    private computeParallelism;
+}
+//# sourceMappingURL=turn-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turn-tracker.d.ts","sourceRoot":"","sources":["../../src/metrics/turn-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC,CAAC;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnD;AAcD,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,CAAC,EAAE,kBAAkB;IAIxC,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IA0B9C,UAAU,IAAI,WAAW;IA2CzB,gBAAgB,IAAI,MAAM;IAU1B,oBAAoB,IAAI,MAAM;IAK9B,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ/B,OAAO,CAAC,YAAY,CAAuB;IAE3C,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,kBAAkB;CAwB3B"}