@newrelic/preflight 0.0.1-pre.1 → 1.0.0

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

@@ -0,0 +1,121 @@
+/**
+ * MCP tool handlers for cost tracking.
+ *
+ * Defines:
+ *   - `nr_observe_report_tokens` — self-report token usage for cost tracking
+ *   - `nr_observe_get_cost_breakdown` — session cost breakdown by task
+ */
+import type { CostTracker } from '../metrics/cost-tracker.js';
+import type { TaskDetector } from '../metrics/task-detector.js';
+import type { BudgetTracker } from '../metrics/budget-tracker.js';
+import type { ModelUsageTracker } from '../metrics/model-usage-tracker.js';
+export interface TokenReport {
+    input_tokens: number;
+    output_tokens: number;
+    thinking_tokens?: number;
+    cache_read_tokens?: number;
+    cache_creation_tokens?: number;
+    model: string;
+}
+export declare const REPORT_TOKENS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            input_tokens: {
+                type: string;
+                description: string;
+            };
+            output_tokens: {
+                type: string;
+                description: string;
+            };
+            thinking_tokens: {
+                type: string;
+                description: string;
+            };
+            cache_read_tokens: {
+                type: string;
+                description: string;
+            };
+            cache_creation_tokens: {
+                type: string;
+                description: string;
+            };
+            model: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare function handleReportTokens(costTracker: CostTracker, args: TokenReport, modelUsageTracker?: ModelUsageTracker): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+};
+export declare const COST_BREAKDOWN_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare function handleGetCostBreakdown(costTracker: CostTracker, taskDetector?: TaskDetector): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare const BUDGET_STATUS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const COST_FORECAST_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare function handleGetBudgetStatus(budgetTracker: BudgetTracker): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function handleGetCostForecast(costTracker: CostTracker, sessionStartMs: number): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+//# sourceMappingURL=cost-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tools.d.ts","sourceRoot":"","sources":["../../src/tools/cost-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAS3E,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwB9B,CAAC;AAYF,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,WAAW,EACjB,iBAAiB,CAAC,EAAE,iBAAiB;;;;;;;;;;;;EAuDtC;AAMD,eAAO,MAAM,mBAAmB;;;;;;;;;;CAS/B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,YAAY;;;;;EA6B3F;AAMD,eAAO,MAAM,kBAAkB;;;;;;;;;;CAS9B,CAAC;AAMF,eAAO,MAAM,kBAAkB;;;;;;;;;;CAS9B,CAAC;AAMF,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,aAAa,GAAG;IACnE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAGA;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,GACrB;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAUpD"}

package/dist/tools/cost-tools.js

