@langchain/core 1.1.31 → 1.1.32

package/dist/messages/block_translators/google.cjs

@@ -12,7 +12,22 @@ function convertToV1FromChatGoogleMessage(message) {
 				type: "text",
 				text: message.content
 			}];
-			else return message.content;
+			else {
+				const originalBlock = message.additional_kwargs?.originalTextContentBlock;
+				if (originalBlock?.thoughtSignature) {
+					if (!message.content.some((b) => "thoughtSignature" in b)) {
+						const result = [...message.content];
+						for (let i = result.length - 1; i >= 0; i--) {
+							const block = result[i];
+							if (block.type === "text" && !block.thought) {
+								block.thoughtSignature = originalBlock.thoughtSignature;
+								return result;
+							}
+						}
+					}
+				}
+				return message.content;
+			}
 		});
 		for (const block of content) {
 			const contentBlockBase = require_utils.iife(() => {

package/dist/messages/block_translators/google.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"google.cjs","names":["iife","_isContentBlock","_isString","_isObject"],"sources":["../../../src/messages/block_translators/google.ts"],"sourcesContent":["import { AIMessage } from \"../ai.js\";\nimport { ContentBlock } from \"../content/index.js\";\nimport type { StandardContentBlockTranslator } from \"./index.js\";\nimport { iife, _isContentBlock, _isObject, _isString } from \"./utils.js\";\n\nfunction convertToV1FromChatGoogleMessage(\n  message: AIMessage\n): Array<ContentBlock.Standard> {\n  function* iterateContent(): Iterable<ContentBlock.Standard> {\n    const content = iife(() => {\n      if (typeof message.content === \"string\") {\n        if (message.additional_kwargs.originalTextContentBlock) {\n          return [\n            {\n              ...message.additional_kwargs.originalTextContentBlock,\n              type: \"text\",\n            },\n          ];\n        } else {\n          return [{ type: \"text\", text: message.content }];\n        }\n      } else {\n        return message.content;\n      }\n    });\n    for (const block of content) {\n      const contentBlockBase: ContentBlock.Standard = iife(() => {\n        if (_isContentBlock(block, \"text\") && _isString(block.text)) {\n          return {\n            type: \"text\",\n            text: block.text,\n          };\n        } else if (\n          _isContentBlock(block, \"inlineData\") &&\n          _isObject(block.inlineData) &&\n          _isString(block.inlineData.mimeType) &&\n          _isString(block.inlineData.data)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.inlineData.mimeType,\n            data: block.inlineData.data,\n          };\n        } else if (\n          _isContentBlock(block, \"functionCall\") &&\n          _isObject(block.functionCall) &&\n          _isString(block.functionCall.name) &&\n          _isObject(block.functionCall.args)\n        ) {\n          return {\n            type: \"tool_call\",\n            id: message.id,\n            name: block.functionCall.name,\n            args: block.functionCall.args,\n          };\n        } else if (_isContentBlock(block, \"functionResponse\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (\n          _isContentBlock(block, \"fileData\") &&\n          _isObject(block.fileData) &&\n          _isString(block.fileData.mimeType) &&\n          _isString(block.fileData.fileUri)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.fileData.mimeType,\n            fileId: block.fileData.fileUri,\n          };\n        } else if (_isContentBlock(block, \"executableCode\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (_isContentBlock(block, \"codeExecutionResult\")) {\n          return { type: \"non_standard\", value: block };\n        }\n        return { type: \"non_standard\", value: block };\n      });\n      const contentBlock: ContentBlock.Standard = iife(() => {\n        if (\"thought\" in block && block.thought) {\n          const reasoning: string =\n            contentBlockBase.type === \"text\" ? contentBlockBase.text : \"\";\n          return {\n            type: \"reasoning\",\n            reasoning,\n            reasoningContentBlock: contentBlockBase,\n          };\n        } else {\n          return contentBlockBase;\n        }\n      });\n\n      const ret: ContentBlock.Standard = {\n        thought: block.thought,\n        thoughtSignature: block.thoughtSignature,\n        partMetadata: block.partMetadata,\n        ...contentBlock,\n      };\n      for (const attribute in ret) {\n        if (ret[attribute] === undefined) {\n          delete ret[attribute];\n        }\n      }\n\n      yield ret;\n      continue;\n    }\n  }\n  return Array.from(iterateContent());\n}\n\nexport const ChatGoogleTranslator: StandardContentBlockTranslator = {\n  translateContent: convertToV1FromChatGoogleMessage,\n  translateContentChunk: convertToV1FromChatGoogleMessage,\n};\n"],"mappings":";;;AAKA,SAAS,iCACP,SAC8B;CAC9B,UAAU,iBAAkD;EAC1D,MAAM,UAAUA,yBAAW;AACzB,OAAI,OAAO,QAAQ,YAAY,SAC7B,KAAI,QAAQ,kBAAkB,yBAC5B,QAAO,CACL;IACE,GAAG,QAAQ,kBAAkB;IAC7B,MAAM;IACP,CACF;OAED,QAAO,CAAC;IAAE,MAAM;IAAQ,MAAM,QAAQ;IAAS,CAAC;OAGlD,QAAO,QAAQ;IAEjB;AACF,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,mBAA0CA,yBAAW;AACzD,QAAIC,8BAAgB,OAAO,OAAO,IAAIC,wBAAU,MAAM,KAAK,CACzD,QAAO;KACL,MAAM;KACN,MAAM,MAAM;KACb;aAEDD,8BAAgB,OAAO,aAAa,IACpCE,wBAAU,MAAM,WAAW,IAC3BD,wBAAU,MAAM,WAAW,SAAS,IACpCA,wBAAU,MAAM,WAAW,KAAK,CAEhC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,WAAW;KAC3B,MAAM,MAAM,WAAW;KACxB;aAEDD,8BAAgB,OAAO,eAAe,IACtCE,wBAAU,MAAM,aAAa,IAC7BD,wBAAU,MAAM,aAAa,KAAK,IAClCC,wBAAU,MAAM,aAAa,KAAK,CAElC,QAAO;KACL,MAAM;KACN,IAAI,QAAQ;KACZ,MAAM,MAAM,aAAa;KACzB,MAAM,MAAM,aAAa;KAC1B;aACQF,8BAAgB,OAAO,mBAAmB,CACnD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aAE7CA,8BAAgB,OAAO,WAAW,IAClCE,wBAAU,MAAM,SAAS,IACzBD,wBAAU,MAAM,SAAS,SAAS,IAClCA,wBAAU,MAAM,SAAS,QAAQ,CAEjC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,SAAS;KACzB,QAAQ,MAAM,SAAS;KACxB;aACQD,8BAAgB,OAAO,iBAAiB,CACjD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aACpCA,8BAAgB,OAAO,sBAAsB,CACtD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;AAE/C,WAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;KAC7C;GACF,MAAM,eAAsCD,yBAAW;AACrD,QAAI,aAAa,SAAS,MAAM,QAG9B,QAAO;KACL,MAAM;KACN,WAHA,iBAAiB,SAAS,SAAS,iBAAiB,OAAO;KAI3D,uBAAuB;KACxB;QAED,QAAO;KAET;GAEF,MAAM,MAA6B;IACjC,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,cAAc,MAAM;IACpB,GAAG;IACJ;AACD,QAAK,MAAM,aAAa,IACtB,KAAI,IAAI,eAAe,OACrB,QAAO,IAAI;AAIf,SAAM;;;AAIV,QAAO,MAAM,KAAK,gBAAgB,CAAC;;AAGrC,MAAa,uBAAuD;CAClE,kBAAkB;CAClB,uBAAuB;CACxB"}
+{"version":3,"file":"google.cjs","names":["iife","_isContentBlock","_isString","_isObject"],"sources":["../../../src/messages/block_translators/google.ts"],"sourcesContent":["import { AIMessage } from \"../ai.js\";\nimport { ContentBlock } from \"../content/index.js\";\nimport type { StandardContentBlockTranslator } from \"./index.js\";\nimport { iife, _isContentBlock, _isObject, _isString } from \"./utils.js\";\n\nfunction convertToV1FromChatGoogleMessage(\n  message: AIMessage\n): Array<ContentBlock.Standard> {\n  function* iterateContent(): Iterable<ContentBlock.Standard> {\n    const content = iife(() => {\n      if (typeof message.content === \"string\") {\n        if (message.additional_kwargs.originalTextContentBlock) {\n          return [\n            {\n              ...message.additional_kwargs.originalTextContentBlock,\n              type: \"text\",\n            },\n          ];\n        } else {\n          return [{ type: \"text\", text: message.content }];\n        }\n      } else {\n        const originalBlock = message.additional_kwargs\n          ?.originalTextContentBlock as Record<string, unknown> | undefined;\n        if (originalBlock?.thoughtSignature) {\n          // During streaming with thinking models, thoughtSignature arrives in\n          // a metadata-only chunk and is stored in originalTextContentBlock.\n          // When content is an array (due to thinking parts), this signature\n          // isn't carried into the content array by mergeContent().\n          // Merge it into the last non-thinking text block.\n          const hasSignatureInContent = message.content.some(\n            (b: Record<string, unknown>) => \"thoughtSignature\" in b\n          );\n          if (!hasSignatureInContent) {\n            const result = [...message.content];\n            for (let i = result.length - 1; i >= 0; i--) {\n              const block = result[i] as Record<string, unknown>;\n              if (block.type === \"text\" && !block.thought) {\n                block.thoughtSignature = originalBlock.thoughtSignature;\n                return result;\n              }\n            }\n          }\n        }\n        return message.content;\n      }\n    });\n    for (const block of content) {\n      const contentBlockBase: ContentBlock.Standard = iife(() => {\n        if (_isContentBlock(block, \"text\") && _isString(block.text)) {\n          return {\n            type: \"text\",\n            text: block.text,\n          };\n        } else if (\n          _isContentBlock(block, \"inlineData\") &&\n          _isObject(block.inlineData) &&\n          _isString(block.inlineData.mimeType) &&\n          _isString(block.inlineData.data)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.inlineData.mimeType,\n            data: block.inlineData.data,\n          };\n        } else if (\n          _isContentBlock(block, \"functionCall\") &&\n          _isObject(block.functionCall) &&\n          _isString(block.functionCall.name) &&\n          _isObject(block.functionCall.args)\n        ) {\n          return {\n            type: \"tool_call\",\n            id: message.id,\n            name: block.functionCall.name,\n            args: block.functionCall.args,\n          };\n        } else if (_isContentBlock(block, \"functionResponse\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (\n          _isContentBlock(block, \"fileData\") &&\n          _isObject(block.fileData) &&\n          _isString(block.fileData.mimeType) &&\n          _isString(block.fileData.fileUri)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.fileData.mimeType,\n            fileId: block.fileData.fileUri,\n          };\n        } else if (_isContentBlock(block, \"executableCode\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (_isContentBlock(block, \"codeExecutionResult\")) {\n          return { type: \"non_standard\", value: block };\n        }\n        return { type: \"non_standard\", value: block };\n      });\n      const contentBlock: ContentBlock.Standard = iife(() => {\n        if (\"thought\" in block && block.thought) {\n          const reasoning: string =\n            contentBlockBase.type === \"text\" ? contentBlockBase.text : \"\";\n          return {\n            type: \"reasoning\",\n            reasoning,\n            reasoningContentBlock: contentBlockBase,\n          };\n        } else {\n          return contentBlockBase;\n        }\n      });\n\n      const ret: ContentBlock.Standard = {\n        thought: block.thought,\n        thoughtSignature: block.thoughtSignature,\n        partMetadata: block.partMetadata,\n        ...contentBlock,\n      };\n      for (const attribute in ret) {\n        if (ret[attribute] === undefined) {\n          delete ret[attribute];\n        }\n      }\n\n      yield ret;\n      continue;\n    }\n  }\n  return Array.from(iterateContent());\n}\n\nexport const ChatGoogleTranslator: StandardContentBlockTranslator = {\n  translateContent: convertToV1FromChatGoogleMessage,\n  translateContentChunk: convertToV1FromChatGoogleMessage,\n};\n"],"mappings":";;;AAKA,SAAS,iCACP,SAC8B;CAC9B,UAAU,iBAAkD;EAC1D,MAAM,UAAUA,yBAAW;AACzB,OAAI,OAAO,QAAQ,YAAY,SAC7B,KAAI,QAAQ,kBAAkB,yBAC5B,QAAO,CACL;IACE,GAAG,QAAQ,kBAAkB;IAC7B,MAAM;IACP,CACF;OAED,QAAO,CAAC;IAAE,MAAM;IAAQ,MAAM,QAAQ;IAAS,CAAC;QAE7C;IACL,MAAM,gBAAgB,QAAQ,mBAC1B;AACJ,QAAI,eAAe,kBASjB;SAAI,CAH0B,QAAQ,QAAQ,MAC3C,MAA+B,sBAAsB,EACvD,EAC2B;MAC1B,MAAM,SAAS,CAAC,GAAG,QAAQ,QAAQ;AACnC,WAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;OAC3C,MAAM,QAAQ,OAAO;AACrB,WAAI,MAAM,SAAS,UAAU,CAAC,MAAM,SAAS;AAC3C,cAAM,mBAAmB,cAAc;AACvC,eAAO;;;;;AAKf,WAAO,QAAQ;;IAEjB;AACF,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,mBAA0CA,yBAAW;AACzD,QAAIC,8BAAgB,OAAO,OAAO,IAAIC,wBAAU,MAAM,KAAK,CACzD,QAAO;KACL,MAAM;KACN,MAAM,MAAM;KACb;aAEDD,8BAAgB,OAAO,aAAa,IACpCE,wBAAU,MAAM,WAAW,IAC3BD,wBAAU,MAAM,WAAW,SAAS,IACpCA,wBAAU,MAAM,WAAW,KAAK,CAEhC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,WAAW;KAC3B,MAAM,MAAM,WAAW;KACxB;aAEDD,8BAAgB,OAAO,eAAe,IACtCE,wBAAU,MAAM,aAAa,IAC7BD,wBAAU,MAAM,aAAa,KAAK,IAClCC,wBAAU,MAAM,aAAa,KAAK,CAElC,QAAO;KACL,MAAM;KACN,IAAI,QAAQ;KACZ,MAAM,MAAM,aAAa;KACzB,MAAM,MAAM,aAAa;KAC1B;aACQF,8BAAgB,OAAO,mBAAmB,CACnD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aAE7CA,8BAAgB,OAAO,WAAW,IAClCE,wBAAU,MAAM,SAAS,IACzBD,wBAAU,MAAM,SAAS,SAAS,IAClCA,wBAAU,MAAM,SAAS,QAAQ,CAEjC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,SAAS;KACzB,QAAQ,MAAM,SAAS;KACxB;aACQD,8BAAgB,OAAO,iBAAiB,CACjD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aACpCA,8BAAgB,OAAO,sBAAsB,CACtD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;AAE/C,WAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;KAC7C;GACF,MAAM,eAAsCD,yBAAW;AACrD,QAAI,aAAa,SAAS,MAAM,QAG9B,QAAO;KACL,MAAM;KACN,WAHA,iBAAiB,SAAS,SAAS,iBAAiB,OAAO;KAI3D,uBAAuB;KACxB;QAED,QAAO;KAET;GAEF,MAAM,MAA6B;IACjC,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,cAAc,MAAM;IACpB,GAAG;IACJ;AACD,QAAK,MAAM,aAAa,IACtB,KAAI,IAAI,eAAe,OACrB,QAAO,IAAI;AAIf,SAAM;;;AAIV,QAAO,MAAM,KAAK,gBAAgB,CAAC;;AAGrC,MAAa,uBAAuD;CAClE,kBAAkB;CAClB,uBAAuB;CACxB"}

package/dist/messages/block_translators/google.js

@@ -12,7 +12,22 @@ function convertToV1FromChatGoogleMessage(message) {
 				type: "text",
 				text: message.content
 			}];
-			else return message.content;
+			else {
+				const originalBlock = message.additional_kwargs?.originalTextContentBlock;
+				if (originalBlock?.thoughtSignature) {
+					if (!message.content.some((b) => "thoughtSignature" in b)) {
+						const result = [...message.content];
+						for (let i = result.length - 1; i >= 0; i--) {
+							const block = result[i];
+							if (block.type === "text" && !block.thought) {
+								block.thoughtSignature = originalBlock.thoughtSignature;
+								return result;
+							}
+						}
+					}
+				}
+				return message.content;
+			}
 		});
 		for (const block of content) {
 			const contentBlockBase = iife(() => {

package/dist/messages/block_translators/google.js.map

@@ -1 +1 @@
-{"version":3,"file":"google.js","names":[],"sources":["../../../src/messages/block_translators/google.ts"],"sourcesContent":["import { AIMessage } from \"../ai.js\";\nimport { ContentBlock } from \"../content/index.js\";\nimport type { StandardContentBlockTranslator } from \"./index.js\";\nimport { iife, _isContentBlock, _isObject, _isString } from \"./utils.js\";\n\nfunction convertToV1FromChatGoogleMessage(\n  message: AIMessage\n): Array<ContentBlock.Standard> {\n  function* iterateContent(): Iterable<ContentBlock.Standard> {\n    const content = iife(() => {\n      if (typeof message.content === \"string\") {\n        if (message.additional_kwargs.originalTextContentBlock) {\n          return [\n            {\n              ...message.additional_kwargs.originalTextContentBlock,\n              type: \"text\",\n            },\n          ];\n        } else {\n          return [{ type: \"text\", text: message.content }];\n        }\n      } else {\n        return message.content;\n      }\n    });\n    for (const block of content) {\n      const contentBlockBase: ContentBlock.Standard = iife(() => {\n        if (_isContentBlock(block, \"text\") && _isString(block.text)) {\n          return {\n            type: \"text\",\n            text: block.text,\n          };\n        } else if (\n          _isContentBlock(block, \"inlineData\") &&\n          _isObject(block.inlineData) &&\n          _isString(block.inlineData.mimeType) &&\n          _isString(block.inlineData.data)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.inlineData.mimeType,\n            data: block.inlineData.data,\n          };\n        } else if (\n          _isContentBlock(block, \"functionCall\") &&\n          _isObject(block.functionCall) &&\n          _isString(block.functionCall.name) &&\n          _isObject(block.functionCall.args)\n        ) {\n          return {\n            type: \"tool_call\",\n            id: message.id,\n            name: block.functionCall.name,\n            args: block.functionCall.args,\n          };\n        } else if (_isContentBlock(block, \"functionResponse\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (\n          _isContentBlock(block, \"fileData\") &&\n          _isObject(block.fileData) &&\n          _isString(block.fileData.mimeType) &&\n          _isString(block.fileData.fileUri)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.fileData.mimeType,\n            fileId: block.fileData.fileUri,\n          };\n        } else if (_isContentBlock(block, \"executableCode\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (_isContentBlock(block, \"codeExecutionResult\")) {\n          return { type: \"non_standard\", value: block };\n        }\n        return { type: \"non_standard\", value: block };\n      });\n      const contentBlock: ContentBlock.Standard = iife(() => {\n        if (\"thought\" in block && block.thought) {\n          const reasoning: string =\n            contentBlockBase.type === \"text\" ? contentBlockBase.text : \"\";\n          return {\n            type: \"reasoning\",\n            reasoning,\n            reasoningContentBlock: contentBlockBase,\n          };\n        } else {\n          return contentBlockBase;\n        }\n      });\n\n      const ret: ContentBlock.Standard = {\n        thought: block.thought,\n        thoughtSignature: block.thoughtSignature,\n        partMetadata: block.partMetadata,\n        ...contentBlock,\n      };\n      for (const attribute in ret) {\n        if (ret[attribute] === undefined) {\n          delete ret[attribute];\n        }\n      }\n\n      yield ret;\n      continue;\n    }\n  }\n  return Array.from(iterateContent());\n}\n\nexport const ChatGoogleTranslator: StandardContentBlockTranslator = {\n  translateContent: convertToV1FromChatGoogleMessage,\n  translateContentChunk: convertToV1FromChatGoogleMessage,\n};\n"],"mappings":";;;AAKA,SAAS,iCACP,SAC8B;CAC9B,UAAU,iBAAkD;EAC1D,MAAM,UAAU,WAAW;AACzB,OAAI,OAAO,QAAQ,YAAY,SAC7B,KAAI,QAAQ,kBAAkB,yBAC5B,QAAO,CACL;IACE,GAAG,QAAQ,kBAAkB;IAC7B,MAAM;IACP,CACF;OAED,QAAO,CAAC;IAAE,MAAM;IAAQ,MAAM,QAAQ;IAAS,CAAC;OAGlD,QAAO,QAAQ;IAEjB;AACF,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,mBAA0C,WAAW;AACzD,QAAI,gBAAgB,OAAO,OAAO,IAAI,UAAU,MAAM,KAAK,CACzD,QAAO;KACL,MAAM;KACN,MAAM,MAAM;KACb;aAED,gBAAgB,OAAO,aAAa,IACpC,UAAU,MAAM,WAAW,IAC3B,UAAU,MAAM,WAAW,SAAS,IACpC,UAAU,MAAM,WAAW,KAAK,CAEhC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,WAAW;KAC3B,MAAM,MAAM,WAAW;KACxB;aAED,gBAAgB,OAAO,eAAe,IACtC,UAAU,MAAM,aAAa,IAC7B,UAAU,MAAM,aAAa,KAAK,IAClC,UAAU,MAAM,aAAa,KAAK,CAElC,QAAO;KACL,MAAM;KACN,IAAI,QAAQ;KACZ,MAAM,MAAM,aAAa;KACzB,MAAM,MAAM,aAAa;KAC1B;aACQ,gBAAgB,OAAO,mBAAmB,CACnD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aAE7C,gBAAgB,OAAO,WAAW,IAClC,UAAU,MAAM,SAAS,IACzB,UAAU,MAAM,SAAS,SAAS,IAClC,UAAU,MAAM,SAAS,QAAQ,CAEjC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,SAAS;KACzB,QAAQ,MAAM,SAAS;KACxB;aACQ,gBAAgB,OAAO,iBAAiB,CACjD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aACpC,gBAAgB,OAAO,sBAAsB,CACtD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;AAE/C,WAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;KAC7C;GACF,MAAM,eAAsC,WAAW;AACrD,QAAI,aAAa,SAAS,MAAM,QAG9B,QAAO;KACL,MAAM;KACN,WAHA,iBAAiB,SAAS,SAAS,iBAAiB,OAAO;KAI3D,uBAAuB;KACxB;QAED,QAAO;KAET;GAEF,MAAM,MAA6B;IACjC,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,cAAc,MAAM;IACpB,GAAG;IACJ;AACD,QAAK,MAAM,aAAa,IACtB,KAAI,IAAI,eAAe,OACrB,QAAO,IAAI;AAIf,SAAM;;;AAIV,QAAO,MAAM,KAAK,gBAAgB,CAAC;;AAGrC,MAAa,uBAAuD;CAClE,kBAAkB;CAClB,uBAAuB;CACxB"}
+{"version":3,"file":"google.js","names":[],"sources":["../../../src/messages/block_translators/google.ts"],"sourcesContent":["import { AIMessage } from \"../ai.js\";\nimport { ContentBlock } from \"../content/index.js\";\nimport type { StandardContentBlockTranslator } from \"./index.js\";\nimport { iife, _isContentBlock, _isObject, _isString } from \"./utils.js\";\n\nfunction convertToV1FromChatGoogleMessage(\n  message: AIMessage\n): Array<ContentBlock.Standard> {\n  function* iterateContent(): Iterable<ContentBlock.Standard> {\n    const content = iife(() => {\n      if (typeof message.content === \"string\") {\n        if (message.additional_kwargs.originalTextContentBlock) {\n          return [\n            {\n              ...message.additional_kwargs.originalTextContentBlock,\n              type: \"text\",\n            },\n          ];\n        } else {\n          return [{ type: \"text\", text: message.content }];\n        }\n      } else {\n        const originalBlock = message.additional_kwargs\n          ?.originalTextContentBlock as Record<string, unknown> | undefined;\n        if (originalBlock?.thoughtSignature) {\n          // During streaming with thinking models, thoughtSignature arrives in\n          // a metadata-only chunk and is stored in originalTextContentBlock.\n          // When content is an array (due to thinking parts), this signature\n          // isn't carried into the content array by mergeContent().\n          // Merge it into the last non-thinking text block.\n          const hasSignatureInContent = message.content.some(\n            (b: Record<string, unknown>) => \"thoughtSignature\" in b\n          );\n          if (!hasSignatureInContent) {\n            const result = [...message.content];\n            for (let i = result.length - 1; i >= 0; i--) {\n              const block = result[i] as Record<string, unknown>;\n              if (block.type === \"text\" && !block.thought) {\n                block.thoughtSignature = originalBlock.thoughtSignature;\n                return result;\n              }\n            }\n          }\n        }\n        return message.content;\n      }\n    });\n    for (const block of content) {\n      const contentBlockBase: ContentBlock.Standard = iife(() => {\n        if (_isContentBlock(block, \"text\") && _isString(block.text)) {\n          return {\n            type: \"text\",\n            text: block.text,\n          };\n        } else if (\n          _isContentBlock(block, \"inlineData\") &&\n          _isObject(block.inlineData) &&\n          _isString(block.inlineData.mimeType) &&\n          _isString(block.inlineData.data)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.inlineData.mimeType,\n            data: block.inlineData.data,\n          };\n        } else if (\n          _isContentBlock(block, \"functionCall\") &&\n          _isObject(block.functionCall) &&\n          _isString(block.functionCall.name) &&\n          _isObject(block.functionCall.args)\n        ) {\n          return {\n            type: \"tool_call\",\n            id: message.id,\n            name: block.functionCall.name,\n            args: block.functionCall.args,\n          };\n        } else if (_isContentBlock(block, \"functionResponse\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (\n          _isContentBlock(block, \"fileData\") &&\n          _isObject(block.fileData) &&\n          _isString(block.fileData.mimeType) &&\n          _isString(block.fileData.fileUri)\n        ) {\n          return {\n            type: \"file\",\n            mimeType: block.fileData.mimeType,\n            fileId: block.fileData.fileUri,\n          };\n        } else if (_isContentBlock(block, \"executableCode\")) {\n          return { type: \"non_standard\", value: block };\n        } else if (_isContentBlock(block, \"codeExecutionResult\")) {\n          return { type: \"non_standard\", value: block };\n        }\n        return { type: \"non_standard\", value: block };\n      });\n      const contentBlock: ContentBlock.Standard = iife(() => {\n        if (\"thought\" in block && block.thought) {\n          const reasoning: string =\n            contentBlockBase.type === \"text\" ? contentBlockBase.text : \"\";\n          return {\n            type: \"reasoning\",\n            reasoning,\n            reasoningContentBlock: contentBlockBase,\n          };\n        } else {\n          return contentBlockBase;\n        }\n      });\n\n      const ret: ContentBlock.Standard = {\n        thought: block.thought,\n        thoughtSignature: block.thoughtSignature,\n        partMetadata: block.partMetadata,\n        ...contentBlock,\n      };\n      for (const attribute in ret) {\n        if (ret[attribute] === undefined) {\n          delete ret[attribute];\n        }\n      }\n\n      yield ret;\n      continue;\n    }\n  }\n  return Array.from(iterateContent());\n}\n\nexport const ChatGoogleTranslator: StandardContentBlockTranslator = {\n  translateContent: convertToV1FromChatGoogleMessage,\n  translateContentChunk: convertToV1FromChatGoogleMessage,\n};\n"],"mappings":";;;AAKA,SAAS,iCACP,SAC8B;CAC9B,UAAU,iBAAkD;EAC1D,MAAM,UAAU,WAAW;AACzB,OAAI,OAAO,QAAQ,YAAY,SAC7B,KAAI,QAAQ,kBAAkB,yBAC5B,QAAO,CACL;IACE,GAAG,QAAQ,kBAAkB;IAC7B,MAAM;IACP,CACF;OAED,QAAO,CAAC;IAAE,MAAM;IAAQ,MAAM,QAAQ;IAAS,CAAC;QAE7C;IACL,MAAM,gBAAgB,QAAQ,mBAC1B;AACJ,QAAI,eAAe,kBASjB;SAAI,CAH0B,QAAQ,QAAQ,MAC3C,MAA+B,sBAAsB,EACvD,EAC2B;MAC1B,MAAM,SAAS,CAAC,GAAG,QAAQ,QAAQ;AACnC,WAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;OAC3C,MAAM,QAAQ,OAAO;AACrB,WAAI,MAAM,SAAS,UAAU,CAAC,MAAM,SAAS;AAC3C,cAAM,mBAAmB,cAAc;AACvC,eAAO;;;;;AAKf,WAAO,QAAQ;;IAEjB;AACF,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,mBAA0C,WAAW;AACzD,QAAI,gBAAgB,OAAO,OAAO,IAAI,UAAU,MAAM,KAAK,CACzD,QAAO;KACL,MAAM;KACN,MAAM,MAAM;KACb;aAED,gBAAgB,OAAO,aAAa,IACpC,UAAU,MAAM,WAAW,IAC3B,UAAU,MAAM,WAAW,SAAS,IACpC,UAAU,MAAM,WAAW,KAAK,CAEhC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,WAAW;KAC3B,MAAM,MAAM,WAAW;KACxB;aAED,gBAAgB,OAAO,eAAe,IACtC,UAAU,MAAM,aAAa,IAC7B,UAAU,MAAM,aAAa,KAAK,IAClC,UAAU,MAAM,aAAa,KAAK,CAElC,QAAO;KACL,MAAM;KACN,IAAI,QAAQ;KACZ,MAAM,MAAM,aAAa;KACzB,MAAM,MAAM,aAAa;KAC1B;aACQ,gBAAgB,OAAO,mBAAmB,CACnD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aAE7C,gBAAgB,OAAO,WAAW,IAClC,UAAU,MAAM,SAAS,IACzB,UAAU,MAAM,SAAS,SAAS,IAClC,UAAU,MAAM,SAAS,QAAQ,CAEjC,QAAO;KACL,MAAM;KACN,UAAU,MAAM,SAAS;KACzB,QAAQ,MAAM,SAAS;KACxB;aACQ,gBAAgB,OAAO,iBAAiB,CACjD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;aACpC,gBAAgB,OAAO,sBAAsB,CACtD,QAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;AAE/C,WAAO;KAAE,MAAM;KAAgB,OAAO;KAAO;KAC7C;GACF,MAAM,eAAsC,WAAW;AACrD,QAAI,aAAa,SAAS,MAAM,QAG9B,QAAO;KACL,MAAM;KACN,WAHA,iBAAiB,SAAS,SAAS,iBAAiB,OAAO;KAI3D,uBAAuB;KACxB;QAED,QAAO;KAET;GAEF,MAAM,MAA6B;IACjC,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,cAAc,MAAM;IACpB,GAAG;IACJ;AACD,QAAK,MAAM,aAAa,IACtB,KAAI,IAAI,eAAe,OACrB,QAAO,IAAI;AAIf,SAAM;;;AAIV,QAAO,MAAM,KAAK,gBAAgB,CAAC;;AAGrC,MAAa,uBAAuD;CAClE,kBAAkB;CAClB,uBAAuB;CACxB"}

package/dist/testing/fake_model_builder.cjs

@@ -18,22 +18,8 @@ function nextToolCallId() {
 *
 * 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`.
+* 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 require_language_models_chat_models.BaseChatModel {
 	queue = [];
@@ -42,9 +28,17 @@ var FakeBuiltModel = class FakeBuiltModel extends require_language_models_chat_m
 	_tools = [];
 	_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._calls;
 	}
+	/**
+	* The number of times this model has been invoked.
+	*/
 	get callCount() {
 		return this._calls.length;
 	}
@@ -57,6 +51,12 @@ var FakeBuiltModel = class FakeBuiltModel extends require_language_models_chat_m
 	_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",
@@ -72,6 +72,13 @@ var FakeBuiltModel = class FakeBuiltModel extends require_language_models_chat_m
 		});
 		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",
@@ -84,14 +91,31 @@ var FakeBuiltModel = class FakeBuiltModel extends require_language_models_chat_m
 		});
 		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();
@@ -103,6 +127,13 @@ var FakeBuiltModel = class FakeBuiltModel extends require_language_models_chat_m
 		next._callIndex = this._callIndex;
 		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 require_base$1.RunnableLambda.from(async () => {
@@ -150,7 +181,27 @@ var FakeBuiltModel = class FakeBuiltModel extends require_language_models_chat_m
 	}
 };
 /**
-* Creates a fake chat model for testing.
+* 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
@@ -170,5 +221,6 @@ function fakeModel() {
 }
 
 //#endregion
+exports.FakeBuiltModel = FakeBuiltModel;
 exports.fakeModel = fakeModel;
 //# sourceMappingURL=fake_model_builder.cjs.map

package/dist/testing/fake_model_builder.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fake_model_builder.cjs","names":["BaseChatModel","BaseMessage","RunnableLambda","AIMessage"],"sources":["../../src/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 \"../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\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":"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"}
+{"version":3,"file":"fake_model_builder.cjs","names":["BaseChatModel","BaseMessage","RunnableLambda","AIMessage"],"sources":["../../src/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 \"../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\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 _callIndex = 0;\n\n  private _calls: FakeModelCall[] = [];\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._calls;\n  }\n\n  /**\n   * The number of times this model has been invoked.\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  /**\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._calls = this._calls;\n    next._callIndex = this._callIndex;\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._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 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/fake_model_builder.d.cts

@@ -21,22 +21,8 @@ interface FakeModelCall {
  *
  * 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`.
+ * Responses are consumed in first-in-first-out order — one per `invoke()` call.
+ * When all queued responses are consumed, further invocations throw.
  */
 declare class FakeBuiltModel extends BaseChatModel {
   private queue;
@@ -45,20 +31,65 @@ declare class FakeBuiltModel extends BaseChatModel {
   private _tools;
   private _callIndex;
   private _calls;
+  /**
+   * All invocations recorded by this model, in order.
+   * Each entry contains the `messages` array and `options` that were
+   * passed to `invoke()`.
+   */
   get calls(): FakeModelCall[];
+  /**
+   * The number of times this model has been invoked.
+   */
   get callCount(): number;
   constructor();
   _llmType(): string;
   _combineLLMOutput(): never[];
+  /**
+   * 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: BaseMessage | Error | ResponseFactory): 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: Array<{
     name: string;
     args: Record<string, any>;
     id?: string;
   }>): this;
+  /**
+   * Make every invocation throw the given error, regardless of the queue.
+   * @param error The error to throw.
+   * @returns `this`, for chaining.
+   */
   alwaysThrow(error: Error): this;
+  /**
+   * Set the value that {@link withStructuredOutput} will resolve to.
+   * @param value The structured object to return.
+   * @returns `this`, for chaining.
+   */
   structuredResponse(value: Record<string, any>): 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: (StructuredTool | ToolSpec)[]): Runnable<BaseLanguageModelInput, AIMessageChunk<MessageStructure<MessageToolSet>>, BaseChatModelCallOptions>;
+  /**
+   * 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<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;
@@ -66,7 +97,27 @@ declare class FakeBuiltModel extends BaseChatModel {
   _generate(messages: BaseMessage[], options?: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
 }
 /**
- * Creates a fake chat model for testing.
+ * 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
@@ -83,5 +134,5 @@ declare class FakeBuiltModel extends BaseChatModel {
  */
 declare function fakeModel(): FakeBuiltModel;
 //#endregion
-export { fakeModel };
+export { FakeBuiltModel, fakeModel };
 //# sourceMappingURL=fake_model_builder.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fake_model_builder.d.cts","names":[],"sources":["../../src/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"}
+{"version":3,"file":"fake_model_builder.d.cts","names":[],"sources":["../../src/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;;;;;;;;;cAwBW,cAAA,SAAuB,aAAA;EAAA,QAC1B,KAAA;EAAA,QAEA,iBAAA;EAAA,QAEA,wBAAA;EAAA,QAEA,MAAA;EAAA,QAEA,UAAA;EAAA,QAEA,MAAA;;;;;;MAOJ,KAAA,CAAA,GAAS,aAAA;EA1CN;AAwBT;;EAxBS,IAiDH,SAAA,CAAA;EAIJ,WAAA,CAAA;EAIA,QAAA,CAAA;EAIA,iBAAA,CAAA;EAUqC;;;;;;EAArC,OAAA,CAAQ,KAAA,EAAO,WAAA,GAAc,KAAA,GAAQ,eAAA;EA4DS;;;;;;;EA1C9C,gBAAA,CACE,SAAA,EAAW,KAAA;IAAQ,IAAA;IAAc,IAAA,EAAM,MAAA;IAAqB,EAAA;EAAA;EAmExD;;;;;EAhDN,WAAA,CAAY,KAAA,EAAO,KAAA;EAsDN;;;;;EA5Cb,kBAAA,CAAmB,KAAA,EAAO,MAAA;EAwDvB;;;;;;;EA5CH,SAAA,CAAU,KAAA,GAAQ,cAAA,GAAiB,QAAA,MAAW,QAAA,CAAA,sBAAA,EAAA,cAAA,CAAA,gBAAA,CAAA,cAAA,IAAA,wBAAA;EApGtC;;;;;;;EAwHR,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6FG,SAAA,CAAA,GAAa,cAAA"}

package/dist/testing/fake_model_builder.d.ts

@@ -22,22 +22,8 @@ interface FakeModelCall {
  *
  * 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`.
+ * Responses are consumed in first-in-first-out order — one per `invoke()` call.
+ * When all queued responses are consumed, further invocations throw.
  */
 declare class FakeBuiltModel extends BaseChatModel {
   private queue;
@@ -46,20 +32,65 @@ declare class FakeBuiltModel extends BaseChatModel {
   private _tools;
   private _callIndex;
   private _calls;
+  /**
+   * All invocations recorded by this model, in order.
+   * Each entry contains the `messages` array and `options` that were
+   * passed to `invoke()`.
+   */
   get calls(): FakeModelCall[];
+  /**
+   * The number of times this model has been invoked.
+   */
   get callCount(): number;
   constructor();
   _llmType(): string;
   _combineLLMOutput(): never[];
+  /**
+   * 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: BaseMessage | Error | ResponseFactory): 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: Array<{
     name: string;
     args: Record<string, any>;
     id?: string;
   }>): this;
+  /**
+   * Make every invocation throw the given error, regardless of the queue.
+   * @param error The error to throw.
+   * @returns `this`, for chaining.
+   */
   alwaysThrow(error: Error): this;
+  /**
+   * Set the value that {@link withStructuredOutput} will resolve to.
+   * @param value The structured object to return.
+   * @returns `this`, for chaining.
+   */
   structuredResponse(value: Record<string, any>): 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: (StructuredTool | ToolSpec)[]): Runnable<BaseLanguageModelInput, AIMessageChunk<MessageStructure<MessageToolSet>>, BaseChatModelCallOptions>;
+  /**
+   * 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<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;
@@ -67,7 +98,27 @@ declare class FakeBuiltModel extends BaseChatModel {
   _generate(messages: BaseMessage[], options?: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
 }
 /**
- * Creates a fake chat model for testing.
+ * 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
@@ -84,5 +135,5 @@ declare class FakeBuiltModel extends BaseChatModel {
  */
 declare function fakeModel(): FakeBuiltModel;
 //#endregion
-export { fakeModel };
+export { FakeBuiltModel, fakeModel };
 //# sourceMappingURL=fake_model_builder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fake_model_builder.d.ts","names":[],"sources":["../../src/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;AAZ8D;;;;;;;;;;;;;;AAEO;;;;;;;;AAFP,cAkD1D,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"}
+{"version":3,"file":"fake_model_builder.d.ts","names":[],"sources":["../../src/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;AAZ8D;;;;;;;;AAAA,cAoCnD,cAAA,SAAuB,aAAA;EAAA,QAC1B,KAAA;EAAA,QAEA,iBAAA;EAAA,QAEA,wBAAA;EAAA,QAEA,MAAA;EAAA,QAEA,UAAA;EAAA,QAEA,MAAA;EArCa;;;;;EAAA,IA4CjB,KAAA,CAAA,GAAS,aAAA;EA1CN;;AAwBT;EAxBS,IAiDH,SAAA,CAAA;EAIJ,WAAA,CAAA;EAIA,QAAA,CAAA;EAIA,iBAAA,CAAA;EAU6B;;;;;;EAA7B,OAAA,CAAQ,KAAA,EAAO,WAAA,GAAc,KAAA,GAAQ,eAAA;EA4DF;;;;;;;EA1CnC,gBAAA,CACE,SAAA,EAAW,KAAA;IAAQ,IAAA;IAAc,IAAA,EAAM,MAAA;IAAqB,EAAA;EAAA;EAkExD;;;;;EA/CN,WAAA,CAAY,KAAA,EAAO,KAAA;EAqDb;;;;;EA3CN,kBAAA,CAAmB,KAAA,EAAO,MAAA;EAwDf;;;;;;;EA5CX,SAAA,CAAU,KAAA,GAAQ,cAAA,GAAiB,QAAA,MAAW,QAAA,CAAA,sBAAA,EAAA,cAAA,CAAA,gBAAA,CAAA,cAAA,IAAA,wBAAA;EAtGtC;;;;;;;EA0HR,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6FG,SAAA,CAAA,GAAa,cAAA"}