@fgv/ts-extras-mcp 5.1.0-47 → 5.1.0-49

package/dist/test/unit/mcp.test.js

@@ -1,494 +0,0 @@
-/*
- * Copyright (c) 2026 Erik Fortune
- *
- * 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.
- */
-// Mock the SDK-isolation seam so no live MCP server / subprocess is required. The factories
-// return controllable fakes; `makeClient` is configured per-test. The jest.mock call must
-// precede the regular imports (hoist-jest-mock).
-jest.mock('../../packlets/mcp/sdk', () => ({
-    makeClient: jest.fn(),
-    makeStdioTransport: jest.fn(() => ({ sentinel: 'stdio' })),
-    makeHttpTransport: jest.fn(() => ({ sentinel: 'http' }))
-}));
-import '@fgv/ts-utils-jest';
-import { Logging } from '@fgv/ts-utils';
-// eslint-disable-next-line @rushstack/packlets/mechanics
-import * as sdk from '../../packlets/mcp/sdk';
-import { adaptMcpTools, callMcpTool, closeMcpSession, connectMcpSession, createHttpTransport, createStdioTransport, listMcpTools } from '../../packlets/mcp';
-const mockSdk = sdk;
-function makeFakeClient(overrides = {}) {
-    return Object.assign({ connect: jest.fn(async () => undefined), getServerVersion: jest.fn(() => ({ name: 'fake-server', version: '1.2.3' })), listTools: jest.fn(async () => ({ tools: [] })), callTool: jest.fn(async () => ({ content: [] })), close: jest.fn(async () => undefined) }, overrides);
-}
-/** Connect a session backed by the given fake client (and a stdio transport). */
-async function connectWith(fake) {
-    mockSdk.makeClient.mockReturnValueOnce(fake);
-    const transport = createStdioTransport({ command: 'node' }).orThrow();
-    return (await connectMcpSession({ transport })).orThrow();
-}
-/** A foreign (non-package) handle, to exercise the loud narrowing-failure paths. */
-const FOREIGN_TRANSPORT = { transportKind: 'stdio' };
-const FOREIGN_SESSION = {
-    clientName: 'x',
-    clientVersion: 'y',
-    serverInfo: undefined
-};
-beforeEach(() => {
-    jest.clearAllMocks();
-    mockSdk.makeStdioTransport.mockReturnValue({ sentinel: 'stdio' });
-    mockSdk.makeHttpTransport.mockReturnValue({ sentinel: 'http' });
-});
-// ===========================================================================
-// Transports
-// ===========================================================================
-describe('createStdioTransport', () => {
-    test('succeeds for a valid command', () => {
-        expect(createStdioTransport({ command: 'node', args: ['x'] })).toSucceedAndSatisfy((t) => {
-            expect(t.transportKind).toBe('stdio');
-        });
-        expect(mockSdk.makeStdioTransport).toHaveBeenCalledWith(expect.objectContaining({ command: 'node', args: ['x'] }));
-    });
-    test('fails for an empty/whitespace command', () => {
-        expect(createStdioTransport({ command: '' })).toFailWith(/command must be a non-empty string/);
-        expect(createStdioTransport({ command: '   ' })).toFailWith(/command must be a non-empty string/);
-    });
-    test('fails (Result) when the SDK constructor throws', () => {
-        mockSdk.makeStdioTransport.mockImplementationOnce(() => {
-            throw new Error('spawn boom');
-        });
-        expect(createStdioTransport({ command: 'node' })).toFailWith(/createStdioTransport:.*spawn boom/);
-    });
-});
-describe('createHttpTransport', () => {
-    test('succeeds for http and https urls and forwards headers', () => {
-        expect(createHttpTransport({ url: 'http://localhost:9000/mcp' })).toSucceedAndSatisfy((t) => {
-            expect(t.transportKind).toBe('http');
-        });
-        expect(createHttpTransport({ url: 'https://example.com/mcp', headers: { authorization: 'Bearer t' } })).toSucceed();
-        expect(mockSdk.makeHttpTransport).toHaveBeenCalledWith(expect.any(URL), { authorization: 'Bearer t' });
-    });
-    test('fails for an unparseable url', () => {
-        expect(createHttpTransport({ url: 'not a url' })).toFailWith(/invalid url 'not a url'/);
-    });
-    test('fails for a non-http(s) protocol', () => {
-        expect(createHttpTransport({ url: 'ftp://example.com' })).toFailWith(/must use http or https/);
-    });
-    test('fails (Result) when the SDK constructor throws', () => {
-        mockSdk.makeHttpTransport.mockImplementationOnce(() => {
-            throw new Error('http boom');
-        });
-        expect(createHttpTransport({ url: 'http://localhost' })).toFailWith(/createHttpTransport:.*http boom/);
-    });
-});
-// ===========================================================================
-// Session lifecycle
-// ===========================================================================
-describe('connectMcpSession', () => {
-    test('fails loudly for a foreign transport handle', async () => {
-        expect(await connectMcpSession({ transport: FOREIGN_TRANSPORT })).toFailWith(/invalid MCP transport/);
-    });
-    test('connects and reports server identity, logging when a logger is supplied', async () => {
-        const logger = new Logging.InMemoryLogger('all');
-        const fake = makeFakeClient();
-        mockSdk.makeClient.mockReturnValueOnce(fake);
-        const transport = createStdioTransport({ command: 'node' }).orThrow();
-        expect(await connectMcpSession({ transport, clientName: 'me', clientVersion: '0.0.1', logger })).toSucceedAndSatisfy((session) => {
-            expect(session.clientName).toBe('me');
-            expect(session.clientVersion).toBe('0.0.1');
-            expect(session.serverInfo).toEqual({ name: 'fake-server', version: '1.2.3' });
-        });
-        expect(mockSdk.makeClient).toHaveBeenCalledWith('me', '0.0.1');
-        expect(fake.connect).toHaveBeenCalledTimes(1);
-        expect(logger.logged.join('\n')).toMatch(/connected to server fake-server@1.2.3/);
-    });
-    test('connects with default identity and no server info, no logger', async () => {
-        const fake = makeFakeClient({ getServerVersion: jest.fn(() => undefined) });
-        mockSdk.makeClient.mockReturnValueOnce(fake);
-        const transport = createStdioTransport({ command: 'node' }).orThrow();
-        expect(await connectMcpSession({ transport })).toSucceedAndSatisfy((session) => {
-            expect(session.clientName).toBe('@fgv/ts-extras-mcp');
-            expect(session.serverInfo).toBeUndefined();
-        });
-    });
-    test('logs the no-identity case when a logger is supplied', async () => {
-        const logger = new Logging.InMemoryLogger('all');
-        const fake = makeFakeClient({ getServerVersion: jest.fn(() => undefined) });
-        mockSdk.makeClient.mockReturnValueOnce(fake);
-        const transport = createStdioTransport({ command: 'node' }).orThrow();
-        expect(await connectMcpSession({ transport, logger })).toSucceed();
-        expect(logger.logged.join('\n')).toMatch(/connected \(server did not report identity\)/);
-    });
-    test('fails when the connect handshake throws', async () => {
-        const fake = makeFakeClient({
-            connect: jest.fn(async () => {
-                throw new Error('handshake refused');
-            })
-        });
-        mockSdk.makeClient.mockReturnValueOnce(fake);
-        const transport = createStdioTransport({ command: 'node' }).orThrow();
-        expect(await connectMcpSession({ transport })).toFailWith(/connectMcpSession:.*handshake refused/);
-    });
-});
-describe('closeMcpSession', () => {
-    test('fails loudly for a foreign session handle', async () => {
-        expect(await closeMcpSession(FOREIGN_SESSION)).toFailWith(/invalid MCP session/);
-    });
-    test('closes a connected session', async () => {
-        const fake = makeFakeClient();
-        const session = await connectWith(fake);
-        expect(await closeMcpSession(session)).toSucceedWith(true);
-        expect(fake.close).toHaveBeenCalledTimes(1);
-    });
-    test('fails when close throws', async () => {
-        const fake = makeFakeClient({
-            close: jest.fn(async () => {
-                throw new Error('already closed');
-            })
-        });
-        const session = await connectWith(fake);
-        expect(await closeMcpSession(session)).toFailWith(/closeMcpSession:.*already closed/);
-    });
-});
-// ===========================================================================
-// Tool discovery + invocation
-// ===========================================================================
-describe('listMcpTools', () => {
-    test('fails loudly for a foreign session handle', async () => {
-        expect(await listMcpTools(FOREIGN_SESSION)).toFailWith(/invalid MCP session/);
-    });
-    test('returns a single-page catalog', async () => {
-        const fake = makeFakeClient({
-            listTools: jest.fn(async () => ({
-                tools: [{ name: 'a', description: 'tool a', inputSchema: { type: 'object' } }]
-            }))
-        });
-        const session = await connectWith(fake);
-        expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-            expect(tools).toHaveLength(1);
-            expect(tools[0]).toEqual({ name: 'a', description: 'tool a', inputSchema: { type: 'object' } });
-        });
-    });
-    test('follows nextCursor across pages', async () => {
-        const listTools = jest
-            .fn()
-            .mockResolvedValueOnce({ tools: [{ name: 'a', inputSchema: { type: 'object' } }], nextCursor: 'p2' })
-            .mockResolvedValueOnce({ tools: [{ name: 'b', inputSchema: { type: 'object' } }] });
-        const fake = makeFakeClient({ listTools });
-        const session = await connectWith(fake);
-        expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-            expect(tools.map((t) => t.name)).toEqual(['a', 'b']);
-        });
-        expect(listTools).toHaveBeenNthCalledWith(1, undefined);
-        expect(listTools).toHaveBeenNthCalledWith(2, { cursor: 'p2' });
-    });
-    test('coerces a missing/invalid inputSchema to null and a missing description to undefined', async () => {
-        const fake = makeFakeClient({
-            listTools: jest.fn(async () => ({ tools: [{ name: 'noschema' }] }))
-        });
-        const session = await connectWith(fake);
-        expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-            expect(tools[0]).toEqual({ name: 'noschema', description: undefined, inputSchema: null });
-        });
-    });
-    test('fails when listTools throws', async () => {
-        const fake = makeFakeClient({
-            listTools: jest.fn(async () => {
-                throw new Error('protocol error');
-            })
-        });
-        const session = await connectWith(fake);
-        expect(await listMcpTools(session)).toFailWith(/listMcpTools:.*protocol error/);
-    });
-});
-describe('callMcpTool', () => {
-    const args = { q: 'hi' };
-    test('fails loudly for a foreign session handle', async () => {
-        expect(await callMcpTool(FOREIGN_SESSION, 'a', args)).toFailWith(/invalid MCP session/);
-    });
-    test('concatenates text blocks', async () => {
-        const fake = makeFakeClient({
-            callTool: jest.fn(async () => ({
-                content: [
-                    { type: 'text', text: 'line one' },
-                    { type: 'text', text: 'line two' }
-                ]
-            }))
-        });
-        const session = await connectWith(fake);
-        expect(await callMcpTool(session, 'a', args)).toSucceedWith({
-            content: 'line one\nline two'
-        });
-        expect(fake.callTool).toHaveBeenCalledWith({ name: 'a', arguments: args });
-    });
-    test('summarizes non-text blocks', async () => {
-        const fake = makeFakeClient({
-            callTool: jest.fn(async () => ({
-                content: [
-                    { type: 'text', text: 'caption' },
-                    { type: 'image', data: 'base64==' }
-                ]
-            }))
-        });
-        const session = await connectWith(fake);
-        expect(await callMcpTool(session, 'a', args)).toSucceedWith({
-            content: 'caption\n[image block]'
-        });
-    });
-    test('projects an empty/absent content list to an empty string', async () => {
-        const fake = makeFakeClient({ callTool: jest.fn(async () => ({})) });
-        const session = await connectWith(fake);
-        expect(await callMcpTool(session, 'a', args)).toSucceedWith({ content: '' });
-    });
-    test('maps isError:true to a Failure carrying the projected content', async () => {
-        const fake = makeFakeClient({
-            callTool: jest.fn(async () => ({ content: [{ type: 'text', text: 'bad input' }], isError: true }))
-        });
-        const session = await connectWith(fake);
-        expect(await callMcpTool(session, 'a', args)).toFailWith(/^bad input$/);
-    });
-    test('maps isError:true with no content to a generic error', async () => {
-        const fake = makeFakeClient({ callTool: jest.fn(async () => ({ isError: true })) });
-        const session = await connectWith(fake);
-        expect(await callMcpTool(session, 'broken', args)).toFailWith(/tool 'broken' reported an error/);
-    });
-    test('fails when callTool throws', async () => {
-        const fake = makeFakeClient({
-            callTool: jest.fn(async () => {
-                throw new Error('timeout');
-            })
-        });
-        const session = await connectWith(fake);
-        expect(await callMcpTool(session, 'a', args)).toFailWith(/callMcpTool 'a':.*timeout/);
-    });
-});
-// ===========================================================================
-// adaptMcpTools — the headline (Constraint 1)
-// ===========================================================================
-describe('adaptMcpTools', () => {
-    const goodSchema = {
-        type: 'object',
-        properties: { q: { type: 'string' } },
-        required: ['q']
-    };
-    // `pattern` is outside the JsonSchema.fromJson supported subset → fromJson fails with a pointer.
-    const forbiddenSchema = {
-        type: 'object',
-        properties: { name: { type: 'string', pattern: '^a' } }
-    };
-    function mixedCatalogClient() {
-        return makeFakeClient({
-            listTools: jest.fn(async () => ({
-                tools: [
-                    { name: 'good', description: 'a good tool', inputSchema: goodSchema },
-                    { name: 'forbidden', inputSchema: forbiddenSchema },
-                    { name: 'nonobject', description: 'bad', inputSchema: 'not-a-schema' }
-                ]
-            }))
-        });
-    }
-    test('propagates a tool-discovery failure', async () => {
-        const fake = makeFakeClient({
-            listTools: jest.fn(async () => {
-                throw new Error('discovery down');
-            })
-        });
-        const session = await connectWith(fake);
-        expect(await adaptMcpTools(session)).toFailWith(/adaptMcpTools:.*discovery down/);
-    });
-    test('adapts good tools and surfaces skipped tools structurally + NOISY warn', async () => {
-        const logger = new Logging.InMemoryLogger('all');
-        const session = await connectWith(mixedCatalogClient());
-        expect(await adaptMcpTools(session, { logger })).toSucceedAndSatisfy((result) => {
-            var _a, _b, _c, _d;
-            expect(result.tools).toHaveLength(1);
-            expect(result.tools[0].config.name).toBe('good');
-            expect(result.tools[0].config.description).toBe('a good tool');
-            expect(result.skipped).toHaveLength(2);
-            const byName = new Map(result.skipped.map((s) => [s.name, s]));
-            expect((_a = byName.get('forbidden')) === null || _a === void 0 ? void 0 : _a.reason).toMatch(/pattern/);
-            expect((_b = byName.get('forbidden')) === null || _b === void 0 ? void 0 : _b.schema).toEqual(forbiddenSchema);
-            expect((_c = byName.get('nonobject')) === null || _c === void 0 ? void 0 : _c.reason).toMatch(/not a JSON object/);
-            expect((_d = byName.get('nonobject')) === null || _d === void 0 ? void 0 : _d.schema).toBe('not-a-schema');
-        });
-        // NOISY warn: tool name + pointer reason + the raw failing schema verbatim.
-        const warned = logger.logged.join('\n');
-        expect(warned).toMatch(/skipping tool 'forbidden'/);
-        expect(warned).toMatch(/pattern/);
-        expect(warned).toContain(JSON.stringify(forbiddenSchema));
-        expect(warned).toMatch(/skipping tool 'nonobject'/);
-    });
-    test('surfaces skips structurally even without a logger', async () => {
-        const session = await connectWith(mixedCatalogClient());
-        expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result) => {
-            expect(result.tools).toHaveLength(1);
-            expect(result.skipped).toHaveLength(2);
-        });
-    });
-    test('falls back to the tool name when no description is provided', async () => {
-        const fake = makeFakeClient({
-            listTools: jest.fn(async () => ({ tools: [{ name: 'nodesc', inputSchema: goodSchema }] }))
-        });
-        const session = await connectWith(fake);
-        expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result) => {
-            expect(result.tools[0].config.description).toBe('nodesc');
-        });
-    });
-    describe('adapted tool execute', () => {
-        async function adaptGood(callTool) {
-            const fake = makeFakeClient({
-                listTools: jest.fn(async () => ({ tools: [{ name: 'good', inputSchema: goodSchema }] })),
-                callTool
-            });
-            const session = await connectWith(fake);
-            const result = (await adaptMcpTools(session)).orThrow();
-            return result.tools[0].execute;
-        }
-        test('forwards validated args to callMcpTool and returns the projected content', async () => {
-            const callTool = jest.fn(async () => ({ content: [{ type: 'text', text: 'tool output' }] }));
-            const execute = await adaptGood(callTool);
-            expect(await execute({ q: 'hello' })).toSucceedWith('tool output');
-            expect(callTool).toHaveBeenCalledWith({ name: 'good', arguments: { q: 'hello' } });
-        });
-        test('fails when the model supplies non-object arguments', async () => {
-            const callTool = jest.fn();
-            const execute = await adaptGood(callTool);
-            expect(await execute('not-an-object')).toFailWith(/tool 'good': arguments must be a JSON object/);
-            expect(callTool).not.toHaveBeenCalled();
-        });
-        test('propagates an MCP tool error as a Failure', async () => {
-            const callTool = jest.fn(async () => ({ content: [{ type: 'text', text: 'denied' }], isError: true }));
-            const execute = await adaptGood(callTool);
-            expect(await execute({ q: 'hello' })).toFailWith(/denied/);
-        });
-    });
-    // ==========================================================================
-    // C2 — MCP Tool.annotations passthrough (normalized, never raw)
-    // ==========================================================================
-    describe('annotations passthrough (C2)', () => {
-        const goodSchema2 = { type: 'object', properties: { q: { type: 'string' } }, required: ['q'] };
-        test('all five hints round-trip onto descriptor.annotations and config.annotations', async () => {
-            const annotations = {
-                title: 'Recall Memory',
-                readOnlyHint: true,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false
-            };
-            const fake = makeFakeClient({
-                listTools: jest.fn(async () => ({
-                    tools: [{ name: 'recall', description: 'r', inputSchema: goodSchema2, annotations }]
-                }))
-            });
-            const session = await connectWith(fake);
-            expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-                expect(tools[0].annotations).toEqual(annotations);
-            });
-            const session2 = await connectWith(makeFakeClient({
-                listTools: jest.fn(async () => ({
-                    tools: [{ name: 'recall', description: 'r', inputSchema: goodSchema2, annotations }]
-                }))
-            }));
-            expect(await adaptMcpTools(session2)).toSucceedAndSatisfy((result) => {
-                expect(result.tools[0].config.annotations).toEqual(annotations);
-            });
-        });
-        test('a tool with no annotations leaves the field absent', async () => {
-            const fake = makeFakeClient({
-                listTools: jest.fn(async () => ({ tools: [{ name: 'plain', inputSchema: goodSchema2 }] }))
-            });
-            const session = await connectWith(fake);
-            expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-                expect(tools[0]).not.toHaveProperty('annotations');
-            });
-            const session2 = await connectWith(makeFakeClient({
-                listTools: jest.fn(async () => ({ tools: [{ name: 'plain', inputSchema: goodSchema2 }] }))
-            }));
-            expect(await adaptMcpTools(session2)).toSucceedAndSatisfy((result) => {
-                expect(result.tools[0].config).not.toHaveProperty('annotations');
-            });
-        });
-        test('a malformed annotations blob is normalized (known fields kept, junk dropped), never raw-propagated', async () => {
-            // readOnlyHint is the wrong type (dropped); bogusField is unknown (dropped); title is valid (kept).
-            const rawAnnotations = {
-                title: 'Keep Me',
-                readOnlyHint: 'yes-please',
-                destructiveHint: true,
-                bogusField: { nested: 42 }
-            };
-            const fake = makeFakeClient({
-                listTools: jest.fn(async () => ({
-                    tools: [{ name: 'messy', inputSchema: goodSchema2, annotations: rawAnnotations }]
-                }))
-            });
-            const session = await connectWith(fake);
-            expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-                // Only the well-typed known fields survive; the malformed readOnlyHint and unknown
-                // bogusField are dropped; the raw blob is never propagated.
-                expect(tools[0].annotations).toEqual({ title: 'Keep Me', destructiveHint: true });
-                expect(tools[0].annotations).not.toHaveProperty('readOnlyHint');
-                expect(tools[0].annotations).not.toHaveProperty('bogusField');
-            });
-        });
-        test('an all-junk annotations blob normalizes to an absent field (not an empty object)', async () => {
-            const fake = makeFakeClient({
-                listTools: jest.fn(async () => ({
-                    tools: [
-                        { name: 'junk', inputSchema: goodSchema2, annotations: { unknownOnly: 1, readOnlyHint: 3 } }
-                    ]
-                }))
-            });
-            const session = await connectWith(fake);
-            expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-                expect(tools[0]).not.toHaveProperty('annotations');
-            });
-        });
-        test('a non-object annotations value is dropped', async () => {
-            const fake = makeFakeClient({
-                listTools: jest.fn(async () => ({
-                    tools: [{ name: 'weird', inputSchema: goodSchema2, annotations: 'not-an-object' }]
-                }))
-            });
-            const session = await connectWith(fake);
-            expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
-                expect(tools[0]).not.toHaveProperty('annotations');
-            });
-        });
-        test('the skipped-tool path is unaffected by annotations', async () => {
-            // A tool with annotations but an unsupported inputSchema is still skipped; annotations do
-            // not rescue it or leak onto the skip record.
-            const forbidden = {
-                type: 'object',
-                properties: { name: { type: 'string', pattern: '^a' } }
-            };
-            const fake = makeFakeClient({
-                listTools: jest.fn(async () => ({
-                    tools: [{ name: 'blocked', inputSchema: forbidden, annotations: { destructiveHint: true } }]
-                }))
-            });
-            const session = await connectWith(fake);
-            expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result) => {
-                expect(result.tools).toHaveLength(0);
-                expect(result.skipped).toHaveLength(1);
-                expect(result.skipped[0].name).toBe('blocked');
-                expect(result.skipped[0]).not.toHaveProperty('annotations');
-            });
-        });
-    });
-});
-//# sourceMappingURL=mcp.test.js.map

