@copilotkit/aimock 1.43.0 → 1.44.0

package/dist/mcp-mock.cjs

@@ -1,6 +1,8 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_message_text = require('./message-text.cjs');
 const require_helpers = require('./helpers.cjs');
 const require_mcp_handler = require('./mcp-handler.cjs');
+const require_mcp_fakes = require('./mcp-fakes.cjs');
 let node_http = require("node:http");
 node_http = require_runtime.__toESM(node_http);
 
@@ -10,9 +12,21 @@ var MCPMock = class {
 	resources = /* @__PURE__ */ new Map();
 	prompts = /* @__PURE__ */ new Map();
 	sessions = /* @__PURE__ */ new Map();
+	/** This mount's fakes; kept across `reset()` so the id counters are never rewound. */
+	fakes = new require_mcp_fakes.McpFakeStore();
+	/** Fake blocks loaded since the last clear. */
+	fakeBlocks = 0;
+	/**
+	* Decode fallbacks already reported (L2), per live session: one key per
+	* field and source, plus one for undecodable query names. Dropped when the
+	* session is deleted.
+	*/
+	decodeWarned = /* @__PURE__ */ new Map();
 	server = null;
 	journal = null;
 	registry = null;
+	/** Mount logger for L1, L2 and L10; none (lines dropped) until `setLogger`. */
+	logger = null;
 	options;
 	requestHandler;
 	constructor(options) {
@@ -46,10 +60,85 @@ var MCPMock = class {
 		});
 		return this;
 	}
