@agentlensai/mcp 0.5.0 → 0.7.0

package/dist/tools/benchmark.js

@@ -0,0 +1,378 @@
+/**
+ * agentlens_benchmark MCP Tool (Stories 4.2, 4.3)
+ *
+ * Create, list, manage, and analyze A/B benchmarks.
+ * Actions: create, list, status, results, start, complete.
+ */
+import { z } from 'zod';
+// ─── Formatting ─────────────────────────────────────────────────────
+const STATUS_ICONS = {
+    draft: '📝',
+    running: '🏃',
+    completed: '✅',
+    cancelled: '❌',
+};
+function statusIcon(status) {
+    return STATUS_ICONS[status] ?? '❓';
+}
+/**
+ * Confidence stars from the API's confidence field.
+ * Falls back to p-value thresholds matching the server (★ p<0.1, ★★ p<0.05, ★★★ p<0.01).
+ */
+function confidenceStars(pValue, confidence) {
+    if (confidence) {
+        if (confidence === 'high')
+            return ' ★★★';
+        if (confidence === 'medium')
+            return ' ★★';
+        if (confidence === 'low')
+            return ' ★';
+        return '';
+    }
+    // Fallback: match server thresholds
+    if (pValue === undefined)
+        return '';
+    if (pValue < 0.01)
+        return ' ★★★';
+    if (pValue < 0.05)
+        return ' ★★';
+    if (pValue < 0.1)
+        return ' ★';
+    return '';
+}
+/**
+ * Format a benchmark list.
+ */
+export function formatBenchmarkList(benchmarks) {
+    if (benchmarks.length === 0) {
+        return 'No benchmarks found.';
+    }
+    const lines = [];
+    lines.push(`📊 Benchmarks (${benchmarks.length})`);
+    lines.push('');
+    for (const b of benchmarks) {
+        const icon = statusIcon(b.status);
+        const variantNames = b.variants.map((v) => v.name).join(' vs ');
+        lines.push(`${icon} ${b.name} [${b.status}]`);
+        lines.push(`   ID: ${b.id}`);
+        lines.push(`   Variants: ${variantNames}`);
+        if (b.description) {
+            lines.push(`   ${b.description}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Format a created benchmark confirmation.
+ */
+export function formatBenchmarkCreated(benchmark) {
+    const lines = [];
+    lines.push(`✅ Benchmark created: ${benchmark.name}`);
+    lines.push('');
+    lines.push(`ID: ${benchmark.id}`);
+    lines.push(`Status: ${benchmark.status}`);
+    lines.push(`Variants: ${benchmark.variants.map((v) => `${v.name} (tag: ${v.tag})`).join(', ')}`);
+    if (benchmark.metrics.length > 0) {
+        lines.push(`Metrics: ${benchmark.metrics.join(', ')}`);
+    }
+    lines.push(`Min Sessions: ${benchmark.minSessions}`);
+    if (benchmark.agentId) {
+        lines.push(`Agent: ${benchmark.agentId}`);
+    }
+    lines.push('');
+    lines.push('Next steps:');
+    lines.push('1. Tag sessions with variant tags');
+    lines.push('2. Start the benchmark with action: "start"');
+    lines.push('3. Collect data, then check with action: "results"');
+    return lines.join('\n');
+}
+/**
+ * Format benchmark status/detail.
+ */
+export function formatBenchmarkStatus(benchmark) {
+    const lines = [];
+    const icon = statusIcon(benchmark.status);
+    lines.push(`${icon} Benchmark: ${benchmark.name} [${benchmark.status}]`);
+    lines.push('');
+    lines.push(`ID: ${benchmark.id}`);
+    if (benchmark.description) {
+        lines.push(`Description: ${benchmark.description}`);
+    }
+    if (benchmark.agentId) {
+        lines.push(`Agent: ${benchmark.agentId}`);
+    }
+    lines.push(`Created: ${benchmark.createdAt}`);
+    if (benchmark.startedAt)
+        lines.push(`Started: ${benchmark.startedAt}`);
+    if (benchmark.completedAt)
+        lines.push(`Completed: ${benchmark.completedAt}`);
+    lines.push('');
+    lines.push('Variants:');
+    for (const v of benchmark.variants) {
+        const count = v.sessionCount ?? 0;
+        const progress = benchmark.minSessions > 0
+            ? ` (${count}/${benchmark.minSessions})`
+            : ` (${count} sessions)`;
+        lines.push(`  • ${v.name} [${v.tag}]${progress}`);
+        if (v.description)
+            lines.push(`    ${v.description}`);
+    }
+    if (benchmark.metrics.length > 0) {
+        lines.push('');
+        lines.push(`Metrics: ${benchmark.metrics.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format benchmark results as an ASCII table.
+ */
+export function formatBenchmarkResults(results) {
+    const lines = [];
+    const icon = statusIcon(results.status);
+    lines.push(`${icon} Benchmark Results: ${results.name}`);
+    lines.push('');
+    if (results.metrics.length === 0) {
+        lines.push('No results available yet. Collect more data and try again.');
+        return lines.join('\n');
+    }
+    // Build ASCII table
+    // Collect all variant names
+    const variantNames = results.metrics[0].variants.map((v) => v.name);
+    // Header row
+    const metricColWidth = Math.max(8, ...results.metrics.map((m) => m.metric.length));
+    const variantColWidth = Math.max(12, ...variantNames.map((n) => n.length + 2));
+    const statsColWidth = 14;
+    const headerCols = ['Metric'.padEnd(metricColWidth)];
+    for (const name of variantNames) {
+        headerCols.push(name.padEnd(variantColWidth));
+    }
+    headerCols.push('p-value'.padEnd(statsColWidth));
+    headerCols.push('Result');
+    const headerLine = '| ' + headerCols.join(' | ') + ' |';
+    const separator = '|' + headerCols.map((col) => '-'.repeat(col.length + 2)).join('|') + '|';
+    lines.push(headerLine);
+    lines.push(separator);
+    // Data rows
+    for (const metric of results.metrics) {
+        const cols = [metric.metric.padEnd(metricColWidth)];
+        for (const variant of metric.variants) {
+            const val = `${variant.mean.toFixed(2)}±${variant.stddev.toFixed(2)}`;
+            cols.push(val.padEnd(variantColWidth));
+        }
+        const pStr = metric.pValue !== undefined ? metric.pValue.toFixed(4) : 'n/a';
+        cols.push(pStr.padEnd(statsColWidth));
+        let resultStr = metric.significant ? `${metric.winner ?? '?'} wins` : 'no sig. diff.';
+        resultStr += confidenceStars(metric.pValue, metric.confidence);
+        cols.push(resultStr);
+        lines.push('| ' + cols.join(' | ') + ' |');
+    }
+    lines.push('');
+    lines.push(`Confidence: ★ p<0.1  ★★ p<0.05  ★★★ p<0.01`);
+    if (results.summary) {
+        lines.push('');
+        lines.push(`Summary: ${results.summary}`);
+    }
+    return lines.join('\n');
+}
+// ─── Tool Registration ──────────────────────────────────────────────
+const variantSchema = z.object({
+    name: z.string().describe('Variant display name'),
+    tag: z.string().describe('Tag to associate sessions with this variant'),
+    description: z.string().optional().describe('Variant description'),
+});
+export function registerBenchmarkTool(server, transport) {
+    server.tool('agentlens_benchmark', `Manage A/B benchmarks: create, list, check status, get results, and control lifecycle.
+
+**When to use:** To set up controlled experiments comparing different agent configurations (models, prompts, parameters), track which variant performs better, and get statistical results.
+
+**Workflow:**
+1. \`create\` — Define a benchmark with 2+ variants and metrics
+2. Tag sessions with variant tags during data collection
+3. \`start\` — Transition benchmark to running
+4. \`status\` — Check progress (session counts per variant)
+5. \`results\` — Get statistical comparison with p-values
+6. \`complete\` — Finalize the benchmark
+
+**Actions:**
+- \`create\`: Set up a new benchmark (name, variants[], metrics[])
+- \`list\`: List benchmarks, optionally filter by status
+- \`status\`: Get benchmark detail with per-variant session counts
+- \`results\`: Get formatted comparison table with statistical analysis
+- \`start\`: Transition benchmark to running state
+- \`complete\`: Transition benchmark to completed state
+
+**Example:** agentlens_benchmark({ action: "create", name: "GPT-4o vs Claude", variants: [{name: "gpt4o", tag: "v-gpt4o"}, {name: "claude", tag: "v-claude"}], metrics: ["cost", "latency", "success_rate"] })`, {
+        action: z
+            .enum(['create', 'list', 'status', 'results', 'start', 'complete'])
+            .describe('Action to perform'),
+        // Create params
+        name: z.string().optional().describe('Benchmark name (required for create)'),
+        description: z.string().optional().describe('Benchmark description'),
+        variants: z
+            .array(variantSchema)
+            .optional()
+            .describe('Variants to compare (required for create, min 2)'),
+        metrics: z
+            .array(z.string())
+            .optional()
+            .describe('Metrics to track (e.g., ["cost", "latency", "success_rate"])'),
+        minSessions: z
+            .number()
+            .int()
+            .optional()
+            .describe('Minimum sessions per variant before results are meaningful'),
+        agentId: z.string().optional().describe('Agent ID to scope the benchmark to'),
+        // List params
+        status: z.string().optional().describe('Filter by status (for list action)'),
+        // Status/Results/Lifecycle params
+        benchmarkId: z.string().optional().describe('Benchmark ID (required for status/results/start/complete)'),
+    }, async (params) => {
+        try {
+            switch (params.action) {
+                case 'create':
+                    return await handleCreate(transport, params);
+                case 'list':
+                    return await handleList(transport, params);
+                case 'status':
+                    return await handleStatus(transport, params);
+                case 'results':
+                    return await handleResults(transport, params);
+                case 'start':
+                    return await handleStart(transport, params);
+                case 'complete':
+                    return await handleComplete(transport, params);
+                default:
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Unknown action: ${params.action}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            if (message.includes('404')) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Benchmark not found. Check the benchmark ID and try again.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+async function handleCreate(transport, params) {
+    // Validation
+    if (!params.name) {
+        return {
+            content: [{ type: 'text', text: 'Validation error: "name" is required for create action.' }],
+            isError: true,
+        };
+    }
+    if (!params.variants || params.variants.length < 2) {
+        return {
+            content: [
+                { type: 'text', text: 'Validation error: At least 2 variants are required for create action.' },
+            ],
+            isError: true,
+        };
+    }
+    const body = {
+        name: params.name,
+        variants: params.variants,
+    };
+    if (params.description)
+        body.description = params.description;
+    if (params.metrics)
+        body.metrics = params.metrics;
+    if (params.minSessions !== undefined)
+        body.minSessions = params.minSessions;
+    if (params.agentId)
+        body.agentId = params.agentId;
+    const data = (await transport.createBenchmark(body));
+    return {
+        content: [{ type: 'text', text: formatBenchmarkCreated(data) }],
+    };
+}
+async function handleList(transport, params) {
+    const data = (await transport.listBenchmarks(params.status));
+    return {
+        content: [{ type: 'text', text: formatBenchmarkList(data.benchmarks) }],
+    };
+}
+async function handleStatus(transport, params) {
+    if (!params.benchmarkId) {
+        return {
+            content: [{ type: 'text', text: 'Validation error: "benchmarkId" is required for status action.' }],
+            isError: true,
+        };
+    }
+    const data = (await transport.getBenchmark(params.benchmarkId));
+    return {
+        content: [{ type: 'text', text: formatBenchmarkStatus(data) }],
+    };
+}
+async function handleResults(transport, params) {
+    if (!params.benchmarkId) {
+        return {
+            content: [{ type: 'text', text: 'Validation error: "benchmarkId" is required for results action.' }],
+            isError: true,
+        };
+    }
+    const data = (await transport.getBenchmarkResults(params.benchmarkId));
+    return {
+        content: [{ type: 'text', text: formatBenchmarkResults(data) }],
+    };
+}
+async function handleStart(transport, params) {
+    if (!params.benchmarkId) {
+        return {
+            content: [{ type: 'text', text: 'Validation error: "benchmarkId" is required for start action.' }],
+            isError: true,
+        };
+    }
+    const data = (await transport.updateBenchmarkStatus(params.benchmarkId, 'running'));
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `🏃 Benchmark "${data.name}" is now running.\n\nTag sessions with variant tags to collect data. Check progress with action: "status".`,
+            },
+        ],
+    };
+}
+async function handleComplete(transport, params) {
+    if (!params.benchmarkId) {
+        return {
+            content: [{ type: 'text', text: 'Validation error: "benchmarkId" is required for complete action.' }],
+            isError: true,
+        };
+    }
+    const data = (await transport.updateBenchmarkStatus(params.benchmarkId, 'completed'));
+    let text = `✅ Benchmark "${data.name}" is now completed.`;
+    if (data.results) {
+        text += '\n\n' + formatBenchmarkResults(data.results);
+    }
+    return {
+        content: [{ type: 'text', text }],
+    };
+}
+//# sourceMappingURL=benchmark.js.map

package/dist/tools/benchmark.js.map

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

package/dist/tools/health.d.ts

@@ -0,0 +1,32 @@
+/**
+ * agentlens_health MCP Tool (Story 1.5)
+ *
+ * Check the health score of the current agent.
+ * Returns overall score (0-100), trend, and dimension breakdown.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+/** Type for the health score response from the API */
+interface HealthScoreResponse {
+    agentId: string;
+    overallScore: number;
+    trend: 'improving' | 'stable' | 'degrading';
+    trendDelta: number;
+    dimensions: Array<{
+        name: string;
+        score: number;
+        weight: number;
+        rawValue: number;
+        description: string;
+    }>;
+    window: {
+        from: string;
+        to: string;
+    };
+    sessionCount: number;
+    computedAt: string;
+}
+export declare function formatHealthScore(data: HealthScoreResponse): string;
+export declare function registerHealthTool(server: McpServer, transport: AgentLensTransport): void;
+export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/tools/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,sDAAsD;AACtD,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAsBnE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAwEzF"}

package/dist/tools/health.js

@@ -0,0 +1,102 @@
+/**
+ * agentlens_health MCP Tool (Story 1.5)
+ *
+ * Check the health score of the current agent.
+ * Returns overall score (0-100), trend, and dimension breakdown.
+ */
+import { z } from 'zod';
+/** Dimension display names */
+const DIMENSION_LABELS = {
+    error_rate: 'Error Rate',
+    cost_efficiency: 'Cost Efficiency',
+    tool_success: 'Tool Success',
+    latency: 'Latency',
+    completion_rate: 'Completion Rate',
+};
+/** Trend arrows */
+const TREND_ARROWS = {
+    improving: '↑',
+    stable: '→',
+    degrading: '↓',
+};
+export function formatHealthScore(data) {
+    const arrow = TREND_ARROWS[data.trend] ?? '→';
+    const deltaStr = data.trendDelta >= 0 ? `+${data.trendDelta}pts` : `${data.trendDelta}pts`;
+    const parts = [];
+    parts.push(`Health Score: ${Math.round(data.overallScore)}/100 (${arrow} ${data.trend}, ${deltaStr})`);
+    parts.push('');
+    parts.push('Dimensions:');
+    for (const dim of data.dimensions) {
+        const label = DIMENSION_LABELS[dim.name] ?? dim.name;
+        const padded = `${label}:`.padEnd(18);
+        parts.push(`  ${padded}${Math.round(dim.score)}/100 (weight: ${dim.weight.toFixed(2)})`);
+    }
+    // Format window dates (just the date portion)
+    const fromDate = data.window.from.slice(0, 10);
+    const toDate = data.window.to.slice(0, 10);
+    parts.push('');
+    parts.push(`Window: ${fromDate} to ${toDate} (${data.sessionCount} sessions)`);
+    return parts.join('\n');
+}
+export function registerHealthTool(server, transport) {
+    server.tool('agentlens_health', `Check the health score of the current agent. Returns overall score (0-100), trend, and dimension breakdown.
+
+**When to use:** To assess the current health and performance of the agent, to check if error rates or latency are degrading, or to get a quick overview of agent reliability metrics.
+
+**What it returns:** An overall health score (0-100), a trend indicator (improving/stable/degrading), and a breakdown by five dimensions: error rate, cost efficiency, tool success, latency, and completion rate.
+
+**Example:** agentlens_health({ window: 7 }) → returns health score with dimension breakdown for the last 7 days.`, {
+        window: z
+            .number()
+            .optional()
+            .describe('Rolling window in days (default: 7)'),
+    }, async ({ window }) => {
+        try {
+            const agentId = transport.getFirstActiveAgent();
+            if (!agentId) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No active session found. Start a session with agentlens_session_start first, then check health.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const data = (await transport.getHealth(agentId, window ?? 7));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatHealthScore(data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            // Check for 404 (no sessions)
+            if (message.includes('404')) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No sessions found for this agent in the specified window. Health scores require at least one completed session.',
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error checking health: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/tools/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,8BAA8B;AAC9B,MAAM,gBAAgB,GAA2B;IAC/C,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,iBAAiB;CACnC,CAAC;AAEF,mBAAmB;AACnB,MAAM,YAAY,GAA2B;IAC3C,SAAS,EAAE,GAAG;IACd,MAAM,EAAE,GAAG;IACX,SAAS,EAAE,GAAG;CACf,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAyB;IACzD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,KAAK,CAAC;IAC3F,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,GAAG,CAAC,CAAC;IACvG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE1B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;QACrD,MAAM,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3F,CAAC;IAED,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,OAAO,MAAM,KAAK,IAAI,CAAC,YAAY,YAAY,CAAC,CAAC;IAE/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,SAA6B;IACjF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB;;;;;;kHAM8G,EAC9G;QACE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qCAAqC,CAAC;KACnD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,CAAC,mBAAmB,EAAE,CAAC;YAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iGAAiG;yBACxG;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,CAAC,SAAS,CACrC,OAAO,EACP,MAAM,IAAI,CAAC,CACZ,CAAwB,CAAC;YAE1B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC;qBAC9B;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAEzE,8BAA8B;YAC9B,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iHAAiH;yBACxH;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,0BAA0B,OAAO,EAAE;qBAC1C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/optimize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * agentlens_optimize MCP Tool (Story 2.5)
+ *
+ * Provides cost optimization recommendations via the optimize endpoint.
+ * Tool name: agentlens_optimize
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+export declare function registerOptimizeTool(server: McpServer, transport: AgentLensTransport): void;
+//# sourceMappingURL=optimize.d.ts.map

package/dist/tools/optimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../src/tools/optimize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAuB1D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI,CA4C3F"}

package/dist/tools/optimize.js

@@ -0,0 +1,70 @@
+/**
+ * agentlens_optimize MCP Tool (Story 2.5)
+ *
+ * Provides cost optimization recommendations via the optimize endpoint.
+ * Tool name: agentlens_optimize
+ */
+import { z } from 'zod';
+export function registerOptimizeTool(server, transport) {
+    server.tool('agentlens_optimize', `Get cost optimization recommendations. Analyzes LLM call patterns and suggests cheaper model alternatives.
+
+**When to use:** To identify cost-saving opportunities by switching expensive models to cheaper alternatives for tasks that don't require the most capable model. Analyzes call complexity (simple/moderate/complex) and success rates.
+
+**What it returns:** A list of model switch recommendations with estimated monthly savings, confidence levels, and success rate comparisons. Sorted by potential savings.
+
+**Example:** agentlens_optimize({ period: 7 }) → returns recommendations like "Switch gpt-4o → gpt-4o-mini for SIMPLE tasks, saving $89/month".`, {
+        period: z.number().optional().describe('Analysis period in days (default: 7, max: 90)'),
+        limit: z.number().optional().describe('Max recommendations to return (default: 5, max: 50)'),
+    }, async ({ period, limit }) => {
+        try {
+            const result = (await transport.getOptimizationRecommendations({
+                period: period ?? 7,
+                limit: limit ?? 5,
+            }));
+            const text = formatOptimizationResult(result);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting optimization recommendations: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Format the optimization result as a readable text block.
+ */
+function formatOptimizationResult(result) {
+    if (result.recommendations.length === 0) {
+        if (result.analyzedCalls === 0) {
+            return '💰 Cost Optimization Recommendations\n\nNo LLM call data found for the analysis period. Start logging calls to get recommendations!';
+        }
+        return `💰 Cost Optimization Recommendations\n\nAnalyzed ${result.analyzedCalls.toLocaleString()} calls over ${result.period} days.\n\nNo recommendations? Your model usage is already optimized! 🎉`;
+    }
+    const lines = [];
+    lines.push('💰 Cost Optimization Recommendations');
+    lines.push('');
+    lines.push(`Total Potential Savings: $${result.totalPotentialSavings.toFixed(2)}/month (analyzed ${result.analyzedCalls.toLocaleString()} calls over ${result.period} days)`);
+    for (let i = 0; i < result.recommendations.length; i++) {
+        const rec = result.recommendations[i];
+        lines.push('');
+        lines.push(`${i + 1}. Switch ${rec.currentModel} → ${rec.recommendedModel} for ${rec.complexityTier.toUpperCase()} tasks`);
+        lines.push(`   Savings: $${rec.monthlySavings.toFixed(2)}/month | Confidence: ${rec.confidence.toUpperCase()} (${rec.callVolume} calls)`);
+        lines.push(`   Current success: ${(rec.currentSuccessRate * 100).toFixed(0)}% → Recommended success: ${(rec.recommendedSuccessRate * 100).toFixed(0)}%`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=optimize.js.map

package/dist/tools/optimize.js.map

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