@copilotkit/aimock 1.43.0 → 1.45.0

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","mcpRecordEnv","McpRecorder","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, McpRecordConfig, 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 McpFakeAddOriginInternal,\n  type McpFakeAddResult,\n  type McpFakeBlockSnapshot,\n  type McpFakeReportEventInput,\n  type McpFakeReportPart,\n} from \"./mcp-fakes.js\";\nimport { build, fixed, msg, plainText, quote } from \"./message-text.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\nimport { McpRecorder, mcpRecordEnv, type RecorderHost } from \"./mcp-recorder.js\";\nimport { validateSecretValues } from \"./record-sanitize.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  /** T1: recorded timing (`durationMs`, `atMs`) plays at value / speed. */\n  private replaySpeed = 1;\n  /** MR1: the recorder while recording is on, else null (AM1). */\n  private recorder: McpRecorder | 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    return this.addFakes(blocks, origin);\n  }\n\n  /** `addMcpFakes`, plus the internal `record` origin of the MCP recorder. */\n  private addFakes(blocks: McpFakeSource[], origin: McpFakeAddOriginInternal): 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    this.recorder?.reset();\n  }\n\n  resetScenarioState(testId?: string): void {\n    this.fakes.resetState(testId);\n    this.recorder?.reset(testId);\n  }\n\n  // ---- MCP recording (MR1) ----\n\n  /**\n   * Record a real upstream MCP server (MR1): from now on every request to\n   * this mount is forwarded to `config.upstream` (all paths and methods), a\n   * fake that applies still answers locally, and each forwarded `tools/list`\n   * and `tools/call` is written to an `mcpFakes` file under\n   * `config.fixturePath`. `secretValues` and `upstreamAuth` that are\n   * `undefined` come from `AIMOCK_RECORD_SECRET_VALUES` and\n   * `AIMOCK_MCP_UPSTREAM_AUTH`, as on the CLI and config paths. Throws on an\n   * invalid upstream URL, a malformed `upstreamAuth` (or env auth), or a\n   * `secretValues` entry shorter than 8 characters.\n   */\n  enableRecording(config: McpRecordConfig): this {\n    let resolved = config;\n    if (config.secretValues === undefined || config.upstreamAuth === undefined) {\n      const fromEnv = mcpRecordEnv(process.env);\n      resolved = {\n        ...config,\n        secretValues: config.secretValues ?? fromEnv.secretValues,\n        upstreamAuth: config.upstreamAuth ?? fromEnv.upstreamAuth,\n      };\n    }\n    validateSecretValues(resolved.secretValues ?? []);\n    const recorder = new McpRecorder(this.recorderHost(), resolved);\n    this.recorder?.close();\n    this.recorder = recorder;\n    return this;\n  }\n\n  /** Stop recording: the mount serves exactly as before `enableRecording`. */\n  disableRecording(): this {\n    this.recorder?.close();\n    this.recorder = null;\n    return this;\n  }\n\n  /** @internal MR13: the recorder's write hashes and write listener, or null when not recording. */\n  recorderEvents(): Pick<McpRecorder, \"lastWrittenHash\" | \"onWrite\"> | null {\n    return this.recorder;\n  }\n\n  setLogger(logger: Logger): void {\n    this.logger = logger;\n  }\n\n  /** T1: the speed recorded fake timing plays at; a non-positive or non-finite value is ignored. */\n  setReplaySpeed(speed: number): void {\n    if (Number.isFinite(speed) && speed > 0) this.replaySpeed = speed;\n  }\n\n  /** @internal RP2 report part for this mount (src/mcp-fakes-report.ts reads it). */\n  fakesReportPart(testId: string | null, context: string | null, mount: string): McpFakeReportPart {\n    return this.fakes.reportPart(testId, context, mount);\n  }\n\n  // ---- Mountable interface ----\n\n  async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean> {\n    // AM1 (a): in record mode every path and method under the mount is the\n    // recorder's, before the off-root check and the B1 GET answer.\n    if (this.recorder) {\n      await this.recorder.handle(req, res, mountPathOf(req.url, pathname), pathname);\n      return true;\n    }\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        // AM1 (b): in record mode the recorder takes every request first. A\n        // standalone server serves every path as its root, so every request\n        // maps to the upstream endpoint itself (review r2 N3).\n        if (this.recorder) {\n          this.recorder.handle(req, res, \"/\", \"/\").catch((err: unknown) => {\n            console.error(\"MCPMock request error:\", err);\n            if (!res.writableEnded) res.end();\n          });\n          return;\n        }\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    // RP2, C9: every fake outcome goes to the event log.\n    this.fakes.logEvent(evt.identity, toReportEvent(evt));\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  /** RP2, C9: a tools/call no fake applied to is always logged, with who answered it. */\n  private logUnfaked(evt: Parameters<MCPState[\"onUnfaked\"]>[0]): void {\n    this.fakes.logEvent(evt.identity, {\n      outcome: \"unfaked\",\n      answeredBy: evt.answeredBy,\n      tool: evt.tool,\n      args: evt.args,\n      context: evt.identity.context,\n      mount: evt.mount,\n    });\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  /** The recorder's view of this mount (fakes, journal, logger, replay speed, side channels). */\n  private recorderHost(): RecorderHost {\n    const fakes = this.fakes;\n    return {\n      fakes,\n      addMcpFakes: (blocks, origin) => this.addFakes(blocks, origin),\n      journalEntry: (entry) => void this.journal?.add(entry),\n      logger: () => this.logger,\n      replaySpeed: () => this.replaySpeed,\n      onFakeEvent: (evt) => this.onFakeEvent(evt),\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      onUnfaked: (evt) => this.logUnfaked(evt),\n      replaySpeed: () => this.replaySpeed,\n    };\n    return createMCPRequestHandler(state);\n  }\n}\n\n/** RP2: a fake outcome as an event-log entry (the store assigns `seq`). */\nfunction toReportEvent(evt: McpFakeEvent): McpFakeReportEventInput {\n  const base = { tool: evt.tool, args: evt.args, context: evt.identity.context, mount: evt.mount };\n  return evt.kind === \"answered\"\n    ? { ...base, outcome: \"answered\", entryId: evt.entryId }\n    : { ...base, outcome: evt.kind, code: evt.code };\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,7 +1,10 @@
 import { Journal } from "./journal.cjs";
