@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/mcp-fakes-report.d.cts

@@ -0,0 +1,40 @@
+import { McpFakeReportPart } from "./mcp-fakes.cjs";
+
+//#region src/mcp-fakes-report.d.ts
+
+type ServedRow = McpFakeReportPart["served"][number];
+type FailureRow = McpFakeReportPart["failures"][number];
+/**
+ * RP3: the report. `served` and `failures` are in call order across mounts;
+ * their rows have no `seq` (the internal ordering key the parts carry).
+ */
+interface McpFakesReport {
+  testId: string | null;
+  context: string | null;
+  ok: boolean;
+  evicted: boolean;
+  served: Omit<ServedRow, "seq">[];
+  unconsumed: McpFakeReportPart["unconsumed"];
+  unfaked: McpFakeReportPart["unfaked"];
+  failures: Omit<FailureRow, "seq">[];
+  sharedUnconsumed: McpFakeReportPart["sharedUnconsumed"];
+}
+/** RP7/RP8: thrown by the plugins under "fail" and by assertFakesReport. */
+declare class AimockFakesReportError extends Error {
+  readonly report: McpFakesReport;
+  constructor(report: McpFakesReport, message: string);
+}
+/** TI5: a default test id cannot be inferred safely. */
+declare class AimockTestIdCollisionError extends Error {
+  constructor(message: string);
+}
+/** RP1-RP5 over every fake mount of a server. Reads only: no state changes (RP9). */
+
+/** RP8: throw `AimockFakesReportError` when the report fails (RP5, plus unfaked under `failOnUnfaked`). */
+declare function assertFakesReport(report: McpFakesReport, opts?: {
+  failOnUnfaked?: boolean;
+}): void;
+/** RP6: `GET /__aimock/mcp/fakes/report?testId=&context=`. Always answers; returns true. */
+//#endregion
+export { AimockFakesReportError, AimockTestIdCollisionError, McpFakesReport, assertFakesReport };
+//# sourceMappingURL=mcp-fakes-report.d.cts.map

package/dist/mcp-fakes-report.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-fakes-report.d.cts","names":[],"sources":["../src/mcp-fakes-report.ts"],"sourcesContent":[],"mappings":";;;;KAYK,SAAA,GAAY,iBAcN,CAAA,QAAA,CAAA,CAAA,MAAA,CAAA;KAbN,UAAA,GAAa,iBAcD,CAAA,UAAA,CAAA,CAAA,MAAA,CAAA;;;;AAKjB;AAAoC,UAbnB,cAAA,CAamB;QACjB,EAAA,MAAA,GAAA,IAAA;SACG,EAAA,MAAA,GAAA,IAAA;MAFsB,OAAA;EAAK,OAAA,EAAA,OAAA;EAUpC,MAAA,EAlBH,IAkBG,CAlBE,SAkBF,EAAA,KAA2B,CAAA,EAAA;EAoGxB,UAAA,EArHF,iBAqHmB,CAAA,YACvB,CAAA;WArHC;YACC,KAAK;oBACG;;;cAIP,sBAAA,SAA+B,KAAA;mBACzB;sBACG;;;cAQT,0BAAA,SAAmC,KAAA;;;;;;iBAoGhC,iBAAA,SACN"}

package/dist/mcp-fakes-report.d.ts

@@ -0,0 +1,40 @@
+import { McpFakeReportPart } from "./mcp-fakes.js";
+
+//#region src/mcp-fakes-report.d.ts
+
+type ServedRow = McpFakeReportPart["served"][number];
+type FailureRow = McpFakeReportPart["failures"][number];
+/**
+ * RP3: the report. `served` and `failures` are in call order across mounts;
+ * their rows have no `seq` (the internal ordering key the parts carry).
+ */
+interface McpFakesReport {
+  testId: string | null;
+  context: string | null;
+  ok: boolean;
+  evicted: boolean;
+  served: Omit<ServedRow, "seq">[];
+  unconsumed: McpFakeReportPart["unconsumed"];
+  unfaked: McpFakeReportPart["unfaked"];
+  failures: Omit<FailureRow, "seq">[];
+  sharedUnconsumed: McpFakeReportPart["sharedUnconsumed"];
+}
+/** RP7/RP8: thrown by the plugins under "fail" and by assertFakesReport. */
+declare class AimockFakesReportError extends Error {
+  readonly report: McpFakesReport;
+  constructor(report: McpFakesReport, message: string);
+}
+/** TI5: a default test id cannot be inferred safely. */
+declare class AimockTestIdCollisionError extends Error {
+  constructor(message: string);
+}
+/** RP1-RP5 over every fake mount of a server. Reads only: no state changes (RP9). */
+
+/** RP8: throw `AimockFakesReportError` when the report fails (RP5, plus unfaked under `failOnUnfaked`). */
+declare function assertFakesReport(report: McpFakesReport, opts?: {
+  failOnUnfaked?: boolean;
+}): void;
+/** RP6: `GET /__aimock/mcp/fakes/report?testId=&context=`. Always answers; returns true. */
+//#endregion
+export { AimockFakesReportError, AimockTestIdCollisionError, McpFakesReport, assertFakesReport };
+//# sourceMappingURL=mcp-fakes-report.d.ts.map

