@dobbyai/mcp-external 1.0.4 → 1.1.0

package/dist/__tests__/agent-mail-tools.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AgentMail MCP Tools Tests — Phase 5 + Session 3 updates
+ *
+ * Tests for agent notification system, inbox retrieval,
+ * digital identity management, dynamic registry, and markdown responses.
+ */
+export {};
+//# sourceMappingURL=agent-mail-tools.test.d.ts.map

package/dist/__tests__/agent-mail-tools.test.d.ts.map

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

package/dist/__tests__/agent-mail-tools.test.js

@@ -0,0 +1,262 @@
+/**
+ * AgentMail MCP Tools Tests — Phase 5 + Session 3 updates
+ *
+ * Tests for agent notification system, inbox retrieval,
+ * digital identity management, dynamic registry, and markdown responses.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// Mock global fetch
+const mockFetch = vi.fn();
+vi.stubGlobal('fetch', mockFetch);
+// Mock DobbyClient with request method and tenantId
+const mockClient = {
+    apiUrl: 'http://localhost:3000',
+    apiKey: 'test-api-key',
+    tenantId: 'tenant_test123',
+    request: vi.fn(),
+};
+// ============================================
+// Send Notification
+// ============================================
+describe('AgentMail: Send Notification', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        // Default: API unavailable for request (dynamic registry fallback)
+        mockClient.request.mockRejectedValue(new Error('Connection refused'));
+    });
+    it('sends notification and returns markdown response', async () => {
+        const { handleAgentMailSendNotification } = await import('../tools/agent-mail.js');
+        // API unavailable — local-only storage
+        mockFetch.mockRejectedValueOnce(new Error('Connection refused'));
+        const result = await handleAgentMailSendNotification(mockClient, {
+            to: 'dobby-backend-agent',
+            subject: 'Task completed',
+            body: 'The API endpoint has been implemented successfully.',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('## Notification Sent');
+        expect(text).toContain('**To:** dobby-backend-agent');
+        expect(text).toContain('**Type:** info');
+        expect(text).toContain('**Priority:** normal');
+        expect(text).toContain('**API Delivered:** No');
+    });
+    it('sends with custom type and priority', async () => {
+        const { handleAgentMailSendNotification } = await import('../tools/agent-mail.js');
+        mockFetch.mockRejectedValueOnce(new Error('Connection refused'));
+        const result = await handleAgentMailSendNotification(mockClient, {
+            to: 'team',
+            subject: 'Urgent: Security Vulnerability',
+            body: 'Critical security issue found in auth module.',
+            notification_type: 'alert',
+            priority: 'urgent',
+            task_id: 'task_abc123',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('**Type:** alert');
+        expect(text).toContain('**Priority:** urgent');
+        expect(text).toContain('**Task:** task_abc123');
+    });
+    it('delivers via API when available', async () => {
+        const { handleAgentMailSendNotification } = await import('../tools/agent-mail.js');
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({ id: 'api_notif_123', delivered: true }),
+        });
+        const result = await handleAgentMailSendNotification(mockClient, {
+            to: 'dobby-frontend-agent',
+            subject: 'PR Ready for Review',
+            body: 'Please review the frontend changes.',
+            notification_type: 'approval_request',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('**API Delivered:** Yes');
+        // Verify API was called with correct endpoint
+        expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/notifications', expect.objectContaining({
+            method: 'POST',
+            headers: expect.objectContaining({
+                'X-API-Key': 'test-api-key',
+            }),
+        }));
+    });
+    it('includes email_requested flag', async () => {
+        const { handleAgentMailSendNotification } = await import('../tools/agent-mail.js');
+        mockFetch.mockRejectedValueOnce(new Error('Connection refused'));
+        const result = await handleAgentMailSendNotification(mockClient, {
+            to: 'user@example.com',
+            subject: 'Status Report',
+            body: 'Weekly status update.',
+            deliver_email: true,
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('**Email Requested:** Yes');
+    });
+});
+// ============================================
+// Get Inbox
+// ============================================
+describe('AgentMail: Get Inbox', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        mockClient.request.mockRejectedValue(new Error('Connection refused'));
+    });
+    it('returns inbox from API when available', async () => {
+        const { handleAgentMailGetInbox } = await import('../tools/agent-mail.js');
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({
+                notifications: [
+                    { id: 'notif_1', subject: 'Test', read: false },
+                ],
+                total: 1,
+            }),
+        });
+        const result = await handleAgentMailGetInbox(mockClient, {});
+        const data = JSON.parse(result.content[0].text);
+        expect(data.notifications).toBeDefined();
+    });
+    it('falls back to local store with markdown format when API unavailable', async () => {
+        const { handleAgentMailGetInbox } = await import('../tools/agent-mail.js');
+        // Both fetch (inbox API) and request (registry) fail
+        mockFetch.mockRejectedValueOnce(new Error('Connection refused'));
+        const result = await handleAgentMailGetInbox(mockClient, {
+            agent_id: 'dobby-backend-agent',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('## Inbox for');
+        expect(text).toContain('**Agent:** dobby-backend-agent');
+        expect(text).toContain('**Source:** local store');
+    });
+    it('respects limit parameter', async () => {
+        const { handleAgentMailGetInbox } = await import('../tools/agent-mail.js');
+        mockFetch.mockRejectedValueOnce(new Error('Connection refused'));
+        const result = await handleAgentMailGetInbox(mockClient, {
+            limit: 5,
+        });
+        // Should not error
+        expect(result.content[0].text).toContain('## Inbox for');
+    });
+    it('includes team notifications in inbox', async () => {
+        const { handleAgentMailSendNotification, handleAgentMailGetInbox } = await import('../tools/agent-mail.js');
+        // Send a team notification first
+        mockFetch.mockRejectedValue(new Error('Connection refused'));
+        await handleAgentMailSendNotification(mockClient, {
+            to: 'team',
+            subject: 'Team Update',
+            body: 'Important team update.',
+            notification_type: 'status_report',
+        });
+        // Check inbox for team — should see team notifications
+        const result = await handleAgentMailGetInbox(mockClient, {
+            agent_id: 'team',
+            unread_only: false,
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('Team Update');
+    });
+});
+// ============================================
+// Get Identity — Dynamic Registry
+// ============================================
+describe('AgentMail: Get Identity (Dynamic Registry)', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('returns identity from API when available', async () => {
+        const { handleAgentMailGetIdentity } = await import('../tools/agent-mail.js');
+        mockClient.request.mockResolvedValueOnce({
+            data: {
+                agents: [
+                    {
+                        agent_id: 'dobby-backend-agent',
+                        display_name: 'Backend Pro',
+                        role: 'Senior Backend Dev',
+                        group: 'dev',
+                        capabilities: ['code', 'api'],
+                    },
+                ],
+            },
+        });
+        const result = await handleAgentMailGetIdentity(mockClient, {
+            agent_id: 'dobby-backend-agent',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('## Agent Identity: Backend Pro');
+        expect(text).toContain('**Agent ID:** dobby-backend-agent');
+        expect(text).toContain('**Role:** Senior Backend Dev');
+        expect(text).toContain('### Capabilities');
+    });
+    it('falls back to hardcoded defaults when API unavailable', async () => {
+        const { handleAgentMailGetIdentity } = await import('../tools/agent-mail.js');
+        // Force cache miss by using a fresh mock that always rejects
+        mockClient.request.mockRejectedValue(new Error('Connection refused'));
+        const result = await handleAgentMailGetIdentity(mockClient, {
+            agent_id: 'dobby-backend-agent',
+        });
+        expect(result.isError).toBeUndefined();
+        const text = result.content[0].text;
+        // May use cached API data or fallback — either way should have agent info
+        expect(text).toContain('**Agent ID:** dobby-backend-agent');
+        expect(text).toContain('### Capabilities');
+    });
+    it('returns error for unknown agent', async () => {
+        const { handleAgentMailGetIdentity } = await import('../tools/agent-mail.js');
+        mockClient.request.mockRejectedValueOnce(new Error('Connection refused'));
+        const result = await handleAgentMailGetIdentity(mockClient, {
+            agent_id: 'nonexistent-agent',
+        });
+        expect(result.isError).toBe(true);
+        const data = JSON.parse(result.content[0].text);
+        expect(data.error).toContain('Unknown agent');
+        expect(data.available_agents).toBeDefined();
+        expect(data.available_agents).toContain('dobby-backend-agent');
+    });
+    it('caches API results for 5 minutes', async () => {
+        const { handleAgentMailGetIdentity } = await import('../tools/agent-mail.js');
+        const apiResponse = {
+            data: {
+                agents: [
+                    { agent_id: 'dobby-chief-agent', display_name: 'Chief Cached', role: 'Cached Role', group: 'chief' },
+                ],
+            },
+        };
+        mockClient.request.mockResolvedValue(apiResponse);
+        // First call — fetches from API
+        await handleAgentMailGetIdentity(mockClient, { agent_id: 'dobby-chief-agent' });
+        // Second call — should use cache (request not called again for registry)
+        const callCountAfterFirst = mockClient.request.mock.calls.length;
+        await handleAgentMailGetIdentity(mockClient, { agent_id: 'dobby-chief-agent' });
+        // Should NOT have made another request (cached)
+        expect(mockClient.request.mock.calls.length).toBe(callCountAfterFirst);
+    });
+});
+// ============================================
+// Tool Registration
+// ============================================
+describe('AgentMail: Tool Registration', () => {
+    it('all agentmail tools are in allTools', async () => {
+        const { allTools } = await import('../tools/index.js');
+        expect(allTools.agentmail_send_notification).toBeDefined();
+        expect(allTools.agentmail_get_inbox).toBeDefined();
+        expect(allTools.agentmail_get_identity).toBeDefined();
+    });
+    it('agentmail tools have correct schemas', async () => {
+        const { agentMailTools } = await import('../tools/agent-mail.js');
+        for (const [name, tool] of Object.entries(agentMailTools)) {
+            expect(tool.name).toBe(name);
+            expect(tool.description).toBeTruthy();
+            expect(tool.inputSchema.type).toBe('object');
+            expect(tool.inputSchema.properties).toBeDefined();
+        }
+    });
+    it('agent_id field has pattern validation', async () => {
+        const { agentMailTools } = await import('../tools/agent-mail.js');
+        const identitySchema = agentMailTools.agentmail_get_identity.inputSchema;
+        expect(identitySchema.properties.agent_id.pattern).toBe('^[a-zA-Z0-9_-]+$');
+    });
+    it('total tool count includes phase 3-5 tools', async () => {
+        const { allTools } = await import('../tools/index.js');
+        const toolCount = Object.keys(allTools).length;
+        expect(toolCount).toBeGreaterThanOrEqual(65);
+    });
+});
+//# sourceMappingURL=agent-mail-tools.test.js.map

package/dist/__tests__/agent-mail-tools.test.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Tool Annotations Tests
+ *
+ * Verifies that all tools have proper MCP annotations
+ * (readOnlyHint, destructiveHint, openWorldHint).
+ */
+export {};
+//# sourceMappingURL=annotations.test.d.ts.map

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

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