package/dist/test/unit/mcp.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp.test.js","sourceRoot":"","sources":["../../../src/test/unit/mcp.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n// Mock the SDK-isolation seam so no live MCP server / subprocess is required. The factories\n// return controllable fakes; `makeClient` is configured per-test. The jest.mock call must\n// precede the regular imports (hoist-jest-mock).\njest.mock('../../packlets/mcp/sdk', () => ({\n  makeClient: jest.fn(),\n  makeStdioTransport: jest.fn(() => ({ sentinel: 'stdio' })),\n  makeHttpTransport: jest.fn(() => ({ sentinel: 'http' }))\n}));\n\nimport '@fgv/ts-utils-jest';\nimport { Logging, type Result } from '@fgv/ts-utils';\nimport { type JsonObject, type JsonValue } from '@fgv/ts-json-base';\n\n// eslint-disable-next-line @rushstack/packlets/mechanics\nimport * as sdk from '../../packlets/mcp/sdk';\nimport {\n  type IAdaptMcpToolsResult,\n  type IMcpSession,\n  type IMcpToolDescriptor,\n  type IMcpTransport,\n  adaptMcpTools,\n  callMcpTool,\n  closeMcpSession,\n  connectMcpSession,\n  createHttpTransport,\n  createStdioTransport,\n  listMcpTools\n} from '../../packlets/mcp';\n\nconst mockSdk = sdk as jest.Mocked<typeof sdk>;\n\ninterface IFakeClient {\n  connect: jest.Mock;\n  getServerVersion: jest.Mock;\n  listTools: jest.Mock;\n  callTool: jest.Mock;\n  close: jest.Mock;\n}\n\nfunction makeFakeClient(overrides: Partial<IFakeClient> = {}): IFakeClient {\n  return {\n    connect: jest.fn(async () => undefined),\n    getServerVersion: jest.fn(() => ({ name: 'fake-server', version: '1.2.3' })),\n    listTools: jest.fn(async () => ({ tools: [] })),\n    callTool: jest.fn(async () => ({ content: [] })),\n    close: jest.fn(async () => undefined),\n    ...overrides\n  };\n}\n\n/** Connect a session backed by the given fake client (and a stdio transport). */\nasync function connectWith(fake: IFakeClient): Promise<IMcpSession> {\n  mockSdk.makeClient.mockReturnValueOnce(fake as unknown as sdk.ISdkClient);\n  const transport = createStdioTransport({ command: 'node' }).orThrow();\n  return (await connectMcpSession({ transport })).orThrow();\n}\n\n/** A foreign (non-package) handle, to exercise the loud narrowing-failure paths. */\nconst FOREIGN_TRANSPORT = { transportKind: 'stdio' } as unknown as IMcpTransport;\nconst FOREIGN_SESSION = {\n  clientName: 'x',\n  clientVersion: 'y',\n  serverInfo: undefined\n} as unknown as IMcpSession;\n\nbeforeEach(() => {\n  jest.clearAllMocks();\n  mockSdk.makeStdioTransport.mockReturnValue({ sentinel: 'stdio' } as unknown as sdk.ISdkTransport);\n  mockSdk.makeHttpTransport.mockReturnValue({ sentinel: 'http' } as unknown as sdk.ISdkTransport);\n});\n\n// ===========================================================================\n// Transports\n// ===========================================================================\n\ndescribe('createStdioTransport', () => {\n  test('succeeds for a valid command', () => {\n    expect(createStdioTransport({ command: 'node', args: ['x'] })).toSucceedAndSatisfy((t: IMcpTransport) => {\n      expect(t.transportKind).toBe('stdio');\n    });\n    expect(mockSdk.makeStdioTransport).toHaveBeenCalledWith(\n      expect.objectContaining({ command: 'node', args: ['x'] })\n    );\n  });\n\n  test('fails for an empty/whitespace command', () => {\n    expect(createStdioTransport({ command: '' })).toFailWith(/command must be a non-empty string/);\n    expect(createStdioTransport({ command: '   ' })).toFailWith(/command must be a non-empty string/);\n  });\n\n  test('fails (Result) when the SDK constructor throws', () => {\n    mockSdk.makeStdioTransport.mockImplementationOnce(() => {\n      throw new Error('spawn boom');\n    });\n    expect(createStdioTransport({ command: 'node' })).toFailWith(/createStdioTransport:.*spawn boom/);\n  });\n});\n\ndescribe('createHttpTransport', () => {\n  test('succeeds for http and https urls and forwards headers', () => {\n    expect(createHttpTransport({ url: 'http://localhost:9000/mcp' })).toSucceedAndSatisfy(\n      (t: IMcpTransport) => {\n        expect(t.transportKind).toBe('http');\n      }\n    );\n    expect(\n      createHttpTransport({ url: 'https://example.com/mcp', headers: { authorization: 'Bearer t' } })\n    ).toSucceed();\n    expect(mockSdk.makeHttpTransport).toHaveBeenCalledWith(expect.any(URL), { authorization: 'Bearer t' });\n  });\n\n  test('fails for an unparseable url', () => {\n    expect(createHttpTransport({ url: 'not a url' })).toFailWith(/invalid url 'not a url'/);\n  });\n\n  test('fails for a non-http(s) protocol', () => {\n    expect(createHttpTransport({ url: 'ftp://example.com' })).toFailWith(/must use http or https/);\n  });\n\n  test('fails (Result) when the SDK constructor throws', () => {\n    mockSdk.makeHttpTransport.mockImplementationOnce(() => {\n      throw new Error('http boom');\n    });\n    expect(createHttpTransport({ url: 'http://localhost' })).toFailWith(/createHttpTransport:.*http boom/);\n  });\n});\n\n// ===========================================================================\n// Session lifecycle\n// ===========================================================================\n\ndescribe('connectMcpSession', () => {\n  test('fails loudly for a foreign transport handle', async () => {\n    expect(await connectMcpSession({ transport: FOREIGN_TRANSPORT })).toFailWith(/invalid MCP transport/);\n  });\n\n  test('connects and reports server identity, logging when a logger is supplied', async () => {\n    const logger = new Logging.InMemoryLogger('all');\n    const fake = makeFakeClient();\n    mockSdk.makeClient.mockReturnValueOnce(fake as unknown as sdk.ISdkClient);\n    const transport = createStdioTransport({ command: 'node' }).orThrow();\n\n    expect(\n      await connectMcpSession({ transport, clientName: 'me', clientVersion: '0.0.1', logger })\n    ).toSucceedAndSatisfy((session: IMcpSession) => {\n      expect(session.clientName).toBe('me');\n      expect(session.clientVersion).toBe('0.0.1');\n      expect(session.serverInfo).toEqual({ name: 'fake-server', version: '1.2.3' });\n    });\n    expect(mockSdk.makeClient).toHaveBeenCalledWith('me', '0.0.1');\n    expect(fake.connect).toHaveBeenCalledTimes(1);\n    expect(logger.logged.join('\\n')).toMatch(/connected to server fake-server@1.2.3/);\n  });\n\n  test('connects with default identity and no server info, no logger', async () => {\n    const fake = makeFakeClient({ getServerVersion: jest.fn(() => undefined) });\n    mockSdk.makeClient.mockReturnValueOnce(fake as unknown as sdk.ISdkClient);\n    const transport = createStdioTransport({ command: 'node' }).orThrow();\n\n    expect(await connectMcpSession({ transport })).toSucceedAndSatisfy((session: IMcpSession) => {\n      expect(session.clientName).toBe('@fgv/ts-extras-mcp');\n      expect(session.serverInfo).toBeUndefined();\n    });\n  });\n\n  test('logs the no-identity case when a logger is supplied', async () => {\n    const logger = new Logging.InMemoryLogger('all');\n    const fake = makeFakeClient({ getServerVersion: jest.fn(() => undefined) });\n    mockSdk.makeClient.mockReturnValueOnce(fake as unknown as sdk.ISdkClient);\n    const transport = createStdioTransport({ command: 'node' }).orThrow();\n\n    expect(await connectMcpSession({ transport, logger })).toSucceed();\n    expect(logger.logged.join('\\n')).toMatch(/connected \\(server did not report identity\\)/);\n  });\n\n  test('fails when the connect handshake throws', async () => {\n    const fake = makeFakeClient({\n      connect: jest.fn(async () => {\n        throw new Error('handshake refused');\n      })\n    });\n    mockSdk.makeClient.mockReturnValueOnce(fake as unknown as sdk.ISdkClient);\n    const transport = createStdioTransport({ command: 'node' }).orThrow();\n\n    expect(await connectMcpSession({ transport })).toFailWith(/connectMcpSession:.*handshake refused/);\n  });\n});\n\ndescribe('closeMcpSession', () => {\n  test('fails loudly for a foreign session handle', async () => {\n    expect(await closeMcpSession(FOREIGN_SESSION)).toFailWith(/invalid MCP session/);\n  });\n\n  test('closes a connected session', async () => {\n    const fake = makeFakeClient();\n    const session = await connectWith(fake);\n    expect(await closeMcpSession(session)).toSucceedWith(true);\n    expect(fake.close).toHaveBeenCalledTimes(1);\n  });\n\n  test('fails when close throws', async () => {\n    const fake = makeFakeClient({\n      close: jest.fn(async () => {\n        throw new Error('already closed');\n      })\n    });\n    const session = await connectWith(fake);\n    expect(await closeMcpSession(session)).toFailWith(/closeMcpSession:.*already closed/);\n  });\n});\n\n// ===========================================================================\n// Tool discovery + invocation\n// ===========================================================================\n\ndescribe('listMcpTools', () => {\n  test('fails loudly for a foreign session handle', async () => {\n    expect(await listMcpTools(FOREIGN_SESSION)).toFailWith(/invalid MCP session/);\n  });\n\n  test('returns a single-page catalog', async () => {\n    const fake = makeFakeClient({\n      listTools: jest.fn(async () => ({\n        tools: [{ name: 'a', description: 'tool a', inputSchema: { type: 'object' } }]\n      }))\n    });\n    const session = await connectWith(fake);\n    expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n      expect(tools).toHaveLength(1);\n      expect(tools[0]).toEqual({ name: 'a', description: 'tool a', inputSchema: { type: 'object' } });\n    });\n  });\n\n  test('follows nextCursor across pages', async () => {\n    const listTools = jest\n      .fn()\n      .mockResolvedValueOnce({ tools: [{ name: 'a', inputSchema: { type: 'object' } }], nextCursor: 'p2' })\n      .mockResolvedValueOnce({ tools: [{ name: 'b', inputSchema: { type: 'object' } }] });\n    const fake = makeFakeClient({ listTools });\n    const session = await connectWith(fake);\n\n    expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n      expect(tools.map((t) => t.name)).toEqual(['a', 'b']);\n    });\n    expect(listTools).toHaveBeenNthCalledWith(1, undefined);\n    expect(listTools).toHaveBeenNthCalledWith(2, { cursor: 'p2' });\n  });\n\n  test('coerces a missing/invalid inputSchema to null and a missing description to undefined', async () => {\n    const fake = makeFakeClient({\n      listTools: jest.fn(async () => ({ tools: [{ name: 'noschema' }] }))\n    });\n    const session = await connectWith(fake);\n    expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n      expect(tools[0]).toEqual({ name: 'noschema', description: undefined, inputSchema: null });\n    });\n  });\n\n  test('fails when listTools throws', async () => {\n    const fake = makeFakeClient({\n      listTools: jest.fn(async () => {\n        throw new Error('protocol error');\n      })\n    });\n    const session = await connectWith(fake);\n    expect(await listMcpTools(session)).toFailWith(/listMcpTools:.*protocol error/);\n  });\n});\n\ndescribe('callMcpTool', () => {\n  const args: JsonObject = { q: 'hi' };\n\n  test('fails loudly for a foreign session handle', async () => {\n    expect(await callMcpTool(FOREIGN_SESSION, 'a', args)).toFailWith(/invalid MCP session/);\n  });\n\n  test('concatenates text blocks', async () => {\n    const fake = makeFakeClient({\n      callTool: jest.fn(async () => ({\n        content: [\n          { type: 'text', text: 'line one' },\n          { type: 'text', text: 'line two' }\n        ]\n      }))\n    });\n    const session = await connectWith(fake);\n    expect(await callMcpTool(session, 'a', args)).toSucceedWith({\n      content: 'line one\\nline two'\n    });\n    expect(fake.callTool).toHaveBeenCalledWith({ name: 'a', arguments: args });\n  });\n\n  test('summarizes non-text blocks', async () => {\n    const fake = makeFakeClient({\n      callTool: jest.fn(async () => ({\n        content: [\n          { type: 'text', text: 'caption' },\n          { type: 'image', data: 'base64==' }\n        ]\n      }))\n    });\n    const session = await connectWith(fake);\n    expect(await callMcpTool(session, 'a', args)).toSucceedWith({\n      content: 'caption\\n[image block]'\n    });\n  });\n\n  test('projects an empty/absent content list to an empty string', async () => {\n    const fake = makeFakeClient({ callTool: jest.fn(async () => ({})) });\n    const session = await connectWith(fake);\n    expect(await callMcpTool(session, 'a', args)).toSucceedWith({ content: '' });\n  });\n\n  test('maps isError:true to a Failure carrying the projected content', async () => {\n    const fake = makeFakeClient({\n      callTool: jest.fn(async () => ({ content: [{ type: 'text', text: 'bad input' }], isError: true }))\n    });\n    const session = await connectWith(fake);\n    expect(await callMcpTool(session, 'a', args)).toFailWith(/^bad input$/);\n  });\n\n  test('maps isError:true with no content to a generic error', async () => {\n    const fake = makeFakeClient({ callTool: jest.fn(async () => ({ isError: true })) });\n    const session = await connectWith(fake);\n    expect(await callMcpTool(session, 'broken', args)).toFailWith(/tool 'broken' reported an error/);\n  });\n\n  test('fails when callTool throws', async () => {\n    const fake = makeFakeClient({\n      callTool: jest.fn(async () => {\n        throw new Error('timeout');\n      })\n    });\n    const session = await connectWith(fake);\n    expect(await callMcpTool(session, 'a', args)).toFailWith(/callMcpTool 'a':.*timeout/);\n  });\n});\n\n// ===========================================================================\n// adaptMcpTools — the headline (Constraint 1)\n// ===========================================================================\n\ndescribe('adaptMcpTools', () => {\n  const goodSchema: JsonValue = {\n    type: 'object',\n    properties: { q: { type: 'string' } },\n    required: ['q']\n  };\n  // `pattern` is outside the JsonSchema.fromJson supported subset → fromJson fails with a pointer.\n  const forbiddenSchema: JsonValue = {\n    type: 'object',\n    properties: { name: { type: 'string', pattern: '^a' } }\n  };\n\n  function mixedCatalogClient(): IFakeClient {\n    return makeFakeClient({\n      listTools: jest.fn(async () => ({\n        tools: [\n          { name: 'good', description: 'a good tool', inputSchema: goodSchema },\n          { name: 'forbidden', inputSchema: forbiddenSchema },\n          { name: 'nonobject', description: 'bad', inputSchema: 'not-a-schema' }\n        ]\n      }))\n    });\n  }\n\n  test('propagates a tool-discovery failure', async () => {\n    const fake = makeFakeClient({\n      listTools: jest.fn(async () => {\n        throw new Error('discovery down');\n      })\n    });\n    const session = await connectWith(fake);\n    expect(await adaptMcpTools(session)).toFailWith(/adaptMcpTools:.*discovery down/);\n  });\n\n  test('adapts good tools and surfaces skipped tools structurally + NOISY warn', async () => {\n    const logger = new Logging.InMemoryLogger('all');\n    const session = await connectWith(mixedCatalogClient());\n\n    expect(await adaptMcpTools(session, { logger })).toSucceedAndSatisfy((result: IAdaptMcpToolsResult) => {\n      expect(result.tools).toHaveLength(1);\n      expect(result.tools[0].config.name).toBe('good');\n      expect(result.tools[0].config.description).toBe('a good tool');\n\n      expect(result.skipped).toHaveLength(2);\n      const byName = new Map(result.skipped.map((s) => [s.name, s]));\n      expect(byName.get('forbidden')?.reason).toMatch(/pattern/);\n      expect(byName.get('forbidden')?.schema).toEqual(forbiddenSchema);\n      expect(byName.get('nonobject')?.reason).toMatch(/not a JSON object/);\n      expect(byName.get('nonobject')?.schema).toBe('not-a-schema');\n    });\n\n    // NOISY warn: tool name + pointer reason + the raw failing schema verbatim.\n    const warned = logger.logged.join('\\n');\n    expect(warned).toMatch(/skipping tool 'forbidden'/);\n    expect(warned).toMatch(/pattern/);\n    expect(warned).toContain(JSON.stringify(forbiddenSchema));\n    expect(warned).toMatch(/skipping tool 'nonobject'/);\n  });\n\n  test('surfaces skips structurally even without a logger', async () => {\n    const session = await connectWith(mixedCatalogClient());\n    expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result: IAdaptMcpToolsResult) => {\n      expect(result.tools).toHaveLength(1);\n      expect(result.skipped).toHaveLength(2);\n    });\n  });\n\n  test('falls back to the tool name when no description is provided', async () => {\n    const fake = makeFakeClient({\n      listTools: jest.fn(async () => ({ tools: [{ name: 'nodesc', inputSchema: goodSchema }] }))\n    });\n    const session = await connectWith(fake);\n    expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result: IAdaptMcpToolsResult) => {\n      expect(result.tools[0].config.description).toBe('nodesc');\n    });\n  });\n\n  describe('adapted tool execute', () => {\n    async function adaptGood(callTool: jest.Mock): Promise<(args: unknown) => Promise<Result<unknown>>> {\n      const fake = makeFakeClient({\n        listTools: jest.fn(async () => ({ tools: [{ name: 'good', inputSchema: goodSchema }] })),\n        callTool\n      });\n      const session = await connectWith(fake);\n      const result = (await adaptMcpTools(session)).orThrow();\n      return result.tools[0].execute;\n    }\n\n    test('forwards validated args to callMcpTool and returns the projected content', async () => {\n      const callTool = jest.fn(async () => ({ content: [{ type: 'text', text: 'tool output' }] }));\n      const execute = await adaptGood(callTool);\n      expect(await execute({ q: 'hello' })).toSucceedWith('tool output');\n      expect(callTool).toHaveBeenCalledWith({ name: 'good', arguments: { q: 'hello' } });\n    });\n\n    test('fails when the model supplies non-object arguments', async () => {\n      const callTool = jest.fn();\n      const execute = await adaptGood(callTool);\n      expect(await execute('not-an-object')).toFailWith(/tool 'good': arguments must be a JSON object/);\n      expect(callTool).not.toHaveBeenCalled();\n    });\n\n    test('propagates an MCP tool error as a Failure', async () => {\n      const callTool = jest.fn(async () => ({ content: [{ type: 'text', text: 'denied' }], isError: true }));\n      const execute = await adaptGood(callTool);\n      expect(await execute({ q: 'hello' })).toFailWith(/denied/);\n    });\n  });\n\n  // ==========================================================================\n  // C2 — MCP Tool.annotations passthrough (normalized, never raw)\n  // ==========================================================================\n\n  describe('annotations passthrough (C2)', () => {\n    const goodSchema2: JsonValue = { type: 'object', properties: { q: { type: 'string' } }, required: ['q'] };\n\n    test('all five hints round-trip onto descriptor.annotations and config.annotations', async () => {\n      const annotations = {\n        title: 'Recall Memory',\n        readOnlyHint: true,\n        destructiveHint: false,\n        idempotentHint: true,\n        openWorldHint: false\n      };\n      const fake = makeFakeClient({\n        listTools: jest.fn(async () => ({\n          tools: [{ name: 'recall', description: 'r', inputSchema: goodSchema2, annotations }]\n        }))\n      });\n      const session = await connectWith(fake);\n\n      expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n        expect(tools[0].annotations).toEqual(annotations);\n      });\n\n      const session2 = await connectWith(\n        makeFakeClient({\n          listTools: jest.fn(async () => ({\n            tools: [{ name: 'recall', description: 'r', inputSchema: goodSchema2, annotations }]\n          }))\n        })\n      );\n      expect(await adaptMcpTools(session2)).toSucceedAndSatisfy((result: IAdaptMcpToolsResult) => {\n        expect(result.tools[0].config.annotations).toEqual(annotations);\n      });\n    });\n\n    test('a tool with no annotations leaves the field absent', async () => {\n      const fake = makeFakeClient({\n        listTools: jest.fn(async () => ({ tools: [{ name: 'plain', inputSchema: goodSchema2 }] }))\n      });\n      const session = await connectWith(fake);\n      expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n        expect(tools[0]).not.toHaveProperty('annotations');\n      });\n\n      const session2 = await connectWith(\n        makeFakeClient({\n          listTools: jest.fn(async () => ({ tools: [{ name: 'plain', inputSchema: goodSchema2 }] }))\n        })\n      );\n      expect(await adaptMcpTools(session2)).toSucceedAndSatisfy((result: IAdaptMcpToolsResult) => {\n        expect(result.tools[0].config).not.toHaveProperty('annotations');\n      });\n    });\n\n    test('a malformed annotations blob is normalized (known fields kept, junk dropped), never raw-propagated', async () => {\n      // readOnlyHint is the wrong type (dropped); bogusField is unknown (dropped); title is valid (kept).\n      const rawAnnotations = {\n        title: 'Keep Me',\n        readOnlyHint: 'yes-please',\n        destructiveHint: true,\n        bogusField: { nested: 42 }\n      };\n      const fake = makeFakeClient({\n        listTools: jest.fn(async () => ({\n          tools: [{ name: 'messy', inputSchema: goodSchema2, annotations: rawAnnotations }]\n        }))\n      });\n      const session = await connectWith(fake);\n      expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n        // Only the well-typed known fields survive; the malformed readOnlyHint and unknown\n        // bogusField are dropped; the raw blob is never propagated.\n        expect(tools[0].annotations).toEqual({ title: 'Keep Me', destructiveHint: true });\n        expect(tools[0].annotations).not.toHaveProperty('readOnlyHint');\n        expect(tools[0].annotations).not.toHaveProperty('bogusField');\n      });\n    });\n\n    test('an all-junk annotations blob normalizes to an absent field (not an empty object)', async () => {\n      const fake = makeFakeClient({\n        listTools: jest.fn(async () => ({\n          tools: [\n            { name: 'junk', inputSchema: goodSchema2, annotations: { unknownOnly: 1, readOnlyHint: 3 } }\n          ]\n        }))\n      });\n      const session = await connectWith(fake);\n      expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n        expect(tools[0]).not.toHaveProperty('annotations');\n      });\n    });\n\n    test('a non-object annotations value is dropped', async () => {\n      const fake = makeFakeClient({\n        listTools: jest.fn(async () => ({\n          tools: [{ name: 'weird', inputSchema: goodSchema2, annotations: 'not-an-object' }]\n        }))\n      });\n      const session = await connectWith(fake);\n      expect(await listMcpTools(session)).toSucceedAndSatisfy((tools: ReadonlyArray<IMcpToolDescriptor>) => {\n        expect(tools[0]).not.toHaveProperty('annotations');\n      });\n    });\n\n    test('the skipped-tool path is unaffected by annotations', async () => {\n      // A tool with annotations but an unsupported inputSchema is still skipped; annotations do\n      // not rescue it or leak onto the skip record.\n      const forbidden: JsonValue = {\n        type: 'object',\n        properties: { name: { type: 'string', pattern: '^a' } }\n      };\n      const fake = makeFakeClient({\n        listTools: jest.fn(async () => ({\n          tools: [{ name: 'blocked', inputSchema: forbidden, annotations: { destructiveHint: true } }]\n        }))\n      });\n      const session = await connectWith(fake);\n      expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result: IAdaptMcpToolsResult) => {\n        expect(result.tools).toHaveLength(0);\n        expect(result.skipped).toHaveLength(1);\n        expect(result.skipped[0].name).toBe('blocked');\n        expect(result.skipped[0]).not.toHaveProperty('annotations');\n      });\n    });\n  });\n});\n"]}