@copilotkit/aimock 1.44.0 → 1.45.1

package/dist/llmock.cjs

@@ -1,9 +1,12 @@
+const require_constants = require('./constants.cjs');
 const require_message_text = require('./message-text.cjs');
 const require_helpers = require('./helpers.cjs');
 const require_live_fixture = require('./live-fixture.cjs');
+const require_misbehavior = require('./misbehavior.cjs');
 const require_fixture_loader = require('./fixture-loader.cjs');
 const require_fal = require('./fal.cjs');
 const require_elevenlabs_voice = require('./elevenlabs-voice.cjs');
+const require_mcp_mock = require('./mcp-mock.cjs');
 const require_mcp_fakes_mount = require('./mcp-fakes-mount.cjs');
 const require_server = require('./server.cjs');
 const require_fixture_loader_services = require('./fixture-loader-services.cjs');
@@ -11,6 +14,13 @@ const require_fixture_loader_services = require('./fixture-loader-services.cjs')
 //#region src/llmock.ts
 var LLMock = class LLMock {
 	fixtures = [];
+	fixtureAddition = 0;
+	fixtureCountOrigins = /* @__PURE__ */ new WeakMap();
+	/**
+	* Fixtures this LLMock built itself (on() and the other helpers), so the
+	* caller never held them: the stored object is their identity.
+	*/
+	ownFixtures = /* @__PURE__ */ new WeakSet();
 	searchFixtures = [];
 	rerankFixtures = [];
 	moderationFixtures = [];
@@ -22,16 +32,46 @@ var LLMock = class LLMock {
 	options;
 	resolvedInboundAuth;
 	constructor(options, resolvedInboundAuth) {
+		require_helpers.markServerOwnedFixtures(this.fixtures);
 		this.options = options ?? {};
 		if (this.options.live !== void 0) require_live_fixture.normalizeLiveOptions(this.options.live);
+		if (this.misbehaviorEnabled && this.options.misbehavior !== void 0) this.setMisbehavior(this.options.misbehavior);
 		this.resolvedInboundAuth = resolvedInboundAuth;
 	}
+	/** Misbehavior (fixture keys, header, `misbehavior` option) needs `enableMisbehavior: true`. */
+	get misbehaviorEnabled() {
+		return this.options.enableMisbehavior === true;
+	}
 	normalizeFixture(fixture) {
-		if (require_helpers.isLiveResponse(fixture.response) || fixture.match.endpoint === "openai-live" && typeof fixture.response !== "function") return {
+		const misbehaviorEnabled = this.misbehaviorEnabled;
+		if (misbehaviorEnabled) require_fixture_loader.enableHeldFixtureMisbehavior(fixture);
+		const own = this.ownFixtures.delete(fixture);
+		const countIdentity = own ? void 0 : this.fixtureCountOrigins.get(fixture) ?? fixture;
+		const previousPosition = require_misbehavior.getFixtureMisbehaviorPosition(fixture);
+		const isNewAddition = previousPosition === void 0 || /^code#\d+$/.test(previousPosition);
+		const position = isNewAddition ? `code#${this.fixtureAddition++}` : previousPosition;
+		if (isNewAddition && misbehaviorEnabled && !own) fixture = { ...fixture };
+		if (misbehaviorEnabled && fixture.misbehavior !== void 0) {
+			const parsed = require_misbehavior.parseMisbehavior(fixture.misbehavior);
+			if (parsed.ok) fixture = {
+				...fixture,
+				misbehavior: parsed.config
+			};
+			const issue = parsed.ok ? require_misbehavior.validateFixtureMisbehavior(fixture) : parsed.issue;
+			if (issue) throw new require_fixture_loader.MisbehaviorConfigError({
+				rule: issue.rule,
+				file: position,
+				detail: issue.message
+			});
+		}
+		if (require_helpers.isLiveResponse(fixture.response) || fixture.match.endpoint === "openai-live" && typeof fixture.response !== "function") fixture = {
 			...fixture,
 			match: { ...fixture.match },
 			response: require_live_fixture.normalizeLiveFixture(fixture.response, this.options.live)
 		};
+		else if (countIdentity !== void 0 && fixture !== countIdentity) this.fixtureCountOrigins.set(fixture, countIdentity);
+		require_misbehavior.setFixtureMisbehaviorPosition(fixture, position);
+		if (misbehaviorEnabled && fixture.misbehavior !== void 0) require_fixture_loader.markFixtureMisbehaviorEnabled(fixture);
 		return fixture;
 	}
 	addFixture(fixture) {
@@ -46,6 +86,11 @@ var LLMock = class LLMock {
 		this.fixtures.unshift(this.normalizeFixture(fixture));
 		return this;
 	}
+	/** Mark a fixture this LLMock built, for {@link normalizeFixture}. */
+	own(fixture) {
+		this.ownFixtures.add(fixture);
+		return fixture;
+	}
 	getFixtures() {
 		return this.fixtures;
 	}
@@ -71,6 +116,8 @@ var LLMock = class LLMock {
 	* still make `start()` reject.
 	*/
 	acceptLoaded(loaded) {
+		if (this.misbehaviorEnabled) loaded.fixtures.forEach(require_fixture_loader.enableHeldFixtureMisbehavior);
+		if (this.options.responsesTools === "extended") loaded.fixtures.forEach(require_fixture_loader.markFixtureResponsesToolsExtended);
 		if (loaded.mcpFakes.length > 0) if (this.serverInstance) this.addFakesAfterStart(this.serverInstance, loaded.mcpFakes);
 		else {
 			require_mcp_fakes_mount.planFileFakes(this.mounts, [...this.mcpFakeBuffer, ...loaded.mcpFakes], new Set(loaded.mcpFakes));
@@ -100,7 +147,8 @@ var LLMock = class LLMock {
 			const target = require_mcp_fakes_mount.ensureFakeMount(this.mounts, path, {
 				journal: server.journal,
 				...registry ? { registry } : {},
-				logger
+				logger,
+				replaySpeed: server.defaults.replaySpeed
 			}, logger);
 			if ("conflict" in target) continue;
 			const result = target.handler.addMcpFakes?.(group, { kind: "file" });
@@ -125,7 +173,17 @@ var LLMock = class LLMock {
 		}
 		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) => require_fixture_loader.entryToFixture(e, void 0, this.options.live));
+		const converted = entries.map((entry) => {
+			const position = `code#${this.fixtureAddition++}`;
+			const fixture = require_fixture_loader.entryToFixture(entry, void 0, this.options.live, {
+				file: position,
+				index: 0
+			});
+			require_misbehavior.setFixtureMisbehaviorPosition(fixture, position);
+			if (this.misbehaviorEnabled) require_fixture_loader.enableHeldFixtureMisbehavior(fixture);
+			if (this.options.responsesTools === "extended") require_fixture_loader.markFixtureResponsesToolsExtended(fixture);
+			return fixture;
+		});
 		const errors = require_fixture_loader.validateFixtures(converted, this.options.live).filter((i) => i.severity === "error");
 		if (errors.length > 0) throw new Error(`Fixture validation failed: ${JSON.stringify(errors)}`);
 		this.fixtures.push(...converted);
@@ -133,15 +191,21 @@ var LLMock = class LLMock {
 	}
 	clearFixtures() {
 		require_fixture_loader.clearFixtureQueue(this.fixtures);
+		this.serverInstance?.journal.clearMisbehaviorCounters();
 		this.unloadMcpFakes();
 		return this;
 	}
 	on(match, response, opts) {
-		return this.addFixture({
+		let normalized = response;
+		if (typeof response !== "function") {
+			normalized = require_fixture_loader.normalizeResponse(response, this.options.live);
+			if (this.options.responsesTools === "extended" && !require_helpers.isLiveResponse(normalized)) require_fixture_loader.normalizeResponsesToolsKeys(normalized);
+		}
+		return this.addFixture(this.own({
 			match,
-			response: typeof response === "function" ? response : require_fixture_loader.normalizeResponse(response, this.options.live),
+			response: normalized,
 			...opts
-		});
+		}));
 	}
 	onLive(match, transcript, opts) {
 		return this.on({
@@ -175,99 +239,99 @@ var LLMock = class LLMock {
 		}, response, opts);
 	}
 	onImage(prompt, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: prompt,
 				endpoint: "image"
 			},
 			response
-		});
+		}));
 	}
 	onSpeech(input, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: input,
 				endpoint: "speech"
 			},
 			response
-		});
+		}));
 	}
 	onTranscription(response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: { endpoint: "transcription" },
 			response
-		});
+		}));
 	}
 	onTranslation(response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: { endpoint: "translation" },
 			response
-		});
+		}));
 	}
 	onVideo(prompt, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: prompt,
 				endpoint: "video"
 			},
 			response
