@copilotkit/aimock 1.44.0 → 1.45.1

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 (278) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +42 -0
  4. package/README.md +6 -0
  5. package/dist/agui-types.d.cts.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 +312 -39
  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 +313 -40
  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 +1 -0
  25. package/dist/chaos.js +1 -1
  26. package/dist/cli.cjs +152 -5
  27. package/dist/cli.cjs.map +1 -1
  28. package/dist/cli.js +155 -8
  29. package/dist/cli.js.map +1 -1
  30. package/dist/cohere.cjs +132 -71
  31. package/dist/cohere.cjs.map +1 -1
  32. package/dist/cohere.d.cts.map +1 -1
  33. package/dist/cohere.d.ts.map +1 -1
  34. package/dist/cohere.js +133 -72
  35. package/dist/cohere.js.map +1 -1
  36. package/dist/config-loader.cjs +62 -4
  37. package/dist/config-loader.cjs.map +1 -1
  38. package/dist/config-loader.d.cts +37 -4
  39. package/dist/config-loader.d.cts.map +1 -1
  40. package/dist/config-loader.d.ts +37 -4
  41. package/dist/config-loader.d.ts.map +1 -1
  42. package/dist/config-loader.js +62 -4
  43. package/dist/config-loader.js.map +1 -1
  44. package/dist/fakes-plugin.cjs +131 -0
  45. package/dist/fakes-plugin.cjs.map +1 -0
  46. package/dist/fakes-plugin.d.cts +23 -0
  47. package/dist/fakes-plugin.d.cts.map +1 -0
  48. package/dist/fakes-plugin.d.ts +23 -0
  49. package/dist/fakes-plugin.d.ts.map +1 -0
  50. package/dist/fakes-plugin.js +127 -0
  51. package/dist/fakes-plugin.js.map +1 -0
  52. package/dist/fixture-loader-services.cjs +1 -1
  53. package/dist/fixture-loader-services.cjs.map +1 -1
  54. package/dist/fixture-loader-services.js +1 -1
  55. package/dist/fixture-loader-services.js.map +1 -1
  56. package/dist/fixture-loader.cjs +389 -27
  57. package/dist/fixture-loader.cjs.map +1 -1
  58. package/dist/fixture-loader.d.cts +47 -3
  59. package/dist/fixture-loader.d.cts.map +1 -1
  60. package/dist/fixture-loader.d.ts +47 -3
  61. package/dist/fixture-loader.d.ts.map +1 -1
  62. package/dist/fixture-loader.js +384 -29
  63. package/dist/fixture-loader.js.map +1 -1
  64. package/dist/gemini-interactions.cjs +250 -52
  65. package/dist/gemini-interactions.cjs.map +1 -1
  66. package/dist/gemini-interactions.d.cts.map +1 -1
  67. package/dist/gemini-interactions.d.ts.map +1 -1
  68. package/dist/gemini-interactions.js +251 -53
  69. package/dist/gemini-interactions.js.map +1 -1
  70. package/dist/gemini.cjs +226 -37
  71. package/dist/gemini.cjs.map +1 -1
  72. package/dist/gemini.d.cts.map +1 -1
  73. package/dist/gemini.d.ts.map +1 -1
  74. package/dist/gemini.js +227 -38
  75. package/dist/gemini.js.map +1 -1
  76. package/dist/helpers.cjs +881 -7
  77. package/dist/helpers.cjs.map +1 -1
  78. package/dist/helpers.d.cts +85 -4
  79. package/dist/helpers.d.cts.map +1 -1
  80. package/dist/helpers.d.ts +85 -4
  81. package/dist/helpers.d.ts.map +1 -1
  82. package/dist/helpers.js +839 -8
  83. package/dist/helpers.js.map +1 -1
  84. package/dist/index.cjs +9 -0
  85. package/dist/index.d.cts +7 -5
  86. package/dist/index.d.ts +7 -5
  87. package/dist/index.js +4 -3
  88. package/dist/jest.cjs +31 -7
  89. package/dist/jest.cjs.map +1 -1
  90. package/dist/jest.d.cts +43 -3
  91. package/dist/jest.d.cts.map +1 -1
  92. package/dist/jest.d.ts +43 -3
  93. package/dist/jest.d.ts.map +1 -1
  94. package/dist/jest.js +33 -9
  95. package/dist/jest.js.map +1 -1
  96. package/dist/journal.cjs +135 -13
  97. package/dist/journal.cjs.map +1 -1
  98. package/dist/journal.d.cts +38 -4
  99. package/dist/journal.d.cts.map +1 -1
  100. package/dist/journal.d.ts +38 -4
  101. package/dist/journal.d.ts.map +1 -1
  102. package/dist/journal.js +135 -13
  103. package/dist/journal.js.map +1 -1
  104. package/dist/live-sanitize.cjs +4 -32
  105. package/dist/live-sanitize.cjs.map +1 -1
  106. package/dist/live-sanitize.js +4 -32
  107. package/dist/live-sanitize.js.map +1 -1
  108. package/dist/llmock.cjs +123 -30
  109. package/dist/llmock.cjs.map +1 -1
  110. package/dist/llmock.d.cts +16 -1
  111. package/dist/llmock.d.cts.map +1 -1
  112. package/dist/llmock.d.ts +16 -1
  113. package/dist/llmock.d.ts.map +1 -1
  114. package/dist/llmock.js +125 -32
  115. package/dist/llmock.js.map +1 -1
  116. package/dist/mcp-fakes-mount.cjs +1 -0
  117. package/dist/mcp-fakes-mount.cjs.map +1 -1
  118. package/dist/mcp-fakes-mount.js +1 -0
  119. package/dist/mcp-fakes-mount.js.map +1 -1
  120. package/dist/mcp-fakes-report.cjs +111 -0
  121. package/dist/mcp-fakes-report.cjs.map +1 -0
  122. package/dist/mcp-fakes-report.d.cts +40 -0
  123. package/dist/mcp-fakes-report.d.cts.map +1 -0
  124. package/dist/mcp-fakes-report.d.ts +40 -0
  125. package/dist/mcp-fakes-report.d.ts.map +1 -0
  126. package/dist/mcp-fakes-report.js +107 -0
  127. package/dist/mcp-fakes-report.js.map +1 -0
  128. package/dist/mcp-fakes.cjs +331 -8
  129. package/dist/mcp-fakes.cjs.map +1 -1
  130. package/dist/mcp-fakes.d.cts +406 -3
  131. package/dist/mcp-fakes.d.cts.map +1 -1
  132. package/dist/mcp-fakes.d.ts +406 -3
  133. package/dist/mcp-fakes.d.ts.map +1 -1
  134. package/dist/mcp-fakes.js +331 -8
  135. package/dist/mcp-fakes.js.map +1 -1
  136. package/dist/mcp-handler.cjs +216 -17
  137. package/dist/mcp-handler.cjs.map +1 -1
  138. package/dist/mcp-handler.d.cts +49 -0
  139. package/dist/mcp-handler.d.cts.map +1 -0
  140. package/dist/mcp-handler.d.ts +49 -0
  141. package/dist/mcp-handler.d.ts.map +1 -0
  142. package/dist/mcp-handler.js +214 -18
  143. package/dist/mcp-handler.js.map +1 -1
  144. package/dist/mcp-mock.cjs +112 -1
  145. package/dist/mcp-mock.cjs.map +1 -1
  146. package/dist/mcp-mock.d.cts +33 -2
  147. package/dist/mcp-mock.d.cts.map +1 -1
  148. package/dist/mcp-mock.d.ts +33 -2
  149. package/dist/mcp-mock.d.ts.map +1 -1
  150. package/dist/mcp-mock.js +112 -1
  151. package/dist/mcp-mock.js.map +1 -1
  152. package/dist/mcp-recorder.cjs +1224 -0
  153. package/dist/mcp-recorder.cjs.map +1 -0
  154. package/dist/mcp-recorder.d.cts +108 -0
  155. package/dist/mcp-recorder.d.cts.map +1 -0
  156. package/dist/mcp-recorder.d.ts +108 -0
  157. package/dist/mcp-recorder.d.ts.map +1 -0
  158. package/dist/mcp-recorder.js +1215 -0
  159. package/dist/mcp-recorder.js.map +1 -0
  160. package/dist/messages.cjs +362 -56
  161. package/dist/messages.cjs.map +1 -1
  162. package/dist/messages.d.cts.map +1 -1
  163. package/dist/messages.d.ts.map +1 -1
  164. package/dist/messages.js +363 -58
  165. package/dist/messages.js.map +1 -1
  166. package/dist/misbehavior.cjs +1523 -0
  167. package/dist/misbehavior.cjs.map +1 -0
  168. package/dist/misbehavior.d.cts +43 -0
  169. package/dist/misbehavior.d.cts.map +1 -0
  170. package/dist/misbehavior.d.ts +43 -0
  171. package/dist/misbehavior.d.ts.map +1 -0
  172. package/dist/misbehavior.js +1511 -0
  173. package/dist/misbehavior.js.map +1 -0
  174. package/dist/ollama.cjs +310 -112
  175. package/dist/ollama.cjs.map +1 -1
  176. package/dist/ollama.d.cts.map +1 -1
  177. package/dist/ollama.d.ts.map +1 -1
  178. package/dist/ollama.js +311 -113
  179. package/dist/ollama.js.map +1 -1
  180. package/dist/openrouter-video.cjs +30 -2
  181. package/dist/openrouter-video.cjs.map +1 -1
  182. package/dist/openrouter-video.d.cts.map +1 -1
  183. package/dist/openrouter-video.d.ts.map +1 -1
  184. package/dist/openrouter-video.js +30 -2
  185. package/dist/openrouter-video.js.map +1 -1
  186. package/dist/record-sanitize.cjs +231 -0
  187. package/dist/record-sanitize.cjs.map +1 -0
  188. package/dist/record-sanitize.js +224 -0
  189. package/dist/record-sanitize.js.map +1 -0
  190. package/dist/recorder.cjs +106 -5
  191. package/dist/recorder.cjs.map +1 -1
  192. package/dist/recorder.d.cts +2 -1
  193. package/dist/recorder.d.cts.map +1 -1
  194. package/dist/recorder.d.ts +2 -1
  195. package/dist/recorder.d.ts.map +1 -1
  196. package/dist/recorder.js +107 -7
  197. package/dist/recorder.js.map +1 -1
  198. package/dist/responses.cjs +667 -171
  199. package/dist/responses.cjs.map +1 -1
  200. package/dist/responses.d.cts +5 -13
  201. package/dist/responses.d.cts.map +1 -1
  202. package/dist/responses.d.ts +5 -13
  203. package/dist/responses.d.ts.map +1 -1
  204. package/dist/responses.js +665 -174
  205. package/dist/responses.js.map +1 -1
  206. package/dist/router.cjs +24 -2
  207. package/dist/router.cjs.map +1 -1
  208. package/dist/router.d.cts.map +1 -1
  209. package/dist/router.d.ts.map +1 -1
  210. package/dist/router.js +25 -4
  211. package/dist/router.js.map +1 -1
  212. package/dist/server.cjs +572 -76
  213. package/dist/server.cjs.map +1 -1
  214. package/dist/server.d.cts.map +1 -1
  215. package/dist/server.d.ts.map +1 -1
  216. package/dist/server.js +574 -78
  217. package/dist/server.js.map +1 -1
  218. package/dist/stream-collapse.cjs +236 -34
  219. package/dist/stream-collapse.cjs.map +1 -1
  220. package/dist/stream-collapse.d.cts +39 -4
  221. package/dist/stream-collapse.d.cts.map +1 -1
  222. package/dist/stream-collapse.d.ts +39 -4
  223. package/dist/stream-collapse.d.ts.map +1 -1
  224. package/dist/stream-collapse.js +235 -35
  225. package/dist/stream-collapse.js.map +1 -1
  226. package/dist/types.cjs.map +1 -1
  227. package/dist/types.d.cts +315 -4
  228. package/dist/types.d.cts.map +1 -1
  229. package/dist/types.d.ts +315 -4
  230. package/dist/types.d.ts.map +1 -1
  231. package/dist/types.js.map +1 -1
  232. package/dist/validate-cli.cjs +36 -4
  233. package/dist/validate-cli.cjs.map +1 -1
  234. package/dist/validate-cli.js +37 -5
  235. package/dist/validate-cli.js.map +1 -1
  236. package/dist/vector-types.d.ts.map +1 -1
  237. package/dist/version.cjs +45 -0
  238. package/dist/version.cjs.map +1 -0
  239. package/dist/version.js +44 -0
  240. package/dist/version.js.map +1 -0
  241. package/dist/vitest.cjs +66 -10
  242. package/dist/vitest.cjs.map +1 -1
  243. package/dist/vitest.d.cts +35 -4
  244. package/dist/vitest.d.cts.map +1 -1
  245. package/dist/vitest.d.ts +35 -4
  246. package/dist/vitest.d.ts.map +1 -1
  247. package/dist/vitest.js +67 -11
  248. package/dist/vitest.js.map +1 -1
  249. package/dist/watcher.cjs +6 -2
  250. package/dist/watcher.cjs.map +1 -1
  251. package/dist/watcher.js +6 -2
  252. package/dist/watcher.js.map +1 -1
  253. package/dist/ws-gemini-live.cjs +210 -101
  254. package/dist/ws-gemini-live.cjs.map +1 -1
  255. package/dist/ws-gemini-live.d.cts +9 -3
  256. package/dist/ws-gemini-live.d.cts.map +1 -1
  257. package/dist/ws-gemini-live.d.ts +9 -3
  258. package/dist/ws-gemini-live.d.ts.map +1 -1
  259. package/dist/ws-gemini-live.js +211 -102
  260. package/dist/ws-gemini-live.js.map +1 -1
  261. package/dist/ws-realtime.cjs +175 -62
  262. package/dist/ws-realtime.cjs.map +1 -1
  263. package/dist/ws-realtime.d.cts +8 -3
  264. package/dist/ws-realtime.d.cts.map +1 -1
  265. package/dist/ws-realtime.d.ts +8 -3
  266. package/dist/ws-realtime.d.ts.map +1 -1
  267. package/dist/ws-realtime.js +176 -63
  268. package/dist/ws-realtime.js.map +1 -1
  269. package/dist/ws-responses.cjs +109 -16
  270. package/dist/ws-responses.cjs.map +1 -1
  271. package/dist/ws-responses.d.cts +8 -12
  272. package/dist/ws-responses.d.cts.map +1 -1
  273. package/dist/ws-responses.d.ts +8 -12
  274. package/dist/ws-responses.d.ts.map +1 -1
  275. package/dist/ws-responses.js +111 -18
  276. package/dist/ws-responses.js.map +1 -1
  277. package/package.json +10 -2
  278. package/skills/write-fixtures/SKILL.md +179 -21
