@langchain/core 1.1.28 → 1.1.30

package/dist/utils/testing/fake_model_builder.d.cts

@@ -0,0 +1,87 @@
+import { BaseMessage } from "../../messages/base.cjs";
+import { AIMessageChunk } from "../../messages/ai.cjs";
+import { MessageStructure, MessageToolSet } from "../../messages/message.cjs";
+import { ChatResult } from "../../outputs.cjs";
+import { InteropZodType } from "../types/zod.cjs";
+import { CallbackManagerForLLMRun } from "../../callbacks/manager.cjs";
+import { Runnable } from "../../runnables/base.cjs";
+import { BaseLanguageModelInput, StructuredOutputMethodOptions, StructuredOutputMethodParams } from "../../language_models/base.cjs";
+import { StructuredTool } from "../../tools/index.cjs";
+import { BaseChatModel, BaseChatModelCallOptions } from "../../language_models/chat_models.cjs";
+import { ToolSpec } from "./chat_models.cjs";
+
+//#region src/utils/testing/fake_model_builder.d.ts
+type ResponseFactory = (messages: BaseMessage[]) => BaseMessage | Error;
+interface FakeModelCall {
+  messages: BaseMessage[];
+  options: any;
+}
+/**
+ * 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.
+ *
+ * Each builder method queues a model response consumed in order per `invoke()`:
+ *
+ * `.respond(entry)` — enqueue a `BaseMessage`, `Error`, or factory function.
+ *
+ * `.respondWithTools(toolCalls[])` — enqueue an `AIMessage` with the given
+ * tool calls. Content is derived from the input messages automatically.
+ *
+ * Both can be mixed freely in one chain. When all queued responses are
+ * consumed, further invocations throw.
+ *
+ * Additional configuration:
+ * - `.alwaysThrow(error)` — every call throws (overrides the queue)
+ * - `.structuredResponse(value)` — value returned by `withStructuredOutput()`
+ *
+ * The model records all invocations in `.calls` / `.callCount`.
+ */
+declare class FakeBuiltModel extends BaseChatModel {
+  private queue;
+  private _alwaysThrowError;
+  private _structuredResponseValue;
+  private _tools;
+  private _callIndex;
+  private _calls;
+  get calls(): FakeModelCall[];
+  get callCount(): number;
+  constructor();
+  _llmType(): string;
+  _combineLLMOutput(): never[];
+  respond(entry: BaseMessage | Error | ResponseFactory): this;
+  respondWithTools(toolCalls: Array<{
+    name: string;
+    args: Record<string, any>;
+    id?: string;
+  }>): this;
+  alwaysThrow(error: Error): this;
+  structuredResponse(value: Record<string, any>): this;
+  bindTools(tools: (StructuredTool | ToolSpec)[]): Runnable<BaseLanguageModelInput, AIMessageChunk<MessageStructure<MessageToolSet>>, BaseChatModelCallOptions>;
+  withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(_params: StructuredOutputMethodParams<RunOutput, boolean> | InteropZodType<RunOutput> | Record<string, any>, _config?: StructuredOutputMethodOptions<boolean>): Runnable<BaseLanguageModelInput, RunOutput> | Runnable<BaseLanguageModelInput, {
+    raw: BaseMessage;
+    parsed: RunOutput;
+  }>;
+  _generate(messages: BaseMessage[], options?: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
+}
+/**
+ * Creates a fake chat model for testing.
+ *
+ * @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."
+ * ```
+ */
+declare function fakeModel(): FakeBuiltModel;
+//#endregion
+export { fakeModel };
+//# sourceMappingURL=fake_model_builder.d.cts.map

package/dist/utils/testing/fake_model_builder.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake_model_builder.d.cts","names":[],"sources":["../../../src/utils/testing/fake_model_builder.ts"],"mappings":";;;;;;;;;;;;;KAmBK,eAAA,IAAmB,QAAA,EAAU,WAAA,OAAkB,WAAA,GAAc,KAAA;AAAA,UAQxD,aAAA;EACR,QAAA,EAAU,WAAA;EACV,OAAA;AAAA;;;;;;;;;;;;;;AAVqE;;;;;;;;;cAgDjE,cAAA,SAAuB,aAAA;EAAA,QACnB,KAAA;EAAA,QAEA,iBAAA;EAAA,QAEA,wBAAA;EAAA,QAEA,MAAA;EAAA,QAEA,UAAA;EAAA,QAEA,MAAA;EAAA,IAEJ,KAAA,CAAA,GAAS,aAAA;EAAA,IAIT,SAAA,CAAA;EAIJ,WAAA,CAAA;EAIA,QAAA,CAAA;EAIA,iBAAA,CAAA;EAIA,OAAA,CAAQ,KAAA,EAAO,WAAA,GAAc,KAAA,GAAQ,eAAA;EAWrC,gBAAA,CACE,SAAA,EAAW,KAAA;IAAQ,IAAA;IAAc,IAAA,EAAM,MAAA;IAAqB,EAAA;EAAA;EAc9D,WAAA,CAAY,KAAA,EAAO,KAAA;EAKnB,kBAAA,CAAmB,KAAA,EAAO,MAAA;EAK1B,SAAA,CAAU,KAAA,GAAQ,cAAA,GAAiB,QAAA,MAAW,QAAA,CAAA,sBAAA,EAAA,cAAA,CAAA,gBAAA,CAAA,cAAA,IAAA,wBAAA;EAa9C,oBAAA,mBACoB,MAAA,gBAAsB,MAAA,cAAA,CAExC,OAAA,EACI,4BAAA,CAA6B,SAAA,aAC7B,cAAA,CAAe,SAAA,IACf,MAAA,eACJ,OAAA,GAAU,6BAAA,YAER,QAAA,CAAS,sBAAA,EAAwB,SAAA,IACjC,QAAA,CACE,sBAAA;IACE,GAAA,EAAK,WAAA;IAAa,MAAA,EAAQ,SAAA;EAAA;EAQ5B,SAAA,CACJ,QAAA,EAAU,WAAA,IACV,OAAA,8BACA,WAAA,GAAc,wBAAA,GACb,OAAA,CAAQ,UAAA;AAAA;;;;;;;;;;;;;;;;;iBAyEG,SAAA,CAAA,GAAa,cAAA"}

package/dist/utils/testing/fake_model_builder.d.ts

@@ -0,0 +1,88 @@
+import { BaseMessage } from "../../messages/base.js";
+import { AIMessageChunk } from "../../messages/ai.js";
+import { MessageStructure, MessageToolSet } from "../../messages/message.js";
+import { ChatResult } from "../../outputs.js";
+import { InteropZodType } from "../types/zod.js";
+import { CallbackManagerForLLMRun } from "../../callbacks/manager.js";
+import { Runnable } from "../../runnables/base.js";
+import { BaseLanguageModelInput, StructuredOutputMethodOptions, StructuredOutputMethodParams } from "../../language_models/base.js";
+import "../../messages/index.js";
+import { StructuredTool } from "../../tools/index.js";
+import { BaseChatModel, BaseChatModelCallOptions } from "../../language_models/chat_models.js";
+import { ToolSpec } from "./chat_models.js";
+
+//#region src/utils/testing/fake_model_builder.d.ts
+type ResponseFactory = (messages: BaseMessage[]) => BaseMessage | Error;
+interface FakeModelCall {
+  messages: BaseMessage[];
+  options: any;
+}
+/**
+ * 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.
+ *
+ * Each builder method queues a model response consumed in order per `invoke()`:
+ *
+ * `.respond(entry)` — enqueue a `BaseMessage`, `Error`, or factory function.
+ *
+ * `.respondWithTools(toolCalls[])` — enqueue an `AIMessage` with the given
+ * tool calls. Content is derived from the input messages automatically.
+ *
+ * Both can be mixed freely in one chain. When all queued responses are
+ * consumed, further invocations throw.
+ *
+ * Additional configuration:
+ * - `.alwaysThrow(error)` — every call throws (overrides the queue)
+ * - `.structuredResponse(value)` — value returned by `withStructuredOutput()`
+ *
+ * The model records all invocations in `.calls` / `.callCount`.
+ */
+declare class FakeBuiltModel extends BaseChatModel {
+  private queue;
+  private _alwaysThrowError;
+  private _structuredResponseValue;
+  private _tools;
+  private _callIndex;
+  private _calls;
+  get calls(): FakeModelCall[];
+  get callCount(): number;
+  constructor();
+  _llmType(): string;
+  _combineLLMOutput(): never[];
+  respond(entry: BaseMessage | Error | ResponseFactory): this;
+  respondWithTools(toolCalls: Array<{
+    name: string;
+    args: Record<string, any>;
+    id?: string;
+  }>): this;
+  alwaysThrow(error: Error): this;
+  structuredResponse(value: Record<string, any>): this;
+  bindTools(tools: (StructuredTool | ToolSpec)[]): Runnable<BaseLanguageModelInput, AIMessageChunk<MessageStructure<MessageToolSet>>, BaseChatModelCallOptions>;
+  withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(_params: StructuredOutputMethodParams<RunOutput, boolean> | InteropZodType<RunOutput> | Record<string, any>, _config?: StructuredOutputMethodOptions<boolean>): Runnable<BaseLanguageModelInput, RunOutput> | Runnable<BaseLanguageModelInput, {
+    raw: BaseMessage;
+    parsed: RunOutput;
+  }>;
+  _generate(messages: BaseMessage[], options?: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
+}
+/**
+ * Creates a fake chat model for testing.
+ *
+ * @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."
+ * ```
+ */
+declare function fakeModel(): FakeBuiltModel;
+//#endregion
+export { fakeModel };
+//# sourceMappingURL=fake_model_builder.d.ts.map

package/dist/utils/testing/fake_model_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake_model_builder.d.ts","names":[],"sources":["../../../src/utils/testing/fake_model_builder.ts"],"mappings":";;;;;;;;;;;;;;KAmBK,eAAA,IAAmB,QAAA,EAAU,WAAA,OAAkB,WAAA,GAAc,KAAA;AAAA,UAQxD,aAAA;EACR,QAAA,EAAU,WAAA;EACV,OAAA;AAAA;AAZ+C;;;;;;;;;;;;;;AAEsB;;;;;;;;AAFtB,cAkD3C,cAAA,SAAuB,aAAA;EAAA,QACnB,KAAA;EAAA,QAEA,iBAAA;EAAA,QAEA,wBAAA;EAAA,QAEA,MAAA;EAAA,QAEA,UAAA;EAAA,QAEA,MAAA;EAAA,IAEJ,KAAA,CAAA,GAAS,aAAA;EAAA,IAIT,SAAA,CAAA;EAIJ,WAAA,CAAA;EAIA,QAAA,CAAA;EAIA,iBAAA,CAAA;EAIA,OAAA,CAAQ,KAAA,EAAO,WAAA,GAAc,KAAA,GAAQ,eAAA;EAWrC,gBAAA,CACE,SAAA,EAAW,KAAA;IAAQ,IAAA;IAAc,IAAA,EAAM,MAAA;IAAqB,EAAA;EAAA;EAc9D,WAAA,CAAY,KAAA,EAAO,KAAA;EAKnB,kBAAA,CAAmB,KAAA,EAAO,MAAA;EAK1B,SAAA,CAAU,KAAA,GAAQ,cAAA,GAAiB,QAAA,MAAW,QAAA,CAAA,sBAAA,EAAA,cAAA,CAAA,gBAAA,CAAA,cAAA,IAAA,wBAAA;EAa9C,oBAAA,mBACoB,MAAA,gBAAsB,MAAA,cAAA,CAExC,OAAA,EACI,4BAAA,CAA6B,SAAA,aAC7B,cAAA,CAAe,SAAA,IACf,MAAA,eACJ,OAAA,GAAU,6BAAA,YAER,QAAA,CAAS,sBAAA,EAAwB,SAAA,IACjC,QAAA,CACE,sBAAA;IACE,GAAA,EAAK,WAAA;IAAa,MAAA,EAAQ,SAAA;EAAA;EAQ5B,SAAA,CACJ,QAAA,EAAU,WAAA,IACV,OAAA,8BACA,WAAA,GAAc,wBAAA,GACb,OAAA,CAAQ,UAAA;AAAA;;;;;;;;;;;;;;;;;iBAyEG,SAAA,CAAA,GAAa,cAAA"}

package/dist/utils/testing/fake_model_builder.js

@@ -0,0 +1,174 @@
+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/utils/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.
+*
+* Each builder method queues a model response consumed in order per `invoke()`:
+*
+* `.respond(entry)` — enqueue a `BaseMessage`, `Error`, or factory function.
+*
+* `.respondWithTools(toolCalls[])` — enqueue an `AIMessage` with the given
+* tool calls. Content is derived from the input messages automatically.
+*
+* Both can be mixed freely in one chain. When all queued responses are
+* consumed, further invocations throw.
+*
+* Additional configuration:
+* - `.alwaysThrow(error)` — every call throws (overrides the queue)
+* - `.structuredResponse(value)` — value returned by `withStructuredOutput()`
+*
+* The model records all invocations in `.calls` / `.callCount`.
+*/
+var FakeBuiltModel = class FakeBuiltModel extends BaseChatModel {
+	queue = [];
+	_alwaysThrowError;
+	_structuredResponseValue;
+	_tools = [];
+	_callIndex = 0;
+	_calls = [];
+	get calls() {
+		return this._calls;
+	}
+	get callCount() {
+		return this._calls.length;
+	}
+	constructor() {
+		super({});
+	}
+	_llmType() {
+		return "fake-model-builder";
+	}
+	_combineLLMOutput() {
+		return [];
+	}
+	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;
+	}
+	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;
+	}
+	alwaysThrow(error) {
+		this._alwaysThrowError = error;
+		return this;
+	}
+	structuredResponse(value) {
+		this._structuredResponseValue = value;
+		return this;
+	}
+	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._calls = this._calls;
+		next._callIndex = this._callIndex;
+		return next.withConfig({});
+	}
+	withStructuredOutput(_params, _config) {
+		const { _structuredResponseValue } = this;
+		return RunnableLambda.from(async () => {
+			return _structuredResponseValue;
+		});
+	}
+	async _generate(messages, options, _runManager) {
+		this._calls.push({
+			messages: [...messages],
+			options
+		});
+		const currentCallIndex = this._callIndex;
+		this._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 fake chat model for testing.
+*
+* @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 { fakeModel };
+//# sourceMappingURL=fake_model_builder.js.map

package/dist/utils/testing/fake_model_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake_model_builder.js","names":[],"sources":["../../../src/utils/testing/fake_model_builder.ts"],"sourcesContent":["/* eslint-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 \"../types/zod.js\";\nimport type { ToolSpec } from \"./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\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 *\n * Each builder method queues a model response consumed in order per `invoke()`:\n *\n * `.respond(entry)` — enqueue a `BaseMessage`, `Error`, or factory function.\n *\n * `.respondWithTools(toolCalls[])` — enqueue an `AIMessage` with the given\n * tool calls. Content is derived from the input messages automatically.\n *\n * Both can be mixed freely in one chain. When all queued responses are\n * consumed, further invocations throw.\n *\n * Additional configuration:\n * - `.alwaysThrow(error)` — every call throws (overrides the queue)\n * - `.structuredResponse(value)` — value returned by `withStructuredOutput()`\n *\n * The model records all invocations in `.calls` / `.callCount`.\n */\nclass 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 _callIndex = 0;\n\n  private _calls: FakeModelCall[] = [];\n\n  get calls(): FakeModelCall[] {\n    return this._calls;\n  }\n\n  get callCount(): number {\n    return this._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  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  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  alwaysThrow(error: Error): this {\n    this._alwaysThrowError = error;\n    return this;\n  }\n\n  structuredResponse(value: Record<string, any>): this {\n    this._structuredResponseValue = value;\n    return this;\n  }\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._calls = this._calls;\n    next._callIndex = this._callIndex;\n\n    return next.withConfig({} as BaseChatModelCallOptions);\n  }\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._calls.push({ messages: [...messages], options });\n\n    const currentCallIndex = this._callIndex;\n    this._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 fake chat model for testing.\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":";;;;;;;AAgCA,SAAS,cAAc,UAAiC;AACtD,QAAO,SACJ,KAAK,MAAM,EAAE,KAAK,CAClB,OAAO,QAAQ,CACf,KAAK,IAAI;;AAGd,IAAI,YAAY;AAChB,SAAS,iBAAyB;AAChC,cAAa;AACb,QAAO,WAAW;;;;;;;;;;;;;;;;;;;;;;;;AAyBpB,IAAM,iBAAN,MAAM,uBAAuB,cAAc;CACzC,AAAQ,QAAsB,EAAE;CAEhC,AAAQ;CAER,AAAQ;CAER,AAAQ,SAAwC,EAAE;CAElD,AAAQ,aAAa;CAErB,AAAQ,SAA0B,EAAE;CAEpC,IAAI,QAAyB;AAC3B,SAAO,KAAK;;CAGd,IAAI,YAAoB;AACtB,SAAO,KAAK,OAAO;;CAGrB,cAAc;AACZ,QAAM,EAAE,CAAC;;CAGX,WAAmB;AACjB,SAAO;;CAGT,oBAAoB;AAClB,SAAO,EAAE;;CAGX,QAAQ,OAAoD;AAC1D,MAAI,OAAO,UAAU,WACnB,MAAK,MAAM,KAAK;GAAE,MAAM;GAAW,SAAS;GAAO,CAAC;WAC3C,YAAY,WAAW,MAAM,CACtC,MAAK,MAAM,KAAK;GAAE,MAAM;GAAW,SAAS;GAAO,CAAC;MAEpD,MAAK,MAAM,KAAK;GAAE,MAAM;GAAS,OAAO;GAAO,CAAC;AAElD,SAAO;;CAGT,iBACE,WACM;AACN,OAAK,MAAM,KAAK;GACd,MAAM;GACN,WAAW,UAAU,KAAK,QAAQ;IAChC,MAAM,GAAG;IACT,MAAM,GAAG;IACT,IAAI,GAAG,MAAM,gBAAgB;IAC7B,MAAM;IACP,EAAE;GACJ,CAAC;AACF,SAAO;;CAGT,YAAY,OAAoB;AAC9B,OAAK,oBAAoB;AACzB,SAAO;;CAGT,mBAAmB,OAAkC;AACnD,OAAK,2BAA2B;AAChC,SAAO;;CAGT,UAAU,OAAsC;EAC9C,MAAM,SAAS,CAAC,GAAG,KAAK,QAAQ,GAAG,MAAM;EACzC,MAAM,OAAO,IAAI,gBAAgB;AACjC,OAAK,QAAQ,KAAK;AAClB,OAAK,oBAAoB,KAAK;AAC9B,OAAK,2BAA2B,KAAK;AACrC,OAAK,SAAS;AACd,OAAK,SAAS,KAAK;AACnB,OAAK,aAAa,KAAK;AAEvB,SAAO,KAAK,WAAW,EAAE,CAA6B;;CAGxD,qBAGE,SAIA,SAMI;EACJ,MAAM,EAAE,6BAA6B;AACrC,SAAO,eAAe,KAAK,YAAY;AACrC,UAAO;IACP;;CAGJ,MAAM,UACJ,UACA,SACA,aACqB;AACrB,OAAK,OAAO,KAAK;GAAE,UAAU,CAAC,GAAG,SAAS;GAAE;GAAS,CAAC;EAEtD,MAAM,mBAAmB,KAAK;AAC9B,OAAK,cAAc;AAEnB,MAAI,KAAK,kBACP,OAAM,KAAK;EAGb,MAAM,QAAQ,KAAK,MAAM;AACzB,MAAI,CAAC,MACH,OAAM,IAAI,MACR,gDAAgD,iBAAiB,IAAI,KAAK,MAAM,OAAO,iBACxF;AAGH,MAAI,MAAM,SAAS,QACjB,OAAM,MAAM;AAGd,MAAI,MAAM,SAAS,WAAW;GAC5B,MAAM,SAAS,MAAM,QAAQ,SAAS;AACtC,OAAI,CAAC,YAAY,WAAW,OAAO,CACjC,OAAM;AAER,UAAO,EACL,aAAa,CAAC;IAAE,MAAM;IAAI,SAAS;IAAQ,CAAC,EAC7C;;AAGH,MAAI,MAAM,SAAS,UACjB,QAAO,EACL,aAAa,CAAC;GAAE,MAAM;GAAI,SAAS,MAAM;GAAS,CAAC,EACpD;EAGH,MAAM,UAAU,cAAc,SAAS;AAavC,SAAO;GACL,aAAa,CAAC;IAAE,MAAM;IAAS,SAbjB,IAAI,UAAU;KAC5B;KACA,IAAI,iBAAiB,UAAU;KAC/B,YACE,MAAM,UAAU,SAAS,IACrB,MAAM,UAAU,KAAK,QAAQ;MAC3B,GAAG;MACH,MAAM;MACP,EAAE,GACH;KACP,CAAC;IAGwC,CAAC;GACzC,WAAW,EAAE;GACd;;;;;;;;;;;;;;;;;;;AAoBL,SAAgB,YAA4B;AAC1C,QAAO,IAAI,gBAAgB"}

package/dist/utils/testing/index.cjs

@@ -10,6 +10,7 @@ const require_runnables = require('./runnables.cjs');
 const require_tools = require('./tools.cjs');
 const require_tracers = require('./tracers.cjs');
 const require_vectorstores = require('./vectorstores.cjs');
+const require_fake_model_builder = require('./fake_model_builder.cjs');
 
 //#region src/utils/testing/index.ts
 var testing_exports = /* @__PURE__ */ require_runtime.__exportAll({
@@ -28,7 +29,8 @@ var testing_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	FakeTracer: () => require_message_history.FakeTracer,
 	FakeVectorStore: () => require_vectorstores.FakeVectorStore,
 	SingleRunExtractor: () => require_tracers.SingleRunExtractor,
-	SyntheticEmbeddings: () => require_embeddings.SyntheticEmbeddings
+	SyntheticEmbeddings: () => require_embeddings.SyntheticEmbeddings,
+	fakeModel: () => require_fake_model_builder.fakeModel
 });
 
 //#endregion
@@ -48,6 +50,7 @@ exports.FakeTracer = require_message_history.FakeTracer;
 exports.FakeVectorStore = require_vectorstores.FakeVectorStore;
 exports.SingleRunExtractor = require_tracers.SingleRunExtractor;
 exports.SyntheticEmbeddings = require_embeddings.SyntheticEmbeddings;
+exports.fakeModel = require_fake_model_builder.fakeModel;
 Object.defineProperty(exports, 'testing_exports', {
   enumerable: true,
   get: function () {

package/dist/utils/testing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/utils/testing/index.ts"],"sourcesContent":["export * from \"./chat_models.js\";\nexport * from \"./embeddings.js\";\nexport * from \"./llms.js\";\nexport * from \"./message_history.js\";\nexport * from \"./output_parsers.js\";\nexport * from \"./retrievers.js\";\nexport * from \"./runnables.js\";\nexport * from \"./tools.js\";\nexport * from \"./tracers.js\";\nexport * from \"./vectorstores.js\";\n"],"mappings":""}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/utils/testing/index.ts"],"sourcesContent":["export * from \"./chat_models.js\";\nexport * from \"./embeddings.js\";\nexport * from \"./llms.js\";\nexport * from \"./message_history.js\";\nexport * from \"./output_parsers.js\";\nexport * from \"./retrievers.js\";\nexport * from \"./runnables.js\";\nexport * from \"./tools.js\";\nexport * from \"./tracers.js\";\nexport * from \"./vectorstores.js\";\nexport { fakeModel } from \"./fake_model_builder.js\";\n"],"mappings":""}