-		});
+		}));
 	}
 	onAudio(input, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: { userMessage: input },
 			response
-		});
+		}));
 	}
 	onSoundEffect(text, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: text,
 				endpoint: "audio-gen"
 			},
 			response
-		});
+		}));
 	}
 	onMusic(prompt, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: prompt,
 				endpoint: "audio-gen"
 			},
 			response
-		});
+		}));
 	}
 	onElevenLabsTTS(text, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: text,
 				endpoint: "elevenlabs-tts"
 			},
 			response
-		});
+		}));
 	}
 	onElevenLabsVoiceDesign(description, response) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: description,
 				endpoint: "elevenlabs-voice-design"
 			},
 			response: require_elevenlabs_voice.voiceDesignToJson(response)
-		});
+		}));
 	}
 	onFalAudio(prompt, response, model) {
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				userMessage: prompt,
 				endpoint: "fal-audio",
 				...model ? { model } : {}
 			},
 			response
-		});
+		}));
 	}
 	onFalQueue(modelOrPrompt, response, opts) {
 		const { billableUnits, ...fixtureOpts } = opts ?? {};
-		return this.addFixture({
+		return this.addFixture(this.own({
 			match: {
 				model: modelOrPrompt,
 				endpoint: "fal"
@@ -277,7 +341,7 @@ var LLMock = class LLMock {
 				...billableUnits != null ? { billableUnits } : {}
 			},
 			...fixtureOpts
-		});
+		}));
 	}
 	onFalRun(modelOrPrompt, response, opts) {
 		return this.onFalQueue(modelOrPrompt, response, opts);
@@ -344,6 +408,7 @@ var LLMock = class LLMock {
 			if (registry && handler.setRegistry) handler.setRegistry(registry);
 			const logger = this.serverInstance.defaults.logger;
 			if (handler.setLogger) handler.setLogger(logger);
+			if (handler instanceof require_mcp_mock.MCPMock) handler.setReplaySpeed(this.serverInstance.defaults.replaySpeed);
 			if (shadowedBy) logger.warn(require_message_text.build(require_message_text.msg`MCP fakes: the mount at ${require_message_text.quote(path)} is shadowed by the MCP mock auto-mounted at ${require_message_text.quote(shadowedBy.path)}; its requests reach the auto-mount`));
 		}
 		return this;
@@ -392,6 +457,32 @@ var LLMock = class LLMock {
 		if (this.serverInstance) this.serverInstance.defaults.chaos = void 0;
 		return this;
 	}
+	/** Replace construction/runtime baselines without changing named test overrides. */
+	setMisbehavior(config) {
+		if (!this.misbehaviorEnabled) throw new TypeError("setMisbehavior: misbehavior is not enabled; construct with enableMisbehavior: true");
+		const parsed = require_misbehavior.parseMisbehavior(config);
+		if (!parsed.ok) throw new TypeError(`${parsed.issue.rule}: ${parsed.issue.message}`);
+		this.options.misbehavior = parsed.config;
+		const defaults = this.serverInstance?.defaults;
+		if (defaults?.misbehavior) {
+			defaults.misbehavior.baseline = parsed.config.seed === "random" ? {
+				...parsed.config,
+				seed: require_misbehavior.resolveMisbehaviorSeed(parsed.config.seed, defaults.logger)
+			} : parsed.config;
+			if (defaults.misbehavior.byTestId.has(require_constants.DEFAULT_TEST_ID)) defaults.misbehavior.byTestId.set(require_constants.DEFAULT_TEST_ID, defaults.misbehavior.baseline);
+		}
+		return this;
+	}
+	/** Clear the baseline and all runtime overrides, before or after start. */
+	clearMisbehavior() {
+		delete this.options.misbehavior;
+		const scope = this.serverInstance?.defaults.misbehavior;
+		if (scope) {
+			scope.baseline = void 0;
+			scope.byTestId.clear();
+		}
+		return this;
+	}
 	enableRecording(config) {
 		this.options.record = config;
 		return this;
@@ -441,6 +532,8 @@ var LLMock = class LLMock {
 			mcpFakes: [...this.mcpFakeBuffer]
 		};
 		this.serverInstance = await (this.resolvedInboundAuth ? require_server.createServerWithResolvedAuth(this.fixtures, this.options, this.resolvedInboundAuth, this.mounts, serviceFixtures) : require_server.createServer(this.fixtures, this.options, this.mounts, serviceFixtures));
+		const countIdentity = (fixture) => this.fixtureCountOrigins.get(fixture) ?? fixture;
+		this.serverInstance.journal.configureFixtureCountIdentity(countIdentity);
 		this.mcpFakeBuffer.length = 0;
 		return this.serverInstance.url;
 	}

package/dist/llmock.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"llmock.cjs","names":["isLiveResponse","normalizeLiveFixture","loadFixtureFileWithServices","loadFixturesFromDirWithServices","planFileFakes","ensureFakeMount","entryToFixture","validateFixtures","normalizeResponse","voiceDesignToJson","imageResponseToFalJson","videoResponseToFalJson","isInjectableStatus","INJECTED_STATUS_RANGE","isAutoMount","build","quote","createServerWithResolvedAuth","createServer"],"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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"}
+{"version":3,"file":"llmock.cjs","names":["getFixtureMisbehaviorPosition","parseMisbehavior","validateFixtureMisbehavior","MisbehaviorConfigError","isLiveResponse","normalizeLiveFixture","loadFixtureFileWithServices","loadFixturesFromDirWithServices","enableHeldFixtureMisbehavior","markFixtureResponsesToolsExtended","planFileFakes","ensureFakeMount","entryToFixture","validateFixtures","normalizeResponse","voiceDesignToJson","imageResponseToFalJson","videoResponseToFalJson","isInjectableStatus","INJECTED_STATUS_RANGE","isAutoMount","MCPMock","build","quote","resolveMisbehaviorSeed","DEFAULT_TEST_ID","createServerWithResolvedAuth","createServer"],"sources":["../src/llmock.ts"],"sourcesContent":["import type { LiveTranscript } from \"./live-types.js\";\nimport { normalizeLiveFixture, normalizeLiveOptions } from \"./live-fixture.js\";\nimport { isLiveResponse, markServerOwnedFixtures } from \"./helpers.js\";\nimport type {\n  AudioResponse,\n  ChaosConfig,\n  EmbeddingFixtureOpts,\n  FalQueueOpts,\n  Fixture,\n  FixtureFileEntry,\n  FixtureFileResponse,\n  FixtureMatch,\n  FixtureOpts,\n  FixtureResponse,\n  ImageResponse,\n  McpFakeSource,\n  MockServerOptions,\n  MisbehaviorConfig,\n  MisbehaviorFaultId,\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  normalizeResponsesToolsKeys,\n  validateFixtures,\n  enableHeldFixtureMisbehavior,\n  markFixtureResponsesToolsExtended,\n  markFixtureMisbehaviorEnabled,\n  MisbehaviorConfigError,\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 { MCPMock } from \"./mcp-mock.js\";\nimport { build, msg, quote } from \"./message-text.js\";\nimport { DEFAULT_TEST_ID } from \"./constants.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\nimport {\n  getFixtureMisbehaviorPosition,\n  parseMisbehavior,\n  resolveMisbehaviorSeed,\n  setFixtureMisbehaviorPosition,\n  validateFixtureMisbehavior,\n} from \"./misbehavior.js\";\n\nexport class LLMock {\n  private fixtures: Fixture[] = [];\n  private fixtureAddition = 0;\n  private readonly fixtureCountOrigins = new WeakMap<Fixture, Fixture>();\n  /**\n   * Fixtures this LLMock built itself (on() and the other helpers), so the\n   * caller never held them: the stored object is their identity.\n   */\n  private readonly ownFixtures = new WeakSet<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    // Only this LLMock's server reads its array, so fixtures it makes may be marked in place.\n    markServerOwnedFixtures(this.fixtures);\n    this.options = options ?? {};\n    if (this.options.live !== undefined) normalizeLiveOptions(this.options.live);\n    // The `misbehavior` option is read only with `enableMisbehavior: true`;\n    // otherwise it is unused data, as in 1.44.0.\n    if (this.misbehaviorEnabled && this.options.misbehavior !== undefined) {\n      this.setMisbehavior(this.options.misbehavior);\n    }\n    this.resolvedInboundAuth = resolvedInboundAuth;\n  }\n\n  /** Misbehavior (fixture keys, header, `misbehavior` option) needs `enableMisbehavior: true`. */\n  private get misbehaviorEnabled(): boolean {\n    return this.options.enableMisbehavior === true;\n  }\n\n  // ---- Fixture management ----\n\n  private normalizeFixture(fixture: Fixture): Fixture {\n    const misbehaviorEnabled = this.misbehaviorEnabled;\n    // A fixture loaded from a file holds its `misbehavior` key until enabled.\n    if (misbehaviorEnabled) enableHeldFixtureMisbehavior(fixture);\n    // A fixture this LLMock built (on() and the helpers) is new to it, so it\n    // needs no per-addition copy, and the object stored is its identity.\n    const own = this.ownFixtures.delete(fixture);\n    const countIdentity = own ? undefined : (this.fixtureCountOrigins.get(fixture) ?? fixture);\n    const previousPosition = getFixtureMisbehaviorPosition(fixture);\n    const isNewAddition = previousPosition === undefined || /^code#\\d+$/.test(previousPosition);\n    const position = isNewAddition ? `code#${this.fixtureAddition++}` : previousPosition;\n    // With misbehavior enabled, re-adding a code fixture creates a new fault\n    // source without changing the old entry, so each addition is its own copy.\n    // The journal counts and records every copy under the caller's object\n    // (fixtureCountOrigins), so the identity APIs read as they do without\n    // misbehavior: an object added twice is one caller fixture, as in 1.44.0.\n    // Without misbehavior the position is never read, and the caller's object\n    // is stored as in 1.44.0.\n    if (isNewAddition && misbehaviorEnabled && !own) fixture = { ...fixture };\n    if (misbehaviorEnabled && fixture.misbehavior !== undefined) {\n      const parsed = parseMisbehavior(fixture.misbehavior);\n      if (parsed.ok) fixture = { ...fixture, misbehavior: parsed.config };\n      const issue = parsed.ok ? validateFixtureMisbehavior(fixture) : parsed.issue;\n      if (issue) {\n        throw new MisbehaviorConfigError({\n          rule: issue.rule,\n          file: position,\n          detail: issue.message,\n        });\n      }\n    }\n\n    if (\n      isLiveResponse(fixture.response) ||\n      (fixture.match.endpoint === \"openai-live\" && typeof fixture.response !== \"function\")\n    ) {\n      fixture = {\n        ...fixture,\n        match: { ...fixture.match },\n        response: normalizeLiveFixture(fixture.response, this.options.live),\n      };\n    } else if (countIdentity !== undefined && fixture !== countIdentity) {\n      this.fixtureCountOrigins.set(fixture, countIdentity);\n    }\n    setFixtureMisbehaviorPosition(fixture, position);\n    if (misbehaviorEnabled && fixture.misbehavior !== undefined) {\n      markFixtureMisbehaviorEnabled(fixture);\n    }\n    // A fixture passed in is not marked for responsesTools \"extended\": the\n    // server reads it through its extended view, so the caller's object (which\n    // another server may share) is left as it was loaded.\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  /** Mark a fixture this LLMock built, for {@link normalizeFixture}. */\n  private own(fixture: Fixture): Fixture {\n    this.ownFixtures.add(fixture);\n    return fixture;\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    // With misbehavior enabled, a bad `misbehavior` key throws before anything is added.\n    if (this.misbehaviorEnabled) loaded.fixtures.forEach(enableHeldFixtureMisbehavior);\n    if (this.options.responsesTools === \"extended\") {\n      loaded.fixtures.forEach(markFixtureResponsesToolsExtended);\n    }\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          replaySpeed: server.defaults.replaySpeed,\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((entry) => {\n      const position = `code#${this.fixtureAddition++}`;\n      const fixture = entryToFixture(entry, undefined, this.options.live, {\n        file: position,\n        index: 0,\n      });\n      setFixtureMisbehaviorPosition(fixture, position);\n      if (this.misbehaviorEnabled) enableHeldFixtureMisbehavior(fixture);\n      if (this.options.responsesTools === \"extended\") markFixtureResponsesToolsExtended(fixture);\n      return fixture;\n    });\n\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.serverInstance?.journal.clearMisbehaviorCounters();\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    let normalized: FixtureResponse | ResponseFactory = response as ResponseFactory;\n    if (typeof response !== \"function\") {\n      normalized = normalizeResponse(response, this.options.live);\n      // `customToolCalls` / `responsesBlocks` are normalized only where they are\n      // read; otherwise they stay as written, as in 1.44.0.\n      if (this.options.responsesTools === \"extended\" && !isLiveResponse(normalized)) {\n        normalizeResponsesToolsKeys(normalized as unknown as Record<string, unknown>);\n      }\n    }\n    return this.addFixture(this.own({ match, response: normalized, ...opts }));\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      this.own({\n        match: { userMessage: prompt, endpoint: \"image\" },\n        response,\n      }),\n    );\n  }\n\n  onSpeech(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { userMessage: input, endpoint: \"speech\" },\n        response,\n      }),\n    );\n  }\n\n  onTranscription(response: TranscriptionResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { endpoint: \"transcription\" },\n        response,\n      }),\n    );\n  }\n\n  onTranslation(response: TranscriptionResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { endpoint: \"translation\" },\n        response,\n      }),\n    );\n  }\n\n  onVideo(prompt: string | RegExp, response: VideoResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { userMessage: prompt, endpoint: \"video\" },\n        response,\n      }),\n    );\n  }\n\n  onAudio(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture(this.own({ match: { userMessage: input }, response }));\n  }\n\n  onSoundEffect(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { userMessage: text, endpoint: \"audio-gen\" },\n        response,\n      }),\n    );\n  }\n\n  onMusic(prompt: string | RegExp, response: AudioResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { userMessage: prompt, endpoint: \"audio-gen\" },\n        response,\n      }),\n    );\n  }\n\n  onElevenLabsTTS(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { userMessage: text, endpoint: \"elevenlabs-tts\" },\n        response,\n      }),\n    );\n  }\n\n  onElevenLabsVoiceDesign(description: string | RegExp, response: VoiceDesignResponse): this {\n    return this.addFixture(\n      this.own({\n        match: { userMessage: description, endpoint: \"elevenlabs-voice-design\" },\n        response: voiceDesignToJson(response),\n      }),\n    );\n  }\n\n  onFalAudio(prompt: string | RegExp, response: AudioResponse, model?: string): this {\n    return this.addFixture(\n      this.own({\n        match: { userMessage: prompt, endpoint: \"fal-audio\", ...(model ? { model } : {}) },\n        response,\n      }),\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      this.own({\n        match: { model: modelOrPrompt, endpoint: \"fal\" },\n        response: { json: response, ...(billableUnits != null ? { billableUnits } : {}) },\n        ...fixtureOpts,\n      }),\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      // B11/R12: only aimock's own MCPMock takes the replay speed; a custom\n      // Mountable is never called (1.44.0 had no such hook).\n      if (handler instanceof MCPMock) {\n        handler.setReplaySpeed(this.serverInstance.defaults.replaySpeed);\n      }\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  // ---- Semantic misbehavior ----\n\n  /** Replace construction/runtime baselines without changing named test overrides. */\n  setMisbehavior(config: MisbehaviorConfig | MisbehaviorFaultId): this {\n    if (!this.misbehaviorEnabled) {\n      throw new TypeError(\n        \"setMisbehavior: misbehavior is not enabled; construct with enableMisbehavior: true\",\n      );\n    }\n    const parsed = parseMisbehavior(config);\n    if (!parsed.ok) throw new TypeError(`${parsed.issue.rule}: ${parsed.issue.message}`);\n    this.options.misbehavior = parsed.config;\n    const defaults = this.serverInstance?.defaults;\n    if (defaults?.misbehavior) {\n      defaults.misbehavior.baseline =\n        parsed.config.seed === \"random\"\n          ? { ...parsed.config, seed: resolveMisbehaviorSeed(parsed.config.seed, defaults.logger) }\n          : parsed.config;\n      if (defaults.misbehavior.byTestId.has(DEFAULT_TEST_ID)) {\n        defaults.misbehavior.byTestId.set(DEFAULT_TEST_ID, defaults.misbehavior.baseline);\n      }\n    }\n    return this;\n  }\n\n  /** Clear the baseline and all runtime overrides, before or after start. */\n  clearMisbehavior(): this {\n    delete this.options.misbehavior;\n    const scope = this.serverInstance?.defaults.misbehavior;\n    if (scope) {\n      scope.baseline = undefined;\n      scope.byTestId.clear();\n    }\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    const countIdentity = (fixture: Fixture) => this.fixtureCountOrigins.get(fixture) ?? fixture;\n    this.serverInstance.journal.configureFixtureCountIdentity(countIdentity);\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/llmock.d.cts

@@ -1,6 +1,6 @@
 import { Journal } from "./journal.cjs";
 import { LiveTranscript } from "./live-types.cjs";
-import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse, VoiceDesignResponse } from "./types.cjs";
+import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MisbehaviorConfig, MisbehaviorFaultId, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse, VoiceDesignResponse } from "./types.cjs";
 import { ResolvedInboundAuth } from "./api-key-auth.cjs";
 import { SearchResult } from "./search.cjs";
 import { RerankResult } from "./rerank.cjs";
@@ -9,6 +9,13 @@ import { ModerationResult } from "./moderation.cjs";
 //#region src/llmock.d.ts
 declare class LLMock {
   private fixtures;
+  private fixtureAddition;
+  private readonly fixtureCountOrigins;
+  /**
+   * Fixtures this LLMock built itself (on() and the other helpers), so the
+   * caller never held them: the stored object is their identity.
+   */
+  private readonly ownFixtures;
   private searchFixtures;
   private rerankFixtures;
   private moderationFixtures;
@@ -20,10 +27,14 @@ declare class LLMock {
   private options;
   private readonly resolvedInboundAuth?;
   constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth);
+  /** Misbehavior (fixture keys, header, `misbehavior` option) needs `enableMisbehavior: true`. */
+  private get misbehaviorEnabled();
   private normalizeFixture;
   addFixture(fixture: Fixture): this;
   addFixtures(fixtures: Fixture[]): this;
   prependFixture(fixture: Fixture): this;
+  /** Mark a fixture this LLMock built, for {@link normalizeFixture}. */
+  private own;
   getFixtures(): readonly Fixture[];
   /**
    * Load a fixture file: its LLM fixtures and its `mcpFakes` blocks (F4).
@@ -136,6 +147,10 @@ declare class LLMock {
    * signal the `defaults.chaos` setter defines).
    */
   clearChaos(): this;
+  /** Replace construction/runtime baselines without changing named test overrides. */
+  setMisbehavior(config: MisbehaviorConfig | MisbehaviorFaultId): this;
+  /** Clear the baseline and all runtime overrides, before or after start. */
+  clearMisbehavior(): this;
   enableRecording(config: RecordConfig): this;
   disableRecording(): this;
   /**

package/dist/llmock.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"llmock.d.cts","names":[],"sources":["../src/llmock.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"llmock.d.cts","names":[],"sources":["../src/llmock.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/llmock.d.ts

@@ -1,6 +1,6 @@
 import { Journal } from "./journal.js";
 import { LiveTranscript } from "./live-types.js";
-import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse, VoiceDesignResponse } from "./types.js";
+import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MisbehaviorConfig, MisbehaviorFaultId, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse, VoiceDesignResponse } from "./types.js";
 import { ResolvedInboundAuth } from "./api-key-auth.js";
 import { SearchResult } from "./search.js";
 import { RerankResult } from "./rerank.js";
@@ -9,6 +9,13 @@ import { ModerationResult } from "./moderation.js";
 //#region src/llmock.d.ts
 declare class LLMock {
   private fixtures;
+  private fixtureAddition;
+  private readonly fixtureCountOrigins;
+  /**
+   * Fixtures this LLMock built itself (on() and the other helpers), so the
+   * caller never held them: the stored object is their identity.
+   */
+  private readonly ownFixtures;
   private searchFixtures;
   private rerankFixtures;
   private moderationFixtures;
@@ -20,10 +27,14 @@ declare class LLMock {
   private options;
   private readonly resolvedInboundAuth?;
   constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth);
+  /** Misbehavior (fixture keys, header, `misbehavior` option) needs `enableMisbehavior: true`. */
+  private get misbehaviorEnabled();
   private normalizeFixture;
   addFixture(fixture: Fixture): this;
   addFixtures(fixtures: Fixture[]): this;
   prependFixture(fixture: Fixture): this;
+  /** Mark a fixture this LLMock built, for {@link normalizeFixture}. */
+  private own;
   getFixtures(): readonly Fixture[];
   /**
    * Load a fixture file: its LLM fixtures and its `mcpFakes` blocks (F4).
@@ -136,6 +147,10 @@ declare class LLMock {
    * signal the `defaults.chaos` setter defines).
    */
   clearChaos(): this;
+  /** Replace construction/runtime baselines without changing named test overrides. */
+  setMisbehavior(config: MisbehaviorConfig | MisbehaviorFaultId): this;
+  /** Clear the baseline and all runtime overrides, before or after start. */
+  clearMisbehavior(): this;
   enableRecording(config: RecordConfig): this;
   disableRecording(): this;
   /**