package/dist/mcp-mock.js CHANGED
@@ -1,7 +1,9 @@
1
1
  import { build, fixed, msg, plainText, quote } from "./message-text.js";
2
2
  import { flattenHeaders, readBody } from "./helpers.js";
3
+ import { validateSecretValues } from "./record-sanitize.js";
3
4
  import { createMCPRequestHandler, describeMcpIdentity, newMCPRequestRecord } from "./mcp-handler.js";
4
5
  import { MCP_FAKES_DEFAULT_TEST_ID, McpFakeStore } from "./mcp-fakes.js";
6
+ import { McpRecorder, mcpRecordEnv } from "./mcp-recorder.js";
5
7
  import * as http$1 from "node:http";
6
8
 
7
9
  //#region src/mcp-mock.ts
@@ -25,6 +27,10 @@ var MCPMock = class {
25
27
  registry = null;
26
28
  /** Mount logger for L1, L2 and L10; none (lines dropped) until `setLogger`. */
27
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;
28
34
  options;
29
35
  requestHandler;
30
36
  constructor(options) {
@@ -77,6 +83,10 @@ var MCPMock = class {
77
83
  return this.addMcpFakes(sources, { kind: "code" });
78
84
  }
79
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) {
80
90
  const result = this.fakes.add(blocks, origin);
81
91
  this.fakeBlocks += blocks.length;
82
92
  return result;
@@ -92,14 +102,65 @@ var MCPMock = class {
92
102
  clearMcpFakes() {
93
103
  this.fakes.clear();
94
104
  this.fakeBlocks = 0;
105
+ this.recorder?.reset();
95
106
  }
96
107
  resetScenarioState(testId) {
97
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;
98
147
  }
99
148
  setLogger(logger) {
100
149
  this.logger = logger;
101
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
+ }
102
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
+ }
103
164
  if (pathname !== "/" && pathname !== "") return false;
104
165
  if (req.method === "GET") {
105
166
  this.answerMethodNotAllowed(req, res);
@@ -181,6 +242,13 @@ var MCPMock = class {
181
242
  const port = this.options.port ?? 0;
182
243
  return new Promise((resolve, reject) => {
183
244
  const srv = http$1.createServer((req, res) => {
245
+ if (this.recorder) {
246
+ this.recorder.handle(req, res, "/", "/").catch((err) => {
247
+ console.error("MCPMock request error:", err);
248
+ if (!res.writableEnded) res.end();
249
+ });
250
+ return;
251
+ }
184
252
  if (req.method === "GET") {
185
253
  this.answerMethodNotAllowed(req, res);
186
254
  return;
@@ -264,6 +332,7 @@ var MCPMock = class {
264
332
  * like a failure, under `MCP_FAKE_INTERNAL_ERROR`.
265
333
  */
266
334
  onFakeEvent(evt) {
335
+ this.fakes.logEvent(evt.identity, toReportEvent(evt));
267
336
  if (evt.kind === "answered") return;
268
337
  this.registry?.incrementCounter("aimock_mcp_fake_failures_total", { code: evt.code });
269
338
  if (!this.logger) return;
@@ -272,6 +341,17 @@ var MCPMock = class {
272
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)}`;
273
342
  this.logger.error(build(line));
274
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
+ }
275
355
  /**
276
356
  * L2: one warning per session for each identity field and source whose
277
357
  * value is not valid percent-encoding (H1), naming that source and value,
@@ -296,6 +376,17 @@ var MCPMock = class {
296
376
  const fate = fallback.used ? "it is used as sent" : "it is ignored (the header value is used)";
297
377
  this.logger?.warn(build(msg`MCP-FAKE: ${fixed(label)} value ${quote(fallback.raw)} on session ${session} is not valid percent-encoding; ${fixed(fate)}`));
298
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
+ }
299
390
  buildHandler() {
300
391
  return createMCPRequestHandler({
301
392
  serverInfo: this.options.serverInfo ?? {
@@ -310,10 +401,30 @@ var MCPMock = class {
310
401
  hasFakes: () => this.fakeBlocks > 0,
311
402
  onFakeEvent: (evt) => this.onFakeEvent(evt),
312
403
  onDecodeFallback: (sessionId, fallback) => this.onDecodeFallback(sessionId, fallback),
313
- onSessionClosed: (sessionId) => void this.decodeWarned.delete(sessionId)
404
+ onSessionClosed: (sessionId) => void this.decodeWarned.delete(sessionId),
405
+ onUnfaked: (evt) => this.logUnfaked(evt),
406
+ replaySpeed: () => this.replaySpeed
314
407
  });
315
408
  }
316
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
+ }
317
428
  /** B1: the only methods the mounted mount root serves; every other one is 405. */
318
429
  function isServedMethod(method) {
319
430
  return method === "POST" || method === "DELETE";
@@ -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 { McpFakeSource, 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 McpFakeAddResult,\n type McpFakeBlockSnapshot,\n} from \"./mcp-fakes.js\";\nimport { build, fixed, msg, plainText, quote } from \"./message-text.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 /** 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 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 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 }\n\n resetScenarioState(testId?: string): void {\n this.fakes.resetState(testId);\n }\n\n setLogger(logger: Logger): void {\n this.logger = logger;\n }\n\n // ---- Mountable interface ----\n\n async handleRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n pathname: string,\n ): Promise<boolean> {\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 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 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 /**\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 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 };\n return createMCPRequestHandler(state);\n }\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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"}
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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"}