@langchain/core 1.2.0-dev-1765937705265 → 1.2.0

package/dist/testing/matchers.d.cts

@@ -0,0 +1,98 @@
+import { StreamMatchers, toHaveStreamOutput, toHaveStreamReasoning, toHaveStreamText, toHaveStreamToolCalls, toHaveStreamUsage } from "../utils/testing/stream.cjs";
+
+//#region src/testing/matchers.d.ts
+/**
+ * The `this` context that Vitest and Jest provide to custom matchers
+ * via `expect.extend`.
+ *
+ * Compatible with both frameworks:
+ * - https://vitest.dev/guide/extending-matchers.html
+ * - https://jestjs.io/docs/expect#expectextendmatchers
+ */
+interface ExpectExtendThis {
+  isNot?: boolean;
+  equals(a: unknown, b: unknown): boolean;
+  utils: {
+    matcherHint(name: string, received?: string, expected?: string): string;
+    printReceived(value: unknown): string;
+    printExpected(value: unknown): string;
+  };
+}
+interface ExpectationResult {
+  pass: boolean;
+  message: () => string;
+  actual?: unknown;
+  expected?: unknown;
+}
+declare const toBeHumanMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare const toBeAIMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare const toBeSystemMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare const toBeToolMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare function toHaveToolCalls(this: ExpectExtendThis, received: unknown, expected: Array<Record<string, unknown>>): ExpectationResult;
+declare function toHaveToolCallCount(this: ExpectExtendThis, received: unknown, expected: number): ExpectationResult;
+declare function toContainToolCall(this: ExpectExtendThis, received: unknown, expected: Record<string, unknown>): ExpectationResult;
+declare function toHaveToolMessages(this: ExpectExtendThis, received: unknown, expected: Array<Record<string, unknown>>): ExpectationResult;
+declare function toHaveBeenInterrupted(this: ExpectExtendThis, received: unknown, expectedValue?: unknown): ExpectationResult;
+declare function toHaveStructuredResponse(this: ExpectExtendThis, received: unknown, expected?: Record<string, unknown>): ExpectationResult;
+/**
+ * All matcher functions bundled for convenient use with `expect.extend()`.
+ */
+declare const langchainMatchers: {
+  toHaveStreamText: typeof toHaveStreamText;
+  toHaveStreamReasoning: typeof toHaveStreamReasoning;
+  toHaveStreamToolCalls: typeof toHaveStreamToolCalls;
+  toHaveStreamUsage: typeof toHaveStreamUsage;
+  toHaveStreamOutput: typeof toHaveStreamOutput;
+  toBeHumanMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toBeAIMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toBeSystemMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toBeToolMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toHaveToolCalls: typeof toHaveToolCalls;
+  toHaveToolCallCount: typeof toHaveToolCallCount;
+  toContainToolCall: typeof toContainToolCall;
+  toHaveToolMessages: typeof toHaveToolMessages;
+  toHaveBeenInterrupted: typeof toHaveBeenInterrupted;
+  toHaveStructuredResponse: typeof toHaveStructuredResponse;
+};
+interface LangChainMatchers<R = unknown> extends StreamMatchers<R> {
+  toBeHumanMessage(expected?: string | {
+    content?: string;
+    id?: string;
+  }): R;
+  toBeAIMessage(expected?: string | {
+    content?: string;
+    name?: string;
+  }): R;
+  toBeSystemMessage(expected?: string | {
+    content?: string;
+    additional_kwargs?: object;
+  }): R;
+  toBeToolMessage(expected?: string | {
+    content?: string;
+    name?: string;
+    status?: string;
+    tool_call_id?: string;
+  }): R;
+  toHaveToolCalls(expected: Array<{
+    name?: string;
+    id?: string;
+    args?: Record<string, unknown>;
+  }>): R;
+  toHaveToolCallCount(expected: number): R;
+  toContainToolCall(expected: {
+    name?: string;
+    id?: string;
+    args?: Record<string, unknown>;
+  }): R;
+  toHaveToolMessages(expected: Array<{
+    content?: string;
+    name?: string;
+    status?: string;
+    tool_call_id?: string;
+  }>): R;
+  toHaveBeenInterrupted(expectedValue?: unknown): R;
+  toHaveStructuredResponse(expected?: Record<string, unknown>): R;
+}
+//#endregion
+export { LangChainMatchers, langchainMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages };
+//# sourceMappingURL=matchers.d.cts.map