package/dist/mcp-fakes-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-fakes-report.d.ts","names":[],"sources":["../src/mcp-fakes-report.ts"],"sourcesContent":[],"mappings":";;;;KAYK,SAAA,GAAY,iBAcN,CAAA,QAAA,CAAA,CAAA,MAAA,CAAA;KAbN,UAAA,GAAa,iBAcD,CAAA,UAAA,CAAA,CAAA,MAAA,CAAA;;;;AAKjB;AAAoC,UAbnB,cAAA,CAamB;QACjB,EAAA,MAAA,GAAA,IAAA;SACG,EAAA,MAAA,GAAA,IAAA;MAFsB,OAAA;EAAK,OAAA,EAAA,OAAA;EAUpC,MAAA,EAlBH,IAkBG,CAlBE,SAkBF,EAAA,KAA2B,CAAA,EAAA;EAoGxB,UAAA,EArHF,iBAqHmB,CAAA,YACvB,CAAA;WArHC;YACC,KAAK;oBACG;;;cAIP,sBAAA,SAA+B,KAAA;mBACzB;sBACG;;;cAQT,0BAAA,SAAmC,KAAA;;;;;;iBAoGhC,iBAAA,SACN"}

package/dist/mcp-fakes-report.js

@@ -0,0 +1,107 @@
+import { isFakeMount } from "./mcp-fakes-mount.js";
+
+//#region src/mcp-fakes-report.ts
+/** RP7/RP8: thrown by the plugins under "fail" and by assertFakesReport. */
+var AimockFakesReportError = class extends Error {
+	report;
+	constructor(report, message) {
+		super(message);
+		this.name = "AimockFakesReportError";
+		this.report = report;
+	}
+};
+/** TI5: a default test id cannot be inferred safely. */
+var AimockTestIdCollisionError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "AimockTestIdCollisionError";
+	}
+};
+function isReportSource(handler) {
+	return typeof handler === "object" && handler !== null && typeof handler.fakesReportPart === "function";
+}
+/** RP1-RP5 over every fake mount of a server. Reads only: no state changes (RP9). */
+function buildFakesReport(mounts, testId, context) {
+	let evicted = false;
+	const served = [];
+	const unconsumed = [];
+	const unfaked = [];
+	const failures = [];
+	const sharedUnconsumed = [];
+	for (const { path, handler } of mounts) {
+		if (!isFakeMount(handler) || !isReportSource(handler)) continue;
+		const part = handler.fakesReportPart(testId, context, path);
+		evicted ||= part.evicted;
+		served.push(...part.served);
+		unconsumed.push(...part.unconsumed);
+		unfaked.push(...part.unfaked);
+		failures.push(...part.failures);
+		sharedUnconsumed.push(...part.sharedUnconsumed);
+	}
+	served.sort((a, b) => a.seq - b.seq);
+	failures.sort((a, b) => a.seq - b.seq);
+	return {
+		testId,
+		context,
+		ok: failures.length === 0 && !evicted && unconsumed.length === 0,
+		evicted,
+		served: served.map(({ entryId, mount, tool, args }) => ({
+			entryId,
+			mount,
+			tool,
+			args
+		})),
+		unconsumed,
+		unfaked,
+		failures: failures.map(({ code, mount, tool, args }) => ({
+			code,
+			mount,
+			tool,
+			args
+		})),
+		sharedUnconsumed
+	};
+}
+/** `value` as one line of JSON; a value with no JSON text is shown as `String(value)`. */
+function jsonText(value) {
+	try {
+		return JSON.stringify(value) ?? String(value);
+	} catch {
+		return String(value);
+	}
+}
+/**
+* RP7 message: a header naming the test id (and context), then one line per
+* failure, then per unconsumed entry id, then the evicted line. With
+* `failOnUnfaked`, one line per unfaked call follows.
+*/
+function formatFakesReport(report, opts = {}) {
+	const lines = [`aimock MCP fakes report failed (${report.testId === null ? "no test id" : `testId ${JSON.stringify(report.testId)}`}${report.context === null ? "" : `, context ${JSON.stringify(report.context)}`}):`];
+	for (const f of report.failures) lines.push(`  failure ${f.code}: tools/call ${f.tool} on ${f.mount} with ${jsonText(f.args)}`);
+	for (const u of report.unconsumed) lines.push(`  unconsumed: ${u.entryId} (${u.mount} ${u.tool})`);
+	if (report.evicted) lines.push("  evicted: this test id's fake state was evicted by the per-mount test-id cap, or its event log overflowed (1000 events); the report is incomplete");
+	if (opts.failOnUnfaked === true) for (const u of report.unfaked) lines.push(`  unfaked: tools/call ${u.tool} on ${u.mount} answered by ${u.answeredBy}`);
+	return lines.join("\n");
+}
+/** RP8: throw `AimockFakesReportError` when the report fails (RP5, plus unfaked under `failOnUnfaked`). */
+function assertFakesReport(report, opts = {}) {
+	const unfakedFails = opts.failOnUnfaked === true && report.unfaked.length > 0;
+	if (report.ok && !unfakedFails) return;
+	throw new AimockFakesReportError(report, formatFakesReport(report, opts));
+}
+/** The query parameters `GET /__aimock/mcp/fakes/report` accepts. */
+const MCP_FAKES_REPORT_PARAMS = new Set(["testId", "context"]);
+/** RP6: `GET /__aimock/mcp/fakes/report?testId=&context=`. Always answers; returns true. */
+function handleFakesReportRoute(res, searchParams, mounts) {
+	const reply = (status, body) => {
+		res.writeHead(status, { "Content-Type": "application/json" });
+		res.end(JSON.stringify(body));
+		return true;
+	};
+	for (const key of searchParams.keys()) if (!MCP_FAKES_REPORT_PARAMS.has(key)) return reply(400, { error: `Unknown query parameter: '${key}'. Supported: ${[...MCP_FAKES_REPORT_PARAMS].join(", ")}` });
+	return reply(200, buildFakesReport(mounts, searchParams.get("testId") || null, searchParams.get("context") || null));
+}
+
+//#endregion
+export { AimockFakesReportError, AimockTestIdCollisionError, assertFakesReport, formatFakesReport, handleFakesReportRoute };
+//# sourceMappingURL=mcp-fakes-report.js.map

