@aria-cli/tools 1.0.9 → 1.0.11

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 (241) hide show
  1. package/package.json +9 -5
  2. package/src/__tests__/web-fetch-download.test.ts +0 -433
  3. package/src/__tests__/web-tools.test.ts +0 -619
  4. package/src/ask-user-interaction.ts +0 -33
  5. package/src/cache/web-cache.ts +0 -110
  6. package/src/definitions/arion.ts +0 -118
  7. package/src/definitions/browser/browser.ts +0 -502
  8. package/src/definitions/browser/index.ts +0 -5
  9. package/src/definitions/browser/pw-downloads.ts +0 -142
  10. package/src/definitions/browser/pw-interactions.ts +0 -282
  11. package/src/definitions/browser/pw-responses.ts +0 -98
  12. package/src/definitions/browser/pw-session.ts +0 -405
  13. package/src/definitions/browser/pw-shared.ts +0 -85
  14. package/src/definitions/browser/pw-snapshot.ts +0 -383
  15. package/src/definitions/browser/pw-state.ts +0 -101
  16. package/src/definitions/browser/types.ts +0 -203
  17. package/src/definitions/code-intelligence.ts +0 -526
  18. package/src/definitions/core.ts +0 -118
  19. package/src/definitions/delegation.ts +0 -567
  20. package/src/definitions/deploy.ts +0 -73
  21. package/src/definitions/filesystem.ts +0 -217
  22. package/src/definitions/frg.ts +0 -67
  23. package/src/definitions/index.ts +0 -28
  24. package/src/definitions/memory.ts +0 -150
  25. package/src/definitions/messaging.ts +0 -734
  26. package/src/definitions/meta.ts +0 -392
  27. package/src/definitions/network.ts +0 -179
  28. package/src/definitions/outlook.ts +0 -318
  29. package/src/definitions/patch/apply-patch.ts +0 -235
  30. package/src/definitions/patch/fuzzy-match.ts +0 -217
  31. package/src/definitions/patch/index.ts +0 -1
  32. package/src/definitions/patch/patch-parser.ts +0 -297
  33. package/src/definitions/patch/sandbox-paths.ts +0 -129
  34. package/src/definitions/process/index.ts +0 -5
  35. package/src/definitions/process/process-registry.ts +0 -303
  36. package/src/definitions/process/process.ts +0 -456
  37. package/src/definitions/process/pty-keys.ts +0 -298
  38. package/src/definitions/process/session-slug.ts +0 -147
  39. package/src/definitions/quip.ts +0 -225
  40. package/src/definitions/search.ts +0 -67
  41. package/src/definitions/session-history.ts +0 -79
  42. package/src/definitions/shell.ts +0 -202
  43. package/src/definitions/slack.ts +0 -211
  44. package/src/definitions/web.ts +0 -119
  45. package/src/executors/apply-patch.ts +0 -1035
  46. package/src/executors/arion.ts +0 -199
  47. package/src/executors/code-intelligence.ts +0 -1179
  48. package/src/executors/deploy.ts +0 -1066
  49. package/src/executors/filesystem.ts +0 -1428
  50. package/src/executors/frg-freshness.ts +0 -743
  51. package/src/executors/frg.ts +0 -394
  52. package/src/executors/index.ts +0 -280
  53. package/src/executors/learning-meta.ts +0 -1367
  54. package/src/executors/lsp-client.ts +0 -355
  55. package/src/executors/memory.ts +0 -978
  56. package/src/executors/meta.ts +0 -293
  57. package/src/executors/process-registry.ts +0 -570
  58. package/src/executors/pty-session-store.ts +0 -43
  59. package/src/executors/pty.ts +0 -342
  60. package/src/executors/restart.ts +0 -133
  61. package/src/executors/search-freshness.ts +0 -249
  62. package/src/executors/search-types.ts +0 -98
  63. package/src/executors/search.ts +0 -89
  64. package/src/executors/self-diagnose.ts +0 -552
  65. package/src/executors/session-history.ts +0 -435
  66. package/src/executors/shell-safety.ts +0 -519
  67. package/src/executors/shell.ts +0 -1243
  68. package/src/executors/utils.ts +0 -40
  69. package/src/executors/web.ts +0 -786
  70. package/src/extraction/content-extraction.ts +0 -281
  71. package/src/extraction/index.ts +0 -5
  72. package/src/headless-control-contract.ts +0 -1149
  73. package/src/index.ts +0 -788
  74. package/src/local-control-http-auth.ts +0 -2
  75. package/src/mcp/client.ts +0 -218
  76. package/src/mcp/connection.ts +0 -568
  77. package/src/mcp/index.ts +0 -11
  78. package/src/mcp/jsonrpc.ts +0 -195
  79. package/src/mcp/types.ts +0 -199
  80. package/src/network-control-adapter.ts +0 -88
  81. package/src/network-runtime/address-types.ts +0 -218
  82. package/src/network-runtime/db-owner-fencing.ts +0 -91
  83. package/src/network-runtime/delivery-receipts.ts +0 -372
  84. package/src/network-runtime/direct-endpoint-authority.ts +0 -35
  85. package/src/network-runtime/index.ts +0 -316
  86. package/src/network-runtime/local-control-contract.ts +0 -784
  87. package/src/network-runtime/node-store-contract.ts +0 -46
  88. package/src/network-runtime/pair-route-contract.ts +0 -97
  89. package/src/network-runtime/peer-capabilities.ts +0 -48
  90. package/src/network-runtime/peer-principal-ref.ts +0 -20
  91. package/src/network-runtime/peer-state-machine.ts +0 -160
  92. package/src/network-runtime/protocol-schemas.ts +0 -265
  93. package/src/network-runtime/runtime-bootstrap-contract.ts +0 -83
  94. package/src/outlook/desktop-session.ts +0 -409
  95. package/src/policy.ts +0 -171
  96. package/src/providers/brave.ts +0 -80
  97. package/src/providers/duckduckgo.ts +0 -199
  98. package/src/providers/exa.ts +0 -85
  99. package/src/providers/firecrawl.ts +0 -77
  100. package/src/providers/index.ts +0 -8
  101. package/src/providers/jina.ts +0 -70
  102. package/src/providers/router.ts +0 -121
  103. package/src/providers/search-provider.ts +0 -74
  104. package/src/providers/tavily.ts +0 -74
  105. package/src/quip/desktop-session.ts +0 -435
  106. package/src/registry/index.ts +0 -1
  107. package/src/registry/registry.ts +0 -905
  108. package/src/runtime-socket-local-control-client.ts +0 -632
  109. package/src/security/dns-normalization.ts +0 -34
  110. package/src/security/dns-pinning.ts +0 -138
  111. package/src/security/external-content.ts +0 -129
  112. package/src/security/ssrf.ts +0 -207
  113. package/src/slack/desktop-session.ts +0 -493
  114. package/src/tool-factory.ts +0 -91
  115. package/src/types.ts +0 -1341
  116. package/src/utils/retry.ts +0 -163
  117. package/src/utils/safe-parse-json.ts +0 -176
  118. package/src/utils/url.ts +0 -20
  119. package/tests/benchmarks/registry.bench.ts +0 -57
  120. package/tests/cache/web-cache.test.ts +0 -147
  121. package/tests/critical-integration.test.ts +0 -1465
  122. package/tests/definitions/apply-patch.test.ts +0 -586
  123. package/tests/definitions/browser.test.ts +0 -495
  124. package/tests/definitions/delegation-pause-resume.test.ts +0 -758
  125. package/tests/definitions/execution.test.ts +0 -671
  126. package/tests/definitions/messaging-inbox-scope.test.ts +0 -229
  127. package/tests/definitions/messaging.test.ts +0 -1468
  128. package/tests/definitions/outlook.test.ts +0 -30
  129. package/tests/definitions/process.test.ts +0 -469
  130. package/tests/definitions/slack.test.ts +0 -28
  131. package/tests/definitions/tool-inventory.test.ts +0 -218
  132. package/tests/e2e/delegation-quest-orchestration.e2e.test.ts +0 -433
  133. package/tests/e2e/memory-tool-discovery-contract.e2e.test.ts +0 -81
  134. package/tests/executors/apply-patch.test.ts +0 -538
  135. package/tests/executors/arion.test.ts +0 -309
  136. package/tests/executors/conversation-primitives.test.ts +0 -250
  137. package/tests/executors/deploy.test.ts +0 -746
  138. package/tests/executors/filesystem-tools.test.ts +0 -357
  139. package/tests/executors/filesystem.test.ts +0 -959
  140. package/tests/executors/frg-freshness.test.ts +0 -136
  141. package/tests/executors/frg-merge.test.ts +0 -70
  142. package/tests/executors/frg-session-content.test.ts +0 -40
  143. package/tests/executors/frg.test.ts +0 -56
  144. package/tests/executors/memory-bugfixes.test.ts +0 -257
  145. package/tests/executors/memory-real-memoria.integration.test.ts +0 -316
  146. package/tests/executors/memory.test.ts +0 -853
  147. package/tests/executors/meta-tools.test.ts +0 -411
  148. package/tests/executors/meta.test.ts +0 -683
  149. package/tests/executors/path-containment.test.ts +0 -51
  150. package/tests/executors/process-registry.test.ts +0 -505
  151. package/tests/executors/pty.test.ts +0 -664
  152. package/tests/executors/quest-security.test.ts +0 -249
  153. package/tests/executors/read-file-media.test.ts +0 -230
  154. package/tests/executors/recall-knowledge-schema.test.ts +0 -209
  155. package/tests/executors/recall-tags.test.ts +0 -278
  156. package/tests/executors/remember-null-safety.contract.test.ts +0 -41
  157. package/tests/executors/restart.test.ts +0 -67
  158. package/tests/executors/search-unified.test.ts +0 -381
  159. package/tests/executors/session-history.test.ts +0 -340
  160. package/tests/executors/session-transcript.test.ts +0 -561
  161. package/tests/executors/shell-abort.test.ts +0 -416
  162. package/tests/executors/shell-env-blocklist.test.ts +0 -648
  163. package/tests/executors/shell-env-process.test.ts +0 -245
  164. package/tests/executors/shell-process-registry.test.ts +0 -334
  165. package/tests/executors/shell-tools.test.ts +0 -393
  166. package/tests/executors/shell.test.ts +0 -690
  167. package/tests/executors/web-abort-vs-timeout.test.ts +0 -213
  168. package/tests/executors/web-integration.test.ts +0 -633
  169. package/tests/executors/web-symlink.test.ts +0 -18
  170. package/tests/executors/web.test.ts +0 -1400
  171. package/tests/executors/write-stdin.test.ts +0 -145
  172. package/tests/extraction/content-extraction.test.ts +0 -153
  173. package/tests/guards/tools-default-test-lane.integration.test.ts +0 -21
  174. package/tests/guards/tools-package-test-commands.e2e.test.ts +0 -43
  175. package/tests/guards/tools-test-lane-manifest.contract.test.ts +0 -76
  176. package/tests/guards/tools-vitest-workspace-alias.contract.test.ts +0 -63
  177. package/tests/helpers/async-waits.ts +0 -53
  178. package/tests/integration/headless-control-contract.integration.test.ts +0 -153
  179. package/tests/integration/memory-tool-schema-parity.integration.test.ts +0 -67
  180. package/tests/integration/meta-tools-round-trip.integration.test.ts +0 -506
  181. package/tests/integration/quest-round-trip.test.ts +0 -303
  182. package/tests/integration/registry-executor-flow.test.ts +0 -85
  183. package/tests/integration.test.ts +0 -177
  184. package/tests/loading-tier.test.ts +0 -126
  185. package/tests/mcp/client-reconnect.test.ts +0 -267
  186. package/tests/mcp/connection.test.ts +0 -846
  187. package/tests/mcp/injectable-logger.test.ts +0 -83
  188. package/tests/mcp/jsonrpc.test.ts +0 -109
  189. package/tests/mcp/lifecycle.test.ts +0 -879
  190. package/tests/network-runtime/address-types.contract.test.ts +0 -143
  191. package/tests/network-runtime/continuity-bind-schema.contract.test.ts +0 -203
  192. package/tests/network-runtime/local-control-contract.test.ts +0 -869
  193. package/tests/network-runtime/local-control-invite-token.contract.test.ts +0 -146
  194. package/tests/network-runtime/node-store-contract.test.ts +0 -11
  195. package/tests/network-runtime/pair-protocol-nodeid.contract.test.ts +0 -15
  196. package/tests/network-runtime/peer-state-machine.contract.test.ts +0 -148
  197. package/tests/network-runtime/protocol-schemas.contract.test.ts +0 -512
  198. package/tests/network-runtime/relay-pending-nodeid.contract.test.ts +0 -62
  199. package/tests/network-runtime/runtime-bootstrap-contract.test.ts +0 -227
  200. package/tests/network-runtime/runtime-socket-local-control-client.test.ts +0 -621
  201. package/tests/network-runtime/wait-for-message-script.test.ts +0 -288
  202. package/tests/parallel.test.ts +0 -71
  203. package/tests/policy.test.ts +0 -184
  204. package/tests/print-default-test-lane.ts +0 -14
  205. package/tests/print-test-lane-manifest.ts +0 -22
  206. package/tests/providers/brave.test.ts +0 -159
  207. package/tests/providers/duckduckgo.test.ts +0 -207
  208. package/tests/providers/exa.test.ts +0 -175
  209. package/tests/providers/firecrawl.test.ts +0 -168
  210. package/tests/providers/jina.test.ts +0 -144
  211. package/tests/providers/router.test.ts +0 -328
  212. package/tests/providers/tavily.test.ts +0 -165
  213. package/tests/registry/discovery.test.ts +0 -154
  214. package/tests/registry/injectable-logger.test.ts +0 -230
  215. package/tests/registry/input-validation.test.ts +0 -361
  216. package/tests/registry/interface-completeness.test.ts +0 -85
  217. package/tests/registry/mcp-integration.test.ts +0 -103
  218. package/tests/registry/mcp-read-only-hint.test.ts +0 -60
  219. package/tests/registry/memoria-discovery.test.ts +0 -390
  220. package/tests/registry/nested-validation.test.ts +0 -283
  221. package/tests/registry/pseudo-tool-filtering.test.ts +0 -258
  222. package/tests/registry/registration-lifecycle.test.ts +0 -133
  223. package/tests/registry-validation.test.ts +0 -424
  224. package/tests/registry.test.ts +0 -460
  225. package/tests/security/dns-pinning.test.ts +0 -162
  226. package/tests/security/external-content.test.ts +0 -144
  227. package/tests/security/ssrf.test.ts +0 -118
  228. package/tests/shell-safety-integration.test.ts +0 -32
  229. package/tests/shell-safety.test.ts +0 -365
  230. package/tests/slack/desktop-session.test.ts +0 -50
  231. package/tests/test-lane-manifest.ts +0 -440
  232. package/tests/test-utils.ts +0 -27
  233. package/tests/tool-factory.test.ts +0 -188
  234. package/tests/utils/retry.test.ts +0 -231
  235. package/tests/utils/url.test.ts +0 -63
  236. package/tsconfig.cjs.json +0 -24
  237. package/tsconfig.json +0 -12
  238. package/vitest.config.ts +0 -55
  239. package/vitest.e2e.config.ts +0 -24
  240. package/vitest.integration.config.ts +0 -24
  241. package/vitest.native.config.ts +0 -24
