@langchain/core 1.2.0-dev-1765937705265 → 1.2.0

package/dist/testing/fake_model_builder.js

@@ -0,0 +1,225 @@
+import { BaseMessage } from "../messages/base.js";
+import { AIMessage } from "../messages/ai.js";
+import { RunnableLambda } from "../runnables/base.js";
+import "../messages/index.js";
+import { BaseChatModel } from "../language_models/chat_models.js";
+//#region src/testing/fake_model_builder.ts
+function deriveContent(messages) {
+	return messages.map((m) => m.text).filter(Boolean).join("-");
+}
+let idCounter = 0;
+function nextToolCallId() {
+	idCounter += 1;
+	return `fake_tc_${idCounter}`;
+}
+/**
+* A fake chat model for testing, created via {@link fakeModel}.
+*
+* Queue responses with `.respond()` and `.respondWithTools()`, then
+* pass the instance directly wherever a chat model is expected.
+* Responses are consumed in first-in-first-out order — one per `invoke()` call.
+* When all queued responses are consumed, further invocations throw.
+*/
+var FakeBuiltModel = class FakeBuiltModel extends BaseChatModel {
+	queue = [];
+	_alwaysThrowError;
+	_structuredResponseValue;
+	_tools = [];
+	_state = {
+		callIndex: 0,
+		calls: []
+	};
+	/**
+	* All invocations recorded by this model, in order.
+	* Each entry contains the `messages` array and `options` that were
+	* passed to `invoke()`.
+	*/
+	get calls() {
+		return this._state.calls;
+	}
+	/**
+	* The number of times this model has been invoked.
+	*/
+	get callCount() {
+		return this._state.calls.length;
+	}
+	constructor() {
+		super({});
+	}
+	_llmType() {
+		return "fake-model-builder";
+	}
+	_combineLLMOutput() {
+		return [];
+	}
+	/**
+	* Enqueue a response that the model will return on its next invocation.
+	* @param entry A {@link BaseMessage} to return, an `Error` to throw, or
+	*   a factory `(messages) => BaseMessage | Error` for dynamic responses.
+	* @returns `this`, for chaining.
+	*/
+	respond(entry) {
+		if (typeof entry === "function") this.queue.push({
+			kind: "factory",
+			factory: entry
+		});
+		else if (BaseMessage.isInstance(entry)) this.queue.push({
+			kind: "message",
+			message: entry
+		});
+		else this.queue.push({
+			kind: "error",
+			error: entry
+		});
+		return this;
+	}
+	/**
+	* Enqueue an {@link AIMessage} that carries the given tool calls.
+	* Content is derived from the input messages at invocation time.
+	* @param toolCalls Array of tool calls. Each entry needs `name` and
+	*   `args`; `id` is optional and auto-generated when omitted.
+	* @returns `this`, for chaining.
+	*/
+	respondWithTools(toolCalls) {
+		this.queue.push({
+			kind: "toolCalls",
+			toolCalls: toolCalls.map((tc) => ({
+				name: tc.name,
+				args: tc.args,
+				id: tc.id ?? nextToolCallId(),
+				type: "tool_call"
+			}))
+		});
+		return this;
+	}
+	/**
+	* Make every invocation throw the given error, regardless of the queue.
+	* @param error The error to throw.
+	* @returns `this`, for chaining.
+	*/
+	alwaysThrow(error) {
+		this._alwaysThrowError = error;
+		return this;
+	}
+	/**
+	* Set the value that {@link withStructuredOutput} will resolve to.
+	* @param value The structured object to return.
+	* @returns `this`, for chaining.
+	*/
+	structuredResponse(value) {
+		this._structuredResponseValue = value;
+		return this;
+	}
+	/**
+	* Bind tools to the model. Returns a new model that shares the same
+	* response queue and call history.
+	* @param tools The tools to bind, as {@link StructuredTool} instances or
+	*   plain {@link ToolSpec} objects.
+	* @returns A new RunnableBinding with the tools bound.
+	*/
+	bindTools(tools) {
+		const merged = [...this._tools, ...tools];
+		const next = new FakeBuiltModel();
+		next.queue = this.queue;
+		next._alwaysThrowError = this._alwaysThrowError;
+		next._structuredResponseValue = this._structuredResponseValue;
+		next._tools = merged;
+		next._state = this._state;
+		return next.withConfig({});
+	}
+	/**
+	* Returns a {@link Runnable} that produces the {@link structuredResponse}
+	* value. The schema argument is accepted for compatibility but ignored.
+	* @param _params Schema or params (ignored).
+	* @param _config Options (ignored).
+	* @returns A Runnable that resolves to the structured response value.
+	*/
+	withStructuredOutput(_params, _config) {
+		const { _structuredResponseValue } = this;
+		return RunnableLambda.from(async () => {
+			return _structuredResponseValue;
+		});
+	}
+	async _generate(messages, options, _runManager) {
+		this._state.calls.push({
+			messages: [...messages],
+			options
+		});
+		const currentCallIndex = this._state.callIndex;
+		this._state.callIndex += 1;
+		if (this._alwaysThrowError) throw this._alwaysThrowError;
+		const entry = this.queue[currentCallIndex];
+		if (!entry) throw new Error(`FakeModel: no response queued for invocation ${currentCallIndex} (${this.queue.length} total queued).`);
+		if (entry.kind === "error") throw entry.error;
+		if (entry.kind === "factory") {
+			const result = entry.factory(messages);
+			if (!BaseMessage.isInstance(result)) throw result;
+			return { generations: [{
+				text: "",
+				message: result
+			}] };
+		}
+		if (entry.kind === "message") return { generations: [{
+			text: "",
+			message: entry.message
+		}] };
+		const content = deriveContent(messages);
+		return {
+			generations: [{
+				text: content,
+				message: new AIMessage({
+					content,
+					id: currentCallIndex.toString(),
+					tool_calls: entry.toolCalls.length > 0 ? entry.toolCalls.map((tc) => ({
+						...tc,
+						type: "tool_call"
+					})) : void 0
+				})
+			}],
+			llmOutput: {}
+		};
+	}
+};
+/**
+* Creates a new {@link FakeBuiltModel} for testing.
+*
+* Returns a chainable builder — queue responses, then pass the model
+* anywhere a chat model is expected. Responses are consumed in FIFO
+* order, one per `invoke()` call.
+*
+* ## API summary
+*
+* | Method | Description |
+* | --- | --- |
+* | `fakeModel()` | Creates a new fake chat model. Returns a chainable builder. |
+* | `.respond(message)` | Queue an `AIMessage` (or any `BaseMessage`) to return on the next invocation. |
+* | `.respond(error)` | Queue an `Error` to throw on the next invocation. |
+* | `.respond(factory)` | Queue a function `(messages) => BaseMessage \| Error` for dynamic responses. |
+* | `.respondWithTools(toolCalls)` | Shorthand for `.respond()` with tool calls. Each entry needs `name` and `args`; `id` is optional. |
+* | `.alwaysThrow(error)` | Make every invocation throw this error, regardless of the queue. |
+* | `.structuredResponse(value)` | Set the value returned by `.withStructuredOutput()`. |
+* | `.bindTools(tools)` | Bind tools to the model. Returns a `RunnableBinding` that shares the response queue and call recording. |
+* | `.withStructuredOutput(schema)` | Returns a runnable that produces the `.structuredResponse()` value. |
+* | `.calls` | Array of `{ messages, options }` for every invocation (read-only). |
+* | `.callCount` | Number of times the model has been invoked. |
+*
+* @example
+* ```typescript
+* const model = fakeModel()
+*   .respondWithTools([{ name: "search", args: { query: "weather" } }])
+*   .respond(new AIMessage("Sunny and warm."));
+*
+* const r1 = await model.invoke([new HumanMessage("What's the weather?")]);
+* // r1.tool_calls[0].name === "search"
+*
+* const r2 = await model.invoke([new HumanMessage("Thanks")]);
+* // r2.content === "Sunny and warm."
+* ```
+*/
+function fakeModel() {
+	return new FakeBuiltModel();
+}
+//#endregion
+export { FakeBuiltModel, fakeModel };
+
+//# sourceMappingURL=fake_model_builder.js.map

