@fgv/ts-extras-mcp 5.1.0-34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/.rush/temp/5d207610a84e494acaefe7ed13447cda74ddf7da.tar.log +90 -0
  2. package/.rush/temp/chunked-rush-logs/ts-extras-mcp.build.chunks.jsonl +9 -0
  3. package/.rush/temp/operation/build/all.log +9 -0
  4. package/.rush/temp/operation/build/log-chunks.jsonl +9 -0
  5. package/.rush/temp/operation/build/state.json +3 -0
  6. package/.rush/temp/shrinkwrap-deps.json +734 -0
  7. package/CHANGELOG.json +4 -0
  8. package/README.md +133 -0
  9. package/config/api-extractor.json +38 -0
  10. package/config/jest.config.json +13 -0
  11. package/config/rig.json +6 -0
  12. package/dist/index.js +49 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/packlets/mcp/adapter.js +122 -0
  15. package/dist/packlets/mcp/adapter.js.map +1 -0
  16. package/dist/packlets/mcp/index.js +33 -0
  17. package/dist/packlets/mcp/index.js.map +1 -0
  18. package/dist/packlets/mcp/model.js +23 -0
  19. package/dist/packlets/mcp/model.js.map +1 -0
  20. package/dist/packlets/mcp/operations.js +119 -0
  21. package/dist/packlets/mcp/operations.js.map +1 -0
  22. package/dist/packlets/mcp/sdk.js +67 -0
  23. package/dist/packlets/mcp/sdk.js.map +1 -0
  24. package/dist/packlets/mcp/session.js +109 -0
  25. package/dist/packlets/mcp/session.js.map +1 -0
  26. package/dist/packlets/mcp/transports.js +96 -0
  27. package/dist/packlets/mcp/transports.js.map +1 -0
  28. package/dist/test/unit/endToEnd.test.js +220 -0
  29. package/dist/test/unit/endToEnd.test.js.map +1 -0
  30. package/dist/test/unit/index.test.js +41 -0
  31. package/dist/test/unit/index.test.js.map +1 -0
  32. package/dist/test/unit/mcp.test.js +381 -0
  33. package/dist/test/unit/mcp.test.js.map +1 -0
  34. package/dist/test/unit/sdk.test.js +68 -0
  35. package/dist/test/unit/sdk.test.js.map +1 -0
  36. package/dist/ts-extras-mcp.d.ts +290 -0
  37. package/dist/tsdoc-metadata.json +11 -0
  38. package/eslint.config.js +15 -0
  39. package/etc/ts-extras-mcp.api.md +104 -0
  40. package/lib/index.d.ts +28 -0
  41. package/lib/index.d.ts.map +1 -0
  42. package/lib/index.js +65 -0
  43. package/lib/index.js.map +1 -0
  44. package/lib/packlets/mcp/adapter.d.ts +33 -0
  45. package/lib/packlets/mcp/adapter.d.ts.map +1 -0
  46. package/lib/packlets/mcp/adapter.js +125 -0
  47. package/lib/packlets/mcp/adapter.js.map +1 -0
  48. package/lib/packlets/mcp/index.d.ts +10 -0
  49. package/lib/packlets/mcp/index.d.ts.map +1 -0
  50. package/lib/packlets/mcp/index.js +57 -0
  51. package/lib/packlets/mcp/index.js.map +1 -0
  52. package/lib/packlets/mcp/model.d.ts +155 -0
  53. package/lib/packlets/mcp/model.d.ts.map +1 -0
  54. package/lib/packlets/mcp/model.js +24 -0
  55. package/lib/packlets/mcp/model.js.map +1 -0
  56. package/lib/packlets/mcp/operations.d.ts +36 -0
  57. package/lib/packlets/mcp/operations.d.ts.map +1 -0
  58. package/lib/packlets/mcp/operations.js +123 -0
  59. package/lib/packlets/mcp/operations.js.map +1 -0
  60. package/lib/packlets/mcp/sdk.d.ts +91 -0
  61. package/lib/packlets/mcp/sdk.d.ts.map +1 -0
  62. package/lib/packlets/mcp/sdk.js +72 -0
  63. package/lib/packlets/mcp/sdk.js.map +1 -0
  64. package/lib/packlets/mcp/session.d.ts +43 -0
  65. package/lib/packlets/mcp/session.d.ts.map +1 -0
  66. package/lib/packlets/mcp/session.js +115 -0
  67. package/lib/packlets/mcp/session.js.map +1 -0
  68. package/lib/packlets/mcp/transports.d.ts +49 -0
  69. package/lib/packlets/mcp/transports.d.ts.map +1 -0
  70. package/lib/packlets/mcp/transports.js +102 -0
  71. package/lib/packlets/mcp/transports.js.map +1 -0
  72. package/lib/test/unit/endToEnd.test.d.ts +13 -0
  73. package/lib/test/unit/endToEnd.test.d.ts.map +1 -0
  74. package/lib/test/unit/endToEnd.test.js +222 -0
  75. package/lib/test/unit/endToEnd.test.js.map +1 -0
  76. package/lib/test/unit/index.test.d.ts +2 -0
  77. package/lib/test/unit/index.test.d.ts.map +1 -0
  78. package/lib/test/unit/index.test.js +76 -0
  79. package/lib/test/unit/index.test.js.map +1 -0
  80. package/lib/test/unit/mcp.test.d.ts +2 -0
  81. package/lib/test/unit/mcp.test.d.ts.map +1 -0
  82. package/lib/test/unit/mcp.test.js +416 -0
  83. package/lib/test/unit/mcp.test.js.map +1 -0
  84. package/lib/test/unit/sdk.test.d.ts +2 -0
  85. package/lib/test/unit/sdk.test.d.ts.map +1 -0
  86. package/lib/test/unit/sdk.test.js +70 -0
  87. package/lib/test/unit/sdk.test.js.map +1 -0
  88. package/package.json +86 -0
  89. package/rush-logs/ts-extras-mcp.build.cache.log +3 -0
  90. package/rush-logs/ts-extras-mcp.build.log +9 -0
  91. package/src/index.ts +50 -0
  92. package/src/packlets/mcp/adapter.ts +152 -0
  93. package/src/packlets/mcp/index.ts +34 -0
  94. package/src/packlets/mcp/model.ts +204 -0
  95. package/src/packlets/mcp/operations.ts +138 -0
  96. package/src/packlets/mcp/sdk.ts +148 -0
  97. package/src/packlets/mcp/session.ts +137 -0
  98. package/src/packlets/mcp/transports.ts +111 -0
  99. package/src/test/unit/endToEnd.test.ts +254 -0
  100. package/src/test/unit/index.test.ts +43 -0
  101. package/src/test/unit/mcp.test.ts +473 -0
  102. package/src/test/unit/sdk.test.ts +73 -0
  103. package/temp/build/lint/_eslint-5eVG3S6w.json +54 -0
  104. package/temp/build/typescript/ts_8nwakTlr.json +1 -0
  105. package/temp/ts-extras-mcp.api.json +1662 -0
  106. package/temp/ts-extras-mcp.api.md +104 -0
  107. package/tsconfig.json +12 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/test/unit/index.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAEnC,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACvF,4FAA4F;QAC5F,6FAA6F;QAC7F,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,oCAAoC,CAAC,CAAC;QACnG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAClF,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\nimport '@fgv/ts-utils-jest';\nimport * as mcp from '../../index';\n\ndescribe('@fgv/ts-extras-mcp package barrel', () => {\n test('re-exports the public boundary primitives', () => {\n expect(typeof mcp.createStdioTransport).toBe('function');\n expect(typeof mcp.createHttpTransport).toBe('function');\n expect(typeof mcp.connectMcpSession).toBe('function');\n expect(typeof mcp.closeMcpSession).toBe('function');\n expect(typeof mcp.listMcpTools).toBe('function');\n expect(typeof mcp.callMcpTool).toBe('function');\n expect(typeof mcp.adaptMcpTools).toBe('function');\n });\n\n test('the re-exported transport factories are the real (behaving) implementations', () => {\n // Behavioral signal beyond `typeof`: a renamed-but-still-a-function export would not behave\n // this way. (The synchronous transport factories validate without touching the SDK/network.)\n expect(mcp.createStdioTransport({ command: '' })).toFailWith(/command must be a non-empty string/);\n expect(mcp.createHttpTransport({ url: 'not a url' })).toFailWith(/invalid url/);\n });\n});\n"]}
@@ -0,0 +1,381 @@
1
+ /*
2
+ * Copyright (c) 2026 Erik Fortune
3
+ *
4
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
5
+ * of this software and associated documentation files (the "Software"), to deal
6
+ * in the Software without restriction, including without limitation the rights
7
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8
+ * copies of the Software, and to permit persons to whom the Software is
9
+ * furnished to do so, subject to the following conditions:
10
+ *
11
+ * The above copyright notice and this permission notice shall be included in all
12
+ * copies or substantial portions of the Software.
13
+ *
14
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20
+ * SOFTWARE.
21
+ */
22
+ // Mock the SDK-isolation seam so no live MCP server / subprocess is required. The factories
23
+ // return controllable fakes; `makeClient` is configured per-test. The jest.mock call must
24
+ // precede the regular imports (hoist-jest-mock).
25
+ jest.mock('../../packlets/mcp/sdk', () => ({
26
+ makeClient: jest.fn(),
27
+ makeStdioTransport: jest.fn(() => ({ sentinel: 'stdio' })),
28
+ makeHttpTransport: jest.fn(() => ({ sentinel: 'http' }))
29
+ }));
30
+ import '@fgv/ts-utils-jest';
31
+ import { Logging } from '@fgv/ts-utils';
32
+ // eslint-disable-next-line @rushstack/packlets/mechanics
33
+ import * as sdk from '../../packlets/mcp/sdk';
34
+ import { adaptMcpTools, callMcpTool, closeMcpSession, connectMcpSession, createHttpTransport, createStdioTransport, listMcpTools } from '../../packlets/mcp';
35
+ const mockSdk = sdk;
36
+ function makeFakeClient(overrides = {}) {
37
+ 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);
38
+ }
39
+ /** Connect a session backed by the given fake client (and a stdio transport). */
40
+ async function connectWith(fake) {
41
+ mockSdk.makeClient.mockReturnValueOnce(fake);
42
+ const transport = createStdioTransport({ command: 'node' }).orThrow();
43
+ return (await connectMcpSession({ transport })).orThrow();
44
+ }
45
+ /** A foreign (non-package) handle, to exercise the loud narrowing-failure paths. */
46
+ const FOREIGN_TRANSPORT = { transportKind: 'stdio' };
47
+ const FOREIGN_SESSION = {
48
+ clientName: 'x',
49
+ clientVersion: 'y',
50
+ serverInfo: undefined
51
+ };
52
+ beforeEach(() => {
53
+ jest.clearAllMocks();
54
+ mockSdk.makeStdioTransport.mockReturnValue({ sentinel: 'stdio' });
55
+ mockSdk.makeHttpTransport.mockReturnValue({ sentinel: 'http' });
56
+ });
57
+ // ===========================================================================
58
+ // Transports
59
+ // ===========================================================================
60
+ describe('createStdioTransport', () => {
61
+ test('succeeds for a valid command', () => {
62
+ expect(createStdioTransport({ command: 'node', args: ['x'] })).toSucceedAndSatisfy((t) => {
63
+ expect(t.transportKind).toBe('stdio');
64
+ });
65
+ expect(mockSdk.makeStdioTransport).toHaveBeenCalledWith(expect.objectContaining({ command: 'node', args: ['x'] }));
66
+ });
67
+ test('fails for an empty/whitespace command', () => {
68
+ expect(createStdioTransport({ command: '' })).toFailWith(/command must be a non-empty string/);
69
+ expect(createStdioTransport({ command: ' ' })).toFailWith(/command must be a non-empty string/);
70
+ });
71
+ test('fails (Result) when the SDK constructor throws', () => {
72
+ mockSdk.makeStdioTransport.mockImplementationOnce(() => {
73
+ throw new Error('spawn boom');
74
+ });
75
+ expect(createStdioTransport({ command: 'node' })).toFailWith(/createStdioTransport:.*spawn boom/);
76
+ });
77
+ });
78
+ describe('createHttpTransport', () => {
79
+ test('succeeds for http and https urls and forwards headers', () => {
80
+ expect(createHttpTransport({ url: 'http://localhost:9000/mcp' })).toSucceedAndSatisfy((t) => {
81
+ expect(t.transportKind).toBe('http');
82
+ });
83
+ expect(createHttpTransport({ url: 'https://example.com/mcp', headers: { authorization: 'Bearer t' } })).toSucceed();
84
+ expect(mockSdk.makeHttpTransport).toHaveBeenCalledWith(expect.any(URL), { authorization: 'Bearer t' });
85
+ });
86
+ test('fails for an unparseable url', () => {
87
+ expect(createHttpTransport({ url: 'not a url' })).toFailWith(/invalid url 'not a url'/);
88
+ });
89
+ test('fails for a non-http(s) protocol', () => {
90
+ expect(createHttpTransport({ url: 'ftp://example.com' })).toFailWith(/must use http or https/);
91
+ });
92
+ test('fails (Result) when the SDK constructor throws', () => {
93
+ mockSdk.makeHttpTransport.mockImplementationOnce(() => {
94
+ throw new Error('http boom');
95
+ });
96
+ expect(createHttpTransport({ url: 'http://localhost' })).toFailWith(/createHttpTransport:.*http boom/);
97
+ });
98
+ });
99
+ // ===========================================================================
100
+ // Session lifecycle
101
+ // ===========================================================================
102
+ describe('connectMcpSession', () => {
103
+ test('fails loudly for a foreign transport handle', async () => {
104
+ expect(await connectMcpSession({ transport: FOREIGN_TRANSPORT })).toFailWith(/invalid MCP transport/);
105
+ });
106
+ test('connects and reports server identity, logging when a logger is supplied', async () => {
107
+ const logger = new Logging.InMemoryLogger('all');
108
+ const fake = makeFakeClient();
109
+ mockSdk.makeClient.mockReturnValueOnce(fake);
110
+ const transport = createStdioTransport({ command: 'node' }).orThrow();
111
+ expect(await connectMcpSession({ transport, clientName: 'me', clientVersion: '0.0.1', logger })).toSucceedAndSatisfy((session) => {
112
+ expect(session.clientName).toBe('me');
113
+ expect(session.clientVersion).toBe('0.0.1');
114
+ expect(session.serverInfo).toEqual({ name: 'fake-server', version: '1.2.3' });
115
+ });
116
+ expect(mockSdk.makeClient).toHaveBeenCalledWith('me', '0.0.1');
117
+ expect(fake.connect).toHaveBeenCalledTimes(1);
118
+ expect(logger.logged.join('\n')).toMatch(/connected to server fake-server@1.2.3/);
119
+ });
120
+ test('connects with default identity and no server info, no logger', async () => {
121
+ const fake = makeFakeClient({ getServerVersion: jest.fn(() => undefined) });
122
+ mockSdk.makeClient.mockReturnValueOnce(fake);
123
+ const transport = createStdioTransport({ command: 'node' }).orThrow();
124
+ expect(await connectMcpSession({ transport })).toSucceedAndSatisfy((session) => {
125
+ expect(session.clientName).toBe('@fgv/ts-extras-mcp');
126
+ expect(session.serverInfo).toBeUndefined();
127
+ });
128
+ });
129
+ test('logs the no-identity case when a logger is supplied', async () => {
130
+ const logger = new Logging.InMemoryLogger('all');
131
+ const fake = makeFakeClient({ getServerVersion: jest.fn(() => undefined) });
132
+ mockSdk.makeClient.mockReturnValueOnce(fake);
133
+ const transport = createStdioTransport({ command: 'node' }).orThrow();
134
+ expect(await connectMcpSession({ transport, logger })).toSucceed();
135
+ expect(logger.logged.join('\n')).toMatch(/connected \(server did not report identity\)/);
136
+ });
137
+ test('fails when the connect handshake throws', async () => {
138
+ const fake = makeFakeClient({
139
+ connect: jest.fn(async () => {
140
+ throw new Error('handshake refused');
141
+ })
142
+ });
143
+ mockSdk.makeClient.mockReturnValueOnce(fake);
144
+ const transport = createStdioTransport({ command: 'node' }).orThrow();
145
+ expect(await connectMcpSession({ transport })).toFailWith(/connectMcpSession:.*handshake refused/);
146
+ });
147
+ });
148
+ describe('closeMcpSession', () => {
149
+ test('fails loudly for a foreign session handle', async () => {
150
+ expect(await closeMcpSession(FOREIGN_SESSION)).toFailWith(/invalid MCP session/);
151
+ });
152
+ test('closes a connected session', async () => {
153
+ const fake = makeFakeClient();
154
+ const session = await connectWith(fake);
155
+ expect(await closeMcpSession(session)).toSucceedWith(true);
156
+ expect(fake.close).toHaveBeenCalledTimes(1);
157
+ });
158
+ test('fails when close throws', async () => {
159
+ const fake = makeFakeClient({
160
+ close: jest.fn(async () => {
161
+ throw new Error('already closed');
162
+ })
163
+ });
164
+ const session = await connectWith(fake);
165
+ expect(await closeMcpSession(session)).toFailWith(/closeMcpSession:.*already closed/);
166
+ });
167
+ });
168
+ // ===========================================================================
169
+ // Tool discovery + invocation
170
+ // ===========================================================================
171
+ describe('listMcpTools', () => {
172
+ test('fails loudly for a foreign session handle', async () => {
173
+ expect(await listMcpTools(FOREIGN_SESSION)).toFailWith(/invalid MCP session/);
174
+ });
175
+ test('returns a single-page catalog', async () => {
176
+ const fake = makeFakeClient({
177
+ listTools: jest.fn(async () => ({
178
+ tools: [{ name: 'a', description: 'tool a', inputSchema: { type: 'object' } }]
179
+ }))
180
+ });
181
+ const session = await connectWith(fake);
182
+ expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
183
+ expect(tools).toHaveLength(1);
184
+ expect(tools[0]).toEqual({ name: 'a', description: 'tool a', inputSchema: { type: 'object' } });
185
+ });
186
+ });
187
+ test('follows nextCursor across pages', async () => {
188
+ const listTools = jest
189
+ .fn()
190
+ .mockResolvedValueOnce({ tools: [{ name: 'a', inputSchema: { type: 'object' } }], nextCursor: 'p2' })
191
+ .mockResolvedValueOnce({ tools: [{ name: 'b', inputSchema: { type: 'object' } }] });
192
+ const fake = makeFakeClient({ listTools });
193
+ const session = await connectWith(fake);
194
+ expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
195
+ expect(tools.map((t) => t.name)).toEqual(['a', 'b']);
196
+ });
197
+ expect(listTools).toHaveBeenNthCalledWith(1, undefined);
198
+ expect(listTools).toHaveBeenNthCalledWith(2, { cursor: 'p2' });
199
+ });
200
+ test('coerces a missing/invalid inputSchema to null and a missing description to undefined', async () => {
201
+ const fake = makeFakeClient({
202
+ listTools: jest.fn(async () => ({ tools: [{ name: 'noschema' }] }))
203
+ });
204
+ const session = await connectWith(fake);
205
+ expect(await listMcpTools(session)).toSucceedAndSatisfy((tools) => {
206
+ expect(tools[0]).toEqual({ name: 'noschema', description: undefined, inputSchema: null });
207
+ });
208
+ });
209
+ test('fails when listTools throws', async () => {
210
+ const fake = makeFakeClient({
211
+ listTools: jest.fn(async () => {
212
+ throw new Error('protocol error');
213
+ })
214
+ });
215
+ const session = await connectWith(fake);
216
+ expect(await listMcpTools(session)).toFailWith(/listMcpTools:.*protocol error/);
217
+ });
218
+ });
219
+ describe('callMcpTool', () => {
220
+ const args = { q: 'hi' };
221
+ test('fails loudly for a foreign session handle', async () => {
222
+ expect(await callMcpTool(FOREIGN_SESSION, 'a', args)).toFailWith(/invalid MCP session/);
223
+ });
224
+ test('concatenates text blocks', async () => {
225
+ const fake = makeFakeClient({
226
+ callTool: jest.fn(async () => ({
227
+ content: [
228
+ { type: 'text', text: 'line one' },
229
+ { type: 'text', text: 'line two' }
230
+ ]
231
+ }))
232
+ });
233
+ const session = await connectWith(fake);
234
+ expect(await callMcpTool(session, 'a', args)).toSucceedWith({
235
+ content: 'line one\nline two'
236
+ });
237
+ expect(fake.callTool).toHaveBeenCalledWith({ name: 'a', arguments: args });
238
+ });
239
+ test('summarizes non-text blocks', async () => {
240
+ const fake = makeFakeClient({
241
+ callTool: jest.fn(async () => ({
242
+ content: [
243
+ { type: 'text', text: 'caption' },
244
+ { type: 'image', data: 'base64==' }
245
+ ]
246
+ }))
247
+ });
248
+ const session = await connectWith(fake);
249
+ expect(await callMcpTool(session, 'a', args)).toSucceedWith({
250
+ content: 'caption\n[image block]'
251
+ });
252
+ });
253
+ test('projects an empty/absent content list to an empty string', async () => {
254
+ const fake = makeFakeClient({ callTool: jest.fn(async () => ({})) });
255
+ const session = await connectWith(fake);
256
+ expect(await callMcpTool(session, 'a', args)).toSucceedWith({ content: '' });
257
+ });
258
+ test('maps isError:true to a Failure carrying the projected content', async () => {
259
+ const fake = makeFakeClient({
260
+ callTool: jest.fn(async () => ({ content: [{ type: 'text', text: 'bad input' }], isError: true }))
261
+ });
262
+ const session = await connectWith(fake);
263
+ expect(await callMcpTool(session, 'a', args)).toFailWith(/^bad input$/);
264
+ });
265
+ test('maps isError:true with no content to a generic error', async () => {
266
+ const fake = makeFakeClient({ callTool: jest.fn(async () => ({ isError: true })) });
267
+ const session = await connectWith(fake);
268
+ expect(await callMcpTool(session, 'broken', args)).toFailWith(/tool 'broken' reported an error/);
269
+ });
270
+ test('fails when callTool throws', async () => {
271
+ const fake = makeFakeClient({
272
+ callTool: jest.fn(async () => {
273
+ throw new Error('timeout');
274
+ })
275
+ });
276
+ const session = await connectWith(fake);
277
+ expect(await callMcpTool(session, 'a', args)).toFailWith(/callMcpTool 'a':.*timeout/);
278
+ });
279
+ });
280
+ // ===========================================================================
281
+ // adaptMcpTools — the headline (Constraint 1)
282
+ // ===========================================================================
283
+ describe('adaptMcpTools', () => {
284
+ const goodSchema = {
285
+ type: 'object',
286
+ properties: { q: { type: 'string' } },
287
+ required: ['q']
288
+ };
289
+ // `pattern` is outside the JsonSchema.fromJson supported subset → fromJson fails with a pointer.
290
+ const forbiddenSchema = {
291
+ type: 'object',
292
+ properties: { name: { type: 'string', pattern: '^a' } }
293
+ };
294
+ function mixedCatalogClient() {
295
+ return makeFakeClient({
296
+ listTools: jest.fn(async () => ({
297
+ tools: [
298
+ { name: 'good', description: 'a good tool', inputSchema: goodSchema },
299
+ { name: 'forbidden', inputSchema: forbiddenSchema },
300
+ { name: 'nonobject', description: 'bad', inputSchema: 'not-a-schema' }
301
+ ]
302
+ }))
303
+ });
304
+ }
305
+ test('propagates a tool-discovery failure', async () => {
306
+ const fake = makeFakeClient({
307
+ listTools: jest.fn(async () => {
308
+ throw new Error('discovery down');
309
+ })
310
+ });
311
+ const session = await connectWith(fake);
312
+ expect(await adaptMcpTools(session)).toFailWith(/adaptMcpTools:.*discovery down/);
313
+ });
314
+ test('adapts good tools and surfaces skipped tools structurally + NOISY warn', async () => {
315
+ const logger = new Logging.InMemoryLogger('all');
316
+ const session = await connectWith(mixedCatalogClient());
317
+ expect(await adaptMcpTools(session, { logger })).toSucceedAndSatisfy((result) => {
318
+ var _a, _b, _c, _d;
319
+ expect(result.tools).toHaveLength(1);
320
+ expect(result.tools[0].config.name).toBe('good');
321
+ expect(result.tools[0].config.description).toBe('a good tool');
322
+ expect(result.skipped).toHaveLength(2);
323
+ const byName = new Map(result.skipped.map((s) => [s.name, s]));
324
+ expect((_a = byName.get('forbidden')) === null || _a === void 0 ? void 0 : _a.reason).toMatch(/pattern/);
325
+ expect((_b = byName.get('forbidden')) === null || _b === void 0 ? void 0 : _b.schema).toEqual(forbiddenSchema);
326
+ expect((_c = byName.get('nonobject')) === null || _c === void 0 ? void 0 : _c.reason).toMatch(/not a JSON object/);
327
+ expect((_d = byName.get('nonobject')) === null || _d === void 0 ? void 0 : _d.schema).toBe('not-a-schema');
328
+ });
329
+ // NOISY warn: tool name + pointer reason + the raw failing schema verbatim.
330
+ const warned = logger.logged.join('\n');
331
+ expect(warned).toMatch(/skipping tool 'forbidden'/);
332
+ expect(warned).toMatch(/pattern/);
333
+ expect(warned).toContain(JSON.stringify(forbiddenSchema));
334
+ expect(warned).toMatch(/skipping tool 'nonobject'/);
335
+ });
336
+ test('surfaces skips structurally even without a logger', async () => {
337
+ const session = await connectWith(mixedCatalogClient());
338
+ expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result) => {
339
+ expect(result.tools).toHaveLength(1);
340
+ expect(result.skipped).toHaveLength(2);
341
+ });
342
+ });
343
+ test('falls back to the tool name when no description is provided', async () => {
344
+ const fake = makeFakeClient({
345
+ listTools: jest.fn(async () => ({ tools: [{ name: 'nodesc', inputSchema: goodSchema }] }))
346
+ });
347
+ const session = await connectWith(fake);
348
+ expect(await adaptMcpTools(session)).toSucceedAndSatisfy((result) => {
349
+ expect(result.tools[0].config.description).toBe('nodesc');
350
+ });
351
+ });
352
+ describe('adapted tool execute', () => {
353
+ async function adaptGood(callTool) {
354
+ const fake = makeFakeClient({
355
+ listTools: jest.fn(async () => ({ tools: [{ name: 'good', inputSchema: goodSchema }] })),
356
+ callTool
357
+ });
358
+ const session = await connectWith(fake);
359
+ const result = (await adaptMcpTools(session)).orThrow();
360
+ return result.tools[0].execute;
361
+ }
362
+ test('forwards validated args to callMcpTool and returns the projected content', async () => {
363
+ const callTool = jest.fn(async () => ({ content: [{ type: 'text', text: 'tool output' }] }));
364
+ const execute = await adaptGood(callTool);
365
+ expect(await execute({ q: 'hello' })).toSucceedWith('tool output');
366
+ expect(callTool).toHaveBeenCalledWith({ name: 'good', arguments: { q: 'hello' } });
367
+ });
368
+ test('fails when the model supplies non-object arguments', async () => {
369
+ const callTool = jest.fn();
370
+ const execute = await adaptGood(callTool);
371
+ expect(await execute('not-an-object')).toFailWith(/tool 'good': arguments must be a JSON object/);
372
+ expect(callTool).not.toHaveBeenCalled();
373
+ });
374
+ test('propagates an MCP tool error as a Failure', async () => {
375
+ const callTool = jest.fn(async () => ({ content: [{ type: 'text', text: 'denied' }], isError: true }));
376
+ const execute = await adaptGood(callTool);
377
+ expect(await execute({ q: 'hello' })).toFailWith(/denied/);
378
+ });
379
+ });
380
+ });
381
+ //# sourceMappingURL=mcp.test.js.map
@@ -0,0 +1 @@
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"]}
@@ -0,0 +1,68 @@
1
+ /*
2
+ * Copyright (c) 2026 Erik Fortune
3
+ *
4
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
5
+ * of this software and associated documentation files (the "Software"), to deal
6
+ * in the Software without restriction, including without limitation the rights
7
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8
+ * copies of the Software, and to permit persons to whom the Software is
9
+ * furnished to do so, subject to the following conditions:
10
+ *
11
+ * The above copyright notice and this permission notice shall be included in all
12
+ * copies or substantial portions of the Software.
13
+ *
14
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20
+ * SOFTWARE.
21
+ */
22
+ // Exercises the real SDK-isolation seam (the one file that imports @modelcontextprotocol/sdk).
23
+ // Constructing the SDK objects is side-effect-free — no process is spawned and no network call is
24
+ // made until a transport is connected, so these factory calls are safe in a unit test.
25
+ // eslint-disable-next-line @rushstack/packlets/mechanics
26
+ import { makeClient, makeHttpTransport, makeStdioTransport } from '../../packlets/mcp/sdk';
27
+ describe('sdk isolation seam', () => {
28
+ describe('makeClient', () => {
29
+ test('constructs a client exposing the projected surface', () => {
30
+ const client = makeClient('test-client', '9.9.9');
31
+ expect(typeof client.connect).toBe('function');
32
+ expect(typeof client.listTools).toBe('function');
33
+ expect(typeof client.callTool).toBe('function');
34
+ expect(typeof client.close).toBe('function');
35
+ expect(typeof client.getServerVersion).toBe('function');
36
+ // Before connecting, the server identity is unknown.
37
+ expect(client.getServerVersion()).toBeUndefined();
38
+ });
39
+ });
40
+ describe('makeStdioTransport', () => {
41
+ test('constructs a transport with full params (args/env/cwd)', () => {
42
+ const transport = makeStdioTransport({
43
+ command: 'node',
44
+ args: ['--version'],
45
+ env: { FOO: 'bar' },
46
+ cwd: '/tmp'
47
+ });
48
+ expect(transport).toBeDefined();
49
+ });
50
+ test('constructs a transport with only a command (args omitted)', () => {
51
+ const transport = makeStdioTransport({ command: 'node' });
52
+ expect(transport).toBeDefined();
53
+ });
54
+ });
55
+ describe('makeHttpTransport', () => {
56
+ test('constructs a transport with headers', () => {
57
+ const transport = makeHttpTransport(new URL('http://localhost:9000/mcp'), {
58
+ authorization: 'Bearer x'
59
+ });
60
+ expect(transport).toBeDefined();
61
+ });
62
+ test('constructs a transport without headers', () => {
63
+ const transport = makeHttpTransport(new URL('https://example.com/mcp'));
64
+ expect(transport).toBeDefined();
65
+ });
66
+ });
67
+ });
68
+ //# sourceMappingURL=sdk.test.js.map
@@ -0,0 +1 @@
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,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;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,UAAU,CAAC,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,kBAAkB,CAAC;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,kBAAkB,CAAC,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,iBAAiB,CAAC,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,iBAAiB,CAAC,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"]}