+import { Logger } from "./logger.cjs";
 import { MetricsRegistry } from "./metrics.cjs";
-import { Mountable } from "./types.cjs";
+import { McpFakeAddOrigin, McpFakeAddResult, McpFakeBlockSnapshot, McpFakeReportPart } from "./mcp-fakes.cjs";
+import { McpFakeSource, McpRecordConfig, Mountable } from "./types.cjs";
 import { MCPContent, MCPMockOptions, MCPPromptDefinition, MCPPromptResult, MCPResourceContent, MCPResourceDefinition, MCPSession, MCPToolDefinition } from "./mcp-types.cjs";
+import { McpRecorder } from "./mcp-recorder.cjs";
 import * as http$1 from "node:http";
 
 //#region src/mcp-mock.d.ts
@@ -10,9 +13,25 @@ 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;
+  /** T1: recorded timing (`durationMs`, `atMs`) plays at value / speed. */
+  private replaySpeed;
+  /** MR1: the recorder while recording is on, else null (AM1). */
+  private recorder;
   private options;
   private requestHandler;
   constructor(options?: MCPMockOptions);
@@ -20,7 +39,61 @@ 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;
+  /** `addMcpFakes`, plus the internal `record` origin of the MCP recorder. */
+  private addFakes;
+  /**
+   * 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;
+  /**
+   * Record a real upstream MCP server (MR1): from now on every request to
+   * this mount is forwarded to `config.upstream` (all paths and methods), a
+   * fake that applies still answers locally, and each forwarded `tools/list`
+   * and `tools/call` is written to an `mcpFakes` file under
+   * `config.fixturePath`. `secretValues` and `upstreamAuth` that are
+   * `undefined` come from `AIMOCK_RECORD_SECRET_VALUES` and
+   * `AIMOCK_MCP_UPSTREAM_AUTH`, as on the CLI and config paths. Throws on an
+   * invalid upstream URL, a malformed `upstreamAuth` (or env auth), or a
+   * `secretValues` entry shorter than 8 characters.
+   */
+  enableRecording(config: McpRecordConfig): this;
+  /** Stop recording: the mount serves exactly as before `enableRecording`. */
+  disableRecording(): this;
+  /** @internal MR13: the recorder's write hashes and write listener, or null when not recording. */
+  recorderEvents(): Pick<McpRecorder, "lastWrittenHash" | "onWrite"> | null;
+  setLogger(logger: Logger): void;
+  /** T1: the speed recorded fake timing plays at; a non-positive or non-finite value is ignored. */
+  setReplaySpeed(speed: number): void;
+  /** @internal RP2 report part for this mount (src/mcp-fakes-report.ts reads it). */
+  fakesReportPart(testId: string | null, context: string | null, mount: string): McpFakeReportPart;
   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 +105,29 @@ 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;