@@ -1,879 +0,0 @@
1
- /**
2
- * MCP Server Connection Lifecycle Tests
3
- *
4
- * Tests the full lifecycle of MCPServerConnection:
5
- * init -> listTools -> callTool -> shutdown
6
- *
7
- * Uses a mock child process with PassThrough streams to simulate
8
- * an MCP server without spawning a real process.
9
- */
10
-
11
- import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
12
- import { PassThrough } from "stream";
13
- import { EventEmitter } from "events";
14
-
15
- // ---------------------------------------------------------------------------
16
- // Mock child_process.spawn — must be before importing connection.ts
17
- // ---------------------------------------------------------------------------
18
-
19
- /** Fake child process that mimics ChildProcess enough for MCPServerConnection */
20
- class FakeChildProcess extends EventEmitter {
21
- readonly stdin = new PassThrough();
22
- readonly stdout = new PassThrough();
23
- readonly stderr = new PassThrough();
24
- killed = false;
25
- pid = 12345;
26
-
27
- kill(signal?: string): boolean {
28
- this.killed = true;
29
- if (signal === "SIGKILL") {
30
- // SIGKILL always succeeds immediately
31
- this.emit("exit", null, "SIGKILL");
32
- }
33
- // For SIGTERM the test controls when exit fires
34
- return true;
35
- }
36
- }
37
-
38
- let fakeProcess: FakeChildProcess;
39
-
40
- // vi.hoisted ensures mockSpawn is available when vi.mock factory runs (hoisted)
41
- const { mockSpawn } = vi.hoisted(() => ({
42
- mockSpawn: vi.fn(),
43
- }));
44
-
45
- vi.mock("child_process", () => ({
46
- spawn: mockSpawn,
47
- }));
48
-
49
- // Import AFTER mock setup so it gets the mocked spawn
50
- import { MCPServerConnection } from "../../src/mcp/connection.js";
51
-
52
- // ---------------------------------------------------------------------------
53
- // Helpers
54
- // ---------------------------------------------------------------------------
55
-
56
- /**
57
- * Intercept JSON-RPC requests on fake stdin and auto-respond.
58
- */
59
- function autoRespond(
60
- proc: FakeChildProcess,
61
- handler: (method: string, params: unknown, id: string) => unknown,
62
- ) {
63
- proc.stdin.on("data", (chunk: Buffer) => {
64
- const lines = chunk.toString().split("\n").filter(Boolean);
65
- for (const line of lines) {
66
- const msg = JSON.parse(line);
67
- // Only respond to requests (have an id), skip notifications
68
- if (msg.id === undefined) continue;
69
- const result = handler(msg.method, msg.params, msg.id);
70
- if (result !== undefined) {
71
- proc.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: msg.id, result }) + "\n");
72
- }
73
- }
74
- });
75
- }
76
-
77
- /** Standard MCP initialize response */
78
- const INIT_RESULT = {
79
- protocolVersion: "2024-11-05",
80
- capabilities: {
81
- tools: { listChanged: true },
82
- resources: { subscribe: false, listChanged: true },
83
- },
84
- serverInfo: { name: "test-server", version: "0.1.0" },
85
- };
86
-
87
- /**
88
- * Configure mockSpawn to create a FakeChildProcess with an auto-responder
89
- * attached immediately on creation (before the RPC request is sent).
90
- */
91
- function setupAutoResponder(handler: (method: string, params: unknown, id: string) => unknown) {
92
- mockSpawn.mockImplementation(() => {
93
- fakeProcess = new FakeChildProcess();
94
- autoRespond(fakeProcess, handler);
95
- return fakeProcess as unknown as ReturnType<typeof mockSpawn>;
96
- });
97
- }
98
-
99
- // ---------------------------------------------------------------------------
100
- // Tests
101
- // ---------------------------------------------------------------------------
102
-
103
- describe("MCPServerConnection lifecycle", () => {
104
- let conn: MCPServerConnection;
105
-
106
- beforeEach(() => {
107
- vi.useFakeTimers();
108
- fakeProcess = undefined as unknown as FakeChildProcess;
109
- mockSpawn.mockImplementation(() => {
110
- fakeProcess = new FakeChildProcess();
111
- return fakeProcess as unknown as ReturnType<typeof mockSpawn>;
112
- });
113
- });
114
-
115
- afterEach(() => {
116
- vi.useRealTimers();
117
- vi.restoreAllMocks();
118
- });
119
-
120
- // =========================================================================
121
- // Initialization
122
- // =========================================================================
123
-
124
- describe("initialize()", () => {
125
- it("should spawn process and complete MCP handshake", async () => {
126
- setupAutoResponder((method) => {
127
- if (method === "initialize") return INIT_RESULT;
128
- return undefined;
129
- });
130
-
131
- conn = new MCPServerConnection({
132
- name: "test-mcp",
133
- command: "/usr/bin/fake-mcp",
134
- args: ["--stdio"],
135
- });
136
-
137
- const capabilities = await conn.initialize();
138
-
139
- expect(conn.initialized).toBe(true);
140
- expect(conn.name).toBe("test-mcp");
141
- expect(capabilities).toEqual(INIT_RESULT.capabilities);
142
- });
143
-
144
- it("should send initialized notification after handshake", async () => {
145
- const sentMessages: Array<{ method: string; id?: string }> = [];
146
-
147
- mockSpawn.mockImplementation(() => {
148
- fakeProcess = new FakeChildProcess();
149
- fakeProcess.stdin.on("data", (chunk: Buffer) => {
150
- const lines = chunk.toString().split("\n").filter(Boolean);
151
- for (const line of lines) {
152
- const msg = JSON.parse(line);
153
- sentMessages.push({ method: msg.method, id: msg.id });
154
- if (msg.id !== undefined && msg.method === "initialize") {
155
- fakeProcess.stdout.write(
156
- JSON.stringify({
157
- jsonrpc: "2.0",
158
- id: msg.id,
159
- result: INIT_RESULT,
160
- }) + "\n",
161
- );
162
- }
163
- }
164
- });
165
- return fakeProcess as unknown as ReturnType<typeof mockSpawn>;
166
- });
167
-
168
- conn = new MCPServerConnection({
169
- name: "test-mcp",
170
- command: "/usr/bin/fake-mcp",
171
- });
172
-
173
- await conn.initialize();
174
-
175
- const methods = sentMessages.map((m) => m.method);
176
- expect(methods).toContain("initialize");
177
- expect(methods).toContain("notifications/initialized");
178
-
179
- // The initialized notification should NOT have an id (it is a notification)
180
- const initNotification = sentMessages.find((m) => m.method === "notifications/initialized");
181
- expect(initNotification?.id).toBeUndefined();
182
- });
183
-
184
- it("should send correct protocol version and client info", async () => {
185
- let capturedParams: unknown;
186
-
187
- mockSpawn.mockImplementation(() => {
188
- fakeProcess = new FakeChildProcess();
189
- fakeProcess.stdin.on("data", (chunk: Buffer) => {
190
- const lines = chunk.toString().split("\n").filter(Boolean);
191
- for (const line of lines) {
192
- const msg = JSON.parse(line);
193
- if (msg.method === "initialize" && msg.id !== undefined) {
194
- capturedParams = msg.params;
195
- fakeProcess.stdout.write(
196
- JSON.stringify({
197
- jsonrpc: "2.0",
198
- id: msg.id,
199
- result: INIT_RESULT,
200
- }) + "\n",
201
- );
202
- }
203
- }
204
- });
205
- return fakeProcess as unknown as ReturnType<typeof mockSpawn>;
206
- });
207
-
208
- conn = new MCPServerConnection({
209
- name: "test-mcp",
210
- command: "/usr/bin/fake-mcp",
211
- });
212
-
213
- await conn.initialize();
214
-
215
- expect(capturedParams).toEqual({
216
- protocolVersion: "2024-11-05",
217
- capabilities: {
218
- roots: { listChanged: true },
219
- },
220
- clientInfo: {
221
- name: "aria-cli",
222
- version: "1.0.0",
223
- },
224
- });
225
- });
226
-
227
- it("should throw if URL is missing for sse transport", async () => {
228
- conn = new MCPServerConnection({
229
- name: "test-sse",
230
- transport: "sse",
231
- });
232
-
233
- await expect(conn.initialize()).rejects.toThrow("URL required for sse transport");
234
- });
235
-
236
- it("should throw if command is missing for stdio transport", async () => {
237
- conn = new MCPServerConnection({ name: "test-no-cmd" });
238
-
239
- await expect(conn.initialize()).rejects.toThrow("Command required for stdio transport");
240
- });
241
-
242
- it("should emit exit event when process exits", async () => {
243
- setupAutoResponder((method) => {
244
- if (method === "initialize") return INIT_RESULT;
245
- return undefined;
246
- });
247
-
248
- conn = new MCPServerConnection({
249
- name: "test-mcp",
250
- command: "/usr/bin/fake-mcp",
251
- });
252
-
253
- await conn.initialize();
254
-
255
- const exitPromise = new Promise<number | null>((resolve) => {
256
- conn.on("exit", resolve);
257
- });
258
-
259
- fakeProcess.emit("exit", 1);
260
-
261
- const code = await exitPromise;
262
- expect(code).toBe(1);
263
- expect(conn.initialized).toBe(false);
264
- });
265
-
266
- it("should emit log events from stderr", async () => {
267
- setupAutoResponder((method) => {
268
- if (method === "initialize") return INIT_RESULT;
269
- return undefined;
270
- });
271
-
272
- conn = new MCPServerConnection({
273
- name: "test-mcp",
274
- command: "/usr/bin/fake-mcp",
275
- });
276
-
277
- await conn.initialize();
278
-
279
- const logPromise = new Promise<{ level: string; message: string }>((resolve) => {
280
- conn.on("log", resolve);
281
- });
282
-
283
- fakeProcess.stderr.write("Something went wrong\n");
284
-
285
- const log = await logPromise;
286
- expect(log.level).toBe("error");
287
- expect(log.message).toContain("Something went wrong");
288
- });
289
-
290
- it("should pass environment variables to spawned process", async () => {
291
- let spawnEnv: Record<string, string> | undefined;
292
-
293
- mockSpawn.mockImplementation(((
294
- _cmd: string,
295
- _args: string[],
296
- opts: { env: Record<string, string> },
297
- ) => {
298
- spawnEnv = opts.env;
299
- fakeProcess = new FakeChildProcess();
300
- autoRespond(fakeProcess, (method) => {
301
- if (method === "initialize") return INIT_RESULT;
302
- return undefined;
303
- });
304
- return fakeProcess;
305
- }) as unknown as typeof mockSpawn);
306
-
307
- conn = new MCPServerConnection({
308
- name: "test-mcp",
309
- command: "/usr/bin/fake-mcp",
310
- env: { MCP_TOKEN: "secret-123" },
311
- });
312
-
313
- await conn.initialize();
314
-
315
- expect(spawnEnv).toBeDefined();
316
- expect(spawnEnv!.MCP_TOKEN).toBe("secret-123");
317
- });
318
- });
319
-
320
- // =========================================================================
321
- // listTools
322
- // =========================================================================
323
-
324
- describe("listTools()", () => {
325
- it("should return parsed tool list from server", async () => {
326
- const mockTools = [
327
- {
328
- name: "read_file",
329
- description: "Read a file",
330
- inputSchema: {
331
- type: "object" as const,
332
- properties: { path: { type: "string" as const } },
333
- required: ["path"],
334
- },
335
- },
336
- {
337
- name: "write_file",
338
- description: "Write a file",
339
- inputSchema: {
340
- type: "object" as const,
341
- properties: {
342
- path: { type: "string" as const },
343
- content: { type: "string" as const },
344
- },
345
- required: ["path", "content"],
346
- },
347
- },
348
- ];
349
-
350
- setupAutoResponder((method) => {
351
- if (method === "initialize") return INIT_RESULT;
352
- if (method === "tools/list") return { tools: mockTools };
353
- return undefined;
354
- });
355
-
356
- conn = new MCPServerConnection({
357
- name: "test-mcp",
358
- command: "/usr/bin/fake-mcp",
359
- });
360
-
361
- await conn.initialize();
362
- const tools = await conn.listTools();
363
-
364
- expect(tools).toHaveLength(2);
365
- expect(tools[0].name).toBe("read_file");
366
- expect(tools[1].name).toBe("write_file");
367
- expect(tools[0].inputSchema).toEqual({
368
- type: "object",
369
- properties: { path: { type: "string" } },
370
- required: ["path"],
371
- });
372
- });
373
-
374
- it("should return empty array when server has no tools", async () => {
375
- setupAutoResponder((method) => {
376
- if (method === "initialize") return INIT_RESULT;
377
- if (method === "tools/list") return { tools: [] };
378
- return undefined;
379
- });
380
-
381
- conn = new MCPServerConnection({
382
- name: "test-mcp",
383
- command: "/usr/bin/fake-mcp",
384
- });
385
-
386
- await conn.initialize();
387
- const tools = await conn.listTools();
388
-
389
- expect(tools).toEqual([]);
390
- });
391
- });
392
-
393
- // =========================================================================
394
- // callTool
395
- // =========================================================================
396
-
397
- describe("callTool()", () => {
398
- it("should send tool call and return success result", async () => {
399
- setupAutoResponder((method, params) => {
400
- if (method === "initialize") return INIT_RESULT;
401
- if (method === "tools/call") {
402
- const p = params as { name: string; arguments: unknown };
403
- if (p.name === "read_file") {
404
- return {
405
- content: [{ type: "text", text: "file contents here" }],
406
- isError: false,
407
- };
408
- }
409
- }
410
- return undefined;
411
- });
412
-
413
- conn = new MCPServerConnection({
414
- name: "test-mcp",
415
- command: "/usr/bin/fake-mcp",
416
- });
417
-
418
- await conn.initialize();
419
- const result = await conn.callTool("read_file", {
420
- path: "/tmp/test.txt",
421
- });
422
-
423
- expect(result.success).toBe(true);
424
- expect(result.message).toBe("file contents here");
425
- });
426
-
427
- it("should concatenate multiple text content blocks", async () => {
428
- setupAutoResponder((method) => {
429
- if (method === "initialize") return INIT_RESULT;
430
- if (method === "tools/call") {
431
- return {
432
- content: [
433
- { type: "text", text: "line 1" },
434
- { type: "image", data: "base64data", mimeType: "image/png" },
435
- { type: "text", text: "line 2" },
436
- ],
437
- isError: false,
438
- };
439
- }
440
- return undefined;
441
- });
442
-
443
- conn = new MCPServerConnection({
444
- name: "test-mcp",
445
- command: "/usr/bin/fake-mcp",
446
- });
447
-
448
- await conn.initialize();
449
- const result = await conn.callTool("multi_output", {});
450
-
451
- expect(result.success).toBe(true);
452
- expect(result.message).toBe("line 1\nline 2");
453
- expect(result.data).toHaveLength(3);
454
- });
455
-
456
- it("should return isError=true as success=false", async () => {
457
- setupAutoResponder((method) => {
458
- if (method === "initialize") return INIT_RESULT;
459
- if (method === "tools/call") {
460
- return {
461
- content: [{ type: "text", text: "Permission denied" }],
462
- isError: true,
463
- };
464
- }
465
- return undefined;
466
- });
467
-
468
- conn = new MCPServerConnection({
469
- name: "test-mcp",
470
- command: "/usr/bin/fake-mcp",
471
- });
472
-
473
- await conn.initialize();
474
- const result = await conn.callTool("write_file", {
475
- path: "/etc/passwd",
476
- content: "hacked",
477
- });
478
-
479
- expect(result.success).toBe(false);
480
- expect(result.message).toBe("Permission denied");
481
- });
482
-
483
- it("should handle JSON-RPC errors gracefully", async () => {
484
- mockSpawn.mockImplementation(() => {
485
- fakeProcess = new FakeChildProcess();
486
- fakeProcess.stdin.on("data", (chunk: Buffer) => {
487
- const lines = chunk.toString().split("\n").filter(Boolean);
488
- for (const line of lines) {
489
- const msg = JSON.parse(line);
490
- if (msg.id === undefined) continue;
491
- if (msg.method === "initialize") {
492
- fakeProcess.stdout.write(
493
- JSON.stringify({
494
- jsonrpc: "2.0",
495
- id: msg.id,
496
- result: INIT_RESULT,
497
- }) + "\n",
498
- );
499
- } else if (msg.method === "tools/call") {
500
- fakeProcess.stdout.write(
501
- JSON.stringify({
502
- jsonrpc: "2.0",
503
- id: msg.id,
504
- error: { code: -32601, message: "Method not found" },
505
- }) + "\n",
506
- );
507
- }
508
- }
509
- });
510
- return fakeProcess as unknown as ReturnType<typeof mockSpawn>;
511
- });
512
-
513
- conn = new MCPServerConnection({
514
- name: "test-mcp",
515
- command: "/usr/bin/fake-mcp",
516
- });
517
-
518
- await conn.initialize();
519
- const result = await conn.callTool("nonexistent", {});
520
-
521
- expect(result.success).toBe(false);
522
- expect(result.message).toContain("Method not found");
523
- });
524
- });
525
-
526
- // =========================================================================
527
- // Shutdown
528
- // =========================================================================
529
-
530
- describe("shutdown()", () => {
531
- it("should send shutdown request and exit notification then kill", async () => {
532
- const sentMethods: string[] = [];
533
-
534
- mockSpawn.mockImplementation(() => {
535
- fakeProcess = new FakeChildProcess();
536
- fakeProcess.stdin.on("data", (chunk: Buffer) => {
537
- const lines = chunk.toString().split("\n").filter(Boolean);
538
- for (const line of lines) {
539
- const msg = JSON.parse(line);
540
- sentMethods.push(msg.method);
541
- if (msg.id === undefined) continue;
542
- if (msg.method === "initialize") {
543
- fakeProcess.stdout.write(
544
- JSON.stringify({
545
- jsonrpc: "2.0",
546
- id: msg.id,
547
- result: INIT_RESULT,
548
- }) + "\n",
549
- );
550
- } else if (msg.method === "shutdown") {
551
- fakeProcess.stdout.write(
552
- JSON.stringify({
553
- jsonrpc: "2.0",
554
- id: msg.id,
555
- result: {},
556
- }) + "\n",
557
- );
558
- }
559
- }
560
- });
561
- return fakeProcess as unknown as ReturnType<typeof mockSpawn>;
562
- });
563
-
564
- conn = new MCPServerConnection({
565
- name: "test-mcp",
566
- command: "/usr/bin/fake-mcp",
567
- });
568
-
569
- await conn.initialize();
570
-
571
- // Override kill to also emit exit (simulating normal graceful shutdown)
572
- const origKill = fakeProcess.kill.bind(fakeProcess);
573
- fakeProcess.kill = vi.fn((signal?: string) => {
574
- origKill(signal);
575
- if (signal === "SIGTERM") {
576
- setTimeout(() => fakeProcess.emit("exit", 0, "SIGTERM"), 50);
577
- }
578
- return true;
579
- }) as unknown as typeof fakeProcess.kill;
580
-
581
- const shutdownPromise = conn.shutdown();
582
- await vi.advanceTimersByTimeAsync(600);
583
- await shutdownPromise;
584
-
585
- expect(sentMethods).toContain("shutdown");
586
- expect(sentMethods).toContain("notifications/exit");
587
- expect(fakeProcess.kill).toHaveBeenCalledWith("SIGTERM");
588
- expect(conn.initialized).toBe(false);
589
- });
590
-
591
- it("should noop if not initialized", async () => {
592
- conn = new MCPServerConnection({
593
- name: "test-mcp",
594
- command: "/usr/bin/fake-mcp",
595
- });
596
-
597
- const shutdownPromise = conn.shutdown();
598
- await vi.advanceTimersByTimeAsync(600);
599
- await shutdownPromise;
600
- expect(conn.initialized).toBe(false);
601
- });
602
-
603
- it("should await process exit before resolving", async () => {
604
- setupAutoResponder((method) => {
605
- if (method === "initialize") return INIT_RESULT;
606
- if (method === "shutdown") return {};
607
- return undefined;
608
- });
609
-
610
- conn = new MCPServerConnection({
611
- name: "test-mcp",
612
- command: "/usr/bin/fake-mcp",
613
- });
614
-
615
- await conn.initialize();
616
-
617
- let shutdownResolved = false;
618
-
619
- // Override kill to NOT auto-emit exit
620
- fakeProcess.kill = vi.fn((_signal?: string) => {
621
- return true;
622
- }) as unknown as typeof fakeProcess.kill;
623
-
624
- const shutdownPromise = conn.shutdown().then(() => {
625
- shutdownResolved = true;
626
- });
627
-
628
- // Advance past the 500ms setTimeout in shutdown
629
- await vi.advanceTimersByTimeAsync(600);
630
-
631
- // Shutdown should still be pending because process has not exited
632
- expect(shutdownResolved).toBe(false);
633
-
634
- // Now emit exit
635
- fakeProcess.emit("exit", 0);
636
-
637
- await shutdownPromise;
638
- expect(shutdownResolved).toBe(true);
639
- });
640
-
641
- it("should escalate to SIGKILL after 5s timeout", async () => {
642
- setupAutoResponder((method) => {
643
- if (method === "initialize") return INIT_RESULT;
644
- if (method === "shutdown") return {};
645
- return undefined;
646
- });
647
-
648
- conn = new MCPServerConnection({
649
- name: "test-mcp",
650
- command: "/usr/bin/fake-mcp",
651
- });
652
-
653
- await conn.initialize();
654
-
655
- const killCalls: string[] = [];
656
- fakeProcess.kill = vi.fn((signal?: string) => {
657
- killCalls.push(signal || "default");
658
- if (signal === "SIGKILL") {
659
- process.nextTick(() => fakeProcess.emit("exit", null, "SIGKILL"));
660
- }
661
- return true;
662
- }) as unknown as typeof fakeProcess.kill;
663
-
664
- const shutdownPromise = conn.shutdown();
665
-
666
- // Advance past the 500ms delay + SIGTERM
667
- await vi.advanceTimersByTimeAsync(600);
668
-
669
- expect(killCalls).toContain("SIGTERM");
670
- expect(killCalls).not.toContain("SIGKILL");
671
-
672
- // Advance to 5s timeout for SIGKILL escalation
673
- await vi.advanceTimersByTimeAsync(5000);
674
-
675
- expect(killCalls).toContain("SIGKILL");
676
-
677
- await shutdownPromise;
678
- });
679
-
680
- it("should handle shutdown when rpc request fails", async () => {
681
- // Simulate a scenario where the shutdown RPC request fails (e.g. process
682
- // already dead / broken pipe). The shutdown() catch block should proceed
683
- // to kill the process anyway.
684
- setupAutoResponder((method) => {
685
- if (method === "initialize") return INIT_RESULT;
686
- // Don't respond to "shutdown" at all -- it will timeout from JSONRPCClient
687
- return undefined;
688
- });
689
-
690
- conn = new MCPServerConnection({
691
- name: "test-mcp",
692
- command: "/usr/bin/fake-mcp",
693
- });
694
-
695
- await conn.initialize();
696
-
697
- const killCalls: string[] = [];
698
- fakeProcess.kill = vi.fn((signal?: string) => {
699
- killCalls.push(signal || "default");
700
- // Process exits immediately on any signal
701
- process.nextTick(() => fakeProcess.emit("exit", 1));
702
- return true;
703
- }) as unknown as typeof fakeProcess.kill;
704
-
705
- const shutdownPromise = conn.shutdown();
706
-
707
- // Advance past the RPC timeout (30s default) + 500ms delay
708
- // The shutdown request will timeout, catch fires, kill is called
709
- await vi.advanceTimersByTimeAsync(31000);
710
-
711
- await shutdownPromise;
712
-
713
- expect(conn.initialized).toBe(false);
714
- expect(killCalls).toContain("SIGTERM");
715
- });
716
- });
717
-
718
- // =========================================================================
719
- // Full lifecycle
720
- // =========================================================================
721
-
722
- describe("full lifecycle: init -> listTools -> callTool -> shutdown", () => {
723
- it("should complete a full interaction cycle", async () => {
724
- const mockTools = [
725
- {
726
- name: "echo",
727
- description: "Echo input back",
728
- inputSchema: {
729
- type: "object" as const,
730
- properties: { text: { type: "string" as const } },
731
- },
732
- },
733
- ];
734
-
735
- mockSpawn.mockImplementation(() => {
736
- fakeProcess = new FakeChildProcess();
737
- fakeProcess.stdin.on("data", (chunk: Buffer) => {
738
- const lines = chunk.toString().split("\n").filter(Boolean);
739
- for (const line of lines) {
740
- const msg = JSON.parse(line);
741
- if (msg.id === undefined) continue;
742
-
743
- let result: unknown;
744
- switch (msg.method) {
745
- case "initialize":
746
- result = INIT_RESULT;
747
- break;
748
- case "tools/list":
749
- result = { tools: mockTools };
750
- break;
751
- case "tools/call": {
752
- const p = msg.params as {
753
- name: string;
754
- arguments: { text: string };
755
- };
756
- result = {
757
- content: [{ type: "text", text: `echo: ${p.arguments.text}` }],
758
- isError: false,
759
- };
760
- break;
761
- }
762
- case "shutdown":
763
- result = {};
764
- break;
765
- }
766
-
767
- if (result !== undefined) {
768
- fakeProcess.stdout.write(
769
- JSON.stringify({ jsonrpc: "2.0", id: msg.id, result }) + "\n",
770
- );
771
- }
772
- }
773
- });
774
-
775
- // Override kill to emit exit
776
- const origKill = fakeProcess.kill.bind(fakeProcess);
777
- fakeProcess.kill = vi.fn((signal?: string) => {
778
- origKill(signal);
779
- if (signal === "SIGTERM") {
780
- setTimeout(() => fakeProcess.emit("exit", 0), 10);
781
- }
782
- return true;
783
- }) as unknown as typeof fakeProcess.kill;
784
-
785
- return fakeProcess as unknown as ReturnType<typeof mockSpawn>;
786
- });
787
-
788
- conn = new MCPServerConnection({
789
- name: "echo-server",
790
- command: "/usr/bin/echo-mcp",
791
- args: ["--stdio"],
792
- env: { DEBUG: "true" },
793
- });
794
-
795
- // 1. Initialize
796
- const caps = await conn.initialize();
797
- expect(conn.initialized).toBe(true);
798
- expect(caps.tools).toEqual({ listChanged: true });
799
-
800
- // 2. List tools
801
- const tools = await conn.listTools();
802
- expect(tools).toHaveLength(1);
803
- expect(tools[0].name).toBe("echo");
804
-
805
- // 3. Call tool
806
- const result = await conn.callTool("echo", { text: "hello world" });
807
- expect(result.success).toBe(true);
808
- expect(result.message).toBe("echo: hello world");
809
-
810
- // 4. Shutdown
811
- const shutdownPromise = conn.shutdown();
812
- await vi.advanceTimersByTimeAsync(600);
813
- await shutdownPromise;
814
- expect(conn.initialized).toBe(false);
815
- });
816
- });
817
-
818
- // =========================================================================
819
- // Notification forwarding
820
- // =========================================================================
821
-
822
- describe("notification forwarding", () => {
823
- it("should forward tools/list_changed notification", async () => {
824
- setupAutoResponder((method) => {
825
- if (method === "initialize") return INIT_RESULT;
826
- return undefined;
827
- });
828
-
829
- conn = new MCPServerConnection({
830
- name: "test-mcp",
831
- command: "/usr/bin/fake-mcp",
832
- });
833
-
834
- await conn.initialize();
835
-
836
- const notifPromise = new Promise<void>((resolve) => {
837
- conn.on("tools/list_changed", resolve);
838
- });
839
-
840
- fakeProcess.stdout.write(
841
- JSON.stringify({
842
- jsonrpc: "2.0",
843
- method: "notifications/tools/list_changed",
844
- params: {},
845
- }) + "\n",
846
- );
847
-
848
- await notifPromise;
849
- });
850
-
851
- it("should forward resources/list_changed notification", async () => {
852
- setupAutoResponder((method) => {
853
- if (method === "initialize") return INIT_RESULT;
854
- return undefined;
855
- });
856
-
857
- conn = new MCPServerConnection({
858
- name: "test-mcp",
859
- command: "/usr/bin/fake-mcp",
860
- });
861
-
862
- await conn.initialize();
863
-
864
- const notifPromise = new Promise<void>((resolve) => {
865
- conn.on("resources/list_changed", resolve);
866
- });
867
-
868
- fakeProcess.stdout.write(
869
- JSON.stringify({
870
- jsonrpc: "2.0",
871
- method: "notifications/resources/list_changed",
872
- params: {},
873
- }) + "\n",
874
- );
875
-
876
- await notifPromise;
877
- });
878
- });
879
- });