package/dist/testing/matchers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.cts","names":[],"sources":["../../src/testing/matchers.ts"],"mappings":";;;;;AAIoC;;;;;;UAe1B,gBAAA;EACR,KAAA;EACA,MAAA,CAAO,CAAA,WAAY,CAAA;EACnB,KAAA;IACE,WAAA,CAAY,IAAA,UAAc,QAAA,WAAmB,QAAA;IAC7C,aAAA,CAAc,KAAA;IACd,aAAA,CAAc,KAAA;EAAA;AAAA;AAAA,UAIR,iBAAA;EACR,IAAA;EACA,OAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,cAoFW,gBAAA,GAAgB,IAAA,EAvEnB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,cAyEQ,aAAA,GAAa,IAAA,EA5EhB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,cA8EQ,iBAAA,GAAiB,IAAA,EAjFpB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,cAmFQ,eAAA,GAAe,IAAA,EAtFlB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,iBAwFW,eAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,EAAU,KAAA,CAAM,MAAA,qBACf,iBAAA;AAAA,iBAwDa,mBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,WACC,iBAAA;AAAA,iBA2Ba,iBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,EAAU,MAAA,oBACT,iBAAA;AAAA,iBA+Ba,kBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,EAAU,KAAA,CAAM,MAAA,qBACf,iBAAA;AAAA,iBA6Da,qBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,aAAA,aACC,iBAAA;AAAA,iBAyCa,wBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,GAAW,MAAA,oBACV,iBAAA;;;;cA4CU,iBAAA;2BAYZ,gBAAA;;;;;2BAnYS,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;;;;;;;;;;;UAkYY,iBAAA,sBAAuC,cAAA,CAAe,CAAA;EACrE,gBAAA,CAAiB,QAAA;IAAsB,OAAA;IAAkB,EAAA;EAAA,IAAgB,CAAA;EACzE,aAAA,CAAc,QAAA;IAAsB,OAAA;IAAkB,IAAA;EAAA,IAAkB,CAAA;EACxE,iBAAA,CACE,QAAA;IAAsB,OAAA;IAAkB,iBAAA;EAAA,IACvC,CAAA;EACH,eAAA,CACE,QAAA;IAGM,OAAA;IACA,IAAA;IACA,MAAA;IACA,YAAA;EAAA,IAEL,CAAA;EACH,eAAA,CACE,QAAA,EAAU,KAAA;IACR,IAAA;IACA,EAAA;IACA,IAAA,GAAO,MAAA;EAAA,KAER,CAAA;EACH,mBAAA,CAAoB,QAAA,WAAmB,CAAA;EACvC,iBAAA,CAAkB,QAAA;IAChB,IAAA;IACA,EAAA;IACA,IAAA,GAAO,MAAA;EAAA,IACL,CAAA;EACJ,kBAAA,CACE,QAAA,EAAU,KAAA;IACR,OAAA;IACA,IAAA;IACA,MAAA;IACA,YAAA;EAAA,KAED,CAAA;EACH,qBAAA,CAAsB,aAAA,aAA0B,CAAA;EAChD,wBAAA,CAAyB,QAAA,GAAW,MAAA,oBAA0B,CAAA;AAAA"}

package/dist/testing/matchers.d.ts