+  /** RP2, C9: a tools/call no fake applied to is always logged, with who answered it. */
+  private logUnfaked;
+  /**
+   * 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;
+  /** The recorder's view of this mount (fakes, journal, logger, replay speed, side channels). */
+  private recorderHost;
   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":";;;;;;;;;;cAwCa,OAAA,YAAmB;;EAAnB,QAAA,SAAQ;EAAA,QAAA,OAAA;UAqCG,QAAA;;UAcQ,KAAA;;UAAwB,UAAA;;;;;;UAsBL,YAAA;UAcrB,MAAA;UAOR,OAAA;UAAyB,QAAA;;UAmBjC,MAAA;;UAqDW,WAAA;;UAIL,QAAA;UAU6D,OAAA;UAOxE,cAAK;aACA,CAAA,OAAA,CAAA,EAvJU,cAuJV;SAET,CAAA,GAAA,EAlJU,iBAkJV,CAAA,EAAA,IAAA;YA2GiB,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAtPU,UAsPV,EAAA,GAAA,MAAA,GAtPkC,OAsPlC,CAtP0C,UAsP1C,EAAA,GAAA,MAAA,CAAA,CAAA,EAAA,IAAA;aAME,CAAA,GAAA,EA/OL,qBA+OK,EAAA,OAAA,CAAA,EA/O4B,kBA+O5B,CAAA,EAAA,IAAA;WAMP,CAAA,GAAA,EA7OR,mBA6OQ,EAAA,OAAA,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GA5OgB,eA4OhB,GA5OkC,OA4OlC,CA5O0C,eA4O1C,CAAA,CAAA,EAAA,IAAA;;;;;;;8BA9Na;sBAOR,yBAAyB,mBAAmB;;;;;;;;2EAmBpD;;;;;;;;;;;;;;0BA4BY;;;;oBAyBN,KAAK;oBAIL;;;;iFAU6D;qBAOxE,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;;;;;;;;;;;;;;;;sBA2GiB;wBAME;WAMP;UAkDD;;iBAkBC,YAAY"}

package/dist/mcp-mock.d.ts

@@ -1,7 +1,10 @@
 import { Journal } from "./journal.js";
+import { Logger } from "./logger.js";
 import { MetricsRegistry } from "./metrics.js";
-import { Mountable } from "./types.js";
+import { McpFakeAddOrigin, McpFakeAddResult, McpFakeBlockSnapshot, McpFakeReportPart } from "./mcp-fakes.js";
+import { McpFakeSource, McpRecordConfig, Mountable } from "./types.js";
 import { MCPContent, MCPMockOptions, MCPPromptDefinition, MCPPromptResult, MCPResourceContent, MCPResourceDefinition, MCPSession, MCPToolDefinition } from "./mcp-types.js";
+import { McpRecorder } from "./mcp-recorder.js";
 import * as http$1 from "node:http";
 
 //#region src/mcp-mock.d.ts
