@agentlensai/mcp 0.10.0 → 0.13.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amit Paz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/benchmark.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for agentlens_benchmark MCP tool (Stories 4.2, 4.3)
+ */
+export {};
+//# sourceMappingURL=benchmark.test.d.ts.map

package/dist/__tests__/benchmark.test.js

@@ -143,7 +143,7 @@ describe('agentlens_benchmark', () => {
     it('total tool count is 14', async () => {
         const { client } = await createTestSetup();
         const result = await client.listTools();
-        expect(result.tools).toHaveLength(17);
+        expect(result.tools).toHaveLength(24);
     });
     // ─── Create ───────────────────────────────────────────────
     it('creates a benchmark successfully', async () => {

package/dist/__tests__/capabilities.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for auto-discovery capabilities module (Feature 10, Story 10.2)
+ */
+export {};
+//# sourceMappingURL=capabilities.test.d.ts.map

package/dist/__tests__/capabilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/capabilities.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/capabilities.test.js

@@ -0,0 +1,127 @@
+/**
+ * Tests for auto-discovery capabilities module (Feature 10, Story 10.2)
+ */
+import { describe, it, expect } from 'vitest';
+import { shouldRegisterTool, TOOL_FEATURE_MAP } from '../capabilities.js';
+const ALL_FEATURES = [
+    'sessions', 'agents', 'alerts', 'analytics', 'stats',
+    'recall', 'reflect', 'optimize', 'context', 'health',
+    'replay', 'benchmarks', 'guardrails', 'discovery', 'delegation',
+    'cost-budgets', 'trust', 'lessons', 'prompts',
+];
+function opts(overrides = {}) {
+    return {
+        serverInfo: { version: '0.12.1', features: ALL_FEATURES },
+        allowlist: null,
+        denylist: null,
+        ...overrides,
+    };
+}
+describe('TOOL_FEATURE_MAP', () => {
+    it('covers 25 tools (15 existing + 10 new)', () => {
+        expect(Object.keys(TOOL_FEATURE_MAP)).toHaveLength(24);
+    });
+    it('core ingest tools have empty feature requirements', () => {
+        expect(TOOL_FEATURE_MAP.agentlens_session_start).toEqual([]);
+        expect(TOOL_FEATURE_MAP.agentlens_log_event).toEqual([]);
+        expect(TOOL_FEATURE_MAP.agentlens_session_end).toEqual([]);
+        expect(TOOL_FEATURE_MAP.agentlens_query_events).toEqual([]);
+        expect(TOOL_FEATURE_MAP.agentlens_log_llm_call).toEqual([]);
+    });
+});
+describe('shouldRegisterTool', () => {
+    // All features available
+    it('registers all tools when all features available', () => {
+        for (const toolName of Object.keys(TOOL_FEATURE_MAP)) {
+            const result = shouldRegisterTool(toolName, opts());
+            expect(result.register).toBe(true);
+        }
+    });
+    // Partial features
+    it('skips tools when required features are missing', () => {
+        const result = shouldRegisterTool('agentlens_analytics', opts({
+            serverInfo: { version: '0.12.1', features: ['sessions', 'agents'] },
+        }));
+        expect(result.register).toBe(false);
+        expect(result.reason).toBe('server missing features: analytics');
+    });
+    it('registers core tools even when features are limited', () => {
+        const result = shouldRegisterTool('agentlens_session_start', opts({
+            serverInfo: { version: '0.12.1', features: [] },
+        }));
+        expect(result.register).toBe(true);
+    });
+    // Null serverInfo (graceful fallback)
+    it('registers all tools when serverInfo is null', () => {
+        for (const toolName of Object.keys(TOOL_FEATURE_MAP)) {
+            const result = shouldRegisterTool(toolName, opts({ serverInfo: null }));
+            expect(result.register).toBe(true);
+        }
+    });
+    // Allowlist
+    it('blocks tools not in allowlist', () => {
+        const result = shouldRegisterTool('agentlens_analytics', opts({
+            allowlist: ['session_start', 'recall'],
+        }));
+        expect(result.register).toBe(false);
+        expect(result.reason).toBe('not in allowlist');
+    });
+    it('allows tools in allowlist by full name', () => {
+        const result = shouldRegisterTool('agentlens_recall', opts({
+            allowlist: ['agentlens_recall'],
+        }));
+        expect(result.register).toBe(true);
+    });
+    it('allows tools in allowlist by short name', () => {
+        const result = shouldRegisterTool('agentlens_recall', opts({
+            allowlist: ['recall'],
+        }));
+        expect(result.register).toBe(true);
+    });
+    // Denylist
+    it('blocks tools in denylist', () => {
+        const result = shouldRegisterTool('agentlens_benchmark', opts({
+            denylist: ['benchmark'],
+        }));
+        expect(result.register).toBe(false);
+        expect(result.reason).toBe('in denylist');
+    });
+    it('blocks tools in denylist by full name', () => {
+        const result = shouldRegisterTool('agentlens_benchmark', opts({
+            denylist: ['agentlens_benchmark'],
+        }));
+        expect(result.register).toBe(false);
+        expect(result.reason).toBe('in denylist');
+    });
+    it('allows tools not in denylist', () => {
+        const result = shouldRegisterTool('agentlens_recall', opts({
+            denylist: ['benchmark'],
+        }));
+        expect(result.register).toBe(true);
+    });
+    // Allowlist + denylist combo
+    it('allowlist takes priority over denylist', () => {
+        // Tool in allowlist but also in denylist
+        const result = shouldRegisterTool('agentlens_recall', opts({
+            allowlist: ['recall'],
+            denylist: ['recall'],
+        }));
+        // Allowlist check passes, then denylist blocks it
+        expect(result.register).toBe(false);
+        expect(result.reason).toBe('in denylist');
+    });
+    it('tool not in allowlist is blocked even if not in denylist', () => {
+        const result = shouldRegisterTool('agentlens_analytics', opts({
+            allowlist: ['recall'],
+            denylist: ['benchmark'],
+        }));
+        expect(result.register).toBe(false);
+        expect(result.reason).toBe('not in allowlist');
+    });
+    // Unknown tool name
+    it('registers unknown tools when no allowlist and serverInfo is null', () => {
+        const result = shouldRegisterTool('agentlens_unknown', opts({ serverInfo: null }));
+        expect(result.register).toBe(true);
+    });
+});
+//# sourceMappingURL=capabilities.test.js.map

package/dist/__tests__/capabilities.test.js.map

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

package/dist/__tests__/context.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for agentlens_context MCP tool (Story 5.3)
+ */
+export {};
+//# sourceMappingURL=context.test.d.ts.map

package/dist/__tests__/context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/context.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/context.test.js

@@ -0,0 +1,203 @@
+/**
+ * Tests for agentlens_context MCP tool (Story 5.3)
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+import { registerTools } from '../tools.js';
+import { AgentLensTransport } from '../transport.js';
+const mockFetch = vi.fn();
+beforeEach(() => {
+    vi.stubGlobal('fetch', mockFetch);
+    mockFetch.mockReset();
+});
+afterEach(() => {
+    vi.unstubAllGlobals();
+});
+function okResponse(data = {}) {
+    return new Response(JSON.stringify(data), {
+        status: 200,
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+function errorResponse(status, body) {
+    return new Response(body, { status });
+}
+async function createTestSetup() {
+    const transport = new AgentLensTransport({
+        baseUrl: 'http://localhost:3400',
+        apiKey: 'test-key',
+    });
+    const server = new McpServer({ name: 'agentlens-test', version: '0.0.0' }, { capabilities: { tools: {} } });
+    registerTools(server, transport);
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+    const client = new Client({ name: 'test-client', version: '1.0.0' });
+    await server.connect(serverTransport);
+    await client.connect(clientTransport);
+    return { server, client, transport };
+}
+describe('agentlens_context', () => {
+    it('calls the context API with correct parameters', async () => {
+        const contextResult = {
+            topic: 'deployment',
+            sessions: [
+                {
+                    sessionId: 'ses-1',
+                    agentId: 'agent-1',
+                    summary: 'Agent deployed to production',
+                    relevanceScore: 0.85,
+                    startedAt: '2024-01-01T00:00:00Z',
+                    endedAt: '2024-01-01T01:00:00Z',
+                    keyEvents: [
+                        { id: 'ev-1', eventType: 'tool_call', summary: 'tool_call: deploy()', timestamp: '2024-01-01T00:30:00Z' },
+                    ],
+                },
+            ],
+            lessons: [
+                {
+                    id: 'les-1',
+                    title: 'Always verify deploy',
+                    content: 'Check health endpoint after deploying',
+                    category: 'operations',
+                    importance: 'high',
+                    relevanceScore: 0.78,
+                },
+            ],
+            totalSessions: 1,
+        };
+        mockFetch.mockResolvedValueOnce(okResponse(contextResult));
+        const { client } = await createTestSetup();
+        const result = await client.callTool({
+            name: 'agentlens_context',
+            arguments: {
+                topic: 'deployment',
+                agentId: 'my-agent',
+                limit: 5,
+            },
+        });
+        // Verify the fetch was called with the right URL
+        expect(mockFetch).toHaveBeenCalledWith(expect.stringContaining('/api/context?'), expect.objectContaining({
+            method: 'GET',
+            headers: expect.objectContaining({
+                Authorization: 'Bearer test-key',
+            }),
+        }));
+        const fetchUrl = mockFetch.mock.calls[0][0];
+        expect(fetchUrl).toContain('topic=deployment');
+        expect(fetchUrl).toContain('agentId=my-agent');
+        expect(fetchUrl).toContain('limit=5');
+        // Verify the result contains formatted data
+        expect(result.isError).toBeUndefined();
+        const content = result.content;
+        expect(content[0].text).toContain('ses-1');
+        expect(content[0].text).toContain('deployed to production');
+        expect(content[0].text).toContain('Always verify deploy');
+    });
+    it('handles empty results gracefully', async () => {
+        mockFetch.mockResolvedValueOnce(okResponse({
+            topic: 'nonexistent',
+            sessions: [],
+            lessons: [],
+            totalSessions: 0,
+        }));
+        const { client } = await createTestSetup();
+        const result = await client.callTool({
+            name: 'agentlens_context',
+            arguments: { topic: 'nonexistent' },
+        });
+        expect(result.isError).toBeUndefined();
+        const content = result.content;
+        expect(content[0].text).toContain('No relevant context found');
+    });
+    it('returns error on API failure', async () => {
+        mockFetch.mockResolvedValueOnce(errorResponse(500, 'Internal Server Error'));
+        const { client } = await createTestSetup();
+        const result = await client.callTool({
+            name: 'agentlens_context',
+            arguments: { topic: 'test' },
+        });
+        expect(result.isError).toBe(true);
+        const content = result.content;
+        expect(content[0].text).toContain('Error retrieving context');
+    });
+    it('returns error on network failure', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('Connection refused'));
+        const { client } = await createTestSetup();
+        const result = await client.callTool({
+            name: 'agentlens_context',
+            arguments: { topic: 'test' },
+        });
+        expect(result.isError).toBe(true);
+        const content = result.content;
+        expect(content[0].text).toContain('Connection refused');
+    });
+    it('handles sessions-only results (no lessons)', async () => {
+        mockFetch.mockResolvedValueOnce(okResponse({
+            topic: 'file operations',
+            sessions: [
+                {
+                    sessionId: 'ses-1',
+                    agentId: 'agent-1',
+                    summary: 'Agent ran file operations',
+                    relevanceScore: 0.9,
+                    startedAt: '2024-01-01T00:00:00Z',
+                    keyEvents: [],
+                },
+            ],
+            lessons: [],
+            totalSessions: 1,
+        }));
+        const { client } = await createTestSetup();
+        const result = await client.callTool({
+            name: 'agentlens_context',
+            arguments: { topic: 'file operations' },
+        });
+        expect(result.isError).toBeUndefined();
+        const content = result.content;
+        expect(content[0].text).toContain('Related Sessions (1)');
+        expect(content[0].text).toContain('file operations');
+    });
+    it('handles lessons-only results (no sessions)', async () => {
+        mockFetch.mockResolvedValueOnce(okResponse({
+            topic: 'database',
+            sessions: [],
+            lessons: [
+                {
+                    id: 'les-1',
+                    title: 'Database tips',
+                    content: 'Always index your queries',
+                    category: 'performance',
+                    importance: 'normal',
+                    relevanceScore: 0.75,
+                },
+            ],
+            totalSessions: 0,
+        }));
+        const { client } = await createTestSetup();
+        const result = await client.callTool({
+            name: 'agentlens_context',
+            arguments: { topic: 'database' },
+        });
+        expect(result.isError).toBeUndefined();
+        const content = result.content;
+        expect(content[0].text).toContain('Database tips');
+        expect(content[0].text).toContain('Related Lessons (1)');
+    });
+    it('sends optional userId parameter', async () => {
+        mockFetch.mockResolvedValueOnce(okResponse({
+            topic: 'test',
+            sessions: [],
+            lessons: [],
+            totalSessions: 0,
+        }));
+        const { client } = await createTestSetup();
+        await client.callTool({
+            name: 'agentlens_context',
+            arguments: { topic: 'test', userId: 'user-123' },
+        });
+        const fetchUrl = mockFetch.mock.calls[0][0];
+        expect(fetchUrl).toContain('userId=user-123');
+    });
+});
+//# sourceMappingURL=context.test.js.map

package/dist/__tests__/context.test.js.map

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

package/dist/__tests__/guardrail-middleware.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guardrail-middleware.test.d.ts.map

package/dist/__tests__/guardrail-middleware.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrail-middleware.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/guardrail-middleware.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/guardrail-middleware.test.js

@@ -0,0 +1,107 @@
+/**
+ * Tests for MCP Guardrail Middleware (Feature 8 — Story 10) [F8-S10]
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { guardrailWrap } from '../guardrail-middleware.js';
+function mockEvaluator(result) {
+    return { evaluateContent: vi.fn().mockResolvedValue(result) };
+}
+const allowResult = {
+    decision: 'allow', matches: [], evaluationMs: 1, rulesEvaluated: 0,
+};
+const blockResult = {
+    decision: 'block', matches: [{ conditionType: 'pii_detection', patternName: 'ssn', offset: { start: 0, end: 11 }, confidence: 0.95, redactionToken: '[SSN]' }],
+    blockingRuleId: 'r1', evaluationMs: 1, rulesEvaluated: 1,
+};
+const redactResult = {
+    decision: 'redact', matches: [], redactedContent: '{"text":"[REDACTED]"}', evaluationMs: 1, rulesEvaluated: 1,
+};
+const mockHandler = vi.fn().mockResolvedValue({
+    content: [{ type: 'text', text: 'Hello world' }],
+});
+describe('guardrailWrap', () => {
+    it('passes through when no agentId', async () => {
+        const evaluator = mockEvaluator(allowResult);
+        const wrapped = guardrailWrap(mockHandler, {
+            toolName: 'test', getAgentId: () => undefined, getTenantId: () => 'default', evaluator,
+        });
+        await wrapped({ text: 'hello' });
+        expect(mockHandler).toHaveBeenCalled();
+        expect(evaluator.evaluateContent).not.toHaveBeenCalled();
+    });
+    it('allows when evaluator returns allow', async () => {
+        const evaluator = mockEvaluator(allowResult);
+        const handler = vi.fn().mockResolvedValue({ content: [{ type: 'text', text: 'ok' }] });
+        const wrapped = guardrailWrap(handler, {
+            toolName: 'test', getAgentId: () => 'a1', getTenantId: () => 'default', evaluator,
+        });
+        const result = await wrapped({ text: 'hello' });
+        expect(handler).toHaveBeenCalled();
+        expect(result.isError).toBeUndefined();
+    });
+    it('blocks on input when evaluator returns block', async () => {
+        const evaluator = mockEvaluator(blockResult);
+        const handler = vi.fn().mockResolvedValue({ content: [{ type: 'text', text: 'ok' }] });
+        const wrapped = guardrailWrap(handler, {
+            toolName: 'test', getAgentId: () => 'a1', getTenantId: () => 'default', evaluator,
+        });
+        const result = await wrapped({ text: '123-45-6789' });
+        expect(handler).not.toHaveBeenCalled();
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('blocked');
+    });
+    it('redacts input when evaluator returns redact', async () => {
+        const evaluator = mockEvaluator(redactResult);
+        const handler = vi.fn().mockResolvedValue({ content: [{ type: 'text', text: 'ok' }] });
+        const wrapped = guardrailWrap(handler, {
+            toolName: 'test', getAgentId: () => 'a1', getTenantId: () => 'default', evaluator,
+        });
+        await wrapped({ text: '123-45-6789' });
+        // Handler should be called with redacted args
+        expect(handler).toHaveBeenCalledWith({ text: '[REDACTED]' });
+    });
+    it('blocks output when evaluator returns block', async () => {
+        // Allow input, block output
+        const evaluator = {
+            evaluateContent: vi.fn()
+                .mockResolvedValueOnce(allowResult) // input scan
+                .mockResolvedValueOnce(blockResult), // output scan
+        };
+        const handler = vi.fn().mockResolvedValue({ content: [{ type: 'text', text: 'sensitive output' }] });
+        const wrapped = guardrailWrap(handler, {
+            toolName: 'test', getAgentId: () => 'a1', getTenantId: () => 'default', evaluator,
+        });
+        const result = await wrapped({ text: 'hello' });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('response blocked');
+    });
+    it('redacts output when evaluator returns redact', async () => {
+        const outputRedact = {
+            decision: 'redact', matches: [], redactedContent: 'Safe output', evaluationMs: 1, rulesEvaluated: 1,
+        };
+        const evaluator = {
+            evaluateContent: vi.fn()
+                .mockResolvedValueOnce(allowResult)
+                .mockResolvedValueOnce(outputRedact),
+        };
+        const handler = vi.fn().mockResolvedValue({ content: [{ type: 'text', text: 'sensitive' }] });
+        const wrapped = guardrailWrap(handler, {
+            toolName: 'test', getAgentId: () => 'a1', getTenantId: () => 'default', evaluator,
+        });
+        const result = await wrapped({});
+        expect(result.content[0].text).toBe('Safe output');
+    });
+    it('fails open on evaluator error', async () => {
+        const evaluator = {
+            evaluateContent: vi.fn().mockRejectedValue(new Error('timeout')),
+        };
+        const handler = vi.fn().mockResolvedValue({ content: [{ type: 'text', text: 'ok' }] });
+        const wrapped = guardrailWrap(handler, {
+            toolName: 'test', getAgentId: () => 'a1', getTenantId: () => 'default', evaluator,
+        });
+        const result = await wrapped({});
+        expect(handler).toHaveBeenCalled();
+        expect(result.content[0].text).toBe('ok');
+    });
+});
+//# sourceMappingURL=guardrail-middleware.test.js.map

package/dist/__tests__/guardrail-middleware.test.js.map

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

package/dist/__tests__/health.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for agentlens_health MCP tool (Story 1.5)
+ */
+export {};
+//# sourceMappingURL=health.test.d.ts.map

package/dist/__tests__/health.test.js

@@ -68,7 +68,7 @@ describe('agentlens_health', () => {
     it('total tool count is 14', async () => {
         const { client } = await createTestSetup();
         const result = await client.listTools();
-        expect(result.tools).toHaveLength(17);
+        expect(result.tools).toHaveLength(24);
     });
     it('returns formatted output with score, trend, and dimensions', async () => {
         mockFetch.mockResolvedValueOnce(okResponse(MOCK_HEALTH_SCORE));

package/dist/__tests__/llm-call.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=llm-call.test.d.ts.map

package/dist/__tests__/llm-call.test.js

@@ -61,7 +61,7 @@ describe('agentlens_log_llm_call registration', () => {
     it('now registers 14 tools total', async () => {
         const { client } = await createTestSetup();
         const result = await client.listTools();
-        expect(result.tools).toHaveLength(17);
+        expect(result.tools).toHaveLength(24);
     });
     it('has a description', async () => {
         const { client } = await createTestSetup();

package/dist/__tests__/optimize.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for agentlens_optimize MCP tool (Story 2.5)
+ */
+export {};
+//# sourceMappingURL=optimize.test.d.ts.map

package/dist/__tests__/optimize.test.js

@@ -50,7 +50,7 @@ describe('agentlens_optimize', () => {
     it('registers 14 tools total (11 existing + guardrails)', async () => {
         const { client } = await createTestSetup();
         const result = await client.listTools();
-        expect(result.tools).toHaveLength(17);
+        expect(result.tools).toHaveLength(24);
         const toolNames = result.tools.map((t) => t.name);
         expect(toolNames).toContain('agentlens_optimize');
     });

package/dist/__tests__/recall.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recall.test.d.ts.map

package/dist/__tests__/recall.test.js

@@ -45,10 +45,10 @@ describe('agentlens_recall registration', () => {
         const toolNames = result.tools.map((t) => t.name);
         expect(toolNames).toContain('agentlens_recall');
     });
-    it('registers 14 tools total', async () => {
+    it('registers 15 tools total', async () => {
         const { client } = await createTestSetup();
         const result = await client.listTools();
-        expect(result.tools).toHaveLength(17);
+        expect(result.tools).toHaveLength(24);
     });
     it('has a description mentioning semantic search', async () => {
         const { client } = await createTestSetup();
@@ -167,11 +167,11 @@ describe('transport.recall', () => {
             baseUrl: 'http://localhost:3400',
             apiKey: 'test-key',
         });
-        await transport.recall({ query: 'test query', scope: 'lessons', limit: 5 });
+        await transport.recall({ query: 'test query', scope: 'sessions', limit: 5 });
         const url = mockFetch.mock.calls[0][0];
         expect(url).toContain('http://localhost:3400/api/recall?');
         expect(url).toContain('query=test+query');
-        expect(url).toContain('scope=lessons');
+        expect(url).toContain('scope=sessions');
         expect(url).toContain('limit=5');
         const opts = mockFetch.mock.calls[0][1];
         expect(opts.method).toBe('GET');