@@ -0,0 +1,98 @@
+import { StreamMatchers, toHaveStreamOutput, toHaveStreamReasoning, toHaveStreamText, toHaveStreamToolCalls, toHaveStreamUsage } from "../utils/testing/stream.js";
+
+//#region src/testing/matchers.d.ts
+/**
+ * The `this` context that Vitest and Jest provide to custom matchers
+ * via `expect.extend`.
+ *
+ * Compatible with both frameworks:
+ * - https://vitest.dev/guide/extending-matchers.html
+ * - https://jestjs.io/docs/expect#expectextendmatchers
+ */
+interface ExpectExtendThis {
+  isNot?: boolean;
+  equals(a: unknown, b: unknown): boolean;
+  utils: {
+    matcherHint(name: string, received?: string, expected?: string): string;
+    printReceived(value: unknown): string;
+    printExpected(value: unknown): string;
+  };
+}
+interface ExpectationResult {
+  pass: boolean;
+  message: () => string;
+  actual?: unknown;
+  expected?: unknown;
+}
+declare const toBeHumanMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare const toBeAIMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare const toBeSystemMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare const toBeToolMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+declare function toHaveToolCalls(this: ExpectExtendThis, received: unknown, expected: Array<Record<string, unknown>>): ExpectationResult;
+declare function toHaveToolCallCount(this: ExpectExtendThis, received: unknown, expected: number): ExpectationResult;
+declare function toContainToolCall(this: ExpectExtendThis, received: unknown, expected: Record<string, unknown>): ExpectationResult;
+declare function toHaveToolMessages(this: ExpectExtendThis, received: unknown, expected: Array<Record<string, unknown>>): ExpectationResult;
+declare function toHaveBeenInterrupted(this: ExpectExtendThis, received: unknown, expectedValue?: unknown): ExpectationResult;
+declare function toHaveStructuredResponse(this: ExpectExtendThis, received: unknown, expected?: Record<string, unknown>): ExpectationResult;
+/**
+ * All matcher functions bundled for convenient use with `expect.extend()`.
+ */
+declare const langchainMatchers: {
+  toHaveStreamText: typeof toHaveStreamText;
+  toHaveStreamReasoning: typeof toHaveStreamReasoning;
+  toHaveStreamToolCalls: typeof toHaveStreamToolCalls;
+  toHaveStreamUsage: typeof toHaveStreamUsage;
+  toHaveStreamOutput: typeof toHaveStreamOutput;
+  toBeHumanMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toBeAIMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toBeSystemMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toBeToolMessage: (this: ExpectExtendThis, received: unknown, expected?: string | Record<string, unknown>) => ExpectationResult;
+  toHaveToolCalls: typeof toHaveToolCalls;
+  toHaveToolCallCount: typeof toHaveToolCallCount;
+  toContainToolCall: typeof toContainToolCall;
+  toHaveToolMessages: typeof toHaveToolMessages;
+  toHaveBeenInterrupted: typeof toHaveBeenInterrupted;
+  toHaveStructuredResponse: typeof toHaveStructuredResponse;
+};
+interface LangChainMatchers<R = unknown> extends StreamMatchers<R> {
+  toBeHumanMessage(expected?: string | {
+    content?: string;
+    id?: string;
+  }): R;
+  toBeAIMessage(expected?: string | {
+    content?: string;
+    name?: string;
+  }): R;
+  toBeSystemMessage(expected?: string | {
+    content?: string;
+    additional_kwargs?: object;
+  }): R;
+  toBeToolMessage(expected?: string | {
+    content?: string;
+    name?: string;
+    status?: string;
+    tool_call_id?: string;
+  }): R;
+  toHaveToolCalls(expected: Array<{
+    name?: string;
+    id?: string;
+    args?: Record<string, unknown>;
+  }>): R;
+  toHaveToolCallCount(expected: number): R;
+  toContainToolCall(expected: {
+    name?: string;
+    id?: string;
+    args?: Record<string, unknown>;
+  }): R;
+  toHaveToolMessages(expected: Array<{
+    content?: string;
+    name?: string;
+    status?: string;
+    tool_call_id?: string;
+  }>): R;
+  toHaveBeenInterrupted(expectedValue?: unknown): R;
+  toHaveStructuredResponse(expected?: Record<string, unknown>): R;
+}
+//#endregion
+export { LangChainMatchers, langchainMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages };
+//# sourceMappingURL=matchers.d.ts.map

