@copilotkit/aimock 1.44.0 → 1.45.0

package/dist/jest.js

@@ -1,9 +1,17 @@
-import { FixtureLoadError } from "./fixture-loader.js";
+import { FixtureLoadError, MisbehaviorConfigError } from "./fixture-loader.js";
+import { AimockTestIdCollisionError } from "./mcp-fakes-report.js";
 import { LLMock } from "./llmock.js";
+import { FakesPluginState, TEST_ID_SEPARATOR, fakesReportMode, fakesTarget, fetchFakesReport } from "./fakes-plugin.js";
 import { statSync } from "node:fs";
-import { resolve } from "node:path";
+import { relative, resolve, sep } from "node:path";
 
 //#region src/jest.ts
+/** TI2: `<testPath relative to root, with "/"> › <currentTestName>`. */
+function defaultJestId(root) {
+	const { testPath, currentTestName } = expect.getState();
+	if (!testPath || currentTestName === void 0) throw new AimockTestIdCollisionError("default test ids are not supported here (concurrent test or no running test); pass an explicit testId");
+	return relative(root, testPath).split(sep).join("/") + TEST_ID_SEPARATOR + currentTestName;
+}
 /**
 * Start an aimock server for the duration of the test suite.
 *
@@ -11,7 +19,8 @@ import { resolve } from "node:path";
 *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
 * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
 *   consumption (not fixtures or fakes)
-* - `afterEach`: closes Live sessions owned by this helper's server
+* - `afterEach`: closes Live sessions owned by this helper's server, then checks
+*   the MCP fake report under `fakesReport: "warn" | "fail"`
 * - `afterAll`: stops the server
 *
 * Returns a getter function — call it inside tests to access the handle.
@@ -23,8 +32,11 @@ function useAimock(options = {}) {
 	let handle = null;
 	let origOpenaiUrl;
 	let origAnthropicUrl;
+	const root = resolve(options.testIdRoot ?? process.cwd());
+	let state = new FakesPluginState("off");
 	beforeAll(async () => {
-		const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;
+		const { fixtures: fixturePath, patchEnv, fakesReport, testIdRoot, ...serverOpts } = options;
+		state = new FakesPluginState(fakesReportMode(fakesReport));
 		const llm = new LLMock(serverOpts);
 		if (fixturePath) loadFixtures(llm, resolve(fixturePath));
 		const url = await llm.start();
@@ -36,17 +48,27 @@ function useAimock(options = {}) {
 		}
 		handle = {
 			llm,
-			url
+			url,
+			fakesFor(testId, opts = {}) {
+				const id = testId ?? defaultJestId(root);
+				state.register(id, opts.context ?? null);
+				return fakesTarget(url, id, opts);
+			},
+			fakesReport(testId, opts = {}) {
+				return fetchFakesReport(url, testId ?? defaultJestId(root), opts.context ?? null);
+			}
 		};
 	});
 	beforeEach(() => {
 		if (handle) {
 			handle.llm.closeLiveSessions();
 			handle.llm.resetMatchCounts();
+			state.beforeEach(handle.llm);
 		}
 	});
-	afterEach(() => {
+	afterEach(async () => {
 		handle?.llm.closeLiveSessions();
+		if (handle) await state.afterEach(handle.llm, handle.url);
 	});
 	afterAll(async () => {
 		if (handle) {
@@ -68,15 +90,17 @@ function useAimock(options = {}) {
 /**
 * Load a fixture file or directory into `llm`: its LLM fixtures and its
 * `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).
-* A `FixtureLoadError` (a bad `mcpFakes` block) propagates and fails
-* `beforeAll`; any other load failure is only warned about, as before.
+* A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`
+* (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)
+* propagates and fails `beforeAll`; any other load failure is only warned
+* about, as before.
 */
 function loadFixtures(llm, fixturePath) {
 	try {
 		if (statSync(fixturePath).isDirectory()) llm.loadFixtureDir(fixturePath);
 		else llm.loadFixtureFile(fixturePath);
 	} catch (err) {
-		if (err instanceof FixtureLoadError) throw err;
+		if (err instanceof FixtureLoadError || err instanceof MisbehaviorConfigError) throw err;
 		console.warn(`[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`);
 	}
 }

package/dist/jest.js.map