package/dist/utils/testing/index.d.cts

@@ -8,4 +8,5 @@ import { FakeRunnable } from "./runnables.cjs";
 import { FakeTool, FakeToolParams } from "./tools.cjs";
 import { SingleRunExtractor } from "./tracers.cjs";
 import { FakeVectorStore, FakeVectorStoreArgs } from "./vectorstores.cjs";
-export { FakeChatInput, FakeChatMessageHistory, FakeChatModel, FakeEmbeddings, FakeLLM, FakeListChatMessageHistory, FakeListChatModel, FakeListChatModelCallOptions, FakeRetriever, FakeRunnable, FakeSplitIntoListParser, FakeStreamingChatModel, FakeStreamingChatModelCallOptions, FakeStreamingChatModelFields, FakeStreamingLLM, FakeTool, FakeToolParams, FakeTracer, FakeVectorStore, FakeVectorStoreArgs, SingleRunExtractor, SyntheticEmbeddings, ToolSpec };
+import { fakeModel } from "./fake_model_builder.cjs";
+export { FakeChatInput, FakeChatMessageHistory, FakeChatModel, FakeEmbeddings, FakeLLM, FakeListChatMessageHistory, FakeListChatModel, FakeListChatModelCallOptions, FakeRetriever, FakeRunnable, FakeSplitIntoListParser, FakeStreamingChatModel, FakeStreamingChatModelCallOptions, FakeStreamingChatModelFields, FakeStreamingLLM, FakeTool, FakeToolParams, FakeTracer, FakeVectorStore, FakeVectorStoreArgs, SingleRunExtractor, SyntheticEmbeddings, ToolSpec, fakeModel };