@@ -10,9 +13,25 @@ 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;
+  /** T1: recorded timing (`durationMs`, `atMs`) plays at value / speed. */
+  private replaySpeed;
+  /** MR1: the recorder while recording is on, else null (AM1). */
+  private recorder;
   private options;
   private requestHandler;
   constructor(options?: MCPMockOptions);
@@ -20,7 +39,61 @@ 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;
+  /** `addMcpFakes`, plus the internal `record` origin of the MCP recorder. */
+  private addFakes;
+  /**
+   * 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;
+  /**
+   * Record a real upstream MCP server (MR1): from now on every request to
+   * this mount is forwarded to `config.upstream` (all paths and methods), a
+   * fake that applies still answers locally, and each forwarded `tools/list`
+   * and `tools/call` is written to an `mcpFakes` file under
+   * `config.fixturePath`. `secretValues` and `upstreamAuth` that are
+   * `undefined` come from `AIMOCK_RECORD_SECRET_VALUES` and
+   * `AIMOCK_MCP_UPSTREAM_AUTH`, as on the CLI and config paths. Throws on an
+   * invalid upstream URL, a malformed `upstreamAuth` (or env auth), or a
+   * `secretValues` entry shorter than 8 characters.
+   */
+  enableRecording(config: McpRecordConfig): this;
+  /** Stop recording: the mount serves exactly as before `enableRecording`. */
+  disableRecording(): this;
+  /** @internal MR13: the recorder's write hashes and write listener, or null when not recording. */
+  recorderEvents(): Pick<McpRecorder, "lastWrittenHash" | "onWrite"> | null;
+  setLogger(logger: Logger): void;
+  /** T1: the speed recorded fake timing plays at; a non-positive or non-finite value is ignored. */
+  setReplaySpeed(speed: number): void;
+  /** @internal RP2 report part for this mount (src/mcp-fakes-report.ts reads it). */
+  fakesReportPart(testId: string | null, context: string | null, mount: string): McpFakeReportPart;
   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 +105,29 @@ 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;
+  /** RP2, C9: a tools/call no fake applied to is always logged, with who answered it. */
+  private logUnfaked;
+  /**
+   * 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;
+  /** The recorder's view of this mount (fakes, journal, logger, replay speed, side channels). */
+  private recorderHost;
   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":";;;;;;;;;;cAwCa,OAAA,YAAmB;;EAAnB,QAAA,SAAQ;EAAA,QAAA,OAAA;UAqCG,QAAA;;UAcQ,KAAA;;UAAwB,UAAA;;;;;;UAsBL,YAAA;UAcrB,MAAA;UAOR,OAAA;UAAyB,QAAA;;UAmBjC,MAAA;;UAqDW,WAAA;;UAIL,QAAA;UAU6D,OAAA;UAOxE,cAAK;aACA,CAAA,OAAA,CAAA,EAvJU,cAuJV;SAET,CAAA,GAAA,EAlJU,iBAkJV,CAAA,EAAA,IAAA;YA2GiB,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAtPU,UAsPV,EAAA,GAAA,MAAA,GAtPkC,OAsPlC,CAtP0C,UAsP1C,EAAA,GAAA,MAAA,CAAA,CAAA,EAAA,IAAA;aAME,CAAA,GAAA,EA/OL,qBA+OK,EAAA,OAAA,CAAA,EA/O4B,kBA+O5B,CAAA,EAAA,IAAA;WAMP,CAAA,GAAA,EA7OR,mBA6OQ,EAAA,OAAA,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GA5OgB,eA4OhB,GA5OkC,OA4OlC,CA5O0C,eA4O1C,CAAA,CAAA,EAAA,IAAA;;;;;;;8BA9Na;sBAOR,yBAAyB,mBAAmB;;;;;;;;2EAmBpD;;;;;;;;;;;;;;0BA4BY;;;;oBAyBN,KAAK;oBAIL;;;;iFAU6D;qBAOxE,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;;;;;;;;;;;;;;;;sBA2GiB;wBAME;WAMP;UAkDD;;iBAkBC,YAAY"}