@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/config-loader.d.cts

@@ -1,4 +1,4 @@
-import { ApiKeyAuthConfig, ChaosConfig, RecordConfig } from "./types.cjs";
+import { ApiKeyAuthConfig, ChaosConfig, McpRecordConfig, MisbehaviorConfig, MisbehaviorFaultId, RecordConfig, ResponsesToolsMode } from "./types.cjs";
 import { A2AAgentDefinition, A2AArtifact, A2APart, A2AStreamEvent } from "./a2a-types.cjs";
 import { AGUIEvent } from "./agui-types.cjs";
 import { LLMock } from "./llmock.cjs";
@@ -83,6 +83,11 @@ interface VectorConfig {
   path?: string;
   collections?: VectorConfigCollection[];
 }
+/** `llm.record` in a config file: the LLM `RecordConfig`, plus MCP record mounts (C10). */
+interface AimockRecordConfig extends RecordConfig {
+  /** MR1: mount path → upstream URL, or a full MCP record config. */
+  mcp?: Record<string, string | McpRecordConfig>;
+}
 interface AimockConfig {
   auth?: ApiKeyAuthConfig;
   llm?: {
@@ -92,7 +97,24 @@ interface AimockConfig {
     replaySpeed?: number;
     logLevel?: "silent" | "warn" | "info" | "debug";
     chaos?: ChaosConfig;
-    record?: RecordConfig;
+    /**
+     * Server-wide misbehavior defaults. Read only when misbehavior is enabled
+     * (`llm.enableMisbehavior: true` or `aimock --misbehavior`); otherwise the
+     * key is ignored with a warning, as 1.44.0 ignored it.
+     */
+    misbehavior?: MisbehaviorConfig | MisbehaviorFaultId;
+    /** See `MockServerOptions.enableMisbehavior`. */
+    enableMisbehavior?: boolean;
+    record?: AimockRecordConfig;
+    /**
+     * Turns on `llm.record.mcp`. Without it the key is ignored with a warning,
+     * as 1.44.0 ignored it.
+     */
+    enableMcpRecording?: boolean;
+    /** See `MockServerOptions.strictToolArguments`. */
+    strictToolArguments?: boolean;
+    /** See `MockServerOptions.responsesTools`. */
+    responsesTools?: ResponsesToolsMode;
   };
   mcp?: MCPConfig;
   a2a?: A2AConfig;
@@ -109,10 +131,21 @@ interface AimockConfig {
   host?: string;
 }
 declare function loadConfig(configPath: string): AimockConfig;
-declare function startFromConfig(config: AimockConfig, overrides?: {
+/**
+ * Command-line overrides for `startFromConfig`. The opt-in flags win over the
+ * matching `llm.*` config keys.
+ */
+interface StartFromConfigOverrides {
   port?: number;
   host?: string;
-}): Promise<{
+  /** `aimock --misbehavior`: overrides `llm.enableMisbehavior`. */
+  enableMisbehavior?: boolean;
+  /** `aimock --strict-tool-arguments`: overrides `llm.strictToolArguments`. */
+  strictToolArguments?: boolean;
+  /** `aimock --responses-tools`: overrides `llm.responsesTools`. */
+  responsesTools?: ResponsesToolsMode;
+}
+declare function startFromConfig(config: AimockConfig, overrides?: StartFromConfigOverrides): Promise<{
   llmock: LLMock;
   url: string;
 }>;

package/dist/config-loader.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.cts","names":[],"sources":["../src/config-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAgBiB,aAAA,SAAsB;;AAAvC;AAIiB,UAAA,iBAAA,CAAiB;EASjB,GAAA,EAAA,MAAA;EAAgB,IAAA,EAAA,MAAA;UAEnB,CAAA,EAAA,MAAA;aAF2B,CAAA,EAAA,MAAA;EAAmB,IAAA,CAAA,EAAA,MAAA;EAM3C,IAAA,CAAA,EAAA,MAAS;;AAGhB,UATO,eAAA,SAAwB,mBAS/B,CAAA;QACI,CAAA,EAAA;IACF,QAAA,EATE,KASF,CAAA;MAAe,IAAA,EAAA,MAAA;MAGV,OAAA,EAAA;QAAgB,IAAA,EAAA,MAAA;QAEvB,IAAA,EAAA,MAAA;MACI,CAAA;IACH,CAAA,CAAA;EAAc,CAAA;AAIzB;AAAgC,UAhBf,SAAA,CAgBe;MACnB,CAAA,EAAA,MAAA;YACH,CAAA,EAAA;IACS,IAAA,EAAA,MAAA;IAHqB,OAAA,EAAA,MAAA;EAAkB,CAAA;EAMzC,KAAA,CAAA,EAnBP,aAmBgB,EAAA;EAKT,SAAA,CAAA,EAvBH,iBAuBoB,EAAA;EAOjB,OAAA,CAAA,EA7BL,eA+BC,EAAA;AAGb;AAAuC,UA/BtB,gBAAA,CA+BsB;SAMxB,EAAA,MAAA;OAHH,CAAA,EAhCF,OAgCE,EAAA;WAKK,CAAA,EApCH,WAoCG,EAAA;EAAW,MAAA,CAAA,EAnCjB,cAmCiB,EAAA;EAGX,OAAA,CAAA,EAAA,MAAY;AAK7B;AAA6B,UAvCZ,cAAA,SAAuB,kBAuCX,CAAA;UACpB,CAAA,EAvCI,gBAuCJ,EAAA;OAOG,CAAA,EA7CF,gBA6CE,EAAA;gBACC,CAAA,EA7CM,gBA6CN,EAAA;;AAGL,UA7CS,SAAA,CA6CT;MACC,CAAA,EAAA,MAAA;QACE,CAAA,EA7CA,cA6CA,EAAA;;AAQK,UAlDC,iBAAA,CAkD+B;EAK1B,KAAA,EAAA;IAAe,OAAA,CAAA,EAAA,MAAA;IAC3B,UAAA,CAAA,EAAA,MAAA;IAEW,QAAA,CAAA,EAAA,MAAA;IAAlB,QAAA,CAAA,EAAA,MAAA;EAAO,CAAA;;WAvDC;;;UAIM,UAAA;;aAEJ;;UAGI,sBAAA;;;YAGL;;;eAGG;;iBAEE;;UAGA,YAAA;;gBAED;;UAGC,YAAA;SACR;;;;;;;YAOG;aACC;;QAEL;QACA;SACC;WACE;;;;;;;;;;;iBAQK,UAAA,sBAAgC;iBAK1B,eAAA,SACZ;;;IAEP;UAAkB"}
+{"version":3,"file":"config-loader.d.cts","names":[],"sources":["../src/config-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;UA4BiB,aAAA,SAAsB;;AAAvC;AAIiB,UAAA,iBAAA,CAAiB;EASjB,GAAA,EAAA,MAAA;EAAgB,IAAA,EAAA,MAAA;UAEnB,CAAA,EAAA,MAAA;aAF2B,CAAA,EAAA,MAAA;EAAmB,IAAA,CAAA,EAAA,MAAA;EAM3C,IAAA,CAAA,EAAA,MAAS;;AAGhB,UATO,eAAA,SAAwB,mBAS/B,CAAA;QACI,CAAA,EAAA;IACF,QAAA,EATE,KASF,CAAA;MAAe,IAAA,EAAA,MAAA;MAGV,OAAA,EAAA;QAAgB,IAAA,EAAA,MAAA;QAEvB,IAAA,EAAA,MAAA;MACI,CAAA;IACH,CAAA,CAAA;EAAc,CAAA;AAIzB;AAAgC,UAhBf,SAAA,CAgBe;MACnB,CAAA,EAAA,MAAA;YACH,CAAA,EAAA;IACS,IAAA,EAAA,MAAA;IAHqB,OAAA,EAAA,MAAA;EAAkB,CAAA;EAMzC,KAAA,CAAA,EAnBP,aAmBgB,EAAA;EAKT,SAAA,CAAA,EAvBH,iBAuBoB,EAAA;EAOjB,OAAA,CAAA,EA7BL,eA+BC,EAAA;AAGb;AAAuC,UA/BtB,gBAAA,CA+BsB;SAMxB,EAAA,MAAA;OAHH,CAAA,EAhCF,OAgCE,EAAA;WAKK,CAAA,EApCH,WAoCG,EAAA;EAAW,MAAA,CAAA,EAnCjB,cAmCiB,EAAA;EAGX,OAAA,CAAA,EAAA,MAAY;AAM7B;AAAoC,UAxCnB,cAAA,SAAuB,kBAwCJ,CAAA;UAEJ,CAAA,EAzCnB,gBAyCmB,EAAA;OAAxB,CAAA,EAxCE,gBAwCF,EAAA;gBAFoC,CAAA,EArCzB,gBAqCyB,EAAA;;AAK3B,UAvCA,SAAA,CAuCY;EAAA,IAAA,CAAA,EAAA,MAAA;QACpB,CAAA,EAtCE,cAsCF,EAAA;;AAaS,UAhDD,iBAAA,CAgDC;OAAoB,EAAA;IAGzB,OAAA,CAAA,EAAA,MAAA;IASQ,UAAA,CAAA,EAAA,MAAA;IAEb,QAAA,CAAA,EAAA,MAAA;IACA,QAAA,CAAA,EAAA,MAAA;;MAEG,CAAA,EAAA,MAAA;EAAY,MAAA,CAAA,EA9DZ,SA8DY,EAAA;EAgBP,OAAA,CAAA,EAAA,MAAU;AAgB1B;AAWsB,UArGL,UAAA,CAqGoB;EAAA,IAAA,CAAA,EAAA,MAAA;UAC3B,CAAA,EApGG,iBAoGH,EAAA;;AAEW,UAnGJ,sBAAA,CAmGI;MAAlB,EAAA,MAAA;EAAO,SAAA,EAAA,MAAA;YAhGE;;;eAGG;;iBAEE;;UAGA,YAAA;;gBAED;;;UAIC,kBAAA,SAA2B;;QAEpC,wBAAwB;;UAGf,YAAA;SACR;;;;;;;YAOG;;;;;;kBAMM,oBAAoB;;;aAGzB;;;;;;;;;qBASQ;;QAEb;QACA;SACC;WACE;;;;;;;;;;;iBAgBK,UAAA,sBAAgC;;;;;UAgB/B,wBAAA;;;;;;;;mBAQE;;iBAGG,eAAA,SACZ,0BACI,2BACX;UAAkB"}

package/dist/config-loader.d.ts

@@ -1,4 +1,4 @@
-import { ApiKeyAuthConfig, ChaosConfig, RecordConfig } from "./types.js";
+import { ApiKeyAuthConfig, ChaosConfig, McpRecordConfig, MisbehaviorConfig, MisbehaviorFaultId, RecordConfig, ResponsesToolsMode } from "./types.js";
 import { A2AAgentDefinition, A2AArtifact, A2APart, A2AStreamEvent } from "./a2a-types.js";
 import { AGUIEvent } from "./agui-types.js";
 import { LLMock } from "./llmock.js";
@@ -83,6 +83,11 @@ interface VectorConfig {
   path?: string;
   collections?: VectorConfigCollection[];
 }
+/** `llm.record` in a config file: the LLM `RecordConfig`, plus MCP record mounts (C10). */
+interface AimockRecordConfig extends RecordConfig {
+  /** MR1: mount path → upstream URL, or a full MCP record config. */
+  mcp?: Record<string, string | McpRecordConfig>;
+}
 interface AimockConfig {
   auth?: ApiKeyAuthConfig;
   llm?: {
@@ -92,7 +97,24 @@ interface AimockConfig {
     replaySpeed?: number;
     logLevel?: "silent" | "warn" | "info" | "debug";
     chaos?: ChaosConfig;
-    record?: RecordConfig;
+    /**
+     * Server-wide misbehavior defaults. Read only when misbehavior is enabled
+     * (`llm.enableMisbehavior: true` or `aimock --misbehavior`); otherwise the
+     * key is ignored with a warning, as 1.44.0 ignored it.
+     */
+    misbehavior?: MisbehaviorConfig | MisbehaviorFaultId;
+    /** See `MockServerOptions.enableMisbehavior`. */
+    enableMisbehavior?: boolean;
+    record?: AimockRecordConfig;
+    /**
+     * Turns on `llm.record.mcp`. Without it the key is ignored with a warning,
+     * as 1.44.0 ignored it.
+     */
+    enableMcpRecording?: boolean;
+    /** See `MockServerOptions.strictToolArguments`. */
+    strictToolArguments?: boolean;
+    /** See `MockServerOptions.responsesTools`. */
+    responsesTools?: ResponsesToolsMode;
   };
   mcp?: MCPConfig;
   a2a?: A2AConfig;
@@ -109,10 +131,21 @@ interface AimockConfig {
   host?: string;
 }
 declare function loadConfig(configPath: string): AimockConfig;
-declare function startFromConfig(config: AimockConfig, overrides?: {
+/**
+ * Command-line overrides for `startFromConfig`. The opt-in flags win over the
+ * matching `llm.*` config keys.
+ */
+interface StartFromConfigOverrides {
   port?: number;
   host?: string;
-}): Promise<{
+  /** `aimock --misbehavior`: overrides `llm.enableMisbehavior`. */
+  enableMisbehavior?: boolean;
+  /** `aimock --strict-tool-arguments`: overrides `llm.strictToolArguments`. */
+  strictToolArguments?: boolean;
+  /** `aimock --responses-tools`: overrides `llm.responsesTools`. */
+  responsesTools?: ResponsesToolsMode;
+}
+declare function startFromConfig(config: AimockConfig, overrides?: StartFromConfigOverrides): Promise<{
   llmock: LLMock;
   url: string;
 }>;

package/dist/config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.ts","names":[],"sources":["../src/config-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAgBiB,aAAA,SAAsB;;AAAvC;AAIiB,UAAA,iBAAA,CAAiB;EASjB,GAAA,EAAA,MAAA;EAAgB,IAAA,EAAA,MAAA;UAEnB,CAAA,EAAA,MAAA;aAF2B,CAAA,EAAA,MAAA;EAAmB,IAAA,CAAA,EAAA,MAAA;EAM3C,IAAA,CAAA,EAAA,MAAS;;AAGhB,UATO,eAAA,SAAwB,mBAS/B,CAAA;QACI,CAAA,EAAA;IACF,QAAA,EATE,KASF,CAAA;MAAe,IAAA,EAAA,MAAA;MAGV,OAAA,EAAA;QAAgB,IAAA,EAAA,MAAA;QAEvB,IAAA,EAAA,MAAA;MACI,CAAA;IACH,CAAA,CAAA;EAAc,CAAA;AAIzB;AAAgC,UAhBf,SAAA,CAgBe;MACnB,CAAA,EAAA,MAAA;YACH,CAAA,EAAA;IACS,IAAA,EAAA,MAAA;IAHqB,OAAA,EAAA,MAAA;EAAkB,CAAA;EAMzC,KAAA,CAAA,EAnBP,aAmBgB,EAEf;EAGM,SAAA,CAAA,EAvBH,iBAuBoB,EAGvB;EAIM,OAAA,CAAA,EA7BL,eA+BC,EAAA;AAGb;AAAuC,UA/BtB,gBAAA,CA+BsB;SAMxB,EAAA,MAAA;OAHH,CAAA,EAhCF,OAgCE,EAAA;WAKK,CAAA,EApCH,WAoCG,EAAA;EAAW,MAAA,CAAA,EAnCjB,cAmCiB,EAAA;EAGX,OAAA,CAAA,EAAA,MAAY;AAK7B;AAA6B,UAvCZ,cAAA,SAAuB,kBAuCX,CAAA;UACpB,CAAA,EAvCI,gBAuCJ,EAAA;OAOG,CAAA,EA7CF,gBA6CE,EAAA;gBACC,CAAA,EA7CM,gBA6CN,EAAA;;AAGL,UA7CS,SAAA,CA6CT;MACC,CAAA,EAAA,MAAA;QACE,CAAA,EA7CA,cA6CA,EAAA;;AAQK,UAlDC,iBAAA,CAkD+B;EAK1B,KAAA,EAAA;IAAe,OAAA,CAAA,EAAA,MAAA;IAC3B,UAAA,CAAA,EAAA,MAAA;IAEW,QAAA,CAAA,EAAA,MAAA;IAAlB,QAAA,CAAA,EAAA,MAAA;EAAO,CAAA;;WAvDC;;;UAIM,UAAA;;aAEJ;;UAGI,sBAAA;;;YAGL;;;eAGG;;iBAEE;;UAGA,YAAA;;gBAED;;UAGC,YAAA;SACR;;;;;;;YAOG;aACC;;QAEL;QACA;SACC;WACE;;;;;;;;;;;iBAQK,UAAA,sBAAgC;iBAK1B,eAAA,SACZ;;;IAEP;UAAkB"}
+{"version":3,"file":"config-loader.d.ts","names":[],"sources":["../src/config-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;UA4BiB,aAAA,SAAsB;;AAAvC;AAIiB,UAAA,iBAAA,CAAiB;EASjB,GAAA,EAAA,MAAA;EAAgB,IAAA,EAAA,MAAA;UAEnB,CAAA,EAAA,MAAA;aAF2B,CAAA,EAAA,MAAA;EAAmB,IAAA,CAAA,EAAA,MAAA;EAM3C,IAAA,CAAA,EAAA,MAAS;;AAGhB,UATO,eAAA,SAAwB,mBAS/B,CAAA;QACI,CAAA,EAAA;IACF,QAAA,EATE,KASF,CAAA;MAAe,IAAA,EAAA,MAAA;MAGV,OAAA,EAAA;QAAgB,IAAA,EAAA,MAAA;QAEvB,IAAA,EAAA,MAAA;MACI,CAAA;IACH,CAAA,CAAA;EAAc,CAAA;AAIzB;AAAgC,UAhBf,SAAA,CAgBe;MACnB,CAAA,EAAA,MAAA;YACH,CAAA,EAAA;IACS,IAAA,EAAA,MAAA;IAHqB,OAAA,EAAA,MAAA;EAAkB,CAAA;EAMzC,KAAA,CAAA,EAnBP,aAmBgB,EAEf;EAGM,SAAA,CAAA,EAvBH,iBAuBoB,EAGvB;EAIM,OAAA,CAAA,EA7BL,eA+BC,EAAA;AAGb;AAAuC,UA/BtB,gBAAA,CA+BsB;SAMxB,EAAA,MAAA;OAHH,CAAA,EAhCF,OAgCE,EAAA;WAKK,CAAA,EApCH,WAoCG,EAAA;EAAW,MAAA,CAAA,EAnCjB,cAmCiB,EAAA;EAGX,OAAA,CAAA,EAAA,MAAY;AAM7B;AAAoC,UAxCnB,cAAA,SAAuB,kBAwCJ,CAAA;UAEJ,CAAA,EAzCnB,gBAyCmB,EAAA;OAAxB,CAAA,EAxCE,gBAwCF,EAAA;gBAFoC,CAAA,EArCzB,gBAqCyB,EAAA;;AAK3B,UAvCA,SAAA,CAuCY;EAAA,IAAA,CAAA,EAAA,MAAA;QACpB,CAAA,EAtCE,cAsCF,EAAA;;AAaS,UAhDD,iBAAA,CAgDC;OAAoB,EAAA;IAGzB,OAAA,CAAA,EAAA,MAAA;IASQ,UAAA,CAAA,EAAA,MAAA;IAEb,QAAA,CAAA,EAAA,MAAA;IACA,QAAA,CAAA,EAAA,MAAA;;MAEG,CAAA,EAAA,MAAA;EAAY,MAAA,CAAA,EA9DZ,SA8DY,EAAA;EAgBP,OAAA,CAAA,EAAA,MAAU;AAgB1B;AAWsB,UArGL,UAAA,CAqGoB;EAAA,IAAA,CAAA,EAAA,MAAA;UAC3B,CAAA,EApGG,iBAoGH,EAAA;;AAEW,UAnGJ,sBAAA,CAmGI;MAAlB,EAAA,MAAA;EAAO,SAAA,EAAA,MAAA;YAhGE;;;eAGG;;iBAEE;;UAGA,YAAA;;gBAED;;;UAIC,kBAAA,SAA2B;;QAEpC,wBAAwB;;UAGf,YAAA;SACR;;;;;;;YAOG;;;;;;kBAMM,oBAAoB;;;aAGzB;;;;;;;;;qBASQ;;QAEb;QACA;SACC;WACE;;;;;;;;;;;iBAgBK,UAAA,sBAAgC;;;;;UAgB/B,wBAAA;;;;;;;;mBAQE;;iBAGG,eAAA,SACZ,0BACI,2BACX;UAAkB"}

package/dist/config-loader.js

@@ -1,21 +1,58 @@
 import { resolveInboundAuth, selectInboundAuthSource } from "./api-key-auth.js";
 import { A2AMock } from "./a2a-mock.js";
 import { buildTextResponse } from "./agui-handler.js";
+import { parseMisbehavior } from "./misbehavior.js";
 import { Logger } from "./logger.js";
 import { AGUIMock } from "./agui-mock.js";
-import { createLLMockWithResolvedAuth } from "./llmock.js";
+import { configToolHandlers } from "./mcp-handler.js";
+import { wireMcpRecording } from "./mcp-recorder.js";
 import { MCPMock } from "./mcp-mock.js";
+import { createLLMockWithResolvedAuth } from "./llmock.js";
 import { VectorMock } from "./vector-mock.js";
 import * as fs from "node:fs";
 import * as path from "node:path";
 
 //#region src/config-loader.ts
+/** C10: the LLM part of `llm.record`. `mcp` is MCP-only; no `providers` means no LLM recording. */
+function llmRecordOf(record) {
+	if (!record) return void 0;
+	const { mcp: _mcp, ...llm } = record;
+	return llm.providers === void 0 ? void 0 : llm;
+}
 function loadConfig(configPath) {
 	const raw = fs.readFileSync(configPath, "utf-8");
 	return JSON.parse(raw);
 }
+/** C3: `llm.record.mcp` is an object with at least one mount. */
+function hasMcpRecordMount(mcp) {
+	return typeof mcp === "object" && mcp !== null && !Array.isArray(mcp) && Object.keys(mcp).length > 0;
+}
 async function startFromConfig(config, overrides) {
 	const logger = new Logger("info");
+	const booleanOptIn = (key) => {
+		const value = config.llm?.[key];
+		if (value === void 0 || typeof value === "boolean") return value;
+		logger.warn(`Ignoring llm.${key} because it must be true or false, got ${JSON.stringify(value)}.`);
+	};
+	const configEnableMisbehavior = booleanOptIn("enableMisbehavior");
+	const configStrictToolArguments = booleanOptIn("strictToolArguments");
+	const enableMcpRecording = booleanOptIn("enableMcpRecording") === true;
+	const mcpRecord = enableMcpRecording ? config.llm?.record?.mcp : void 0;
+	const enableMisbehavior = (overrides?.enableMisbehavior ?? configEnableMisbehavior) === true;
+	let misbehavior;
+	if (config.llm?.misbehavior !== void 0) if (!enableMisbehavior) logger.warn("Ignoring llm.misbehavior because misbehavior is not enabled. Set llm.enableMisbehavior: true or pass --misbehavior to use it.");
+	else {
+		const parsed = parseMisbehavior(config.llm.misbehavior, "llm.misbehavior");
+		if (!parsed.ok) throw new TypeError(`${parsed.issue.rule}: ${parsed.issue.path}: ${parsed.issue.message}`);
+		misbehavior = parsed.config;
+	}
+	if (config.llm?.record?.mcp !== void 0 && !enableMcpRecording) logger.warn("Ignoring llm.record.mcp because MCP recording is not enabled. Set llm.enableMcpRecording: true to use it.");
+	let responsesTools = config.llm?.responsesTools;
+	if (responsesTools !== void 0 && responsesTools !== "legacy" && responsesTools !== "extended") {
+		const effective = overrides?.responsesTools !== void 0 ? `"${overrides.responsesTools}" from --responses-tools` : "\"legacy\"";
+		logger.warn(`Ignoring llm.responsesTools because it must be "legacy" or "extended", got ${JSON.stringify(responsesTools)}. Using ${effective}.`);
+		responsesTools = void 0;
+	}
 	let replaySpeed = config.llm?.replaySpeed;
 	if (replaySpeed != null && (!Number.isFinite(replaySpeed) || replaySpeed <= 0)) {
 		logger.warn(`llm.replaySpeed must be a positive number, got ${replaySpeed}. Ignoring.`);
@@ -28,12 +65,17 @@ async function startFromConfig(config, overrides) {
 		latency: config.llm?.latency,
 		chunkSize: config.llm?.chunkSize,
 		replaySpeed,
-		logLevel: config.llm?.logLevel,
+		logLevel: config.llm?.logLevel ?? (hasMcpRecordMount(mcpRecord) ? "warn" : void 0),
 		chaos: config.llm?.chaos,
-		record: config.llm?.record,
+		misbehavior,
+		...enableMisbehavior ? { enableMisbehavior: true } : {},
+		record: llmRecordOf(config.llm?.record),
 		metrics: config.metrics,
-		strict: config.strict
+		strict: config.strict,
+		strictToolArguments: overrides?.strictToolArguments ?? configStrictToolArguments,
+		responsesTools: overrides?.responsesTools ?? responsesTools
 	}, resolvedAuth);
+	const configMounts = /* @__PURE__ */ new Map();
 	if (config.llm?.fixtures) {
 		const fixturePath = path.resolve(config.llm.fixtures);
 		if (fs.statSync(fixturePath).isDirectory()) llmock.loadFixtureDir(fixturePath);
@@ -45,7 +87,11 @@ async function startFromConfig(config, overrides) {
 		if (mcpConfig.tools) for (const tool of mcpConfig.tools) {
 			const { result, ...def } = tool;
 			mcp.addTool(def);
-			if (result !== void 0) mcp.onToolCall(def.name, () => result);
+			if (result !== void 0) {
+				const answer = () => result;
+				configToolHandlers.add(answer);
+				mcp.onToolCall(def.name, answer);
+			}
 		}
 		if (mcpConfig.resources) for (const res of mcpConfig.resources) mcp.addResource({
 			uri: res.uri,
@@ -64,6 +110,7 @@ async function startFromConfig(config, overrides) {
 		}
 		const mcpPath = mcpConfig.path ?? "/mcp";
 		llmock.mount(mcpPath, mcp);
+		configMounts.set(mcpPath, mcp);
 		logger.info(`MCPMock mounted at ${mcpPath}`);
 	}
 	if (config.a2a) {
@@ -78,6 +125,7 @@ async function startFromConfig(config, overrides) {
 		}
 		const a2aPath = a2aConfig.path ?? "/a2a";
 		llmock.mount(a2aPath, a2a);
+		configMounts.set(a2aPath, a2a);
 		logger.info(`A2AMock mounted at ${a2aPath}`);
 	}
 	if (config.agui) {
@@ -109,6 +157,7 @@ async function startFromConfig(config, overrides) {
 		}
 		const aguiPath = aguiConfig.path ?? "/agui";
 		llmock.mount(aguiPath, agui);
+		configMounts.set(aguiPath, agui);
 		logger.info(`AGUIMock mounted at ${aguiPath}`);
 	}
 	if (config.vector) {
@@ -121,8 +170,17 @@ async function startFromConfig(config, overrides) {
 		}
 		const vectorPath = vectorConfig.path ?? "/vector";
 		llmock.mount(vectorPath, vector);
+		configMounts.set(vectorPath, vector);
 		logger.info(`VectorMock mounted at ${vectorPath}`);
 	}
+	if (mcpRecord !== void 0) wireMcpRecording(llmock, mcpRecord, {
+		mounted: configMounts,
+		mcpMock: MCPMock,
+		fixtures: config.llm?.fixtures,
+		fixturePath: config.llm?.record?.fixturePath,
+		strict: config.strict,
+		env: process.env
+	});
 	if (config.services) {
 		if (config.services.search) {
 			llmock.onSearch(/.*/, []);

package/dist/config-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.js","names":[],"sources":["../src/config-loader.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { LLMock, createLLMockWithResolvedAuth } from \"./llmock.js\";\nimport { resolveInboundAuth, selectInboundAuthSource } from \"./api-key-auth.js\";\nimport { MCPMock } from \"./mcp-mock.js\";\nimport { A2AMock } from \"./a2a-mock.js\";\nimport { AGUIMock } from \"./agui-mock.js\";\nimport type { ApiKeyAuthConfig, ChaosConfig, RecordConfig } from \"./types.js\";\nimport type { MCPToolDefinition, MCPPromptDefinition } from \"./mcp-types.js\";\nimport type { A2AAgentDefinition, A2APart, A2AArtifact, A2AStreamEvent } from \"./a2a-types.js\";\nimport type { AGUIEvent } from \"./agui-types.js\";\nimport { buildTextResponse } from \"./agui-handler.js\";\nimport { VectorMock } from \"./vector-mock.js\";\nimport type { QueryResult } from \"./vector-types.js\";\nimport { Logger } from \"./logger.js\";\n\nexport interface MCPConfigTool extends MCPToolDefinition {\n  result?: string;\n}\n\nexport interface MCPConfigResource {\n  uri: string;\n  name: string;\n  mimeType?: string;\n  description?: string;\n  text?: string;\n  blob?: string;\n}\n\nexport interface MCPConfigPrompt extends MCPPromptDefinition {\n  result?: {\n    messages: Array<{ role: string; content: { type: string; text: string } }>;\n  };\n}\n\nexport interface MCPConfig {\n  path?: string;\n  serverInfo?: { name: string; version: string };\n  tools?: MCPConfigTool[];\n  resources?: MCPConfigResource[];\n  prompts?: MCPConfigPrompt[];\n}\n\nexport interface A2AConfigPattern {\n  pattern: string;\n  parts?: A2APart[];\n  artifacts?: A2AArtifact[];\n  events?: A2AStreamEvent[];\n  delayMs?: number;\n}\n\nexport interface A2AConfigAgent extends A2AAgentDefinition {\n  messages?: A2AConfigPattern[];\n  tasks?: A2AConfigPattern[];\n  streamingTasks?: A2AConfigPattern[];\n}\n\nexport interface A2AConfig {\n  path?: string;\n  agents?: A2AConfigAgent[];\n}\n\nexport interface AGUIConfigFixture {\n  match: { message?: string; toolCallId?: string; toolName?: string; stateKey?: string };\n  text?: string; // shorthand: uses buildTextResponse\n  events?: AGUIEvent[]; // raw events\n  delayMs?: number;\n}\n\nexport interface AGUIConfig {\n  path?: string; // mount path, default \"/agui\"\n  fixtures?: AGUIConfigFixture[];\n}\n\nexport interface VectorConfigCollection {\n  name: string;\n  dimension: number;\n  vectors?: Array<{\n    id: string;\n    values: number[];\n    metadata?: Record<string, unknown>;\n  }>;\n  queryResults?: QueryResult[];\n}\n\nexport interface VectorConfig {\n  path?: string;\n  collections?: VectorConfigCollection[];\n}\n\nexport interface AimockConfig {\n  auth?: ApiKeyAuthConfig;\n  llm?: {\n    fixtures?: string;\n    latency?: number;\n    chunkSize?: number;\n    replaySpeed?: number;\n    logLevel?: \"silent\" | \"warn\" | \"info\" | \"debug\";\n    chaos?: ChaosConfig;\n    record?: RecordConfig;\n  };\n  mcp?: MCPConfig;\n  a2a?: A2AConfig;\n  agui?: AGUIConfig;\n  vector?: VectorConfig;\n  services?: { search?: boolean; rerank?: boolean; moderate?: boolean };\n  metrics?: boolean;\n  strict?: boolean;\n  port?: number;\n  host?: string;\n}\n\nexport function loadConfig(configPath: string): AimockConfig {\n  const raw = fs.readFileSync(configPath, \"utf-8\");\n  return JSON.parse(raw) as AimockConfig;\n}\n\nexport async function startFromConfig(\n  config: AimockConfig,\n  overrides?: { port?: number; host?: string },\n): Promise<{ llmock: LLMock; url: string }> {\n  const logger = new Logger(\"info\");\n\n  // A non-positive replaySpeed fails calculateDelay's `speed > 0` check and applies the\n  // full delay rather than none. Mirrors the fixture-level guard in fixture-loader.ts.\n  let replaySpeed = config.llm?.replaySpeed;\n  if (replaySpeed != null && (!Number.isFinite(replaySpeed) || replaySpeed <= 0)) {\n    logger.warn(`llm.replaySpeed must be a positive number, got ${replaySpeed}. Ignoring.`);\n    replaySpeed = undefined;\n  }\n\n  // Load fixtures if specified\n  const resolvedAuth = resolveInboundAuth(selectInboundAuthSource(config.auth));\n  const llmock = createLLMockWithResolvedAuth(\n    {\n      port: overrides?.port ?? config.port ?? 0,\n      host: overrides?.host ?? config.host ?? \"127.0.0.1\",\n      latency: config.llm?.latency,\n      chunkSize: config.llm?.chunkSize,\n      replaySpeed,\n      logLevel: config.llm?.logLevel,\n      chaos: config.llm?.chaos,\n      record: config.llm?.record,\n      metrics: config.metrics,\n      strict: config.strict,\n    },\n    resolvedAuth,\n  );\n\n  if (config.llm?.fixtures) {\n    const fixturePath = path.resolve(config.llm.fixtures);\n    const stat = fs.statSync(fixturePath);\n    if (stat.isDirectory()) {\n      llmock.loadFixtureDir(fixturePath);\n    } else {\n      llmock.loadFixtureFile(fixturePath);\n    }\n  }\n\n  // MCP\n  if (config.mcp) {\n    const mcpConfig = config.mcp;\n    const mcp = new MCPMock({\n      serverInfo: mcpConfig.serverInfo,\n    });\n\n    if (mcpConfig.tools) {\n      for (const tool of mcpConfig.tools) {\n        const { result, ...def } = tool;\n        mcp.addTool(def);\n        if (result !== undefined) {\n          mcp.onToolCall(def.name, () => result);\n        }\n      }\n    }\n\n    if (mcpConfig.resources) {\n      for (const res of mcpConfig.resources) {\n        mcp.addResource(\n          { uri: res.uri, name: res.name, mimeType: res.mimeType, description: res.description },\n          res.text !== undefined || res.blob !== undefined\n            ? { text: res.text, blob: res.blob, mimeType: res.mimeType }\n            : undefined,\n        );\n      }\n    }\n\n    if (mcpConfig.prompts) {\n      for (const prompt of mcpConfig.prompts) {\n        const { result, ...def } = prompt;\n        if (result) {\n          mcp.addPrompt(def, () => result as import(\"./mcp-types.js\").MCPPromptResult);\n        } else {\n          mcp.addPrompt(def);\n        }\n      }\n    }\n\n    const mcpPath = mcpConfig.path ?? \"/mcp\";\n    llmock.mount(mcpPath, mcp);\n    logger.info(`MCPMock mounted at ${mcpPath}`);\n  }\n\n  // A2A\n  if (config.a2a) {\n    const a2aConfig = config.a2a;\n    const a2a = new A2AMock();\n\n    if (a2aConfig.agents) {\n      for (const agentConfig of a2aConfig.agents) {\n        const { messages, tasks, streamingTasks, ...def } = agentConfig;\n        a2a.registerAgent(def);\n\n        if (messages) {\n          for (const m of messages) {\n            a2a.onMessage(def.name, m.pattern, m.parts ?? [{ text: \"\" }]);\n          }\n        }\n\n        if (tasks) {\n          for (const t of tasks) {\n            a2a.onTask(def.name, t.pattern, t.artifacts ?? []);\n          }\n        }\n\n        if (streamingTasks) {\n          for (const s of streamingTasks) {\n            a2a.onStreamingTask(def.name, s.pattern, s.events ?? [], s.delayMs);\n          }\n        }\n      }\n    }\n\n    const a2aPath = a2aConfig.path ?? \"/a2a\";\n    llmock.mount(a2aPath, a2a);\n    logger.info(`A2AMock mounted at ${a2aPath}`);\n  }\n\n  // AG-UI\n  if (config.agui) {\n    const aguiConfig = config.agui;\n    const agui = new AGUIMock();\n\n    if (aguiConfig.fixtures) {\n      for (const f of aguiConfig.fixtures) {\n        if (f.match.toolCallId && f.text && !f.events) {\n          logger.warn(\n            `AG-UI fixture uses text shorthand with toolCallId — text shorthand ignores toolCallId matching; use events[] instead (match: ${JSON.stringify(f.match)})`,\n          );\n        }\n        if (f.text) {\n          if (f.match.message !== undefined) {\n            agui.onMessage(f.match.message, f.text, { delayMs: f.delayMs });\n          } else {\n            // No message pattern — register via addFixture so it only matches\n            // on other criteria (toolCallId, toolName, stateKey) instead of\n            // becoming a catch-all that matches every request.\n            agui.addFixture({\n              match: {\n                toolCallId: f.match.toolCallId,\n                toolName: f.match.toolName,\n                stateKey: f.match.stateKey,\n              },\n              events: buildTextResponse(f.text),\n              delayMs: f.delayMs,\n            });\n          }\n        } else if (f.events) {\n          agui.addFixture({\n            match: {\n              message: f.match.message,\n              toolCallId: f.match.toolCallId,\n              toolName: f.match.toolName,\n              stateKey: f.match.stateKey,\n            },\n            events: f.events,\n            delayMs: f.delayMs,\n          });\n        } else {\n          logger.warn(\n            `AG-UI fixture has neither text nor events — it will be skipped (match: ${JSON.stringify(f.match)})`,\n          );\n        }\n      }\n    }\n\n    const aguiPath = aguiConfig.path ?? \"/agui\";\n    llmock.mount(aguiPath, agui);\n    logger.info(`AGUIMock mounted at ${aguiPath}`);\n  }\n\n  // Vector\n  if (config.vector) {\n    const vectorConfig = config.vector;\n    const vector = new VectorMock();\n\n    if (vectorConfig.collections) {\n      for (const col of vectorConfig.collections) {\n        vector.addCollection(col.name, { dimension: col.dimension });\n\n        if (col.vectors && col.vectors.length > 0) {\n          vector.upsert(col.name, col.vectors);\n        }\n\n        if (col.queryResults) {\n          vector.onQuery(col.name, col.queryResults);\n        }\n      }\n    }\n\n    const vectorPath = vectorConfig.path ?? \"/vector\";\n    llmock.mount(vectorPath, vector);\n    logger.info(`VectorMock mounted at ${vectorPath}`);\n  }\n\n  // Services — configure default catch-all responses\n  if (config.services) {\n    if (config.services.search) {\n      llmock.onSearch(/.*/, []);\n      logger.info(\"Search service enabled with default empty results\");\n    }\n    if (config.services.rerank) {\n      llmock.onRerank(/.*/, []);\n      logger.info(\"Rerank service enabled with default empty results\");\n    }\n    if (config.services.moderate) {\n      llmock.onModerate(/.*/, { flagged: false, categories: {} });\n      logger.info(\"Moderation service enabled with default unflagged results\");\n    }\n  }\n\n  const url = await llmock.start();\n  return { llmock, url };\n}\n"],"mappings":";;;;;;;;;;;;AAgHA,SAAgB,WAAW,YAAkC;CAC3D,MAAM,MAAM,GAAG,aAAa,YAAY,QAAQ;AAChD,QAAO,KAAK,MAAM,IAAI;;AAGxB,eAAsB,gBACpB,QACA,WAC0C;CAC1C,MAAM,SAAS,IAAI,OAAO,OAAO;CAIjC,IAAI,cAAc,OAAO,KAAK;AAC9B,KAAI,eAAe,SAAS,CAAC,OAAO,SAAS,YAAY,IAAI,eAAe,IAAI;AAC9E,SAAO,KAAK,kDAAkD,YAAY,aAAa;AACvF,gBAAc;;CAIhB,MAAM,eAAe,mBAAmB,wBAAwB,OAAO,KAAK,CAAC;CAC7E,MAAM,SAAS,6BACb;EACE,MAAM,WAAW,QAAQ,OAAO,QAAQ;EACxC,MAAM,WAAW,QAAQ,OAAO,QAAQ;EACxC,SAAS,OAAO,KAAK;EACrB,WAAW,OAAO,KAAK;EACvB;EACA,UAAU,OAAO,KAAK;EACtB,OAAO,OAAO,KAAK;EACnB,QAAQ,OAAO,KAAK;EACpB,SAAS,OAAO;EAChB,QAAQ,OAAO;EAChB,EACD,aACD;AAED,KAAI,OAAO,KAAK,UAAU;EACxB,MAAM,cAAc,KAAK,QAAQ,OAAO,IAAI,SAAS;AAErD,MADa,GAAG,SAAS,YAAY,CAC5B,aAAa,CACpB,QAAO,eAAe,YAAY;MAElC,QAAO,gBAAgB,YAAY;;AAKvC,KAAI,OAAO,KAAK;EACd,MAAM,YAAY,OAAO;EACzB,MAAM,MAAM,IAAI,QAAQ,EACtB,YAAY,UAAU,YACvB,CAAC;AAEF,MAAI,UAAU,MACZ,MAAK,MAAM,QAAQ,UAAU,OAAO;GAClC,MAAM,EAAE,QAAQ,GAAG,QAAQ;AAC3B,OAAI,QAAQ,IAAI;AAChB,OAAI,WAAW,OACb,KAAI,WAAW,IAAI,YAAY,OAAO;;AAK5C,MAAI,UAAU,UACZ,MAAK,MAAM,OAAO,UAAU,UAC1B,KAAI,YACF;GAAE,KAAK,IAAI;GAAK,MAAM,IAAI;GAAM,UAAU,IAAI;GAAU,aAAa,IAAI;GAAa,EACtF,IAAI,SAAS,UAAa,IAAI,SAAS,SACnC;GAAE,MAAM,IAAI;GAAM,MAAM,IAAI;GAAM,UAAU,IAAI;GAAU,GAC1D,OACL;AAIL,MAAI,UAAU,QACZ,MAAK,MAAM,UAAU,UAAU,SAAS;GACtC,MAAM,EAAE,QAAQ,GAAG,QAAQ;AAC3B,OAAI,OACF,KAAI,UAAU,WAAW,OAAmD;OAE5E,KAAI,UAAU,IAAI;;EAKxB,MAAM,UAAU,UAAU,QAAQ;AAClC,SAAO,MAAM,SAAS,IAAI;AAC1B,SAAO,KAAK,sBAAsB,UAAU;;AAI9C,KAAI,OAAO,KAAK;EACd,MAAM,YAAY,OAAO;EACzB,MAAM,MAAM,IAAI,SAAS;AAEzB,MAAI,UAAU,OACZ,MAAK,MAAM,eAAe,UAAU,QAAQ;GAC1C,MAAM,EAAE,UAAU,OAAO,gBAAgB,GAAG,QAAQ;AACpD,OAAI,cAAc,IAAI;AAEtB,OAAI,SACF,MAAK,MAAM,KAAK,SACd,KAAI,UAAU,IAAI,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;AAIjE,OAAI,MACF,MAAK,MAAM,KAAK,MACd,KAAI,OAAO,IAAI,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAItD,OAAI,eACF,MAAK,MAAM,KAAK,eACd,KAAI,gBAAgB,IAAI,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ;;EAM3E,MAAM,UAAU,UAAU,QAAQ;AAClC,SAAO,MAAM,SAAS,IAAI;AAC1B,SAAO,KAAK,sBAAsB,UAAU;;AAI9C,KAAI,OAAO,MAAM;EACf,MAAM,aAAa,OAAO;EAC1B,MAAM,OAAO,IAAI,UAAU;AAE3B,MAAI,WAAW,SACb,MAAK,MAAM,KAAK,WAAW,UAAU;AACnC,OAAI,EAAE,MAAM,cAAc,EAAE,QAAQ,CAAC,EAAE,OACrC,QAAO,KACL,gIAAgI,KAAK,UAAU,EAAE,MAAM,CAAC,GACzJ;AAEH,OAAI,EAAE,KACJ,KAAI,EAAE,MAAM,YAAY,OACtB,MAAK,UAAU,EAAE,MAAM,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;OAK/D,MAAK,WAAW;IACd,OAAO;KACL,YAAY,EAAE,MAAM;KACpB,UAAU,EAAE,MAAM;KAClB,UAAU,EAAE,MAAM;KACnB;IACD,QAAQ,kBAAkB,EAAE,KAAK;IACjC,SAAS,EAAE;IACZ,CAAC;YAEK,EAAE,OACX,MAAK,WAAW;IACd,OAAO;KACL,SAAS,EAAE,MAAM;KACjB,YAAY,EAAE,MAAM;KACpB,UAAU,EAAE,MAAM;KAClB,UAAU,EAAE,MAAM;KACnB;IACD,QAAQ,EAAE;IACV,SAAS,EAAE;IACZ,CAAC;OAEF,QAAO,KACL,0EAA0E,KAAK,UAAU,EAAE,MAAM,CAAC,GACnG;;EAKP,MAAM,WAAW,WAAW,QAAQ;AACpC,SAAO,MAAM,UAAU,KAAK;AAC5B,SAAO,KAAK,uBAAuB,WAAW;;AAIhD,KAAI,OAAO,QAAQ;EACjB,MAAM,eAAe,OAAO;EAC5B,MAAM,SAAS,IAAI,YAAY;AAE/B,MAAI,aAAa,YACf,MAAK,MAAM,OAAO,aAAa,aAAa;AAC1C,UAAO,cAAc,IAAI,MAAM,EAAE,WAAW,IAAI,WAAW,CAAC;AAE5D,OAAI,IAAI,WAAW,IAAI,QAAQ,SAAS,EACtC,QAAO,OAAO,IAAI,MAAM,IAAI,QAAQ;AAGtC,OAAI,IAAI,aACN,QAAO,QAAQ,IAAI,MAAM,IAAI,aAAa;;EAKhD,MAAM,aAAa,aAAa,QAAQ;AACxC,SAAO,MAAM,YAAY,OAAO;AAChC,SAAO,KAAK,yBAAyB,aAAa;;AAIpD,KAAI,OAAO,UAAU;AACnB,MAAI,OAAO,SAAS,QAAQ;AAC1B,UAAO,SAAS,MAAM,EAAE,CAAC;AACzB,UAAO,KAAK,oDAAoD;;AAElE,MAAI,OAAO,SAAS,QAAQ;AAC1B,UAAO,SAAS,MAAM,EAAE,CAAC;AACzB,UAAO,KAAK,oDAAoD;;AAElE,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAO,WAAW,MAAM;IAAE,SAAS;IAAO,YAAY,EAAE;IAAE,CAAC;AAC3D,UAAO,KAAK,4DAA4D;;;AAK5E,QAAO;EAAE;EAAQ,KADL,MAAM,OAAO,OAAO;EACV"}
+{"version":3,"file":"config-loader.js","names":[],"sources":["../src/config-loader.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { LLMock, createLLMockWithResolvedAuth } from \"./llmock.js\";\nimport { resolveInboundAuth, selectInboundAuthSource } from \"./api-key-auth.js\";\nimport { MCPMock } from \"./mcp-mock.js\";\nimport { configToolHandlers } from \"./mcp-handler.js\";\nimport { A2AMock } from \"./a2a-mock.js\";\nimport { AGUIMock } from \"./agui-mock.js\";\nimport type {\n  ApiKeyAuthConfig,\n  ChaosConfig,\n  McpRecordConfig,\n  MisbehaviorConfig,\n  MisbehaviorFaultId,\n  Mountable,\n  RecordConfig,\n  ResponsesToolsMode,\n} from \"./types.js\";\nimport { parseMisbehavior } from \"./misbehavior.js\";\nimport type { MCPToolDefinition, MCPPromptDefinition } from \"./mcp-types.js\";\nimport type { A2AAgentDefinition, A2APart, A2AArtifact, A2AStreamEvent } from \"./a2a-types.js\";\nimport type { AGUIEvent } from \"./agui-types.js\";\nimport { buildTextResponse } from \"./agui-handler.js\";\nimport { VectorMock } from \"./vector-mock.js\";\nimport type { QueryResult } from \"./vector-types.js\";\nimport { Logger } from \"./logger.js\";\nimport { wireMcpRecording } from \"./mcp-recorder.js\";\n\nexport interface MCPConfigTool extends MCPToolDefinition {\n  result?: string;\n}\n\nexport interface MCPConfigResource {\n  uri: string;\n  name: string;\n  mimeType?: string;\n  description?: string;\n  text?: string;\n  blob?: string;\n}\n\nexport interface MCPConfigPrompt extends MCPPromptDefinition {\n  result?: {\n    messages: Array<{ role: string; content: { type: string; text: string } }>;\n  };\n}\n\nexport interface MCPConfig {\n  path?: string;\n  serverInfo?: { name: string; version: string };\n  tools?: MCPConfigTool[];\n  resources?: MCPConfigResource[];\n  prompts?: MCPConfigPrompt[];\n}\n\nexport interface A2AConfigPattern {\n  pattern: string;\n  parts?: A2APart[];\n  artifacts?: A2AArtifact[];\n  events?: A2AStreamEvent[];\n  delayMs?: number;\n}\n\nexport interface A2AConfigAgent extends A2AAgentDefinition {\n  messages?: A2AConfigPattern[];\n  tasks?: A2AConfigPattern[];\n  streamingTasks?: A2AConfigPattern[];\n}\n\nexport interface A2AConfig {\n  path?: string;\n  agents?: A2AConfigAgent[];\n}\n\nexport interface AGUIConfigFixture {\n  match: { message?: string; toolCallId?: string; toolName?: string; stateKey?: string };\n  text?: string; // shorthand: uses buildTextResponse\n  events?: AGUIEvent[]; // raw events\n  delayMs?: number;\n}\n\nexport interface AGUIConfig {\n  path?: string; // mount path, default \"/agui\"\n  fixtures?: AGUIConfigFixture[];\n}\n\nexport interface VectorConfigCollection {\n  name: string;\n  dimension: number;\n  vectors?: Array<{\n    id: string;\n    values: number[];\n    metadata?: Record<string, unknown>;\n  }>;\n  queryResults?: QueryResult[];\n}\n\nexport interface VectorConfig {\n  path?: string;\n  collections?: VectorConfigCollection[];\n}\n\n/** `llm.record` in a config file: the LLM `RecordConfig`, plus MCP record mounts (C10). */\nexport interface AimockRecordConfig extends RecordConfig {\n  /** MR1: mount path → upstream URL, or a full MCP record config. */\n  mcp?: Record<string, string | McpRecordConfig>;\n}\n\nexport interface AimockConfig {\n  auth?: ApiKeyAuthConfig;\n  llm?: {\n    fixtures?: string;\n    latency?: number;\n    chunkSize?: number;\n    replaySpeed?: number;\n    logLevel?: \"silent\" | \"warn\" | \"info\" | \"debug\";\n    chaos?: ChaosConfig;\n    /**\n     * Server-wide misbehavior defaults. Read only when misbehavior is enabled\n     * (`llm.enableMisbehavior: true` or `aimock --misbehavior`); otherwise the\n     * key is ignored with a warning, as 1.44.0 ignored it.\n     */\n    misbehavior?: MisbehaviorConfig | MisbehaviorFaultId;\n    /** See `MockServerOptions.enableMisbehavior`. */\n    enableMisbehavior?: boolean;\n    record?: AimockRecordConfig;\n    /**\n     * Turns on `llm.record.mcp`. Without it the key is ignored with a warning,\n     * as 1.44.0 ignored it.\n     */\n    enableMcpRecording?: boolean;\n    /** See `MockServerOptions.strictToolArguments`. */\n    strictToolArguments?: boolean;\n    /** See `MockServerOptions.responsesTools`. */\n    responsesTools?: ResponsesToolsMode;\n  };\n  mcp?: MCPConfig;\n  a2a?: A2AConfig;\n  agui?: AGUIConfig;\n  vector?: VectorConfig;\n  services?: { search?: boolean; rerank?: boolean; moderate?: boolean };\n  metrics?: boolean;\n  strict?: boolean;\n  port?: number;\n  host?: string;\n}\n\n/** C10: the LLM part of `llm.record`. `mcp` is MCP-only; no `providers` means no LLM recording. */\nfunction llmRecordOf(record: AimockRecordConfig | undefined): RecordConfig | undefined {\n  if (!record) return undefined;\n  const { mcp: _mcp, ...llm } = record;\n  void _mcp; // repo pattern for an intentionally unused binding (byteplus-video.ts:1379-1380)\n  return llm.providers === undefined ? undefined : llm;\n}\n\nexport function loadConfig(configPath: string): AimockConfig {\n  const raw = fs.readFileSync(configPath, \"utf-8\");\n  return JSON.parse(raw) as AimockConfig;\n}\n\n/** C3: `llm.record.mcp` is an object with at least one mount. */\nfunction hasMcpRecordMount(mcp: unknown): boolean {\n  return (\n    typeof mcp === \"object\" && mcp !== null && !Array.isArray(mcp) && Object.keys(mcp).length > 0\n  );\n}\n\n/**\n * Command-line overrides for `startFromConfig`. The opt-in flags win over the\n * matching `llm.*` config keys.\n */\nexport interface StartFromConfigOverrides {\n  port?: number;\n  host?: string;\n  /** `aimock --misbehavior`: overrides `llm.enableMisbehavior`. */\n  enableMisbehavior?: boolean;\n  /** `aimock --strict-tool-arguments`: overrides `llm.strictToolArguments`. */\n  strictToolArguments?: boolean;\n  /** `aimock --responses-tools`: overrides `llm.responsesTools`. */\n  responsesTools?: ResponsesToolsMode;\n}\n\nexport async function startFromConfig(\n  config: AimockConfig,\n  overrides?: StartFromConfigOverrides,\n): Promise<{ llmock: LLMock; url: string }> {\n  const logger = new Logger(\"info\");\n  // 1.44.0 ignored these keys, so a non-boolean value (such as the string\n  // \"true\") is ignored with a warning, as `llm.misbehavior` is, and the\n  // option stays off unless a CLI flag turns it on (`llm.enableMcpRecording`\n  // has no CLI flag).\n  const booleanOptIn = (\n    key: \"enableMisbehavior\" | \"enableMcpRecording\" | \"strictToolArguments\",\n  ): boolean | undefined => {\n    const value: unknown = config.llm?.[key];\n    if (value === undefined || typeof value === \"boolean\") return value;\n    logger.warn(\n      `Ignoring llm.${key} because it must be true or false, got ${JSON.stringify(value)}.`,\n    );\n    return undefined;\n  };\n  const configEnableMisbehavior = booleanOptIn(\"enableMisbehavior\");\n  const configStrictToolArguments = booleanOptIn(\"strictToolArguments\");\n  // MCP recording also needs an explicit opt-in. 1.44.0 ignored\n  // `llm.record.mcp`, so without `llm.enableMcpRecording: true` the key is\n  // ignored (with a warning): nothing is mounted or validated and the log level\n  // is unchanged. With the opt-in, an invalid value fails startup.\n  const enableMcpRecording = booleanOptIn(\"enableMcpRecording\") === true;\n  const mcpRecord = enableMcpRecording ? config.llm?.record?.mcp : undefined;\n  // Misbehavior needs an explicit opt-in that a 1.44.0 config cannot contain.\n  // 1.44.0 ignored `llm.misbehavior`, so without the opt-in the key is ignored\n  // (with a warning) and the server serves exactly what 1.44.0 served. With the\n  // opt-in, an invalid value fails startup like any other enabled-mode error.\n  const enableMisbehavior = (overrides?.enableMisbehavior ?? configEnableMisbehavior) === true;\n  let misbehavior: MisbehaviorConfig | undefined;\n  if (config.llm?.misbehavior !== undefined) {\n    if (!enableMisbehavior) {\n      logger.warn(\n        \"Ignoring llm.misbehavior because misbehavior is not enabled. Set llm.enableMisbehavior: true or pass --misbehavior to use it.\",\n      );\n    } else {\n      const parsed = parseMisbehavior(config.llm.misbehavior, \"llm.misbehavior\");\n      if (!parsed.ok) {\n        throw new TypeError(`${parsed.issue.rule}: ${parsed.issue.path}: ${parsed.issue.message}`);\n      }\n      misbehavior = parsed.config;\n    }\n  }\n  if (config.llm?.record?.mcp !== undefined && !enableMcpRecording) {\n    logger.warn(\n      \"Ignoring llm.record.mcp because MCP recording is not enabled. Set llm.enableMcpRecording: true to use it.\",\n    );\n  }\n\n  // 1.44.0 ignored `llm.responsesTools`, so an invalid value is ignored with a\n  // warning (as `llm.misbehavior` is) and the server runs in \"legacy\" mode,\n  // unless `--responses-tools` sets the mode. The warning names the mode that\n  // actually runs.\n  let responsesTools = config.llm?.responsesTools;\n  if (\n    responsesTools !== undefined &&\n    responsesTools !== \"legacy\" &&\n    responsesTools !== \"extended\"\n  ) {\n    const effective =\n      overrides?.responsesTools !== undefined\n        ? `\"${overrides.responsesTools}\" from --responses-tools`\n        : '\"legacy\"';\n    logger.warn(\n      `Ignoring llm.responsesTools because it must be \"legacy\" or \"extended\", got ${JSON.stringify(responsesTools)}. Using ${effective}.`,\n    );\n    responsesTools = undefined;\n  }\n\n  // A non-positive replaySpeed fails calculateDelay's `speed > 0` check and applies the\n  // full delay rather than none. Mirrors the fixture-level guard in fixture-loader.ts.\n  let replaySpeed = config.llm?.replaySpeed;\n  if (replaySpeed != null && (!Number.isFinite(replaySpeed) || replaySpeed <= 0)) {\n    logger.warn(`llm.replaySpeed must be a positive number, got ${replaySpeed}. Ignoring.`);\n    replaySpeed = undefined;\n  }\n\n  // Load fixtures if specified\n  const resolvedAuth = resolveInboundAuth(selectInboundAuthSource(config.auth));\n  const llmock = createLLMockWithResolvedAuth(\n    {\n      port: overrides?.port ?? config.port ?? 0,\n      host: overrides?.host ?? config.host ?? \"127.0.0.1\",\n      latency: config.llm?.latency,\n      chunkSize: config.llm?.chunkSize,\n      replaySpeed,\n      // llm.record.mcp reports skipped or failed recordings only as MCP-RECORD: warnings,\n      // so an enabled config with at least one mount defaults to \"warn\" rather than the silent\n      // default. An empty llm.record.mcp records nothing. An explicit logLevel wins.\n      logLevel: config.llm?.logLevel ?? (hasMcpRecordMount(mcpRecord) ? \"warn\" : undefined),\n      chaos: config.llm?.chaos,\n      misbehavior,\n      ...(enableMisbehavior ? { enableMisbehavior: true } : {}),\n      record: llmRecordOf(config.llm?.record),\n      metrics: config.metrics,\n      strict: config.strict,\n      strictToolArguments: overrides?.strictToolArguments ?? configStrictToolArguments,\n      responsesTools: overrides?.responsesTools ?? responsesTools,\n    },\n    resolvedAuth,\n  );\n\n  // What this function mounted, by path (MR1: llm.record.mcp records through an MCP mount).\n  const configMounts = new Map<string, Mountable>();\n\n  if (config.llm?.fixtures) {\n    const fixturePath = path.resolve(config.llm.fixtures);\n    const stat = fs.statSync(fixturePath);\n    if (stat.isDirectory()) {\n      llmock.loadFixtureDir(fixturePath);\n    } else {\n      llmock.loadFixtureFile(fixturePath);\n    }\n  }\n\n  // MCP\n  if (config.mcp) {\n    const mcpConfig = config.mcp;\n    const mcp = new MCPMock({\n      serverInfo: mcpConfig.serverInfo,\n    });\n\n    if (mcpConfig.tools) {\n      for (const tool of mcpConfig.tools) {\n        const { result, ...def } = tool;\n        mcp.addTool(def);\n        if (result !== undefined) {\n          const answer = () => result;\n          configToolHandlers.add(answer);\n          mcp.onToolCall(def.name, answer);\n        }\n      }\n    }\n\n    if (mcpConfig.resources) {\n      for (const res of mcpConfig.resources) {\n        mcp.addResource(\n          { uri: res.uri, name: res.name, mimeType: res.mimeType, description: res.description },\n          res.text !== undefined || res.blob !== undefined\n            ? { text: res.text, blob: res.blob, mimeType: res.mimeType }\n            : undefined,\n        );\n      }\n    }\n\n    if (mcpConfig.prompts) {\n      for (const prompt of mcpConfig.prompts) {\n        const { result, ...def } = prompt;\n        if (result) {\n          mcp.addPrompt(def, () => result as import(\"./mcp-types.js\").MCPPromptResult);\n        } else {\n          mcp.addPrompt(def);\n        }\n      }\n    }\n\n    const mcpPath = mcpConfig.path ?? \"/mcp\";\n    llmock.mount(mcpPath, mcp);\n    configMounts.set(mcpPath, mcp);\n    logger.info(`MCPMock mounted at ${mcpPath}`);\n  }\n\n  // A2A\n  if (config.a2a) {\n    const a2aConfig = config.a2a;\n    const a2a = new A2AMock();\n\n    if (a2aConfig.agents) {\n      for (const agentConfig of a2aConfig.agents) {\n        const { messages, tasks, streamingTasks, ...def } = agentConfig;\n        a2a.registerAgent(def);\n\n        if (messages) {\n          for (const m of messages) {\n            a2a.onMessage(def.name, m.pattern, m.parts ?? [{ text: \"\" }]);\n          }\n        }\n\n        if (tasks) {\n          for (const t of tasks) {\n            a2a.onTask(def.name, t.pattern, t.artifacts ?? []);\n          }\n        }\n\n        if (streamingTasks) {\n          for (const s of streamingTasks) {\n            a2a.onStreamingTask(def.name, s.pattern, s.events ?? [], s.delayMs);\n          }\n        }\n      }\n    }\n\n    const a2aPath = a2aConfig.path ?? \"/a2a\";\n    llmock.mount(a2aPath, a2a);\n    configMounts.set(a2aPath, a2a);\n    logger.info(`A2AMock mounted at ${a2aPath}`);\n  }\n\n  // AG-UI\n  if (config.agui) {\n    const aguiConfig = config.agui;\n    const agui = new AGUIMock();\n\n    if (aguiConfig.fixtures) {\n      for (const f of aguiConfig.fixtures) {\n        if (f.match.toolCallId && f.text && !f.events) {\n          logger.warn(\n            `AG-UI fixture uses text shorthand with toolCallId — text shorthand ignores toolCallId matching; use events[] instead (match: ${JSON.stringify(f.match)})`,\n          );\n        }\n        if (f.text) {\n          if (f.match.message !== undefined) {\n            agui.onMessage(f.match.message, f.text, { delayMs: f.delayMs });\n          } else {\n            // No message pattern — register via addFixture so it only matches\n            // on other criteria (toolCallId, toolName, stateKey) instead of\n            // becoming a catch-all that matches every request.\n            agui.addFixture({\n              match: {\n                toolCallId: f.match.toolCallId,\n                toolName: f.match.toolName,\n                stateKey: f.match.stateKey,\n              },\n              events: buildTextResponse(f.text),\n              delayMs: f.delayMs,\n            });\n          }\n        } else if (f.events) {\n          agui.addFixture({\n            match: {\n              message: f.match.message,\n              toolCallId: f.match.toolCallId,\n              toolName: f.match.toolName,\n              stateKey: f.match.stateKey,\n            },\n            events: f.events,\n            delayMs: f.delayMs,\n          });\n        } else {\n          logger.warn(\n            `AG-UI fixture has neither text nor events — it will be skipped (match: ${JSON.stringify(f.match)})`,\n          );\n        }\n      }\n    }\n\n    const aguiPath = aguiConfig.path ?? \"/agui\";\n    llmock.mount(aguiPath, agui);\n    configMounts.set(aguiPath, agui);\n    logger.info(`AGUIMock mounted at ${aguiPath}`);\n  }\n\n  // Vector\n  if (config.vector) {\n    const vectorConfig = config.vector;\n    const vector = new VectorMock();\n\n    if (vectorConfig.collections) {\n      for (const col of vectorConfig.collections) {\n        vector.addCollection(col.name, { dimension: col.dimension });\n\n        if (col.vectors && col.vectors.length > 0) {\n          vector.upsert(col.name, col.vectors);\n        }\n\n        if (col.queryResults) {\n          vector.onQuery(col.name, col.queryResults);\n        }\n      }\n    }\n\n    const vectorPath = vectorConfig.path ?? \"/vector\";\n    llmock.mount(vectorPath, vector);\n    configMounts.set(vectorPath, vector);\n    logger.info(`VectorMock mounted at ${vectorPath}`);\n  }\n\n  // MR1: llm.record.mcp — record mounts (auto-mount an MCPMock where none is).\n  // Read only with llm.enableMcpRecording: true. Any value that is present is then\n  // validated, so null, false, 0 and \"\" fail at start too.\n  if (mcpRecord !== undefined) {\n    wireMcpRecording(llmock, mcpRecord, {\n      mounted: configMounts,\n      mcpMock: MCPMock,\n      fixtures: config.llm?.fixtures,\n      fixturePath: config.llm?.record?.fixturePath,\n      strict: config.strict,\n      env: process.env,\n    });\n  }\n\n  // Services — configure default catch-all responses\n  if (config.services) {\n    if (config.services.search) {\n      llmock.onSearch(/.*/, []);\n      logger.info(\"Search service enabled with default empty results\");\n    }\n    if (config.services.rerank) {\n      llmock.onRerank(/.*/, []);\n      logger.info(\"Rerank service enabled with default empty results\");\n    }\n    if (config.services.moderate) {\n      llmock.onModerate(/.*/, { flagged: false, categories: {} });\n      logger.info(\"Moderation service enabled with default unflagged results\");\n    }\n  }\n\n  const url = await llmock.start();\n  return { llmock, url };\n}\n"],"mappings":"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"}

package/dist/constants.cjs

@@ -2,7 +2,15 @@
 //#region src/constants.ts
 /** Sentinel testId used when no explicit test scope is provided. */
 const DEFAULT_TEST_ID = "__default__";
+/**
+* Longest text (in characters) an `echo` of one value produces in an error
+* message, a bad-block detail or a `firstDifference` side. A longer value is
+* cut so that the kept part, `…` and the count of chars left out together
+* fit in this limit. Exported from mcp-fakes.ts as well.
+*/
+const MCP_FAKES_ECHO_LIMIT = 200;
 
 //#endregion
 exports.DEFAULT_TEST_ID = DEFAULT_TEST_ID;
+exports.MCP_FAKES_ECHO_LIMIT = MCP_FAKES_ECHO_LIMIT;
 //# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.cjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/** Sentinel testId used when no explicit test scope is provided. */\nexport const DEFAULT_TEST_ID = \"__default__\";\n"],"mappings":";;;AACA,MAAa,kBAAkB"}
+{"version":3,"file":"constants.cjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/** Sentinel testId used when no explicit test scope is provided. */\nexport const DEFAULT_TEST_ID = \"__default__\";\n\n/**\n * Longest text (in characters) an `echo` of one value produces in an error\n * message, a bad-block detail or a `firstDifference` side. A longer value is\n * cut so that the kept part, `…` and the count of chars left out together\n * fit in this limit. Exported from mcp-fakes.ts as well.\n */\nexport const MCP_FAKES_ECHO_LIMIT = 200;\n"],"mappings":";;;AACA,MAAa,kBAAkB;;;;;;;AAQ/B,MAAa,uBAAuB"}

package/dist/constants.d.cts

@@ -1,8 +1,12 @@
 //#region src/constants.d.ts
 /** Sentinel testId used when no explicit test scope is provided. */
 declare const DEFAULT_TEST_ID = "__default__";
-//# sourceMappingURL=constants.d.ts.map
-
+/**
+ * Longest text (in characters) an `echo` of one value produces in an error
+ * message, a bad-block detail or a `firstDifference` side. A longer value is
+ * cut so that the kept part, `…` and the count of chars left out together
+ * fit in this limit. Exported from mcp-fakes.ts as well.
+ */
 //#endregion
 export { DEFAULT_TEST_ID };
 //# sourceMappingURL=constants.d.cts.map

package/dist/constants.d.ts

@@ -1,8 +1,12 @@
 //#region src/constants.d.ts
 /** Sentinel testId used when no explicit test scope is provided. */
 declare const DEFAULT_TEST_ID = "__default__";
-//# sourceMappingURL=constants.d.ts.map
-
+/**
+ * Longest text (in characters) an `echo` of one value produces in an error
+ * message, a bad-block detail or a `firstDifference` side. A longer value is
+ * cut so that the kept part, `…` and the count of chars left out together
+ * fit in this limit. Exported from mcp-fakes.ts as well.
+ */
 //#endregion
 export { DEFAULT_TEST_ID };
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -1,7 +1,14 @@
 //#region src/constants.ts
 /** Sentinel testId used when no explicit test scope is provided. */
 const DEFAULT_TEST_ID = "__default__";
+/**
+* Longest text (in characters) an `echo` of one value produces in an error
+* message, a bad-block detail or a `firstDifference` side. A longer value is
+* cut so that the kept part, `…` and the count of chars left out together
+* fit in this limit. Exported from mcp-fakes.ts as well.
+*/
+const MCP_FAKES_ECHO_LIMIT = 200;
 
 //#endregion
-export { DEFAULT_TEST_ID };
+export { DEFAULT_TEST_ID, MCP_FAKES_ECHO_LIMIT };
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/** Sentinel testId used when no explicit test scope is provided. */\nexport const DEFAULT_TEST_ID = \"__default__\";\n"],"mappings":";;AACA,MAAa,kBAAkB"}
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/** Sentinel testId used when no explicit test scope is provided. */\nexport const DEFAULT_TEST_ID = \"__default__\";\n\n/**\n * Longest text (in characters) an `echo` of one value produces in an error\n * message, a bad-block detail or a `firstDifference` side. A longer value is\n * cut so that the kept part, `…` and the count of chars left out together\n * fit in this limit. Exported from mcp-fakes.ts as well.\n */\nexport const MCP_FAKES_ECHO_LIMIT = 200;\n"],"mappings":";;AACA,MAAa,kBAAkB;;;;;;;AAQ/B,MAAa,uBAAuB"}

package/dist/echo-text.cjs

@@ -0,0 +1,65 @@
+const require_constants = require('./constants.cjs');
+
+//#region src/echo-text.ts
+/**
+* The one cut rule for text that MCP fakes put into a message. The message
+* builder (`build` in message-text.ts) cuts every user part of a message with
+* it, once; helpers.ts also cuts the `MCP_INVALID_UNDECLARED` `raw` field
+* with it. A leaf module (it imports only constants.ts), so every one of
+* those can use it without an import cycle.
+*/
+/**
+* `text` cut to at most `limit` chars in all: the kept part, then `…` and the
+* count of chars left out. When even that count does not fit in `limit`, the
+* kept part is followed by a bare `…`. A `limit` below 1 has no room even for
+* that `…`, so a text longer than it is cut to `""`; the message builder
+* never asks for that (each of its user parts gets at least 1 char). The
+* kept part is a prefix of `text` that never ends inside a unit of `units`. A
+* `limit` that is not an integer is rounded down, a negative one
+* (`-Infinity` too) is 0, and a `NaN` limit is a `RangeError`.
+*
+* @internal
+*/
+function cutText(text, limit = require_constants.MCP_FAKES_ECHO_LIMIT, units = "text") {
+	if (Number.isNaN(limit)) throw new RangeError("cutText limit must be a number, got NaN");
+	limit = Math.max(0, Math.floor(limit));
+	if (text.length <= limit) return text;
+	let keep = limit;
+	let suffix = "";
+	for (;;) {
+		suffix = `… (${text.length - keep} more chars)`;
+		const room = Math.max(0, limit - suffix.length);
+		if (keep <= room) break;
+		keep = room;
+	}
+	if (keep + suffix.length > limit) return limit < 1 ? "" : text.slice(0, safeEnd(text, limit - 1, units)) + "…";
+	keep = safeEnd(text, keep, units);
+	return text.slice(0, keep) + `… (${text.length - keep} more chars)`;
+}
+/** `keep`, moved back to a point that does not split a unit of `units`. */
+function safeEnd(text, keep, units) {
+	return surrogateSafeEnd(text, units === "json" ? escapeSafeEnd(text, keep) : keep);
+}
+/** `keep`, or one less when the char before it is a high surrogate. */
+function surrogateSafeEnd(text, keep) {
+	if (keep <= 0) return keep;
+	const code = text.charCodeAt(keep - 1);
+	return code >= 55296 && code <= 56319 ? keep - 1 : keep;
+}
+/**
+* `keep`, or the start of the JSON escape (`\x` or `\uXXXX`) that a cut at
+* `keep` would split.
+*/
+function escapeSafeEnd(text, keep) {
+	for (let i = 0; i < keep; i++) {
+		if (text.charCodeAt(i) !== 92) continue;
+		const end = i + (text[i + 1] === "u" ? 6 : 2);
+		if (end > keep) return i;
+		i = end - 1;
+	}
+	return keep;
+}
+
+//#endregion
+exports.cutText = cutText;
+//# sourceMappingURL=echo-text.cjs.map

package/dist/echo-text.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-text.cjs","names":["MCP_FAKES_ECHO_LIMIT"],"sources":["../src/echo-text.ts"],"sourcesContent":["/**\n * The one cut rule for text that MCP fakes put into a message. The message\n * builder (`build` in message-text.ts) cuts every user part of a message with\n * it, once; helpers.ts also cuts the `MCP_INVALID_UNDECLARED` `raw` field\n * with it. A leaf module (it imports only constants.ts), so every one of\n * those can use it without an import cycle.\n */\nimport { MCP_FAKES_ECHO_LIMIT } from \"./constants.js\";\n\n/**\n * What a cut must not split. `\"text\"`: a surrogate pair. `\"json\"`: a\n * surrogate pair or a JSON escape (`\\x` or `\\uXXXX`); for JSON text, where a\n * backslash only ever starts an escape.\n */\nexport type CutUnits = \"text\" | \"json\";\n\n/**\n * `text` cut to at most `limit` chars in all: the kept part, then `…` and the\n * count of chars left out. When even that count does not fit in `limit`, the\n * kept part is followed by a bare `…`. A `limit` below 1 has no room even for\n * that `…`, so a text longer than it is cut to `\"\"`; the message builder\n * never asks for that (each of its user parts gets at least 1 char). The\n * kept part is a prefix of `text` that never ends inside a unit of `units`. A\n * `limit` that is not an integer is rounded down, a negative one\n * (`-Infinity` too) is 0, and a `NaN` limit is a `RangeError`.\n *\n * @internal\n */\nexport function cutText(\n  text: string,\n  limit: number = MCP_FAKES_ECHO_LIMIT,\n  units: CutUnits = \"text\",\n): string {\n  if (Number.isNaN(limit)) throw new RangeError(\"cutText limit must be a number, got NaN\");\n  // A negative limit (`-Infinity` included) keeps nothing, as a limit of 0 does.\n  limit = Math.max(0, Math.floor(limit));\n  if (text.length <= limit) return text;\n  let keep = limit;\n  let suffix = \"\";\n  for (;;) {\n    suffix = `… (${text.length - keep} more chars)`;\n    const room = Math.max(0, limit - suffix.length);\n    if (keep <= room) break;\n    keep = room;\n  }\n  if (keep + suffix.length > limit) {\n    // Not even the count fits: keep what fits before a bare `…`.\n    return limit < 1 ? \"\" : text.slice(0, safeEnd(text, limit - 1, units)) + \"…\";\n  }\n  // Moving the cut back by d chars grows the count by d, which adds at most\n  // one digit to the suffix, so the total stays within `limit`.\n  keep = safeEnd(text, keep, units);\n  return text.slice(0, keep) + `… (${text.length - keep} more chars)`;\n}\n\n/** `keep`, moved back to a point that does not split a unit of `units`. */\nfunction safeEnd(text: string, keep: number, units: CutUnits): number {\n  return surrogateSafeEnd(text, units === \"json\" ? escapeSafeEnd(text, keep) : keep);\n}\n\n/** `keep`, or one less when the char before it is a high surrogate. */\nfunction surrogateSafeEnd(text: string, keep: number): number {\n  if (keep <= 0) return keep;\n  const code = text.charCodeAt(keep - 1);\n  return code >= 0xd800 && code <= 0xdbff ? keep - 1 : keep;\n}\n\n/**\n * `keep`, or the start of the JSON escape (`\\x` or `\\uXXXX`) that a cut at\n * `keep` would split.\n */\nfunction escapeSafeEnd(text: string, keep: number): number {\n  for (let i = 0; i < keep; i++) {\n    if (text.charCodeAt(i) !== 0x5c) continue;\n    const end = i + (text[i + 1] === \"u\" ? 6 : 2);\n    if (end > keep) return i;\n    i = end - 1;\n  }\n  return keep;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,QACd,MACA,QAAgBA,wCAChB,QAAkB,QACV;AACR,KAAI,OAAO,MAAM,MAAM,CAAE,OAAM,IAAI,WAAW,0CAA0C;AAExF,SAAQ,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,CAAC;AACtC,KAAI,KAAK,UAAU,MAAO,QAAO;CACjC,IAAI,OAAO;CACX,IAAI,SAAS;AACb,UAAS;AACP,WAAS,MAAM,KAAK,SAAS,KAAK;EAClC,MAAM,OAAO,KAAK,IAAI,GAAG,QAAQ,OAAO,OAAO;AAC/C,MAAI,QAAQ,KAAM;AAClB,SAAO;;AAET,KAAI,OAAO,OAAO,SAAS,MAEzB,QAAO,QAAQ,IAAI,KAAK,KAAK,MAAM,GAAG,QAAQ,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG;AAI3E,QAAO,QAAQ,MAAM,MAAM,MAAM;AACjC,QAAO,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,KAAK,SAAS,KAAK;;;AAIxD,SAAS,QAAQ,MAAc,MAAc,OAAyB;AACpE,QAAO,iBAAiB,MAAM,UAAU,SAAS,cAAc,MAAM,KAAK,GAAG,KAAK;;;AAIpF,SAAS,iBAAiB,MAAc,MAAsB;AAC5D,KAAI,QAAQ,EAAG,QAAO;CACtB,MAAM,OAAO,KAAK,WAAW,OAAO,EAAE;AACtC,QAAO,QAAQ,SAAU,QAAQ,QAAS,OAAO,IAAI;;;;;;AAOvD,SAAS,cAAc,MAAc,MAAsB;AACzD,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,KAAK;AAC7B,MAAI,KAAK,WAAW,EAAE,KAAK,GAAM;EACjC,MAAM,MAAM,KAAK,KAAK,IAAI,OAAO,MAAM,IAAI;AAC3C,MAAI,MAAM,KAAM,QAAO;AACvB,MAAI,MAAM;;AAEZ,QAAO"}

package/dist/echo-text.d.cts

@@ -0,0 +1,22 @@
+//#region src/echo-text.d.ts
+/**
+ * What a cut must not split. `"text"`: a surrogate pair. `"json"`: a
+ * surrogate pair or a JSON escape (`\x` or `\uXXXX`); for JSON text, where a
+ * backslash only ever starts an escape.
+ */
+type CutUnits = "text" | "json";
+/**
+ * `text` cut to at most `limit` chars in all: the kept part, then `…` and the
+ * count of chars left out. When even that count does not fit in `limit`, the
+ * kept part is followed by a bare `…`. A `limit` below 1 has no room even for
+ * that `…`, so a text longer than it is cut to `""`; the message builder
+ * never asks for that (each of its user parts gets at least 1 char). The
+ * kept part is a prefix of `text` that never ends inside a unit of `units`. A
+ * `limit` that is not an integer is rounded down, a negative one
+ * (`-Infinity` too) is 0, and a `NaN` limit is a `RangeError`.
+ *
+ * @internal
+ */
+//#endregion
+export { CutUnits };
+//# sourceMappingURL=echo-text.d.cts.map

package/dist/echo-text.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-text.d.cts","names":[],"sources":["../src/echo-text.ts"],"sourcesContent":[],"mappings":";;AAcA;;;;KAAY,QAAA"}

package/dist/echo-text.d.ts

@@ -0,0 +1,22 @@
+//#region src/echo-text.d.ts
+/**
+ * What a cut must not split. `"text"`: a surrogate pair. `"json"`: a
+ * surrogate pair or a JSON escape (`\x` or `\uXXXX`); for JSON text, where a
+ * backslash only ever starts an escape.
+ */
+type CutUnits = "text" | "json";
+/**
+ * `text` cut to at most `limit` chars in all: the kept part, then `…` and the
+ * count of chars left out. When even that count does not fit in `limit`, the
+ * kept part is followed by a bare `…`. A `limit` below 1 has no room even for
+ * that `…`, so a text longer than it is cut to `""`; the message builder
+ * never asks for that (each of its user parts gets at least 1 char). The
+ * kept part is a prefix of `text` that never ends inside a unit of `units`. A
+ * `limit` that is not an integer is rounded down, a negative one
+ * (`-Infinity` too) is 0, and a `NaN` limit is a `RangeError`.
+ *
+ * @internal
+ */
+//#endregion
+export { CutUnits };
+//# sourceMappingURL=echo-text.d.ts.map

package/dist/echo-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-text.d.ts","names":[],"sources":["../src/echo-text.ts"],"sourcesContent":[],"mappings":";;AAcA;;;;KAAY,QAAA"}