package/dist/testing/fake_model_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake_model_builder.js","names":[],"sources":["../../src/testing/fake_model_builder.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport { CallbackManagerForLLMRun } from \"../callbacks/manager.js\";\nimport {\n  BaseChatModel,\n  BaseChatModelCallOptions,\n} from \"../language_models/chat_models.js\";\nimport {\n  BaseLanguageModelInput,\n  StructuredOutputMethodOptions,\n  StructuredOutputMethodParams,\n} from \"../language_models/base.js\";\nimport { BaseMessage, AIMessage } from \"../messages/index.js\";\nimport type { ToolCall } from \"../messages/tool.js\";\nimport type { ChatResult } from \"../outputs.js\";\nimport { Runnable, RunnableLambda } from \"../runnables/base.js\";\nimport { StructuredTool } from \"../tools/index.js\";\nimport type { InteropZodType } from \"../utils/types/zod.js\";\nimport type { ToolSpec } from \"../utils/testing/chat_models.js\";\n\ntype ResponseFactory = (messages: BaseMessage[]) => BaseMessage | Error;\n\ntype QueueEntry =\n  | { kind: \"message\"; message: BaseMessage }\n  | { kind: \"toolCalls\"; toolCalls: ToolCall[] }\n  | { kind: \"error\"; error: Error }\n  | { kind: \"factory\"; factory: ResponseFactory };\n\ninterface FakeModelCall {\n  messages: BaseMessage[];\n  options: any;\n}\n\ninterface FakeModelState {\n  callIndex: number;\n  calls: FakeModelCall[];\n}\n\nfunction deriveContent(messages: BaseMessage[]): string {\n  return messages\n    .map((m) => m.text)\n    .filter(Boolean)\n    .join(\"-\");\n}\n\nlet idCounter = 0;\nfunction nextToolCallId(): string {\n  idCounter += 1;\n  return `fake_tc_${idCounter}`;\n}\n\n/**\n * A fake chat model for testing, created via {@link fakeModel}.\n *\n * Queue responses with `.respond()` and `.respondWithTools()`, then\n * pass the instance directly wherever a chat model is expected.\n * Responses are consumed in first-in-first-out order — one per `invoke()` call.\n * When all queued responses are consumed, further invocations throw.\n */\nexport class FakeBuiltModel extends BaseChatModel {\n  private queue: QueueEntry[] = [];\n\n  private _alwaysThrowError: Error | undefined;\n\n  private _structuredResponseValue: any;\n\n  private _tools: (StructuredTool | ToolSpec)[] = [];\n\n  private _state: FakeModelState = { callIndex: 0, calls: [] };\n\n  /**\n   * All invocations recorded by this model, in order.\n   * Each entry contains the `messages` array and `options` that were\n   * passed to `invoke()`.\n   */\n  get calls(): FakeModelCall[] {\n    return this._state.calls;\n  }\n\n  /**\n   * The number of times this model has been invoked.\n   */\n  get callCount(): number {\n    return this._state.calls.length;\n  }\n\n  constructor() {\n    super({});\n  }\n\n  _llmType(): string {\n    return \"fake-model-builder\";\n  }\n\n  _combineLLMOutput() {\n    return [];\n  }\n\n  /**\n   * Enqueue a response that the model will return on its next invocation.\n   * @param entry A {@link BaseMessage} to return, an `Error` to throw, or\n   *   a factory `(messages) => BaseMessage | Error` for dynamic responses.\n   * @returns `this`, for chaining.\n   */\n  respond(entry: BaseMessage | Error | ResponseFactory): this {\n    if (typeof entry === \"function\") {\n      this.queue.push({ kind: \"factory\", factory: entry });\n    } else if (BaseMessage.isInstance(entry)) {\n      this.queue.push({ kind: \"message\", message: entry });\n    } else {\n      this.queue.push({ kind: \"error\", error: entry });\n    }\n    return this;\n  }\n\n  /**\n   * Enqueue an {@link AIMessage} that carries the given tool calls.\n   * Content is derived from the input messages at invocation time.\n   * @param toolCalls Array of tool calls. Each entry needs `name` and\n   *   `args`; `id` is optional and auto-generated when omitted.\n   * @returns `this`, for chaining.\n   */\n  respondWithTools(\n    toolCalls: Array<{ name: string; args: Record<string, any>; id?: string }>\n  ): this {\n    this.queue.push({\n      kind: \"toolCalls\",\n      toolCalls: toolCalls.map((tc) => ({\n        name: tc.name,\n        args: tc.args,\n        id: tc.id ?? nextToolCallId(),\n        type: \"tool_call\" as const,\n      })),\n    });\n    return this;\n  }\n\n  /**\n   * Make every invocation throw the given error, regardless of the queue.\n   * @param error The error to throw.\n   * @returns `this`, for chaining.\n   */\n  alwaysThrow(error: Error): this {\n    this._alwaysThrowError = error;\n    return this;\n  }\n\n  /**\n   * Set the value that {@link withStructuredOutput} will resolve to.\n   * @param value The structured object to return.\n   * @returns `this`, for chaining.\n   */\n  structuredResponse(value: Record<string, any>): this {\n    this._structuredResponseValue = value;\n    return this;\n  }\n\n  /**\n   * Bind tools to the model. Returns a new model that shares the same\n   * response queue and call history.\n   * @param tools The tools to bind, as {@link StructuredTool} instances or\n   *   plain {@link ToolSpec} objects.\n   * @returns A new RunnableBinding with the tools bound.\n   */\n  bindTools(tools: (StructuredTool | ToolSpec)[]) {\n    const merged = [...this._tools, ...tools];\n    const next = new FakeBuiltModel();\n    next.queue = this.queue;\n    next._alwaysThrowError = this._alwaysThrowError;\n    next._structuredResponseValue = this._structuredResponseValue;\n    next._tools = merged;\n    next._state = this._state;\n\n    return next.withConfig({} as BaseChatModelCallOptions);\n  }\n\n  /**\n   * Returns a {@link Runnable} that produces the {@link structuredResponse}\n   * value. The schema argument is accepted for compatibility but ignored.\n   * @param _params Schema or params (ignored).\n   * @param _config Options (ignored).\n   * @returns A Runnable that resolves to the structured response value.\n   */\n  withStructuredOutput<\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    _params:\n      | StructuredOutputMethodParams<RunOutput, boolean>\n      | InteropZodType<RunOutput>\n      | Record<string, any>,\n    _config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<\n        BaseLanguageModelInput,\n        { raw: BaseMessage; parsed: RunOutput }\n      > {\n    const { _structuredResponseValue } = this;\n    return RunnableLambda.from(async () => {\n      return _structuredResponseValue as RunOutput;\n    }) as Runnable;\n  }\n\n  async _generate(\n    messages: BaseMessage[],\n    options?: this[\"ParsedCallOptions\"],\n    _runManager?: CallbackManagerForLLMRun\n  ): Promise<ChatResult> {\n    this._state.calls.push({ messages: [...messages], options });\n\n    const currentCallIndex = this._state.callIndex;\n    this._state.callIndex += 1;\n\n    if (this._alwaysThrowError) {\n      throw this._alwaysThrowError;\n    }\n\n    const entry = this.queue[currentCallIndex];\n    if (!entry) {\n      throw new Error(\n        `FakeModel: no response queued for invocation ${currentCallIndex} (${this.queue.length} total queued).`\n      );\n    }\n\n    if (entry.kind === \"error\") {\n      throw entry.error;\n    }\n\n    if (entry.kind === \"factory\") {\n      const result = entry.factory(messages);\n      if (!BaseMessage.isInstance(result)) {\n        throw result;\n      }\n      return {\n        generations: [{ text: \"\", message: result }],\n      };\n    }\n\n    if (entry.kind === \"message\") {\n      return {\n        generations: [{ text: \"\", message: entry.message }],\n      };\n    }\n\n    const content = deriveContent(messages);\n    const message = new AIMessage({\n      content,\n      id: currentCallIndex.toString(),\n      tool_calls:\n        entry.toolCalls.length > 0\n          ? entry.toolCalls.map((tc) => ({\n              ...tc,\n              type: \"tool_call\" as const,\n            }))\n          : undefined,\n    });\n\n    return {\n      generations: [{ text: content, message }],\n      llmOutput: {},\n    };\n  }\n}\n\n/**\n * Creates a new {@link FakeBuiltModel} for testing.\n *\n * Returns a chainable builder — queue responses, then pass the model\n * anywhere a chat model is expected. Responses are consumed in FIFO\n * order, one per `invoke()` call.\n *\n * ## API summary\n *\n * | Method | Description |\n * | --- | --- |\n * | `fakeModel()` | Creates a new fake chat model. Returns a chainable builder. |\n * | `.respond(message)` | Queue an `AIMessage` (or any `BaseMessage`) to return on the next invocation. |\n * | `.respond(error)` | Queue an `Error` to throw on the next invocation. |\n * | `.respond(factory)` | Queue a function `(messages) => BaseMessage \\| Error` for dynamic responses. |\n * | `.respondWithTools(toolCalls)` | Shorthand for `.respond()` with tool calls. Each entry needs `name` and `args`; `id` is optional. |\n * | `.alwaysThrow(error)` | Make every invocation throw this error, regardless of the queue. |\n * | `.structuredResponse(value)` | Set the value returned by `.withStructuredOutput()`. |\n * | `.bindTools(tools)` | Bind tools to the model. Returns a `RunnableBinding` that shares the response queue and call recording. |\n * | `.withStructuredOutput(schema)` | Returns a runnable that produces the `.structuredResponse()` value. |\n * | `.calls` | Array of `{ messages, options }` for every invocation (read-only). |\n * | `.callCount` | Number of times the model has been invoked. |\n *\n * @example\n * ```typescript\n * const model = fakeModel()\n *   .respondWithTools([{ name: \"search\", args: { query: \"weather\" } }])\n *   .respond(new AIMessage(\"Sunny and warm.\"));\n *\n * const r1 = await model.invoke([new HumanMessage(\"What's the weather?\")]);\n * // r1.tool_calls[0].name === \"search\"\n *\n * const r2 = await model.invoke([new HumanMessage(\"Thanks\")]);\n * // r2.content === \"Sunny and warm.\"\n * ```\n */\nexport function fakeModel(): FakeBuiltModel {\n  return new FakeBuiltModel();\n}\n"],"mappings":"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"}