package/dist/__tests__/annotations.test.js

@@ -0,0 +1,108 @@
+/**
+ * Tool Annotations Tests
+ *
+ * Verifies that all tools have proper MCP annotations
+ * (readOnlyHint, destructiveHint, openWorldHint).
+ */
+import { describe, it, expect } from 'vitest';
+import { allTools } from '../tools/index.js';
+describe('Tool Annotations', () => {
+    const tools = Object.values(allTools);
+    it('all tools have annotations object', () => {
+        for (const tool of tools) {
+            expect(tool.annotations, `Tool "${tool.name}" missing annotations`).toBeDefined();
+        }
+    });
+    it('all annotations have required fields', () => {
+        for (const tool of tools) {
+            const ann = tool.annotations;
+            expect(ann.title, `Tool "${tool.name}" missing title`).toBeDefined();
+            expect(typeof ann.readOnlyHint, `Tool "${tool.name}" readOnlyHint not boolean`).toBe('boolean');
+            expect(typeof ann.destructiveHint, `Tool "${tool.name}" destructiveHint not boolean`).toBe('boolean');
+            expect(typeof ann.openWorldHint, `Tool "${tool.name}" openWorldHint not boolean`).toBe('boolean');
+        }
+    });
+    it('no tool is both readOnly and destructive', () => {
+        for (const tool of tools) {
+            const ann = tool.annotations;
+            if (ann.readOnlyHint && ann.destructiveHint) {
+                throw new Error(`Tool "${tool.name}" cannot be both readOnly and destructive`);
+            }
+        }
+    });
+    it('read-only tools are correctly classified', () => {
+        const expectedReadOnly = [
+            'list_tasks', 'get_task', 'get_task_timeline',
+            'get_messages',
+            'get_pending_approvals',
+            'list_services',
+            'crewai_health', 'crewai_inputs', 'crewai_status',
+            'crew_validate', 'crew_status', 'crew_list',
+            'mcp_discover_tools',
+            'jira_search_issues', 'jira_get_issue', 'jira_get_comments',
+            'jira_get_transitions', 'jira_list_projects',
+            'get_ops_health_summary', 'get_service_status', 'get_active_issues', 'get_ops_audit_log',
+            'github_search_code', 'github_get_file', 'github_list_prs',
+            'github_list_issues', 'github_get_workflow_runs',
+            'mem0_search', 'mem0_list',
+            'mcp_health_check', 'mcp_connection_info',
+            'workflow_classify_task', 'workflow_agent_workload', 'workflow_assignment_rules',
+            'webeval_run_tests', 'webeval_check_health', 'webeval_test_api_endpoint', 'webeval_coverage_report',
+            'memory_graph_query', 'memory_graph_timeline', 'memory_graph_context',
+            'agentmail_get_inbox', 'agentmail_get_identity',
+            'list_schedules',
+            'moltbook_get_profile', 'moltbook_get_home_feed', 'moltbook_get_posts',
+            'moltbook_get_post', 'moltbook_get_comments', 'moltbook_search', 'moltbook_get_notifications',
+            'list_all_agents',
+            'export_policies', 'validate_policies',
+        ];
+        for (const name of expectedReadOnly) {
+            const tool = allTools[name];
+            expect(tool, `Tool "${name}" not found`).toBeDefined();
+            expect(tool.annotations?.readOnlyHint, `Tool "${name}" should be readOnly`).toBe(true);
+        }
+    });
+    it('destructive tools are correctly classified', () => {
+        const expectedDestructive = [
+            'create_task', 'update_task', 'cancel_task',
+            'send_message',
+            'approve_task', 'reject_task', 'request_changes',
+            'crewai_kickoff',
+            'crew_kickoff',
+            'jira_create_issue', 'jira_update_issue', 'jira_add_comment',
+            'jira_transition_issue', 'jira_assign_issue',
+            'acknowledge_ops_issue',
+            'github_create_pr', 'github_create_issue',
+            'mem0_store', 'mem0_delete',
+            'workflow_auto_assign',
+            'memory_graph_store',
+            'agentmail_send_notification',
+            'create_schedule', 'pause_schedule', 'delete_schedule',
+            'moltbook_update_profile', 'moltbook_create_post', 'moltbook_create_comment',
+            'moltbook_upvote_post', 'moltbook_downvote_post',
+            'import_policies', 'apply_guardrail',
+        ];
+        for (const name of expectedDestructive) {
+            const tool = allTools[name];
+            expect(tool, `Tool "${name}" not found`).toBeDefined();
+            expect(tool.annotations?.destructiveHint, `Tool "${name}" should be destructive`).toBe(true);
+        }
+    });
+    it('openWorldHint is true only for external API tools', () => {
+        const expectedOpenWorld = [
+            'exa_web_search', 'exa_find_similar', 'exa_get_contents',
+            'mcp_call_tool',
+        ];
+        const openWorldSet = new Set(expectedOpenWorld);
+        for (const tool of tools) {
+            const ann = tool.annotations;
+            if (openWorldSet.has(tool.name)) {
+                expect(ann.openWorldHint, `Tool "${tool.name}" should have openWorldHint=true`).toBe(true);
+            }
+            else {
+                expect(ann.openWorldHint, `Tool "${tool.name}" should have openWorldHint=false`).toBe(false);
+            }
+        }
+    });
+});
+//# sourceMappingURL=annotations.test.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * MCP Auth Tests
+ *
+ * Tests for OAuth proxy provider and token verifier.
+ */
+export {};
+//# sourceMappingURL=auth.test.d.ts.map

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

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

