@copilotkit/aimock 1.12.0 → 1.14.0

package/dist/vitest.d.ts

@@ -0,0 +1,30 @@
+import { Fixture, MockServerOptions } from "./types.js";
+import { LLMock } from "./llmock.js";
+
+//#region src/vitest.d.ts
+
+interface UseAimockOptions extends MockServerOptions {
+  /** Path to fixture file or directory. Loaded automatically on start. */
+  fixtures?: string;
+  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */
+  patchEnv?: boolean;
+}
+interface AimockHandle {
+  /** The LLMock instance. */
+  readonly llm: LLMock;
+  /** The server URL (e.g., http://127.0.0.1:4010). */
+  readonly url: string;
+}
+/**
+ * Start an aimock server for the duration of the test suite.
+ *
+ * - `beforeAll`: starts the server and optionally loads fixtures
+ * - `beforeEach`: resets fixture match counts (not fixtures themselves)
+ * - `afterAll`: stops the server
+ *
+ * Returns a getter function — call it inside tests to access the handle.
+ */
+declare function useAimock(options?: UseAimockOptions): () => AimockHandle;
+//#endregion
+export { AimockHandle, type Fixture, LLMock, type MockServerOptions, UseAimockOptions, useAimock };
+//# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","names":[],"sources":["../src/vitest.ts"],"sourcesContent":[],"mappings":";;;;;UAoBiB,gBAAA,SAAyB;;;;;;UAOzB,YAAA;;gBAED;;;;;;;;;;;;;iBAcA,SAAA,WAAmB,yBAA8B"}

package/dist/vitest.js