package/dist/testing/index.cjs

@@ -0,0 +1,58 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_stream = require("../utils/testing/stream.cjs");
+const require_matchers = require("./matchers.cjs");
+const require_fake_model_builder = require("./fake_model_builder.cjs");
+const require_openai_stream_fixtures = require("../utils/testing/openai_stream_fixtures.cjs");
+//#region src/testing/index.ts
+var testing_exports = /* @__PURE__ */ require_runtime.__exportAll({
+	FakeBuiltModel: () => require_fake_model_builder.FakeBuiltModel,
+	asAsyncIterable: () => require_openai_stream_fixtures.asAsyncIterable,
+	fakeModel: () => require_fake_model_builder.fakeModel,
+	langchainMatchers: () => require_matchers.langchainMatchers,
+	openAIReasoningTextChunks: () => require_openai_stream_fixtures.openAIReasoningTextChunks,
+	openAITextOnlyChunks: () => require_openai_stream_fixtures.openAITextOnlyChunks,
+	openAITextOnlyChunksWithUsage: () => require_openai_stream_fixtures.openAITextOnlyChunksWithUsage,
+	openAIToolCallChunks: () => require_openai_stream_fixtures.openAIToolCallChunks,
+	sseResponseFromOpenAIChunks: () => require_openai_stream_fixtures.sseResponseFromOpenAIChunks,
+	streamMatchers: () => require_stream.streamMatchers,
+	toBeAIMessage: () => require_matchers.toBeAIMessage,
+	toBeHumanMessage: () => require_matchers.toBeHumanMessage,
+	toBeSystemMessage: () => require_matchers.toBeSystemMessage,
+	toBeToolMessage: () => require_matchers.toBeToolMessage,
+	toContainToolCall: () => require_matchers.toContainToolCall,
+	toHaveBeenInterrupted: () => require_matchers.toHaveBeenInterrupted,
+	toHaveStructuredResponse: () => require_matchers.toHaveStructuredResponse,
+	toHaveToolCallCount: () => require_matchers.toHaveToolCallCount,
+	toHaveToolCalls: () => require_matchers.toHaveToolCalls,
+	toHaveToolMessages: () => require_matchers.toHaveToolMessages
+});
+//#endregion
+exports.FakeBuiltModel = require_fake_model_builder.FakeBuiltModel;
+exports.asAsyncIterable = require_openai_stream_fixtures.asAsyncIterable;
+exports.fakeModel = require_fake_model_builder.fakeModel;
+exports.langchainMatchers = require_matchers.langchainMatchers;
+exports.openAIReasoningTextChunks = require_openai_stream_fixtures.openAIReasoningTextChunks;
+exports.openAITextOnlyChunks = require_openai_stream_fixtures.openAITextOnlyChunks;
+exports.openAITextOnlyChunksWithUsage = require_openai_stream_fixtures.openAITextOnlyChunksWithUsage;
+exports.openAIToolCallChunks = require_openai_stream_fixtures.openAIToolCallChunks;
+exports.sseResponseFromOpenAIChunks = require_openai_stream_fixtures.sseResponseFromOpenAIChunks;
+exports.streamMatchers = require_stream.streamMatchers;
+Object.defineProperty(exports, "testing_exports", {
+	enumerable: true,
+	get: function() {
+		return testing_exports;
+	}
+});
+exports.toBeAIMessage = require_matchers.toBeAIMessage;
+exports.toBeHumanMessage = require_matchers.toBeHumanMessage;
+exports.toBeSystemMessage = require_matchers.toBeSystemMessage;
+exports.toBeToolMessage = require_matchers.toBeToolMessage;
+exports.toContainToolCall = require_matchers.toContainToolCall;
+exports.toHaveBeenInterrupted = require_matchers.toHaveBeenInterrupted;
+exports.toHaveStructuredResponse = require_matchers.toHaveStructuredResponse;
+exports.toHaveToolCallCount = require_matchers.toHaveToolCallCount;
+exports.toHaveToolCalls = require_matchers.toHaveToolCalls;
+exports.toHaveToolMessages = require_matchers.toHaveToolMessages;
+
+//# sourceMappingURL=index.cjs.map