package/dist/mcp-fakes-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-fakes-report.js","names":[],"sources":["../src/mcp-fakes-report.ts"],"sourcesContent":["/**\n * The per-test MCP fake report (record-replay RP1-RP8): one identity (a test\n * id, plus an optional context) across every MCP mount of one server. Each\n * mount's `MCPMock` gives its part (`fakesReportPart`, from the store's event\n * log); this module merges the parts, decides `ok` (RP5), formats the failure\n * message (RP7) and serves `GET /__aimock/mcp/fakes/report` (RP6).\n */\nimport type * as http from \"node:http\";\nimport type { MountList } from \"./mcp-fakes-mount.js\";\nimport { isFakeMount } from \"./mcp-fakes-mount.js\";\nimport type { McpFakeReportPart } from \"./mcp-fakes.js\";\n\ntype ServedRow = McpFakeReportPart[\"served\"][number];\ntype FailureRow = McpFakeReportPart[\"failures\"][number];\n\n/**\n * RP3: the report. `served` and `failures` are in call order across mounts;\n * their rows have no `seq` (the internal ordering key the parts carry).\n */\nexport interface McpFakesReport {\n  testId: string | null;\n  context: string | null;\n  ok: boolean;\n  evicted: boolean;\n  served: Omit<ServedRow, \"seq\">[];\n  unconsumed: McpFakeReportPart[\"unconsumed\"];\n  unfaked: McpFakeReportPart[\"unfaked\"];\n  failures: Omit<FailureRow, \"seq\">[];\n  sharedUnconsumed: McpFakeReportPart[\"sharedUnconsumed\"];\n}\n\n/** RP7/RP8: thrown by the plugins under \"fail\" and by assertFakesReport. */\nexport class AimockFakesReportError extends Error {\n  readonly report: McpFakesReport;\n  constructor(report: McpFakesReport, message: string) {\n    super(message);\n    this.name = \"AimockFakesReportError\";\n    this.report = report;\n  }\n}\n\n/** TI5: a default test id cannot be inferred safely. */\nexport class AimockTestIdCollisionError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AimockTestIdCollisionError\";\n  }\n}\n\ninterface ReportSource {\n  fakesReportPart(testId: string | null, context: string | null, mount: string): McpFakeReportPart;\n}\n\nfunction isReportSource(handler: unknown): handler is ReportSource {\n  return (\n    typeof handler === \"object\" &&\n    handler !== null &&\n    typeof (handler as Partial<ReportSource>).fakesReportPart === \"function\"\n  );\n}\n\n/** RP1-RP5 over every fake mount of a server. Reads only: no state changes (RP9). */\nexport function buildFakesReport(\n  mounts: MountList,\n  testId: string | null,\n  context: string | null,\n): McpFakesReport {\n  let evicted = false;\n  const served: ServedRow[] = [];\n  const unconsumed: McpFakesReport[\"unconsumed\"] = [];\n  const unfaked: McpFakesReport[\"unfaked\"] = [];\n  const failures: FailureRow[] = [];\n  const sharedUnconsumed: McpFakesReport[\"sharedUnconsumed\"] = [];\n  for (const { path, handler } of mounts) {\n    if (!isFakeMount(handler) || !isReportSource(handler)) continue;\n    const part = handler.fakesReportPart(testId, context, path);\n    evicted ||= part.evicted;\n    served.push(...part.served);\n    unconsumed.push(...part.unconsumed);\n    unfaked.push(...part.unfaked);\n    failures.push(...part.failures);\n    sharedUnconsumed.push(...part.sharedUnconsumed);\n  }\n  // `seq` is shared by every store, so it orders calls across mounts.\n  served.sort((a, b) => a.seq - b.seq);\n  failures.sort((a, b) => a.seq - b.seq);\n  const ok = failures.length === 0 && !evicted && unconsumed.length === 0; // RP5\n  return {\n    testId,\n    context,\n    ok,\n    evicted,\n    served: served.map(({ entryId, mount, tool, args }) => ({ entryId, mount, tool, args })),\n    unconsumed,\n    unfaked,\n    failures: failures.map(({ code, mount, tool, args }) => ({ code, mount, tool, args })),\n    sharedUnconsumed,\n  };\n}\n\n/** `value` as one line of JSON; a value with no JSON text is shown as `String(value)`. */\nfunction jsonText(value: unknown): string {\n  try {\n    const text = JSON.stringify(value) as string | undefined;\n    return text ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/**\n * RP7 message: a header naming the test id (and context), then one line per\n * failure, then per unconsumed entry id, then the evicted line. With\n * `failOnUnfaked`, one line per unfaked call follows.\n */\nexport function formatFakesReport(\n  report: McpFakesReport,\n  opts: { failOnUnfaked?: boolean } = {},\n): string {\n  const who = report.testId === null ? \"no test id\" : `testId ${JSON.stringify(report.testId)}`;\n  const ctx = report.context === null ? \"\" : `, context ${JSON.stringify(report.context)}`;\n  const lines = [`aimock MCP fakes report failed (${who}${ctx}):`];\n  for (const f of report.failures) {\n    lines.push(`  failure ${f.code}: tools/call ${f.tool} on ${f.mount} with ${jsonText(f.args)}`);\n  }\n  for (const u of report.unconsumed) {\n    lines.push(`  unconsumed: ${u.entryId} (${u.mount} ${u.tool})`);\n  }\n  if (report.evicted) {\n    lines.push(\n      \"  evicted: this test id's fake state was evicted by the per-mount test-id cap, or its event log overflowed (1000 events); the report is incomplete\",\n    );\n  }\n  if (opts.failOnUnfaked === true) {\n    for (const u of report.unfaked) {\n      lines.push(`  unfaked: tools/call ${u.tool} on ${u.mount} answered by ${u.answeredBy}`);\n    }\n  }\n  return lines.join(\"\\n\");\n}\n\n/** RP8: throw `AimockFakesReportError` when the report fails (RP5, plus unfaked under `failOnUnfaked`). */\nexport function assertFakesReport(\n  report: McpFakesReport,\n  opts: { failOnUnfaked?: boolean } = {},\n): void {\n  const unfakedFails = opts.failOnUnfaked === true && report.unfaked.length > 0;\n  if (report.ok && !unfakedFails) return;\n  throw new AimockFakesReportError(report, formatFakesReport(report, opts));\n}\n\n/** The query parameters `GET /__aimock/mcp/fakes/report` accepts. */\nconst MCP_FAKES_REPORT_PARAMS = new Set([\"testId\", \"context\"]);\n\n/** RP6: `GET /__aimock/mcp/fakes/report?testId=&context=`. Always answers; returns true. */\nexport function handleFakesReportRoute(\n  res: http.ServerResponse,\n  searchParams: URLSearchParams,\n  mounts: MountList,\n): true {\n  const reply = (status: number, body: unknown): true => {\n    res.writeHead(status, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify(body));\n    return true;\n  };\n  for (const key of searchParams.keys()) {\n    if (!MCP_FAKES_REPORT_PARAMS.has(key)) {\n      return reply(400, {\n        error: `Unknown query parameter: '${key}'. Supported: ${[...MCP_FAKES_REPORT_PARAMS].join(\", \")}`,\n      });\n    }\n  }\n  // Empty values are not supplied, as on GET /__aimock/mcp/fakes.\n  const testId = searchParams.get(\"testId\") || null;\n  const context = searchParams.get(\"context\") || null;\n  return reply(200, buildFakesReport(mounts, testId, context));\n}\n"],"mappings":"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"}