@fgv/ts-extras-mcp 5.1.0-34

package/lib/test/unit/mcp.test.js

@@ -0,0 +1,416 @@
+"use strict";
+/*
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+// 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' }))
+}));
+require("@fgv/ts-utils-jest");
+const ts_utils_1 = require("@fgv/ts-utils");
+// eslint-disable-next-line @rushstack/packlets/mechanics
+const sdk = __importStar(require("../../packlets/mcp/sdk"));
+const mcp_1 = require("../../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 = (0, mcp_1.createStdioTransport)({ command: 'node' }).orThrow();
+    return (await (0, mcp_1.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((0, mcp_1.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((0, mcp_1.createStdioTransport)({ command: '' })).toFailWith(/command must be a non-empty string/);
+        expect((0, mcp_1.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((0, mcp_1.createStdioTransport)({ command: 'node' })).toFailWith(/createStdioTransport:.*spawn boom/);
+    });
+});
+describe('createHttpTransport', () => {
+    test('succeeds for http and https urls and forwards headers', () => {
+        expect((0, mcp_1.createHttpTransport)({ url: 'http://localhost:9000/mcp' })).toSucceedAndSatisfy((t) => {
+            expect(t.transportKind).toBe('http');
+        });
+        expect((0, mcp_1.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((0, mcp_1.createHttpTransport)({ url: 'not a url' })).toFailWith(/invalid url 'not a url'/);
+    });
+    test('fails for a non-http(s) protocol', () => {
+        expect((0, mcp_1.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((0, mcp_1.createHttpTransport)({ url: 'http://localhost' })).toFailWith(/createHttpTransport:.*http boom/);
+    });
+});
+// ===========================================================================
+// Session lifecycle
+// ===========================================================================
+describe('connectMcpSession', () => {
+    test('fails loudly for a foreign transport handle', async () => {
+        expect(await (0, mcp_1.connectMcpSession)({ transport: FOREIGN_TRANSPORT })).toFailWith(/invalid MCP transport/);
+    });
+    test('connects and reports server identity, logging when a logger is supplied', async () => {
+        const logger = new ts_utils_1.Logging.InMemoryLogger('all');
+        const fake = makeFakeClient();
+        mockSdk.makeClient.mockReturnValueOnce(fake);
+        const transport = (0, mcp_1.createStdioTransport)({ command: 'node' }).orThrow();
+        expect(await (0, mcp_1.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 = (0, mcp_1.createStdioTransport)({ command: 'node' }).orThrow();
+        expect(await (0, mcp_1.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 ts_utils_1.Logging.InMemoryLogger('all');
+        const fake = makeFakeClient({ getServerVersion: jest.fn(() => undefined) });
+        mockSdk.makeClient.mockReturnValueOnce(fake);
+        const transport = (0, mcp_1.createStdioTransport)({ command: 'node' }).orThrow();
+        expect(await (0, mcp_1.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 = (0, mcp_1.createStdioTransport)({ command: 'node' }).orThrow();
+        expect(await (0, mcp_1.connectMcpSession)({ transport })).toFailWith(/connectMcpSession:.*handshake refused/);
+    });
+});
+describe('closeMcpSession', () => {
+    test('fails loudly for a foreign session handle', async () => {
+        expect(await (0, mcp_1.closeMcpSession)(FOREIGN_SESSION)).toFailWith(/invalid MCP session/);
+    });
+    test('closes a connected session', async () => {
+        const fake = makeFakeClient();
+        const session = await connectWith(fake);
+        expect(await (0, mcp_1.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 (0, mcp_1.closeMcpSession)(session)).toFailWith(/closeMcpSession:.*already closed/);
+    });
+});
+// ===========================================================================
+// Tool discovery + invocation
+// ===========================================================================
+describe('listMcpTools', () => {
+    test('fails loudly for a foreign session handle', async () => {
+        expect(await (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.listMcpTools)(session)).toFailWith(/listMcpTools:.*protocol error/);
+    });
+});
+describe('callMcpTool', () => {
+    const args = { q: 'hi' };
+    test('fails loudly for a foreign session handle', async () => {
+        expect(await (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.adaptMcpTools)(session)).toFailWith(/adaptMcpTools:.*discovery down/);
+    });
+    test('adapts good tools and surfaces skipped tools structurally + NOISY warn', async () => {
+        const logger = new ts_utils_1.Logging.InMemoryLogger('all');
+        const session = await connectWith(mixedCatalogClient());
+        expect(await (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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 (0, mcp_1.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/);
+        });
+    });
+});
+//# sourceMappingURL=mcp.test.js.map

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

@@ -0,0 +1 @@
+{"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"]}

package/lib/test/unit/sdk.test.d.ts

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

package/lib/test/unit/sdk.test.d.ts.map

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

package/lib/test/unit/sdk.test.js

@@ -0,0 +1,70 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// Exercises the real SDK-isolation seam (the one file that imports @modelcontextprotocol/sdk).
+// Constructing the SDK objects is side-effect-free — no process is spawned and no network call is
+// made until a transport is connected, so these factory calls are safe in a unit test.
+// eslint-disable-next-line @rushstack/packlets/mechanics
+const sdk_1 = require("../../packlets/mcp/sdk");
+describe('sdk isolation seam', () => {
+    describe('makeClient', () => {
+        test('constructs a client exposing the projected surface', () => {
+            const client = (0, sdk_1.makeClient)('test-client', '9.9.9');
+            expect(typeof client.connect).toBe('function');
+            expect(typeof client.listTools).toBe('function');
+            expect(typeof client.callTool).toBe('function');
+            expect(typeof client.close).toBe('function');
+            expect(typeof client.getServerVersion).toBe('function');
+            // Before connecting, the server identity is unknown.
+            expect(client.getServerVersion()).toBeUndefined();
+        });
+    });
+    describe('makeStdioTransport', () => {
+        test('constructs a transport with full params (args/env/cwd)', () => {
+            const transport = (0, sdk_1.makeStdioTransport)({
+                command: 'node',
+                args: ['--version'],
+                env: { FOO: 'bar' },
+                cwd: '/tmp'
+            });
+            expect(transport).toBeDefined();
+        });
+        test('constructs a transport with only a command (args omitted)', () => {
+            const transport = (0, sdk_1.makeStdioTransport)({ command: 'node' });
+            expect(transport).toBeDefined();
+        });
+    });
+    describe('makeHttpTransport', () => {
+        test('constructs a transport with headers', () => {
+            const transport = (0, sdk_1.makeHttpTransport)(new URL('http://localhost:9000/mcp'), {
+                authorization: 'Bearer x'
+            });
+            expect(transport).toBeDefined();
+        });
+        test('constructs a transport without headers', () => {
+            const transport = (0, sdk_1.makeHttpTransport)(new URL('https://example.com/mcp'));
+            expect(transport).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=sdk.test.js.map

package/lib/test/unit/sdk.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.test.js","sourceRoot":"","sources":["../../../src/test/unit/sdk.test.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAEH,+FAA+F;AAC/F,kGAAkG;AAClG,uFAAuF;AACvF,yDAAyD;AACzD,gDAA2F;AAE3F,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC9D,MAAM,MAAM,GAAG,IAAA,gBAAU,EAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/C,MAAM,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjD,MAAM,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAChD,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxD,qDAAqD;YACrD,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,IAAI,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAClE,MAAM,SAAS,GAAG,IAAA,wBAAkB,EAAC;gBACnC,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,CAAC,WAAW,CAAC;gBACnB,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;gBACnB,GAAG,EAAE,MAAM;aACZ,CAAC,CAAC;YACH,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACrE,MAAM,SAAS,GAAG,IAAA,wBAAkB,EAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1D,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC/C,MAAM,SAAS,GAAG,IAAA,uBAAiB,EAAC,IAAI,GAAG,CAAC,2BAA2B,CAAC,EAAE;gBACxE,aAAa,EAAE,UAAU;aAC1B,CAAC,CAAC;YACH,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAClD,MAAM,SAAS,GAAG,IAAA,uBAAiB,EAAC,IAAI,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACxE,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","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// Exercises the real SDK-isolation seam (the one file that imports @modelcontextprotocol/sdk).\n// Constructing the SDK objects is side-effect-free — no process is spawned and no network call is\n// made until a transport is connected, so these factory calls are safe in a unit test.\n// eslint-disable-next-line @rushstack/packlets/mechanics\nimport { makeClient, makeHttpTransport, makeStdioTransport } from '../../packlets/mcp/sdk';\n\ndescribe('sdk isolation seam', () => {\n  describe('makeClient', () => {\n    test('constructs a client exposing the projected surface', () => {\n      const client = makeClient('test-client', '9.9.9');\n      expect(typeof client.connect).toBe('function');\n      expect(typeof client.listTools).toBe('function');\n      expect(typeof client.callTool).toBe('function');\n      expect(typeof client.close).toBe('function');\n      expect(typeof client.getServerVersion).toBe('function');\n      // Before connecting, the server identity is unknown.\n      expect(client.getServerVersion()).toBeUndefined();\n    });\n  });\n\n  describe('makeStdioTransport', () => {\n    test('constructs a transport with full params (args/env/cwd)', () => {\n      const transport = makeStdioTransport({\n        command: 'node',\n        args: ['--version'],\n        env: { FOO: 'bar' },\n        cwd: '/tmp'\n      });\n      expect(transport).toBeDefined();\n    });\n\n    test('constructs a transport with only a command (args omitted)', () => {\n      const transport = makeStdioTransport({ command: 'node' });\n      expect(transport).toBeDefined();\n    });\n  });\n\n  describe('makeHttpTransport', () => {\n    test('constructs a transport with headers', () => {\n      const transport = makeHttpTransport(new URL('http://localhost:9000/mcp'), {\n        authorization: 'Bearer x'\n      });\n      expect(transport).toBeDefined();\n    });\n\n    test('constructs a transport without headers', () => {\n      const transport = makeHttpTransport(new URL('https://example.com/mcp'));\n      expect(transport).toBeDefined();\n    });\n  });\n});\n"]}