@@ -0,0 +1,77 @@
+import { loadFixtureFile, loadFixturesFromDir } from "./fixture-loader.js";
+import { LLMock } from "./llmock.js";
+import { afterAll, beforeAll, beforeEach } from "./node_modules/.pnpm/@vitest_runner@3.2.4/node_modules/@vitest/runner/dist/chunk-hooks.js";
+import { resolve } from "node:path";
+import { statSync } from "node:fs";
+
+//#region src/vitest.ts
+/**
+* Vitest integration for aimock.
+*
+* Usage:
+*   import { useAimock } from "@copilotkit/aimock/vitest";
+*
+*   const mock = useAimock({ fixtures: "./fixtures" });
+*
+*   it("responds", async () => {
+*     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });
+*   });
+*/
+/**
+* Start an aimock server for the duration of the test suite.
+*
+* - `beforeAll`: starts the server and optionally loads fixtures
+* - `beforeEach`: resets fixture match counts (not fixtures themselves)
+* - `afterAll`: stops the server
+*
+* Returns a getter function — call it inside tests to access the handle.
+*/
+function useAimock(options = {}) {
+	let handle = null;
+	beforeAll(async () => {
+		const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;
+		const llm = new LLMock(serverOpts);
+		if (fixturePath) {
+			const loadedFixtures = loadFixtures(resolve(fixturePath));
+			for (const f of loadedFixtures) llm.addFixture(f);
+		}
+		const url = await llm.start();
+		if (patchEnv !== false) {
+			process.env.OPENAI_BASE_URL = `${url}/v1`;
+			process.env.ANTHROPIC_BASE_URL = `${url}/v1`;
+		}
+		handle = {
+			llm,
+			url
+		};
+	});
+	beforeEach(() => {
+		if (handle) handle.llm.resetMatchCounts();
+	});
+	afterAll(async () => {
+		if (handle) {
+			if (options.patchEnv !== false) {
+				delete process.env.OPENAI_BASE_URL;
+				delete process.env.ANTHROPIC_BASE_URL;
+			}
+			await handle.llm.stop();
+			handle = null;
+		}
+	});
+	return () => {
+		if (!handle) throw new Error("useAimock(): server not started — are you calling this inside a test?");
+		return handle;
+	};
+}
+function loadFixtures(fixturePath) {
+	try {
+		if (statSync(fixturePath).isDirectory()) return loadFixturesFromDir(fixturePath);
+		return loadFixtureFile(fixturePath);
+	} catch {
+		return [];
+	}
+}
+
+//#endregion
+export { LLMock, useAimock };
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","names":[],"sources":["../src/vitest.ts"],"sourcesContent":["/**\n * Vitest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/vitest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\nimport { beforeAll, afterAll, beforeEach } from \"vitest\";\nimport { LLMock } from \"./llmock.js\";\nimport { loadFixtureFile, loadFixturesFromDir } from \"./fixture-loader.js\";\nimport type { Fixture, MockServerOptions } from \"./types.js\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures\n * - `beforeEach`: resets fixture match counts (not fixtures themselves)\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockHandle {\n  let handle: AimockHandle | null = null;\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      const resolved = resolve(fixturePath);\n      const loadedFixtures = loadFixtures(resolved);\n      for (const f of loadedFixtures) {\n        llm.addFixture(f);\n      }\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = { llm, url };\n  });\n\n  beforeEach(() => {\n    if (handle) {\n      handle.llm.resetMatchCounts();\n    }\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        delete process.env.OPENAI_BASE_URL;\n        delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\nfunction loadFixtures(fixturePath: string): Fixture[] {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      return loadFixturesFromDir(fixturePath);\n    }\n    return loadFixtureFile(fixturePath);\n  } catch {\n    return [];\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,UAAU,UAA4B,EAAE,EAAsB;CAC5E,IAAI,SAA8B;AAElC,WAAU,YAAY;EACpB,MAAM,EAAE,UAAU,aAAa,UAAU,GAAG,eAAe;EAC3D,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,MAAI,aAAa;GAEf,MAAM,iBAAiB,aADN,QAAQ,YAAY,CACQ;AAC7C,QAAK,MAAM,KAAK,eACd,KAAI,WAAW,EAAE;;EAIrB,MAAM,MAAM,MAAM,IAAI,OAAO;AAE7B,MAAI,aAAa,OAAO;AACtB,WAAQ,IAAI,kBAAkB,GAAG,IAAI;AACrC,WAAQ,IAAI,qBAAqB,GAAG,IAAI;;AAG1C,WAAS;GAAE;GAAK;GAAK;GACrB;AAEF,kBAAiB;AACf,MAAI,OACF,QAAO,IAAI,kBAAkB;GAE/B;AAEF,UAAS,YAAY;AACnB,MAAI,QAAQ;AACV,OAAI,QAAQ,aAAa,OAAO;AAC9B,WAAO,QAAQ,IAAI;AACnB,WAAO,QAAQ,IAAI;;AAErB,SAAM,OAAO,IAAI,MAAM;AACvB,YAAS;;GAEX;AAEF,cAAa;AACX,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wEAAwE;AAE1F,SAAO;;;AAIX,SAAS,aAAa,aAAgC;AACpD,KAAI;AAEF,MADa,SAAS,YAAY,CACzB,aAAa,CACpB,QAAO,oBAAoB,YAAY;AAEzC,SAAO,gBAAgB,YAAY;SAC7B;AACN,SAAO,EAAE"}

package/fixtures/example-multi-turn.json

@@ -3,7 +3,7 @@
     {
       "match": { "userMessage": "change background to blue" },
       "response": {
-        "toolCalls": [{ "name": "change_background", "arguments": "{\"background\":\"blue\"}" }]
+        "toolCalls": [{ "name": "change_background", "arguments": { "background": "blue" } }]
       }
     },
     {

package/fixtures/example-tool-call.json

@@ -6,7 +6,7 @@
         "toolCalls": [
           {
             "name": "get_weather",
-            "arguments": "{\"location\":\"San Francisco\",\"unit\":\"fahrenheit\"}"
+            "arguments": { "location": "San Francisco", "unit": "fahrenheit" }
           }
         ]
       }

package/fixtures/examples/a2a/a2a-config.json

@@ -0,0 +1,42 @@
+{
+  "a2a": {
+    "agents": [
+      {
+        "name": "research-agent",
+        "description": "An agent that researches topics and returns summaries",
+        "version": "1.0.0",
+        "skills": [
+          {
+            "id": "web-research",
+            "name": "Web Research",
+            "description": "Search the web and summarize findings",
+            "tags": ["research", "search"]
+          }
+        ],
+        "capabilities": { "streaming": true },
+        "messages": [
+          {
+            "pattern": "research",
+            "parts": [{ "text": "Here is a summary of my research findings on the topic." }]
+          }
+        ],
+        "streamingTasks": [
+          {
+            "pattern": "deep-research",
+            "events": [
+              { "type": "status", "state": "TASK_STATE_WORKING" },
+              {
+                "type": "artifact",
+                "name": "research-report",
+                "parts": [{ "text": "## Research Report\n\nFindings from deep research..." }],
+                "lastChunk": true
+              },
+              { "type": "status", "state": "TASK_STATE_COMPLETED" }
+            ],
+            "delayMs": 100
+          }
+        ]
+      }
+    ]
+  }
+}

package/fixtures/examples/adk/gemini-agent.json

@@ -0,0 +1,47 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": "weather" },
+      "response": {
+        "toolCalls": [
+          {
+            "name": "get_weather",
+            "arguments": { "city": "San Francisco", "unit": "fahrenheit" }
+          }
+        ]
+      }
+    },
+    {
+      "match": { "userMessage": "hello" },
+      "response": {
+        "content": "Hello! I'm an ADK agent running on aimock. How can I help you today?"
+      }
+    },
+    {
+      "match": { "userMessage": "search" },
+      "response": {
+        "toolCalls": [
+          {
+            "name": "google_search",
+            "arguments": { "query": "latest AI news" }
+          }
+        ]
+      }
+    },
+    {
+      "match": { "userMessage": "multi-tool" },
+      "response": {
+        "toolCalls": [
+          {
+            "name": "get_weather",
+            "arguments": { "city": "New York", "unit": "celsius" }
+          },
+          {
+            "name": "get_time",
+            "arguments": { "timezone": "America/New_York" }
+          }
+        ]
+      }
+    }
+  ]
+}

package/fixtures/examples/agui/agui-text-response.json

@@ -0,0 +1,35 @@
+{
+  "agui": {
+    "fixtures": [
+      {
+        "match": { "message": "hello" },
+        "text": "Hi! How can I help you today?"
+      },
+      {
+        "match": { "message": "search" },
+        "events": [
+          { "type": "RUN_STARTED", "threadId": "t1", "runId": "r1" },
+          { "type": "TOOL_CALL_START", "toolCallId": "tc1", "toolCallName": "web_search" },
+          {
+            "type": "TOOL_CALL_ARGS",
+            "toolCallId": "tc1",
+            "delta": "{\"query\": \"latest news\"}"
+          },
+          { "type": "TOOL_CALL_END", "toolCallId": "tc1" },
+          {
+            "type": "TEXT_MESSAGE_START",
+            "messageId": "m1",
+            "role": "assistant"
+          },
+          {
+            "type": "TEXT_MESSAGE_CONTENT",
+            "messageId": "m1",
+            "delta": "Here are the latest results..."
+          },
+          { "type": "TEXT_MESSAGE_END", "messageId": "m1" },
+          { "type": "RUN_FINISHED", "threadId": "t1", "runId": "r1" }
+        ]
+      }
+    ]
+  }
+}

package/fixtures/examples/chaos/chaos-config.json

@@ -0,0 +1,10 @@
+{
+  "llm": {
+    "fixtures": "fixtures/example-greeting.json",
+    "chaos": {
+      "dropRate": 0.1,
+      "malformedRate": 0.05,
+      "disconnectRate": 0.02
+    }
+  }
+}

package/fixtures/examples/crewai/multi-agent-crew.json

@@ -0,0 +1,16 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": "research" },
+      "response": {
+        "content": "Based on my research, the key findings are:\n\n1. LLM testing with fixture-based mocks eliminates flaky tests caused by non-deterministic API responses.\n2. Proxy recording captures real interactions for replay in CI without API keys.\n3. Multi-agent frameworks like CrewAI benefit most because each agent multiplies the number of LLM calls per run."
+      }
+    },
+    {
+      "match": { "userMessage": "write" },
+      "response": {
+        "content": "# Testing LLMs in CI\n\nFixture-based mocking brings determinism to AI-powered applications. By replacing real API calls with recorded responses, teams ship faster with confidence.\n\n## Why It Matters\n\nEvery agent in a CrewAI crew makes independent LLM calls. Without mocking, a two-agent crew means two sources of non-determinism per run. With aimock, every call returns the exact same response every time."
+      }
+    }
+  ]
+}

package/fixtures/examples/full-suite.json

@@ -0,0 +1,116 @@
+{
+  "port": 4000,
+  "host": "127.0.0.1",
+  "metrics": true,
+  "strict": true,
+
+  "llm": {
+    "fixtures": "fixtures/example-greeting.json",
+    "chaos": {
+      "dropRate": 0.01,
+      "malformedRate": 0.005,
+      "disconnectRate": 0.002
+    }
+  },
+
+  "mcp": {
+    "serverInfo": { "name": "full-suite-mcp", "version": "1.0.0" },
+    "tools": [
+      {
+        "name": "search",
+        "description": "Search the knowledge base",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "query": { "type": "string" },
+            "limit": { "type": "number" }
+          },
+          "required": ["query"]
+        },
+        "result": "Found 3 results for your query."
+      }
+    ],
+    "resources": [
+      {
+        "uri": "file:///config",
+        "name": "Configuration",
+        "mimeType": "application/json",
+        "text": "{\"version\": \"1.0\", \"environment\": \"test\"}"
+      }
+    ],
+    "prompts": [
+      {
+        "name": "summarize",
+        "description": "Summarize a document",
+        "arguments": [{ "name": "text", "description": "The text to summarize", "required": true }],
+        "result": {
+          "messages": [
+            {
+              "role": "assistant",
+              "content": { "type": "text", "text": "Here is a summary of the provided text." }
+            }
+          ]
+        }
+      }
+    ]
+  },
+
+  "a2a": {
+    "agents": [
+      {
+        "name": "assistant",
+        "description": "A general-purpose assistant agent",
+        "version": "1.0.0",
+        "skills": [{ "id": "qa", "name": "Q&A", "description": "Answer questions" }],
+        "capabilities": { "streaming": true },
+        "messages": [
+          {
+            "pattern": ".*",
+            "parts": [{ "text": "I can help you with that." }]
+          }
+        ]
+      }
+    ]
+  },
+
+  "agui": {
+    "fixtures": [
+      {
+        "match": { "message": "hello" },
+        "text": "Hello from the full-suite mock!"
+      },
+      {
+        "match": { "toolName": "get_data" },
+        "events": [
+          { "type": "RUN_STARTED", "threadId": "t1", "runId": "r1" },
+          { "type": "TOOL_CALL_START", "toolCallId": "tc1", "toolCallName": "get_data" },
+          { "type": "TOOL_CALL_ARGS", "toolCallId": "tc1", "delta": "{}" },
+          { "type": "TOOL_CALL_END", "toolCallId": "tc1" },
+          { "type": "RUN_FINISHED", "threadId": "t1", "runId": "r1" }
+        ]
+      }
+    ]
+  },
+
+  "vector": {
+    "collections": [
+      {
+        "name": "knowledge-base",
+        "dimension": 384,
+        "queryResults": [
+          {
+            "id": "kb-001",
+            "score": 0.97,
+            "metadata": { "source": "docs", "title": "Quick Start Guide" }
+          }
+        ]
+      }
+    ]
+  },
+
+  "services": {
+    "search": true,
+    "rerank": true,
+    "moderate": true
+  }
+}

package/fixtures/examples/langchain/agent-loop.json

@@ -0,0 +1,27 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": "plan a trip", "sequenceIndex": 0 },
+      "response": {
+        "content": "I'll help plan your trip. Let me look up some options."
+      }
+    },
+    {
+      "match": { "userMessage": "plan a trip", "sequenceIndex": 1 },
+      "response": {
+        "toolCalls": [
+          {
+            "name": "search_flights",
+            "arguments": { "origin": "SFO", "dest": "NRT" }
+          }
+        ]
+      }
+    },
+    {
+      "match": { "userMessage": "plan a trip", "sequenceIndex": 2 },
+      "response": {
+        "content": "I found 3 flights from SFO to Tokyo Narita. The best option is..."
+      }
+    }
+  ]
+}

package/fixtures/examples/llamaindex/aimock-config.json

@@ -0,0 +1,62 @@
+{
+  "llm": {
+    "fixtures": "./rag-pipeline.json"
+  },
+  "vector": {
+    "collections": [
+      {
+        "name": "knowledge-base",
+        "dimension": 3,
+        "vectors": [
+          {
+            "id": "doc-gravity",
+            "values": [0.9, 0.1, 0.05],
+            "metadata": {
+              "source": "physics.pdf",
+              "page": 12,
+              "text": "Gravity is a fundamental force of nature that attracts objects with mass toward one another."
+            }
+          },
+          {
+            "id": "doc-orbits",
+            "values": [0.75, 0.3, 0.15],
+            "metadata": {
+              "source": "physics.pdf",
+              "page": 45,
+              "text": "Orbital mechanics describes the motion of planets and satellites under gravitational influence."
+            }
+          },
+          {
+            "id": "doc-tides",
+            "values": [0.6, 0.5, 0.2],
+            "metadata": {
+              "source": "physics.pdf",
+              "page": 78,
+              "text": "Tidal forces result from the differential gravitational pull of the Moon and Sun on Earth's oceans."
+            }
+          }
+        ],
+        "queryResults": [
+          {
+            "id": "doc-gravity",
+            "score": 0.97,
+            "metadata": {
+              "source": "physics.pdf",
+              "page": 12,
+              "text": "Gravity is a fundamental force of nature that attracts objects with mass toward one another."
+            }
+          },
+          {
+            "id": "doc-orbits",
+            "score": 0.82,
+            "metadata": {
+              "source": "physics.pdf",
+              "page": 45,
+              "text": "Orbital mechanics describes the motion of planets and satellites under gravitational influence."
+            }
+          }
+        ]
+      }
+    ]
+  }
+}

package/fixtures/examples/llamaindex/rag-pipeline.json

@@ -0,0 +1,34 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": "What is gravity?" },
+      "response": {
+        "content": "Based on the retrieved documents, gravity is a fundamental force of nature that attracts objects with mass toward one another. It is described by Newton's law of universal gravitation and Einstein's general theory of relativity."
+      }
+    },
+    {
+      "match": { "userMessage": "Summarize the document" },
+      "response": {
+        "content": "The document covers three main topics: gravitational force, orbital mechanics, and tidal effects. It explains how gravity governs planetary motion and influences ocean tides on Earth."
+      }
+    },
+    {
+      "match": { "inputText": "What is gravity?", "endpoint": "embedding" },
+      "response": {
+        "embedding": [0.9, 0.1, 0.05]
+      }
+    },
+    {
+      "match": { "inputText": "Gravity is a fundamental force", "endpoint": "embedding" },
+      "response": {
+        "embedding": [0.88, 0.12, 0.07]
+      }
+    },
+    {
+      "match": { "inputText": "orbital mechanics and planetary motion", "endpoint": "embedding" },
+      "response": {
+        "embedding": [0.75, 0.3, 0.15]
+      }
+    }
+  ]
+}

package/fixtures/examples/llm/embeddings.json

@@ -0,0 +1,10 @@
+{
+  "fixtures": [
+    {
+      "match": { "inputText": "hello world" },
+      "response": {
+        "embedding": [0.0023064255, -0.009327292, 0.015797347]
+      }
+    }
+  ]
+}

package/fixtures/examples/llm/error-injection.json

@@ -0,0 +1,15 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": ".*" },
+      "response": {
+        "error": {
+          "message": "Rate limit exceeded. Please retry after 30 seconds.",
+          "type": "rate_limit_error",
+          "code": "rate_limit_exceeded"
+        },
+        "status": 429
+      }
+    }
+  ]
+}

package/fixtures/examples/llm/sequential-responses.json

@@ -0,0 +1,20 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": "tell me a joke", "sequenceIndex": 0 },
+      "response": {
+        "content": "Why did the programmer quit his job? Because he didn't get arrays!"
+      }
+    },
+    {
+      "match": { "userMessage": "tell me a joke", "sequenceIndex": 1 },
+      "response": { "content": "Why do Java developers wear glasses? Because they can't C#!" }
+    },
+    {
+      "match": { "userMessage": "tell me a joke", "sequenceIndex": 2 },
+      "response": {
+        "content": "A SQL query walks into a bar, sees two tables, and asks: 'Can I join you?'"
+      }
+    }
+  ]
+}

package/fixtures/examples/llm/streaming-physics.json

@@ -0,0 +1,15 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": "explain gravity" },
+      "response": {
+        "content": "Gravity is a fundamental force of nature that attracts objects with mass toward one another. It keeps planets in orbit around the sun and holds galaxies together."
+      },
+      "streamingProfile": {
+        "ttft": 200,
+        "tps": 40,
+        "jitter": 0.1
+      }
+    }
+  ]
+}

package/fixtures/examples/mastra/agent-workflow.json

@@ -0,0 +1,32 @@
+{
+  "fixtures": [
+    {
+      "match": { "userMessage": "plan a trip", "sequenceIndex": 0 },
+      "response": {
+        "toolCalls": [
+          {
+            "name": "search_flights",
+            "arguments": { "origin": "SFO", "destination": "NRT", "date": "2025-03-15" }
+          }
+        ]
+      }
+    },
+    {
+      "match": { "userMessage": "plan a trip", "sequenceIndex": 1 },
+      "response": {
+        "toolCalls": [
+          {
+            "name": "search_hotels",
+            "arguments": { "city": "Tokyo", "checkIn": "2025-03-15", "checkOut": "2025-03-22" }
+          }
+        ]
+      }
+    },
+    {
+      "match": { "userMessage": "plan a trip", "sequenceIndex": 2 },
+      "response": {
+        "content": "I found a great itinerary for your Tokyo trip!\n\n**Flight:** SFO → NRT on March 15, departing 11:30 AM (United UA837) — $890 round trip\n\n**Hotel:** Hotel Gracery Shinjuku, March 15–22 — $185/night\n\nWould you like me to book these, or would you prefer different options?"
+      }
+    }
+  ]
+}

package/fixtures/examples/mcp/mcp-config.json

@@ -0,0 +1,26 @@
+{
+  "mcp": {
+    "tools": [
+      {
+        "name": "search",
+        "description": "Search the web",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "query": { "type": "string" }
+          },
+          "required": ["query"]
+        },
+        "result": "No results found for the given query."
+      }
+    ],
+    "resources": [
+      {
+        "uri": "file:///readme",
+        "name": "README",
+        "mimeType": "text/plain",
+        "text": "# My Project\n\nThis is the project README."
+      }
+    ]
+  }
+}