@@ -0,0 +1,174 @@
+/**
+ * MCP tool handlers for cost tracking.
+ *
+ * Defines:
+ *   - `nr_observe_report_tokens` — self-report token usage for cost tracking
+ *   - `nr_observe_get_cost_breakdown` — session cost breakdown by task
+ */
+import { buildCostForecastFromInputs } from '../metrics/cost-forecast.js';
+import { localDateKey } from '../lib/date.js';
+// ---------------------------------------------------------------------------
+// Tool definitions (for tools/list)
+// ---------------------------------------------------------------------------
+export const REPORT_TOKENS_TOOL = {
+    name: 'nr_observe_report_tokens',
+    description: 'Report token usage for cost tracking. Call periodically to enable accurate cost metrics. ' +
+        'Provide the model name and token counts from the most recent API response.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            input_tokens: { type: 'number', description: 'Number of input/prompt tokens' },
+            output_tokens: { type: 'number', description: 'Number of output/completion tokens' },
+            thinking_tokens: {
+                type: 'number',
+                description: 'Number of thinking/reasoning tokens (optional)',
+            },
+            cache_read_tokens: { type: 'number', description: 'Number of cache read tokens (optional)' },
+            cache_creation_tokens: {
+                type: 'number',
+                description: 'Number of cache creation tokens (optional)',
+            },
+            model: { type: 'string', description: 'Model identifier (e.g. claude-sonnet-4-20250514)' },
+        },
+        required: ['input_tokens', 'output_tokens', 'model'],
+    },
+    annotations: { readOnlyHint: false },
+};
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+const MAX_TOKENS = 10_000_000;
+const clampToken = (v) => {
+    if (!Number.isFinite(v))
+        return 0;
+    return Math.min(Math.max(0, Math.floor(v)), MAX_TOKENS);
+};
+export function handleReportTokens(costTracker, args, modelUsageTracker) {
+    const inputTokens = clampToken(args.input_tokens);
+    const outputTokens = clampToken(args.output_tokens);
+    const thinkingTokens = clampToken(args.thinking_tokens ?? 0);
+    const cacheReadTokens = clampToken(args.cache_read_tokens ?? 0);
+    const cacheCreationTokens = clampToken(args.cache_creation_tokens ?? 0);
+    const safeModel = typeof args.model === 'string' ? args.model.slice(0, 256) : 'unknown';
+    if (!/^[a-zA-Z0-9._:-]+$/.test(safeModel)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'invalid_model_name',
+                        message: `Model name contains invalid characters: ${safeModel}. Allowed: alphanumerics, dots, underscores, colons, hyphens.`,
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const usage = {
+        inputTokens,
+        outputTokens,
+        thinkingTokens,
+        cacheReadTokens,
+        cacheCreationTokens,
+        // Cache tokens are billed separately and excluded from totalTokens to match Anthropic dashboard conventions
+        totalTokens: inputTokens + outputTokens + thinkingTokens,
+    };
+    const breakdown = costTracker.recordTokenUsage(usage, safeModel);
+    modelUsageTracker?.recordUsage(safeModel, inputTokens, outputTokens, breakdown.totalUsd);
+    const metrics = costTracker.getMetrics();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    recorded: true,
+                    cost_this_report_usd: breakdown.totalUsd,
+                    session_total_cost_usd: metrics.sessionTotalCostUsd,
+                    model: safeModel,
+                }, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Cost Breakdown tool
+// ---------------------------------------------------------------------------
+export const COST_BREAKDOWN_TOOL = {
+    name: 'nr_observe_get_cost_breakdown',
+    description: 'Get a breakdown of session costs by task, model, and efficiency metrics like cost per line of code.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    annotations: { readOnlyHint: true },
+};
+export function handleGetCostBreakdown(costTracker, taskDetector) {
+    const metrics = costTracker.getMetrics();
+    const byTask = taskDetector
+        ? taskDetector.getCompletedTasks().map((task) => ({
+            task_id: task.taskId,
+            cost_usd: task.estimatedCostUsd,
+            tokens_used: task.tokensUsed,
+        }))
+        : [];
+    const result = {
+        total_usd: metrics.sessionTotalCostUsd ?? 0,
+        by_model: metrics.costByModel,
+        by_task: byTask,
+        cost_per_line_of_code: metrics.costPerLineOfCode,
+        cost_per_file_modified: metrics.costPerFileModified,
+        tokens: {
+            input: metrics.totalInputTokens,
+            output: metrics.totalOutputTokens,
+            thinking: metrics.totalThinkingTokens,
+            cache_read: metrics.totalCacheReadTokens,
+            cache_creation: metrics.totalCacheCreationTokens,
+        },
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+// ---------------------------------------------------------------------------
+// Budget Status tool
+// ---------------------------------------------------------------------------
+export const BUDGET_STATUS_TOOL = {
+    name: 'nr_observe_get_budget_status',
+    description: 'Get current AI spend vs. configured budget caps (session, daily, weekly). Returns remaining budget, % used, and any threshold alerts fired this session.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    annotations: { readOnlyHint: true },
+};
+// ---------------------------------------------------------------------------
+// Cost Forecast tool
+// ---------------------------------------------------------------------------
+export const COST_FORECAST_TOOL = {
+    name: 'nr_observe_get_cost_forecast',
+    description: 'Project AI spending forward based on current session rate. Returns forecast cost for end-of-day, end-of-week, and end-of-session (8h), with a confidence note.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    annotations: { readOnlyHint: true },
+};
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+export function handleGetBudgetStatus(budgetTracker) {
+    const status = budgetTracker.getStatus();
+    return { content: [{ type: 'text', text: JSON.stringify(status, null, 2) }] };
+}
+export function handleGetCostForecast(costTracker, sessionStartMs) {
+    const metrics = costTracker.getMetrics();
+    const todayKey = localDateKey();
+    const forecast = buildCostForecastFromInputs({
+        sessionSpentUsd: metrics.sessionTotalCostUsd ?? 0,
+        sessionStartMs,
+        dailySpentUsd: costTracker.getCostForDay(todayKey),
+        dailyFirstActivityMs: costTracker.getFirstActivityMsForDay(todayKey),
+    });
+    return { content: [{ type: 'text', text: JSON.stringify(forecast, null, 2) }] };
+}
+//# sourceMappingURL=cost-tools.js.map

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

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

package/dist/tools/cross-session-tools.d.ts

@@ -0,0 +1,376 @@
+/**
+ * MCP tool definitions and handlers for cross-session analytics and digest delivery.
+ *
+ * Tools: nr_observe_get_session_history, nr_observe_get_weekly_summary,
+ *   nr_observe_get_trends, nr_observe_get_collaboration_profile,
+ *   nr_observe_get_claudemd_impact, nr_observe_get_cost_per_outcome,
+ *   nr_observe_get_recommendations, nr_observe_get_platform_comparison,
+ *   nr_observe_get_team_summary, nr_observe_subscribe_digest,
+ *   nr_observe_unsubscribe_digest, nr_observe_send_digest
+ *
+ * Tool defs and handlers are exported for integration into the main
+ * registerTools() in session-stats.ts.
+ */
+import type { SessionStore } from '../storage/session-store.js';
+import type { WeeklySummaryGenerator } from '../storage/weekly-summary.js';
+import type { TrendAnalyzer } from '../metrics/trend-analyzer.js';
+import type { CollaborationProfiler } from '../metrics/collaboration-profile.js';
+import type { ClaudeMdTracker } from '../metrics/claudemd-tracker.js';
+import type { CostPerOutcomeAnalyzer } from '../metrics/cost-per-outcome.js';
+import type { TaskDetector } from '../metrics/task-detector.js';
+import type { RecommendationEngine } from '../metrics/recommendation-engine.js';
+export declare const SESSION_HISTORY_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            since: {
+                type: string;
+                description: string;
+            };
+            developer: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const WEEKLY_SUMMARY_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            week: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const TRENDS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            metric: {
+                type: string;
+                description: string;
+            };
+            developer: {
+                type: string;
+                description: string;
+            };
+            weeks: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const COLLABORATION_PROFILE_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            developer: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const CLAUDEMD_IMPACT_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const COST_PER_OUTCOME_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            since: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const RECOMMENDATIONS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            developer: {
+                type: string;
+                description: string;
+            };
+            topN: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const PLATFORM_COMPARISON_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            metric: {
+                type: string;
+                description: string;
+            };
+            weeks: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const TEAM_SUMMARY_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            since: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const SUBSCRIBE_DIGEST_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            webhookUrl: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const UNSUBSCRIBE_DIGEST_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const SEND_DIGEST_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const PERSONAL_INSIGHTS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+};
+export declare const CROSS_SESSION_TOOLS: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    annotations: {
+        readOnlyHint: boolean;
+    };
+}[];
+export declare function toFiniteNumber(x: unknown, fallback?: number): number;
+export declare function handleGetSessionHistory(sessionStore: SessionStore, args: {
+    since?: string;
+    developer?: string;
+    limit?: number;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+};
+export declare function handleGetWeeklySummary(weeklySummaryGenerator: WeeklySummaryGenerator, args: {
+    week?: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function handleGetTrends(trendAnalyzer: TrendAnalyzer, args: {
+    metric?: string;
+    developer?: string;
+    weeks?: number;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleGetCollaborationProfile(collaborationProfiler: CollaborationProfiler, args: {
+    developer?: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleGetClaudeMdImpact(claudeMdTracker: ClaudeMdTracker): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleGetCostPerOutcome(costPerOutcomeAnalyzer: CostPerOutcomeAnalyzer, taskDetector: TaskDetector, args: {
+    since?: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+};
+export declare function handleGetRecommendations(recommendationEngine: RecommendationEngine, args: {
+    developer?: string;
+    topN?: number;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleGetPlatformComparison(sessionStore: SessionStore, args: {
+    metric?: string;
+    weeks?: number;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleGetTeamSummary(options: {
+    teamId: string | null;
+    accountId: string;
+    nrApiKey: string | null;
+    collectorHost?: string | null;
+    since?: string;
+}): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function handleSubscribeDigest(webhookUrl: string, configFilePath: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function handleUnsubscribeDigest(configFilePath: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function handleSendDigest(weeklySummaryGenerator: WeeklySummaryGenerator, configFilePath: string): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare function handleGetPersonalInsights(summaryGenerator: WeeklySummaryGenerator, developer: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+//# sourceMappingURL=cross-session-tools.d.ts.map

package/dist/tools/cross-session-tools.d.ts.map

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