package/dist/testing/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","names":[],"sources":["../../src/testing/matchers.ts"],"mappings":";;;;;AAIoC;;;;;;UAe1B,gBAAA;EACR,KAAA;EACA,MAAA,CAAO,CAAA,WAAY,CAAA;EACnB,KAAA;IACE,WAAA,CAAY,IAAA,UAAc,QAAA,WAAmB,QAAA;IAC7C,aAAA,CAAc,KAAA;IACd,aAAA,CAAc,KAAA;EAAA;AAAA;AAAA,UAIR,iBAAA;EACR,IAAA;EACA,OAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,cAoFW,gBAAA,GAAgB,IAAA,EAvEnB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,cAyEQ,aAAA,GAAa,IAAA,EA5EhB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,cA8EQ,iBAAA,GAAiB,IAAA,EAjFpB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,cAmFQ,eAAA,GAAe,IAAA,EAtFlB,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;AAAA,iBAwFW,eAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,EAAU,KAAA,CAAM,MAAA,qBACf,iBAAA;AAAA,iBAwDa,mBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,WACC,iBAAA;AAAA,iBA2Ba,iBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,EAAU,MAAA,oBACT,iBAAA;AAAA,iBA+Ba,kBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,EAAU,KAAA,CAAM,MAAA,qBACf,iBAAA;AAAA,iBA6Da,qBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,aAAA,aACC,iBAAA;AAAA,iBAyCa,wBAAA,CACd,IAAA,EAAM,gBAAA,EACN,QAAA,WACA,QAAA,GAAW,MAAA,oBACV,iBAAA;;;;cA4CU,iBAAA;2BAYZ,gBAAA;;;;;2BAnYS,gBAAA,EAAgB,QAAA,WACL,QAAA,YACG,MAAA,sBACnB,iBAAA;;;;;;;;;;;UAkYY,iBAAA,sBAAuC,cAAA,CAAe,CAAA;EACrE,gBAAA,CAAiB,QAAA;IAAsB,OAAA;IAAkB,EAAA;EAAA,IAAgB,CAAA;EACzE,aAAA,CAAc,QAAA;IAAsB,OAAA;IAAkB,IAAA;EAAA,IAAkB,CAAA;EACxE,iBAAA,CACE,QAAA;IAAsB,OAAA;IAAkB,iBAAA;EAAA,IACvC,CAAA;EACH,eAAA,CACE,QAAA;IAGM,OAAA;IACA,IAAA;IACA,MAAA;IACA,YAAA;EAAA,IAEL,CAAA;EACH,eAAA,CACE,QAAA,EAAU,KAAA;IACR,IAAA;IACA,EAAA;IACA,IAAA,GAAO,MAAA;EAAA,KAER,CAAA;EACH,mBAAA,CAAoB,QAAA,WAAmB,CAAA;EACvC,iBAAA,CAAkB,QAAA;IAChB,IAAA;IACA,EAAA;IACA,IAAA,GAAO,MAAA;EAAA,IACL,CAAA;EACJ,kBAAA,CACE,QAAA,EAAU,KAAA;IACR,OAAA;IACA,IAAA;IACA,MAAA;IACA,YAAA;EAAA,KAED,CAAA;EACH,qBAAA,CAAsB,aAAA,aAA0B,CAAA;EAChD,wBAAA,CAAyB,QAAA,GAAW,MAAA,oBAA0B,CAAA;AAAA"}

package/dist/testing/matchers.js

