@copilotkit/aimock 1.43.0 → 1.45.0

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 (396) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +46 -0
  4. package/README.md +14 -2
  5. package/dist/agui-handler.d.ts.map +1 -1
  6. package/dist/aimock-cli.cjs +31 -5
  7. package/dist/aimock-cli.cjs.map +1 -1
  8. package/dist/aimock-cli.d.cts.map +1 -1
  9. package/dist/aimock-cli.d.ts.map +1 -1
  10. package/dist/aimock-cli.js +31 -5
  11. package/dist/aimock-cli.js.map +1 -1
  12. package/dist/bedrock-converse.cjs +344 -43
  13. package/dist/bedrock-converse.cjs.map +1 -1
  14. package/dist/bedrock-converse.d.cts.map +1 -1
  15. package/dist/bedrock-converse.d.ts.map +1 -1
  16. package/dist/bedrock-converse.js +345 -44
  17. package/dist/bedrock-converse.js.map +1 -1
  18. package/dist/bedrock.cjs +195 -42
  19. package/dist/bedrock.cjs.map +1 -1
  20. package/dist/bedrock.d.cts.map +1 -1
  21. package/dist/bedrock.d.ts.map +1 -1
  22. package/dist/bedrock.js +196 -43
  23. package/dist/bedrock.js.map +1 -1
  24. package/dist/chaos.cjs +9 -5
  25. package/dist/chaos.cjs.map +1 -1
  26. package/dist/chaos.d.cts.map +1 -1
  27. package/dist/chaos.d.ts.map +1 -1
  28. package/dist/chaos.js +10 -7
  29. package/dist/chaos.js.map +1 -1
  30. package/dist/cli.cjs +238 -9
  31. package/dist/cli.cjs.map +1 -1
  32. package/dist/cli.js +242 -13
  33. package/dist/cli.js.map +1 -1
  34. package/dist/cohere.cjs +159 -72
  35. package/dist/cohere.cjs.map +1 -1
  36. package/dist/cohere.d.cts.map +1 -1
  37. package/dist/cohere.d.ts.map +1 -1
  38. package/dist/cohere.js +160 -73
  39. package/dist/cohere.js.map +1 -1
  40. package/dist/config-loader.cjs +63 -5
  41. package/dist/config-loader.cjs.map +1 -1
  42. package/dist/config-loader.d.cts +37 -4
  43. package/dist/config-loader.d.cts.map +1 -1
  44. package/dist/config-loader.d.ts +37 -4
  45. package/dist/config-loader.d.ts.map +1 -1
  46. package/dist/config-loader.js +63 -5
  47. package/dist/config-loader.js.map +1 -1
  48. package/dist/constants.cjs +8 -0
  49. package/dist/constants.cjs.map +1 -1
  50. package/dist/constants.d.cts +6 -2
  51. package/dist/constants.d.ts +6 -2
  52. package/dist/constants.js +8 -1
  53. package/dist/constants.js.map +1 -1
  54. package/dist/echo-text.cjs +65 -0
  55. package/dist/echo-text.cjs.map +1 -0
  56. package/dist/echo-text.d.cts +22 -0
  57. package/dist/echo-text.d.cts.map +1 -0
  58. package/dist/echo-text.d.ts +22 -0
  59. package/dist/echo-text.d.ts.map +1 -0
  60. package/dist/echo-text.js +65 -0
  61. package/dist/echo-text.js.map +1 -0
  62. package/dist/embeddings.cjs +18 -1
  63. package/dist/embeddings.cjs.map +1 -1
  64. package/dist/embeddings.d.cts +1 -1
  65. package/dist/embeddings.d.cts.map +1 -1
  66. package/dist/embeddings.d.ts +1 -1
  67. package/dist/embeddings.d.ts.map +1 -1
  68. package/dist/embeddings.js +18 -1
  69. package/dist/embeddings.js.map +1 -1
  70. package/dist/fakes-plugin.cjs +131 -0
  71. package/dist/fakes-plugin.cjs.map +1 -0
  72. package/dist/fakes-plugin.d.cts +23 -0
  73. package/dist/fakes-plugin.d.cts.map +1 -0
  74. package/dist/fakes-plugin.d.ts +23 -0
  75. package/dist/fakes-plugin.d.ts.map +1 -0
  76. package/dist/fakes-plugin.js +127 -0
  77. package/dist/fakes-plugin.js.map +1 -0
  78. package/dist/files.cjs +9 -11
  79. package/dist/files.cjs.map +1 -1
  80. package/dist/files.d.cts.map +1 -1
  81. package/dist/files.d.ts.map +1 -1
  82. package/dist/files.js +10 -13
  83. package/dist/files.js.map +1 -1
  84. package/dist/fine-tuning.cjs +1 -19
  85. package/dist/fine-tuning.cjs.map +1 -1
  86. package/dist/fine-tuning.d.cts.map +1 -1
  87. package/dist/fine-tuning.d.ts.map +1 -1
  88. package/dist/fine-tuning.js +2 -20
  89. package/dist/fine-tuning.js.map +1 -1
  90. package/dist/fixture-loader-services.cjs +116 -0
  91. package/dist/fixture-loader-services.cjs.map +1 -0
  92. package/dist/fixture-loader-services.d.cts +48 -0
  93. package/dist/fixture-loader-services.d.cts.map +1 -0
  94. package/dist/fixture-loader-services.d.ts +48 -0
  95. package/dist/fixture-loader-services.d.ts.map +1 -0
  96. package/dist/fixture-loader-services.js +114 -0
  97. package/dist/fixture-loader-services.js.map +1 -0
  98. package/dist/fixture-loader.cjs +552 -29
  99. package/dist/fixture-loader.cjs.map +1 -1
  100. package/dist/fixture-loader.d.cts +140 -2
  101. package/dist/fixture-loader.d.cts.map +1 -1
  102. package/dist/fixture-loader.d.ts +140 -2
  103. package/dist/fixture-loader.d.ts.map +1 -1
  104. package/dist/fixture-loader.js +542 -31
  105. package/dist/fixture-loader.js.map +1 -1
  106. package/dist/gemini-embeddings.cjs +42 -2
  107. package/dist/gemini-embeddings.cjs.map +1 -1
  108. package/dist/gemini-embeddings.js +43 -3
  109. package/dist/gemini-embeddings.js.map +1 -1
  110. package/dist/gemini-interactions.cjs +288 -52
  111. package/dist/gemini-interactions.cjs.map +1 -1
  112. package/dist/gemini-interactions.d.cts.map +1 -1
  113. package/dist/gemini-interactions.d.ts.map +1 -1
  114. package/dist/gemini-interactions.js +289 -53
  115. package/dist/gemini-interactions.js.map +1 -1
  116. package/dist/gemini.cjs +234 -38
  117. package/dist/gemini.cjs.map +1 -1
  118. package/dist/gemini.d.cts.map +1 -1
  119. package/dist/gemini.d.ts.map +1 -1
  120. package/dist/gemini.js +235 -39
  121. package/dist/gemini.js.map +1 -1
  122. package/dist/helpers.cjs +1157 -12
  123. package/dist/helpers.cjs.map +1 -1
  124. package/dist/helpers.d.cts +85 -4
  125. package/dist/helpers.d.cts.map +1 -1
  126. package/dist/helpers.d.ts +85 -4
  127. package/dist/helpers.d.ts.map +1 -1
  128. package/dist/helpers.js +1113 -14
  129. package/dist/helpers.js.map +1 -1
  130. package/dist/images.cjs +3 -2
  131. package/dist/images.cjs.map +1 -1
  132. package/dist/images.js +3 -2
  133. package/dist/images.js.map +1 -1
  134. package/dist/index.cjs +39 -1
  135. package/dist/index.d.cts +11 -4
  136. package/dist/index.d.ts +11 -4
  137. package/dist/index.js +11 -4
  138. package/dist/jest.cjs +43 -14
  139. package/dist/jest.cjs.map +1 -1
  140. package/dist/jest.d.cts +47 -5
  141. package/dist/jest.d.cts.map +1 -1
  142. package/dist/jest.d.ts +47 -5
  143. package/dist/jest.d.ts.map +1 -1
  144. package/dist/jest.js +45 -16
  145. package/dist/jest.js.map +1 -1
  146. package/dist/journal.cjs +155 -13
  147. package/dist/journal.cjs.map +1 -1
  148. package/dist/journal.d.cts +54 -4
  149. package/dist/journal.d.cts.map +1 -1
  150. package/dist/journal.d.ts +54 -4
  151. package/dist/journal.d.ts.map +1 -1
  152. package/dist/journal.js +155 -13
  153. package/dist/journal.js.map +1 -1
  154. package/dist/live-sanitize.cjs +4 -32
  155. package/dist/live-sanitize.cjs.map +1 -1
  156. package/dist/live-sanitize.js +4 -32
  157. package/dist/live-sanitize.js.map +1 -1
  158. package/dist/llmock.cjs +204 -39
  159. package/dist/llmock.cjs.map +1 -1
  160. package/dist/llmock.d.cts +51 -1
  161. package/dist/llmock.d.cts.map +1 -1
  162. package/dist/llmock.d.ts +51 -1
  163. package/dist/llmock.d.ts.map +1 -1
  164. package/dist/llmock.js +206 -41
  165. package/dist/llmock.js.map +1 -1
  166. package/dist/mcp-fakes-mount.cjs +217 -0
  167. package/dist/mcp-fakes-mount.cjs.map +1 -0
  168. package/dist/mcp-fakes-mount.js +211 -0
  169. package/dist/mcp-fakes-mount.js.map +1 -0
  170. package/dist/mcp-fakes-report.cjs +111 -0
  171. package/dist/mcp-fakes-report.cjs.map +1 -0
  172. package/dist/mcp-fakes-report.d.cts +40 -0
  173. package/dist/mcp-fakes-report.d.cts.map +1 -0
  174. package/dist/mcp-fakes-report.d.ts +40 -0
  175. package/dist/mcp-fakes-report.d.ts.map +1 -0
  176. package/dist/mcp-fakes-report.js +107 -0
  177. package/dist/mcp-fakes-report.js.map +1 -0
  178. package/dist/mcp-fakes.cjs +1942 -0
  179. package/dist/mcp-fakes.cjs.map +1 -0
  180. package/dist/mcp-fakes.d.cts +504 -0
  181. package/dist/mcp-fakes.d.cts.map +1 -0
  182. package/dist/mcp-fakes.d.ts +504 -0
  183. package/dist/mcp-fakes.d.ts.map +1 -0
  184. package/dist/mcp-fakes.js +1937 -0
  185. package/dist/mcp-fakes.js.map +1 -0
  186. package/dist/mcp-handler.cjs +534 -27
  187. package/dist/mcp-handler.cjs.map +1 -1
  188. package/dist/mcp-handler.d.cts +49 -0
  189. package/dist/mcp-handler.d.cts.map +1 -0
  190. package/dist/mcp-handler.d.ts +49 -0
  191. package/dist/mcp-handler.d.ts.map +1 -0
  192. package/dist/mcp-handler.js +530 -28
  193. package/dist/mcp-handler.js.map +1 -1
  194. package/dist/mcp-mock.cjs +326 -47
  195. package/dist/mcp-mock.cjs.map +1 -1
  196. package/dist/mcp-mock.d.cts +97 -1
  197. package/dist/mcp-mock.d.cts.map +1 -1
  198. package/dist/mcp-mock.d.ts +97 -1
  199. package/dist/mcp-mock.d.ts.map +1 -1
  200. package/dist/mcp-mock.js +327 -48
  201. package/dist/mcp-mock.js.map +1 -1
  202. package/dist/mcp-recorder.cjs +1224 -0
  203. package/dist/mcp-recorder.cjs.map +1 -0
  204. package/dist/mcp-recorder.d.cts +108 -0
  205. package/dist/mcp-recorder.d.cts.map +1 -0
  206. package/dist/mcp-recorder.d.ts +108 -0
  207. package/dist/mcp-recorder.d.ts.map +1 -0
  208. package/dist/mcp-recorder.js +1215 -0
  209. package/dist/mcp-recorder.js.map +1 -0
  210. package/dist/mcp-stub.cjs +5 -1
  211. package/dist/mcp-stub.d.cts +3 -1
  212. package/dist/mcp-stub.d.ts +3 -1
  213. package/dist/mcp-stub.js +3 -1
  214. package/dist/mcp-types.d.cts +6 -0
  215. package/dist/mcp-types.d.ts +6 -0
  216. package/dist/message-text.cjs +192 -0
  217. package/dist/message-text.cjs.map +1 -0
  218. package/dist/message-text.d.cts +31 -0
  219. package/dist/message-text.d.cts.map +1 -0
  220. package/dist/message-text.d.ts +31 -0
  221. package/dist/message-text.d.ts.map +1 -0
  222. package/dist/message-text.js +184 -0
  223. package/dist/message-text.js.map +1 -0
  224. package/dist/messages.cjs +400 -56
  225. package/dist/messages.cjs.map +1 -1
  226. package/dist/messages.d.cts.map +1 -1
  227. package/dist/messages.d.ts.map +1 -1
  228. package/dist/messages.js +401 -58
  229. package/dist/messages.js.map +1 -1
  230. package/dist/metrics.cjs +46 -66
  231. package/dist/metrics.cjs.map +1 -1
  232. package/dist/metrics.d.cts +14 -6
  233. package/dist/metrics.d.cts.map +1 -1
  234. package/dist/metrics.d.ts +14 -6
  235. package/dist/metrics.d.ts.map +1 -1
  236. package/dist/metrics.js +32 -40
  237. package/dist/metrics.js.map +1 -1
  238. package/dist/misbehavior.cjs +1523 -0
  239. package/dist/misbehavior.cjs.map +1 -0
  240. package/dist/misbehavior.d.cts +43 -0
  241. package/dist/misbehavior.d.cts.map +1 -0
  242. package/dist/misbehavior.d.ts +43 -0
  243. package/dist/misbehavior.d.ts.map +1 -0
  244. package/dist/misbehavior.js +1511 -0
  245. package/dist/misbehavior.js.map +1 -0
  246. package/dist/ollama.cjs +315 -113
  247. package/dist/ollama.cjs.map +1 -1
  248. package/dist/ollama.d.cts.map +1 -1
  249. package/dist/ollama.d.ts.map +1 -1
  250. package/dist/ollama.js +316 -114
  251. package/dist/ollama.js.map +1 -1
  252. package/dist/openapi.cjs +3405 -0
  253. package/dist/openapi.cjs.map +1 -0
  254. package/dist/openapi.d.cts +30 -0
  255. package/dist/openapi.d.cts.map +1 -0
  256. package/dist/openapi.d.ts +30 -0
  257. package/dist/openapi.d.ts.map +1 -0
  258. package/dist/openapi.js +3404 -0
  259. package/dist/openapi.js.map +1 -0
  260. package/dist/openrouter-video.cjs +4 -4
  261. package/dist/openrouter-video.cjs.map +1 -1
  262. package/dist/openrouter-video.d.cts.map +1 -1
  263. package/dist/openrouter-video.d.ts.map +1 -1
  264. package/dist/openrouter-video.js +4 -4
  265. package/dist/openrouter-video.js.map +1 -1
  266. package/dist/record-sanitize.cjs +231 -0
  267. package/dist/record-sanitize.cjs.map +1 -0
  268. package/dist/record-sanitize.js +224 -0
  269. package/dist/record-sanitize.js.map +1 -0
  270. package/dist/recorder.cjs +115 -6
  271. package/dist/recorder.cjs.map +1 -1
  272. package/dist/recorder.d.cts +2 -1
  273. package/dist/recorder.d.cts.map +1 -1
  274. package/dist/recorder.d.ts +2 -1
  275. package/dist/recorder.d.ts.map +1 -1
  276. package/dist/recorder.js +116 -8
  277. package/dist/recorder.js.map +1 -1
  278. package/dist/responses.cjs +701 -166
  279. package/dist/responses.cjs.map +1 -1
  280. package/dist/responses.d.cts +5 -13
  281. package/dist/responses.d.cts.map +1 -1
  282. package/dist/responses.d.ts +5 -13
  283. package/dist/responses.d.ts.map +1 -1
  284. package/dist/responses.js +699 -169
  285. package/dist/responses.js.map +1 -1
  286. package/dist/route-registry.cjs +951 -0
  287. package/dist/route-registry.cjs.map +1 -0
  288. package/dist/route-registry.d.cts +33 -0
  289. package/dist/route-registry.d.cts.map +1 -0
  290. package/dist/route-registry.d.ts +33 -0
  291. package/dist/route-registry.d.ts.map +1 -0
  292. package/dist/route-registry.js +866 -0
  293. package/dist/route-registry.js.map +1 -0
  294. package/dist/router.cjs +24 -2
  295. package/dist/router.cjs.map +1 -1
  296. package/dist/router.d.cts.map +1 -1
  297. package/dist/router.d.ts.map +1 -1
  298. package/dist/router.js +25 -4
  299. package/dist/router.js.map +1 -1
  300. package/dist/server.cjs +1159 -264
  301. package/dist/server.cjs.map +1 -1
  302. package/dist/server.d.cts +4 -1
  303. package/dist/server.d.cts.map +1 -1
  304. package/dist/server.d.ts +4 -1
  305. package/dist/server.d.ts.map +1 -1
  306. package/dist/server.js +1067 -172
  307. package/dist/server.js.map +1 -1
  308. package/dist/speech.cjs +4 -2
  309. package/dist/speech.cjs.map +1 -1
  310. package/dist/speech.js +4 -2
  311. package/dist/speech.js.map +1 -1
  312. package/dist/stream-collapse.cjs +236 -34
  313. package/dist/stream-collapse.cjs.map +1 -1
  314. package/dist/stream-collapse.d.cts +39 -4
  315. package/dist/stream-collapse.d.cts.map +1 -1
  316. package/dist/stream-collapse.d.ts +39 -4
  317. package/dist/stream-collapse.d.ts.map +1 -1
  318. package/dist/stream-collapse.js +235 -35
  319. package/dist/stream-collapse.js.map +1 -1
  320. package/dist/suite.cjs +1 -1
  321. package/dist/suite.js +1 -1
  322. package/dist/transcription.cjs +2 -2
  323. package/dist/transcription.cjs.map +1 -1
  324. package/dist/transcription.d.cts.map +1 -1
  325. package/dist/transcription.d.ts.map +1 -1
  326. package/dist/transcription.js +2 -2
  327. package/dist/transcription.js.map +1 -1
  328. package/dist/types.cjs +18 -0
  329. package/dist/types.cjs.map +1 -0
  330. package/dist/types.d.cts +516 -5
  331. package/dist/types.d.cts.map +1 -1
  332. package/dist/types.d.ts +516 -5
  333. package/dist/types.d.ts.map +1 -1
  334. package/dist/types.js +17 -0
  335. package/dist/types.js.map +1 -0
  336. package/dist/validate-cli.cjs +123 -33
  337. package/dist/validate-cli.cjs.map +1 -1
  338. package/dist/validate-cli.js +125 -35
  339. package/dist/validate-cli.js.map +1 -1
  340. package/dist/vector-stores.cjs +1180 -0
  341. package/dist/vector-stores.cjs.map +1 -0
  342. package/dist/vector-stores.d.cts +106 -0
  343. package/dist/vector-stores.d.cts.map +1 -0
  344. package/dist/vector-stores.d.ts +106 -0
  345. package/dist/vector-stores.d.ts.map +1 -0
  346. package/dist/vector-stores.js +1164 -0
  347. package/dist/vector-stores.js.map +1 -0
  348. package/dist/vector-types.d.cts.map +1 -1
  349. package/dist/version.cjs +45 -0
  350. package/dist/version.cjs.map +1 -0
  351. package/dist/version.js +44 -0
  352. package/dist/version.js.map +1 -0
  353. package/dist/video.cjs +19 -0
  354. package/dist/video.cjs.map +1 -1
  355. package/dist/video.d.cts.map +1 -1
  356. package/dist/video.d.ts.map +1 -1
  357. package/dist/video.js +19 -0
  358. package/dist/video.js.map +1 -1
  359. package/dist/vitest.cjs +77 -16
  360. package/dist/vitest.cjs.map +1 -1
  361. package/dist/vitest.d.cts +38 -5
  362. package/dist/vitest.d.cts.map +1 -1
  363. package/dist/vitest.d.ts +38 -5
  364. package/dist/vitest.d.ts.map +1 -1
  365. package/dist/vitest.js +78 -17
  366. package/dist/vitest.js.map +1 -1
  367. package/dist/watcher.cjs +6 -2
  368. package/dist/watcher.cjs.map +1 -1
  369. package/dist/watcher.js +6 -2
  370. package/dist/watcher.js.map +1 -1
  371. package/dist/ws-gemini-live.cjs +210 -101
  372. package/dist/ws-gemini-live.cjs.map +1 -1
  373. package/dist/ws-gemini-live.d.cts +9 -3
  374. package/dist/ws-gemini-live.d.cts.map +1 -1
  375. package/dist/ws-gemini-live.d.ts +9 -3
  376. package/dist/ws-gemini-live.d.ts.map +1 -1
  377. package/dist/ws-gemini-live.js +211 -102
  378. package/dist/ws-gemini-live.js.map +1 -1
  379. package/dist/ws-realtime.cjs +175 -62
  380. package/dist/ws-realtime.cjs.map +1 -1
  381. package/dist/ws-realtime.d.cts +8 -3
  382. package/dist/ws-realtime.d.cts.map +1 -1
  383. package/dist/ws-realtime.d.ts +8 -3
  384. package/dist/ws-realtime.d.ts.map +1 -1
  385. package/dist/ws-realtime.js +176 -63
  386. package/dist/ws-realtime.js.map +1 -1
  387. package/dist/ws-responses.cjs +121 -16
  388. package/dist/ws-responses.cjs.map +1 -1
  389. package/dist/ws-responses.d.cts +8 -12
  390. package/dist/ws-responses.d.cts.map +1 -1
  391. package/dist/ws-responses.d.ts +8 -12
  392. package/dist/ws-responses.d.ts.map +1 -1
  393. package/dist/ws-responses.js +123 -18
  394. package/dist/ws-responses.js.map +1 -1
  395. package/package.json +13 -2
  396. package/skills/write-fixtures/SKILL.md +179 -21