package/dist/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/testing/index.ts"],"sourcesContent":["import \"./vitest-expect.js\";\nexport * from \"./matchers.js\";\nexport { fakeModel, FakeBuiltModel } from \"./fake_model_builder.js\";\nexport {\n  asAsyncIterable,\n  openAITextOnlyChunks,\n  openAITextOnlyChunksWithUsage,\n  openAIReasoningTextChunks,\n  openAIToolCallChunks,\n  sseResponseFromOpenAIChunks,\n} from \"../utils/testing/openai_stream_fixtures.js\";\nexport {\n  streamMatchers,\n  type StreamMatchers,\n  type StreamOutputExpectation,\n  type StreamToolCallExpectation,\n  type StreamUsageExpectation,\n} from \"../utils/testing/stream.js\";\n"],"mappings":""}

package/dist/testing/index.d.cts

@@ -0,0 +1,5 @@
+import { StreamMatchers, StreamOutputExpectation, StreamToolCallExpectation, StreamUsageExpectation, streamMatchers } from "../utils/testing/stream.cjs";
+import { LangChainMatchers, langchainMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages } from "./matchers.cjs";
+import { FakeBuiltModel, fakeModel } from "./fake_model_builder.cjs";
+import { asAsyncIterable, openAIReasoningTextChunks, openAITextOnlyChunks, openAITextOnlyChunksWithUsage, openAIToolCallChunks, sseResponseFromOpenAIChunks } from "../utils/testing/openai_stream_fixtures.cjs";
+export { FakeBuiltModel, LangChainMatchers, type StreamMatchers, type StreamOutputExpectation, type StreamToolCallExpectation, type StreamUsageExpectation, asAsyncIterable, fakeModel, langchainMatchers, openAIReasoningTextChunks, openAITextOnlyChunks, openAITextOnlyChunksWithUsage, openAIToolCallChunks, sseResponseFromOpenAIChunks, streamMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages };

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+import { StreamMatchers, StreamOutputExpectation, StreamToolCallExpectation, StreamUsageExpectation, streamMatchers } from "../utils/testing/stream.js";
+import { LangChainMatchers, langchainMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages } from "./matchers.js";
+import { FakeBuiltModel, fakeModel } from "./fake_model_builder.js";
+import { asAsyncIterable, openAIReasoningTextChunks, openAITextOnlyChunks, openAITextOnlyChunksWithUsage, openAIToolCallChunks, sseResponseFromOpenAIChunks } from "../utils/testing/openai_stream_fixtures.js";
+export { FakeBuiltModel, LangChainMatchers, type StreamMatchers, type StreamOutputExpectation, type StreamToolCallExpectation, type StreamUsageExpectation, asAsyncIterable, fakeModel, langchainMatchers, openAIReasoningTextChunks, openAITextOnlyChunks, openAITextOnlyChunksWithUsage, openAIToolCallChunks, sseResponseFromOpenAIChunks, streamMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages };

package/dist/testing/index.js

