@agentlensai/mcp 0.11.0 → 0.13.0

package/dist/tools/agents.js

@@ -0,0 +1,67 @@
+/**
+ * agentlens_agents MCP Tool (Feature 10, Story 10.7)
+ *
+ * List, inspect, and manage agents.
+ */
+import { z } from 'zod';
+import { formatApiError } from './error-helpers.js';
+export function registerAgentsTool(server, transport) {
+    server.tool('agentlens_agents', `List, inspect, and manage AgentLens agents.
+
+**When to use:** To see which agents are registered, check agent details and error rates, or unpause a paused agent.
+
+**Actions:**
+- \`list\`: List all agents with error rates
+- \`detail\`: Get agent detail by ID
+- \`unpause\`: Clear paused state for an agent
+
+**Example:** agentlens_agents({ action: "list" })`, {
+        action: z.enum(['list', 'detail', 'unpause']).describe('Action to perform'),
+        agentId: z.string().optional().describe('Agent ID (required for detail/unpause)'),
+        clearModelOverride: z.boolean().optional().describe('Clear model override on unpause'),
+    }, async (params) => {
+        try {
+            switch (params.action) {
+                case 'list': {
+                    const response = await transport.listAgents();
+                    if (!response.ok) {
+                        const body = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${body}`);
+                    }
+                    const data = await response.json();
+                    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+                }
+                case 'detail': {
+                    if (!params.agentId) {
+                        return { content: [{ type: 'text', text: 'Validation error: "agentId" is required for detail action.' }], isError: true };
+                    }
+                    const response = await transport.getAgent(params.agentId);
+                    if (!response.ok) {
+                        const body = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${body}`);
+                    }
+                    const data = await response.json();
+                    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+                }
+                case 'unpause': {
+                    if (!params.agentId) {
+                        return { content: [{ type: 'text', text: 'Validation error: "agentId" is required for unpause action.' }], isError: true };
+                    }
+                    const response = await transport.unpauseAgent(params.agentId, params.clearModelOverride);
+                    if (!response.ok) {
+                        const body = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${body}`);
+                    }
+                    const data = await response.json();
+                    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+                }
+                default:
+                    return { content: [{ type: 'text', text: `Unknown action: ${params.action}` }], isError: true };
+            }
+        }
+        catch (error) {
+            return formatApiError(error, 'agents');
+        }
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/tools/agents.js.map

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

package/dist/tools/alerts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * agentlens_alerts MCP Tool (Feature 10, Story 10.8)
+ *
+ * Create, list, update, delete alert rules, and view alert history.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+export declare function registerAlertsTool(server: McpServer, transport: AgentLensTransport): void;
+//# sourceMappingURL=alerts.d.ts.map

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

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

package/dist/tools/alerts.js

@@ -0,0 +1,126 @@
+/**
+ * agentlens_alerts MCP Tool (Feature 10, Story 10.8)
+ *
+ * Create, list, update, delete alert rules, and view alert history.
+ */
+import { z } from 'zod';
+import { formatApiError } from './error-helpers.js';
+export function registerAlertsTool(server, transport) {
+    server.tool('agentlens_alerts', `Manage alert rules and view alert history.
+
+**When to use:** To create alerting rules for error rates, costs, or latency thresholds; manage existing rules; or review past alert triggers.
+
+**Actions:**
+- \`list\`: List all alert rules
+- \`create\`: Create a new alert rule
+- \`update\`: Update an existing alert rule
+- \`delete\`: Delete an alert rule
+- \`history\`: View recent alert triggers
+
+**Example:** agentlens_alerts({ action: "create", name: "High error rate", condition: "error_rate_above", threshold: 0.1, windowMinutes: 60 })`, {
+        action: z.enum(['list', 'create', 'update', 'delete', 'history']).describe('Action to perform'),
+        ruleId: z.string().optional().describe('Rule ID (required for update/delete)'),
+        name: z.string().optional().describe('Alert rule name (required for create)'),
+        condition: z.string().optional().describe('Condition: error_rate_above, cost_above, latency_above (required for create)'),
+        threshold: z.number().optional().describe('Threshold value (required for create)'),
+        windowMinutes: z.number().optional().describe('Evaluation window in minutes (required for create)'),
+        scope: z.string().optional().describe('Scope: global or agentId'),
+        notifyChannels: z.array(z.string()).optional().describe('Notification channels'),
+        enabled: z.boolean().optional().describe('Enable/disable rule'),
+        limit: z.number().optional().describe('Max history results'),
+    }, async (params) => {
+        try {
+            switch (params.action) {
+                case 'list': {
+                    const response = await transport.listAlertRules();
+                    if (!response.ok) {
+                        const body = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${body}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'create': {
+                    if (!params.name)
+                        return { content: [{ type: 'text', text: 'Validation error: "name" is required for create action.' }], isError: true };
+                    if (!params.condition)
+                        return { content: [{ type: 'text', text: 'Validation error: "condition" is required for create action.' }], isError: true };
+                    if (params.threshold === undefined)
+                        return { content: [{ type: 'text', text: 'Validation error: "threshold" is required for create action.' }], isError: true };
+                    const body = {
+                        name: params.name,
+                        condition: params.condition,
+                        threshold: params.threshold,
+                    };
+                    if (params.windowMinutes !== undefined)
+                        body.windowMinutes = params.windowMinutes;
+                    if (params.scope)
+                        body.scope = params.scope;
+                    if (params.notifyChannels)
+                        body.notifyChannels = params.notifyChannels;
+                    if (params.enabled !== undefined)
+                        body.enabled = params.enabled;
+                    const response = await transport.createAlertRule(body);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'update': {
+                    if (!params.ruleId)
+                        return { content: [{ type: 'text', text: 'Validation error: "ruleId" is required for update action.' }], isError: true };
+                    const body = {};
+                    if (params.name)
+                        body.name = params.name;
+                    if (params.condition)
+                        body.condition = params.condition;
+                    if (params.threshold !== undefined)
+                        body.threshold = params.threshold;
+                    if (params.windowMinutes !== undefined)
+                        body.windowMinutes = params.windowMinutes;
+                    if (params.scope)
+                        body.scope = params.scope;
+                    if (params.notifyChannels)
+                        body.notifyChannels = params.notifyChannels;
+                    if (params.enabled !== undefined)
+                        body.enabled = params.enabled;
+                    const response = await transport.updateAlertRule(params.ruleId, body);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'delete': {
+                    if (!params.ruleId)
+                        return { content: [{ type: 'text', text: 'Validation error: "ruleId" is required for delete action.' }], isError: true };
+                    const response = await transport.deleteAlertRule(params.ruleId);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: `Alert rule ${params.ruleId} deleted.` }] };
+                }
+                case 'history': {
+                    const qp = {};
+                    if (params.limit !== undefined)
+                        qp.limit = String(params.limit);
+                    if (params.ruleId)
+                        qp.ruleId = params.ruleId;
+                    const response = await transport.getAlertHistory(qp);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                default:
+                    return { content: [{ type: 'text', text: `Unknown action: ${params.action}` }], isError: true };
+            }
+        }
+        catch (error) {
+            return formatApiError(error, 'alerts');
+        }
+    });
+}
+//# sourceMappingURL=alerts.js.map

package/dist/tools/alerts.js.map

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

package/dist/tools/analytics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * agentlens_analytics MCP Tool (Feature 10, Story 10.9)
+ *
+ * Query operational metrics, costs, agent metrics, and tool usage stats.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+export declare function registerAnalyticsTool(server: McpServer, transport: AgentLensTransport): void;
+//# sourceMappingURL=analytics.d.ts.map

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

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

package/dist/tools/analytics.js

@@ -0,0 +1,67 @@
+/**
+ * agentlens_analytics MCP Tool (Feature 10, Story 10.9)
+ *
+ * Query operational metrics, costs, agent metrics, and tool usage stats.
+ */
+import { z } from 'zod';
+import { formatApiError } from './error-helpers.js';
+export function registerAnalyticsTool(server, transport) {
+    server.tool('agentlens_analytics', `Query operational analytics: metrics, costs, agent performance, and tool usage.
+
+**When to use:** To understand system performance trends, cost breakdowns, agent activity, or tool usage patterns over time.
+
+**Actions:**
+- \`metrics\`: Get bucketed metrics with optional range/date filters
+- \`costs\`: Get cost breakdown
+- \`agents\`: Get per-agent metrics
+- \`tools\`: Get tool usage statistics
+
+**Example:** agentlens_analytics({ action: "metrics", range: "24h" })`, {
+        action: z.enum(['metrics', 'costs', 'agents', 'tools']).describe('Action to perform'),
+        range: z.string().optional().describe('Shorthand: 1h, 6h, 24h, 3d, 7d, 30d'),
+        from: z.string().optional().describe('Start date ISO'),
+        to: z.string().optional().describe('End date ISO'),
+        granularity: z.enum(['hour', 'day', 'week']).optional().describe('Bucket granularity'),
+        agentId: z.string().optional().describe('Filter by agent ID'),
+    }, async (params) => {
+        try {
+            const qp = {};
+            if (params.range)
+                qp.range = params.range;
+            if (params.from)
+                qp.from = params.from;
+            if (params.to)
+                qp.to = params.to;
+            if (params.granularity)
+                qp.granularity = params.granularity;
+            if (params.agentId)
+                qp.agentId = params.agentId;
+            let response;
+            switch (params.action) {
+                case 'metrics':
+                    response = await transport.getAnalytics(qp);
+                    break;
+                case 'costs':
+                    response = await transport.getAnalyticsCosts(qp);
+                    break;
+                case 'agents':
+                    response = await transport.getAnalyticsAgents(qp);
+                    break;
+                case 'tools':
+                    response = await transport.getAnalyticsTools(qp);
+                    break;
+                default:
+                    return { content: [{ type: 'text', text: `Unknown action: ${params.action}` }], isError: true };
+            }
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                throw new Error(`${response.status}: ${body}`);
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+        }
+        catch (error) {
+            return formatApiError(error, 'analytics');
+        }
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/tools/analytics.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * agentlens_cost_budgets MCP Tool (Feature 10, Story 10.10)
+ *
+ * Budget CRUD, status check, and anomaly detection configuration.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+export declare function registerCostBudgetsTool(server: McpServer, transport: AgentLensTransport): void;
+//# sourceMappingURL=cost-budgets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-budgets.d.ts","sourceRoot":"","sources":["../../src/tools/cost-budgets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI,CA+G9F"}

package/dist/tools/cost-budgets.js

@@ -0,0 +1,144 @@
+/**
+ * agentlens_cost_budgets MCP Tool (Feature 10, Story 10.10)
+ *
+ * Budget CRUD, status check, and anomaly detection configuration.
+ */
+import { z } from 'zod';
+import { formatApiError } from './error-helpers.js';
+export function registerCostBudgetsTool(server, transport) {
+    server.tool('agentlens_cost_budgets', `Manage cost budgets and anomaly detection.
+
+**When to use:** To create/manage spending limits, check budget utilization, or configure cost anomaly detection.
+
+**Actions:**
+- \`list\`: List all cost budgets
+- \`create\`: Create a new budget
+- \`update\`: Update an existing budget
+- \`delete\`: Delete a budget
+- \`status\`: Check spend vs limit for a budget
+- \`anomaly_config\`: Get anomaly detection configuration
+- \`anomaly_update\`: Update anomaly detection settings
+
+**Example:** agentlens_cost_budgets({ action: "create", scope: "global", period: "daily", limitUsd: 10, onBreach: "alert" })`, {
+        action: z.enum(['list', 'create', 'update', 'delete', 'status', 'anomaly_config', 'anomaly_update']).describe('Action to perform'),
+        budgetId: z.string().optional().describe('Budget ID (required for update/delete/status)'),
+        scope: z.enum(['global', 'agent']).optional().describe('Budget scope'),
+        agentId: z.string().optional().describe('Agent ID (for agent-scoped budgets)'),
+        period: z.enum(['daily', 'weekly', 'monthly']).optional().describe('Budget period'),
+        limitUsd: z.number().optional().describe('Spending limit in USD'),
+        onBreach: z.enum(['alert', 'pause', 'downgrade']).optional().describe('Action on budget breach'),
+        downgradeTargetModel: z.string().optional().describe('Target model for downgrade action'),
+        enabled: z.boolean().optional().describe('Enable/disable budget'),
+        zScoreThreshold: z.number().optional().describe('Z-score threshold for anomaly detection'),
+        lookbackDays: z.number().optional().describe('Lookback period in days for anomaly detection'),
+    }, async (params) => {
+        try {
+            switch (params.action) {
+                case 'list': {
+                    const qp = {};
+                    if (params.agentId)
+                        qp.agentId = params.agentId;
+                    if (params.scope)
+                        qp.scope = params.scope;
+                    const response = await transport.listCostBudgets(qp);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'create': {
+                    if (!params.scope)
+                        return { content: [{ type: 'text', text: 'Validation error: "scope" is required for create action.' }], isError: true };
+                    if (!params.period)
+                        return { content: [{ type: 'text', text: 'Validation error: "period" is required for create action.' }], isError: true };
+                    if (params.limitUsd === undefined)
+                        return { content: [{ type: 'text', text: 'Validation error: "limitUsd" is required for create action.' }], isError: true };
+                    if (!params.onBreach)
+                        return { content: [{ type: 'text', text: 'Validation error: "onBreach" is required for create action.' }], isError: true };
+                    const body = {
+                        scope: params.scope, period: params.period, limitUsd: params.limitUsd, onBreach: params.onBreach,
+                    };
+                    if (params.agentId)
+                        body.agentId = params.agentId;
+                    if (params.downgradeTargetModel)
+                        body.downgradeTargetModel = params.downgradeTargetModel;
+                    if (params.enabled !== undefined)
+                        body.enabled = params.enabled;
+                    const response = await transport.createCostBudget(body);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'update': {
+                    if (!params.budgetId)
+                        return { content: [{ type: 'text', text: 'Validation error: "budgetId" is required for update action.' }], isError: true };
+                    const body = {};
+                    if (params.limitUsd !== undefined)
+                        body.limitUsd = params.limitUsd;
+                    if (params.onBreach)
+                        body.onBreach = params.onBreach;
+                    if (params.enabled !== undefined)
+                        body.enabled = params.enabled;
+                    if (params.downgradeTargetModel)
+                        body.downgradeTargetModel = params.downgradeTargetModel;
+                    const response = await transport.updateCostBudget(params.budgetId, body);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'delete': {
+                    if (!params.budgetId)
+                        return { content: [{ type: 'text', text: 'Validation error: "budgetId" is required for delete action.' }], isError: true };
+                    const response = await transport.deleteCostBudget(params.budgetId);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: `Budget ${params.budgetId} deleted.` }] };
+                }
+                case 'status': {
+                    if (!params.budgetId)
+                        return { content: [{ type: 'text', text: 'Validation error: "budgetId" is required for status action.' }], isError: true };
+                    const response = await transport.getCostBudgetStatus(params.budgetId);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'anomaly_config': {
+                    const response = await transport.getAnomalyConfig();
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                case 'anomaly_update': {
+                    const body = {};
+                    if (params.zScoreThreshold !== undefined)
+                        body.zScoreThreshold = params.zScoreThreshold;
+                    if (params.lookbackDays !== undefined)
+                        body.lookbackDays = params.lookbackDays;
+                    const response = await transport.updateAnomalyConfig(body);
+                    if (!response.ok) {
+                        const b = await response.text().catch(() => '');
+                        throw new Error(`${response.status}: ${b}`);
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(await response.json(), null, 2) }] };
+                }
+                default:
+                    return { content: [{ type: 'text', text: `Unknown action: ${params.action}` }], isError: true };
+            }
+        }
+        catch (error) {
+            return formatApiError(error, 'cost-budgets');
+        }
+    });
+}
+//# sourceMappingURL=cost-budgets.js.map

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

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

package/dist/tools/error-helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Error helpers for MCP tools — consistent error formatting (Feature 10, Story 10.5)
+ *
+ * Detects 404/501 responses and appends upgrade suggestion per R13.
+ */
+export type ToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function formatApiError(error: unknown, featureName: string): ToolResult;
+//# sourceMappingURL=error-helpers.d.ts.map

package/dist/tools/error-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/error-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAY9E"}

package/dist/tools/error-helpers.js

@@ -0,0 +1,17 @@
+/**
+ * Error helpers for MCP tools — consistent error formatting (Feature 10, Story 10.5)
+ *
+ * Detects 404/501 responses and appends upgrade suggestion per R13.
+ */
+export function formatApiError(error, featureName) {
+    const message = error instanceof Error ? error.message : String(error);
+    const is404 = message.includes('404');
+    const is501 = message.includes('501');
+    let text = `Error: ${message}`;
+    if (is404 || is501) {
+        text += `\n\nThis feature may require a newer AgentLens server version. ` +
+            `The "${featureName}" API endpoint was not found.`;
+    }
+    return { content: [{ type: 'text', text }], isError: true };
+}
+//# sourceMappingURL=error-helpers.js.map

package/dist/tools/error-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-helpers.js","sourceRoot":"","sources":["../../src/tools/error-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,WAAmB;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,IAAI,GAAG,UAAU,OAAO,EAAE,CAAC;IAC/B,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACnB,IAAI,IAAI,iEAAiE;YACvE,QAAQ,WAAW,+BAA+B,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/dist/tools/lessons.d.ts

@@ -0,0 +1,9 @@
+/**
+ * agentlens_lessons MCP Tool (Feature 10, Story 10.11)
+ *
+ * CRUD for lessons learned. Uses existing transport lesson methods.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentLensTransport } from '../transport.js';
+export declare function registerLessonsTool(server: McpServer, transport: AgentLensTransport): void;
+//# sourceMappingURL=lessons.d.ts.map

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

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