package/dist/mcp-mock.js CHANGED
@@ -1,5 +1,9 @@
1
+ import { build, fixed, msg, plainText, quote } from "./message-text.js";
1
2
  import { flattenHeaders, readBody } from "./helpers.js";
2
- import { createMCPRequestHandler } from "./mcp-handler.js";
3
+ import { validateSecretValues } from "./record-sanitize.js";
4
+ import { createMCPRequestHandler, describeMcpIdentity, newMCPRequestRecord } from "./mcp-handler.js";
5
+ import { MCP_FAKES_DEFAULT_TEST_ID, McpFakeStore } from "./mcp-fakes.js";
6
+ import { McpRecorder, mcpRecordEnv } from "./mcp-recorder.js";
3
7
  import * as http$1 from "node:http";
4
8
 
5
9
  //#region src/mcp-mock.ts
@@ -8,9 +12,25 @@ var MCPMock = class {
8
12
  resources = /* @__PURE__ */ new Map();
9
13
  prompts = /* @__PURE__ */ new Map();
10
14
  sessions = /* @__PURE__ */ new Map();
15
+ /** This mount's fakes; kept across `reset()` so the id counters are never rewound. */
16
+ fakes = new McpFakeStore();
17
+ /** Fake blocks loaded since the last clear. */
18
+ fakeBlocks = 0;
19
+ /**
20
+ * Decode fallbacks already reported (L2), per live session: one key per
21
+ * field and source, plus one for undecodable query names. Dropped when the
22
+ * session is deleted.
23
+ */
24
+ decodeWarned = /* @__PURE__ */ new Map();
11
25
  server = null;
12
26
  journal = null;
13
27
  registry = null;
28
+ /** Mount logger for L1, L2 and L10; none (lines dropped) until `setLogger`. */
29
+ logger = null;
30
+ /** T1: recorded timing (`durationMs`, `atMs`) plays at value / speed. */
31
+ replaySpeed = 1;
32
+ /** MR1: the recorder while recording is on, else null (AM1). */
33
+ recorder = null;
14
34
  options;
15
35
  requestHandler;
16
36
  constructor(options) {
@@ -44,10 +64,140 @@ var MCPMock = class {
44
64
  });
45
65
  return this;
46
66
  }