@@ -0,0 +1,204 @@
+import { BaseMessage } from "../messages/base.js";
+import { ToolMessage } from "../messages/tool.js";
+import { AIMessage } from "../messages/ai.js";
+import { HumanMessage } from "../messages/human.js";
+import { SystemMessage } from "../messages/system.js";
+import "../messages/index.js";
+import { streamMatchers } from "../utils/testing/stream.js";
+//#region src/testing/matchers.ts
+function getMessageTypeName(msg) {
+	if (!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", HumanMessage.isInstance);
+const toBeAIMessage = makeMessageTypeMatcher("AIMessage", AIMessage.isInstance);
+const toBeSystemMessage = makeMessageTypeMatcher("SystemMessage", SystemMessage.isInstance);
+const toBeToolMessage = makeMessageTypeMatcher("ToolMessage", ToolMessage.isInstance);
+function toHaveToolCalls(received, expected) {
+	const { isNot, utils } = this;
+	if (!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 (!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 (!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(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,
+	...streamMatchers
+};
+//#endregion
+export { langchainMatchers, toBeAIMessage, toBeHumanMessage, toBeSystemMessage, toBeToolMessage, toContainToolCall, toHaveBeenInterrupted, toHaveStructuredResponse, toHaveToolCallCount, toHaveToolCalls, toHaveToolMessages };
+
+//# sourceMappingURL=matchers.js.map

package/dist/testing/matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.js","names":["result"],"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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"}

package/dist/tools/index.cjs

@@ -1,22 +1,22 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-const require_messages_tool = require('../messages/tool.cjs');
-const require_utils = require('./utils.cjs');
-const require_callbacks_manager = require('../callbacks/manager.cjs');
-const require_index = require('../singletons/async_local_storage/index.cjs');
-require('../singletons/index.cjs');
-const require_config = require('../runnables/config.cjs');
-const require_signal = require('../utils/signal.cjs');
-const require_zod = require('../utils/types/zod.cjs');
-const require_utils_json_schema = require('../utils/json_schema.cjs');
-const require_language_models_base = require('../language_models/base.cjs');
-const require_types = require('./types.cjs');
-const zod_v3 = require_rolldown_runtime.__toESM(require("zod/v3"));
-const __cfworker_json_schema = require_rolldown_runtime.__toESM(require("@cfworker/json-schema"));
-const zod_v4 = require_rolldown_runtime.__toESM(require("zod/v4"));
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_utils = require("./utils.cjs");
+const require_messages_tool = require("../messages/tool.cjs");
+const require_callbacks_manager = require("../callbacks/manager.cjs");
+const require_index = require("../singletons/async_local_storage/index.cjs");
+require("../singletons/index.cjs");
+const require_config = require("../runnables/config.cjs");
+const require_signal = require("../utils/signal.cjs");
+const require_zod = require("../utils/types/zod.cjs");
+const require_utils_json_schema = require("../utils/json_schema.cjs");
+const require_iter = require("../runnables/iter.cjs");
+const require_language_models_base = require("../language_models/base.cjs");
+const require_types = require("./types.cjs");
+let zod_v3 = require("zod/v3");
+let _cfworker_json_schema = require("@cfworker/json-schema");
+let zod_v4 = require("zod/v4");
 //#region src/tools/index.ts
-var tools_exports = {};
-require_rolldown_runtime.__export(tools_exports, {
+var tools_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	BaseToolkit: () => BaseToolkit,
 	DynamicStructuredTool: () => DynamicStructuredTool,
 	DynamicTool: () => DynamicTool,
@@ -114,21 +114,31 @@ var StructuredTool = class extends require_language_models_base.BaseLangChain {
 			throw new require_utils.ToolInputParsingException(message, JSON.stringify(arg));
 		}
 		else {
-			const result$1 = (0, __cfworker_json_schema.validate)(inputForValidation, this.schema);
-			if (!result$1.valid) {
+			const result = (0, _cfworker_json_schema.validate)(inputForValidation, this.schema);
+			if (!result.valid) {
 				let message = `Received tool input did not match expected schema`;
-				if (this.verboseParsingErrors) message = `${message}\nDetails: ${result$1.errors.map((e) => `${e.keywordLocation}: ${e.error}`).join("\n")}`;
+				if (this.verboseParsingErrors) message = `${message}\nDetails: ${result.errors.map((e) => `${e.keywordLocation}: ${e.error}`).join("\n")}`;
 				throw new require_utils.ToolInputParsingException(message, JSON.stringify(arg));
 			}
 			parsed = inputForValidation;
 		}
 		const config = require_callbacks_manager.parseCallbackConfigArg(configArg);
 		const callbackManager_ = require_callbacks_manager.CallbackManager.configure(config.callbacks, this.callbacks, config.tags || tags, this.tags, config.metadata, this.metadata, { verbose: this.verbose });
-		const runManager = await callbackManager_?.handleToolStart(this.toJSON(), typeof arg === "string" ? arg : JSON.stringify(arg), config.runId, void 0, void 0, void 0, config.runName);
+		let toolCallId;
+		if (require_utils._isToolCall(arg)) toolCallId = arg.id;
+		if (!toolCallId && require_utils._configHasToolCallId(config)) toolCallId = config.toolCall.id;
+		const runManager = await callbackManager_?.handleToolStart(this.toJSON(), typeof arg === "string" ? arg : JSON.stringify(arg), config.runId, void 0, void 0, void 0, config.runName, toolCallId);
 		delete config.runId;
 		let result;
 		try {
-			result = await this._call(parsed, runManager, config);
+			const raw = await this._call(parsed, runManager, config);
+			result = require_iter.isAsyncGenerator(raw) ? await require_iter.consumeAsyncGenerator(raw, async (chunk) => {
+				try {
+					await runManager?.handleToolEvent(chunk);
+				} catch (streamError) {
+					await runManager?.handleToolError(streamError);
+				}
+			}) : raw;
 		} catch (e) {
 			await runManager?.handleToolError(e);
 			throw e;
@@ -138,9 +148,6 @@ var StructuredTool = class extends require_language_models_base.BaseLangChain {
 		if (this.responseFormat === "content_and_artifact") if (Array.isArray(result) && result.length === 2) [content, artifact] = result;
 		else throw new Error(`Tool response format is "content_and_artifact" but the output was not a two-tuple.\nResult: ${JSON.stringify(result)}`);
 		else content = result;
-		let toolCallId;
-		if (require_utils._isToolCall(arg)) toolCallId = arg.id;
-		if (!toolCallId && require_utils._configHasToolCallId(config)) toolCallId = config.toolCall.id;
 		const formattedOutput = _formatToolOutput({
 			content,
 			artifact,
@@ -200,7 +207,7 @@ var DynamicTool = class extends Tool {
 		return super.call(arg, config);
 	}
 	/** @ignore */
-	async _call(input, runManager, parentConfig) {
+	_call(input, runManager, parentConfig) {
 		return this.func(input, runManager, parentConfig);
 	}
 };
@@ -213,7 +220,11 @@ var DynamicTool = class extends Tool {
 * Schema can be passed as Zod or JSON schema. The tool will not validate
 * input if JSON schema is passed.
 *
-* @template NameT The literal type of the tool name (for discriminated union support)
+* @template SchemaT The input schema type for the tool (Zod schema or JSON schema). Defaults to `ToolInputSchemaBase`.
+* @template SchemaOutputT The output type derived from the schema after parsing/validation. Defaults to `ToolInputSchemaOutputType<SchemaT>`.
+* @template SchemaInputT The input type derived from the schema before parsing. Defaults to `ToolInputSchemaInputType<SchemaT>`.
+* @template ToolOutputT The return type of the tool's function. Defaults to `ToolOutputType`.
+* @template NameT The literal type of the tool name (for discriminated union support). Defaults to `string`.
 */
 var DynamicStructuredTool = class extends StructuredTool {
 	static lc_name() {
@@ -288,12 +299,16 @@ function tool(func, fields) {
 						cleanup();
 						reject(require_signal.getAbortSignalError(config.signal));
 					};
-					config.signal.addEventListener("abort", listener);
+					config.signal.addEventListener("abort", listener, { once: true });
 				}
 				const childConfig = require_config.patchConfig(config, { callbacks: runManager?.getChild() });
 				require_index.AsyncLocalStorageProviderSingleton.runWithConfig(require_config.pickRunnableConfigKeys(childConfig), async () => {
 					try {
 						const result = await func(input, childConfig);
+						if (require_iter.isAsyncGenerator(result)) {
+							resolve(result);
+							return;
+						}
 						/**
 						* If the signal is aborted, we don't want to resolve the promise
 						* as the promise is already rejected.
@@ -335,12 +350,11 @@ function _formatToolOutput(params) {
 }
 function _stringify(content) {
 	try {
-		return JSON.stringify(content, null, 2) ?? "";
+		return JSON.stringify(content) ?? "";
 	} catch (_noOp) {
 		return `${content}`;
 	}
 }
-
 //#endregion
 exports.BaseToolkit = BaseToolkit;
 exports.DynamicStructuredTool = DynamicStructuredTool;
@@ -353,10 +367,11 @@ exports.isRunnableToolLike = require_types.isRunnableToolLike;
 exports.isStructuredTool = require_types.isStructuredTool;
 exports.isStructuredToolParams = require_types.isStructuredToolParams;
 exports.tool = tool;
-Object.defineProperty(exports, 'tools_exports', {
-  enumerable: true,
-  get: function () {
-    return tools_exports;
-  }
+Object.defineProperty(exports, "tools_exports", {
+	enumerable: true,
+	get: function() {
+		return tools_exports;
+	}
 });
+
 //# sourceMappingURL=index.cjs.map