package/dist/utils/testing/index.d.ts

@@ -8,4 +8,5 @@ import { FakeRunnable } from "./runnables.js";
 import { FakeTool, FakeToolParams } from "./tools.js";
 import { SingleRunExtractor } from "./tracers.js";
 import { FakeVectorStore, FakeVectorStoreArgs } from "./vectorstores.js";
-export { FakeChatInput, FakeChatMessageHistory, FakeChatModel, FakeEmbeddings, FakeLLM, FakeListChatMessageHistory, FakeListChatModel, FakeListChatModelCallOptions, FakeRetriever, FakeRunnable, FakeSplitIntoListParser, FakeStreamingChatModel, FakeStreamingChatModelCallOptions, FakeStreamingChatModelFields, FakeStreamingLLM, FakeTool, FakeToolParams, FakeTracer, FakeVectorStore, FakeVectorStoreArgs, SingleRunExtractor, SyntheticEmbeddings, ToolSpec };
+import { fakeModel } from "./fake_model_builder.js";
+export { FakeChatInput, FakeChatMessageHistory, FakeChatModel, FakeEmbeddings, FakeLLM, FakeListChatMessageHistory, FakeListChatModel, FakeListChatModelCallOptions, FakeRetriever, FakeRunnable, FakeSplitIntoListParser, FakeStreamingChatModel, FakeStreamingChatModelCallOptions, FakeStreamingChatModelFields, FakeStreamingLLM, FakeTool, FakeToolParams, FakeTracer, FakeVectorStore, FakeVectorStoreArgs, SingleRunExtractor, SyntheticEmbeddings, ToolSpec, fakeModel };