@@ -0,0 +1,32 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { streamMatchers } from "../utils/testing/stream.js";
+import { langchainMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages } from "./matchers.js";
+import { FakeBuiltModel, fakeModel } from "./fake_model_builder.js";
+import { asAsyncIterable, openAIReasoningTextChunks, openAITextOnlyChunks, openAITextOnlyChunksWithUsage, openAIToolCallChunks, sseResponseFromOpenAIChunks } from "../utils/testing/openai_stream_fixtures.js";
+//#region src/testing/index.ts
+var testing_exports = /* @__PURE__ */ __exportAll({
+	FakeBuiltModel: () => FakeBuiltModel,
+	asAsyncIterable: () => asAsyncIterable,
+	fakeModel: () => fakeModel,
+	langchainMatchers: () => langchainMatchers,
+	openAIReasoningTextChunks: () => openAIReasoningTextChunks,
+	openAITextOnlyChunks: () => openAITextOnlyChunks,
+	openAITextOnlyChunksWithUsage: () => openAITextOnlyChunksWithUsage,
+	openAIToolCallChunks: () => openAIToolCallChunks,
+	sseResponseFromOpenAIChunks: () => sseResponseFromOpenAIChunks,
+	streamMatchers: () => streamMatchers,
+	toBeAIMessage: () => toBeAIMessage,
+	toBeHumanMessage: () => toBeHumanMessage,
+	toBeSystemMessage: () => toBeSystemMessage,
+	toBeToolMessage: () => toBeToolMessage,
+	toContainToolCall: () => toContainToolCall,
+	toHaveBeenInterrupted: () => toHaveBeenInterrupted,
+	toHaveStructuredResponse: () => toHaveStructuredResponse,
+	toHaveToolCallCount: () => toHaveToolCallCount,
+	toHaveToolCalls: () => toHaveToolCalls,
+	toHaveToolMessages: () => toHaveToolMessages
+});
+//#endregion
+export { FakeBuiltModel, asAsyncIterable, fakeModel, langchainMatchers, openAIReasoningTextChunks, openAITextOnlyChunks, openAITextOnlyChunksWithUsage, openAIToolCallChunks, sseResponseFromOpenAIChunks, streamMatchers, testing_exports, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages };
+
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/index.ts"],"sourcesContent":["import \"./vitest-expect.js\";\nexport * from \"./matchers.js\";\nexport { fakeModel, FakeBuiltModel } from \"./fake_model_builder.js\";\nexport {\n  asAsyncIterable,\n  openAITextOnlyChunks,\n  openAITextOnlyChunksWithUsage,\n  openAIReasoningTextChunks,\n  openAIToolCallChunks,\n  sseResponseFromOpenAIChunks,\n} from \"../utils/testing/openai_stream_fixtures.js\";\nexport {\n  streamMatchers,\n  type StreamMatchers,\n  type StreamOutputExpectation,\n  type StreamToolCallExpectation,\n  type StreamUsageExpectation,\n} from \"../utils/testing/stream.js\";\n"],"mappings":""}

package/dist/testing/matchers.cjs