@@ -1 +1 @@
-{"version":3,"file":"jest.js","names":[],"sources":["../src/jest.ts"],"sourcesContent":["/**\n * Jest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/jest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\n/* eslint-disable no-var */\n// Jest globals — available at runtime in jest test files\ndeclare var beforeAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var beforeEach: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterEach: (fn: () => Promise<void> | void, timeout?: number) => void;\n/* eslint-enable no-var */\n\nimport { LLMock } from \"./llmock.js\";\nimport { FixtureLoadError } from \"./fixture-loader.js\";\nimport type { MockServerOptions } from \"./types.js\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and\n *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)\n * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake\n *   consumption (not fixtures or fakes)\n * - `afterEach`: closes Live sessions owned by this helper's server\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n *\n * NOTE: Jest globals (beforeAll, afterAll, beforeEach, afterEach) must be available\n * in the test environment. This works with the default jest configuration.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockHandle {\n  let handle: AimockHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      loadFixtures(llm, resolve(fixturePath));\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = { llm, url };\n  });\n\n  beforeEach(() => {\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n    }\n  });\n\n  afterEach(() => {\n    handle?.llm.closeLiveSessions();\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\n/**\n * Load a fixture file or directory into `llm`: its LLM fixtures and its\n * `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).\n * A `FixtureLoadError` (a bad `mcpFakes` block) propagates and fails\n * `beforeAll`; any other load failure is only warned about, as before.\n */\nfunction loadFixtures(llm: LLMock, fixturePath: string): void {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      llm.loadFixtureDir(fixturePath);\n    } else {\n      llm.loadFixtureFile(fixturePath);\n    }\n  } catch (err) {\n    if (err instanceof FixtureLoadError) throw err;\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,UAAU,UAA4B,EAAE,EAAsB;CAC5E,IAAI,SAA8B;CAClC,IAAI;CACJ,IAAI;AAEJ,WAAU,YAAY;EACpB,MAAM,EAAE,UAAU,aAAa,UAAU,GAAG,eAAe;EAC3D,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,MAAI,YACF,cAAa,KAAK,QAAQ,YAAY,CAAC;EAGzC,MAAM,MAAM,MAAM,IAAI,OAAO;AAE7B,MAAI,aAAa,OAAO;AACtB,mBAAgB,QAAQ,IAAI;AAC5B,sBAAmB,QAAQ,IAAI;AAC/B,WAAQ,IAAI,kBAAkB,GAAG,IAAI;AACrC,WAAQ,IAAI,qBAAqB,GAAG,IAAI;;AAG1C,WAAS;GAAE;GAAK;GAAK;GACrB;AAEF,kBAAiB;AACf,MAAI,QAAQ;AACV,UAAO,IAAI,mBAAmB;AAC9B,UAAO,IAAI,kBAAkB;;GAE/B;AAEF,iBAAgB;AACd,UAAQ,IAAI,mBAAmB;GAC/B;AAEF,UAAS,YAAY;AACnB,MAAI,QAAQ;AACV,OAAI,QAAQ,aAAa,OAAO;AAC9B,QAAI,kBAAkB,OAAW,SAAQ,IAAI,kBAAkB;QAC1D,QAAO,QAAQ,IAAI;AACxB,QAAI,qBAAqB,OAAW,SAAQ,IAAI,qBAAqB;QAChE,QAAO,QAAQ,IAAI;;AAE1B,SAAM,OAAO,IAAI,MAAM;AACvB,YAAS;;GAEX;AAEF,cAAa;AACX,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wEAAwE;AAE1F,SAAO;;;;;;;;;AAUX,SAAS,aAAa,KAAa,aAA2B;AAC5D,KAAI;AAEF,MADa,SAAS,YAAY,CACzB,aAAa,CACpB,KAAI,eAAe,YAAY;MAE/B,KAAI,gBAAgB,YAAY;UAE3B,KAAK;AACZ,MAAI,eAAe,iBAAkB,OAAM;AAC3C,UAAQ,KACN,yCAAyC,YAAY,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAC1G"}
+{"version":3,"file":"jest.js","names":[],"sources":["../src/jest.ts"],"sourcesContent":["/**\n * Jest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/jest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\n/* eslint-disable no-var */\n// Jest globals — available at runtime in jest test files\ndeclare var beforeAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var beforeEach: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterEach: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var expect: { getState(): { testPath?: string; currentTestName?: string } };\n/* eslint-enable no-var */\n\nimport { LLMock } from \"./llmock.js\";\nimport { FixtureLoadError, MisbehaviorConfigError } from \"./fixture-loader.js\";\nimport type { MockServerOptions } from \"./types.js\";\nimport {\n  FakesPluginState,\n  TEST_ID_SEPARATOR,\n  fakesReportMode,\n  fakesTarget,\n  fetchFakesReport,\n  type FakesForOptions,\n  type FakesReportMode,\n  type FakesTarget,\n} from \"./fakes-plugin.js\";\nimport { AimockTestIdCollisionError, type McpFakesReport } from \"./mcp-fakes-report.js\";\nimport { statSync } from \"node:fs\";\nimport { relative, resolve, sep } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n  /**\n   * The per-test MCP fake report, read in `afterEach` (RP7): `\"off\"` (the\n   * default), `\"warn\"` (print a failing report) or `\"fail\"` (throw\n   * `AimockFakesReportError`). Not supported with `test.concurrent`: the\n   * report keeps one state per `useAimock`, so concurrent tests clear and read\n   * each other's identities, and Jest cannot tell this plugin that a test is\n   * concurrent. Keep `\"off\"` for a suite with concurrent tests.\n   */\n  fakesReport?: FakesReportMode;\n  /**\n   * The directory default test ids are relative to (TI2). Defaults to\n   * `process.cwd()` when `useAimock` is called; Jest does not expose\n   * `rootDir` to test code.\n   */\n  testIdRoot?: string;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes\n * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and\n * code that builds its own `AimockHandle` keeps compiling.\n */\nexport interface AimockFakesHandle extends AimockHandle {\n  /**\n   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and\n   * registers that identity for this test's report. With no `testId`, the\n   * default is `<test file relative to testIdRoot> › <currentTestName>` (TI2);\n   * it is used only here and in `fakesReport`, never on LLM traffic (TI4).\n   * Two tests with the same full name in one file share a default id (TI5):\n   * pass an explicit `testId` for them. In `test.concurrent`, Jest can\n   * report another test's name, so pass an explicit `testId` there too (with\n   * `fakesReport: \"off\"`; the report is not supported in concurrent tests).\n   */\n  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;\n  /** The MCP fake report for `testId` (default as in `fakesFor`). */\n  fakesReport(testId?: string, opts?: { context?: string }): Promise<McpFakesReport>;\n}\n\n/** TI2: `<testPath relative to root, with \"/\"> › <currentTestName>`. */\nfunction defaultJestId(root: string): string {\n  const { testPath, currentTestName } = expect.getState();\n  if (!testPath || currentTestName === undefined) {\n    throw new AimockTestIdCollisionError(\n      \"default test ids are not supported here (concurrent test or no running test); pass an explicit testId\",\n    );\n  }\n  return relative(root, testPath).split(sep).join(\"/\") + TEST_ID_SEPARATOR + currentTestName;\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and\n *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)\n * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake\n *   consumption (not fixtures or fakes)\n * - `afterEach`: closes Live sessions owned by this helper's server, then checks\n *   the MCP fake report under `fakesReport: \"warn\" | \"fail\"`\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n *\n * NOTE: Jest globals (beforeAll, afterAll, beforeEach, afterEach) must be available\n * in the test environment. This works with the default jest configuration.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockFakesHandle {\n  let handle: AimockFakesHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n  const root = resolve(options.testIdRoot ?? process.cwd());\n  let state = new FakesPluginState(\"off\");\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, fakesReport, testIdRoot, ...serverOpts } = options;\n    void testIdRoot; // read above, when useAimock is called\n    state = new FakesPluginState(fakesReportMode(fakesReport));\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      loadFixtures(llm, resolve(fixturePath));\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = {\n      llm,\n      url,\n      fakesFor(testId?: string, opts: FakesForOptions = {}): FakesTarget {\n        const id = testId ?? defaultJestId(root); // TI4: an explicit id wins\n        state.register(id, opts.context ?? null);\n        return fakesTarget(url, id, opts);\n      },\n      fakesReport(testId?: string, opts: { context?: string } = {}): Promise<McpFakesReport> {\n        return fetchFakesReport(url, testId ?? defaultJestId(root), opts.context ?? null);\n      },\n    };\n  });\n\n  beforeEach(() => {\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n      state.beforeEach(handle.llm);\n    }\n  });\n\n  afterEach(async () => {\n    handle?.llm.closeLiveSessions();\n    if (handle) await state.afterEach(handle.llm, handle.url);\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\n/**\n * Load a fixture file or directory into `llm`: its LLM fixtures and its\n * `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).\n * A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`\n * (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)\n * propagates and fails `beforeAll`; any other load failure is only warned\n * about, as before.\n */\nfunction loadFixtures(llm: LLMock, fixturePath: string): void {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      llm.loadFixtureDir(fixturePath);\n    } else {\n      llm.loadFixtureFile(fixturePath);\n    }\n  } catch (err) {\n    if (err instanceof FixtureLoadError || err instanceof MisbehaviorConfigError) throw err;\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\nexport type { FakesForOptions, FakesReportMode, FakesTarget } from \"./fakes-plugin.js\";\nexport type { McpFakesReport } from \"./mcp-fakes-report.js\";\n"],"mappings":";;;;;;;;;AA0FA,SAAS,cAAc,MAAsB;CAC3C,MAAM,EAAE,UAAU,oBAAoB,OAAO,UAAU;AACvD,KAAI,CAAC,YAAY,oBAAoB,OACnC,OAAM,IAAI,2BACR,wGACD;AAEH,QAAO,SAAS,MAAM,SAAS,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,GAAG,oBAAoB;;;;;;;;;;;;;;;;;;AAmB7E,SAAgB,UAAU,UAA4B,EAAE,EAA2B;CACjF,IAAI,SAAmC;CACvC,IAAI;CACJ,IAAI;CACJ,MAAM,OAAO,QAAQ,QAAQ,cAAc,QAAQ,KAAK,CAAC;CACzD,IAAI,QAAQ,IAAI,iBAAiB,MAAM;AAEvC,WAAU,YAAY;EACpB,MAAM,EAAE,UAAU,aAAa,UAAU,aAAa,YAAY,GAAG,eAAe;AAEpF,UAAQ,IAAI,iBAAiB,gBAAgB,YAAY,CAAC;EAC1D,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,MAAI,YACF,cAAa,KAAK,QAAQ,YAAY,CAAC;EAGzC,MAAM,MAAM,MAAM,IAAI,OAAO;AAE7B,MAAI,aAAa,OAAO;AACtB,mBAAgB,QAAQ,IAAI;AAC5B,sBAAmB,QAAQ,IAAI;AAC/B,WAAQ,IAAI,kBAAkB,GAAG,IAAI;AACrC,WAAQ,IAAI,qBAAqB,GAAG,IAAI;;AAG1C,WAAS;GACP;GACA;GACA,SAAS,QAAiB,OAAwB,EAAE,EAAe;IACjE,MAAM,KAAK,UAAU,cAAc,KAAK;AACxC,UAAM,SAAS,IAAI,KAAK,WAAW,KAAK;AACxC,WAAO,YAAY,KAAK,IAAI,KAAK;;GAEnC,YAAY,QAAiB,OAA6B,EAAE,EAA2B;AACrF,WAAO,iBAAiB,KAAK,UAAU,cAAc,KAAK,EAAE,KAAK,WAAW,KAAK;;GAEpF;GACD;AAEF,kBAAiB;AACf,MAAI,QAAQ;AACV,UAAO,IAAI,mBAAmB;AAC9B,UAAO,IAAI,kBAAkB;AAC7B,SAAM,WAAW,OAAO,IAAI;;GAE9B;AAEF,WAAU,YAAY;AACpB,UAAQ,IAAI,mBAAmB;AAC/B,MAAI,OAAQ,OAAM,MAAM,UAAU,OAAO,KAAK,OAAO,IAAI;GACzD;AAEF,UAAS,YAAY;AACnB,MAAI,QAAQ;AACV,OAAI,QAAQ,aAAa,OAAO;AAC9B,QAAI,kBAAkB,OAAW,SAAQ,IAAI,kBAAkB;QAC1D,QAAO,QAAQ,IAAI;AACxB,QAAI,qBAAqB,OAAW,SAAQ,IAAI,qBAAqB;QAChE,QAAO,QAAQ,IAAI;;AAE1B,SAAM,OAAO,IAAI,MAAM;AACvB,YAAS;;GAEX;AAEF,cAAa;AACX,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wEAAwE;AAE1F,SAAO;;;;;;;;;;;AAYX,SAAS,aAAa,KAAa,aAA2B;AAC5D,KAAI;AAEF,MADa,SAAS,YAAY,CACzB,aAAa,CACpB,KAAI,eAAe,YAAY;MAE/B,KAAI,gBAAgB,YAAY;UAE3B,KAAK;AACZ,MAAI,eAAe,oBAAoB,eAAe,uBAAwB,OAAM;AACpF,UAAQ,KACN,yCAAyC,YAAY,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAC1G"}

package/dist/journal.cjs

@@ -76,12 +76,43 @@ function systemMessageEqual(a, b) {
 * (ignoring sequenceIndex). Used to group sequenced fixtures.
 */
 function matchCriteriaEqual(a, b) {
-	return fieldEqual(a.userMessage, b.userMessage) && systemMessageEqual(a.systemMessage, b.systemMessage) && fieldEqual(a.inputText, b.inputText) && fieldEqual(a.toolCallId, b.toolCallId) && fieldEqual(a.toolName, b.toolName) && fieldEqual(a.model, b.model) && fieldEqual(a.responseFormat, b.responseFormat) && fieldEqual(a.predicate, b.predicate) && fieldEqual(a.endpoint, b.endpoint) && fieldEqual(a.turnIndex, b.turnIndex) && fieldEqual(a.hasToolResult, b.hasToolResult) && fieldEqual(a.toolResultContains, b.toolResultContains) && fieldEqual(a.context, b.context);
+	return fieldEqual(a.userMessage, b.userMessage) && systemMessageEqual(a.systemMessage, b.systemMessage) && fieldEqual(a.inputText, b.inputText) && fieldEqual(a.toolCallId, b.toolCallId) && fieldEqual(a.toolName, b.toolName) && fieldEqual(a.toolNamespace, b.toolNamespace) && fieldEqual(a.model, b.model) && fieldEqual(a.responseFormat, b.responseFormat) && fieldEqual(a.predicate, b.predicate) && fieldEqual(a.endpoint, b.endpoint) && fieldEqual(a.turnIndex, b.turnIndex) && fieldEqual(a.hasToolResult, b.hasToolResult) && fieldEqual(a.toolResultContains, b.toolResultContains) && fieldEqual(a.context, b.context);
 }
+/** Count-map keys resolve through `identity`, so every alias of a fixture finds its caller entry. */
+var FixtureCountMap = class extends Map {
+	constructor(identity) {
+		super();
+		this.identity = identity;
+	}
+	get(key) {
+		return super.get(this.identity(key));
+	}
+	has(key) {
+		return super.has(this.identity(key));
+	}
+	set(key, value) {
+		return super.set(this.identity(key), value);
+	}
+	delete(key) {
+		return super.delete(this.identity(key));
+	}
+};
 var Journal = class {
 	entries = [];
 	matchedFixtures = /* @__PURE__ */ new WeakMap();
+	/** The fixture a request was served from, where the entry names its caller fixture instead. */
+	servedFixtures = /* @__PURE__ */ new WeakMap();
 	fixtureMatchCountsByTestId = /* @__PURE__ */ new Map();
+	/** An extended server's view of a fixture to the caller's fixture (configureFixtureViewSource). */
+	fixtureViewSource = (fixture) => fixture;
+	fixtureCountIdentity = (fixture) => fixture;
+	/** The key a fixture is counted under: the caller's object behind any view or copy. */
+	fixtureCountKey = (fixture) => this.fixtureCountIdentity(this.fixtureViewSource(fixture));
+	createFixtureCountMap = () => /* @__PURE__ */ new Map();
+	fixtureCountIdentityConfigured = false;
+	fixtureViewSourceConfigured = false;
+	counterTestIds = /* @__PURE__ */ new Set();
+	misbehaviorCountersByTestId = /* @__PURE__ */ new Map();
 	maxEntries;
 	fixtureCountsMaxTestIds;
 	onAdd;
@@ -124,7 +155,16 @@ var Journal = class {
 			...entry,
 			body: capBody(entry.body)
 		};
-		if (matchedFixture) this.matchedFixtures.set(full, matchedFixture);
+		const fixture = full.response.fixture;
+		const source = fixture ? this.fixtureCountKey(fixture) : fixture;
+		if (fixture && source !== fixture) {
+			full.response = {
+				...full.response,
+				fixture: source
+			};
+			this.servedFixtures.set(full, fixture);
+		}
+		if (matchedFixture) this.matchedFixtures.set(full, this.fixtureCountKey(matchedFixture));
 		this.entries.push(full);
 		if (this.maxEntries > 0 && this.entries.length > this.maxEntries) this.entries.shift();
 		this.onAdd?.(full);
@@ -151,7 +191,16 @@ var Journal = class {
 		return this.entries.length > 0 ? this.entries[this.entries.length - 1] : null;
 	}
 	findByFixture(fixture) {
-		return this.entries.filter((e) => (this.matchedFixtures.get(e) ?? e.response.fixture) === fixture);
+		const key = this.fixtureCountKey(fixture);
+		return this.entries.filter((e) => (this.matchedFixtures.get(e) ?? e.response.fixture) === key);
+	}
+	/**
+	* @internal The fixture `entry`'s request was served from: the extended
+	* view or the per-addition copy when the entry names the caller's fixture
+	* behind it, otherwise `entry.response.fixture`. The journal JSON shows it.
+	*/
+	servedFixture(entry) {
+		return this.servedFixtures.get(entry) ?? entry.response.fixture;
 	}
 	/**
 	* READ-ONLY accessor. Returns the existing count map for `testId`, or an
@@ -161,7 +210,7 @@ var Journal = class {
 	* `getOrCreateFixtureMatchCountsForTest`.
 	*/
 	getFixtureMatchCountsForTest(testId) {
-		return this.fixtureMatchCountsByTestId.get(testId) ?? /* @__PURE__ */ new Map();
+		return this.fixtureMatchCountsByTestId.get(testId) ?? this.createFixtureCountMap();
 	}
 	/**
 	* WRITE path: get the count map for `testId`, inserting a fresh empty Map
@@ -172,15 +221,83 @@ var Journal = class {
 	getOrCreateFixtureMatchCountsForTest(testId) {
 		let counts = this.fixtureMatchCountsByTestId.get(testId);
 		if (!counts) {
-			counts = /* @__PURE__ */ new Map();
+			counts = this.createFixtureCountMap();
 			this.fixtureMatchCountsByTestId.set(testId, counts);
-			if (this.fixtureCountsMaxTestIds > 0 && this.fixtureMatchCountsByTestId.size > this.fixtureCountsMaxTestIds) {
-				const oldest = this.fixtureMatchCountsByTestId.keys().next().value;
-				if (oldest !== void 0) this.fixtureMatchCountsByTestId.delete(oldest);
-			}
+			this.admitCounterTestId(testId);
 		}
 		return counts;
 	}
+	/** Match and fault mutations share one admission order and capacity. */
+	admitCounterTestId(testId) {
+		this.counterTestIds.add(testId);
+		if (this.fixtureCountsMaxTestIds > 0 && this.counterTestIds.size > this.fixtureCountsMaxTestIds) {
+			const oldest = this.counterTestIds.values().next().value;
+			if (oldest !== void 0) {
+				this.counterTestIds.delete(oldest);
+				this.fixtureMatchCountsByTestId.delete(oldest);
+				this.misbehaviorCountersByTestId.delete(oldest);
+			}
+		}
+	}
+	getOrCreateMisbehaviorCounter(key) {
+		let sources = this.misbehaviorCountersByTestId.get(key.testId);
+		if (!sources) {
+			sources = /* @__PURE__ */ new Map();
+			this.misbehaviorCountersByTestId.set(key.testId, sources);
+			this.admitCounterTestId(key.testId);
+		}
+		let entries = sources.get(key.sourceKey);
+		if (!entries) {
+			entries = /* @__PURE__ */ new Map();
+			sources.set(key.sourceKey, entries);
+		}
+		let counter = entries.get(key.entryIndex);
+		if (!counter) {
+			counter = {
+				ordinal: 0,
+				firings: 0
+			};
+			entries.set(key.entryIndex, counter);
+		}
+		return counter;
+	}
+	getFiringCount(key) {
+		return this.misbehaviorCountersByTestId.get(key.testId)?.get(key.sourceKey)?.get(key.entryIndex)?.firings ?? 0;
+	}
+	nextOrdinal(key) {
+		return this.getOrCreateMisbehaviorCounter(key).ordinal++;
+	}
+	recordFiring(key) {
+		this.getOrCreateMisbehaviorCounter(key).firings++;
+	}
+	clearMisbehaviorCounters(testId) {
+		if (testId !== void 0) {
+			this.misbehaviorCountersByTestId.delete(testId);
+			if (!this.fixtureMatchCountsByTestId.has(testId)) this.counterTestIds.delete(testId);
+		} else {
+			this.misbehaviorCountersByTestId.clear();
+			for (const id of this.counterTestIds) if (!this.fixtureMatchCountsByTestId.has(id)) this.counterTestIds.delete(id);
+		}
+	}
+	/** @internal LLMock configures caller count identity before serving requests. */
+	configureFixtureCountIdentity(identity) {
+		if (this.fixtureCountIdentityConfigured || this.fixtureMatchCountsByTestId.size > 0) throw new Error("Fixture count identity must be configured once before counting");
+		this.fixtureCountIdentity = identity;
+		this.createFixtureCountMap = () => new FixtureCountMap(this.fixtureCountKey);
+		this.fixtureCountIdentityConfigured = true;
+	}
+	/**
+	* @internal A server with `responsesTools: "extended"` matches each fixture
+	* through its extended view. `source` maps a view back to the caller's
+	* fixture, so counts, `findByFixture` and `JournalEntry.response.fixture`
+	* keep the caller's object. Configured once, before counting.
+	*/
+	configureFixtureViewSource(source) {
+		if (this.fixtureViewSourceConfigured || this.fixtureMatchCountsByTestId.size > 0) throw new Error("Fixture view source must be configured once before counting");
+		this.fixtureViewSource = source;
+		this.createFixtureCountMap = () => new FixtureCountMap(this.fixtureCountKey);
+		this.fixtureViewSourceConfigured = true;
+	}
 	getFixtureMatchCount(fixture, testId = require_constants.DEFAULT_TEST_ID) {
 		return this.getFixtureMatchCountsForTest(testId).get(fixture) ?? 0;
 	}
@@ -188,14 +305,19 @@ var Journal = class {
 		const counts = this.getOrCreateFixtureMatchCountsForTest(testId);
 		counts.set(fixture, (counts.get(fixture) ?? 0) + 1);
 		if (fixture.match.sequenceIndex !== void 0 && allFixtures) for (const sibling of allFixtures) {
-			if (sibling === fixture) continue;
+			if (this.fixtureCountKey(sibling) === this.fixtureCountKey(fixture)) continue;
 			if (sibling.match.sequenceIndex === void 0) continue;
 			if (matchCriteriaEqual(fixture.match, sibling.match)) counts.set(sibling, (counts.get(sibling) ?? 0) + 1);
 		}
 	}
 	clearMatchCounts(testId) {
-		if (testId !== void 0) this.fixtureMatchCountsByTestId.delete(testId);
-		else this.fixtureMatchCountsByTestId.clear();
+		if (testId !== void 0) {
+			this.fixtureMatchCountsByTestId.delete(testId);
+			this.clearMisbehaviorCounters(testId);
+		} else {
+			this.fixtureMatchCountsByTestId.clear();
+			this.clearMisbehaviorCounters();
+		}
 	}
 	/**
 	* Clear ONLY the request journal entries, preserving fixture match-counts.
@@ -209,7 +331,7 @@ var Journal = class {
 	}
 	clear() {
 		this.entries = [];
-		this.fixtureMatchCountsByTestId.clear();
+		this.clearMatchCounts();
 	}
 	get size() {
 		return this.entries.length;

package/dist/journal.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"journal.cjs","names":["DEFAULT_TEST_ID","generateId"],"sources":["../src/journal.ts"],"sourcesContent":["import { generateId } from \"./helpers.js\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  FixtureMatch,\n  JournalBody,\n  JournalEntry,\n} from \"./types.js\";\nimport { DEFAULT_TEST_ID } from \"./constants.js\";\nexport { DEFAULT_TEST_ID } from \"./constants.js\";\n\n/**\n * Maximum UTF-8 byte length of a serialized request body retained in a\n * journal entry. Bodies whose JSON serialization exceeds this byte size are\n * replaced with a truncation marker.\n *\n * Only the request `body` field is capped here. `headers` and `path` are\n * retained uncapped, but they are naturally bounded by Node's default ~16 KB\n * maximum HTTP header size, so the per-entry overhead beyond the body cap\n * remains small. Combined with the journal's maxEntries limit (default 1000),\n * the total `JSON.stringify(journal.getAll())` output stays well under V8's\n * ~512 MB string limit even at maximum capacity.\n */\nconst JOURNAL_BODY_CAP_BYTES = 64 * 1024; // 64 KB\n\n/**\n * If `body` serializes to more than JOURNAL_BODY_CAP_BYTES (in UTF-8 bytes),\n * replace it with a truncation marker. Returns the original body when within\n * the cap, or null when `body` is null.\n *\n * The gate uses Buffer.byteLength (UTF-8 bytes) rather than .length (UTF-16\n * code units) to match the constant name and to correctly cap multibyte\n * content (e.g. CJK/emoji) whose code-unit count falls under the threshold\n * but whose byte size does not.\n */\nfunction capBody(body: JournalBody | null): JournalBody | null {\n  if (body === null) return null;\n  const serialized = JSON.stringify(body);\n  if (Buffer.byteLength(serialized, \"utf8\") <= JOURNAL_BODY_CAP_BYTES) return body;\n  // The marker is not a chat request, and `JournalBody` no longer claims it is\n  // — downstream consumers (e.g. GET /journal) treat the body as opaque JSON.\n  return {\n    __aimock_truncated: true,\n    originalByteSize: Buffer.byteLength(serialized, \"utf8\"),\n    note: \"body truncated by aimock journal cap (64 KB limit)\",\n  };\n}\n\n/**\n * Narrow a journaled body to a chat-completion request.\n *\n * `JournalEntry.body` is a union (see {@link JournalBody}): most entries hold a\n * chat request, but the fine-tuning create payload and this module's own\n * truncation marker do not. Anything reading `messages`, `model` or the rest of\n * the chat shape off a journal entry — inside aimock or in a consumer's test\n * — goes through here, so an entry that is not a chat request fails as a\n * `false` it can assert on rather than as an undefined property three accesses\n * later.\n *\n * `messages` is the discriminator because it is the one required field no\n * other journaled shape carries.\n */\nexport function isChatCompletionBody(\n  body: JournalBody | null | undefined,\n): body is ChatCompletionRequest {\n  return (\n    body !== null &&\n    body !== undefined &&\n    Array.isArray((body as { messages?: unknown }).messages) &&\n    typeof (body as { model?: unknown }).model === \"string\"\n  );\n}\n\n/**\n * Compare two field values, handling RegExp by source+flags rather than reference.\n */\nfunction fieldEqual(a: unknown, b: unknown): boolean {\n  if (a instanceof RegExp && b instanceof RegExp)\n    return a.source === b.source && a.flags === b.flags;\n  return a === b;\n}\n\n/**\n * Compare two systemMessage values. Handles string, string[], and RegExp.\n * Both-undefined is treated as equal.\n */\nfunction systemMessageEqual(\n  a: string | string[] | RegExp | undefined,\n  b: string | string[] | RegExp | undefined,\n): boolean {\n  if (a === undefined && b === undefined) return true;\n  if (a === undefined || b === undefined) return false;\n  if (typeof a === \"string\" && typeof b === \"string\") return a === b;\n  if (Array.isArray(a) && Array.isArray(b))\n    return a.length === b.length && a.every((v, i) => v === b[i]);\n  if (a instanceof RegExp && b instanceof RegExp)\n    return a.source === b.source && a.flags === b.flags;\n  return false;\n}\n\n/**\n * Check whether two fixture match objects have the same criteria\n * (ignoring sequenceIndex). Used to group sequenced fixtures.\n */\nfunction matchCriteriaEqual(a: FixtureMatch, b: FixtureMatch): boolean {\n  return (\n    fieldEqual(a.userMessage, b.userMessage) &&\n    systemMessageEqual(a.systemMessage, b.systemMessage) &&\n    fieldEqual(a.inputText, b.inputText) &&\n    fieldEqual(a.toolCallId, b.toolCallId) &&\n    fieldEqual(a.toolName, b.toolName) &&\n    fieldEqual(a.model, b.model) &&\n    fieldEqual(a.responseFormat, b.responseFormat) &&\n    fieldEqual(a.predicate, b.predicate) &&\n    fieldEqual(a.endpoint, b.endpoint) &&\n    fieldEqual(a.turnIndex, b.turnIndex) &&\n    fieldEqual(a.hasToolResult, b.hasToolResult) &&\n    fieldEqual(a.toolResultContains, b.toolResultContains) &&\n    fieldEqual(a.context, b.context)\n  );\n}\n\nexport interface JournalOptions {\n  /**\n   * Maximum number of entries to retain. When exceeded, oldest entries are\n   * dropped FIFO. Set to 0 (or omit) for unbounded retention (the historical\n   * default — suitable for short-lived test runs only). Negative values are\n   * rejected at the CLI parse layer; programmatically they are treated as 0\n   * (unbounded) for back-compat.\n   *\n   * Long-running servers (e.g. mock proxies in CI/demo environments) should\n   * always set a finite cap: every request appends an entry holding the\n   * request body + headers + fixture reference, and without a cap the\n   * journal grows until the process OOMs.\n   */\n  maxEntries?: number;\n  /**\n   * Maximum number of unique testIds retained in the fixture match-count\n   * map (`fixtureMatchCountsByTestId`). When exceeded, the oldest testId\n   * (by first-insertion order) is evicted FIFO. Set to 0 (or omit) for\n   * unbounded retention. Negative values are rejected at the CLI parse\n   * layer; programmatically they are treated as 0 (unbounded) for\n   * back-compat. Without a cap this map can grow over time in long-running\n   * servers that see many unique testIds.\n   */\n  fixtureCountsMaxTestIds?: number;\n  /**\n   * Called with every entry {@link Journal.add} creates, right after it is\n   * recorded. The hook exists so an embedder can attribute an entry to the\n   * request that produced it WITHOUT touching each of the ~100 `journal.add`\n   * call sites spread across the handler modules: the server binds the entry\n   * to the in-flight `IncomingMessage` here, and its error arm then amends\n   * that exact object rather than guessing from a caller-supplied header.\n   *\n   * The entry is already recorded when the hook runs, so a hook that throws\n   * does not lose the write — but it does propagate out of `add` into the\n   * caller's error path, so a hook must not throw.\n   */\n  onAdd?: (entry: JournalEntry) => void;\n}\n\nexport class Journal {\n  private entries: JournalEntry[] = [];\n  private readonly matchedFixtures = new WeakMap<JournalEntry, Fixture>();\n  private readonly fixtureMatchCountsByTestId: Map<string, Map<Fixture, number>> = new Map();\n  private readonly maxEntries: number;\n  private readonly fixtureCountsMaxTestIds: number;\n  private readonly onAdd?: (entry: JournalEntry) => void;\n\n  constructor(options: JournalOptions = {}) {\n    this.onAdd = options.onAdd;\n    // Treat 0 or negative as \"unbounded\" to preserve prior behavior when\n    // the option is omitted or explicitly disabled.\n    const cap = options.maxEntries;\n    this.maxEntries = cap !== undefined && cap > 0 ? cap : 0;\n    const testIdCap = options.fixtureCountsMaxTestIds;\n    this.fixtureCountsMaxTestIds = testIdCap !== undefined && testIdCap > 0 ? testIdCap : 0;\n  }\n\n  /**\n   * The per-test-id cap on fixture match-count maps, for an MCP mount to pass\n   * to `McpFakeStore.setMaxTestIds`. Always a non-negative safe integer, `0`\n   * meaning unbounded, and never throws, whatever option was passed:\n   * omitted, zero, negative or `NaN` is `0`; `Infinity` or a value above\n   * `Number.MAX_SAFE_INTEGER` (never reached) is `0`; a fraction of 1 or more\n   * is rounded down (`1.5` evicts at 2 ids, so it keeps 1). For these values\n   * it is the number of test ids the journal keeps.\n   *\n   * An option between 0 and 1 is the exception. The journal keeps no test id\n   * (each new count map is evicted as soon as it is made, so counts never\n   * advance), and a store cap cannot say \"keep none\" because `0` is\n   * unbounded. The getter returns `1`, the smallest bounded cap, so a store\n   * given it keeps 1 test id where the journal keeps 0.\n   */\n  get fixtureCountsMaxTestIdsCap(): number {\n    const cap = this.fixtureCountsMaxTestIds;\n    if (!(cap > 0) || cap > Number.MAX_SAFE_INTEGER) return 0;\n    return Math.max(1, Math.floor(cap));\n  }\n\n  /** Backwards-compatible accessor — returns the default (no testId) count map. */\n  get fixtureMatchCounts(): Map<Fixture, number> {\n    return this.getFixtureMatchCountsForTest(DEFAULT_TEST_ID);\n  }\n\n  /** @internal matchedFixture preserves identity when Live supplies safe diagnostics. */\n  add(entry: Omit<JournalEntry, \"id\" | \"timestamp\">, matchedFixture?: Fixture): JournalEntry {\n    const full: JournalEntry = {\n      id: generateId(\"req\"),\n      timestamp: Date.now(),\n      ...entry,\n      body: capBody(entry.body),\n    };\n    if (matchedFixture) this.matchedFixtures.set(full, matchedFixture);\n    this.entries.push(full);\n    // FIFO eviction when over capacity. Array.prototype.shift() is O(n)\n    // regardless of how many we drop per add; we accept it at small caps\n    // (default 1000) because the constant factor is tiny and this runs once\n    // per request. For much larger caps, switch to a ring buffer for true\n    // O(1) eviction.\n    if (this.maxEntries > 0 && this.entries.length > this.maxEntries) {\n      this.entries.shift();\n    }\n    this.onAdd?.(full);\n    return full;\n  }\n\n  /**\n   * Return every entry, or with `limit` the most recent `limit` entries.\n   * `0` returns `[]` — exactly what `GET /__aimock/journal?limit=0` answers.\n   * `slice(-0)` is `slice(0)`, so a `0` used to return the ENTIRE journal; it\n   * is special-cased so the library and the HTTP route agree. This is a public\n   * library API, so odd limits are tolerated rather than thrown on: a\n   * non-finite limit (`NaN`, `Infinity`) means \"no limit\", a fractional limit\n   * floors, and any limit at or below `0` asks for nothing.\n   */\n  getAll(opts?: { limit?: number }): JournalEntry[] {\n    if (opts?.limit !== undefined && Number.isFinite(opts.limit)) {\n      const limit = Math.floor(opts.limit);\n      if (limit <= 0) return [];\n      return this.entries.slice(-limit);\n    }\n    return this.entries.slice();\n  }\n\n  getLast(): JournalEntry | null {\n    return this.entries.length > 0 ? this.entries[this.entries.length - 1] : null;\n  }\n\n  findByFixture(fixture: Fixture): JournalEntry[] {\n    return this.entries.filter(\n      (e) => (this.matchedFixtures.get(e) ?? e.response.fixture) === fixture,\n    );\n  }\n\n  /**\n   * READ-ONLY accessor. Returns the existing count map for `testId`, or an\n   * empty transient Map if none exists. Does NOT insert into the cache and\n   * does NOT trigger FIFO eviction — callers may read freely without\n   * perturbing cache state. For the write path, see\n   * `getOrCreateFixtureMatchCountsForTest`.\n   */\n  getFixtureMatchCountsForTest(testId: string): Map<Fixture, number> {\n    return this.fixtureMatchCountsByTestId.get(testId) ?? new Map();\n  }\n\n  /**\n   * WRITE path: get the count map for `testId`, inserting a fresh empty Map\n   * if missing and running FIFO eviction when the testId cap is exceeded.\n   * Only callers that intend to mutate the map (e.g. incrementing a count)\n   * should use this.\n   */\n  private getOrCreateFixtureMatchCountsForTest(testId: string): Map<Fixture, number> {\n    let counts = this.fixtureMatchCountsByTestId.get(testId);\n    if (!counts) {\n      counts = new Map();\n      this.fixtureMatchCountsByTestId.set(testId, counts);\n      // FIFO eviction when over capacity. JS Map preserves insertion order,\n      // so the first key returned by keys() is the oldest. Same O(n) shift\n      // caveat as `entries`: acceptable at small caps (createServer\n      // default 500; a bare Journal is unbounded).\n      if (\n        this.fixtureCountsMaxTestIds > 0 &&\n        this.fixtureMatchCountsByTestId.size > this.fixtureCountsMaxTestIds\n      ) {\n        const oldest = this.fixtureMatchCountsByTestId.keys().next().value;\n        if (oldest !== undefined) {\n          this.fixtureMatchCountsByTestId.delete(oldest);\n        }\n      }\n    }\n    return counts;\n  }\n\n  getFixtureMatchCount(fixture: Fixture, testId = DEFAULT_TEST_ID): number {\n    return this.getFixtureMatchCountsForTest(testId).get(fixture) ?? 0;\n  }\n\n  incrementFixtureMatchCount(\n    fixture: Fixture,\n    allFixtures?: readonly Fixture[],\n    testId = DEFAULT_TEST_ID,\n  ): void {\n    const counts = this.getOrCreateFixtureMatchCountsForTest(testId);\n    counts.set(fixture, (counts.get(fixture) ?? 0) + 1);\n    // When a sequenced fixture matches, also increment all siblings with matching criteria\n    if (fixture.match.sequenceIndex !== undefined && allFixtures) {\n      for (const sibling of allFixtures) {\n        if (sibling === fixture) continue;\n        if (sibling.match.sequenceIndex === undefined) continue;\n        if (matchCriteriaEqual(fixture.match, sibling.match)) {\n          counts.set(sibling, (counts.get(sibling) ?? 0) + 1);\n        }\n      }\n    }\n  }\n\n  clearMatchCounts(testId?: string): void {\n    if (testId !== undefined) {\n      this.fixtureMatchCountsByTestId.delete(testId);\n    } else {\n      this.fixtureMatchCountsByTestId.clear();\n    }\n  }\n\n  /**\n   * Clear ONLY the request journal entries, preserving fixture match-counts.\n   * Match-counts are fixture-matching/sequencing state, not journal data, so\n   * clearing the journal must not silently rewind sequenced fixtures. Used by\n   * `POST /__aimock/reset/journal`. For a full reset (entries + match-counts),\n   * use `clear()` instead.\n   */\n  clearEntries(): void {\n    this.entries = [];\n  }\n\n  clear(): void {\n    this.entries = [];\n    this.fixtureMatchCountsByTestId.clear();\n  }\n\n  get size(): number {\n    return this.entries.length;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"journal.cjs","names":["DEFAULT_TEST_ID","generateId"],"sources":["../src/journal.ts"],"sourcesContent":["import { generateId } from \"./helpers.js\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  FixtureMatch,\n  JournalBody,\n  JournalEntry,\n  MisbehaviorCounterKey,\n  MisbehaviorCounters,\n} from \"./types.js\";\nimport { DEFAULT_TEST_ID } from \"./constants.js\";\nexport { DEFAULT_TEST_ID } from \"./constants.js\";\n\n/**\n * Maximum UTF-8 byte length of a serialized request body retained in a\n * journal entry. Bodies whose JSON serialization exceeds this byte size are\n * replaced with a truncation marker.\n *\n * Only the request `body` field is capped here. `headers` and `path` are\n * retained uncapped, but they are naturally bounded by Node's default ~16 KB\n * maximum HTTP header size, so the per-entry overhead beyond the body cap\n * remains small. Combined with the journal's maxEntries limit (default 1000),\n * the total `JSON.stringify(journal.getAll())` output stays well under V8's\n * ~512 MB string limit even at maximum capacity.\n */\nconst JOURNAL_BODY_CAP_BYTES = 64 * 1024; // 64 KB\n\n/**\n * If `body` serializes to more than JOURNAL_BODY_CAP_BYTES (in UTF-8 bytes),\n * replace it with a truncation marker. Returns the original body when within\n * the cap, or null when `body` is null.\n *\n * The gate uses Buffer.byteLength (UTF-8 bytes) rather than .length (UTF-16\n * code units) to match the constant name and to correctly cap multibyte\n * content (e.g. CJK/emoji) whose code-unit count falls under the threshold\n * but whose byte size does not.\n */\nfunction capBody(body: JournalBody | null): JournalBody | null {\n  if (body === null) return null;\n  const serialized = JSON.stringify(body);\n  if (Buffer.byteLength(serialized, \"utf8\") <= JOURNAL_BODY_CAP_BYTES) return body;\n  // The marker is not a chat request, and `JournalBody` no longer claims it is\n  // — downstream consumers (e.g. GET /journal) treat the body as opaque JSON.\n  return {\n    __aimock_truncated: true,\n    originalByteSize: Buffer.byteLength(serialized, \"utf8\"),\n    note: \"body truncated by aimock journal cap (64 KB limit)\",\n  };\n}\n\n/**\n * Narrow a journaled body to a chat-completion request.\n *\n * `JournalEntry.body` is a union (see {@link JournalBody}): most entries hold a\n * chat request, but the fine-tuning create payload and this module's own\n * truncation marker do not. Anything reading `messages`, `model` or the rest of\n * the chat shape off a journal entry — inside aimock or in a consumer's test\n * — goes through here, so an entry that is not a chat request fails as a\n * `false` it can assert on rather than as an undefined property three accesses\n * later.\n *\n * `messages` is the discriminator because it is the one required field no\n * other journaled shape carries.\n */\nexport function isChatCompletionBody(\n  body: JournalBody | null | undefined,\n): body is ChatCompletionRequest {\n  return (\n    body !== null &&\n    body !== undefined &&\n    Array.isArray((body as { messages?: unknown }).messages) &&\n    typeof (body as { model?: unknown }).model === \"string\"\n  );\n}\n\n/**\n * Compare two field values, handling RegExp by source+flags rather than reference.\n */\nfunction fieldEqual(a: unknown, b: unknown): boolean {\n  if (a instanceof RegExp && b instanceof RegExp)\n    return a.source === b.source && a.flags === b.flags;\n  return a === b;\n}\n\n/**\n * Compare two systemMessage values. Handles string, string[], and RegExp.\n * Both-undefined is treated as equal.\n */\nfunction systemMessageEqual(\n  a: string | string[] | RegExp | undefined,\n  b: string | string[] | RegExp | undefined,\n): boolean {\n  if (a === undefined && b === undefined) return true;\n  if (a === undefined || b === undefined) return false;\n  if (typeof a === \"string\" && typeof b === \"string\") return a === b;\n  if (Array.isArray(a) && Array.isArray(b))\n    return a.length === b.length && a.every((v, i) => v === b[i]);\n  if (a instanceof RegExp && b instanceof RegExp)\n    return a.source === b.source && a.flags === b.flags;\n  return false;\n}\n\n/**\n * Check whether two fixture match objects have the same criteria\n * (ignoring sequenceIndex). Used to group sequenced fixtures.\n */\nfunction matchCriteriaEqual(a: FixtureMatch, b: FixtureMatch): boolean {\n  return (\n    fieldEqual(a.userMessage, b.userMessage) &&\n    systemMessageEqual(a.systemMessage, b.systemMessage) &&\n    fieldEqual(a.inputText, b.inputText) &&\n    fieldEqual(a.toolCallId, b.toolCallId) &&\n    fieldEqual(a.toolName, b.toolName) &&\n    fieldEqual(a.toolNamespace, b.toolNamespace) &&\n    fieldEqual(a.model, b.model) &&\n    fieldEqual(a.responseFormat, b.responseFormat) &&\n    fieldEqual(a.predicate, b.predicate) &&\n    fieldEqual(a.endpoint, b.endpoint) &&\n    fieldEqual(a.turnIndex, b.turnIndex) &&\n    fieldEqual(a.hasToolResult, b.hasToolResult) &&\n    fieldEqual(a.toolResultContains, b.toolResultContains) &&\n    fieldEqual(a.context, b.context)\n  );\n}\n\n/** Count-map keys resolve through `identity`, so every alias of a fixture finds its caller entry. */\nclass FixtureCountMap extends Map<Fixture, number> {\n  constructor(private readonly identity: (fixture: Fixture) => Fixture) {\n    super();\n  }\n\n  override get(key: Fixture): number | undefined {\n    return super.get(this.identity(key));\n  }\n\n  override has(key: Fixture): boolean {\n    return super.has(this.identity(key));\n  }\n\n  override set(key: Fixture, value: number): this {\n    return super.set(this.identity(key), value);\n  }\n\n  override delete(key: Fixture): boolean {\n    return super.delete(this.identity(key));\n  }\n}\n\nexport interface JournalOptions {\n  /**\n   * Maximum number of entries to retain. When exceeded, oldest entries are\n   * dropped FIFO. Set to 0 (or omit) for unbounded retention (the historical\n   * default — suitable for short-lived test runs only). Negative values are\n   * rejected at the CLI parse layer; programmatically they are treated as 0\n   * (unbounded) for back-compat.\n   *\n   * Long-running servers (e.g. mock proxies in CI/demo environments) should\n   * always set a finite cap: every request appends an entry holding the\n   * request body + headers + fixture reference, and without a cap the\n   * journal grows until the process OOMs.\n   */\n  maxEntries?: number;\n  /**\n   * Maximum number of unique testIds retained across fixture match-count\n   * and misbehavior counters. When exceeded, the oldest testId\n   * (by first-insertion order) is evicted FIFO. Set to 0 (or omit) for\n   * unbounded retention. Negative values are rejected at the CLI parse\n   * layer; programmatically they are treated as 0 (unbounded) for\n   * back-compat. Without a cap this map can grow over time in long-running\n   * servers that see many unique testIds.\n   */\n  fixtureCountsMaxTestIds?: number;\n  /**\n   * Called with every entry {@link Journal.add} creates, right after it is\n   * recorded. The hook exists so an embedder can attribute an entry to the\n   * request that produced it WITHOUT touching each of the ~100 `journal.add`\n   * call sites spread across the handler modules: the server binds the entry\n   * to the in-flight `IncomingMessage` here, and its error arm then amends\n   * that exact object rather than guessing from a caller-supplied header.\n   *\n   * The entry is already recorded when the hook runs, so a hook that throws\n   * does not lose the write — but it does propagate out of `add` into the\n   * caller's error path, so a hook must not throw.\n   */\n  onAdd?: (entry: JournalEntry) => void;\n}\n\nexport class Journal implements MisbehaviorCounters {\n  private entries: JournalEntry[] = [];\n  private readonly matchedFixtures = new WeakMap<JournalEntry, Fixture>();\n  /** The fixture a request was served from, where the entry names its caller fixture instead. */\n  private readonly servedFixtures = new WeakMap<JournalEntry, Fixture>();\n  private readonly fixtureMatchCountsByTestId: Map<string, Map<Fixture, number>> = new Map();\n  /** An extended server's view of a fixture to the caller's fixture (configureFixtureViewSource). */\n  private fixtureViewSource = (fixture: Fixture): Fixture => fixture;\n  private fixtureCountIdentity = (fixture: Fixture): Fixture => fixture;\n  /** The key a fixture is counted under: the caller's object behind any view or copy. */\n  private readonly fixtureCountKey = (fixture: Fixture): Fixture =>\n    this.fixtureCountIdentity(this.fixtureViewSource(fixture));\n  private createFixtureCountMap = (): Map<Fixture, number> => new Map();\n  private fixtureCountIdentityConfigured = false;\n  private fixtureViewSourceConfigured = false;\n  private readonly counterTestIds = new Set<string>();\n  private readonly misbehaviorCountersByTestId = new Map<\n    string,\n    Map<string, Map<number, { ordinal: number; firings: number }>>\n  >();\n  private readonly maxEntries: number;\n  private readonly fixtureCountsMaxTestIds: number;\n  private readonly onAdd?: (entry: JournalEntry) => void;\n\n  constructor(options: JournalOptions = {}) {\n    this.onAdd = options.onAdd;\n    // Treat 0 or negative as \"unbounded\" to preserve prior behavior when\n    // the option is omitted or explicitly disabled.\n    const cap = options.maxEntries;\n    this.maxEntries = cap !== undefined && cap > 0 ? cap : 0;\n    const testIdCap = options.fixtureCountsMaxTestIds;\n    this.fixtureCountsMaxTestIds = testIdCap !== undefined && testIdCap > 0 ? testIdCap : 0;\n  }\n\n  /**\n   * The per-test-id cap on fixture match-count maps, for an MCP mount to pass\n   * to `McpFakeStore.setMaxTestIds`. Always a non-negative safe integer, `0`\n   * meaning unbounded, and never throws, whatever option was passed:\n   * omitted, zero, negative or `NaN` is `0`; `Infinity` or a value above\n   * `Number.MAX_SAFE_INTEGER` (never reached) is `0`; a fraction of 1 or more\n   * is rounded down (`1.5` evicts at 2 ids, so it keeps 1). For these values\n   * it is the number of test ids the journal keeps.\n   *\n   * An option between 0 and 1 is the exception. The journal keeps no test id\n   * (each new count map is evicted as soon as it is made, so counts never\n   * advance), and a store cap cannot say \"keep none\" because `0` is\n   * unbounded. The getter returns `1`, the smallest bounded cap, so a store\n   * given it keeps 1 test id where the journal keeps 0.\n   */\n  get fixtureCountsMaxTestIdsCap(): number {\n    const cap = this.fixtureCountsMaxTestIds;\n    if (!(cap > 0) || cap > Number.MAX_SAFE_INTEGER) return 0;\n    return Math.max(1, Math.floor(cap));\n  }\n\n  /** Backwards-compatible accessor — returns the default (no testId) count map. */\n  get fixtureMatchCounts(): Map<Fixture, number> {\n    return this.getFixtureMatchCountsForTest(DEFAULT_TEST_ID);\n  }\n\n  /** @internal matchedFixture preserves identity when Live supplies safe diagnostics. */\n  add(entry: Omit<JournalEntry, \"id\" | \"timestamp\">, matchedFixture?: Fixture): JournalEntry {\n    const full: JournalEntry = {\n      id: generateId(\"req\"),\n      timestamp: Date.now(),\n      ...entry,\n      body: capBody(entry.body),\n    };\n    // A request is served from an extended server's view of a fixture, or\n    // from LLMock's per-addition copy with misbehavior enabled; the entry\n    // names the caller's fixture behind it, as in 1.44.0.\n    const fixture = full.response.fixture;\n    const source = fixture ? this.fixtureCountKey(fixture) : fixture;\n    if (fixture && source !== fixture) {\n      full.response = { ...full.response, fixture: source };\n      this.servedFixtures.set(full, fixture);\n    }\n    if (matchedFixture) this.matchedFixtures.set(full, this.fixtureCountKey(matchedFixture));\n    this.entries.push(full);\n    // FIFO eviction when over capacity. Array.prototype.shift() is O(n)\n    // regardless of how many we drop per add; we accept it at small caps\n    // (default 1000) because the constant factor is tiny and this runs once\n    // per request. For much larger caps, switch to a ring buffer for true\n    // O(1) eviction.\n    if (this.maxEntries > 0 && this.entries.length > this.maxEntries) {\n      this.entries.shift();\n    }\n    this.onAdd?.(full);\n    return full;\n  }\n\n  /**\n   * Return every entry, or with `limit` the most recent `limit` entries.\n   * `0` returns `[]` — exactly what `GET /__aimock/journal?limit=0` answers.\n   * `slice(-0)` is `slice(0)`, so a `0` used to return the ENTIRE journal; it\n   * is special-cased so the library and the HTTP route agree. This is a public\n   * library API, so odd limits are tolerated rather than thrown on: a\n   * non-finite limit (`NaN`, `Infinity`) means \"no limit\", a fractional limit\n   * floors, and any limit at or below `0` asks for nothing.\n   */\n  getAll(opts?: { limit?: number }): JournalEntry[] {\n    if (opts?.limit !== undefined && Number.isFinite(opts.limit)) {\n      const limit = Math.floor(opts.limit);\n      if (limit <= 0) return [];\n      return this.entries.slice(-limit);\n    }\n    return this.entries.slice();\n  }\n\n  getLast(): JournalEntry | null {\n    return this.entries.length > 0 ? this.entries[this.entries.length - 1] : null;\n  }\n\n  findByFixture(fixture: Fixture): JournalEntry[] {\n    const key = this.fixtureCountKey(fixture);\n    return this.entries.filter((e) => (this.matchedFixtures.get(e) ?? e.response.fixture) === key);\n  }\n\n  /**\n   * @internal The fixture `entry`'s request was served from: the extended\n   * view or the per-addition copy when the entry names the caller's fixture\n   * behind it, otherwise `entry.response.fixture`. The journal JSON shows it.\n   */\n  servedFixture(entry: JournalEntry): Fixture | null {\n    return this.servedFixtures.get(entry) ?? entry.response.fixture;\n  }\n\n  /**\n   * READ-ONLY accessor. Returns the existing count map for `testId`, or an\n   * empty transient Map if none exists. Does NOT insert into the cache and\n   * does NOT trigger FIFO eviction — callers may read freely without\n   * perturbing cache state. For the write path, see\n   * `getOrCreateFixtureMatchCountsForTest`.\n   */\n  getFixtureMatchCountsForTest(testId: string): Map<Fixture, number> {\n    return this.fixtureMatchCountsByTestId.get(testId) ?? this.createFixtureCountMap();\n  }\n\n  /**\n   * WRITE path: get the count map for `testId`, inserting a fresh empty Map\n   * if missing and running FIFO eviction when the testId cap is exceeded.\n   * Only callers that intend to mutate the map (e.g. incrementing a count)\n   * should use this.\n   */\n  private getOrCreateFixtureMatchCountsForTest(testId: string): Map<Fixture, number> {\n    let counts = this.fixtureMatchCountsByTestId.get(testId);\n    if (!counts) {\n      counts = this.createFixtureCountMap();\n      this.fixtureMatchCountsByTestId.set(testId, counts);\n      this.admitCounterTestId(testId);\n    }\n    return counts;\n  }\n\n  /** Match and fault mutations share one admission order and capacity. */\n  private admitCounterTestId(testId: string): void {\n    this.counterTestIds.add(testId);\n    if (\n      this.fixtureCountsMaxTestIds > 0 &&\n      this.counterTestIds.size > this.fixtureCountsMaxTestIds\n    ) {\n      const oldest = this.counterTestIds.values().next().value;\n      if (oldest !== undefined) {\n        this.counterTestIds.delete(oldest);\n        this.fixtureMatchCountsByTestId.delete(oldest);\n        this.misbehaviorCountersByTestId.delete(oldest);\n      }\n    }\n  }\n\n  private getOrCreateMisbehaviorCounter(key: MisbehaviorCounterKey) {\n    let sources = this.misbehaviorCountersByTestId.get(key.testId);\n    if (!sources) {\n      sources = new Map();\n      this.misbehaviorCountersByTestId.set(key.testId, sources);\n      this.admitCounterTestId(key.testId);\n    }\n    let entries = sources.get(key.sourceKey);\n    if (!entries) {\n      entries = new Map();\n      sources.set(key.sourceKey, entries);\n    }\n    let counter = entries.get(key.entryIndex);\n    if (!counter) {\n      counter = { ordinal: 0, firings: 0 };\n      entries.set(key.entryIndex, counter);\n    }\n    return counter;\n  }\n\n  getFiringCount(key: MisbehaviorCounterKey): number {\n    return (\n      this.misbehaviorCountersByTestId.get(key.testId)?.get(key.sourceKey)?.get(key.entryIndex)\n        ?.firings ?? 0\n    );\n  }\n\n  nextOrdinal(key: MisbehaviorCounterKey): number {\n    return this.getOrCreateMisbehaviorCounter(key).ordinal++;\n  }\n\n  recordFiring(key: MisbehaviorCounterKey): void {\n    this.getOrCreateMisbehaviorCounter(key).firings++;\n  }\n\n  clearMisbehaviorCounters(testId?: string): void {\n    if (testId !== undefined) {\n      this.misbehaviorCountersByTestId.delete(testId);\n      if (!this.fixtureMatchCountsByTestId.has(testId)) this.counterTestIds.delete(testId);\n    } else {\n      this.misbehaviorCountersByTestId.clear();\n      for (const id of this.counterTestIds) {\n        if (!this.fixtureMatchCountsByTestId.has(id)) this.counterTestIds.delete(id);\n      }\n    }\n  }\n\n  /** @internal LLMock configures caller count identity before serving requests. */\n  configureFixtureCountIdentity(identity: (fixture: Fixture) => Fixture): void {\n    if (this.fixtureCountIdentityConfigured || this.fixtureMatchCountsByTestId.size > 0) {\n      throw new Error(\"Fixture count identity must be configured once before counting\");\n    }\n    this.fixtureCountIdentity = identity;\n    this.createFixtureCountMap = () => new FixtureCountMap(this.fixtureCountKey);\n    this.fixtureCountIdentityConfigured = true;\n  }\n\n  /**\n   * @internal A server with `responsesTools: \"extended\"` matches each fixture\n   * through its extended view. `source` maps a view back to the caller's\n   * fixture, so counts, `findByFixture` and `JournalEntry.response.fixture`\n   * keep the caller's object. Configured once, before counting.\n   */\n  configureFixtureViewSource(source: (fixture: Fixture) => Fixture): void {\n    if (this.fixtureViewSourceConfigured || this.fixtureMatchCountsByTestId.size > 0) {\n      throw new Error(\"Fixture view source must be configured once before counting\");\n    }\n    this.fixtureViewSource = source;\n    this.createFixtureCountMap = () => new FixtureCountMap(this.fixtureCountKey);\n    this.fixtureViewSourceConfigured = true;\n  }\n\n  getFixtureMatchCount(fixture: Fixture, testId = DEFAULT_TEST_ID): number {\n    return this.getFixtureMatchCountsForTest(testId).get(fixture) ?? 0;\n  }\n\n  incrementFixtureMatchCount(\n    fixture: Fixture,\n    allFixtures?: readonly Fixture[],\n    testId = DEFAULT_TEST_ID,\n  ): void {\n    const counts = this.getOrCreateFixtureMatchCountsForTest(testId);\n    counts.set(fixture, (counts.get(fixture) ?? 0) + 1);\n    // When a sequenced fixture matches, also increment all siblings with matching criteria\n    if (fixture.match.sequenceIndex !== undefined && allFixtures) {\n      for (const sibling of allFixtures) {\n        if (this.fixtureCountKey(sibling) === this.fixtureCountKey(fixture)) continue;\n        if (sibling.match.sequenceIndex === undefined) continue;\n        if (matchCriteriaEqual(fixture.match, sibling.match)) {\n          counts.set(sibling, (counts.get(sibling) ?? 0) + 1);\n        }\n      }\n    }\n  }\n\n  clearMatchCounts(testId?: string): void {\n    if (testId !== undefined) {\n      this.fixtureMatchCountsByTestId.delete(testId);\n      this.clearMisbehaviorCounters(testId);\n    } else {\n      this.fixtureMatchCountsByTestId.clear();\n      this.clearMisbehaviorCounters();\n    }\n  }\n\n  /**\n   * Clear ONLY the request journal entries, preserving fixture match-counts.\n   * Match-counts are fixture-matching/sequencing state, not journal data, so\n   * clearing the journal must not silently rewind sequenced fixtures. Used by\n   * `POST /__aimock/reset/journal`. For a full reset (entries + match-counts),\n   * use `clear()` instead.\n   */\n  clearEntries(): void {\n    this.entries = [];\n  }\n\n  clear(): void {\n    this.entries = [];\n    this.clearMatchCounts();\n  }\n\n  get size(): number {\n    return this.entries.length;\n  }\n}\n"],"mappings":"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"}

package/dist/journal.d.cts

@@ -1,5 +1,5 @@
 import { DEFAULT_TEST_ID } from "./constants.cjs";
-import { ChatCompletionRequest, Fixture, JournalBody, JournalEntry } from "./types.cjs";
+import { ChatCompletionRequest, Fixture, JournalBody, JournalEntry, MisbehaviorCounterKey, MisbehaviorCounters } from "./types.cjs";
 
 //#region src/journal.d.ts
 
@@ -33,8 +33,8 @@ interface JournalOptions {
    */
   maxEntries?: number;
   /**
-   * Maximum number of unique testIds retained in the fixture match-count
-   * map (`fixtureMatchCountsByTestId`). When exceeded, the oldest testId
+   * Maximum number of unique testIds retained across fixture match-count
+   * and misbehavior counters. When exceeded, the oldest testId
    * (by first-insertion order) is evicted FIFO. Set to 0 (or omit) for
    * unbounded retention. Negative values are rejected at the CLI parse
    * layer; programmatically they are treated as 0 (unbounded) for
@@ -56,10 +56,22 @@ interface JournalOptions {
    */
   onAdd?: (entry: JournalEntry) => void;
 }
-declare class Journal {
+declare class Journal implements MisbehaviorCounters {
   private entries;
   private readonly matchedFixtures;
+  /** The fixture a request was served from, where the entry names its caller fixture instead. */
+  private readonly servedFixtures;
   private readonly fixtureMatchCountsByTestId;
+  /** An extended server's view of a fixture to the caller's fixture (configureFixtureViewSource). */
+  private fixtureViewSource;
+  private fixtureCountIdentity;
+  /** The key a fixture is counted under: the caller's object behind any view or copy. */
+  private readonly fixtureCountKey;
+  private createFixtureCountMap;
+  private fixtureCountIdentityConfigured;
+  private fixtureViewSourceConfigured;
+  private readonly counterTestIds;
+  private readonly misbehaviorCountersByTestId;
   private readonly maxEntries;
   private readonly fixtureCountsMaxTestIds;
   private readonly onAdd?;
@@ -98,6 +110,12 @@ declare class Journal {
   }): JournalEntry[];
   getLast(): JournalEntry | null;
   findByFixture(fixture: Fixture): JournalEntry[];
+  /**
+   * @internal The fixture `entry`'s request was served from: the extended
+   * view or the per-addition copy when the entry names the caller's fixture
+   * behind it, otherwise `entry.response.fixture`. The journal JSON shows it.
+   */
+  servedFixture(entry: JournalEntry): Fixture | null;
   /**
    * READ-ONLY accessor. Returns the existing count map for `testId`, or an
    * empty transient Map if none exists. Does NOT insert into the cache and
@@ -113,6 +131,22 @@ declare class Journal {
    * should use this.
    */
   private getOrCreateFixtureMatchCountsForTest;
+  /** Match and fault mutations share one admission order and capacity. */
+  private admitCounterTestId;
+  private getOrCreateMisbehaviorCounter;
+  getFiringCount(key: MisbehaviorCounterKey): number;
+  nextOrdinal(key: MisbehaviorCounterKey): number;
+  recordFiring(key: MisbehaviorCounterKey): void;
+  clearMisbehaviorCounters(testId?: string): void;
+  /** @internal LLMock configures caller count identity before serving requests. */
+  configureFixtureCountIdentity(identity: (fixture: Fixture) => Fixture): void;
+  /**
+   * @internal A server with `responsesTools: "extended"` matches each fixture
+   * through its extended view. `source` maps a view back to the caller's
+   * fixture, so counts, `findByFixture` and `JournalEntry.response.fixture`
+   * keep the caller's object. Configured once, before counting.
+   */
+  configureFixtureViewSource(source: (fixture: Fixture) => Fixture): void;
   getFixtureMatchCount(fixture: Fixture, testId?: string): number;
   incrementFixtureMatchCount(fixture: Fixture, allFixtures?: readonly Fixture[], testId?: string): void;
   clearMatchCounts(testId?: string): void;

package/dist/journal.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"journal.d.cts","names":[],"sources":["../src/journal.ts"],"sourcesContent":[],"mappings":";;;;;;;AA8DA;;;;;AA4DA;AAuCA;;;;;;AA6Ca,iBAhJG,oBAAA,CAgJH,IAAA,EA/IL,WA+IK,GAAA,IAAA,GAAA,SAAA,CAAA,EAAA,IAAA,IA9IF,qBA8IE;AAAyD,UApFrD,cAAA,CAoFqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAhDpD;;cAGL,OAAA;;;;;;;wBAQU;;;;;;;;;;;;;;;;;;4BAgCK,IAAI;;aAKnB,KAAK,oDAAoD,UAAU;;;;;;;;;;;;MA8B3C;aASxB;yBAIY,UAAU;;;;;;;;gDAaa,IAAI;;;;;;;;gCAgCpB;sCAKnB,gCACc"}
+{"version":3,"file":"journal.d.cts","names":[],"sources":["../src/journal.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgEA;;;;;AAoFA;AAuCA;;;;;;AA6Da,iBAxLG,oBAAA,CAwLH,IAAA,EAvLL,WAuLK,GAAA,IAAA,GAAA,SAAA,CAAA,EAAA,IAAA,IAtLF,qBAsLE;AAAyD,UApGrD,cAAA,CAoGqD;;;;;;;;;;;;;YA6JlB,CAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;kBA7NlC;;cAGL,OAAA,YAAmB;;;;;;;;;;;;;;;;;;;wBAwBT;;;;;;;;;;;;;;;;;;4BAgCK,IAAI;;aAKnB,KAAK,oDAAoD,UAAU;;;;;;;;;;;;MAuC3C;aASxB;yBAIY,UAAU;;;;;;uBAUZ,eAAe;;;;;;;;gDAWU,IAAI;;;;;;;;;;;sBAwD9B;mBAOH;oBAIC;;;oDAiBgC,YAAY;;;;;;;+CAejB,YAAY;gCAS3B;sCAKnB,gCACc"}

package/dist/journal.d.ts

@@ -1,5 +1,5 @@
 import { DEFAULT_TEST_ID } from "./constants.js";
-import { ChatCompletionRequest, Fixture, JournalBody, JournalEntry } from "./types.js";
+import { ChatCompletionRequest, Fixture, JournalBody, JournalEntry, MisbehaviorCounterKey, MisbehaviorCounters } from "./types.js";
 
 //#region src/journal.d.ts
 
@@ -33,8 +33,8 @@ interface JournalOptions {
    */
   maxEntries?: number;
   /**
-   * Maximum number of unique testIds retained in the fixture match-count
-   * map (`fixtureMatchCountsByTestId`). When exceeded, the oldest testId
+   * Maximum number of unique testIds retained across fixture match-count
+   * and misbehavior counters. When exceeded, the oldest testId
    * (by first-insertion order) is evicted FIFO. Set to 0 (or omit) for
    * unbounded retention. Negative values are rejected at the CLI parse
    * layer; programmatically they are treated as 0 (unbounded) for
@@ -56,10 +56,22 @@ interface JournalOptions {
    */
   onAdd?: (entry: JournalEntry) => void;
 }
-declare class Journal {
+declare class Journal implements MisbehaviorCounters {
   private entries;
   private readonly matchedFixtures;
+  /** The fixture a request was served from, where the entry names its caller fixture instead. */
+  private readonly servedFixtures;
   private readonly fixtureMatchCountsByTestId;
+  /** An extended server's view of a fixture to the caller's fixture (configureFixtureViewSource). */
+  private fixtureViewSource;
+  private fixtureCountIdentity;
+  /** The key a fixture is counted under: the caller's object behind any view or copy. */
+  private readonly fixtureCountKey;
+  private createFixtureCountMap;
+  private fixtureCountIdentityConfigured;
+  private fixtureViewSourceConfigured;
+  private readonly counterTestIds;
+  private readonly misbehaviorCountersByTestId;
   private readonly maxEntries;
   private readonly fixtureCountsMaxTestIds;
   private readonly onAdd?;
@@ -98,6 +110,12 @@ declare class Journal {
   }): JournalEntry[];
   getLast(): JournalEntry | null;
   findByFixture(fixture: Fixture): JournalEntry[];
+  /**
+   * @internal The fixture `entry`'s request was served from: the extended
+   * view or the per-addition copy when the entry names the caller's fixture
+   * behind it, otherwise `entry.response.fixture`. The journal JSON shows it.
+   */
+  servedFixture(entry: JournalEntry): Fixture | null;
   /**
    * READ-ONLY accessor. Returns the existing count map for `testId`, or an
    * empty transient Map if none exists. Does NOT insert into the cache and
@@ -113,6 +131,22 @@ declare class Journal {
    * should use this.
    */
   private getOrCreateFixtureMatchCountsForTest;
+  /** Match and fault mutations share one admission order and capacity. */
+  private admitCounterTestId;
+  private getOrCreateMisbehaviorCounter;
+  getFiringCount(key: MisbehaviorCounterKey): number;
+  nextOrdinal(key: MisbehaviorCounterKey): number;
+  recordFiring(key: MisbehaviorCounterKey): void;
+  clearMisbehaviorCounters(testId?: string): void;
+  /** @internal LLMock configures caller count identity before serving requests. */
+  configureFixtureCountIdentity(identity: (fixture: Fixture) => Fixture): void;
+  /**
+   * @internal A server with `responsesTools: "extended"` matches each fixture
+   * through its extended view. `source` maps a view back to the caller's
+   * fixture, so counts, `findByFixture` and `JournalEntry.response.fixture`
+   * keep the caller's object. Configured once, before counting.
+   */
+  configureFixtureViewSource(source: (fixture: Fixture) => Fixture): void;
   getFixtureMatchCount(fixture: Fixture, testId?: string): number;
   incrementFixtureMatchCount(fixture: Fixture, allFixtures?: readonly Fixture[], testId?: string): void;
   clearMatchCounts(testId?: string): void;

package/dist/journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal.d.ts","names":[],"sources":["../src/journal.ts"],"sourcesContent":[],"mappings":";;;;;;;AA8DA;;;;;AA4DA;AAuCA;;;;;;AA6Ca,iBAhJG,oBAAA,CAgJH,IAAA,EA/IL,WA+IK,GAAA,IAAA,GAAA,SAAA,CAAA,EAAA,IAAA,IA9IF,qBA8IE;AAAyD,UApFrD,cAAA,CAoFqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAhDpD;;cAGL,OAAA;;;;;;;wBAQU;;;;;;;;;;;;;;;;;;4BAgCK,IAAI;;aAKnB,KAAK,oDAAoD,UAAU;;;;;;;;;;;;MA8B3C;aASxB;yBAIY,UAAU;;;;;;;;gDAaa,IAAI;;;;;;;;gCAgCpB;sCAKnB,gCACc"}
+{"version":3,"file":"journal.d.ts","names":[],"sources":["../src/journal.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgEA;;;;;AAoFA;AAuCA;;;;;;AA6Da,iBAxLG,oBAAA,CAwLH,IAAA,EAvLL,WAuLK,GAAA,IAAA,GAAA,SAAA,CAAA,EAAA,IAAA,IAtLF,qBAsLE;AAAyD,UApGrD,cAAA,CAoGqD;;;;;;;;;;;;;YA6JlB,CAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;kBA7NlC;;cAGL,OAAA,YAAmB;;;;;;;;;;;;;;;;;;;wBAwBT;;;;;;;;;;;;;;;;;;4BAgCK,IAAI;;aAKnB,KAAK,oDAAoD,UAAU;;;;;;;;;;;;MAuC3C;aASxB;yBAIY,UAAU;;;;;;uBAUZ,eAAe;;;;;;;;gDAWU,IAAI;;;;;;;;;;;sBAwD9B;mBAOH;oBAIC;;;oDAiBgC,YAAY;;;;;;;+CAejB,YAAY;gCAS3B;sCAKnB,gCACc"}