@copilotkit/aimock 1.43.0 → 1.44.0

package/dist/llmock.js

@@ -1,9 +1,12 @@
+import { build, msg, quote } from "./message-text.js";
 import { isLiveResponse } from "./helpers.js";
 import { normalizeLiveFixture, normalizeLiveOptions } from "./live-fixture.js";
-import { INJECTED_STATUS_RANGE, clearFixtureQueue, entryToFixture, isInjectableStatus, loadFixtureFile, loadFixturesFromDir, normalizeResponse, queueOneShotError, validateFixtures } from "./fixture-loader.js";
+import { INJECTED_STATUS_RANGE, clearFixtureQueue, entryToFixture, isInjectableStatus, normalizeResponse, queueOneShotError, validateFixtures } from "./fixture-loader.js";
 import { imageResponseToFalJson, videoResponseToFalJson } from "./fal.js";
 import { voiceDesignToJson } from "./elevenlabs-voice.js";
+import { ensureFakeMount, isAutoMount, planFileFakes } from "./mcp-fakes-mount.js";
 import { createServer, createServerWithResolvedAuth, performFullReset } from "./server.js";
+import { loadFixtureFileWithServices, loadFixturesFromDirWithServices } from "./fixture-loader-services.js";
 
 //#region src/llmock.ts
 var LLMock = class LLMock {
@@ -12,6 +15,9 @@ var LLMock = class LLMock {
 	rerankFixtures = [];
 	moderationFixtures = [];
 	mounts = [];
+	/** `mcpFakes` blocks loaded before `start()`, handed to the server at start (W2). */
+	mcpFakeBuffer = [];
+	/** MCPMocks the server or a load auto-mounted (W3, W6), for the L6 check. */
 	serverInstance = null;
 	options;
 	resolvedInboundAuth;
@@ -43,15 +49,70 @@ var LLMock = class LLMock {
 	getFixtures() {
 		return this.fixtures;
 	}
+	/**
+	* Load a fixture file: its LLM fixtures and its `mcpFakes` blocks (F4).
+	* Before `start()` the blocks are buffered and handed to the server at
+	* start (W2); after it they go to the MCPMock serving each block's `mount`
+	* path, auto-mounted when none does (W6). A block that cannot be honored
+	* throws a `FixtureLoadError` and nothing from the file is added.
+	*/
 	loadFixtureFile(filePath) {
-		this.fixtures.push(...loadFixtureFile(filePath, void 0, this.options.live));
-		return this;
+		return this.acceptLoaded(loadFixtureFileWithServices(filePath, void 0, this.options.live));
 	}
+	/** As {@link loadFixtureFile}, for every fixture file under `dirPath`. */
 	loadFixtureDir(dirPath) {
-		this.fixtures.push(...loadFixturesFromDir(dirPath, void 0, this.options.live));
+		return this.acceptLoaded(loadFixturesFromDirWithServices(dirPath, void 0, this.options.live));
+	}
+	/**
+	* Add a load's fakes (all or nothing), then its LLM fixtures. Before start
+	* the fakes are checked as the start-time hand-off will check them, with
+	* the blocks already buffered and the mounts added so far, so a file whose
+	* fakes would be rejected adds nothing. A mount added after the load can
+	* still make `start()` reject.
+	*/
+	acceptLoaded(loaded) {
+		if (loaded.mcpFakes.length > 0) if (this.serverInstance) this.addFakesAfterStart(this.serverInstance, loaded.mcpFakes);
+		else {
+			planFileFakes(this.mounts, [...this.mcpFakeBuffer, ...loaded.mcpFakes], new Set(loaded.mcpFakes));
+			this.mcpFakeBuffer.push(...loaded.mcpFakes);
+		}
+		this.fixtures.push(...loaded.fixtures);
 		return this;
 	}
 	/**
+	* W6 for a load after start. Every group of blocks (by `mount` path) is
+	* checked before any mount is touched: a path held by a mount that is not
+	* an MCPMock is a mount conflict, and each group is first added to a
+	* throwaway store. Groups for an existing MCPMock are then added to it (its
+	* own add is all or nothing and finds collisions with its loaded ids);
+	* groups for a free path are added last, to a new auto-mounted MCPMock,
+	* wired as W4. The add warnings (L8) are logged at `warn`.
+	*/
+	addFakesAfterStart(server, sources) {
+		const { onExisting, onNew } = planFileFakes(this.mounts, sources);
+		const logger = server.defaults.logger;
+		for (const { handler, group } of onExisting) {
+			const result = handler.addMcpFakes?.(group, { kind: "file" });
+			for (const warning of result?.warnings ?? []) logger.warn(warning.message);
+		}
+		const registry = server.defaults.registry;
+		for (const { path, group } of onNew) {
+			const target = ensureFakeMount(this.mounts, path, {
+				journal: server.journal,
+				...registry ? { registry } : {},
+				logger
+			}, logger);
+			if ("conflict" in target) continue;
+			const result = target.handler.addMcpFakes?.(group, { kind: "file" });
+			for (const warning of result?.warnings ?? []) logger.warn(warning.message);
+		}
+	}
+	/** R4, R5: unload the fakes of every mount and the pre-start buffer. */
+	unloadMcpFakes() {
+		this.mcpFakeBuffer.length = 0;
+		for (const { handler } of this.mounts) handler.clearMcpFakes?.();
+	}
+	/**
 	* Add fixtures from a JSON string or pre-parsed array of fixture entries.
 	* Validates all fixtures and throws if any have severity "error".
 	*/
@@ -63,6 +124,7 @@ var LLMock = class LLMock {
 			throw new Error(`addFixturesFromJSON: invalid JSON — ${err instanceof Error ? err.message : String(err)}`);
 		}
 		else entries = input;
+		if (!Array.isArray(entries)) throw new TypeError("addFixturesFromJSON: expected an array of fixture entries; use loadFixtureFile for a {fixtures:[...]} file");
 		const converted = entries.map((e) => entryToFixture(e, void 0, this.options.live));
 		const errors = validateFixtures(converted, this.options.live).filter((i) => i.severity === "error");
 		if (errors.length > 0) throw new Error(`Fixture validation failed: ${JSON.stringify(errors)}`);
@@ -71,6 +133,7 @@ var LLMock = class LLMock {
 	}
 	clearFixtures() {
 		clearFixtureQueue(this.fixtures);
+		this.unloadMcpFakes();
 		return this;
 	}
 	on(match, response, opts) {
@@ -269,6 +332,7 @@ var LLMock = class LLMock {
 		return this;
 	}
 	mount(path, handler) {
+		const shadowedBy = this.serverInstance ? this.mounts.find((m) => isAutoMount(m.handler) && (path === m.path || path === m.path + "/")) : void 0;
 		this.mounts.push({
 			path,
 			handler
@@ -278,6 +342,9 @@ var LLMock = class LLMock {
 			if (handler.setBaseUrl) handler.setBaseUrl(this.serverInstance.url + path);
 			const registry = this.serverInstance.defaults.registry;
 			if (registry && handler.setRegistry) handler.setRegistry(registry);
+			const logger = this.serverInstance.defaults.logger;
+			if (handler.setLogger) handler.setLogger(logger);
+			if (shadowedBy) logger.warn(build(msg`MCP fakes: the mount at ${quote(path)} is shadowed by the MCP mock auto-mounted at ${quote(shadowedBy.path)}; its requests reach the auto-mount`));
 		}
 		return this;
 	}
@@ -294,8 +361,13 @@ var LLMock = class LLMock {
 	clearRequests() {
 		this.journal.clearEntries();
 	}
+	/**
+	* Reset fixture match counts, and the MCP fakes consumption state of every
+	* mount (R6), for `testId` or for all test ids. Fakes stay loaded.
+	*/
 	resetMatchCounts(testId) {
 		if (this.serverInstance) this.serverInstance.journal.clearMatchCounts(testId);
+		for (const { handler } of this.mounts) handler.resetScenarioState?.(testId);
 		return this;
 	}
 	/**
@@ -356,20 +428,20 @@ var LLMock = class LLMock {
 		this.searchFixtures.length = 0;
 		this.rerankFixtures.length = 0;
 		this.moderationFixtures.length = 0;
+		this.unloadMcpFakes();
 		performFullReset(this.fixtures, this.serverInstance);
 		return this;
 	}
 	async start() {
 		if (this.serverInstance) throw new Error("Server already started");
-		this.serverInstance = await (this.resolvedInboundAuth ? createServerWithResolvedAuth(this.fixtures, this.options, this.resolvedInboundAuth, this.mounts, {
-			search: this.searchFixtures,
-			rerank: this.rerankFixtures,
-			moderation: this.moderationFixtures
-		}) : createServer(this.fixtures, this.options, this.mounts, {
+		const serviceFixtures = {
 			search: this.searchFixtures,
 			rerank: this.rerankFixtures,
-			moderation: this.moderationFixtures
-		}));
+			moderation: this.moderationFixtures,
+			mcpFakes: [...this.mcpFakeBuffer]
+		};
+		this.serverInstance = await (this.resolvedInboundAuth ? createServerWithResolvedAuth(this.fixtures, this.options, this.resolvedInboundAuth, this.mounts, serviceFixtures) : createServer(this.fixtures, this.options, this.mounts, serviceFixtures));
+		this.mcpFakeBuffer.length = 0;
 		return this.serverInstance.url;
 	}
 	closeLiveSessions(testId) {

package/dist/llmock.js.map

@@ -1 +1 @@
-{"version":3,"file":"llmock.js","names":[],"sources":["../src/llmock.ts"],"sourcesContent":["import type { LiveTranscript } from \"./live-types.js\";\nimport { normalizeLiveFixture, normalizeLiveOptions } from \"./live-fixture.js\";\nimport { isLiveResponse } from \"./helpers.js\";\nimport type {\n  AudioResponse,\n  ChaosConfig,\n  EmbeddingFixtureOpts,\n  FalQueueOpts,\n  Fixture,\n  FixtureFileEntry,\n  FixtureFileResponse,\n  FixtureMatch,\n  FixtureOpts,\n  ImageResponse,\n  MockServerOptions,\n  Mountable,\n  RecordConfig,\n  ResponseFactory,\n  TranscriptionResponse,\n  VideoResponse,\n  VoiceDesignResponse,\n} from \"./types.js\";\nimport {\n  createServer,\n  createServerWithResolvedAuth,\n  performFullReset,\n  type ServerInstance,\n} from \"./server.js\";\nimport type { ResolvedInboundAuth } from \"./api-key-auth.js\";\nimport {\n  isInjectableStatus,\n  INJECTED_STATUS_RANGE,\n  queueOneShotError,\n  clearFixtureQueue,\n  loadFixtureFile,\n  loadFixturesFromDir,\n  entryToFixture,\n  normalizeResponse,\n  validateFixtures,\n} from \"./fixture-loader.js\";\nimport { Journal } from \"./journal.js\";\nimport type { SearchFixture, SearchResult } from \"./search.js\";\nimport type { RerankFixture, RerankResult } from \"./rerank.js\";\nimport type { ModerationFixture, ModerationResult } from \"./moderation.js\";\nimport { imageResponseToFalJson, videoResponseToFalJson } from \"./fal.js\";\nimport { voiceDesignToJson } from \"./elevenlabs-voice.js\";\n\nexport class LLMock {\n  private fixtures: Fixture[] = [];\n  private searchFixtures: SearchFixture[] = [];\n  private rerankFixtures: RerankFixture[] = [];\n  private moderationFixtures: ModerationFixture[] = [];\n  private mounts: Array<{ path: string; handler: Mountable }> = [];\n  private serverInstance: ServerInstance | null = null;\n  private options: MockServerOptions;\n  private readonly resolvedInboundAuth?: ResolvedInboundAuth;\n\n  constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth) {\n    this.options = options ?? {};\n    if (this.options.live !== undefined) normalizeLiveOptions(this.options.live);\n    this.resolvedInboundAuth = resolvedInboundAuth;\n  }\n\n  // ---- Fixture management ----\n\n  private normalizeFixture(fixture: Fixture): Fixture {\n    if (\n      isLiveResponse(fixture.response) ||\n      (fixture.match.endpoint === \"openai-live\" && typeof fixture.response !== \"function\")\n    ) {\n      return {\n        ...fixture,\n        match: { ...fixture.match },\n        response: normalizeLiveFixture(fixture.response, this.options.live),\n      };\n    }\n    return fixture;\n  }\n\n  addFixture(fixture: Fixture): this {\n    this.fixtures.push(this.normalizeFixture(fixture));\n    return this;\n  }\n\n  addFixtures(fixtures: Fixture[]): this {\n    this.fixtures.push(...fixtures.map((fixture) => this.normalizeFixture(fixture)));\n    return this;\n  }\n\n  prependFixture(fixture: Fixture): this {\n    this.fixtures.unshift(this.normalizeFixture(fixture));\n    return this;\n  }\n\n  getFixtures(): readonly Fixture[] {\n    return this.fixtures;\n  }\n\n  loadFixtureFile(filePath: string): this {\n    this.fixtures.push(...loadFixtureFile(filePath, undefined, this.options.live));\n    return this;\n  }\n\n  loadFixtureDir(dirPath: string): this {\n    this.fixtures.push(...loadFixturesFromDir(dirPath, undefined, this.options.live));\n    return this;\n  }\n\n  /**\n   * Add fixtures from a JSON string or pre-parsed array of fixture entries.\n   * Validates all fixtures and throws if any have severity \"error\".\n   */\n  addFixturesFromJSON(input: string | FixtureFileEntry[]): this {\n    let entries: FixtureFileEntry[];\n    if (typeof input === \"string\") {\n      try {\n        entries = JSON.parse(input);\n      } catch (err) {\n        throw new Error(\n          `addFixturesFromJSON: invalid JSON — ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      entries = input;\n    }\n    const converted = entries.map((e) => entryToFixture(e, undefined, this.options.live));\n    const issues = validateFixtures(converted, this.options.live);\n    const errors = issues.filter((i) => i.severity === \"error\");\n    if (errors.length > 0) {\n      throw new Error(`Fixture validation failed: ${JSON.stringify(errors)}`);\n    }\n    this.fixtures.push(...converted);\n    return this;\n  }\n\n  // Clears in place to preserve array reference identity — the running\n  // server reads this same array on every request — and invalidates any\n  // one-shot claim parked in flight so it cannot re-arm into the cleared queue.\n  clearFixtures(): this {\n    clearFixtureQueue(this.fixtures);\n    return this;\n  }\n\n  // ---- Convenience ----\n\n  on(\n    match: FixtureMatch,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.addFixture({\n      match,\n      response:\n        typeof response === \"function\" ? response : normalizeResponse(response, this.options.live),\n      ...opts,\n    });\n  }\n\n  onLive(\n    match: Omit<FixtureMatch, \"endpoint\">,\n    transcript: LiveTranscript,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ ...match, endpoint: \"openai-live\" }, { live: transcript }, opts);\n  }\n\n  onMessage(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern }, response, opts);\n  }\n\n  onEmbedding(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: EmbeddingFixtureOpts,\n  ): this {\n    return this.on({ inputText: pattern }, response, opts);\n  }\n\n  onJsonOutput(pattern: string | RegExp, jsonContent: object | string, opts?: FixtureOpts): this {\n    const content = typeof jsonContent === \"string\" ? jsonContent : JSON.stringify(jsonContent);\n    return this.on({ userMessage: pattern, responseFormat: \"json_object\" }, { content }, opts);\n  }\n\n  onToolCall(\n    name: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolName: name }, response, opts);\n  }\n\n  onToolResult(\n    id: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolCallId: id }, response, opts);\n  }\n\n  onTurn(\n    turn: number,\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern, turnIndex: turn }, response, opts);\n  }\n\n  onImage(prompt: string | RegExp, response: ImageResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"image\" },\n      response,\n    });\n  }\n\n  onSpeech(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: input, endpoint: \"speech\" },\n      response,\n    });\n  }\n\n  onTranscription(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"transcription\" },\n      response,\n    });\n  }\n\n  onTranslation(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"translation\" },\n      response,\n    });\n  }\n\n  onVideo(prompt: string | RegExp, response: VideoResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"video\" },\n      response,\n    });\n  }\n\n  onAudio(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({ match: { userMessage: input }, response });\n  }\n\n  onSoundEffect(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onMusic(prompt: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onElevenLabsTTS(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"elevenlabs-tts\" },\n      response,\n    });\n  }\n\n  onElevenLabsVoiceDesign(description: string | RegExp, response: VoiceDesignResponse): this {\n    return this.addFixture({\n      match: { userMessage: description, endpoint: \"elevenlabs-voice-design\" },\n      response: voiceDesignToJson(response),\n    });\n  }\n\n  onFalAudio(prompt: string | RegExp, response: AudioResponse, model?: string): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"fal-audio\", ...(model ? { model } : {}) },\n      response,\n    });\n  }\n\n  // fal.queue.* is the dominant client API; onFalRun is a sync alias.\n  //\n  // `opts.billableUnits` rides through to the completed `queue-result`\n  // response's `x-fal-billable-units` header (emitted alongside\n  // `x-fal-request-id`), letting consumers like `@tanstack/ai-fal` surface a\n  // billed-units value on replay. Omit it to preserve the header-less default.\n  onFalQueue(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    const { billableUnits, ...fixtureOpts } = opts ?? {};\n    return this.addFixture({\n      match: { model: modelOrPrompt, endpoint: \"fal\" },\n      response: { json: response, ...(billableUnits != null ? { billableUnits } : {}) },\n      ...fixtureOpts,\n    });\n  }\n\n  onFalRun(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, response, opts);\n  }\n\n  /**\n   * Register a fal.ai image fixture. Wraps an `ImageResponse` (the shape used\n   * by `onImage` and OpenAI/Azure image fixtures) into fal's image envelope\n   * before storing it as a `RawJSONResponse`. Defaults `width`/`height` to\n   * 1024 when the fixture's `ImageItem` doesn't carry them.\n   */\n  onFalImage(modelOrPrompt: string | RegExp, response: ImageResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, imageResponseToFalJson(response), opts);\n  }\n\n  /**\n   * Register a fal.ai video fixture. Wraps a `VideoResponse` into fal's video\n   * envelope (`{ video: { url, content_type, file_name, file_size }, seed }`)\n   * before storing it as a `RawJSONResponse`.\n   */\n  onFalVideo(modelOrPrompt: string | RegExp, response: VideoResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, videoResponseToFalJson(response), opts);\n  }\n\n  // ---- Service mock convenience methods ----\n\n  onSearch(pattern: string | RegExp, results: SearchResult[]): this {\n    this.searchFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onRerank(pattern: string | RegExp, results: RerankResult[]): this {\n    this.rerankFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onModerate(pattern: string | RegExp, result: ModerationResult): this {\n    this.moderationFixtures.push({ match: pattern, result });\n    return this;\n  }\n\n  /**\n   * Queue a one-shot error that will be returned for the next matching\n   * request, then automatically removed. Implemented as an internal fixture\n   * inserted at the front of the fixture list; see `queueOneShotError` for\n   * the endpoint gate and the served-not-evaluated consumption rule.\n   */\n  nextRequestError(\n    status: number,\n    errorBody?: { message?: string; type?: string; code?: string },\n  ): this {\n    // Same gate as `POST /__aimock/error` and fixture validation — this is the\n    // form the docs use, and an unchecked status reaches `res.writeHead` on\n    // the next matched request: 99/1000 throw there (the injected error is\n    // lost and the caller sees a generic 500), and 1xx hangs the request until\n    // the client times out. Throwing HERE names the offending call instead.\n    if (!isInjectableStatus(status)) {\n      throw new RangeError(\n        `nextRequestError: invalid status ${String(status)} — must be ${INJECTED_STATUS_RANGE}`,\n      );\n    }\n    queueOneShotError(this.fixtures, status, errorBody);\n    return this;\n  }\n\n  // ---- Mounts ----\n\n  mount(path: string, handler: Mountable): this {\n    this.mounts.push({ path, handler });\n\n    // If server is already running, wire up journal, registry, and baseUrl immediately\n    // so late mounts behave identically to pre-start mounts.\n    if (this.serverInstance) {\n      if (handler.setJournal) handler.setJournal(this.serverInstance.journal);\n      if (handler.setBaseUrl) handler.setBaseUrl(this.serverInstance.url + path);\n      const registry = this.serverInstance.defaults.registry;\n      if (registry && handler.setRegistry) handler.setRegistry(registry);\n    }\n\n    return this;\n  }\n\n  // ---- Journal proxies ----\n\n  getRequests(): import(\"./types.js\").JournalEntry[] {\n    return this.journal.getAll();\n  }\n\n  getLastRequest(): import(\"./types.js\").JournalEntry | null {\n    return this.journal.getLast();\n  }\n\n  /**\n   * Clear the request journal. Fixture match-counts (sequencing state) are\n   * left intact — use `resetMatchCounts()` for those.\n   */\n  clearRequests(): void {\n    this.journal.clearEntries();\n  }\n\n  resetMatchCounts(testId?: string): this {\n    if (this.serverInstance) {\n      this.serverInstance.journal.clearMatchCounts(testId);\n    }\n    return this;\n  }\n\n  // ---- Chaos ----\n\n  /**\n   * Set the server-wide chaos baseline. Writes through to a RUNNING server as\n   * well as the construction options: an untagged `POST /__aimock/chaos`\n   * installs a baseline override that shadows `options.chaos`, and without this\n   * the call would silently do nothing until the next `reset()`. Per-testId\n   * overrides still win over the baseline.\n   */\n  setChaos(config: ChaosConfig): this {\n    this.options.chaos = config;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = config;\n    return this;\n  }\n\n  /**\n   * Turn chaos off everywhere: the construction config, the runtime baseline,\n   * and every per-testId override (assigning `undefined` is the full-clear\n   * signal the `defaults.chaos` setter defines).\n   */\n  clearChaos(): this {\n    delete this.options.chaos;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = undefined;\n    return this;\n  }\n\n  // ---- Recording ----\n\n  enableRecording(config: RecordConfig): this {\n    this.options.record = config;\n    return this;\n  }\n\n  disableRecording(): this {\n    delete this.options.record;\n    return this;\n  }\n\n  // ---- Reset ----\n\n  /**\n   * Full reset — the in-process equivalent of `POST /__aimock/reset`. Shares\n   * one implementation with the control-API route so the two cannot drift.\n   *\n   * The one deliberate difference: search / rerank / moderation fixtures are\n   * also cleared here. Those are registered through this class only — the\n   * control API has no route that creates them, so the HTTP reset can neither\n   * reach nor observe them.\n   *\n   * NOT ALL OF THIS IS PER-INSTANCE. `performFullReset` clears module-global\n   * state as well: the Gemini interaction and event-id counters\n   * (`resetInteractionCounter` / `resetEventIdCounter` in\n   * `./gemini-interactions.js`), the fal.ai job/queue maps (`falJobs`,\n   * `falQueueStates`), the fine-tuning job store (`clearFineTuningStore`),\n   * and the ElevenLabs Voice Design store (`clearElevenLabsVoices`). With two\n   * `LLMock` instances live in one process,\n   * `a.reset()` rewinds the Gemini id sequence that `b` is mid-way through —\n   * `b` then re-emits `aimock-int-0` / `evt_1`, ids it has already handed\n   * out — and drops `b`'s in-flight fal jobs. Give each instance its own\n   * process (or its own vitest worker) if that matters.\n   *\n   * The global stores are cleared even before `start()`, when there is no\n   * server instance to reset.\n   */\n  reset(): this {\n    this.searchFixtures.length = 0;\n    this.rerankFixtures.length = 0;\n    this.moderationFixtures.length = 0;\n    performFullReset(this.fixtures, this.serverInstance);\n    return this;\n  }\n\n  // ---- Server lifecycle ----\n\n  async start(): Promise<string> {\n    if (this.serverInstance) {\n      throw new Error(\"Server already started\");\n    }\n    this.serverInstance = await (this.resolvedInboundAuth\n      ? createServerWithResolvedAuth(\n          this.fixtures,\n          this.options,\n          this.resolvedInboundAuth,\n          this.mounts,\n          {\n            search: this.searchFixtures,\n            rerank: this.rerankFixtures,\n            moderation: this.moderationFixtures,\n          },\n        )\n      : createServer(this.fixtures, this.options, this.mounts, {\n          search: this.searchFixtures,\n          rerank: this.rerankFixtures,\n          moderation: this.moderationFixtures,\n        }));\n    return this.serverInstance.url;\n  }\n\n  closeLiveSessions(testId?: string): this {\n    this.serverInstance?.closeLiveSessions(testId);\n    return this;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    const { server } = this.serverInstance;\n    await new Promise<void>((resolve, reject) => {\n      server.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.serverInstance = null;\n  }\n\n  // ---- Accessors ----\n\n  get journal(): Journal {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.journal;\n  }\n\n  get url(): string {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.url;\n  }\n\n  get baseUrl(): string {\n    return this.url;\n  }\n\n  get port(): number {\n    const parsed = new URL(this.url); // this.url throws if not started\n    if (!parsed.port) {\n      throw new Error(`Server URL has no explicit port: ${this.url}`);\n    }\n    return parseInt(parsed.port, 10);\n  }\n\n  // ---- Static factory ----\n\n  static async create(options?: MockServerOptions): Promise<LLMock> {\n    const instance = new LLMock(options);\n    await instance.start();\n    return instance;\n  }\n}\n\n/** @internal Configuration startup preserves a policy resolved from the selected source. */\nexport function createLLMockWithResolvedAuth(\n  options: MockServerOptions,\n  resolvedAuth: ResolvedInboundAuth,\n): LLMock {\n  return new LLMock(options, resolvedAuth);\n}\n"],"mappings":"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"}
+{"version":3,"file":"llmock.js","names":[],"sources":["../src/llmock.ts"],"sourcesContent":["import type { LiveTranscript } from \"./live-types.js\";\nimport { normalizeLiveFixture, normalizeLiveOptions } from \"./live-fixture.js\";\nimport { isLiveResponse } from \"./helpers.js\";\nimport type {\n  AudioResponse,\n  ChaosConfig,\n  EmbeddingFixtureOpts,\n  FalQueueOpts,\n  Fixture,\n  FixtureFileEntry,\n  FixtureFileResponse,\n  FixtureMatch,\n  FixtureOpts,\n  ImageResponse,\n  McpFakeSource,\n  MockServerOptions,\n  Mountable,\n  RecordConfig,\n  ResponseFactory,\n  TranscriptionResponse,\n  VideoResponse,\n  VoiceDesignResponse,\n} from \"./types.js\";\nimport {\n  createServer,\n  createServerWithResolvedAuth,\n  performFullReset,\n  type ServerInstance,\n} from \"./server.js\";\nimport type { ResolvedInboundAuth } from \"./api-key-auth.js\";\nimport {\n  isInjectableStatus,\n  INJECTED_STATUS_RANGE,\n  queueOneShotError,\n  clearFixtureQueue,\n  entryToFixture,\n  normalizeResponse,\n  validateFixtures,\n} from \"./fixture-loader.js\";\nimport {\n  loadFixtureFileWithServices,\n  loadFixturesFromDirWithServices,\n  type FixturesWithServices,\n} from \"./fixture-loader-services.js\";\nimport { ensureFakeMount, isAutoMount, planFileFakes } from \"./mcp-fakes-mount.js\";\nimport { build, msg, quote } from \"./message-text.js\";\nimport { Journal } from \"./journal.js\";\nimport type { SearchFixture, SearchResult } from \"./search.js\";\nimport type { RerankFixture, RerankResult } from \"./rerank.js\";\nimport type { ModerationFixture, ModerationResult } from \"./moderation.js\";\nimport { imageResponseToFalJson, videoResponseToFalJson } from \"./fal.js\";\nimport { voiceDesignToJson } from \"./elevenlabs-voice.js\";\n\nexport class LLMock {\n  private fixtures: Fixture[] = [];\n  private searchFixtures: SearchFixture[] = [];\n  private rerankFixtures: RerankFixture[] = [];\n  private moderationFixtures: ModerationFixture[] = [];\n  private mounts: Array<{ path: string; handler: Mountable }> = [];\n  /** `mcpFakes` blocks loaded before `start()`, handed to the server at start (W2). */\n  private mcpFakeBuffer: McpFakeSource[] = [];\n  /** MCPMocks the server or a load auto-mounted (W3, W6), for the L6 check. */\n  private serverInstance: ServerInstance | null = null;\n  private options: MockServerOptions;\n  private readonly resolvedInboundAuth?: ResolvedInboundAuth;\n\n  constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth) {\n    this.options = options ?? {};\n    if (this.options.live !== undefined) normalizeLiveOptions(this.options.live);\n    this.resolvedInboundAuth = resolvedInboundAuth;\n  }\n\n  // ---- Fixture management ----\n\n  private normalizeFixture(fixture: Fixture): Fixture {\n    if (\n      isLiveResponse(fixture.response) ||\n      (fixture.match.endpoint === \"openai-live\" && typeof fixture.response !== \"function\")\n    ) {\n      return {\n        ...fixture,\n        match: { ...fixture.match },\n        response: normalizeLiveFixture(fixture.response, this.options.live),\n      };\n    }\n    return fixture;\n  }\n\n  addFixture(fixture: Fixture): this {\n    this.fixtures.push(this.normalizeFixture(fixture));\n    return this;\n  }\n\n  addFixtures(fixtures: Fixture[]): this {\n    this.fixtures.push(...fixtures.map((fixture) => this.normalizeFixture(fixture)));\n    return this;\n  }\n\n  prependFixture(fixture: Fixture): this {\n    this.fixtures.unshift(this.normalizeFixture(fixture));\n    return this;\n  }\n\n  getFixtures(): readonly Fixture[] {\n    return this.fixtures;\n  }\n\n  /**\n   * Load a fixture file: its LLM fixtures and its `mcpFakes` blocks (F4).\n   * Before `start()` the blocks are buffered and handed to the server at\n   * start (W2); after it they go to the MCPMock serving each block's `mount`\n   * path, auto-mounted when none does (W6). A block that cannot be honored\n   * throws a `FixtureLoadError` and nothing from the file is added.\n   */\n  loadFixtureFile(filePath: string): this {\n    return this.acceptLoaded(loadFixtureFileWithServices(filePath, undefined, this.options.live));\n  }\n\n  /** As {@link loadFixtureFile}, for every fixture file under `dirPath`. */\n  loadFixtureDir(dirPath: string): this {\n    return this.acceptLoaded(\n      loadFixturesFromDirWithServices(dirPath, undefined, this.options.live),\n    );\n  }\n\n  /**\n   * Add a load's fakes (all or nothing), then its LLM fixtures. Before start\n   * the fakes are checked as the start-time hand-off will check them, with\n   * the blocks already buffered and the mounts added so far, so a file whose\n   * fakes would be rejected adds nothing. A mount added after the load can\n   * still make `start()` reject.\n   */\n  private acceptLoaded(loaded: FixturesWithServices): this {\n    if (loaded.mcpFakes.length > 0) {\n      if (this.serverInstance) {\n        this.addFakesAfterStart(this.serverInstance, loaded.mcpFakes);\n      } else {\n        planFileFakes(\n          this.mounts,\n          [...this.mcpFakeBuffer, ...loaded.mcpFakes],\n          new Set(loaded.mcpFakes),\n        );\n        this.mcpFakeBuffer.push(...loaded.mcpFakes);\n      }\n    }\n    this.fixtures.push(...loaded.fixtures);\n    return this;\n  }\n\n  /**\n   * W6 for a load after start. Every group of blocks (by `mount` path) is\n   * checked before any mount is touched: a path held by a mount that is not\n   * an MCPMock is a mount conflict, and each group is first added to a\n   * throwaway store. Groups for an existing MCPMock are then added to it (its\n   * own add is all or nothing and finds collisions with its loaded ids);\n   * groups for a free path are added last, to a new auto-mounted MCPMock,\n   * wired as W4. The add warnings (L8) are logged at `warn`.\n   */\n  private addFakesAfterStart(server: ServerInstance, sources: McpFakeSource[]): void {\n    const { onExisting, onNew } = planFileFakes(this.mounts, sources);\n\n    const logger = server.defaults.logger;\n    for (const { handler, group } of onExisting) {\n      const result = handler.addMcpFakes?.(group, { kind: \"file\" });\n      for (const warning of result?.warnings ?? []) logger.warn(warning.message);\n    }\n    const registry = server.defaults.registry;\n    for (const { path, group } of onNew) {\n      const target = ensureFakeMount(\n        this.mounts,\n        path,\n        {\n          journal: server.journal,\n          ...(registry ? { registry } : {}),\n          logger,\n        },\n        logger,\n      );\n      // The check above found no mount at this path, and nothing ran since.\n      if (\"conflict\" in target) continue;\n      const result = target.handler.addMcpFakes?.(group, { kind: \"file\" });\n      for (const warning of result?.warnings ?? []) logger.warn(warning.message);\n    }\n  }\n\n  /** R4, R5: unload the fakes of every mount and the pre-start buffer. */\n  private unloadMcpFakes(): void {\n    this.mcpFakeBuffer.length = 0;\n    for (const { handler } of this.mounts) handler.clearMcpFakes?.();\n  }\n\n  /**\n   * Add fixtures from a JSON string or pre-parsed array of fixture entries.\n   * Validates all fixtures and throws if any have severity \"error\".\n   */\n  addFixturesFromJSON(input: string | FixtureFileEntry[]): this {\n    let entries: FixtureFileEntry[];\n    if (typeof input === \"string\") {\n      try {\n        entries = JSON.parse(input);\n      } catch (err) {\n        throw new Error(\n          `addFixturesFromJSON: invalid JSON — ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      entries = input;\n    }\n    if (!Array.isArray(entries)) {\n      throw new TypeError(\n        \"addFixturesFromJSON: expected an array of fixture entries; use loadFixtureFile for a {fixtures:[...]} file\",\n      );\n    }\n    const converted = entries.map((e) => entryToFixture(e, undefined, this.options.live));\n    const issues = validateFixtures(converted, this.options.live);\n    const errors = issues.filter((i) => i.severity === \"error\");\n    if (errors.length > 0) {\n      throw new Error(`Fixture validation failed: ${JSON.stringify(errors)}`);\n    }\n    this.fixtures.push(...converted);\n    return this;\n  }\n\n  // Clears in place to preserve array reference identity — the running\n  // server reads this same array on every request — and invalidates any\n  // one-shot claim parked in flight so it cannot re-arm into the cleared queue.\n  clearFixtures(): this {\n    clearFixtureQueue(this.fixtures);\n    this.unloadMcpFakes();\n    return this;\n  }\n\n  // ---- Convenience ----\n\n  on(\n    match: FixtureMatch,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.addFixture({\n      match,\n      response:\n        typeof response === \"function\" ? response : normalizeResponse(response, this.options.live),\n      ...opts,\n    });\n  }\n\n  onLive(\n    match: Omit<FixtureMatch, \"endpoint\">,\n    transcript: LiveTranscript,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ ...match, endpoint: \"openai-live\" }, { live: transcript }, opts);\n  }\n\n  onMessage(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern }, response, opts);\n  }\n\n  onEmbedding(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: EmbeddingFixtureOpts,\n  ): this {\n    return this.on({ inputText: pattern }, response, opts);\n  }\n\n  onJsonOutput(pattern: string | RegExp, jsonContent: object | string, opts?: FixtureOpts): this {\n    const content = typeof jsonContent === \"string\" ? jsonContent : JSON.stringify(jsonContent);\n    return this.on({ userMessage: pattern, responseFormat: \"json_object\" }, { content }, opts);\n  }\n\n  onToolCall(\n    name: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolName: name }, response, opts);\n  }\n\n  onToolResult(\n    id: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolCallId: id }, response, opts);\n  }\n\n  onTurn(\n    turn: number,\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern, turnIndex: turn }, response, opts);\n  }\n\n  onImage(prompt: string | RegExp, response: ImageResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"image\" },\n      response,\n    });\n  }\n\n  onSpeech(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: input, endpoint: \"speech\" },\n      response,\n    });\n  }\n\n  onTranscription(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"transcription\" },\n      response,\n    });\n  }\n\n  onTranslation(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"translation\" },\n      response,\n    });\n  }\n\n  onVideo(prompt: string | RegExp, response: VideoResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"video\" },\n      response,\n    });\n  }\n\n  onAudio(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({ match: { userMessage: input }, response });\n  }\n\n  onSoundEffect(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onMusic(prompt: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onElevenLabsTTS(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"elevenlabs-tts\" },\n      response,\n    });\n  }\n\n  onElevenLabsVoiceDesign(description: string | RegExp, response: VoiceDesignResponse): this {\n    return this.addFixture({\n      match: { userMessage: description, endpoint: \"elevenlabs-voice-design\" },\n      response: voiceDesignToJson(response),\n    });\n  }\n\n  onFalAudio(prompt: string | RegExp, response: AudioResponse, model?: string): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"fal-audio\", ...(model ? { model } : {}) },\n      response,\n    });\n  }\n\n  // fal.queue.* is the dominant client API; onFalRun is a sync alias.\n  //\n  // `opts.billableUnits` rides through to the completed `queue-result`\n  // response's `x-fal-billable-units` header (emitted alongside\n  // `x-fal-request-id`), letting consumers like `@tanstack/ai-fal` surface a\n  // billed-units value on replay. Omit it to preserve the header-less default.\n  onFalQueue(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    const { billableUnits, ...fixtureOpts } = opts ?? {};\n    return this.addFixture({\n      match: { model: modelOrPrompt, endpoint: \"fal\" },\n      response: { json: response, ...(billableUnits != null ? { billableUnits } : {}) },\n      ...fixtureOpts,\n    });\n  }\n\n  onFalRun(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, response, opts);\n  }\n\n  /**\n   * Register a fal.ai image fixture. Wraps an `ImageResponse` (the shape used\n   * by `onImage` and OpenAI/Azure image fixtures) into fal's image envelope\n   * before storing it as a `RawJSONResponse`. Defaults `width`/`height` to\n   * 1024 when the fixture's `ImageItem` doesn't carry them.\n   */\n  onFalImage(modelOrPrompt: string | RegExp, response: ImageResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, imageResponseToFalJson(response), opts);\n  }\n\n  /**\n   * Register a fal.ai video fixture. Wraps a `VideoResponse` into fal's video\n   * envelope (`{ video: { url, content_type, file_name, file_size }, seed }`)\n   * before storing it as a `RawJSONResponse`.\n   */\n  onFalVideo(modelOrPrompt: string | RegExp, response: VideoResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, videoResponseToFalJson(response), opts);\n  }\n\n  // ---- Service mock convenience methods ----\n\n  onSearch(pattern: string | RegExp, results: SearchResult[]): this {\n    this.searchFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onRerank(pattern: string | RegExp, results: RerankResult[]): this {\n    this.rerankFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onModerate(pattern: string | RegExp, result: ModerationResult): this {\n    this.moderationFixtures.push({ match: pattern, result });\n    return this;\n  }\n\n  /**\n   * Queue a one-shot error that will be returned for the next matching\n   * request, then automatically removed. Implemented as an internal fixture\n   * inserted at the front of the fixture list; see `queueOneShotError` for\n   * the endpoint gate and the served-not-evaluated consumption rule.\n   */\n  nextRequestError(\n    status: number,\n    errorBody?: { message?: string; type?: string; code?: string },\n  ): this {\n    // Same gate as `POST /__aimock/error` and fixture validation — this is the\n    // form the docs use, and an unchecked status reaches `res.writeHead` on\n    // the next matched request: 99/1000 throw there (the injected error is\n    // lost and the caller sees a generic 500), and 1xx hangs the request until\n    // the client times out. Throwing HERE names the offending call instead.\n    if (!isInjectableStatus(status)) {\n      throw new RangeError(\n        `nextRequestError: invalid status ${String(status)} — must be ${INJECTED_STATUS_RANGE}`,\n      );\n    }\n    queueOneShotError(this.fixtures, status, errorBody);\n    return this;\n  }\n\n  // ---- Mounts ----\n\n  mount(path: string, handler: Mountable): this {\n    // W4: an auto-mounted MCPMock at `path` takes its requests first (dispatch\n    // takes the first match), so the new mount is shadowed; so is one at\n    // `path` plus \"/\", whose root request the auto-mount answers as its own.\n    // An auto-mount lets any other sub-path fall through: that is no shadow.\n    const shadowedBy = this.serverInstance\n      ? this.mounts.find(\n          (m) => isAutoMount(m.handler) && (path === m.path || path === m.path + \"/\"),\n        )\n      : undefined;\n    this.mounts.push({ path, handler });\n\n    // If server is already running, wire up journal, registry, logger and baseUrl\n    // immediately so late mounts behave identically to pre-start mounts.\n    if (this.serverInstance) {\n      if (handler.setJournal) handler.setJournal(this.serverInstance.journal);\n      if (handler.setBaseUrl) handler.setBaseUrl(this.serverInstance.url + path);\n      const registry = this.serverInstance.defaults.registry;\n      if (registry && handler.setRegistry) handler.setRegistry(registry);\n      const logger = this.serverInstance.defaults.logger;\n      if (handler.setLogger) handler.setLogger(logger);\n      if (shadowedBy) {\n        logger.warn(\n          build(\n            msg`MCP fakes: the mount at ${quote(path)} is shadowed by the MCP mock auto-mounted at ${quote(shadowedBy.path)}; its requests reach the auto-mount`,\n          ),\n        );\n      }\n    }\n\n    return this;\n  }\n\n  // ---- Journal proxies ----\n\n  getRequests(): import(\"./types.js\").JournalEntry[] {\n    return this.journal.getAll();\n  }\n\n  getLastRequest(): import(\"./types.js\").JournalEntry | null {\n    return this.journal.getLast();\n  }\n\n  /**\n   * Clear the request journal. Fixture match-counts (sequencing state) are\n   * left intact — use `resetMatchCounts()` for those.\n   */\n  clearRequests(): void {\n    this.journal.clearEntries();\n  }\n\n  /**\n   * Reset fixture match counts, and the MCP fakes consumption state of every\n   * mount (R6), for `testId` or for all test ids. Fakes stay loaded.\n   */\n  resetMatchCounts(testId?: string): this {\n    if (this.serverInstance) {\n      this.serverInstance.journal.clearMatchCounts(testId);\n    }\n    for (const { handler } of this.mounts) handler.resetScenarioState?.(testId);\n    return this;\n  }\n\n  // ---- Chaos ----\n\n  /**\n   * Set the server-wide chaos baseline. Writes through to a RUNNING server as\n   * well as the construction options: an untagged `POST /__aimock/chaos`\n   * installs a baseline override that shadows `options.chaos`, and without this\n   * the call would silently do nothing until the next `reset()`. Per-testId\n   * overrides still win over the baseline.\n   */\n  setChaos(config: ChaosConfig): this {\n    this.options.chaos = config;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = config;\n    return this;\n  }\n\n  /**\n   * Turn chaos off everywhere: the construction config, the runtime baseline,\n   * and every per-testId override (assigning `undefined` is the full-clear\n   * signal the `defaults.chaos` setter defines).\n   */\n  clearChaos(): this {\n    delete this.options.chaos;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = undefined;\n    return this;\n  }\n\n  // ---- Recording ----\n\n  enableRecording(config: RecordConfig): this {\n    this.options.record = config;\n    return this;\n  }\n\n  disableRecording(): this {\n    delete this.options.record;\n    return this;\n  }\n\n  // ---- Reset ----\n\n  /**\n   * Full reset — the in-process equivalent of `POST /__aimock/reset`. Shares\n   * one implementation with the control-API route so the two cannot drift.\n   *\n   * The one deliberate difference: search / rerank / moderation fixtures are\n   * also cleared here. Those are registered through this class only — the\n   * control API has no route that creates them, so the HTTP reset can neither\n   * reach nor observe them.\n   *\n   * NOT ALL OF THIS IS PER-INSTANCE. `performFullReset` clears module-global\n   * state as well: the Gemini interaction and event-id counters\n   * (`resetInteractionCounter` / `resetEventIdCounter` in\n   * `./gemini-interactions.js`), the fal.ai job/queue maps (`falJobs`,\n   * `falQueueStates`), the fine-tuning job store (`clearFineTuningStore`),\n   * and the ElevenLabs Voice Design store (`clearElevenLabsVoices`). With two\n   * `LLMock` instances live in one process,\n   * `a.reset()` rewinds the Gemini id sequence that `b` is mid-way through —\n   * `b` then re-emits `aimock-int-0` / `evt_1`, ids it has already handed\n   * out — and drops `b`'s in-flight fal jobs. Give each instance its own\n   * process (or its own vitest worker) if that matters.\n   *\n   * The global stores are cleared even before `start()`, when there is no\n   * server instance to reset.\n   */\n  reset(): this {\n    this.searchFixtures.length = 0;\n    this.rerankFixtures.length = 0;\n    this.moderationFixtures.length = 0;\n    // `ServerInstance` carries no mounts, so the fakes are unloaded here (R4).\n    this.unloadMcpFakes();\n    performFullReset(this.fixtures, this.serverInstance);\n    return this;\n  }\n\n  // ---- Server lifecycle ----\n\n  async start(): Promise<string> {\n    if (this.serverInstance) {\n      throw new Error(\"Server already started\");\n    }\n    const serviceFixtures = {\n      search: this.searchFixtures,\n      rerank: this.rerankFixtures,\n      moderation: this.moderationFixtures,\n      mcpFakes: [...this.mcpFakeBuffer],\n    };\n    this.serverInstance = await (this.resolvedInboundAuth\n      ? createServerWithResolvedAuth(\n          this.fixtures,\n          this.options,\n          this.resolvedInboundAuth,\n          this.mounts,\n          serviceFixtures,\n        )\n      : createServer(this.fixtures, this.options, this.mounts, serviceFixtures));\n    // The server holds the buffered fakes now (W2). A start that rejects took\n    // its hand-off back, so the buffer is kept for a retry.\n    this.mcpFakeBuffer.length = 0;\n    return this.serverInstance.url;\n  }\n\n  closeLiveSessions(testId?: string): this {\n    this.serverInstance?.closeLiveSessions(testId);\n    return this;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    const { server } = this.serverInstance;\n    await new Promise<void>((resolve, reject) => {\n      server.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.serverInstance = null;\n  }\n\n  // ---- Accessors ----\n\n  get journal(): Journal {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.journal;\n  }\n\n  get url(): string {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.url;\n  }\n\n  get baseUrl(): string {\n    return this.url;\n  }\n\n  get port(): number {\n    const parsed = new URL(this.url); // this.url throws if not started\n    if (!parsed.port) {\n      throw new Error(`Server URL has no explicit port: ${this.url}`);\n    }\n    return parseInt(parsed.port, 10);\n  }\n\n  // ---- Static factory ----\n\n  static async create(options?: MockServerOptions): Promise<LLMock> {\n    const instance = new LLMock(options);\n    await instance.start();\n    return instance;\n  }\n}\n\n/** @internal Configuration startup preserves a policy resolved from the selected source. */\nexport function createLLMockWithResolvedAuth(\n  options: MockServerOptions,\n  resolvedAuth: ResolvedInboundAuth,\n): LLMock {\n  return new LLMock(options, resolvedAuth);\n}\n"],"mappings":"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"}

package/dist/mcp-fakes-mount.cjs

@@ -0,0 +1,216 @@
+const require_message_text = require('./message-text.cjs');
+const require_fixture_loader = require('./fixture-loader.cjs');
+const require_mcp_fakes = require('./mcp-fakes.cjs');
+const require_mcp_mock = require('./mcp-mock.cjs');
+
+//#region src/mcp-fakes-mount.ts
+/**
+* The control-API prefix. The server hands every request whose path starts
+* with it to the control API, before any mount, so no mount under it is
+* reachable.
+*/
+const CONTROL_PREFIX = "/__aimock";
+/** The handlers an auto-mount created (W3, W6), whichever path created them. */
+const autoMounts = /* @__PURE__ */ new WeakSet();
+/** `handler` was auto-mounted for MCP fakes (at start, after start or by the control API). */
+function isAutoMount(handler) {
+	return autoMounts.has(handler);
+}
+/** A mount "is an MCPMock" for fakes if and only if it implements `addMcpFakes`. */
+function isFakeMount(handler) {
+	return typeof handler.addMcpFakes === "function";
+}
+/**
+* The mount that serves `path`, in dispatch order: an MCPMock at exactly
+* `path`; a conflict when the path is under the control prefix, when a mount
+* that is not an MCPMock serves it first (it would shadow the fakes), or when
+* an MCPMock at `path` without its trailing "/" answers it as its root; none
+* when no mount serves it. An MCPMock mounted at a prefix of `path` lets any
+* other sub-path fall through, so it is skipped. `pending` are the paths an
+* add will auto-mount before this one, in order (they follow `mounts`).
+*/
+function findFakeMount(mounts, path, pending = []) {
+	if (path.startsWith(CONTROL_PREFIX)) return {
+		kind: "conflict",
+		mountPath: CONTROL_PREFIX,
+		reason: "control"
+	};
+	for (const { path: mountPath, handler } of mounts) {
+		if (path !== mountPath && !path.startsWith(mountPath + "/")) continue;
+		if (!isFakeMount(handler)) return {
+			kind: "conflict",
+			mountPath,
+			reason: "not-mcp"
+		};
+		if (mountPath === path) return {
+			kind: "mcp",
+			handler
+		};
+		if (path === mountPath + "/") return {
+			kind: "conflict",
+			mountPath,
+			reason: "mcp-root"
+		};
+	}
+	for (const mountPath of pending) if (path === mountPath + "/") return {
+		kind: "conflict",
+		mountPath,
+		reason: "mcp-root"
+	};
+	return { kind: "none" };
+}
+/** Why the fakes for `path` cannot be served there (no location prefix). */
+function mountConflictDetail(path, target) {
+	switch (target.reason) {
+		case "control": return require_message_text.msg`mount ${require_message_text.quote(path)} is under the control API prefix ${require_message_text.quote(target.mountPath)}, which takes its requests first, so its fakes cannot be served`;
+		case "mcp-root": return require_message_text.msg`mount ${require_message_text.quote(path)} is answered by the MCP mock at ${require_message_text.quote(target.mountPath)} as its root, so its fakes cannot be served`;
+		case "not-mcp": return require_message_text.msg`mount ${require_message_text.quote(path)} is served by ${require_message_text.quote(target.mountPath)}, which is not an MCP mock, so its fakes cannot be served`;
+	}
+}
+/** Wire, push and log (L4, L5) an auto-mounted MCPMock. */
+function pushAutoMount(mounts, path, handler, wiring, logger) {
+	if (wiring.journal) handler.setJournal(wiring.journal);
+	if (wiring.registry) handler.setRegistry(wiring.registry);
+	if (wiring.logger) handler.setLogger(wiring.logger);
+	const others = mounts.filter((m) => m.path !== path && isFakeMount(m.handler));
+	mounts.push({
+		path,
+		handler
+	});
+	autoMounts.add(handler);
+	logger.info(require_message_text.build(require_message_text.msg`MCP fakes: auto-mounted an MCP mock at ${require_message_text.quote(path)}`));
+	for (const other of others) logger.warn(require_message_text.build(require_message_text.msg`MCP fakes: auto-mounted an MCP mock at ${require_message_text.quote(path)} while an MCP mock is mounted at ${require_message_text.quote(other.path)}; fakes for one path do not reach the other`));
+}
+/**
+* The MCPMock for `path`: the one already mounted there, or a new one pushed
+* onto `mounts` (auto-mount, logs L4 and L5). A conflict is returned, not
+* thrown, so the caller can name the offending block.
+*/
+function ensureFakeMount(mounts, path, wiring, logger) {
+	const target = findFakeMount(mounts, path);
+	if (target.kind === "conflict") return { conflict: target.mountPath };
+	if (target.kind === "mcp") return {
+		handler: target.handler,
+		created: false
+	};
+	const handler = new require_mcp_mock.MCPMock();
+	pushAutoMount(mounts, path, handler, wiring, logger);
+	return {
+		handler,
+		created: true
+	};
+}
+/** A block's `mount` path, read without running getters; the add validates it. */
+function mountOf(raw) {
+	if (typeof raw !== "object" || raw === null) return require_mcp_fakes.MCP_FAKES_DEFAULT_MOUNT;
+	const value = Object.getOwnPropertyDescriptor(raw, "mount")?.value;
+	return typeof value === "string" ? value : require_mcp_fakes.MCP_FAKES_DEFAULT_MOUNT;
+}
+/** The mount-conflict error for one file-origin block. */
+function mountConflictError(block, path, target) {
+	return new require_fixture_loader.FixtureLoadError({
+		rule: "mcp-fakes/mount-conflict",
+		file: block.source,
+		blockId: require_mcp_fakes.blockIdOf(block.source, "", block.blockIndex),
+		entryId: null,
+		detail: mountConflictDetail(path, target)
+	});
+}
+/**
+* Check file-origin `blocks` against `mounts` without changing anything:
+* group them by `mount` path (default `/mcp`), find each group's mount (a
+* mount conflict is one error per block), and add each group to a throwaway
+* store (bad blocks and id collisions inside the input). Throws one
+* `McpFakesAddError` holding every error. With `checked`, only the groups
+* that hold a checked block are checked, and only checked blocks get a
+* mount-conflict error (the others were checked before).
+*/
+function planFileFakes(mounts, blocks, checked) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const block of blocks) {
+		const path = mountOf(block.raw);
+		const group = groups.get(path);
+		if (group) group.push(block);
+		else groups.set(path, [block]);
+	}
+	const errors = [];
+	const warnings = [];
+	const plan = {
+		onExisting: [],
+		onNew: [],
+		warnings
+	};
+	for (const [path, group] of groups) {
+		if (checked && !group.some((block) => checked.has(block))) continue;
+		const target = findFakeMount(mounts, path, plan.onNew.map((g) => g.path));
+		if (target.kind === "conflict") {
+			for (const block of group) if (!checked || checked.has(block)) errors.push(mountConflictError(block, path, target));
+			continue;
+		}
+		try {
+			warnings.push(...new require_mcp_fakes.McpFakeStore().add(group, { kind: "file" }).warnings);
+		} catch (err) {
+			if (!(err instanceof require_mcp_fakes.McpFakesAddError)) throw err;
+			errors.push(...err.errors);
+			warnings.push(...err.warnings);
+			continue;
+		}
+		if (target.kind === "mcp") plan.onExisting.push({
+			handler: target.handler,
+			group
+		});
+		else plan.onNew.push({
+			path,
+			group
+		});
+	}
+	if (errors.length > 0) throw new require_mcp_fakes.McpFakesAddError(errors, warnings);
+	return plan;
+}
+/**
+* Start-time hand-off (F2): check every block first (`planFileFakes`; on any
+* error, a bad block, an id collision or a mount conflict, throws one
+* `McpFakesAddError` holding every error and changes nothing). Then the
+* groups for paths no mount serves are added to new MCPMocks, pushed onto
+* `mounts` (auto-mount, L4, L5) so the mount loop wires them. The groups for
+* an MCPMock already mounted are added by `commit`, once the server listens,
+* so a start that fails after the hand-off leaves those mounts untouched;
+* `undo` removes the auto-mounts. The add warnings (L8) are logged at `warn`.
+*/
+function handOffMcpFakes(mounts, blocks, logger) {
+	const plan = planFileFakes(mounts, blocks);
+	const created = [];
+	for (const { path, group } of plan.onNew) {
+		const handler = new require_mcp_mock.MCPMock();
+		for (const warning of handler.addMcpFakes(group, { kind: "file" }).warnings) logger.warn(warning.message);
+		created.push({
+			path,
+			handler
+		});
+	}
+	for (const { path, handler } of created) pushAutoMount(mounts, path, handler, {}, logger);
+	return {
+		commit() {
+			for (const { handler, group } of plan.onExisting) {
+				const result = handler.addMcpFakes?.(group, { kind: "file" });
+				for (const warning of result?.warnings ?? []) logger.warn(warning.message);
+			}
+		},
+		undo() {
+			for (const { handler } of created) {
+				const at = mounts.findIndex((m) => m.handler === handler);
+				if (at !== -1) mounts.splice(at, 1);
+			}
+		}
+	};
+}
+
+//#endregion
+exports.ensureFakeMount = ensureFakeMount;
+exports.findFakeMount = findFakeMount;
+exports.handOffMcpFakes = handOffMcpFakes;
+exports.isAutoMount = isAutoMount;
+exports.isFakeMount = isFakeMount;
+exports.mountConflictDetail = mountConflictDetail;
+exports.planFileFakes = planFileFakes;
+//# sourceMappingURL=mcp-fakes-mount.cjs.map

package/dist/mcp-fakes-mount.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-fakes-mount.cjs","names":["quote","build","MCPMock","MCP_FAKES_DEFAULT_MOUNT","FixtureLoadError","blockIdOf","McpFakeStore","McpFakesAddError"],"sources":["../src/mcp-fakes-mount.ts"],"sourcesContent":["/**\n * Where MCP fakes go on a server (spec 5.2): find the mount that serves a\n * block's `mount` path, auto-mount an `MCPMock` when none does (W3, W6), and\n * the start-time hand-off of `ServiceFixtures.mcpFakes` (F2).\n */\nimport type { Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type { McpFakeSource, Mountable } from \"./types.js\";\nimport { FixtureLoadError } from \"./fixture-loader.js\";\nimport { MCPMock } from \"./mcp-mock.js\";\nimport {\n  MCP_FAKES_DEFAULT_MOUNT,\n  McpFakeStore,\n  McpFakesAddError,\n  blockIdOf,\n  type McpFakeIssue,\n} from \"./mcp-fakes.js\";\nimport { build, msg, quote, type Message } from \"./message-text.js\";\n\nexport type MountList = Array<{ path: string; handler: Mountable }>;\n\n/** Dependencies an auto-mount gets when it is created (after start: W4 wiring). */\nexport interface FakeMountWiring {\n  journal?: Journal;\n  registry?: MetricsRegistry;\n  logger?: Logger;\n}\n\n/**\n * The control-API prefix. The server hands every request whose path starts\n * with it to the control API, before any mount, so no mount under it is\n * reachable.\n */\nexport const CONTROL_PREFIX = \"/__aimock\";\n\n/**\n * What serves a block's `mount` path. A conflict is a path no fake there can\n * be served at: a mount that is not an MCPMock serves it first (`not-mcp`), an\n * MCPMock mounted at `mountPath` answers it as its root (`mcp-root`, the path\n * is `mountPath` plus a trailing \"/\"), or it is under the control prefix\n * (`control`).\n */\nexport type FakeMountTarget =\n  | { kind: \"mcp\"; handler: Mountable }\n  | { kind: \"conflict\"; mountPath: string; reason: \"not-mcp\" | \"mcp-root\" | \"control\" }\n  | { kind: \"none\" };\n\n/** The handlers an auto-mount created (W3, W6), whichever path created them. */\nconst autoMounts = new WeakSet<Mountable>();\n\n/** `handler` was auto-mounted for MCP fakes (at start, after start or by the control API). */\nexport function isAutoMount(handler: Mountable): boolean {\n  return autoMounts.has(handler);\n}\n\n/** A mount \"is an MCPMock\" for fakes if and only if it implements `addMcpFakes`. */\nexport function isFakeMount(handler: Mountable): boolean {\n  return typeof handler.addMcpFakes === \"function\";\n}\n\n/**\n * The mount that serves `path`, in dispatch order: an MCPMock at exactly\n * `path`; a conflict when the path is under the control prefix, when a mount\n * that is not an MCPMock serves it first (it would shadow the fakes), or when\n * an MCPMock at `path` without its trailing \"/\" answers it as its root; none\n * when no mount serves it. An MCPMock mounted at a prefix of `path` lets any\n * other sub-path fall through, so it is skipped. `pending` are the paths an\n * add will auto-mount before this one, in order (they follow `mounts`).\n */\nexport function findFakeMount(\n  mounts: MountList,\n  path: string,\n  pending: readonly string[] = [],\n): FakeMountTarget {\n  if (path.startsWith(CONTROL_PREFIX)) {\n    return { kind: \"conflict\", mountPath: CONTROL_PREFIX, reason: \"control\" };\n  }\n  for (const { path: mountPath, handler } of mounts) {\n    if (path !== mountPath && !path.startsWith(mountPath + \"/\")) continue;\n    if (!isFakeMount(handler)) return { kind: \"conflict\", mountPath, reason: \"not-mcp\" };\n    if (mountPath === path) return { kind: \"mcp\", handler };\n    if (path === mountPath + \"/\") return { kind: \"conflict\", mountPath, reason: \"mcp-root\" };\n  }\n  for (const mountPath of pending) {\n    if (path === mountPath + \"/\") return { kind: \"conflict\", mountPath, reason: \"mcp-root\" };\n  }\n  return { kind: \"none\" };\n}\n\n/** Why the fakes for `path` cannot be served there (no location prefix). */\nexport function mountConflictDetail(\n  path: string,\n  target: Extract<FakeMountTarget, { kind: \"conflict\" }>,\n): Message {\n  switch (target.reason) {\n    case \"control\":\n      return msg`mount ${quote(path)} is under the control API prefix ${quote(target.mountPath)}, which takes its requests first, so its fakes cannot be served`;\n    case \"mcp-root\":\n      return msg`mount ${quote(path)} is answered by the MCP mock at ${quote(target.mountPath)} as its root, so its fakes cannot be served`;\n    case \"not-mcp\":\n      return msg`mount ${quote(path)} is served by ${quote(target.mountPath)}, which is not an MCP mock, so its fakes cannot be served`;\n  }\n}\n\n/** Wire, push and log (L4, L5) an auto-mounted MCPMock. */\nfunction pushAutoMount(\n  mounts: MountList,\n  path: string,\n  handler: MCPMock,\n  wiring: FakeMountWiring,\n  logger: Logger,\n): void {\n  if (wiring.journal) handler.setJournal(wiring.journal);\n  if (wiring.registry) handler.setRegistry(wiring.registry);\n  if (wiring.logger) handler.setLogger(wiring.logger);\n  const others = mounts.filter((m) => m.path !== path && isFakeMount(m.handler));\n  mounts.push({ path, handler });\n  autoMounts.add(handler);\n  logger.info(build(msg`MCP fakes: auto-mounted an MCP mock at ${quote(path)}`));\n  for (const other of others) {\n    logger.warn(\n      build(\n        msg`MCP fakes: auto-mounted an MCP mock at ${quote(path)} while an MCP mock is mounted at ${quote(other.path)}; fakes for one path do not reach the other`,\n      ),\n    );\n  }\n}\n\n/**\n * The MCPMock for `path`: the one already mounted there, or a new one pushed\n * onto `mounts` (auto-mount, logs L4 and L5). A conflict is returned, not\n * thrown, so the caller can name the offending block.\n */\nexport function ensureFakeMount(\n  mounts: MountList,\n  path: string,\n  wiring: FakeMountWiring,\n  logger: Logger,\n): { handler: Mountable; created: boolean } | { conflict: string } {\n  const target = findFakeMount(mounts, path);\n  if (target.kind === \"conflict\") return { conflict: target.mountPath };\n  if (target.kind === \"mcp\") return { handler: target.handler, created: false };\n  const handler = new MCPMock();\n  pushAutoMount(mounts, path, handler, wiring, logger);\n  return { handler, created: true };\n}\n\n/** A block's `mount` path, read without running getters; the add validates it. */\nfunction mountOf(raw: unknown): string {\n  if (typeof raw !== \"object\" || raw === null) return MCP_FAKES_DEFAULT_MOUNT;\n  const value: unknown = Object.getOwnPropertyDescriptor(raw, \"mount\")?.value;\n  return typeof value === \"string\" ? value : MCP_FAKES_DEFAULT_MOUNT;\n}\n\n/** The mount-conflict error for one file-origin block. */\nexport function mountConflictError(\n  block: McpFakeSource,\n  path: string,\n  target: Extract<FakeMountTarget, { kind: \"conflict\" }>,\n): FixtureLoadError {\n  return new FixtureLoadError({\n    rule: \"mcp-fakes/mount-conflict\",\n    file: block.source,\n    blockId: blockIdOf(block.source, \"\", block.blockIndex),\n    entryId: null,\n    detail: mountConflictDetail(path, target),\n  });\n}\n\n/** Where a checked add of file blocks goes: each group by its `mount` path. */\nexport interface FileFakesPlan {\n  /** Groups for a path an MCPMock already serves, with that mount. */\n  onExisting: Array<{ handler: Mountable; group: McpFakeSource[] }>;\n  /** Groups for a path no mount serves, in order: each gets an auto-mount. */\n  onNew: Array<{ path: string; group: McpFakeSource[] }>;\n  /** The add warnings (L8), as a throwaway store reports them. */\n  warnings: McpFakeIssue[];\n}\n\n/**\n * Check file-origin `blocks` against `mounts` without changing anything:\n * group them by `mount` path (default `/mcp`), find each group's mount (a\n * mount conflict is one error per block), and add each group to a throwaway\n * store (bad blocks and id collisions inside the input). Throws one\n * `McpFakesAddError` holding every error. With `checked`, only the groups\n * that hold a checked block are checked, and only checked blocks get a\n * mount-conflict error (the others were checked before).\n */\nexport function planFileFakes(\n  mounts: MountList,\n  blocks: readonly McpFakeSource[],\n  checked?: ReadonlySet<McpFakeSource>,\n): FileFakesPlan {\n  const groups = new Map<string, McpFakeSource[]>();\n  for (const block of blocks) {\n    const path = mountOf(block.raw);\n    const group = groups.get(path);\n    if (group) group.push(block);\n    else groups.set(path, [block]);\n  }\n\n  const errors: FixtureLoadError[] = [];\n  const warnings: McpFakeIssue[] = [];\n  const plan: FileFakesPlan = { onExisting: [], onNew: [], warnings };\n  for (const [path, group] of groups) {\n    if (checked && !group.some((block) => checked.has(block))) continue;\n    const target = findFakeMount(\n      mounts,\n      path,\n      plan.onNew.map((g) => g.path),\n    );\n    if (target.kind === \"conflict\") {\n      for (const block of group) {\n        if (!checked || checked.has(block)) errors.push(mountConflictError(block, path, target));\n      }\n      continue;\n    }\n    try {\n      warnings.push(...new McpFakeStore().add(group, { kind: \"file\" }).warnings);\n    } catch (err) {\n      if (!(err instanceof McpFakesAddError)) throw err;\n      errors.push(...err.errors);\n      warnings.push(...err.warnings);\n      continue;\n    }\n    if (target.kind === \"mcp\") plan.onExisting.push({ handler: target.handler, group });\n    else plan.onNew.push({ path, group });\n  }\n  if (errors.length > 0) throw new McpFakesAddError(errors, warnings);\n  return plan;\n}\n\n/** A start-time hand-off: the auto-mounts are in place, the rest waits for `commit`. */\nexport interface McpFakesHandOff {\n  /** Add the groups for existing MCPMocks (after the server listens). */\n  commit(): void;\n  /** Take the auto-mounts back off the mounts array (start failed). */\n  undo(): void;\n}\n\n/**\n * Start-time hand-off (F2): check every block first (`planFileFakes`; on any\n * error, a bad block, an id collision or a mount conflict, throws one\n * `McpFakesAddError` holding every error and changes nothing). Then the\n * groups for paths no mount serves are added to new MCPMocks, pushed onto\n * `mounts` (auto-mount, L4, L5) so the mount loop wires them. The groups for\n * an MCPMock already mounted are added by `commit`, once the server listens,\n * so a start that fails after the hand-off leaves those mounts untouched;\n * `undo` removes the auto-mounts. The add warnings (L8) are logged at `warn`.\n */\nexport function handOffMcpFakes(\n  mounts: MountList,\n  blocks: McpFakeSource[],\n  logger: Logger,\n): McpFakesHandOff {\n  const plan = planFileFakes(mounts, blocks);\n  const created: Array<{ path: string; handler: MCPMock }> = [];\n  for (const { path, group } of plan.onNew) {\n    const handler = new MCPMock();\n    for (const warning of handler.addMcpFakes(group, { kind: \"file\" }).warnings) {\n      logger.warn(warning.message);\n    }\n    created.push({ path, handler });\n  }\n  for (const { path, handler } of created) pushAutoMount(mounts, path, handler, {}, logger);\n  return {\n    commit(): void {\n      for (const { handler, group } of plan.onExisting) {\n        const result = handler.addMcpFakes?.(group, { kind: \"file\" });\n        for (const warning of result?.warnings ?? []) logger.warn(warning.message);\n      }\n    },\n    undo(): void {\n      for (const { handler } of created) {\n        const at = mounts.findIndex((m) => m.handler === handler);\n        if (at !== -1) mounts.splice(at, 1);\n      }\n    },\n  };\n}\n"],"mappings":"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"}