package/dist/utils/testing/index.js

@@ -9,6 +9,7 @@ import { FakeRunnable } from "./runnables.js";
 import { FakeTool } from "./tools.js";
 import { SingleRunExtractor } from "./tracers.js";
 import { FakeVectorStore } from "./vectorstores.js";
+import { fakeModel } from "./fake_model_builder.js";
 
 //#region src/utils/testing/index.ts
 var testing_exports = /* @__PURE__ */ __exportAll({
@@ -27,9 +28,10 @@ var testing_exports = /* @__PURE__ */ __exportAll({
 	FakeTracer: () => FakeTracer,
 	FakeVectorStore: () => FakeVectorStore,
 	SingleRunExtractor: () => SingleRunExtractor,
-	SyntheticEmbeddings: () => SyntheticEmbeddings
+	SyntheticEmbeddings: () => SyntheticEmbeddings,
+	fakeModel: () => fakeModel
 });
 
 //#endregion
-export { FakeChatMessageHistory, FakeChatModel, FakeEmbeddings, FakeLLM, FakeListChatMessageHistory, FakeListChatModel, FakeRetriever, FakeRunnable, FakeSplitIntoListParser, FakeStreamingChatModel, FakeStreamingLLM, FakeTool, FakeTracer, FakeVectorStore, SingleRunExtractor, SyntheticEmbeddings, testing_exports };
+export { FakeChatMessageHistory, FakeChatModel, FakeEmbeddings, FakeLLM, FakeListChatMessageHistory, FakeListChatModel, FakeRetriever, FakeRunnable, FakeSplitIntoListParser, FakeStreamingChatModel, FakeStreamingLLM, FakeTool, FakeTracer, FakeVectorStore, SingleRunExtractor, SyntheticEmbeddings, fakeModel, testing_exports };
 //# sourceMappingURL=index.js.map

package/dist/utils/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/utils/testing/index.ts"],"sourcesContent":["export * from \"./chat_models.js\";\nexport * from \"./embeddings.js\";\nexport * from \"./llms.js\";\nexport * from \"./message_history.js\";\nexport * from \"./output_parsers.js\";\nexport * from \"./retrievers.js\";\nexport * from \"./runnables.js\";\nexport * from \"./tools.js\";\nexport * from \"./tracers.js\";\nexport * from \"./vectorstores.js\";\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/utils/testing/index.ts"],"sourcesContent":["export * from \"./chat_models.js\";\nexport * from \"./embeddings.js\";\nexport * from \"./llms.js\";\nexport * from \"./message_history.js\";\nexport * from \"./output_parsers.js\";\nexport * from \"./retrievers.js\";\nexport * from \"./runnables.js\";\nexport * from \"./tools.js\";\nexport * from \"./tracers.js\";\nexport * from \"./vectorstores.js\";\nexport { fakeModel } from \"./fake_model_builder.js\";\n"],"mappings":""}

package/dist/utils/types/zod.cjs

@@ -136,7 +136,7 @@ function interopParse(schema, input) {
 	throw new Error("Schema must be an instance of z3.ZodType or z4.$ZodType");
 }
 /**
-* Retrieves the description from a schema definition (v3, v4, or plain object), if available.
+* Retrieves the description from a schema definition (v3, v4, standard schema, or plain object), if available.
 *
 * @param {unknown} schema - The schema to extract the description from.
 * @returns {string | undefined} The description of the schema, or undefined if not present.