@@ -0,0 +1,214 @@
+const require_base = require("../messages/base.cjs");
+const require_messages_tool = require("../messages/tool.cjs");
+const require_ai = require("../messages/ai.cjs");
+const require_human = require("../messages/human.cjs");
+const require_system = require("../messages/system.cjs");
+require("../messages/index.cjs");
+const require_stream = require("../utils/testing/stream.cjs");
+//#region src/testing/matchers.ts
+function getMessageTypeName(msg) {
+	if (!require_base.BaseMessage.isInstance(msg)) return typeof msg;
+	return msg.constructor.name || msg.type;
+}
+function makeMessageTypeMatcher(typeName, isInstance) {
+	return function(received, expected) {
+		const { isNot, utils } = this;
+		if (!isInstance(received)) return {
+			pass: false,
+			message: () => `${utils.matcherHint(`toBe${typeName}`, void 0, void 0)}\n\nExpected: ${isNot ? "not " : ""}${typeName}\nReceived: ${getMessageTypeName(received)}`,
+			actual: getMessageTypeName(received),
+			expected: typeName
+		};
+		if (expected === void 0) return {
+			pass: true,
+			message: () => `${utils.matcherHint(`toBe${typeName}`, void 0, void 0)}\n\nExpected: not ${typeName}\nReceived: ${typeName}`
+		};
+		const msg = received;
+		if (typeof expected === "string") return {
+			pass: msg.content === expected,
+			message: () => `${utils.matcherHint(`toBe${typeName}`, void 0, void 0)}\n\nExpected: ${typeName} with content ${utils.printExpected(expected)}\nReceived: ${typeName} with content ${utils.printReceived(msg.content)}`,
+			actual: msg.content,
+			expected
+		};
+		return {
+			pass: Object.entries(expected).every(([key, value]) => this.equals(msg[key], value)),
+			message: () => {
+				const receivedFields = {};
+				for (const key of Object.keys(expected)) receivedFields[key] = msg[key];
+				return `${utils.matcherHint(`toBe${typeName}`, void 0, void 0)}\n\nExpected: ${typeName} matching ${utils.printExpected(expected)}\nReceived: ${typeName} with ${utils.printReceived(receivedFields)}`;
+			},
+			actual: (() => {
+				const receivedFields = {};
+				for (const key of Object.keys(expected)) receivedFields[key] = msg[key];
+				return receivedFields;
+			})(),
+			expected
+		};
+	};
+}
+const toBeHumanMessage = makeMessageTypeMatcher("HumanMessage", require_human.HumanMessage.isInstance);
+const toBeAIMessage = makeMessageTypeMatcher("AIMessage", require_ai.AIMessage.isInstance);
+const toBeSystemMessage = makeMessageTypeMatcher("SystemMessage", require_system.SystemMessage.isInstance);
+const toBeToolMessage = makeMessageTypeMatcher("ToolMessage", require_messages_tool.ToolMessage.isInstance);
+function toHaveToolCalls(received, expected) {
+	const { isNot, utils } = this;
+	if (!require_ai.AIMessage.isInstance(received)) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveToolCalls")}\n\nExpected: AIMessage\nReceived: ${getMessageTypeName(received)}`
+	};
+	const actual = received.tool_calls ?? [];
+	if (actual.length !== expected.length) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveToolCalls")}\n\nExpected ${isNot ? "not " : ""}${expected.length} tool call(s), received ${actual.length}`,
+		actual: actual.length,
+		expected: expected.length
+	};
+	const unmatched = expected.filter((exp) => !actual.some((tc) => Object.entries(exp).every(([key, value]) => this.equals(tc[key], value))));
+	if (unmatched.length > 0) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveToolCalls")}\n\nCould not find matching tool call(s) for:\n${utils.printExpected(unmatched)}\nReceived tool calls: ${utils.printReceived(actual.map((tc) => ({
+			name: tc.name,
+			id: tc.id,
+			args: tc.args
+		})))}`,
+		actual: actual.map((tc) => ({
+			name: tc.name,
+			id: tc.id,
+			args: tc.args
+		})),
+		expected
+	};
+	return {
+		pass: true,
+		message: () => `${utils.matcherHint("toHaveToolCalls")}\n\nExpected AIMessage not to have matching tool calls`
+	};
+}
+function toHaveToolCallCount(received, expected) {
+	const { isNot, utils } = this;
+	if (!require_ai.AIMessage.isInstance(received)) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveToolCallCount")}\n\nExpected: AIMessage\nReceived: ${getMessageTypeName(received)}`
+	};
+	const actual = received.tool_calls?.length ?? 0;
+	return {
+		pass: actual === expected,
+		message: () => `${utils.matcherHint("toHaveToolCallCount")}\n\nExpected ${isNot ? "not " : ""}${expected} tool call(s)\nReceived: ${actual}`,
+		actual,
+		expected
+	};
+}
+function toContainToolCall(received, expected) {
+	const { isNot, utils } = this;
+	if (!require_ai.AIMessage.isInstance(received)) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toContainToolCall")}\n\nExpected: AIMessage\nReceived: ${getMessageTypeName(received)}`
+	};
+	const actual = received.tool_calls ?? [];
+	return {
+		pass: actual.some((tc) => Object.entries(expected).every(([key, value]) => this.equals(tc[key], value))),
+		message: () => `${utils.matcherHint("toContainToolCall")}\n\nExpected AIMessage ${isNot ? "not " : ""}to contain a tool call matching ${utils.printExpected(expected)}\nReceived tool calls: ${utils.printReceived(actual.map((tc) => ({
+			name: tc.name,
+			id: tc.id
+		})))}`,
+		actual: actual.map((tc) => ({
+			name: tc.name,
+			id: tc.id
+		})),
+		expected
+	};
+}
+function toHaveToolMessages(received, expected) {
+	const { isNot, utils } = this;
+	if (!Array.isArray(received)) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveToolMessages")}\n\nExpected an array of messages\nReceived: ${typeof received}`
+	};
+	const toolMessages = received.filter(require_messages_tool.ToolMessage.isInstance);
+	if (toolMessages.length !== expected.length) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveToolMessages")}\n\nExpected ${isNot ? "not " : ""}${expected.length} tool message(s), found ${toolMessages.length}`,
+		actual: toolMessages.length,
+		expected: expected.length
+	};
+	for (let i = 0; i < expected.length; i++) if (!Object.entries(expected[i]).every(([key, value]) => this.equals(toolMessages[i][key], value))) return {
+		pass: false,
+		message: () => {
+			const receivedFields = {};
+			for (const key of Object.keys(expected[i])) receivedFields[key] = toolMessages[i][key];
+			return `${utils.matcherHint("toHaveToolMessages")}\n\nTool message at index ${i} did not match:\nExpected: ${utils.printExpected(expected[i])}\nReceived: ${utils.printReceived(receivedFields)}`;
+		},
+		actual: toolMessages[i],
+		expected: expected[i]
+	};
+	return {
+		pass: true,
+		message: () => `${utils.matcherHint("toHaveToolMessages")}\n\nExpected messages not to contain matching tool messages`
+	};
+}
+function toHaveBeenInterrupted(received, expectedValue) {
+	const { isNot, utils } = this;
+	const interrupts = received?.__interrupt__;
+	if (!(Array.isArray(interrupts) && interrupts.length > 0)) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveBeenInterrupted")}\n\nExpected result ${isNot ? "not " : ""}to have been interrupted\nReceived __interrupt__: ${utils.printReceived(interrupts)}`
+	};
+	if (expectedValue === void 0) return {
+		pass: true,
+		message: () => `${utils.matcherHint("toHaveBeenInterrupted")}\n\nExpected result not to have been interrupted\nReceived ${interrupts.length} interrupt(s)`
+	};
+	const actualValue = interrupts[0]?.value;
+	return {
+		pass: this.equals(actualValue, expectedValue),
+		message: () => `${utils.matcherHint("toHaveBeenInterrupted")}\n\nExpected interrupt value: ${utils.printExpected(expectedValue)}\nReceived interrupt value: ${utils.printReceived(actualValue)}`,
+		actual: actualValue,
+		expected: expectedValue
+	};
+}
+function toHaveStructuredResponse(received, expected) {
+	const { isNot, utils } = this;
+	const structuredResponse = received?.structuredResponse;
+	if (!(structuredResponse !== void 0)) return {
+		pass: false,
+		message: () => `${utils.matcherHint("toHaveStructuredResponse")}\n\nExpected result ${isNot ? "not " : ""}to have a structured response\nReceived structuredResponse: undefined`
+	};
+	if (expected === void 0) return {
+		pass: true,
+		message: () => `${utils.matcherHint("toHaveStructuredResponse")}\n\nExpected result not to have a structured response`
+	};
+	return {
+		pass: Object.entries(expected).every(([key, value]) => this.equals(structuredResponse[key], value)),
+		message: () => `${utils.matcherHint("toHaveStructuredResponse")}\n\nExpected structured response: ${utils.printExpected(expected)}\nReceived structured response: ${utils.printReceived(structuredResponse)}`,
+		actual: structuredResponse,
+		expected
+	};
+}
+/**
+* All matcher functions bundled for convenient use with `expect.extend()`.
+*/
+const langchainMatchers = {
+	toBeHumanMessage,
+	toBeAIMessage,
+	toBeSystemMessage,
+	toBeToolMessage,
+	toHaveToolCalls,
+	toHaveToolCallCount,
+	toContainToolCall,
+	toHaveToolMessages,
+	toHaveBeenInterrupted,
+	toHaveStructuredResponse,
+	...require_stream.streamMatchers
+};
+//#endregion
+exports.langchainMatchers = langchainMatchers;
+exports.toBeAIMessage = toBeAIMessage;
+exports.toBeHumanMessage = toBeHumanMessage;
+exports.toBeSystemMessage = toBeSystemMessage;
+exports.toBeToolMessage = toBeToolMessage;
+exports.toContainToolCall = toContainToolCall;
+exports.toHaveBeenInterrupted = toHaveBeenInterrupted;
+exports.toHaveStructuredResponse = toHaveStructuredResponse;
+exports.toHaveToolCallCount = toHaveToolCallCount;
+exports.toHaveToolCalls = toHaveToolCalls;
+exports.toHaveToolMessages = toHaveToolMessages;
+
+//# sourceMappingURL=matchers.cjs.map