package/dist/__tests__/auth.test.js

@@ -0,0 +1,116 @@
+/**
+ * MCP Auth Tests
+ *
+ * Tests for OAuth proxy provider and token verifier.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { TokenVerifier } from '../auth/token-verifier.js';
+import { createOAuthProvider } from '../auth/oauth-provider.js';
+describe('TokenVerifier', () => {
+    let verifier;
+    beforeEach(() => {
+        verifier = new TokenVerifier('https://dobby-ai.com');
+        vi.restoreAllMocks();
+    });
+    afterEach(() => {
+        verifier.clearCache();
+    });
+    const validTokenResponse = {
+        active: true,
+        user_id: 'pu_user123',
+        org_id: 'org_abc',
+        tenant_id: 'tenant_xyz',
+        scope: 'mcp:read mcp:execute',
+        client_id: 'mcp_client1',
+        exp: Math.floor(Date.now() / 1000) + 3600,
+    };
+    it('validates a valid token against remote endpoint', async () => {
+        global.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve(validTokenResponse),
+        });
+        const authInfo = await verifier.verifyAccessToken('dobby_at_valid_token');
+        expect(authInfo.token).toBe('dobby_at_valid_token');
+        expect(authInfo.clientId).toBe('mcp_client1');
+        expect(authInfo.scopes).toEqual(['mcp:read', 'mcp:execute']);
+        expect(authInfo.extra?.org_id).toBe('org_abc');
+        expect(authInfo.extra?.tenant_id).toBe('tenant_xyz');
+    });
+    it('caches token verification results', async () => {
+        global.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve(validTokenResponse),
+        });
+        // First call hits remote
+        await verifier.verifyAccessToken('dobby_at_cached_token');
+        expect(fetch).toHaveBeenCalledTimes(1);
+        // Second call uses cache
+        await verifier.verifyAccessToken('dobby_at_cached_token');
+        expect(fetch).toHaveBeenCalledTimes(1);
+    });
+    it('throws on invalid/expired token (401)', async () => {
+        global.fetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+        });
+        await expect(verifier.verifyAccessToken('dobby_at_bad'))
+            .rejects.toThrow('Invalid or expired access token');
+    });
+    it('throws on inactive token', async () => {
+        global.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ active: false }),
+        });
+        await expect(verifier.verifyAccessToken('dobby_at_inactive'))
+            .rejects.toThrow('Token is not active');
+    });
+    it('throws when token missing org_id or tenant_id', async () => {
+        global.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ active: true, user_id: 'u1' }),
+        });
+        await expect(verifier.verifyAccessToken('dobby_at_no_context'))
+            .rejects.toThrow('Token missing org_id or tenant_id');
+    });
+    it('evicts oldest entry when cache exceeds max size', async () => {
+        global.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve(validTokenResponse),
+        });
+        // Fill cache beyond max (1000) — simplified test with a few entries
+        for (let i = 0; i < 5; i++) {
+            await verifier.verifyAccessToken(`dobby_at_token_${i}`);
+        }
+        expect(verifier.cacheSize).toBe(5);
+    });
+    it('calls correct introspection URL', async () => {
+        global.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve(validTokenResponse),
+        });
+        await verifier.verifyAccessToken('dobby_at_url_test');
+        expect(fetch).toHaveBeenCalledWith('https://dobby-ai.com/oauth/token/introspect', expect.objectContaining({
+            method: 'POST',
+            headers: expect.objectContaining({
+                'Authorization': 'Bearer dobby_at_url_test',
+            }),
+        }));
+    });
+    it('strips trailing slash from issuer URL', () => {
+        const v = new TokenVerifier('https://dobby-ai.com/');
+        // The verifier should store the URL without trailing slash
+        expect(v.issuerUrl).toBe('https://dobby-ai.com');
+    });
+});
+describe('createOAuthProvider', () => {
+    it('returns provider and tokenVerifier', () => {
+        const result = createOAuthProvider({
+            issuerUrl: 'https://dobby-ai.com',
+            mcpPublicUrl: 'https://mcp.dobby-ai.com',
+        });
+        expect(result.provider).toBeDefined();
+        expect(result.tokenVerifier).toBeDefined();
+        expect(result.tokenVerifier).toBeInstanceOf(TokenVerifier);
+    });
+});
+//# sourceMappingURL=auth.test.js.map

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

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

package/dist/__tests__/integration/protocol.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Protocol Compliance Tests
+ *
+ * Verifies JSON-RPC 2.0 compliance and MCP protocol adherence
+ * for the Dobby MCP server.
+ */
+export {};
+//# sourceMappingURL=protocol.test.d.ts.map

package/dist/__tests__/integration/protocol.test.d.ts.map

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