@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/storage/types.d.ts

@@ -0,0 +1,64 @@
+export interface HookEvent {
+    readonly mode: 'pre' | 'post' | 'token';
+    readonly tool: string;
+    readonly timestamp: number;
+    readonly inputHash?: string;
+    readonly inputSize?: number;
+    readonly outputSize?: number;
+    readonly success?: boolean;
+    readonly [key: string]: unknown;
+}
+export interface TokenEvent {
+    readonly mode: 'token';
+    readonly timestamp: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheCreationTokens: number;
+    readonly model: string;
+    readonly sessionId?: string;
+}
+export interface SessionSummary {
+    readonly sessionId: string;
+    readonly startTime: number;
+    readonly endTime: number;
+    readonly durationMs: number;
+    readonly toolCallCount: number;
+    readonly developer: string;
+    readonly [key: string]: unknown;
+}
+export interface ToolCallRecord {
+    readonly id: string;
+    readonly sessionId: string | null;
+    readonly toolName: string;
+    readonly toolUseId: string;
+    readonly timestamp: number;
+    readonly durationMs: number | null;
+    readonly success: boolean;
+    readonly errorType?: string;
+    readonly error?: string;
+    readonly inputSizeBytes?: number;
+    readonly outputSizeBytes?: number;
+    readonly inputHash?: string;
+    readonly [key: string]: unknown;
+}
+export interface ReplayTimelineEntry {
+    readonly timestamp: number;
+    readonly toolName: string;
+    readonly durationMs: number | null;
+    readonly success: boolean;
+    readonly filePath?: string;
+    readonly command?: string;
+    readonly isTestCommand?: boolean;
+    readonly isBuildCommand?: boolean;
+    readonly isLintCommand?: boolean;
+    readonly errorType?: string;
+}
+export interface AuditEntry {
+    readonly timestamp: number;
+    readonly action: string;
+    readonly tool?: string;
+    readonly detail?: string;
+    readonly [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/storage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":""}

package/dist/storage/weekly-summary.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Weekly Summary Generation — aggregates session data into weekly reports.
+ *
+ * `WeeklySummaryGenerator` loads all sessions from a given ISO week,
+ * computes aggregate stats (total cost, tool usage, task completion, etc.),
+ * and writes a summary file to `weekly_summaries/{weekId}.json`.
+ *
+ * ISO week helpers use Monday as the first day of the week.
+ */
+import type { SessionStore } from './session-store.js';
+export interface DeveloperWeeklyStats {
+    readonly sessionCount: number;
+    readonly totalCostUsd: number;
+    readonly avgEfficiencyScore: number | null;
+    readonly totalToolCalls: number;
+    readonly toolBreakdown: Record<string, number>;
+    readonly totalTasksCompleted: number;
+    readonly taskSuccessRate: number | null;
+    readonly antiPatternCounts: Record<string, number>;
+}
+export interface WeeklySummary {
+    readonly week: string;
+    readonly generatedAt: number;
+    readonly developers: string[];
+    readonly sessionCount: number;
+    readonly totalCostUsd: number;
+    readonly avgCostPerSession: number;
+    readonly avgEfficiencyScore: number | null;
+    readonly totalToolCalls: number;
+    readonly toolBreakdown: Record<string, number>;
+    readonly totalTasksCompleted: number;
+    readonly taskSuccessRate: number | null;
+    readonly antiPatternCounts: Record<string, number>;
+    readonly perDeveloper: Record<string, DeveloperWeeklyStats>;
+}
+/**
+ * Compute the ISO week identifier for a date (e.g., "2026-W16").
+ * ISO weeks start on Monday.
+ */
+export declare function getIsoWeekId(date: Date): string;
+/**
+ * Compute the date range for an ISO week.
+ * Returns Monday 00:00:00 UTC to Sunday 23:59:59.999 UTC.
+ */
+export declare function getWeekDateRange(weekId: string): {
+    start: Date;
+    end: Date;
+};
+export declare class WeeklySummaryGenerator {
+    private readonly summariesDir;
+    private readonly sessionStore;
+    constructor(options: {
+        storagePath: string;
+        sessionStore: SessionStore;
+    });
+    generate(weekId: string): WeeklySummary;
+    getLatest(): WeeklySummary | null;
+    checkAndGenerateLastWeek(): WeeklySummary | null;
+    loadRecentWeeks(count: number): WeeklySummary[];
+}
+//# sourceMappingURL=weekly-summary.d.ts.map

package/dist/storage/weekly-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekly-summary.d.ts","sourceRoot":"","sources":["../../src/storage/weekly-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASvD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC7D;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQ/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAwB3E;AAMD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE;IAKxE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAmCvC,SAAS,IAAI,aAAa,GAAG,IAAI;IAqBjC,wBAAwB,IAAI,aAAa,GAAG,IAAI;IAYhD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;CAqBhD"}

package/dist/storage/weekly-summary.js

@@ -0,0 +1,243 @@
+/**
+ * Weekly Summary Generation — aggregates session data into weekly reports.
+ *
+ * `WeeklySummaryGenerator` loads all sessions from a given ISO week,
+ * computes aggregate stats (total cost, tool usage, task completion, etc.),
+ * and writes a summary file to `weekly_summaries/{weekId}.json`.
+ *
+ * ISO week helpers use Monday as the first day of the week.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLogger } from '../shared/index.js';
+const logger = createLogger('weekly-summary');
+// ---------------------------------------------------------------------------
+// ISO week helpers
+// ---------------------------------------------------------------------------
+/**
+ * Compute the ISO week identifier for a date (e.g., "2026-W16").
+ * ISO weeks start on Monday.
+ */
+export function getIsoWeekId(date) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    // Set to nearest Thursday: current date + 4 - current day number (Mon=1, Sun=7)
+    const dayNum = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    const weekNo = Math.ceil(((d.getTime() - yearStart.getTime()) / 86_400_000 + 1) / 7);
+    return `${d.getUTCFullYear()}-W${String(weekNo).padStart(2, '0')}`;
+}
+/**
+ * Compute the date range for an ISO week.
+ * Returns Monday 00:00:00 UTC to Sunday 23:59:59.999 UTC.
+ */
+export function getWeekDateRange(weekId) {
+    const match = weekId.match(/^(\d{4})-W(\d{2})$/);
+    if (!match)
+        throw new Error(`Invalid week ID: ${weekId}`);
+    const year = parseInt(match[1], 10);
+    const week = parseInt(match[2], 10);
+    // Jan 4 is always in week 1 of the ISO year
+    const jan4 = new Date(Date.UTC(year, 0, 4));
+    const dayNum = jan4.getUTCDay() || 7;
+    // Monday of week 1
+    const week1Monday = new Date(jan4.getTime());
+    week1Monday.setUTCDate(jan4.getUTCDate() - (dayNum - 1));
+    // Monday of target week
+    const targetMonday = new Date(week1Monday.getTime());
+    targetMonday.setUTCDate(week1Monday.getUTCDate() + (week - 1) * 7);
+    // Exclusive upper bound: Monday 00:00:00.000 of the following week.
+    // Use half-open interval [start, end) to avoid the 23:59:59.999 boundary edge case.
+    const nextMonday = new Date(targetMonday.getTime());
+    nextMonday.setUTCDate(targetMonday.getUTCDate() + 7);
+    return { start: targetMonday, end: nextMonday };
+}
+// ---------------------------------------------------------------------------
+// WeeklySummaryGenerator
+// ---------------------------------------------------------------------------
+export class WeeklySummaryGenerator {
+    summariesDir;
+    sessionStore;
+    constructor(options) {
+        this.summariesDir = join(options.storagePath, 'weekly_summaries');
+        this.sessionStore = options.sessionStore;
+    }
+    generate(weekId) {
+        // N-03: defense-in-depth — reject non-conforming weekIds before filepath construction
+        if (!/^\d{4}-W\d{2}$/.test(weekId)) {
+            throw new Error(`Invalid weekId format: "${weekId}". Expected YYYY-Wnn.`);
+        }
+        const { start, end } = getWeekDateRange(weekId);
+        // Widen the filename pre-filter by one day to avoid excluding sessions that started
+        // near midnight UTC on the week boundary — the strict startTime filter below is
+        // the authoritative range guard.
+        const allSessions = this.sessionStore.loadAllSessions({
+            since: new Date(start.getTime() - 86_400_000),
+        });
+        const weekSessions = allSessions.filter((s) => s.startTime >= start.getTime() && s.startTime < end.getTime());
+        const summary = aggregateSessions(weekId, weekSessions);
+        if (!existsSync(this.summariesDir)) {
+            mkdirSync(this.summariesDir, { recursive: true, mode: 0o700 });
+        }
+        const filepath = join(this.summariesDir, `${weekId}.json`);
+        try {
+            writeFileSync(filepath, JSON.stringify(summary, null, 2) + '\n', { mode: 0o600 });
+            logger.debug('Weekly summary generated', { weekId, sessions: weekSessions.length });
+        }
+        catch (err) {
+            logger.error('Failed to write weekly summary to disk', { weekId, error: String(err) });
+            // Return the in-memory summary even if the write fails so callers still get data
+        }
+        return summary;
+    }
+    getLatest() {
+        if (!existsSync(this.summariesDir))
+            return null;
+        // Only include zero-padded filenames (YYYY-Wnn.json); older non-padded
+        // files (e.g. 2026-W9.json) sort incorrectly and are excluded.
+        const files = readdirSync(this.summariesDir)
+            .filter((f) => /^\d{4}-W\d{2}\.json$/.test(f))
+            .sort();
+        if (files.length === 0)
+            return null;
+        const latestFile = files[files.length - 1];
+        try {
+            const raw = readFileSync(join(this.summariesDir, latestFile), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            logger.warn('Failed to read latest weekly summary', { file: latestFile });
+            return null;
+        }
+    }
+    checkAndGenerateLastWeek() {
+        const lastWeekDate = new Date(Date.now() - 7 * 86_400_000);
+        const lastWeekId = getIsoWeekId(lastWeekDate);
+        const filepath = join(this.summariesDir, `${lastWeekId}.json`);
+        if (existsSync(filepath)) {
+            return null;
+        }
+        return this.generate(lastWeekId);
+    }
+    loadRecentWeeks(count) {
+        if (!existsSync(this.summariesDir))
+            return [];
+        const files = readdirSync(this.summariesDir)
+            .filter((f) => /^\d{4}-W\d{2}\.json$/.test(f))
+            .sort()
+            .reverse() // newest first
+            .slice(0, count);
+        const results = [];
+        for (const file of files) {
+            try {
+                const raw = readFileSync(join(this.summariesDir, file), 'utf-8');
+                results.push(JSON.parse(raw));
+            }
+            catch {
+                logger.warn('Skipping unreadable weekly summary', { file });
+            }
+        }
+        return results;
+    }
+}
+// ---------------------------------------------------------------------------
+// Aggregation
+// ---------------------------------------------------------------------------
+function aggregateSessions(weekId, sessions) {
+    const perDeveloper = new Map();
+    for (const session of sessions) {
+        const existing = perDeveloper.get(session.developer) ?? [];
+        existing.push(session);
+        perDeveloper.set(session.developer, existing);
+    }
+    let totalCostUsd = 0;
+    let totalToolCalls = 0;
+    let totalTasksCompleted = 0;
+    let totalTestsRun = 0;
+    let totalTestsPassed = 0;
+    let efficiencySum = 0;
+    let efficiencyCount = 0;
+    // N-06: null-proto accumulators — prevent prototype pollution from disk-sourced keys
+    const toolBreakdown = Object.create(null);
+    const antiPatternCounts = Object.create(null);
+    for (const session of sessions) {
+        totalCostUsd += session.estimatedCostUsd ?? 0;
+        totalToolCalls += session.toolCallCount;
+        totalTasksCompleted += session.taskCount;
+        totalTestsRun += session.testRunCount;
+        totalTestsPassed += session.testPassCount;
+        if (session.efficiencyScore !== null) {
+            efficiencySum += session.efficiencyScore;
+            efficiencyCount++;
+        }
+        for (const [tool, count] of Object.entries(session.toolBreakdown)) {
+            toolBreakdown[tool] = (toolBreakdown[tool] ?? 0) + count;
+        }
+        for (const ap of session.antiPatterns) {
+            antiPatternCounts[ap.type] = (antiPatternCounts[ap.type] ?? 0) + ap.count;
+        }
+    }
+    const devStats = {};
+    for (const [developer, devSessions] of perDeveloper) {
+        devStats[developer] = aggregateDeveloperSessions(devSessions);
+    }
+    return {
+        week: weekId,
+        generatedAt: Date.now(),
+        developers: [...perDeveloper.keys()].sort(),
+        sessionCount: sessions.length,
+        totalCostUsd: round(totalCostUsd, 4),
+        avgCostPerSession: sessions.length > 0 ? round(totalCostUsd / sessions.length, 4) : 0,
+        avgEfficiencyScore: efficiencyCount > 0 ? round(efficiencySum / efficiencyCount, 3) : null,
+        totalToolCalls,
+        toolBreakdown,
+        totalTasksCompleted,
+        taskSuccessRate: totalTestsRun > 0 ? round(Math.min(1, totalTestsPassed / totalTestsRun), 3) : null,
+        antiPatternCounts,
+        perDeveloper: devStats,
+    };
+}
+function aggregateDeveloperSessions(sessions) {
+    let totalCostUsd = 0;
+    let totalToolCalls = 0;
+    let totalTasksCompleted = 0;
+    let totalTestsRun = 0;
+    let totalTestsPassed = 0;
+    let efficiencySum = 0;
+    let efficiencyCount = 0;
+    // N-06: null-proto accumulators — prevent prototype pollution from disk-sourced keys
+    const toolBreakdown = Object.create(null);
+    const antiPatternCounts = Object.create(null);
+    for (const session of sessions) {
+        totalCostUsd += session.estimatedCostUsd ?? 0;
+        totalToolCalls += session.toolCallCount;
+        totalTasksCompleted += session.taskCount;
+        totalTestsRun += session.testRunCount;
+        totalTestsPassed += session.testPassCount;
+        if (session.efficiencyScore !== null) {
+            efficiencySum += session.efficiencyScore;
+            efficiencyCount++;
+        }
+        for (const [tool, count] of Object.entries(session.toolBreakdown)) {
+            toolBreakdown[tool] = (toolBreakdown[tool] ?? 0) + count;
+        }
+        for (const ap of session.antiPatterns) {
+            antiPatternCounts[ap.type] = (antiPatternCounts[ap.type] ?? 0) + ap.count;
+        }
+    }
+    return {
+        sessionCount: sessions.length,
+        totalCostUsd: round(totalCostUsd, 4),
+        avgEfficiencyScore: efficiencyCount > 0 ? round(efficiencySum / efficiencyCount, 3) : null,
+        totalToolCalls,
+        toolBreakdown,
+        totalTasksCompleted,
+        taskSuccessRate: totalTestsRun > 0 ? round(Math.min(1, totalTestsPassed / totalTestsRun), 3) : null,
+        antiPatternCounts,
+    };
+}
+function round(value, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=weekly-summary.js.map

package/dist/storage/weekly-summary.js.map

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

package/dist/tools/analytics-tools.d.ts

@@ -0,0 +1,101 @@
+/**
+ * MCP tool handlers for new metric trackers.
+ *
+ * Defines and handles:
+ *   - nr_observe_get_context_efficiency — context window efficiency metrics
+ *   - nr_observe_get_latency_percentiles — tool call latency percentiles
+ *   - nr_observe_get_task_completion_rate — task lifecycle metrics
+ *   - nr_observe_get_model_usage — per-model usage and efficiency
+ */
+import type { ContextWindowTracker } from '../metrics/context-window-tracker.js';
+import type { ContextTrackerRegistry } from '../metrics/context-tracker.js';
+import type { LatencyTracker } from '../metrics/latency-tracker.js';
+import type { TaskCompletionTracker } from '../metrics/task-completion-tracker.js';
+import type { ModelUsageTracker } from '../metrics/model-usage-tracker.js';
+import type { TaskDetector } from '../metrics/task-detector.js';
+export declare const CONTEXT_EFFICIENCY_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const LATENCY_PERCENTILES_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const TASK_COMPLETION_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const MODEL_USAGE_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const CONTEXT_TRACKING_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare function handleGetContextEfficiency(tracker: ContextWindowTracker): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function handleGetLatencyPercentiles(tracker: LatencyTracker): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function handleGetTaskCompletionRate(tracker: TaskCompletionTracker, _taskDetector?: TaskDetector): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function handleGetModelUsage(tracker: ModelUsageTracker): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function handleGetContextTracking(tracker: ContextTrackerRegistry): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+//# sourceMappingURL=analytics-tools.d.ts.map

package/dist/tools/analytics-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-tools.d.ts","sourceRoot":"","sources":["../../src/tools/analytics-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,eAAO,MAAM,uBAAuB;;;;;;;;;;CAMnC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;CAMpC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;CAMhC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;CAM5B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;CAMjC,CAAC;AAMF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,GAAG;IACzE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAIA;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc,GAAG;IACpE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAIA;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,qBAAqB,EAC9B,aAAa,CAAC,EAAE,YAAY,GAC3B;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAIpD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAC/D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAIA;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,sBAAsB,GAAG;IACzE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAIA"}

package/dist/tools/analytics-tools.js

@@ -0,0 +1,71 @@
+/**
+ * MCP tool handlers for new metric trackers.
+ *
+ * Defines and handles:
+ *   - nr_observe_get_context_efficiency — context window efficiency metrics
+ *   - nr_observe_get_latency_percentiles — tool call latency percentiles
+ *   - nr_observe_get_task_completion_rate — task lifecycle metrics
+ *   - nr_observe_get_model_usage — per-model usage and efficiency
+ */
+// ---------------------------------------------------------------------------
+// Tool definitions (for tools/list)
+// ---------------------------------------------------------------------------
+export const CONTEXT_EFFICIENCY_TOOL = {
+    name: 'nr_observe_get_context_efficiency',
+    description: 'Get context window efficiency metrics: unique vs. repeated file reads, repeated-read ratio, and top re-read files. A high ratio suggests the model is losing context.',
+    inputSchema: { type: 'object', properties: {} },
+    annotations: { readOnlyHint: true },
+};
+export const LATENCY_PERCENTILES_TOOL = {
+    name: 'nr_observe_get_latency_percentiles',
+    description: 'Get p50/p95/p99 latency percentiles for tool calls, broken down by tool type. Use to identify which tools are slowest in the current session.',
+    inputSchema: { type: 'object', properties: {} },
+    annotations: { readOnlyHint: true },
+};
+export const TASK_COMPLETION_TOOL = {
+    name: 'nr_observe_get_task_completion_rate',
+    description: 'Get task lifecycle metrics: completed task count, average task duration, and average tool calls per task.',
+    inputSchema: { type: 'object', properties: {} },
+    annotations: { readOnlyHint: true },
+};
+export const MODEL_USAGE_TOOL = {
+    name: 'nr_observe_get_model_usage',
+    description: 'Get per-model usage statistics: request counts, token totals, cost, and cost-per-output-token efficiency ratios. Identifies the most-used and most cost-efficient model.',
+    inputSchema: { type: 'object', properties: {} },
+    annotations: { readOnlyHint: true },
+};
+export const CONTEXT_TRACKING_TOOL = {
+    name: 'nr_observe_get_context_tracking',
+    description: 'Get context window tracking: per-turn token growth, category breakdown (System/Tools/User/Assistant), fill percentage, and per-tool output contribution. Shows which tools consume the most context.',
+    inputSchema: { type: 'object', properties: {} },
+    annotations: { readOnlyHint: true },
+};
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+export function handleGetContextEfficiency(tracker) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(tracker.getMetrics(), null, 2) }],
+    };
+}
+export function handleGetLatencyPercentiles(tracker) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(tracker.getMetrics(), null, 2) }],
+    };
+}
+export function handleGetTaskCompletionRate(tracker, _taskDetector) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(tracker.getMetrics(), null, 2) }],
+    };
+}
+export function handleGetModelUsage(tracker) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(tracker.getMetrics(), null, 2) }],
+    };
+}
+export function handleGetContextTracking(tracker) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(tracker.getMetrics(), null, 2) }],
+    };
+}
+//# sourceMappingURL=analytics-tools.js.map

package/dist/tools/analytics-tools.js.map

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