package/dist/testing/matchers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.cjs","names":["BaseMessage","HumanMessage","AIMessage","SystemMessage","ToolMessage","result","streamMatchers"],"sources":["../../src/testing/matchers.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport {\n  streamMatchers,\n  type StreamMatchers,\n} from \"../utils/testing/stream.js\";\nimport { BaseMessage } from \"../messages/index.js\";\nimport { HumanMessage } from \"../messages/index.js\";\nimport { AIMessage } from \"../messages/index.js\";\nimport { SystemMessage } from \"../messages/index.js\";\nimport { ToolMessage } from \"../messages/index.js\";\n\n/**\n * The `this` context that Vitest and Jest provide to custom matchers\n * via `expect.extend`.\n *\n * Compatible with both frameworks:\n * - https://vitest.dev/guide/extending-matchers.html\n * - https://jestjs.io/docs/expect#expectextendmatchers\n */\ninterface ExpectExtendThis {\n  isNot?: boolean;\n  equals(a: unknown, b: unknown): boolean;\n  utils: {\n    matcherHint(name: string, received?: string, expected?: string): string;\n    printReceived(value: unknown): string;\n    printExpected(value: unknown): string;\n  };\n}\n\ninterface ExpectationResult {\n  pass: boolean;\n  message: () => string;\n  actual?: unknown;\n  expected?: unknown;\n}\n\nfunction getMessageTypeName(msg: unknown): string {\n  if (!BaseMessage.isInstance(msg)) return typeof msg;\n  return msg.constructor.name || msg.type;\n}\n\nfunction makeMessageTypeMatcher(\n  typeName: string,\n  isInstance: (obj: unknown) => boolean\n) {\n  return function (\n    this: ExpectExtendThis,\n    received: unknown,\n    expected?: string | Record<string, unknown>\n  ): ExpectationResult {\n    const { isNot, utils } = this;\n\n    const instancePass = isInstance(received);\n    if (!instancePass) {\n      return {\n        pass: false,\n        message: () =>\n          `${utils.matcherHint(`toBe${typeName}`, undefined, undefined)}\\n\\n` +\n          `Expected: ${isNot ? \"not \" : \"\"}${typeName}\\n` +\n          `Received: ${getMessageTypeName(received)}`,\n        actual: getMessageTypeName(received),\n        expected: typeName,\n      };\n    }\n\n    if (expected === undefined) {\n      return {\n        pass: true,\n        message: () =>\n          `${utils.matcherHint(`toBe${typeName}`, undefined, undefined)}\\n\\n` +\n          `Expected: not ${typeName}\\n` +\n          `Received: ${typeName}`,\n      };\n    }\n\n    const msg = received as BaseMessage;\n    if (typeof expected === \"string\") {\n      const contentPass = msg.content === expected;\n      return {\n        pass: contentPass,\n        message: () =>\n          `${utils.matcherHint(`toBe${typeName}`, undefined, undefined)}\\n\\n` +\n          `Expected: ${typeName} with content ${utils.printExpected(expected)}\\n` +\n          `Received: ${typeName} with content ${utils.printReceived(msg.content)}`,\n        actual: msg.content,\n        expected,\n      };\n    }\n\n    const fieldsPass = Object.entries(expected).every(([key, value]) =>\n      this.equals((msg as any)[key], value)\n    );\n    return {\n      pass: fieldsPass,\n      message: () => {\n        const receivedFields: Record<string, unknown> = {};\n        for (const key of Object.keys(expected)) {\n          receivedFields[key] = (msg as any)[key];\n        }\n        return (\n          `${utils.matcherHint(`toBe${typeName}`, undefined, undefined)}\\n\\n` +\n          `Expected: ${typeName} matching ${utils.printExpected(expected)}\\n` +\n          `Received: ${typeName} with ${utils.printReceived(receivedFields)}`\n        );\n      },\n      actual: (() => {\n        const receivedFields: Record<string, unknown> = {};\n        for (const key of Object.keys(expected)) {\n          receivedFields[key] = (msg as any)[key];\n        }\n        return receivedFields;\n      })(),\n      expected,\n    };\n  };\n}\n\nexport const toBeHumanMessage = makeMessageTypeMatcher(\n  \"HumanMessage\",\n  HumanMessage.isInstance\n);\n\nexport const toBeAIMessage = makeMessageTypeMatcher(\n  \"AIMessage\",\n  AIMessage.isInstance\n);\n\nexport const toBeSystemMessage = makeMessageTypeMatcher(\n  \"SystemMessage\",\n  SystemMessage.isInstance\n);\n\nexport const toBeToolMessage = makeMessageTypeMatcher(\n  \"ToolMessage\",\n  ToolMessage.isInstance\n);\n\nexport function toHaveToolCalls(\n  this: ExpectExtendThis,\n  received: unknown,\n  expected: Array<Record<string, unknown>>\n): ExpectationResult {\n  const { isNot, utils } = this;\n\n  if (!AIMessage.isInstance(received)) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveToolCalls\")}\\n\\n` +\n        `Expected: AIMessage\\n` +\n        `Received: ${getMessageTypeName(received)}`,\n    };\n  }\n\n  const actual = received.tool_calls ?? [];\n\n  if (actual.length !== expected.length) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveToolCalls\")}\\n\\n` +\n        `Expected ${isNot ? \"not \" : \"\"}${expected.length} tool call(s), received ${actual.length}`,\n      actual: actual.length,\n      expected: expected.length,\n    };\n  }\n\n  const unmatched = expected.filter(\n    (exp) =>\n      !actual.some((tc) =>\n        Object.entries(exp).every(([key, value]) =>\n          this.equals((tc as any)[key], value)\n        )\n      )\n  );\n\n  if (unmatched.length > 0) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveToolCalls\")}\\n\\n` +\n        `Could not find matching tool call(s) for:\\n` +\n        `${utils.printExpected(unmatched)}\\n` +\n        `Received tool calls: ${utils.printReceived(actual.map((tc) => ({ name: tc.name, id: tc.id, args: tc.args })))}`,\n      actual: actual.map((tc) => ({ name: tc.name, id: tc.id, args: tc.args })),\n      expected,\n    };\n  }\n\n  return {\n    pass: true,\n    message: () =>\n      `${utils.matcherHint(\"toHaveToolCalls\")}\\n\\n` +\n      `Expected AIMessage not to have matching tool calls`,\n  };\n}\n\nexport function toHaveToolCallCount(\n  this: ExpectExtendThis,\n  received: unknown,\n  expected: number\n): ExpectationResult {\n  const { isNot, utils } = this;\n\n  if (!AIMessage.isInstance(received)) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveToolCallCount\")}\\n\\n` +\n        `Expected: AIMessage\\n` +\n        `Received: ${getMessageTypeName(received)}`,\n    };\n  }\n\n  const actual = received.tool_calls?.length ?? 0;\n  const pass = actual === expected;\n\n  return {\n    pass,\n    message: () =>\n      `${utils.matcherHint(\"toHaveToolCallCount\")}\\n\\n` +\n      `Expected ${isNot ? \"not \" : \"\"}${expected} tool call(s)\\n` +\n      `Received: ${actual}`,\n    actual,\n    expected,\n  };\n}\n\nexport function toContainToolCall(\n  this: ExpectExtendThis,\n  received: unknown,\n  expected: Record<string, unknown>\n): ExpectationResult {\n  const { isNot, utils } = this;\n\n  if (!AIMessage.isInstance(received)) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toContainToolCall\")}\\n\\n` +\n        `Expected: AIMessage\\n` +\n        `Received: ${getMessageTypeName(received)}`,\n    };\n  }\n\n  const actual = received.tool_calls ?? [];\n  const found = actual.some((tc) =>\n    Object.entries(expected).every(([key, value]) =>\n      this.equals((tc as any)[key], value)\n    )\n  );\n\n  return {\n    pass: found,\n    message: () =>\n      `${utils.matcherHint(\"toContainToolCall\")}\\n\\n` +\n      `Expected AIMessage ${isNot ? \"not \" : \"\"}to contain a tool call matching ${utils.printExpected(expected)}\\n` +\n      `Received tool calls: ${utils.printReceived(actual.map((tc) => ({ name: tc.name, id: tc.id })))}`,\n    actual: actual.map((tc) => ({ name: tc.name, id: tc.id })),\n    expected,\n  };\n}\n\nexport function toHaveToolMessages(\n  this: ExpectExtendThis,\n  received: unknown,\n  expected: Array<Record<string, unknown>>\n): ExpectationResult {\n  const { isNot, utils } = this;\n\n  if (!Array.isArray(received)) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveToolMessages\")}\\n\\n` +\n        `Expected an array of messages\\n` +\n        `Received: ${typeof received}`,\n    };\n  }\n\n  const toolMessages = (received as BaseMessage[]).filter(\n    ToolMessage.isInstance\n  );\n\n  if (toolMessages.length !== expected.length) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveToolMessages\")}\\n\\n` +\n        `Expected ${isNot ? \"not \" : \"\"}${expected.length} tool message(s), found ${toolMessages.length}`,\n      actual: toolMessages.length,\n      expected: expected.length,\n    };\n  }\n\n  for (let i = 0; i < expected.length; i++) {\n    const match = Object.entries(expected[i]).every(([key, value]) =>\n      this.equals((toolMessages[i] as any)[key], value)\n    );\n    if (!match) {\n      return {\n        pass: false,\n        message: () => {\n          const receivedFields: Record<string, unknown> = {};\n          for (const key of Object.keys(expected[i])) {\n            receivedFields[key] = (toolMessages[i] as any)[key];\n          }\n          return (\n            `${utils.matcherHint(\"toHaveToolMessages\")}\\n\\n` +\n            `Tool message at index ${i} did not match:\\n` +\n            `Expected: ${utils.printExpected(expected[i])}\\n` +\n            `Received: ${utils.printReceived(receivedFields)}`\n          );\n        },\n        actual: toolMessages[i],\n        expected: expected[i],\n      };\n    }\n  }\n\n  return {\n    pass: true,\n    message: () =>\n      `${utils.matcherHint(\"toHaveToolMessages\")}\\n\\n` +\n      `Expected messages not to contain matching tool messages`,\n  };\n}\n\nexport function toHaveBeenInterrupted(\n  this: ExpectExtendThis,\n  received: unknown,\n  expectedValue?: unknown\n): ExpectationResult {\n  const { isNot, utils } = this;\n\n  const result = received as Record<string, any>;\n  const interrupts = result?.__interrupt__;\n  const hasInterrupt = Array.isArray(interrupts) && interrupts.length > 0;\n\n  if (!hasInterrupt) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveBeenInterrupted\")}\\n\\n` +\n        `Expected result ${isNot ? \"not \" : \"\"}to have been interrupted\\n` +\n        `Received __interrupt__: ${utils.printReceived(interrupts)}`,\n    };\n  }\n\n  if (expectedValue === undefined) {\n    return {\n      pass: true,\n      message: () =>\n        `${utils.matcherHint(\"toHaveBeenInterrupted\")}\\n\\n` +\n        `Expected result not to have been interrupted\\n` +\n        `Received ${interrupts.length} interrupt(s)`,\n    };\n  }\n\n  const actualValue = interrupts[0]?.value;\n  const valuePass = this.equals(actualValue, expectedValue);\n\n  return {\n    pass: valuePass,\n    message: () =>\n      `${utils.matcherHint(\"toHaveBeenInterrupted\")}\\n\\n` +\n      `Expected interrupt value: ${utils.printExpected(expectedValue)}\\n` +\n      `Received interrupt value: ${utils.printReceived(actualValue)}`,\n    actual: actualValue,\n    expected: expectedValue,\n  };\n}\n\nexport function toHaveStructuredResponse(\n  this: ExpectExtendThis,\n  received: unknown,\n  expected?: Record<string, unknown>\n): ExpectationResult {\n  const { isNot, utils } = this;\n\n  const result = received as Record<string, any>;\n  const structuredResponse = result?.structuredResponse;\n  const isDefined = structuredResponse !== undefined;\n\n  if (!isDefined) {\n    return {\n      pass: false,\n      message: () =>\n        `${utils.matcherHint(\"toHaveStructuredResponse\")}\\n\\n` +\n        `Expected result ${isNot ? \"not \" : \"\"}to have a structured response\\n` +\n        `Received structuredResponse: undefined`,\n    };\n  }\n\n  if (expected === undefined) {\n    return {\n      pass: true,\n      message: () =>\n        `${utils.matcherHint(\"toHaveStructuredResponse\")}\\n\\n` +\n        `Expected result not to have a structured response`,\n    };\n  }\n\n  const fieldsPass = Object.entries(expected).every(([key, value]) =>\n    this.equals(structuredResponse[key], value)\n  );\n\n  return {\n    pass: fieldsPass,\n    message: () =>\n      `${utils.matcherHint(\"toHaveStructuredResponse\")}\\n\\n` +\n      `Expected structured response: ${utils.printExpected(expected)}\\n` +\n      `Received structured response: ${utils.printReceived(structuredResponse)}`,\n    actual: structuredResponse,\n    expected,\n  };\n}\n\n/**\n * All matcher functions bundled for convenient use with `expect.extend()`.\n */\nexport const langchainMatchers = {\n  toBeHumanMessage,\n  toBeAIMessage,\n  toBeSystemMessage,\n  toBeToolMessage,\n  toHaveToolCalls,\n  toHaveToolCallCount,\n  toContainToolCall,\n  toHaveToolMessages,\n  toHaveBeenInterrupted,\n  toHaveStructuredResponse,\n  ...streamMatchers,\n};\n\nexport interface LangChainMatchers<R = unknown> extends StreamMatchers<R> {\n  toBeHumanMessage(expected?: string | { content?: string; id?: string }): R;\n  toBeAIMessage(expected?: string | { content?: string; name?: string }): R;\n  toBeSystemMessage(\n    expected?: string | { content?: string; additional_kwargs?: object }\n  ): R;\n  toBeToolMessage(\n    expected?:\n      | string\n      | {\n          content?: string;\n          name?: string;\n          status?: string;\n          tool_call_id?: string;\n        }\n  ): R;\n  toHaveToolCalls(\n    expected: Array<{\n      name?: string;\n      id?: string;\n      args?: Record<string, unknown>;\n    }>\n  ): R;\n  toHaveToolCallCount(expected: number): R;\n  toContainToolCall(expected: {\n    name?: string;\n    id?: string;\n    args?: Record<string, unknown>;\n  }): R;\n  toHaveToolMessages(\n    expected: Array<{\n      content?: string;\n      name?: string;\n      status?: string;\n      tool_call_id?: string;\n    }>\n  ): R;\n  toHaveBeenInterrupted(expectedValue?: unknown): R;\n  toHaveStructuredResponse(expected?: Record<string, unknown>): R;\n}\n"],"mappings":"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"}