@agentlensai/mcp 0.6.0 → 0.8.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/guardrails-format.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Guardrail formatting utilities for MCP tool output.
+ */
+interface GuardrailRuleInfo {
+    id: string;
+    name: string;
+    enabled: boolean;
+    conditionType: string;
+    actionType: string;
+    cooldownMinutes: number;
+    dryRun: boolean;
+}
+interface GuardrailStatusInfo {
+    rule: GuardrailRuleInfo;
+    state: {
+        lastTriggeredAt?: string;
+        triggerCount: number;
+        lastEvaluatedAt?: string;
+        currentValue?: number;
+    } | null;
+    recentTriggers: Array<{
+        triggeredAt: string;
+        conditionValue: number;
+        conditionThreshold: number;
+        actionResult?: string;
+    }>;
+}
+export declare function formatGuardrailStatus(rules: GuardrailRuleInfo[], statuses: GuardrailStatusInfo[]): string;
+export {};
+//# sourceMappingURL=guardrails-format.d.ts.map

package/dist/tools/guardrails-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails-format.d.ts","sourceRoot":"","sources":["../../src/tools/guardrails-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE;QACL,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI,CAAC;IACT,cAAc,EAAE,KAAK,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,MAAM,CA8BzG"}

package/dist/tools/guardrails-format.js