67
+ /**
68
+ * Load MCP fakes from code: one `mcpFakes` value (a block, or an array of
69
+ * blocks), in the fixture-file shape, validated here. One run-time addition
70
+ * (`code#<n>` entry ids). Always appends. Returns the shadowed-entry
71
+ * warnings; on any bad block throws one `McpFakesAddError` and adds nothing.
72
+ */
73
+ loadFakes(blocks) {
74
+ const sources = Array.isArray(blocks) ? blocks.map((raw, blockIndex) => ({
75
+ source: "code",
76
+ blockIndex,
77
+ raw
78
+ })) : [{
79
+ source: "code",
80
+ blockIndex: null,
81
+ raw: blocks
82
+ }];
83
+ return this.addMcpFakes(sources, { kind: "code" });
84
+ }
85
+ addMcpFakes(blocks, origin) {
86
+ return this.addFakes(blocks, origin);
87
+ }
88
+ /** `addMcpFakes`, plus the internal `record` origin of the MCP recorder. */
89
+ addFakes(blocks, origin) {
90
+ const result = this.fakes.add(blocks, origin);
91
+ this.fakeBlocks += blocks.length;
92
+ return result;
93
+ }
94
+ /**
95
+ * The blocks on this mount that apply to `testId` and `context` (spec 6.5,
96
+ * I9), with every entry id and its consumed state for that test id. `null`
97
+ * means "none sent". Read-only: the result is deeply frozen.
98
+ */
99
+ fakesSnapshot(testId = null, context = null) {
100
+ return this.fakes.snapshot(testId, context);
101
+ }
102
+ clearMcpFakes() {
103
+ this.fakes.clear();
104
+ this.fakeBlocks = 0;
105
+ this.recorder?.reset();
106
+ }
107
+ resetScenarioState(testId) {
108
+ this.fakes.resetState(testId);
109
+ this.recorder?.reset(testId);
110
+ }
111
+ /**
112
+ * Record a real upstream MCP server (MR1): from now on every request to
113
+ * this mount is forwarded to `config.upstream` (all paths and methods), a
114
+ * fake that applies still answers locally, and each forwarded `tools/list`
115
+ * and `tools/call` is written to an `mcpFakes` file under
116
+ * `config.fixturePath`. `secretValues` and `upstreamAuth` that are
117
+ * `undefined` come from `AIMOCK_RECORD_SECRET_VALUES` and
118
+ * `AIMOCK_MCP_UPSTREAM_AUTH`, as on the CLI and config paths. Throws on an
119
+ * invalid upstream URL, a malformed `upstreamAuth` (or env auth), or a
120
+ * `secretValues` entry shorter than 8 characters.
121
+ */
122
+ enableRecording(config) {
123
+ let resolved = config;
124
+ if (config.secretValues === void 0 || config.upstreamAuth === void 0) {
125
+ const fromEnv = mcpRecordEnv(process.env);
126
+ resolved = {
127
+ ...config,
128
+ secretValues: config.secretValues ?? fromEnv.secretValues,
129
+ upstreamAuth: config.upstreamAuth ?? fromEnv.upstreamAuth
130
+ };
131
+ }
132
+ validateSecretValues(resolved.secretValues ?? []);
133
+ const recorder = new McpRecorder(this.recorderHost(), resolved);
134
+ this.recorder?.close();
135
+ this.recorder = recorder;
136
+ return this;
137
+ }
138
+ /** Stop recording: the mount serves exactly as before `enableRecording`. */
139
+ disableRecording() {
140
+ this.recorder?.close();
141
+ this.recorder = null;
142
+ return this;
143
+ }
144
+ /** @internal MR13: the recorder's write hashes and write listener, or null when not recording. */
145
+ recorderEvents() {
146
+ return this.recorder;
147
+ }
148
+ setLogger(logger) {
149
+ this.logger = logger;
150
+ }
151
+ /** T1: the speed recorded fake timing plays at; a non-positive or non-finite value is ignored. */
152
+ setReplaySpeed(speed) {
153
+ if (Number.isFinite(speed) && speed > 0) this.replaySpeed = speed;
154
+ }
155
+ /** @internal RP2 report part for this mount (src/mcp-fakes-report.ts reads it). */
156
+ fakesReportPart(testId, context, mount) {
157
+ return this.fakes.reportPart(testId, context, mount);
158
+ }
47
159
  async handleRequest(req, res, pathname) {
160
+ if (this.recorder) {
161
+ await this.recorder.handle(req, res, mountPathOf(req.url, pathname), pathname);
162
+ return true;
163
+ }
48
164
  if (pathname !== "/" && pathname !== "") return false;
49
- if (req.method !== "POST" && req.method !== "DELETE") return false;
50
- const body = await readBody(req);
165
+ if (req.method === "GET") {
166
+ this.answerMethodNotAllowed(req, res);
167
+ return true;
168
+ }
169
+ if (!isServedMethod(req.method)) return false;
170
+ await this.serve(req, res, mountPathOf(req.url, pathname), false);
171
+ return true;
172
+ }
173
+ /**
174
+ * Serve one request, in both modes (mounted: a POST or DELETE on the mount
175
+ * root; standalone: any method but GET on any path): count it, run the
176
+ * handler, journal it. A throw from the mount's own code is logged with the
177
+ * identity resolved so far, answered 500 and journaled with its message,
178
+ * never left to a generic catch.
179
+ */
180
+ async serve(req, res, mount, standalone) {
181
+ const record = newMCPRequestRecord();
182
+ try {
183
+ const body = await readBody(req);
184
+ this.countRequest(req, body);
185
+ await this.requestHandler(req, res, body, mount, record);
186
+ this.journalRequest(req, res, record);
187
+ } catch (err) {
188
+ const thrown = err instanceof Error ? err.message : String(err);
189
+ const line = build(msg`MCPMock request error (${record.identity ? describeMcpIdentity(record.identity) : msg`no identity resolved`}, mount ${plainText(mount)}): ${plainText(thrown)}`);
190
+ if (standalone || !this.logger) console.error(line);
191
+ else this.logger.error(line);
192
+ if (!res.headersSent) {
193
+ res.writeHead(500);
194
+ res.end("Internal server error");
195
+ } else if (!res.writableEnded) res.end();
196
+ this.journalRequest(req, res, record, thrown);
197
+ }
198
+ }
199
+ /** `aimock_mcp_requests_total` by JSON-RPC method (`session/delete` for DELETE). */
200
+ countRequest(req, body) {
51
201
  if (this.registry) if (req.method === "DELETE") this.registry.incrementCounter("aimock_mcp_requests_total", { method: "session/delete" });
52
202
  else try {
53
203
  const parsed = JSON.parse(body);
@@ -56,19 +206,19 @@ var MCPMock = class {
56
206
  } catch {
57
207
  this.registry.incrementCounter("aimock_mcp_requests_total", { method: "unknown" });
58
208
  }
59
- await this.requestHandler(req, res, body);
60
- if (this.journal) this.journal.add({
61
- method: req.method ?? "POST",
62
- path: req.url ?? "/",
63
- headers: flattenHeaders(req.headers),
64
- body: null,
65
- service: "mcp",
66
- response: {
67
- status: res.statusCode,
68
- fixture: null
69
- }
209
+ }
210
+ /**
211
+ * B1: answer 405 (`Allow: POST, DELETE`), journaled. Mounted, this is a GET
212
+ * on the mount root; standalone, a GET on any path.
213
+ */
214
+ answerMethodNotAllowed(req, res) {
215
+ res.writeHead(405, {
216
+ "Content-Type": "application/json",
217
+ Allow: "POST, DELETE"
70
218
  });
71
- return true;
219
+ res.end(JSON.stringify({ error: build(msg`Method not allowed: use POST or DELETE`) }));
220
+ req.resume();
221
+ this.journalRequest(req, res, null);
72
222
  }
73
223
  health() {
74
224
  return {
@@ -81,6 +231,7 @@ var MCPMock = class {
81
231
  }
82
232
  setJournal(journal) {
83
233
  this.journal = journal;
234
+ this.fakes.setMaxTestIds(journal.fixtureCountsMaxTestIdsCap);
84
235
  }
85
236
  setRegistry(registry) {
86
237
  this.registry = registry;
@@ -91,40 +242,20 @@ var MCPMock = class {
91
242
  const port = this.options.port ?? 0;
92
243
  return new Promise((resolve, reject) => {
93
244
  const srv = http$1.createServer((req, res) => {
94
- const chunks = [];
95
- req.on("data", (chunk) => chunks.push(chunk));
96
- req.on("end", () => {
97
- const body = Buffer.concat(chunks).toString();
98
- this.requestHandler(req, res, body).then(() => {
99
- if (this.journal) this.journal.add({
100
- method: req.method ?? "POST",
101
- path: req.url ?? "/",
102
- headers: flattenHeaders(req.headers),
103
- body: null,
104
- service: "mcp",
105
- response: {
106
- status: res.statusCode,
107
- fixture: null
108
- }
109
- });
110
- }).catch((err) => {
245
+ if (this.recorder) {
246
+ this.recorder.handle(req, res, "/", "/").catch((err) => {
111
247
  console.error("MCPMock request error:", err);
112
- if (!res.headersSent) {
113
- res.writeHead(500);
114
- res.end("Internal server error");
115
- } else if (!res.writableEnded) res.end();
116
- if (this.journal) this.journal.add({
117
- method: req.method ?? "POST",
118
- path: req.url ?? "/",
119
- headers: flattenHeaders(req.headers),
120
- body: null,
121
- service: "mcp",
122
- response: {
123
- status: res.statusCode,
124
- fixture: null
125
- }
126
- });
248
+ if (!res.writableEnded) res.end();
127
249
  });
250
+ return;
251
+ }
252
+ if (req.method === "GET") {
253
+ this.answerMethodNotAllowed(req, res);
254
+ return;
255
+ }
256
+ this.serve(req, res, "/", true).catch((err) => {
257
+ console.error("MCPMock request error:", err);
258
+ if (!res.writableEnded) res.end();
128
259
  });
129
260
  });
130
261
  srv.listen(port, host, () => {
@@ -156,9 +287,106 @@ var MCPMock = class {
156
287
  this.resources.clear();
157
288
  this.prompts.clear();
158
289
  this.sessions.clear();
290
+ this.decodeWarned.clear();
291
+ this.clearMcpFakes();
159
292
  this.requestHandler = this.buildHandler();
160
293
  return this;
161
294
  }
295
+ /**
296
+ * The journal entries of one handled request (B2, B3): one per JSON-RPC
297
+ * message (each element of a batch), or one with no body when the request
298
+ * carried none that was read; none without a journal (W5). `error` is what
299
+ * the mount's own code threw while serving it.
300
+ */
301
+ journalRequest(req, res, record, error) {
302
+ if (!this.journal) return;
303
+ const messages = record?.messages.length ? record.messages : [{
304
+ body: null,
305
+ mcpFake: null,
306
+ error: null
307
+ }];
308
+ for (const message of messages) {
309
+ const failed = message.error ?? error;
310
+ this.journal.add({
311
+ method: req.method ?? "POST",
312
+ path: req.url ?? "/",
313
+ headers: flattenHeaders(req.headers),
314
+ body: message.body,
315
+ service: "mcp",
316
+ ...record?.identity ? {
317
+ testId: record.identity.testId ?? MCP_FAKES_DEFAULT_TEST_ID,
318
+ context: record.identity.context
319
+ } : {},
320
+ response: {
321
+ status: res.statusCode,
322
+ fixture: null,
323
+ ...message.mcpFake ? { mcpFake: message.mcpFake } : {},
324
+ ...failed !== void 0 && failed !== null ? { error: failed } : {}
325
+ }
326
+ });
327
+ }
328
+ }
329
+ /**
330
+ * Side channels of a fake outcome (9.3): the failure metric and the L1 /
331
+ * L10 line. A claim that threw (`internal_error`) is counted and logged
332
+ * like a failure, under `MCP_FAKE_INTERNAL_ERROR`.
333
+ */
334
+ onFakeEvent(evt) {
335
+ this.fakes.logEvent(evt.identity, toReportEvent(evt));
336
+ if (evt.kind === "answered") return;
337
+ this.registry?.incrementCounter("aimock_mcp_fake_failures_total", { code: evt.code });
338
+ if (!this.logger) return;
339
+ const where = msg`mount ${plainText(evt.mount)}`;
340
+ const kind = evt.kind.replace("_", " ");
341
+ const line = evt.kind === "evicted" ? msg`MCP-FAKE: evicted testId ${quote(evt.testId)} (cap ${evt.cap}) for tools/call ${plainText(evt.tool)} (${where})` : msg`MCP-FAKE: ${fixed(kind)} for tools/call ${plainText(evt.tool)} (${describeMcpIdentity(evt.identity)}, ${where}): ${plainText(evt.message)}`;
342
+ this.logger.error(build(line));
343
+ }
344
+ /** RP2, C9: a tools/call no fake applied to is always logged, with who answered it. */
345
+ logUnfaked(evt) {
346
+ this.fakes.logEvent(evt.identity, {
347
+ outcome: "unfaked",
348
+ answeredBy: evt.answeredBy,
349
+ tool: evt.tool,
350
+ args: evt.args,
351
+ context: evt.identity.context,
352
+ mount: evt.mount
353
+ });
354
+ }
355
+ /**
356
+ * L2: one warning per session for each identity field and source whose
357
+ * value is not valid percent-encoding (H1), naming that source and value,
358
+ * and one for query names that are not valid percent-encoding.
359
+ */
360
+ onDecodeFallback(sessionId, fallback) {
361
+ let warned = this.decodeWarned.get(sessionId);
362
+ if (!warned) {
363
+ warned = /* @__PURE__ */ new Set();
364
+ this.decodeWarned.set(sessionId, warned);
365
+ }
366
+ const key = fallback.kind === "names" ? "names" : `${fallback.field}:${fallback.source}`;
367
+ if (warned.has(key)) return;
368
+ warned.add(key);
369
+ const session = quote(sessionId);
370
+ if (fallback.kind === "names") {
371
+ const one = fallback.count === 1;
372
+ this.logger?.warn(build(msg`MCP-FAKE: ${fallback.count} query parameter ${fixed(one ? "name" : "names")} on session ${session} ${fixed(one ? "is" : "are")} not valid percent-encoding; ${fixed(one ? "it matches" : "they match")} no identity field`));
373
+ return;
374
+ }
375
+ const label = DECODE_LABELS[fallback.field][fallback.source];
376
+ const fate = fallback.used ? "it is used as sent" : "it is ignored (the header value is used)";
377
+ this.logger?.warn(build(msg`MCP-FAKE: ${fixed(label)} value ${quote(fallback.raw)} on session ${session} is not valid percent-encoding; ${fixed(fate)}`));
378
+ }
379
+ /** The recorder's view of this mount (fakes, journal, logger, replay speed, side channels). */
380
+ recorderHost() {
381
+ return {
382
+ fakes: this.fakes,
383
+ addMcpFakes: (blocks, origin) => this.addFakes(blocks, origin),
384
+ journalEntry: (entry) => void this.journal?.add(entry),
385
+ logger: () => this.logger,
386
+ replaySpeed: () => this.replaySpeed,
387
+ onFakeEvent: (evt) => this.onFakeEvent(evt)
388
+ };
389
+ }
162
390
  buildHandler() {
163
391
  return createMCPRequestHandler({
164
392
  serverInfo: this.options.serverInfo ?? {
@@ -168,10 +396,61 @@ var MCPMock = class {
168
396
  tools: this.tools,
169
397
  resources: this.resources,
170
398
  prompts: this.prompts,
171
- sessions: this.sessions
399
+ sessions: this.sessions,
400
+ fakes: this.fakes,
401
+ hasFakes: () => this.fakeBlocks > 0,
402
+ onFakeEvent: (evt) => this.onFakeEvent(evt),
403
+ onDecodeFallback: (sessionId, fallback) => this.onDecodeFallback(sessionId, fallback),
404
+ onSessionClosed: (sessionId) => void this.decodeWarned.delete(sessionId),
405
+ onUnfaked: (evt) => this.logUnfaked(evt),
406
+ replaySpeed: () => this.replaySpeed
172
407
  });
173
408
  }
174
409
  };
410
+ /** RP2: a fake outcome as an event-log entry (the store assigns `seq`). */
411
+ function toReportEvent(evt) {
412
+ const base = {
413
+ tool: evt.tool,
414
+ args: evt.args,
415
+ context: evt.identity.context,
416
+ mount: evt.mount
417
+ };
418
+ return evt.kind === "answered" ? {
419
+ ...base,
420
+ outcome: "answered",
421
+ entryId: evt.entryId
422
+ } : {
423
+ ...base,
424
+ outcome: evt.kind,
425
+ code: evt.code
426
+ };
427
+ }
428
+ /** B1: the only methods the mounted mount root serves; every other one is 405. */
429
+ function isServedMethod(method) {
430
+ return method === "POST" || method === "DELETE";
431
+ }
432
+ /** The L2 label of each identity field's header and query source. */
433
+ const DECODE_LABELS = {
434
+ testId: {
435
+ header: "X-Test-Id header",
436
+ query: "?testId= query parameter"
437
+ },
438
+ context: {
439
+ header: "X-AIMock-Context header",
440
+ query: "?context= query parameter"
441
+ }
442
+ };
443
+ /**
444
+ * The path a mount is served at (I9): the request path without the
445
+ * sub-path the server handed the mount (`/mcp` for `/mcp` or `/mcp/`), `/`
446
+ * at the root.
447
+ */
448
+ function mountPathOf(url, subPath) {
449
+ const full = new URL(url ?? "/", "http://mount.invalid").pathname;
450
+ const sub = subPath === "" ? "/" : subPath;
451
+ const mount = full.endsWith(sub) ? full.slice(0, full.length - sub.length) : full;
452
+ return mount === "" ? "/" : mount;
453
+ }
175
454
 
176
455
  //#endregion
177
456
  export { MCPMock };
@@ -1 +1 @@
1
- {"version":3,"file":"mcp-mock.js","names":["http"],"sources":["../src/mcp-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type {\n MCPMockOptions,\n MCPToolDefinition,\n MCPResourceDefinition,\n MCPResourceContent,\n MCPPromptDefinition,\n MCPPromptResult,\n MCPContent,\n MCPSession,\n} from \"./mcp-types.js\";\nimport { createMCPRequestHandler, type MCPState } from \"./mcp-handler.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\n\nexport class MCPMock implements Mountable {\n private tools: Map<\n string,\n { def: MCPToolDefinition; handler?: (...args: unknown[]) => unknown }\n > = new Map();\n private resources: Map<string, { def: MCPResourceDefinition; content?: MCPResourceContent }> =\n new Map();\n private prompts: Map<\n string,\n {\n def: MCPPromptDefinition;\n handler?: (...args: unknown[]) => MCPPromptResult | Promise<MCPPromptResult>;\n }\n > = new Map();\n private sessions: Map<string, MCPSession> = new Map();\n private server: http.Server | null = null;\n private journal: Journal | null = null;\n private registry: MetricsRegistry | null = null;\n private options: MCPMockOptions;\n private requestHandler: ReturnType<typeof createMCPRequestHandler>;\n\n constructor(options?: MCPMockOptions) {\n this.options = options ?? {};\n this.requestHandler = this.buildHandler();\n }\n\n // ---- Configuration: Tools ----\n\n addTool(def: MCPToolDefinition): this {\n this.tools.set(def.name, { def });\n return this;\n }\n\n onToolCall(\n name: string,\n handler: (args: unknown) => MCPContent[] | string | Promise<MCPContent[] | string>,\n ): this {\n const entry = this.tools.get(name);\n if (entry) {\n entry.handler = handler;\n } else {\n this.tools.set(name, { def: { name }, handler });\n }\n return this;\n }\n\n // ---- Configuration: Resources ----\n\n addResource(def: MCPResourceDefinition, content?: MCPResourceContent): this {\n this.resources.set(def.uri, { def, content });\n return this;\n }\n\n // ---- Configuration: Prompts ----\n\n addPrompt(\n def: MCPPromptDefinition,\n handler?: (args: unknown) => MCPPromptResult | Promise<MCPPromptResult>,\n ): this {\n this.prompts.set(def.name, { def, handler });\n return this;\n }\n\n // ---- Mountable interface ----\n\n async handleRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n pathname: string,\n ): Promise<boolean> {\n // Only handle POST and DELETE to the root of the mount\n if (pathname !== \"/\" && pathname !== \"\") {\n return false;\n }\n if (req.method !== \"POST\" && req.method !== \"DELETE\") {\n return false;\n }\n\n const body = await readBody(req);\n\n // Extract JSON-RPC method for metrics (skip for DELETE — no JSON-RPC body)\n if (this.registry) {\n if (req.method === \"DELETE\") {\n this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"session/delete\" });\n } else {\n try {\n const parsed = JSON.parse(body);\n const method =\n typeof parsed === \"object\" && parsed !== null && \"method\" in parsed\n ? String(parsed.method)\n : \"unknown\";\n this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method });\n } catch {\n this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"unknown\" });\n }\n }\n }\n\n await this.requestHandler(req, res, body);\n\n // Journal the request after the handler completes\n if (this.journal) {\n this.journal.add({\n method: req.method ?? \"POST\",\n path: req.url ?? \"/\",\n headers: flattenHeaders(req.headers),\n body: null,\n service: \"mcp\",\n response: { status: res.statusCode, fixture: null },\n });\n }\n\n return true;\n }\n\n health(): { status: string; [key: string]: unknown } {\n return {\n status: \"ok\",\n tools: this.tools.size,\n resources: this.resources.size,\n prompts: this.prompts.size,\n sessions: this.sessions.size,\n };\n }\n\n setJournal(journal: Journal): void {\n this.journal = journal;\n }\n\n setRegistry(registry: MetricsRegistry): void {\n this.registry = registry;\n }\n\n // ---- Standalone mode ----\n\n async start(): Promise<string> {\n if (this.server) {\n throw new Error(\"Server already started\");\n }\n\n const host = this.options.host ?? \"127.0.0.1\";\n const port = this.options.port ?? 0;\n\n return new Promise((resolve, reject) => {\n const srv = http.createServer((req, res) => {\n const chunks: Buffer[] = [];\n req.on(\"data\", (chunk: Buffer) => chunks.push(chunk));\n req.on(\"end\", () => {\n const body = Buffer.concat(chunks).toString();\n\n this.requestHandler(req, res, body)\n .then(() => {\n if (this.journal) {\n this.journal.add({\n method: req.method ?? \"POST\",\n path: req.url ?? \"/\",\n headers: flattenHeaders(req.headers),\n body: null,\n service: \"mcp\",\n response: { status: res.statusCode, fixture: null },\n });\n }\n })\n .catch((err) => {\n console.error(\"MCPMock request error:\", err);\n if (!res.headersSent) {\n res.writeHead(500);\n res.end(\"Internal server error\");\n } else if (!res.writableEnded) {\n res.end();\n }\n if (this.journal) {\n this.journal.add({\n method: req.method ?? \"POST\",\n path: req.url ?? \"/\",\n headers: flattenHeaders(req.headers),\n body: null,\n service: \"mcp\",\n response: { status: res.statusCode, fixture: null },\n });\n }\n });\n });\n });\n\n srv.listen(port, host, () => {\n this.server = srv;\n const addr = srv.address();\n if (typeof addr === \"object\" && addr !== null) {\n resolve(`http://${host}:${addr.port}`);\n } else {\n resolve(`http://${host}:${port}`);\n }\n });\n\n srv.on(\"error\", reject);\n });\n }\n\n async stop(): Promise<void> {\n if (!this.server) {\n throw new Error(\"Server not started\");\n }\n const srv = this.server;\n this.server = null;\n await new Promise<void>((resolve, reject) => {\n srv.close((err) => (err ? reject(err) : resolve()));\n });\n }\n\n // ---- Inspection ----\n\n getRequests(): unknown[] {\n if (!this.journal) return [];\n return this.journal.getAll().filter((e) => e.service === \"mcp\");\n }\n\n getSessions(): Map<string, MCPSession> {\n return new Map(this.sessions);\n }\n\n reset(): this {\n this.tools.clear();\n this.resources.clear();\n this.prompts.clear();\n this.sessions.clear();\n this.requestHandler = this.buildHandler();\n return this;\n }\n\n // ---- Internal ----\n\n private buildHandler() {\n const state: MCPState = {\n serverInfo: this.options.serverInfo ?? { name: \"mcp-mock\", version: \"1.0.0\" },\n tools: this.tools,\n resources: this.resources,\n prompts: this.prompts,\n sessions: this.sessions,\n };\n return createMCPRequestHandler(state);\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"mcp-mock.js","names":["http"],"sources":["../src/mcp-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { McpFakeSource, McpRecordConfig, Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type { Logger } from \"./logger.js\";\nimport type {\n MCPMockOptions,\n MCPToolDefinition,\n MCPResourceDefinition,\n MCPResourceContent,\n MCPPromptDefinition,\n MCPPromptResult,\n MCPContent,\n MCPSession,\n} from \"./mcp-types.js\";\nimport {\n createMCPRequestHandler,\n describeMcpIdentity,\n newMCPRequestRecord,\n type McpDecodeFallback,\n type McpFakeEvent,\n type MCPMessageRecord,\n type MCPRequestRecord,\n type MCPState,\n} from \"./mcp-handler.js\";\nimport {\n MCP_FAKES_DEFAULT_TEST_ID,\n McpFakeStore,\n type McpFakeAddOrigin,\n type McpFakeAddOriginInternal,\n type McpFakeAddResult,\n type McpFakeBlockSnapshot,\n type McpFakeReportEventInput,\n type McpFakeReportPart,\n} from \"./mcp-fakes.js\";\nimport { build, fixed, msg, plainText, quote } from \"./message-text.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\nimport { McpRecorder, mcpRecordEnv, type RecorderHost } from \"./mcp-recorder.js\";\nimport { validateSecretValues } from \"./record-sanitize.js\";\n\nexport class MCPMock implements Mountable {\n private tools: Map<\n string,\n { def: MCPToolDefinition; handler?: (...args: unknown[]) => unknown }\n > = new Map();\n private resources: Map<string, { def: MCPResourceDefinition; content?: MCPResourceContent }> =\n new Map();\n private prompts: Map<\n string,\n {\n def: MCPPromptDefinition;\n handler?: (...args: unknown[]) => MCPPromptResult | Promise<MCPPromptResult>;\n }\n > = new Map();\n private sessions: Map<string, MCPSession> = new Map();\n /** This mount's fakes; kept across `reset()` so the id counters are never rewound. */\n private fakes = new McpFakeStore();\n /** Fake blocks loaded since the last clear. */\n private fakeBlocks = 0;\n /**\n * Decode fallbacks already reported (L2), per live session: one key per\n * field and source, plus one for undecodable query names. Dropped when the\n * session is deleted.\n */\n private decodeWarned = new Map<string, Set<string>>();\n private server: http.Server | null = null;\n private journal: Journal | null = null;\n private registry: MetricsRegistry | null = null;\n /** Mount logger for L1, L2 and L10; none (lines dropped) until `setLogger`. */\n private logger: Logger | null = null;\n /** T1: recorded timing (`durationMs`, `atMs`) plays at value / speed. */\n private replaySpeed = 1;\n /** MR1: the recorder while recording is on, else null (AM1). */\n private recorder: McpRecorder | null = null;\n private options: MCPMockOptions;\n private requestHandler: ReturnType<typeof createMCPRequestHandler>;\n\n constructor(options?: MCPMockOptions) {\n this.options = options ?? {};\n this.requestHandler = this.buildHandler();\n }\n\n // ---- Configuration: Tools ----\n\n addTool(def: MCPToolDefinition): this {\n this.tools.set(def.name, { def });\n return this;\n }\n\n onToolCall(\n name: string,\n handler: (args: unknown) => MCPContent[] | string | Promise<MCPContent[] | string>,\n ): this {\n const entry = this.tools.get(name);\n if (entry) {\n entry.handler = handler;\n } else {\n this.tools.set(name, { def: { name }, handler });\n }\n return this;\n }\n\n // ---- Configuration: Resources ----\n\n addResource(def: MCPResourceDefinition, content?: MCPResourceContent): this {\n this.resources.set(def.uri, { def, content });\n return this;\n }\n\n // ---- Configuration: Prompts ----\n\n addPrompt(\n def: MCPPromptDefinition,\n handler?: (args: unknown) => MCPPromptResult | Promise<MCPPromptResult>,\n ): this {\n this.prompts.set(def.name, { def, handler });\n return this;\n }\n\n // ---- Configuration: MCP fakes ----\n\n /**\n * Load MCP fakes from code: one `mcpFakes` value (a block, or an array of\n * blocks), in the fixture-file shape, validated here. One run-time addition\n * (`code#<n>` entry ids). Always appends. Returns the shadowed-entry\n * warnings; on any bad block throws one `McpFakesAddError` and adds nothing.\n */\n loadFakes(blocks: unknown): McpFakeAddResult {\n const sources: McpFakeSource[] = Array.isArray(blocks)\n ? blocks.map((raw: unknown, blockIndex) => ({ source: \"code\", blockIndex, raw }))\n : [{ source: \"code\", blockIndex: null, raw: blocks }];\n return this.addMcpFakes(sources, { kind: \"code\" });\n }\n\n addMcpFakes(blocks: McpFakeSource[], origin: McpFakeAddOrigin): McpFakeAddResult {\n return this.addFakes(blocks, origin);\n }\n\n /** `addMcpFakes`, plus the internal `record` origin of the MCP recorder. */\n private addFakes(blocks: McpFakeSource[], origin: McpFakeAddOriginInternal): McpFakeAddResult {\n const result = this.fakes.add(blocks, origin);\n this.fakeBlocks += blocks.length;\n return result;\n }\n\n /**\n * The blocks on this mount that apply to `testId` and `context` (spec 6.5,\n * I9), with every entry id and its consumed state for that test id. `null`\n * means \"none sent\". Read-only: the result is deeply frozen.\n */\n fakesSnapshot(\n testId: string | null = null,\n context: string | null = null,\n ): readonly McpFakeBlockSnapshot[] {\n return this.fakes.snapshot(testId, context);\n }\n\n clearMcpFakes(): void {\n this.fakes.clear();\n this.fakeBlocks = 0;\n this.recorder?.reset();\n }\n\n resetScenarioState(testId?: string): void {\n this.fakes.resetState(testId);\n this.recorder?.reset(testId);\n }\n\n // ---- MCP recording (MR1) ----\n\n /**\n * Record a real upstream MCP server (MR1): from now on every request to\n * this mount is forwarded to `config.upstream` (all paths and methods), a\n * fake that applies still answers locally, and each forwarded `tools/list`\n * and `tools/call` is written to an `mcpFakes` file under\n * `config.fixturePath`. `secretValues` and `upstreamAuth` that are\n * `undefined` come from `AIMOCK_RECORD_SECRET_VALUES` and\n * `AIMOCK_MCP_UPSTREAM_AUTH`, as on the CLI and config paths. Throws on an\n * invalid upstream URL, a malformed `upstreamAuth` (or env auth), or a\n * `secretValues` entry shorter than 8 characters.\n */\n enableRecording(config: McpRecordConfig): this {\n let resolved = config;\n if (config.secretValues === undefined || config.upstreamAuth === undefined) {\n const fromEnv = mcpRecordEnv(process.env);\n resolved = {\n ...config,\n secretValues: config.secretValues ?? fromEnv.secretValues,\n upstreamAuth: config.upstreamAuth ?? fromEnv.upstreamAuth,\n };\n }\n validateSecretValues(resolved.secretValues ?? []);\n const recorder = new McpRecorder(this.recorderHost(), resolved);\n this.recorder?.close();\n this.recorder = recorder;\n return this;\n }\n\n /** Stop recording: the mount serves exactly as before `enableRecording`. */\n disableRecording(): this {\n this.recorder?.close();\n this.recorder = null;\n return this;\n }\n\n /** @internal MR13: the recorder's write hashes and write listener, or null when not recording. */\n recorderEvents(): Pick<McpRecorder, \"lastWrittenHash\" | \"onWrite\"> | null {\n return this.recorder;\n }\n\n setLogger(logger: Logger): void {\n this.logger = logger;\n }\n\n /** T1: the speed recorded fake timing plays at; a non-positive or non-finite value is ignored. */\n setReplaySpeed(speed: number): void {\n if (Number.isFinite(speed) && speed > 0) this.replaySpeed = speed;\n }\n\n /** @internal RP2 report part for this mount (src/mcp-fakes-report.ts reads it). */\n fakesReportPart(testId: string | null, context: string | null, mount: string): McpFakeReportPart {\n return this.fakes.reportPart(testId, context, mount);\n }\n\n // ---- Mountable interface ----\n\n async handleRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n pathname: string,\n ): Promise<boolean> {\n // AM1 (a): in record mode every path and method under the mount is the\n // recorder's, before the off-root check and the B1 GET answer.\n if (this.recorder) {\n await this.recorder.handle(req, res, mountPathOf(req.url, pathname), pathname);\n return true;\n }\n // Off the mount root: not this mount's request (fall through).\n if (pathname !== \"/\" && pathname !== \"\") {\n return false;\n }\n // B1: a GET on the mount root is 405. Any other method but POST and\n // DELETE falls through to the next route, as on origin/main.\n if (req.method === \"GET\") {\n this.answerMethodNotAllowed(req, res);\n return true;\n }\n if (!isServedMethod(req.method)) {\n return false;\n }\n await this.serve(req, res, mountPathOf(req.url, pathname), false);\n return true;\n }\n\n /**\n * Serve one request, in both modes (mounted: a POST or DELETE on the mount\n * root; standalone: any method but GET on any path): count it, run the\n * handler, journal it. A throw from the mount's own code is logged with the\n * identity resolved so far, answered 500 and journaled with its message,\n * never left to a generic catch.\n */\n private async serve(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n mount: string,\n standalone: boolean,\n ): Promise<void> {\n const record = newMCPRequestRecord();\n try {\n const body = await readBody(req);\n this.countRequest(req, body);\n await this.requestHandler(req, res, body, mount, record);\n this.journalRequest(req, res, record);\n } catch (err) {\n const thrown = err instanceof Error ? err.message : String(err);\n const who = record.identity\n ? describeMcpIdentity(record.identity)\n : msg`no identity resolved`;\n const line = build(\n msg`MCPMock request error (${who}, mount ${plainText(mount)}): ${plainText(thrown)}`,\n );\n // W5: the standalone server always prints the error, as on origin/main,\n // even when the mount also has a server's (possibly silent) logger.\n // Mounted, it goes to the server's logger, as origin/main's route error did.\n if (standalone || !this.logger) console.error(line);\n else this.logger.error(line);\n if (!res.headersSent) {\n res.writeHead(500);\n res.end(\"Internal server error\");\n } else if (!res.writableEnded) {\n res.end();\n }\n this.journalRequest(req, res, record, thrown);\n }\n }\n\n /** `aimock_mcp_requests_total` by JSON-RPC method (`session/delete` for DELETE). */\n private countRequest(req: http.IncomingMessage, body: string): void {\n if (this.registry) {\n if (req.method === \"DELETE\") {\n this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"session/delete\" });\n } else {\n try {\n const parsed = JSON.parse(body);\n const method =\n typeof parsed === \"object\" && parsed !== null && \"method\" in parsed\n ? String(parsed.method)\n : \"unknown\";\n this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method });\n } catch {\n this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"unknown\" });\n }\n }\n }\n }\n\n /**\n * B1: answer 405 (`Allow: POST, DELETE`), journaled. Mounted, this is a GET\n * on the mount root; standalone, a GET on any path.\n */\n private answerMethodNotAllowed(req: http.IncomingMessage, res: http.ServerResponse): void {\n res.writeHead(405, { \"Content-Type\": \"application/json\", Allow: \"POST, DELETE\" });\n res.end(JSON.stringify({ error: build(msg`Method not allowed: use POST or DELETE`) }));\n req.resume();\n this.journalRequest(req, res, null);\n }\n\n health(): { status: string; [key: string]: unknown } {\n return {\n status: \"ok\",\n tools: this.tools.size,\n resources: this.resources.size,\n prompts: this.prompts.size,\n sessions: this.sessions.size,\n };\n }\n\n setJournal(journal: Journal): void {\n this.journal = journal;\n // I5: the fakes' test-id cap follows the journal's (`0` = unbounded).\n this.fakes.setMaxTestIds(journal.fixtureCountsMaxTestIdsCap);\n }\n\n setRegistry(registry: MetricsRegistry): void {\n this.registry = registry;\n }\n\n // ---- Standalone mode ----\n\n async start(): Promise<string> {\n if (this.server) {\n throw new Error(\"Server already started\");\n }\n\n const host = this.options.host ?? \"127.0.0.1\";\n const port = this.options.port ?? 0;\n\n return new Promise((resolve, reject) => {\n // The standalone server serves every path, as it always has: every\n // method but GET goes to the MCP handler on any path. B1: a GET on any\n // path is 405 (`Allow: POST, DELETE`) and journaled, so the SDK's\n // optional GET SSE stream is declined, not mishandled.\n const srv = http.createServer((req, res) => {\n // AM1 (b): in record mode the recorder takes every request first. A\n // standalone server serves every path as its root, so every request\n // maps to the upstream endpoint itself (review r2 N3).\n if (this.recorder) {\n this.recorder.handle(req, res, \"/\", \"/\").catch((err: unknown) => {\n console.error(\"MCPMock request error:\", err);\n if (!res.writableEnded) res.end();\n });\n return;\n }\n if (req.method === \"GET\") {\n this.answerMethodNotAllowed(req, res);\n return;\n }\n // serve() catches the request's own errors; this is only a logger\n // that threw while reporting one.\n this.serve(req, res, \"/\", true).catch((err: unknown) => {\n console.error(\"MCPMock request error:\", err);\n if (!res.writableEnded) res.end();\n });\n });\n\n srv.listen(port, host, () => {\n this.server = srv;\n const addr = srv.address();\n if (typeof addr === \"object\" && addr !== null) {\n resolve(`http://${host}:${addr.port}`);\n } else {\n resolve(`http://${host}:${port}`);\n }\n });\n\n srv.on(\"error\", reject);\n });\n }\n\n async stop(): Promise<void> {\n if (!this.server) {\n throw new Error(\"Server not started\");\n }\n const srv = this.server;\n this.server = null;\n await new Promise<void>((resolve, reject) => {\n srv.close((err) => (err ? reject(err) : resolve()));\n });\n }\n\n // ---- Inspection ----\n\n getRequests(): unknown[] {\n if (!this.journal) return [];\n return this.journal.getAll().filter((e) => e.service === \"mcp\");\n }\n\n getSessions(): Map<string, MCPSession> {\n return new Map(this.sessions);\n }\n\n reset(): this {\n this.tools.clear();\n this.resources.clear();\n this.prompts.clear();\n this.sessions.clear();\n this.decodeWarned.clear();\n // R8: fakes and their consumption state go; the id counters stay.\n this.clearMcpFakes();\n this.requestHandler = this.buildHandler();\n return this;\n }\n\n // ---- Internal ----\n\n /**\n * The journal entries of one handled request (B2, B3): one per JSON-RPC\n * message (each element of a batch), or one with no body when the request\n * carried none that was read; none without a journal (W5). `error` is what\n * the mount's own code threw while serving it.\n */\n private journalRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n record: MCPRequestRecord | null,\n error?: string,\n ): void {\n if (!this.journal) return;\n const messages: MCPMessageRecord[] = record?.messages.length\n ? record.messages\n : [{ body: null, mcpFake: null, error: null }];\n for (const message of messages) {\n const failed = message.error ?? error;\n this.journal.add({\n method: req.method ?? \"POST\",\n path: req.url ?? \"/\",\n headers: flattenHeaders(req.headers),\n body: message.body,\n service: \"mcp\",\n ...(record?.identity\n ? {\n testId: record.identity.testId ?? MCP_FAKES_DEFAULT_TEST_ID,\n context: record.identity.context,\n }\n : {}),\n response: {\n status: res.statusCode,\n fixture: null,\n ...(message.mcpFake ? { mcpFake: message.mcpFake } : {}),\n ...(failed !== undefined && failed !== null ? { error: failed } : {}),\n },\n });\n }\n }\n\n /**\n * Side channels of a fake outcome (9.3): the failure metric and the L1 /\n * L10 line. A claim that threw (`internal_error`) is counted and logged\n * like a failure, under `MCP_FAKE_INTERNAL_ERROR`.\n */\n private onFakeEvent(evt: McpFakeEvent): void {\n // RP2, C9: every fake outcome goes to the event log.\n this.fakes.logEvent(evt.identity, toReportEvent(evt));\n if (evt.kind === \"answered\") return;\n this.registry?.incrementCounter(\"aimock_mcp_fake_failures_total\", { code: evt.code });\n if (!this.logger) return;\n const where = msg`mount ${plainText(evt.mount)}`;\n // \"not declared\", \"internal error\"; the other kinds are one word.\n const kind = evt.kind.replace(\"_\", \" \");\n const line =\n evt.kind === \"evicted\"\n ? msg`MCP-FAKE: evicted testId ${quote(evt.testId)} (cap ${evt.cap}) for tools/call ${plainText(evt.tool)} (${where})`\n : msg`MCP-FAKE: ${fixed(kind)} for tools/call ${plainText(evt.tool)} (${describeMcpIdentity(evt.identity)}, ${where}): ${plainText(evt.message)}`;\n this.logger.error(build(line));\n }\n\n /** RP2, C9: a tools/call no fake applied to is always logged, with who answered it. */\n private logUnfaked(evt: Parameters<MCPState[\"onUnfaked\"]>[0]): void {\n this.fakes.logEvent(evt.identity, {\n outcome: \"unfaked\",\n answeredBy: evt.answeredBy,\n tool: evt.tool,\n args: evt.args,\n context: evt.identity.context,\n mount: evt.mount,\n });\n }\n\n /**\n * L2: one warning per session for each identity field and source whose\n * value is not valid percent-encoding (H1), naming that source and value,\n * and one for query names that are not valid percent-encoding.\n */\n private onDecodeFallback(sessionId: string, fallback: McpDecodeFallback): void {\n let warned = this.decodeWarned.get(sessionId);\n if (!warned) {\n warned = new Set();\n this.decodeWarned.set(sessionId, warned);\n }\n const key = fallback.kind === \"names\" ? \"names\" : `${fallback.field}:${fallback.source}`;\n if (warned.has(key)) return;\n warned.add(key);\n const session = quote(sessionId);\n if (fallback.kind === \"names\") {\n const one = fallback.count === 1;\n this.logger?.warn(\n build(\n msg`MCP-FAKE: ${fallback.count} query parameter ${fixed(one ? \"name\" : \"names\")} on session ${session} ${fixed(one ? \"is\" : \"are\")} not valid percent-encoding; ${fixed(one ? \"it matches\" : \"they match\")} no identity field`,\n ),\n );\n return;\n }\n const label = DECODE_LABELS[fallback.field][fallback.source];\n const fate = fallback.used ? \"it is used as sent\" : \"it is ignored (the header value is used)\";\n this.logger?.warn(\n build(\n msg`MCP-FAKE: ${fixed(label)} value ${quote(fallback.raw)} on session ${session} is not valid percent-encoding; ${fixed(fate)}`,\n ),\n );\n }\n\n /** The recorder's view of this mount (fakes, journal, logger, replay speed, side channels). */\n private recorderHost(): RecorderHost {\n const fakes = this.fakes;\n return {\n fakes,\n addMcpFakes: (blocks, origin) => this.addFakes(blocks, origin),\n journalEntry: (entry) => void this.journal?.add(entry),\n logger: () => this.logger,\n replaySpeed: () => this.replaySpeed,\n onFakeEvent: (evt) => this.onFakeEvent(evt),\n };\n }\n\n private buildHandler() {\n const state: MCPState = {\n serverInfo: this.options.serverInfo ?? { name: \"mcp-mock\", version: \"1.0.0\" },\n tools: this.tools,\n resources: this.resources,\n prompts: this.prompts,\n sessions: this.sessions,\n fakes: this.fakes,\n hasFakes: () => this.fakeBlocks > 0,\n onFakeEvent: (evt) => this.onFakeEvent(evt),\n onDecodeFallback: (sessionId, fallback) => this.onDecodeFallback(sessionId, fallback),\n onSessionClosed: (sessionId) => void this.decodeWarned.delete(sessionId),\n onUnfaked: (evt) => this.logUnfaked(evt),\n replaySpeed: () => this.replaySpeed,\n };\n return createMCPRequestHandler(state);\n }\n}\n\n/** RP2: a fake outcome as an event-log entry (the store assigns `seq`). */\nfunction toReportEvent(evt: McpFakeEvent): McpFakeReportEventInput {\n const base = { tool: evt.tool, args: evt.args, context: evt.identity.context, mount: evt.mount };\n return evt.kind === \"answered\"\n ? { ...base, outcome: \"answered\", entryId: evt.entryId }\n : { ...base, outcome: evt.kind, code: evt.code };\n}\n\n/** B1: the only methods the mounted mount root serves; every other one is 405. */\nfunction isServedMethod(method: string | undefined): boolean {\n return method === \"POST\" || method === \"DELETE\";\n}\n\n/** The L2 label of each identity field's header and query source. */\nconst DECODE_LABELS = {\n testId: { header: \"X-Test-Id header\", query: \"?testId= query parameter\" },\n context: { header: \"X-AIMock-Context header\", query: \"?context= query parameter\" },\n} as const;\n\n/**\n * The path a mount is served at (I9): the request path without the\n * sub-path the server handed the mount (`/mcp` for `/mcp` or `/mcp/`), `/`\n * at the root.\n */\nfunction mountPathOf(url: string | undefined, subPath: string): string {\n const full = new URL(url ?? \"/\", \"http://mount.invalid\").pathname;\n const sub = subPath === \"\" ? \"/\" : subPath;\n const mount = full.endsWith(sub) ? full.slice(0, full.length - sub.length) : full;\n return mount === \"\" ? \"/\" : mount;\n}\n"],"mappings":"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"}