+	/**
+	* Load MCP fakes from code: one `mcpFakes` value (a block, or an array of
+	* blocks), in the fixture-file shape, validated here. One run-time addition
+	* (`code#<n>` entry ids). Always appends. Returns the shadowed-entry
+	* warnings; on any bad block throws one `McpFakesAddError` and adds nothing.
+	*/
+	loadFakes(blocks) {
+		const sources = Array.isArray(blocks) ? blocks.map((raw, blockIndex) => ({
+			source: "code",
+			blockIndex,
+			raw
+		})) : [{
+			source: "code",
+			blockIndex: null,
+			raw: blocks
+		}];
+		return this.addMcpFakes(sources, { kind: "code" });
+	}
+	addMcpFakes(blocks, origin) {
+		const result = this.fakes.add(blocks, origin);
+		this.fakeBlocks += blocks.length;
+		return result;
+	}
+	/**
+	* The blocks on this mount that apply to `testId` and `context` (spec 6.5,
+	* I9), with every entry id and its consumed state for that test id. `null`
+	* means "none sent". Read-only: the result is deeply frozen.
+	*/
+	fakesSnapshot(testId = null, context = null) {
+		return this.fakes.snapshot(testId, context);
+	}
+	clearMcpFakes() {
+		this.fakes.clear();
+		this.fakeBlocks = 0;
+	}
+	resetScenarioState(testId) {
+		this.fakes.resetState(testId);
+	}
+	setLogger(logger) {
+		this.logger = logger;
+	}
 	async handleRequest(req, res, pathname) {
 		if (pathname !== "/" && pathname !== "") return false;
-		if (req.method !== "POST" && req.method !== "DELETE") return false;
-		const body = await require_helpers.readBody(req);
+		if (req.method === "GET") {
+			this.answerMethodNotAllowed(req, res);
+			return true;
+		}
+		if (!isServedMethod(req.method)) return false;
+		await this.serve(req, res, mountPathOf(req.url, pathname), false);
+		return true;
+	}
+	/**
+	* Serve one request, in both modes (mounted: a POST or DELETE on the mount
+	* root; standalone: any method but GET on any path): count it, run the
+	* handler, journal it. A throw from the mount's own code is logged with the
+	* identity resolved so far, answered 500 and journaled with its message,
+	* never left to a generic catch.
+	*/
+	async serve(req, res, mount, standalone) {
+		const record = require_mcp_handler.newMCPRequestRecord();
+		try {
+			const body = await require_helpers.readBody(req);
+			this.countRequest(req, body);
+			await this.requestHandler(req, res, body, mount, record);
+			this.journalRequest(req, res, record);
+		} catch (err) {
+			const thrown = err instanceof Error ? err.message : String(err);
+			const line = require_message_text.build(require_message_text.msg`MCPMock request error (${record.identity ? require_mcp_handler.describeMcpIdentity(record.identity) : require_message_text.msg`no identity resolved`}, mount ${require_message_text.plainText(mount)}): ${require_message_text.plainText(thrown)}`);
+			if (standalone || !this.logger) console.error(line);
+			else this.logger.error(line);
+			if (!res.headersSent) {
+				res.writeHead(500);
+				res.end("Internal server error");
+			} else if (!res.writableEnded) res.end();
+			this.journalRequest(req, res, record, thrown);
+		}
+	}
+	/** `aimock_mcp_requests_total` by JSON-RPC method (`session/delete` for DELETE). */
+	countRequest(req, body) {
 		if (this.registry) if (req.method === "DELETE") this.registry.incrementCounter("aimock_mcp_requests_total", { method: "session/delete" });
 		else try {
 			const parsed = JSON.parse(body);
@@ -58,19 +147,19 @@ var MCPMock = class {
 		} catch {
 			this.registry.incrementCounter("aimock_mcp_requests_total", { method: "unknown" });
 		}
-		await this.requestHandler(req, res, body);
-		if (this.journal) this.journal.add({
-			method: req.method ?? "POST",
-			path: req.url ?? "/",
-			headers: require_helpers.flattenHeaders(req.headers),
-			body: null,
-			service: "mcp",
-			response: {
-				status: res.statusCode,
-				fixture: null
-			}
+	}
+	/**
+	* B1: answer 405 (`Allow: POST, DELETE`), journaled. Mounted, this is a GET
+	* on the mount root; standalone, a GET on any path.
+	*/
+	answerMethodNotAllowed(req, res) {
+		res.writeHead(405, {
+			"Content-Type": "application/json",
+			Allow: "POST, DELETE"
 		});
-		return true;
+		res.end(JSON.stringify({ error: require_message_text.build(require_message_text.msg`Method not allowed: use POST or DELETE`) }));
+		req.resume();
+		this.journalRequest(req, res, null);
 	}
 	health() {
 		return {
@@ -83,6 +172,7 @@ var MCPMock = class {
 	}
 	setJournal(journal) {
 		this.journal = journal;
+		this.fakes.setMaxTestIds(journal.fixtureCountsMaxTestIdsCap);
 	}
 	setRegistry(registry) {
 		this.registry = registry;
@@ -93,40 +183,13 @@ var MCPMock = class {
 		const port = this.options.port ?? 0;
 		return new Promise((resolve, reject) => {
 			const srv = node_http.createServer((req, res) => {
-				const chunks = [];
-				req.on("data", (chunk) => chunks.push(chunk));
-				req.on("end", () => {
-					const body = Buffer.concat(chunks).toString();
-					this.requestHandler(req, res, body).then(() => {
-						if (this.journal) this.journal.add({
-							method: req.method ?? "POST",
-							path: req.url ?? "/",
-							headers: require_helpers.flattenHeaders(req.headers),
-							body: null,
-							service: "mcp",
-							response: {
-								status: res.statusCode,
-								fixture: null
-							}
-						});
-					}).catch((err) => {
-						console.error("MCPMock request error:", err);
-						if (!res.headersSent) {
-							res.writeHead(500);
-							res.end("Internal server error");
-						} else if (!res.writableEnded) res.end();
-						if (this.journal) this.journal.add({
-							method: req.method ?? "POST",
-							path: req.url ?? "/",
-							headers: require_helpers.flattenHeaders(req.headers),
-							body: null,
-							service: "mcp",
-							response: {
-								status: res.statusCode,
-								fixture: null
-							}
-						});
-					});
+				if (req.method === "GET") {
+					this.answerMethodNotAllowed(req, res);
+					return;
+				}
+				this.serve(req, res, "/", true).catch((err) => {
+					console.error("MCPMock request error:", err);
+					if (!res.writableEnded) res.end();
 				});
 			});
 			srv.listen(port, host, () => {
@@ -158,9 +221,83 @@ var MCPMock = class {
 		this.resources.clear();
 		this.prompts.clear();
 		this.sessions.clear();
+		this.decodeWarned.clear();
+		this.clearMcpFakes();
 		this.requestHandler = this.buildHandler();
 		return this;
 	}
+	/**
+	* The journal entries of one handled request (B2, B3): one per JSON-RPC
+	* message (each element of a batch), or one with no body when the request
+	* carried none that was read; none without a journal (W5). `error` is what
+	* the mount's own code threw while serving it.
+	*/
+	journalRequest(req, res, record, error) {
+		if (!this.journal) return;
+		const messages = record?.messages.length ? record.messages : [{
+			body: null,
+			mcpFake: null,
+			error: null
+		}];
+		for (const message of messages) {
+			const failed = message.error ?? error;
+			this.journal.add({
+				method: req.method ?? "POST",
+				path: req.url ?? "/",
+				headers: require_helpers.flattenHeaders(req.headers),
+				body: message.body,
+				service: "mcp",
+				...record?.identity ? {
+					testId: record.identity.testId ?? require_mcp_fakes.MCP_FAKES_DEFAULT_TEST_ID,
+					context: record.identity.context
+				} : {},
+				response: {
+					status: res.statusCode,
+					fixture: null,
+					...message.mcpFake ? { mcpFake: message.mcpFake } : {},
+					...failed !== void 0 && failed !== null ? { error: failed } : {}
+				}
+			});
+		}
+	}
+	/**
+	* Side channels of a fake outcome (9.3): the failure metric and the L1 /
+	* L10 line. A claim that threw (`internal_error`) is counted and logged
+	* like a failure, under `MCP_FAKE_INTERNAL_ERROR`.
+	*/
+	onFakeEvent(evt) {
+		if (evt.kind === "answered") return;
+		this.registry?.incrementCounter("aimock_mcp_fake_failures_total", { code: evt.code });
+		if (!this.logger) return;
+		const where = require_message_text.msg`mount ${require_message_text.plainText(evt.mount)}`;
+		const kind = evt.kind.replace("_", " ");
+		const line = evt.kind === "evicted" ? require_message_text.msg`MCP-FAKE: evicted testId ${require_message_text.quote(evt.testId)} (cap ${evt.cap}) for tools/call ${require_message_text.plainText(evt.tool)} (${where})` : require_message_text.msg`MCP-FAKE: ${require_message_text.fixed(kind)} for tools/call ${require_message_text.plainText(evt.tool)} (${require_mcp_handler.describeMcpIdentity(evt.identity)}, ${where}): ${require_message_text.plainText(evt.message)}`;
+		this.logger.error(require_message_text.build(line));
+	}
+	/**
+	* L2: one warning per session for each identity field and source whose
+	* value is not valid percent-encoding (H1), naming that source and value,
+	* and one for query names that are not valid percent-encoding.
+	*/
+	onDecodeFallback(sessionId, fallback) {
+		let warned = this.decodeWarned.get(sessionId);
+		if (!warned) {
+			warned = /* @__PURE__ */ new Set();
+			this.decodeWarned.set(sessionId, warned);
+		}
+		const key = fallback.kind === "names" ? "names" : `${fallback.field}:${fallback.source}`;
+		if (warned.has(key)) return;
+		warned.add(key);
+		const session = require_message_text.quote(sessionId);
+		if (fallback.kind === "names") {
+			const one = fallback.count === 1;
+			this.logger?.warn(require_message_text.build(require_message_text.msg`MCP-FAKE: ${fallback.count} query parameter ${require_message_text.fixed(one ? "name" : "names")} on session ${session} ${require_message_text.fixed(one ? "is" : "are")} not valid percent-encoding; ${require_message_text.fixed(one ? "it matches" : "they match")} no identity field`));
+			return;
+		}
+		const label = DECODE_LABELS[fallback.field][fallback.source];
+		const fate = fallback.used ? "it is used as sent" : "it is ignored (the header value is used)";
+		this.logger?.warn(require_message_text.build(require_message_text.msg`MCP-FAKE: ${require_message_text.fixed(label)} value ${require_message_text.quote(fallback.raw)} on session ${session} is not valid percent-encoding; ${require_message_text.fixed(fate)}`));
+	}
 	buildHandler() {
 		return require_mcp_handler.createMCPRequestHandler({
 			serverInfo: this.options.serverInfo ?? {
@@ -170,10 +307,41 @@ var MCPMock = class {
 			tools: this.tools,
 			resources: this.resources,
 			prompts: this.prompts,
-			sessions: this.sessions
+			sessions: this.sessions,
+			fakes: this.fakes,
+			hasFakes: () => this.fakeBlocks > 0,
+			onFakeEvent: (evt) => this.onFakeEvent(evt),
+			onDecodeFallback: (sessionId, fallback) => this.onDecodeFallback(sessionId, fallback),
+			onSessionClosed: (sessionId) => void this.decodeWarned.delete(sessionId)
 		});
 	}
 };
+/** B1: the only methods the mounted mount root serves; every other one is 405. */
+function isServedMethod(method) {
+	return method === "POST" || method === "DELETE";
+}
+/** The L2 label of each identity field's header and query source. */
+const DECODE_LABELS = {
+	testId: {
+		header: "X-Test-Id header",
+		query: "?testId= query parameter"
+	},
+	context: {
+		header: "X-AIMock-Context header",
+		query: "?context= query parameter"
+	}
+};
+/**
+* The path a mount is served at (I9): the request path without the
+* sub-path the server handed the mount (`/mcp` for `/mcp` or `/mcp/`), `/`
+* at the root.
+*/
+function mountPathOf(url, subPath) {
+	const full = new URL(url ?? "/", "http://mount.invalid").pathname;
+	const sub = subPath === "" ? "/" : subPath;
+	const mount = full.endsWith(sub) ? full.slice(0, full.length - sub.length) : full;
+	return mount === "" ? "/" : mount;
+}
 
 //#endregion
 exports.MCPMock = MCPMock;

package/dist/mcp-mock.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-mock.cjs","names":["readBody","flattenHeaders","http","createMCPRequestHandler"],"sources":["../src/mcp-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type {\n  MCPMockOptions,\n  MCPToolDefinition,\n  MCPResourceDefinition,\n  MCPResourceContent,\n  MCPPromptDefinition,\n  MCPPromptResult,\n  MCPContent,\n  MCPSession,\n} from \"./mcp-types.js\";\nimport { createMCPRequestHandler, type MCPState } from \"./mcp-handler.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\n\nexport class MCPMock implements Mountable {\n  private tools: Map<\n    string,\n    { def: MCPToolDefinition; handler?: (...args: unknown[]) => unknown }\n  > = new Map();\n  private resources: Map<string, { def: MCPResourceDefinition; content?: MCPResourceContent }> =\n    new Map();\n  private prompts: Map<\n    string,\n    {\n      def: MCPPromptDefinition;\n      handler?: (...args: unknown[]) => MCPPromptResult | Promise<MCPPromptResult>;\n    }\n  > = new Map();\n  private sessions: Map<string, MCPSession> = new Map();\n  private server: http.Server | null = null;\n  private journal: Journal | null = null;\n  private registry: MetricsRegistry | null = null;\n  private options: MCPMockOptions;\n  private requestHandler: ReturnType<typeof createMCPRequestHandler>;\n\n  constructor(options?: MCPMockOptions) {\n    this.options = options ?? {};\n    this.requestHandler = this.buildHandler();\n  }\n\n  // ---- Configuration: Tools ----\n\n  addTool(def: MCPToolDefinition): this {\n    this.tools.set(def.name, { def });\n    return this;\n  }\n\n  onToolCall(\n    name: string,\n    handler: (args: unknown) => MCPContent[] | string | Promise<MCPContent[] | string>,\n  ): this {\n    const entry = this.tools.get(name);\n    if (entry) {\n      entry.handler = handler;\n    } else {\n      this.tools.set(name, { def: { name }, handler });\n    }\n    return this;\n  }\n\n  // ---- Configuration: Resources ----\n\n  addResource(def: MCPResourceDefinition, content?: MCPResourceContent): this {\n    this.resources.set(def.uri, { def, content });\n    return this;\n  }\n\n  // ---- Configuration: Prompts ----\n\n  addPrompt(\n    def: MCPPromptDefinition,\n    handler?: (args: unknown) => MCPPromptResult | Promise<MCPPromptResult>,\n  ): this {\n    this.prompts.set(def.name, { def, handler });\n    return this;\n  }\n\n  // ---- Mountable interface ----\n\n  async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean> {\n    // Only handle POST and DELETE to the root of the mount\n    if (pathname !== \"/\" && pathname !== \"\") {\n      return false;\n    }\n    if (req.method !== \"POST\" && req.method !== \"DELETE\") {\n      return false;\n    }\n\n    const body = await readBody(req);\n\n    // Extract JSON-RPC method for metrics (skip for DELETE — no JSON-RPC body)\n    if (this.registry) {\n      if (req.method === \"DELETE\") {\n        this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"session/delete\" });\n      } else {\n        try {\n          const parsed = JSON.parse(body);\n          const method =\n            typeof parsed === \"object\" && parsed !== null && \"method\" in parsed\n              ? String(parsed.method)\n              : \"unknown\";\n          this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method });\n        } catch {\n          this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"unknown\" });\n        }\n      }\n    }\n\n    await this.requestHandler(req, res, body);\n\n    // Journal the request after the handler completes\n    if (this.journal) {\n      this.journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/\",\n        headers: flattenHeaders(req.headers),\n        body: null,\n        service: \"mcp\",\n        response: { status: res.statusCode, fixture: null },\n      });\n    }\n\n    return true;\n  }\n\n  health(): { status: string; [key: string]: unknown } {\n    return {\n      status: \"ok\",\n      tools: this.tools.size,\n      resources: this.resources.size,\n      prompts: this.prompts.size,\n      sessions: this.sessions.size,\n    };\n  }\n\n  setJournal(journal: Journal): void {\n    this.journal = journal;\n  }\n\n  setRegistry(registry: MetricsRegistry): void {\n    this.registry = registry;\n  }\n\n  // ---- Standalone mode ----\n\n  async start(): Promise<string> {\n    if (this.server) {\n      throw new Error(\"Server already started\");\n    }\n\n    const host = this.options.host ?? \"127.0.0.1\";\n    const port = this.options.port ?? 0;\n\n    return new Promise((resolve, reject) => {\n      const srv = http.createServer((req, res) => {\n        const chunks: Buffer[] = [];\n        req.on(\"data\", (chunk: Buffer) => chunks.push(chunk));\n        req.on(\"end\", () => {\n          const body = Buffer.concat(chunks).toString();\n\n          this.requestHandler(req, res, body)\n            .then(() => {\n              if (this.journal) {\n                this.journal.add({\n                  method: req.method ?? \"POST\",\n                  path: req.url ?? \"/\",\n                  headers: flattenHeaders(req.headers),\n                  body: null,\n                  service: \"mcp\",\n                  response: { status: res.statusCode, fixture: null },\n                });\n              }\n            })\n            .catch((err) => {\n              console.error(\"MCPMock request error:\", err);\n              if (!res.headersSent) {\n                res.writeHead(500);\n                res.end(\"Internal server error\");\n              } else if (!res.writableEnded) {\n                res.end();\n              }\n              if (this.journal) {\n                this.journal.add({\n                  method: req.method ?? \"POST\",\n                  path: req.url ?? \"/\",\n                  headers: flattenHeaders(req.headers),\n                  body: null,\n                  service: \"mcp\",\n                  response: { status: res.statusCode, fixture: null },\n                });\n              }\n            });\n        });\n      });\n\n      srv.listen(port, host, () => {\n        this.server = srv;\n        const addr = srv.address();\n        if (typeof addr === \"object\" && addr !== null) {\n          resolve(`http://${host}:${addr.port}`);\n        } else {\n          resolve(`http://${host}:${port}`);\n        }\n      });\n\n      srv.on(\"error\", reject);\n    });\n  }\n\n  async stop(): Promise<void> {\n    if (!this.server) {\n      throw new Error(\"Server not started\");\n    }\n    const srv = this.server;\n    this.server = null;\n    await new Promise<void>((resolve, reject) => {\n      srv.close((err) => (err ? reject(err) : resolve()));\n    });\n  }\n\n  // ---- Inspection ----\n\n  getRequests(): unknown[] {\n    if (!this.journal) return [];\n    return this.journal.getAll().filter((e) => e.service === \"mcp\");\n  }\n\n  getSessions(): Map<string, MCPSession> {\n    return new Map(this.sessions);\n  }\n\n  reset(): this {\n    this.tools.clear();\n    this.resources.clear();\n    this.prompts.clear();\n    this.sessions.clear();\n    this.requestHandler = this.buildHandler();\n    return this;\n  }\n\n  // ---- Internal ----\n\n  private buildHandler() {\n    const state: MCPState = {\n      serverInfo: this.options.serverInfo ?? { name: \"mcp-mock\", version: \"1.0.0\" },\n      tools: this.tools,\n      resources: this.resources,\n      prompts: this.prompts,\n      sessions: this.sessions,\n    };\n    return createMCPRequestHandler(state);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"mcp-mock.cjs","names":["McpFakeStore","newMCPRequestRecord","readBody","build","describeMcpIdentity","plainText","http","flattenHeaders","MCP_FAKES_DEFAULT_TEST_ID","quote","fixed","createMCPRequestHandler"],"sources":["../src/mcp-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { McpFakeSource, Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type { Logger } from \"./logger.js\";\nimport type {\n  MCPMockOptions,\n  MCPToolDefinition,\n  MCPResourceDefinition,\n  MCPResourceContent,\n  MCPPromptDefinition,\n  MCPPromptResult,\n  MCPContent,\n  MCPSession,\n} from \"./mcp-types.js\";\nimport {\n  createMCPRequestHandler,\n  describeMcpIdentity,\n  newMCPRequestRecord,\n  type McpDecodeFallback,\n  type McpFakeEvent,\n  type MCPMessageRecord,\n  type MCPRequestRecord,\n  type MCPState,\n} from \"./mcp-handler.js\";\nimport {\n  MCP_FAKES_DEFAULT_TEST_ID,\n  McpFakeStore,\n  type McpFakeAddOrigin,\n  type McpFakeAddResult,\n  type McpFakeBlockSnapshot,\n} from \"./mcp-fakes.js\";\nimport { build, fixed, msg, plainText, quote } from \"./message-text.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\n\nexport class MCPMock implements Mountable {\n  private tools: Map<\n    string,\n    { def: MCPToolDefinition; handler?: (...args: unknown[]) => unknown }\n  > = new Map();\n  private resources: Map<string, { def: MCPResourceDefinition; content?: MCPResourceContent }> =\n    new Map();\n  private prompts: Map<\n    string,\n    {\n      def: MCPPromptDefinition;\n      handler?: (...args: unknown[]) => MCPPromptResult | Promise<MCPPromptResult>;\n    }\n  > = new Map();\n  private sessions: Map<string, MCPSession> = new Map();\n  /** This mount's fakes; kept across `reset()` so the id counters are never rewound. */\n  private fakes = new McpFakeStore();\n  /** Fake blocks loaded since the last clear. */\n  private fakeBlocks = 0;\n  /**\n   * Decode fallbacks already reported (L2), per live session: one key per\n   * field and source, plus one for undecodable query names. Dropped when the\n   * session is deleted.\n   */\n  private decodeWarned = new Map<string, Set<string>>();\n  private server: http.Server | null = null;\n  private journal: Journal | null = null;\n  private registry: MetricsRegistry | null = null;\n  /** Mount logger for L1, L2 and L10; none (lines dropped) until `setLogger`. */\n  private logger: Logger | null = null;\n  private options: MCPMockOptions;\n  private requestHandler: ReturnType<typeof createMCPRequestHandler>;\n\n  constructor(options?: MCPMockOptions) {\n    this.options = options ?? {};\n    this.requestHandler = this.buildHandler();\n  }\n\n  // ---- Configuration: Tools ----\n\n  addTool(def: MCPToolDefinition): this {\n    this.tools.set(def.name, { def });\n    return this;\n  }\n\n  onToolCall(\n    name: string,\n    handler: (args: unknown) => MCPContent[] | string | Promise<MCPContent[] | string>,\n  ): this {\n    const entry = this.tools.get(name);\n    if (entry) {\n      entry.handler = handler;\n    } else {\n      this.tools.set(name, { def: { name }, handler });\n    }\n    return this;\n  }\n\n  // ---- Configuration: Resources ----\n\n  addResource(def: MCPResourceDefinition, content?: MCPResourceContent): this {\n    this.resources.set(def.uri, { def, content });\n    return this;\n  }\n\n  // ---- Configuration: Prompts ----\n\n  addPrompt(\n    def: MCPPromptDefinition,\n    handler?: (args: unknown) => MCPPromptResult | Promise<MCPPromptResult>,\n  ): this {\n    this.prompts.set(def.name, { def, handler });\n    return this;\n  }\n\n  // ---- Configuration: MCP fakes ----\n\n  /**\n   * Load MCP fakes from code: one `mcpFakes` value (a block, or an array of\n   * blocks), in the fixture-file shape, validated here. One run-time addition\n   * (`code#<n>` entry ids). Always appends. Returns the shadowed-entry\n   * warnings; on any bad block throws one `McpFakesAddError` and adds nothing.\n   */\n  loadFakes(blocks: unknown): McpFakeAddResult {\n    const sources: McpFakeSource[] = Array.isArray(blocks)\n      ? blocks.map((raw: unknown, blockIndex) => ({ source: \"code\", blockIndex, raw }))\n      : [{ source: \"code\", blockIndex: null, raw: blocks }];\n    return this.addMcpFakes(sources, { kind: \"code\" });\n  }\n\n  addMcpFakes(blocks: McpFakeSource[], origin: McpFakeAddOrigin): McpFakeAddResult {\n    const result = this.fakes.add(blocks, origin);\n    this.fakeBlocks += blocks.length;\n    return result;\n  }\n\n  /**\n   * The blocks on this mount that apply to `testId` and `context` (spec 6.5,\n   * I9), with every entry id and its consumed state for that test id. `null`\n   * means \"none sent\". Read-only: the result is deeply frozen.\n   */\n  fakesSnapshot(\n    testId: string | null = null,\n    context: string | null = null,\n  ): readonly McpFakeBlockSnapshot[] {\n    return this.fakes.snapshot(testId, context);\n  }\n\n  clearMcpFakes(): void {\n    this.fakes.clear();\n    this.fakeBlocks = 0;\n  }\n\n  resetScenarioState(testId?: string): void {\n    this.fakes.resetState(testId);\n  }\n\n  setLogger(logger: Logger): void {\n    this.logger = logger;\n  }\n\n  // ---- Mountable interface ----\n\n  async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean> {\n    // Off the mount root: not this mount's request (fall through).\n    if (pathname !== \"/\" && pathname !== \"\") {\n      return false;\n    }\n    // B1: a GET on the mount root is 405. Any other method but POST and\n    // DELETE falls through to the next route, as on origin/main.\n    if (req.method === \"GET\") {\n      this.answerMethodNotAllowed(req, res);\n      return true;\n    }\n    if (!isServedMethod(req.method)) {\n      return false;\n    }\n    await this.serve(req, res, mountPathOf(req.url, pathname), false);\n    return true;\n  }\n\n  /**\n   * Serve one request, in both modes (mounted: a POST or DELETE on the mount\n   * root; standalone: any method but GET on any path): count it, run the\n   * handler, journal it. A throw from the mount's own code is logged with the\n   * identity resolved so far, answered 500 and journaled with its message,\n   * never left to a generic catch.\n   */\n  private async serve(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    mount: string,\n    standalone: boolean,\n  ): Promise<void> {\n    const record = newMCPRequestRecord();\n    try {\n      const body = await readBody(req);\n      this.countRequest(req, body);\n      await this.requestHandler(req, res, body, mount, record);\n      this.journalRequest(req, res, record);\n    } catch (err) {\n      const thrown = err instanceof Error ? err.message : String(err);\n      const who = record.identity\n        ? describeMcpIdentity(record.identity)\n        : msg`no identity resolved`;\n      const line = build(\n        msg`MCPMock request error (${who}, mount ${plainText(mount)}): ${plainText(thrown)}`,\n      );\n      // W5: the standalone server always prints the error, as on origin/main,\n      // even when the mount also has a server's (possibly silent) logger.\n      // Mounted, it goes to the server's logger, as origin/main's route error did.\n      if (standalone || !this.logger) console.error(line);\n      else this.logger.error(line);\n      if (!res.headersSent) {\n        res.writeHead(500);\n        res.end(\"Internal server error\");\n      } else if (!res.writableEnded) {\n        res.end();\n      }\n      this.journalRequest(req, res, record, thrown);\n    }\n  }\n\n  /** `aimock_mcp_requests_total` by JSON-RPC method (`session/delete` for DELETE). */\n  private countRequest(req: http.IncomingMessage, body: string): void {\n    if (this.registry) {\n      if (req.method === \"DELETE\") {\n        this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"session/delete\" });\n      } else {\n        try {\n          const parsed = JSON.parse(body);\n          const method =\n            typeof parsed === \"object\" && parsed !== null && \"method\" in parsed\n              ? String(parsed.method)\n              : \"unknown\";\n          this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method });\n        } catch {\n          this.registry.incrementCounter(\"aimock_mcp_requests_total\", { method: \"unknown\" });\n        }\n      }\n    }\n  }\n\n  /**\n   * B1: answer 405 (`Allow: POST, DELETE`), journaled. Mounted, this is a GET\n   * on the mount root; standalone, a GET on any path.\n   */\n  private answerMethodNotAllowed(req: http.IncomingMessage, res: http.ServerResponse): void {\n    res.writeHead(405, { \"Content-Type\": \"application/json\", Allow: \"POST, DELETE\" });\n    res.end(JSON.stringify({ error: build(msg`Method not allowed: use POST or DELETE`) }));\n    req.resume();\n    this.journalRequest(req, res, null);\n  }\n\n  health(): { status: string; [key: string]: unknown } {\n    return {\n      status: \"ok\",\n      tools: this.tools.size,\n      resources: this.resources.size,\n      prompts: this.prompts.size,\n      sessions: this.sessions.size,\n    };\n  }\n\n  setJournal(journal: Journal): void {\n    this.journal = journal;\n    // I5: the fakes' test-id cap follows the journal's (`0` = unbounded).\n    this.fakes.setMaxTestIds(journal.fixtureCountsMaxTestIdsCap);\n  }\n\n  setRegistry(registry: MetricsRegistry): void {\n    this.registry = registry;\n  }\n\n  // ---- Standalone mode ----\n\n  async start(): Promise<string> {\n    if (this.server) {\n      throw new Error(\"Server already started\");\n    }\n\n    const host = this.options.host ?? \"127.0.0.1\";\n    const port = this.options.port ?? 0;\n\n    return new Promise((resolve, reject) => {\n      // The standalone server serves every path, as it always has: every\n      // method but GET goes to the MCP handler on any path. B1: a GET on any\n      // path is 405 (`Allow: POST, DELETE`) and journaled, so the SDK's\n      // optional GET SSE stream is declined, not mishandled.\n      const srv = http.createServer((req, res) => {\n        if (req.method === \"GET\") {\n          this.answerMethodNotAllowed(req, res);\n          return;\n        }\n        // serve() catches the request's own errors; this is only a logger\n        // that threw while reporting one.\n        this.serve(req, res, \"/\", true).catch((err: unknown) => {\n          console.error(\"MCPMock request error:\", err);\n          if (!res.writableEnded) res.end();\n        });\n      });\n\n      srv.listen(port, host, () => {\n        this.server = srv;\n        const addr = srv.address();\n        if (typeof addr === \"object\" && addr !== null) {\n          resolve(`http://${host}:${addr.port}`);\n        } else {\n          resolve(`http://${host}:${port}`);\n        }\n      });\n\n      srv.on(\"error\", reject);\n    });\n  }\n\n  async stop(): Promise<void> {\n    if (!this.server) {\n      throw new Error(\"Server not started\");\n    }\n    const srv = this.server;\n    this.server = null;\n    await new Promise<void>((resolve, reject) => {\n      srv.close((err) => (err ? reject(err) : resolve()));\n    });\n  }\n\n  // ---- Inspection ----\n\n  getRequests(): unknown[] {\n    if (!this.journal) return [];\n    return this.journal.getAll().filter((e) => e.service === \"mcp\");\n  }\n\n  getSessions(): Map<string, MCPSession> {\n    return new Map(this.sessions);\n  }\n\n  reset(): this {\n    this.tools.clear();\n    this.resources.clear();\n    this.prompts.clear();\n    this.sessions.clear();\n    this.decodeWarned.clear();\n    // R8: fakes and their consumption state go; the id counters stay.\n    this.clearMcpFakes();\n    this.requestHandler = this.buildHandler();\n    return this;\n  }\n\n  // ---- Internal ----\n\n  /**\n   * The journal entries of one handled request (B2, B3): one per JSON-RPC\n   * message (each element of a batch), or one with no body when the request\n   * carried none that was read; none without a journal (W5). `error` is what\n   * the mount's own code threw while serving it.\n   */\n  private journalRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    record: MCPRequestRecord | null,\n    error?: string,\n  ): void {\n    if (!this.journal) return;\n    const messages: MCPMessageRecord[] = record?.messages.length\n      ? record.messages\n      : [{ body: null, mcpFake: null, error: null }];\n    for (const message of messages) {\n      const failed = message.error ?? error;\n      this.journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/\",\n        headers: flattenHeaders(req.headers),\n        body: message.body,\n        service: \"mcp\",\n        ...(record?.identity\n          ? {\n              testId: record.identity.testId ?? MCP_FAKES_DEFAULT_TEST_ID,\n              context: record.identity.context,\n            }\n          : {}),\n        response: {\n          status: res.statusCode,\n          fixture: null,\n          ...(message.mcpFake ? { mcpFake: message.mcpFake } : {}),\n          ...(failed !== undefined && failed !== null ? { error: failed } : {}),\n        },\n      });\n    }\n  }\n\n  /**\n   * Side channels of a fake outcome (9.3): the failure metric and the L1 /\n   * L10 line. A claim that threw (`internal_error`) is counted and logged\n   * like a failure, under `MCP_FAKE_INTERNAL_ERROR`.\n   */\n  private onFakeEvent(evt: McpFakeEvent): void {\n    if (evt.kind === \"answered\") return;\n    this.registry?.incrementCounter(\"aimock_mcp_fake_failures_total\", { code: evt.code });\n    if (!this.logger) return;\n    const where = msg`mount ${plainText(evt.mount)}`;\n    // \"not declared\", \"internal error\"; the other kinds are one word.\n    const kind = evt.kind.replace(\"_\", \" \");\n    const line =\n      evt.kind === \"evicted\"\n        ? msg`MCP-FAKE: evicted testId ${quote(evt.testId)} (cap ${evt.cap}) for tools/call ${plainText(evt.tool)} (${where})`\n        : msg`MCP-FAKE: ${fixed(kind)} for tools/call ${plainText(evt.tool)} (${describeMcpIdentity(evt.identity)}, ${where}): ${plainText(evt.message)}`;\n    this.logger.error(build(line));\n  }\n\n  /**\n   * L2: one warning per session for each identity field and source whose\n   * value is not valid percent-encoding (H1), naming that source and value,\n   * and one for query names that are not valid percent-encoding.\n   */\n  private onDecodeFallback(sessionId: string, fallback: McpDecodeFallback): void {\n    let warned = this.decodeWarned.get(sessionId);\n    if (!warned) {\n      warned = new Set();\n      this.decodeWarned.set(sessionId, warned);\n    }\n    const key = fallback.kind === \"names\" ? \"names\" : `${fallback.field}:${fallback.source}`;\n    if (warned.has(key)) return;\n    warned.add(key);\n    const session = quote(sessionId);\n    if (fallback.kind === \"names\") {\n      const one = fallback.count === 1;\n      this.logger?.warn(\n        build(\n          msg`MCP-FAKE: ${fallback.count} query parameter ${fixed(one ? \"name\" : \"names\")} on session ${session} ${fixed(one ? \"is\" : \"are\")} not valid percent-encoding; ${fixed(one ? \"it matches\" : \"they match\")} no identity field`,\n        ),\n      );\n      return;\n    }\n    const label = DECODE_LABELS[fallback.field][fallback.source];\n    const fate = fallback.used ? \"it is used as sent\" : \"it is ignored (the header value is used)\";\n    this.logger?.warn(\n      build(\n        msg`MCP-FAKE: ${fixed(label)} value ${quote(fallback.raw)} on session ${session} is not valid percent-encoding; ${fixed(fate)}`,\n      ),\n    );\n  }\n\n  private buildHandler() {\n    const state: MCPState = {\n      serverInfo: this.options.serverInfo ?? { name: \"mcp-mock\", version: \"1.0.0\" },\n      tools: this.tools,\n      resources: this.resources,\n      prompts: this.prompts,\n      sessions: this.sessions,\n      fakes: this.fakes,\n      hasFakes: () => this.fakeBlocks > 0,\n      onFakeEvent: (evt) => this.onFakeEvent(evt),\n      onDecodeFallback: (sessionId, fallback) => this.onDecodeFallback(sessionId, fallback),\n      onSessionClosed: (sessionId) => void this.decodeWarned.delete(sessionId),\n    };\n    return createMCPRequestHandler(state);\n  }\n}\n\n/** B1: the only methods the mounted mount root serves; every other one is 405. */\nfunction isServedMethod(method: string | undefined): boolean {\n  return method === \"POST\" || method === \"DELETE\";\n}\n\n/** The L2 label of each identity field's header and query source. */\nconst DECODE_LABELS = {\n  testId: { header: \"X-Test-Id header\", query: \"?testId= query parameter\" },\n  context: { header: \"X-AIMock-Context header\", query: \"?context= query parameter\" },\n} as const;\n\n/**\n * The path a mount is served at (I9): the request path without the\n * sub-path the server handed the mount (`/mcp` for `/mcp` or `/mcp/`), `/`\n * at the root.\n */\nfunction mountPathOf(url: string | undefined, subPath: string): string {\n  const full = new URL(url ?? \"/\", \"http://mount.invalid\").pathname;\n  const sub = subPath === \"\" ? \"/\" : subPath;\n  const mount = full.endsWith(sub) ? full.slice(0, full.length - sub.length) : full;\n  return mount === \"\" ? \"/\" : mount;\n}\n"],"mappings":"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"}

package/dist/mcp-mock.d.cts

@@ -1,6 +1,8 @@
 import { Journal } from "./journal.cjs";
+import { Logger } from "./logger.cjs";
 import { MetricsRegistry } from "./metrics.cjs";
-import { Mountable } from "./types.cjs";
+import { McpFakeAddOrigin, McpFakeAddResult, McpFakeBlockSnapshot } from "./mcp-fakes.cjs";
+import { McpFakeSource, Mountable } from "./types.cjs";
 import { MCPContent, MCPMockOptions, MCPPromptDefinition, MCPPromptResult, MCPResourceContent, MCPResourceDefinition, MCPSession, MCPToolDefinition } from "./mcp-types.cjs";
 import * as http$1 from "node:http";
 
@@ -10,9 +12,21 @@ declare class MCPMock implements Mountable {
   private resources;
   private prompts;
   private sessions;
+  /** This mount's fakes; kept across `reset()` so the id counters are never rewound. */
+  private fakes;
+  /** Fake blocks loaded since the last clear. */
+  private fakeBlocks;
+  /**
+   * Decode fallbacks already reported (L2), per live session: one key per
+   * field and source, plus one for undecodable query names. Dropped when the
+   * session is deleted.
+   */
+  private decodeWarned;
   private server;
   private journal;
   private registry;
+  /** Mount logger for L1, L2 and L10; none (lines dropped) until `setLogger`. */
+  private logger;
   private options;
   private requestHandler;
   constructor(options?: MCPMockOptions);
@@ -20,7 +34,39 @@ declare class MCPMock implements Mountable {
   onToolCall(name: string, handler: (args: unknown) => MCPContent[] | string | Promise<MCPContent[] | string>): this;
   addResource(def: MCPResourceDefinition, content?: MCPResourceContent): this;
   addPrompt(def: MCPPromptDefinition, handler?: (args: unknown) => MCPPromptResult | Promise<MCPPromptResult>): this;
+  /**
+   * Load MCP fakes from code: one `mcpFakes` value (a block, or an array of
+   * blocks), in the fixture-file shape, validated here. One run-time addition
+   * (`code#<n>` entry ids). Always appends. Returns the shadowed-entry
+   * warnings; on any bad block throws one `McpFakesAddError` and adds nothing.
+   */
+  loadFakes(blocks: unknown): McpFakeAddResult;
+  addMcpFakes(blocks: McpFakeSource[], origin: McpFakeAddOrigin): McpFakeAddResult;
+  /**
+   * The blocks on this mount that apply to `testId` and `context` (spec 6.5,
+   * I9), with every entry id and its consumed state for that test id. `null`
+   * means "none sent". Read-only: the result is deeply frozen.
+   */
+  fakesSnapshot(testId?: string | null, context?: string | null): readonly McpFakeBlockSnapshot[];
+  clearMcpFakes(): void;
+  resetScenarioState(testId?: string): void;
+  setLogger(logger: Logger): void;
   handleRequest(req: http$1.IncomingMessage, res: http$1.ServerResponse, pathname: string): Promise<boolean>;
+  /**
+   * Serve one request, in both modes (mounted: a POST or DELETE on the mount
+   * root; standalone: any method but GET on any path): count it, run the
+   * handler, journal it. A throw from the mount's own code is logged with the
+   * identity resolved so far, answered 500 and journaled with its message,
+   * never left to a generic catch.
+   */
+  private serve;
+  /** `aimock_mcp_requests_total` by JSON-RPC method (`session/delete` for DELETE). */
+  private countRequest;
+  /**
+   * B1: answer 405 (`Allow: POST, DELETE`), journaled. Mounted, this is a GET
+   * on the mount root; standalone, a GET on any path.
+   */
+  private answerMethodNotAllowed;
   health(): {
     status: string;
     [key: string]: unknown;
@@ -32,6 +78,25 @@ declare class MCPMock implements Mountable {
   getRequests(): unknown[];
   getSessions(): Map<string, MCPSession>;
   reset(): this;
+  /**
+   * The journal entries of one handled request (B2, B3): one per JSON-RPC
+   * message (each element of a batch), or one with no body when the request
+   * carried none that was read; none without a journal (W5). `error` is what
+   * the mount's own code threw while serving it.
+   */
+  private journalRequest;
+  /**
+   * Side channels of a fake outcome (9.3): the failure metric and the L1 /
+   * L10 line. A claim that threw (`internal_error`) is counted and logged
+   * like a failure, under `MCP_FAKE_INTERNAL_ERROR`.
+   */
+  private onFakeEvent;
+  /**
+   * L2: one warning per session for each identity field and source whose
+   * value is not valid percent-encoding (H1), naming that source and value,
+   * and one for query names that are not valid percent-encoding.
+   */
+  private onDecodeFallback;
   private buildHandler;
 }
 //# sourceMappingURL=mcp-mock.d.ts.map

package/dist/mcp-mock.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-mock.d.cts","names":[],"sources":["../src/mcp-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;cAiBa,OAAA,YAAmB;;EAAnB,QAAA,SAAQ;EAAA,QAAA,OAAA;UAqBG,QAAA;UAOT,MAAA;UAOiB,OAAA;UAAgC,QAAA;UAAR,OAAA;UAarC,cAAA;aAAiC,CAAA,OAAA,CAAA,EA3B5B,cA2B4B;SAQ3C,CAAA,GAAA,EA5BM,iBA4BN,CAAA,EAAA,IAAA;YACwB,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAtBD,UAsBC,EAAA,GAAA,MAAA,GAtBuB,OAsBvB,CAtB+B,UAsB/B,EAAA,GAAA,MAAA,CAAA,CAAA,EAAA,IAAA;aAA0B,CAAA,GAAA,EATxC,qBASwC,EAAA,OAAA,CAAA,EATP,kBASO,CAAA,EAAA,IAAA;WAAR,CAAA,GAAA,EAD1C,mBAC0C,EAAA,OAAA,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAlB,eAAkB,GAAA,OAAA,CAAQ,eAAR,CAAA,CAAA,EAAA,IAAA;eASrC,CAAA,GAAA,EAAL,MAAA,CAAK,eAAA,EAAA,GAAA,EACL,MAAA,CAAK,cADA,EAAA,QAAA,EAAA,MAAA,CAAA,EAGT,OAHS,CAAA,OAAA,CAAA;QACL,CAAA,CAAA,EAAK;IAET,MAAA,EAAA,MAAA;IAwDiB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;YAUL,CAAA,OAAA,EAVK,OAUL,CAAA,EAAA,IAAA;aAgED,CAAA,QAAA,EAtEQ,eAsER,CAAA,EAAA,IAAA;OAkBa,CAAA,CAAA,EAlFZ,OAkFY,CAAA,MAAA,CAAA;MAAZ,CAAA,CAAA,EAlBD,OAkBC,CAAA,IAAA,CAAA;aAzNe,CAAA,CAAA,EAAA,OAAA,EAAA;EAAS,WAAA,CAAA,CAAA,EAyNxB,GAzNwB,CAAA,MAAA,EAyNZ,UAzNY,CAAA"}
+{"version":3,"file":"mcp-mock.d.cts","names":[],"sources":["../src/mcp-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAmCa,OAAA,YAAmB;;EAAnB,QAAA,SAAQ;EAAA,QAAA,OAAA;UAiCG,QAAA;;UAcQ,KAAA;;UAAwB,UAAA;;;;;;UAsBL,YAAA;UAcrB,MAAA;UAOR,OAAA;UAAyB,QAAA;;UAcjC,MAAA;UAaM,OAAA;UAOX,cAAK;aACA,CAAA,OAAA,CAAA,EA5FU,cA4FV;SAET,CAAA,GAAA,EAvFU,iBAuFV,CAAA,EAAA,IAAA;YAqGiB,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GArLU,UAqLV,EAAA,GAAA,MAAA,GArLkC,OAqLlC,CArL0C,UAqL1C,EAAA,GAAA,MAAA,CAAA,CAAA,EAAA,IAAA;aAME,CAAA,GAAA,EA9KL,qBA8KK,EAAA,OAAA,CAAA,EA9K4B,kBA8K5B,CAAA,EAAA,IAAA;WAMP,CAAA,GAAA,EA5KR,mBA4KQ,EAAA,OAAA,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GA3KgB,eA2KhB,GA3KkC,OA2KlC,CA3K0C,eA2K1C,CAAA,CAAA,EAAA,IAAA;;;;;;;8BA7Ja;sBAOR,yBAAyB,mBAAmB;;;;;;2EAcpD;;;oBAaM;qBAOX,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;;;;;;;;;;;;;;;;sBAqGiB;wBAME;WAMP;UAwCD;;iBAkBC,YAAY"}

package/dist/mcp-mock.d.ts

@@ -1,6 +1,8 @@
 import { Journal } from "./journal.js";
+import { Logger } from "./logger.js";
 import { MetricsRegistry } from "./metrics.js";
-import { Mountable } from "./types.js";
+import { McpFakeAddOrigin, McpFakeAddResult, McpFakeBlockSnapshot } from "./mcp-fakes.js";
+import { McpFakeSource, Mountable } from "./types.js";
 import { MCPContent, MCPMockOptions, MCPPromptDefinition, MCPPromptResult, MCPResourceContent, MCPResourceDefinition, MCPSession, MCPToolDefinition } from "./mcp-types.js";
 import * as http$1 from "node:http";
 
@@ -10,9 +12,21 @@ declare class MCPMock implements Mountable {
   private resources;
   private prompts;
   private sessions;
+  /** This mount's fakes; kept across `reset()` so the id counters are never rewound. */
+  private fakes;
+  /** Fake blocks loaded since the last clear. */
+  private fakeBlocks;
+  /**
+   * Decode fallbacks already reported (L2), per live session: one key per
+   * field and source, plus one for undecodable query names. Dropped when the
+   * session is deleted.
+   */
+  private decodeWarned;
   private server;
   private journal;
   private registry;
+  /** Mount logger for L1, L2 and L10; none (lines dropped) until `setLogger`. */
+  private logger;
   private options;
   private requestHandler;
   constructor(options?: MCPMockOptions);
@@ -20,7 +34,39 @@ declare class MCPMock implements Mountable {
   onToolCall(name: string, handler: (args: unknown) => MCPContent[] | string | Promise<MCPContent[] | string>): this;
   addResource(def: MCPResourceDefinition, content?: MCPResourceContent): this;
   addPrompt(def: MCPPromptDefinition, handler?: (args: unknown) => MCPPromptResult | Promise<MCPPromptResult>): this;
+  /**
+   * Load MCP fakes from code: one `mcpFakes` value (a block, or an array of
+   * blocks), in the fixture-file shape, validated here. One run-time addition
+   * (`code#<n>` entry ids). Always appends. Returns the shadowed-entry
+   * warnings; on any bad block throws one `McpFakesAddError` and adds nothing.
+   */
+  loadFakes(blocks: unknown): McpFakeAddResult;
+  addMcpFakes(blocks: McpFakeSource[], origin: McpFakeAddOrigin): McpFakeAddResult;
+  /**
+   * The blocks on this mount that apply to `testId` and `context` (spec 6.5,
+   * I9), with every entry id and its consumed state for that test id. `null`
+   * means "none sent". Read-only: the result is deeply frozen.
+   */
+  fakesSnapshot(testId?: string | null, context?: string | null): readonly McpFakeBlockSnapshot[];
+  clearMcpFakes(): void;
+  resetScenarioState(testId?: string): void;
+  setLogger(logger: Logger): void;
   handleRequest(req: http$1.IncomingMessage, res: http$1.ServerResponse, pathname: string): Promise<boolean>;
+  /**
+   * Serve one request, in both modes (mounted: a POST or DELETE on the mount
+   * root; standalone: any method but GET on any path): count it, run the
+   * handler, journal it. A throw from the mount's own code is logged with the
+   * identity resolved so far, answered 500 and journaled with its message,
+   * never left to a generic catch.
+   */
+  private serve;
+  /** `aimock_mcp_requests_total` by JSON-RPC method (`session/delete` for DELETE). */
+  private countRequest;
+  /**
+   * B1: answer 405 (`Allow: POST, DELETE`), journaled. Mounted, this is a GET
+   * on the mount root; standalone, a GET on any path.
+   */
+  private answerMethodNotAllowed;
   health(): {
     status: string;
     [key: string]: unknown;
@@ -32,6 +78,25 @@ declare class MCPMock implements Mountable {
   getRequests(): unknown[];
   getSessions(): Map<string, MCPSession>;
   reset(): this;
+  /**
+   * The journal entries of one handled request (B2, B3): one per JSON-RPC
+   * message (each element of a batch), or one with no body when the request
+   * carried none that was read; none without a journal (W5). `error` is what
+   * the mount's own code threw while serving it.
+   */
+  private journalRequest;
+  /**
+   * Side channels of a fake outcome (9.3): the failure metric and the L1 /
+   * L10 line. A claim that threw (`internal_error`) is counted and logged
+   * like a failure, under `MCP_FAKE_INTERNAL_ERROR`.
+   */
+  private onFakeEvent;
+  /**
+   * L2: one warning per session for each identity field and source whose
+   * value is not valid percent-encoding (H1), naming that source and value,
+   * and one for query names that are not valid percent-encoding.
+   */
+  private onDecodeFallback;
   private buildHandler;
 }
 //# sourceMappingURL=mcp-mock.d.ts.map

package/dist/mcp-mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-mock.d.ts","names":[],"sources":["../src/mcp-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;cAiBa,OAAA,YAAmB;;EAAnB,QAAA,SAAQ;EAAA,QAAA,OAAA;UAqBG,QAAA;UAOT,MAAA;UAOiB,OAAA;UAAgC,QAAA;UAAR,OAAA;UAarC,cAAA;aAAiC,CAAA,OAAA,CAAA,EA3B5B,cA2B4B;SAQ3C,CAAA,GAAA,EA5BM,iBA4BN,CAAA,EAAA,IAAA;YACwB,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAtBD,UAsBC,EAAA,GAAA,MAAA,GAtBuB,OAsBvB,CAtB+B,UAsB/B,EAAA,GAAA,MAAA,CAAA,CAAA,EAAA,IAAA;aAA0B,CAAA,GAAA,EATxC,qBASwC,EAAA,OAAA,CAAA,EATP,kBASO,CAAA,EAAA,IAAA;WAAR,CAAA,GAAA,EAD1C,mBAC0C,EAAA,OAAA,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAlB,eAAkB,GAAA,OAAA,CAAQ,eAAR,CAAA,CAAA,EAAA,IAAA;eASrC,CAAA,GAAA,EAAL,MAAA,CAAK,eAAA,EAAA,GAAA,EACL,MAAA,CAAK,cADA,EAAA,QAAA,EAAA,MAAA,CAAA,EAGT,OAHS,CAAA,OAAA,CAAA;QACL,CAAA,CAAA,EAAK;IAET,MAAA,EAAA,MAAA;IAwDiB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;YAUL,CAAA,OAAA,EAVK,OAUL,CAAA,EAAA,IAAA;aAgED,CAAA,QAAA,EAtEQ,eAsER,CAAA,EAAA,IAAA;OAkBa,CAAA,CAAA,EAlFZ,OAkFY,CAAA,MAAA,CAAA;MAAZ,CAAA,CAAA,EAlBD,OAkBC,CAAA,IAAA,CAAA;aAzNe,CAAA,CAAA,EAAA,OAAA,EAAA;EAAS,WAAA,CAAA,CAAA,EAyNxB,GAzNwB,CAAA,MAAA,EAyNZ,UAzNY,CAAA"}
+{"version":3,"file":"mcp-mock.d.ts","names":[],"sources":["../src/mcp-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAmCa,OAAA,YAAmB;;EAAnB,QAAA,SAAQ;EAAA,QAAA,OAAA;UAiCG,QAAA;;UAcQ,KAAA;;UAAwB,UAAA;;;;;;UAsBL,YAAA;UAcrB,MAAA;UAOR,OAAA;UAAyB,QAAA;;UAcjC,MAAA;UAaM,OAAA;UAOX,cAAK;aACA,CAAA,OAAA,CAAA,EA5FU,cA4FV;SAET,CAAA,GAAA,EAvFU,iBAuFV,CAAA,EAAA,IAAA;YAqGiB,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GArLU,UAqLV,EAAA,GAAA,MAAA,GArLkC,OAqLlC,CArL0C,UAqL1C,EAAA,GAAA,MAAA,CAAA,CAAA,EAAA,IAAA;aAME,CAAA,GAAA,EA9KL,qBA8KK,EAAA,OAAA,CAAA,EA9K4B,kBA8K5B,CAAA,EAAA,IAAA;WAMP,CAAA,GAAA,EA5KR,mBA4KQ,EAAA,OAAA,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GA3KgB,eA2KhB,GA3KkC,OA2KlC,CA3K0C,eA2K1C,CAAA,CAAA,EAAA,IAAA;;;;;;;8BA7Ja;sBAOR,yBAAyB,mBAAmB;;;;;;2EAcpD;;;oBAaM;qBAOX,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;;;;;;;;;;;;;;;;sBAqGiB;wBAME;WAMP;UAwCD;;iBAkBC,YAAY"}