@@ -0,0 +1,30 @@
+/**
+ * Guardrail formatting utilities for MCP tool output.
+ */
+export function formatGuardrailStatus(rules, statuses) {
+    if (rules.length === 0) {
+        return 'No guardrail rules configured. Create rules via the REST API or dashboard.';
+    }
+    const parts = [];
+    parts.push(`Guardrails: ${rules.length} rule(s) configured\n`);
+    for (const status of statuses) {
+        const rule = status.rule;
+        const state = status.state;
+        const enabled = rule.enabled ? '✅ Enabled' : '❌ Disabled';
+        const dryRun = rule.dryRun ? ' [DRY RUN]' : '';
+        const triggerCount = state?.triggerCount ?? 0;
+        const lastTriggered = state?.lastTriggeredAt ? ` (last: ${state.lastTriggeredAt.slice(0, 19)})` : '';
+        parts.push(`${enabled}${dryRun} ${rule.name}`);
+        parts.push(`  Condition: ${rule.conditionType} → Action: ${rule.actionType}`);
+        parts.push(`  Triggers: ${triggerCount}${lastTriggered}`);
+        if (status.recentTriggers.length > 0) {
+            parts.push(`  Recent:`);
+            for (const t of status.recentTriggers.slice(0, 3)) {
+                parts.push(`    ${t.triggeredAt.slice(0, 19)}: value=${t.conditionValue} threshold=${t.conditionThreshold} → ${t.actionResult ?? 'unknown'}`);
+            }
+        }
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=guardrails-format.js.map

package/dist/tools/guardrails-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails-format.js","sourceRoot":"","sources":["../../src/tools/guardrails-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4BH,MAAM,UAAU,qBAAqB,CAAC,KAA0B,EAAE,QAA+B;IAC/F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,4EAA4E,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,uBAAuB,CAAC,CAAC;IAE/D,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,YAAY,GAAG,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAErG,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,aAAa,cAAc,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,eAAe,YAAY,GAAG,aAAa,EAAE,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,cAAc,cAAc,CAAC,CAAC,kBAAkB,MAAM,CAAC,CAAC,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;YAChJ,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/guardrails.d.ts

@@ -0,0 +1,10 @@
+/**
+ * agentlens_guardrails MCP Tool (v0.8.0 — Story 3.1)
+ *
+ * Check guardrail status for the current agent.
+ * Returns active rules, their status, and recent triggers.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+export declare function registerGuardrailsTool(server: McpServer, transport: AgentLensTransport): void;
+//# sourceMappingURL=guardrails.d.ts.map

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

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

package/dist/tools/guardrails.js

@@ -0,0 +1,87 @@
+/**
+ * agentlens_guardrails MCP Tool (v0.8.0 — Story 3.1)
+ *
+ * Check guardrail status for the current agent.
+ * Returns active rules, their status, and recent triggers.
+ */
+import { z } from 'zod';
+import { formatGuardrailStatus } from './guardrails-format.js';
+export function registerGuardrailsTool(server, transport) {
+    server.tool('agentlens_guardrails', `Check guardrail status for the current agent. Returns active guardrail rules, their current state, and recent trigger history.
+
+**When to use:** To check what guardrails are protecting this agent, whether any have been triggered recently, and what conditions/actions are configured.
+
+**What it returns:** A list of configured guardrail rules with their status (enabled/disabled, trigger count, last trigger time) and recent trigger history.
+
+**Example:** agentlens_guardrails({}) → returns all guardrail rules and their status.`, {
+        agentId: z
+            .string()
+            .optional()
+            .describe('Agent ID to check guardrails for (defaults to current agent)'),
+    }, async ({ agentId }) => {
+        try {
+            const effectiveAgentId = agentId ?? transport.getFirstActiveAgent();
+            if (!effectiveAgentId) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: 'No active session found. Start a session with agentlens_session_start first.',
+                        }],
+                    isError: true,
+                };
+            }
+            // Fetch guardrail rules — handle empty/error responses gracefully
+            let rules = [];
+            try {
+                const rulesResponse = await transport.getGuardrailRules();
+                rules = rulesResponse?.rules ?? [];
+            }
+            catch (fetchError) {
+                const msg = fetchError instanceof Error ? fetchError.message : 'Unknown error';
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Failed to fetch guardrail rules: ${msg}. The guardrail API may be unavailable.`,
+                        }],
+                    isError: true,
+                };
+            }
+            if (rules.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: 'No guardrail rules configured for this tenant. Use the dashboard or API to create guardrail rules.',
+                        }],
+                };
+            }
+            // Fetch status for each rule
+            const statuses = [];
+            for (const rule of rules) {
+                try {
+                    const status = await transport.getGuardrailStatus(rule.id);
+                    statuses.push(status);
+                }
+                catch {
+                    statuses.push({ rule, state: null, recentTriggers: [] });
+                }
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: formatGuardrailStatus(rules, statuses),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error checking guardrails: ${message}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/tools/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../src/tools/guardrails.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AA4B/D,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,SAA6B;IACrF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB;;;;;;sFAMkF,EAClF;QACE,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;KAC5E,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,OAAO,IAAI,SAAS,CAAC,mBAAmB,EAAE,CAAC;YAEpE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,8EAA8E;yBACrF,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,kEAAkE;YAClE,IAAI,KAAK,GAA4B,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAgD,CAAC;gBACxG,KAAK,GAAG,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC;YACrC,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC/E,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,oCAAoC,GAAG,yCAAyC;yBACvF,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,oGAAoG;yBAC3G,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,6BAA6B;YAC7B,MAAM,QAAQ,GAA8B,EAAE,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAA4B,CAAC;oBACtF,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC;qBAC7C,CAAC;aACH,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;YACzE,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,8BAA8B,OAAO,EAAE;qBAC9C,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/replay.d.ts

@@ -0,0 +1,45 @@
+/**
+ * agentlens_replay MCP Tool (Story 4.1)
+ *
+ * Replay a past session as a structured, human-readable timeline.
+ * Returns session summary + numbered, timestamped steps with event type icons.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+/** Replay response from the API */
+export interface ReplayResponse {
+    sessionId: string;
+    agentId: string;
+    status: string;
+    startedAt: string;
+    endedAt?: string;
+    durationMs?: number;
+    totalCostUsd?: number;
+    eventCounts: Record<string, number>;
+    steps: ReplayStep[];
+}
+export interface ReplayStep {
+    index: number;
+    timestamp: string;
+    eventType: string;
+    severity: string;
+    summary: string;
+    durationMs?: number;
+    costUsd?: number;
+    error?: string;
+    paired?: boolean;
+}
+/**
+ * Format the replay header (session summary).
+ */
+export declare function formatReplayHeader(data: ReplayResponse): string;
+/**
+ * Format a single replay step.
+ */
+export declare function formatReplayStep(step: ReplayStep, costSoFar?: number, errorCount?: number): string;
+/**
+ * Format the full replay output.
+ */
+export declare function formatReplay(data: ReplayResponse, summaryOnly: boolean): string;
+export declare function registerReplayTool(server: McpServer, transport: AgentLensTransport): void;
+//# sourceMappingURL=replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/tools/replay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA+BD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA0B/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAgClG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,CAuB/E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI,CA0EzF"}