langchain 1.5.4 → 1.5.6

package/dist/agents/errors.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/agents/errors.ts"],"mappings":";;;cAIa,uBAAA,SAAgC,KAAA;EAC3C,WAAA,CAAA;AAAA;;;;cAYW,8BAAA,SAAuC,KAAA;EAAA,SAClC,SAAA;EAEhB,WAAA,CAAY,SAAA;AAAA;;;;cAcD,4BAAA,SAAqC,KAAA;EAAA,SAChC,QAAA;EAAA,SAEA,MAAA;EAEhB,WAAA,CAAY,QAAA,UAAkB,MAAA;AAAA;;;;cAcnB,mBAAA,SAA4B,KAAA;EAAA;EAAA,SAGvB,QAAA,EAAU,QAAA;EAAA,SAEV,SAAA,EAAW,KAAA;EAE3B,WAAA,CAAY,SAAA,WAAoB,QAAA,EAAU,QAAA;EArBZ;;;AAchC;;EAdgC,OAsCvB,UAAA,CAAW,KAAA,YAAiB,KAAA,IAAS,mBAAA;AAAA;;;;;;;cAejC,eAAA,SAAwB,KAAA;EAAA;EAAA,QAG5B,WAAA,CAAA;EArCS;;;;;;;;EAAA,OA0DT,IAAA,CAAK,KAAA,WAAgB,cAAA,WAAyB,KAAA;EAvCT;;;AAe9C;;EAf8C,OAqDrC,UAAA,CAAW,KAAA,YAAiB,KAAA,IAAS,eAAA;AAAA"}
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/agents/errors.ts"],"mappings":";;cAIa,gCAAgC;EAC3C;;;;;cAYW,uCAAuC;WAClC;EAEhB,YAAY;;;;;cAcD,qCAAqC;WAChC;WAEA;EAEhB,YAAY,kBAAkB;;;;;cAcnB,4BAA4B;;WAGvB,UAAU;WAEV,WAAW;EAE3B,YAAY,oBAAoB,UAAU;;;;;;SAiBnC,WAAW,iBAAiB,SAAS;UAQpC,OAAO,aAAa,eAAY,OAAA;;;;;;;;cAW7B,wBAAwB;;UAG5B;;;;;;;;;SAqBA,KAAK,gBAAgB,yBAAyB;;;;;;SAc9C,WAAW,iBAAiB,SAAS;UAQpC,OAAO,aAAa,eAAY,OAAA"}

package/dist/agents/errors.d.ts

@@ -1,5 +1,4 @@
 import { ToolCall } from "@langchain/core/messages/tool";
-
 //#region src/agents/errors.d.ts
 declare class MultipleToolsBoundError extends Error {
   constructor();
@@ -33,6 +32,7 @@ declare class ToolInvocationError extends Error {
    * @returns Whether the error is a ToolInvocationError
    */
   static isInstance(error: unknown): error is ToolInvocationError;
+  static [Symbol.hasInstance](obj: unknown): obj is ToolInvocationError;
 }
 /**
  * Error thrown when a middleware fails.
@@ -58,6 +58,7 @@ declare class MiddlewareError extends Error {
    * @returns Whether the error is a MiddlewareError
    */
   static isInstance(error: unknown): error is MiddlewareError;
+  static [Symbol.hasInstance](obj: unknown): obj is MiddlewareError;
 }
 //#endregion
 export { MiddlewareError, MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError };

package/dist/agents/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/agents/errors.ts"],"mappings":";;;cAIa,uBAAA,SAAgC,KAAA;EAC3C,WAAA,CAAA;AAAA;;;;cAYW,8BAAA,SAAuC,KAAA;EAAA,SAClC,SAAA;EAEhB,WAAA,CAAY,SAAA;AAAA;;;;cAcD,4BAAA,SAAqC,KAAA;EAAA,SAChC,QAAA;EAAA,SAEA,MAAA;EAEhB,WAAA,CAAY,QAAA,UAAkB,MAAA;AAAA;;;;cAcnB,mBAAA,SAA4B,KAAA;EAAA;EAAA,SAGvB,QAAA,EAAU,QAAA;EAAA,SAEV,SAAA,EAAW,KAAA;EAE3B,WAAA,CAAY,SAAA,WAAoB,QAAA,EAAU,QAAA;EArBZ;;;AAchC;;EAdgC,OAsCvB,UAAA,CAAW,KAAA,YAAiB,KAAA,IAAS,mBAAA;AAAA;;;;;;;cAejC,eAAA,SAAwB,KAAA;EAAA;EAAA,QAG5B,WAAA,CAAA;EArCS;;;;;;;;EAAA,OA0DT,IAAA,CAAK,KAAA,WAAgB,cAAA,WAAyB,KAAA;EAvCT;;;AAe9C;;EAf8C,OAqDrC,UAAA,CAAW,KAAA,YAAiB,KAAA,IAAS,eAAA;AAAA"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/agents/errors.ts"],"mappings":";;cAIa,gCAAgC;EAC3C;;;;;cAYW,uCAAuC;WAClC;EAEhB,YAAY;;;;;cAcD,qCAAqC;WAChC;WAEA;EAEhB,YAAY,kBAAkB;;;;;cAcnB,4BAA4B;;WAGvB,UAAU;WAEV,WAAW;EAE3B,YAAY,oBAAoB,UAAU;;;;;;SAiBnC,WAAW,iBAAiB,SAAS;UAQpC,OAAO,aAAa,eAAY,OAAA;;;;;;;;cAW7B,wBAAwB;;UAG5B;;;;;;;;;SAqBA,KAAK,gBAAgB,yBAAyB;;;;;;SAc9C,WAAW,iBAAiB,SAAS;UAQpC,OAAO,aAAa,eAAY,OAAA"}

package/dist/agents/errors.js

@@ -49,6 +49,9 @@ var ToolInvocationError = class extends Error {
 	static isInstance(error) {
 		return error instanceof Error && "~brand" in error && error["~brand"] === "ToolInvocationError";
 	}
+	static [Symbol.hasInstance](obj) {
+		return this.isInstance(obj);
+	}
 };
 /**
 * Error thrown when a middleware fails.
@@ -84,6 +87,9 @@ var MiddlewareError = class MiddlewareError extends Error {
 	static isInstance(error) {
 		return error instanceof Error && "~brand" in error && error["~brand"] === "MiddlewareError";
 	}
+	static [Symbol.hasInstance](obj) {
+		return this.isInstance(obj);
+	}
 };
 //#endregion
 export { MiddlewareError, MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError };

package/dist/agents/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/agents/errors.ts"],"sourcesContent":["/* oxlint-disable no-instanceof/no-instanceof */\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\nimport { isGraphBubbleUp } from \"@langchain/langgraph\";\n\nexport class MultipleToolsBoundError extends Error {\n  constructor() {\n    super(\n      \"The provided LLM already has bound tools. \" +\n        \"Please provide an LLM without bound tools to createAgent. \" +\n        \"The agent will bind the tools provided in the 'tools' parameter.\"\n    );\n  }\n}\n\n/**\n * Raised when model returns multiple structured output tool calls when only one is expected.\n */\nexport class MultipleStructuredOutputsError extends Error {\n  public readonly toolNames: string[];\n\n  constructor(toolNames: string[]) {\n    super(\n      `The model has called multiple tools: ${toolNames.join(\n        \", \"\n      )} to return a structured output. ` +\n        \"This is not supported. Please provide a single structured output.\"\n    );\n    this.toolNames = toolNames;\n  }\n}\n\n/**\n * Raised when structured output tool call arguments fail to parse according to the schema.\n */\nexport class StructuredOutputParsingError extends Error {\n  public readonly toolName: string;\n\n  public readonly errors: string[];\n\n  constructor(toolName: string, errors: string[]) {\n    super(\n      `Failed to parse structured output for tool '${toolName}':${errors\n        .map((e) => `\\n  - ${e}`)\n        .join(\"\")}.`\n    );\n    this.toolName = toolName;\n    this.errors = errors;\n  }\n}\n\n/**\n * Raised when a tool call is throwing an error.\n */\nexport class ToolInvocationError extends Error {\n  readonly \"~brand\" = \"ToolInvocationError\";\n\n  public readonly toolCall: ToolCall;\n\n  public readonly toolError: Error;\n\n  constructor(toolError: unknown, toolCall: ToolCall) {\n    const error =\n      toolError instanceof Error ? toolError : new Error(String(toolError));\n    const toolArgs = JSON.stringify(toolCall.args);\n    super(\n      `Error invoking tool '${toolCall.name}' with kwargs ${toolArgs} with error: ${error.stack}\\n Please fix the error and try again.`\n    );\n\n    this.toolCall = toolCall;\n    this.toolError = error;\n  }\n\n  /**\n   * Check if the error is a ToolInvocationError.\n   * @param error - The error to check\n   * @returns Whether the error is a ToolInvocationError\n   */\n  static isInstance(error: unknown): error is ToolInvocationError {\n    return (\n      error instanceof Error &&\n      \"~brand\" in error &&\n      error[\"~brand\"] === \"ToolInvocationError\"\n    );\n  }\n}\n\n/**\n * Error thrown when a middleware fails.\n *\n * Use `MiddlewareError.wrap()` to create instances. The constructor is private\n * to ensure that GraphBubbleUp errors (like GraphInterrupt) are never wrapped.\n */\nexport class MiddlewareError extends Error {\n  readonly \"~brand\" = \"MiddlewareError\";\n\n  private constructor(error: unknown, middlewareName: string) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    super(errorMessage);\n    this.name =\n      error instanceof Error\n        ? error.name\n        : `${middlewareName[0].toUpperCase() + middlewareName.slice(1)}Error`;\n\n    if (error instanceof Error) {\n      this.cause = error;\n    }\n  }\n\n  /**\n   * Wrap an error in a MiddlewareError, unless it's a GraphBubbleUp error\n   * (like GraphInterrupt) which should propagate unchanged.\n   *\n   * @param error - The error to wrap\n   * @param middlewareName - The name of the middleware that threw the error\n   * @returns The original error if it's a GraphBubbleUp, otherwise a new MiddlewareError\n   */\n  static wrap(error: unknown, middlewareName: string): Error {\n    // Don't wrap GraphBubbleUp errors (GraphInterrupt, NodeInterrupt, etc.)\n    // These are control flow mechanisms that need to bubble up unchanged\n    if (isGraphBubbleUp(error)) {\n      return error;\n    }\n    return new MiddlewareError(error, middlewareName);\n  }\n\n  /**\n   * Check if the error is a MiddlewareError.\n   * @param error - The error to check\n   * @returns Whether the error is a MiddlewareError\n   */\n  static isInstance(error: unknown): error is MiddlewareError {\n    return (\n      error instanceof Error &&\n      \"~brand\" in error &&\n      error[\"~brand\"] === \"MiddlewareError\"\n    );\n  }\n}\n"],"mappings":";;AAIA,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;AACZ,QACE,uKAGD;;;;;;AAOL,IAAa,iCAAb,cAAoD,MAAM;CACxD;CAEA,YAAY,WAAqB;AAC/B,QACE,wCAAwC,UAAU,KAChD,KACD,CAAC,mGAEH;AACD,OAAK,YAAY;;;;;;AAOrB,IAAa,+BAAb,cAAkD,MAAM;CACtD;CAEA;CAEA,YAAY,UAAkB,QAAkB;AAC9C,QACE,+CAA+C,SAAS,IAAI,OACzD,KAAK,MAAM,SAAS,IAAI,CACxB,KAAK,GAAG,CAAC,GACb;AACD,OAAK,WAAW;AAChB,OAAK,SAAS;;;;;;AAOlB,IAAa,sBAAb,cAAyC,MAAM;CAC7C,WAAoB;CAEpB;CAEA;CAEA,YAAY,WAAoB,UAAoB;EAClD,MAAM,QACJ,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,UAAU,CAAC;EACvE,MAAM,WAAW,KAAK,UAAU,SAAS,KAAK;AAC9C,QACE,wBAAwB,SAAS,KAAK,gBAAgB,SAAS,eAAe,MAAM,MAAM,wCAC3F;AAED,OAAK,WAAW;AAChB,OAAK,YAAY;;;;;;;CAQnB,OAAO,WAAW,OAA8C;AAC9D,SACE,iBAAiB,SACjB,YAAY,SACZ,MAAM,cAAc;;;;;;;;;AAW1B,IAAa,kBAAb,MAAa,wBAAwB,MAAM;CACzC,WAAoB;CAEpB,YAAoB,OAAgB,gBAAwB;EAC1D,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,QAAM,aAAa;AACnB,OAAK,OACH,iBAAiB,QACb,MAAM,OACN,GAAG,eAAe,GAAG,aAAa,GAAG,eAAe,MAAM,EAAE,CAAC;AAEnE,MAAI,iBAAiB,MACnB,MAAK,QAAQ;;;;;;;;;;CAYjB,OAAO,KAAK,OAAgB,gBAA+B;AAGzD,MAAI,gBAAgB,MAAM,CACxB,QAAO;AAET,SAAO,IAAI,gBAAgB,OAAO,eAAe;;;;;;;CAQnD,OAAO,WAAW,OAA0C;AAC1D,SACE,iBAAiB,SACjB,YAAY,SACZ,MAAM,cAAc"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/agents/errors.ts"],"sourcesContent":["/* oxlint-disable no-instanceof/no-instanceof */\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\nimport { isGraphBubbleUp } from \"@langchain/langgraph\";\n\nexport class MultipleToolsBoundError extends Error {\n  constructor() {\n    super(\n      \"The provided LLM already has bound tools. \" +\n        \"Please provide an LLM without bound tools to createAgent. \" +\n        \"The agent will bind the tools provided in the 'tools' parameter.\"\n    );\n  }\n}\n\n/**\n * Raised when model returns multiple structured output tool calls when only one is expected.\n */\nexport class MultipleStructuredOutputsError extends Error {\n  public readonly toolNames: string[];\n\n  constructor(toolNames: string[]) {\n    super(\n      `The model has called multiple tools: ${toolNames.join(\n        \", \"\n      )} to return a structured output. ` +\n        \"This is not supported. Please provide a single structured output.\"\n    );\n    this.toolNames = toolNames;\n  }\n}\n\n/**\n * Raised when structured output tool call arguments fail to parse according to the schema.\n */\nexport class StructuredOutputParsingError extends Error {\n  public readonly toolName: string;\n\n  public readonly errors: string[];\n\n  constructor(toolName: string, errors: string[]) {\n    super(\n      `Failed to parse structured output for tool '${toolName}':${errors\n        .map((e) => `\\n  - ${e}`)\n        .join(\"\")}.`\n    );\n    this.toolName = toolName;\n    this.errors = errors;\n  }\n}\n\n/**\n * Raised when a tool call is throwing an error.\n */\nexport class ToolInvocationError extends Error {\n  readonly \"~brand\" = \"ToolInvocationError\";\n\n  public readonly toolCall: ToolCall;\n\n  public readonly toolError: Error;\n\n  constructor(toolError: unknown, toolCall: ToolCall) {\n    const error =\n      toolError instanceof Error ? toolError : new Error(String(toolError));\n    const toolArgs = JSON.stringify(toolCall.args);\n    super(\n      `Error invoking tool '${toolCall.name}' with kwargs ${toolArgs} with error: ${error.stack}\\n Please fix the error and try again.`\n    );\n\n    this.toolCall = toolCall;\n    this.toolError = error;\n  }\n\n  /**\n   * Check if the error is a ToolInvocationError.\n   * @param error - The error to check\n   * @returns Whether the error is a ToolInvocationError\n   */\n  static isInstance(error: unknown): error is ToolInvocationError {\n    return (\n      error instanceof Error &&\n      \"~brand\" in error &&\n      error[\"~brand\"] === \"ToolInvocationError\"\n    );\n  }\n\n  static [Symbol.hasInstance](obj: unknown) {\n    return this.isInstance(obj);\n  }\n}\n\n/**\n * Error thrown when a middleware fails.\n *\n * Use `MiddlewareError.wrap()` to create instances. The constructor is private\n * to ensure that GraphBubbleUp errors (like GraphInterrupt) are never wrapped.\n */\nexport class MiddlewareError extends Error {\n  readonly \"~brand\" = \"MiddlewareError\";\n\n  private constructor(error: unknown, middlewareName: string) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    super(errorMessage);\n    this.name =\n      error instanceof Error\n        ? error.name\n        : `${middlewareName[0].toUpperCase() + middlewareName.slice(1)}Error`;\n\n    if (error instanceof Error) {\n      this.cause = error;\n    }\n  }\n\n  /**\n   * Wrap an error in a MiddlewareError, unless it's a GraphBubbleUp error\n   * (like GraphInterrupt) which should propagate unchanged.\n   *\n   * @param error - The error to wrap\n   * @param middlewareName - The name of the middleware that threw the error\n   * @returns The original error if it's a GraphBubbleUp, otherwise a new MiddlewareError\n   */\n  static wrap(error: unknown, middlewareName: string): Error {\n    // Don't wrap GraphBubbleUp errors (GraphInterrupt, NodeInterrupt, etc.)\n    // These are control flow mechanisms that need to bubble up unchanged\n    if (isGraphBubbleUp(error)) {\n      return error;\n    }\n    return new MiddlewareError(error, middlewareName);\n  }\n\n  /**\n   * Check if the error is a MiddlewareError.\n   * @param error - The error to check\n   * @returns Whether the error is a MiddlewareError\n   */\n  static isInstance(error: unknown): error is MiddlewareError {\n    return (\n      error instanceof Error &&\n      \"~brand\" in error &&\n      error[\"~brand\"] === \"MiddlewareError\"\n    );\n  }\n\n  static [Symbol.hasInstance](obj: unknown) {\n    return this.isInstance(obj);\n  }\n}\n"],"mappings":";;AAIA,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MACE,sKAGF;CACF;AACF;;;;AAKA,IAAa,iCAAb,cAAoD,MAAM;CACxD;CAEA,YAAY,WAAqB;EAC/B,MACE,wCAAwC,UAAU,KAChD,IACF,EAAE,kGAEJ;EACA,KAAK,YAAY;CACnB;AACF;;;;AAKA,IAAa,+BAAb,cAAkD,MAAM;CACtD;CAEA;CAEA,YAAY,UAAkB,QAAkB;EAC9C,MACE,+CAA+C,SAAS,IAAI,OACzD,KAAK,MAAM,SAAS,GAAG,CAAC,CACxB,KAAK,EAAE,EAAE,EACd;EACA,KAAK,WAAW;EAChB,KAAK,SAAS;CAChB;AACF;;;;AAKA,IAAa,sBAAb,cAAyC,MAAM;CAC7C,WAAoB;CAEpB;CAEA;CAEA,YAAY,WAAoB,UAAoB;EAClD,MAAM,QACJ,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,SAAS,CAAC;EACtE,MAAM,WAAW,KAAK,UAAU,SAAS,IAAI;EAC7C,MACE,wBAAwB,SAAS,KAAK,gBAAgB,SAAS,eAAe,MAAM,MAAM,uCAC5F;EAEA,KAAK,WAAW;EAChB,KAAK,YAAY;CACnB;;;;;;CAOA,OAAO,WAAW,OAA8C;EAC9D,OACE,iBAAiB,SACjB,YAAY,SACZ,MAAM,cAAc;CAExB;CAEA,QAAQ,OAAO,aAAa,KAAc;EACxC,OAAO,KAAK,WAAW,GAAG;CAC5B;AACF;;;;;;;AAQA,IAAa,kBAAb,MAAa,wBAAwB,MAAM;CACzC,WAAoB;CAEpB,YAAoB,OAAgB,gBAAwB;EAC1D,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAC1E,MAAM,YAAY;EAClB,KAAK,OACH,iBAAiB,QACb,MAAM,OACN,GAAG,eAAe,EAAE,CAAC,YAAY,IAAI,eAAe,MAAM,CAAC,EAAE;EAEnE,IAAI,iBAAiB,OACnB,KAAK,QAAQ;CAEjB;;;;;;;;;CAUA,OAAO,KAAK,OAAgB,gBAA+B;EAGzD,IAAI,gBAAgB,KAAK,GACvB,OAAO;EAET,OAAO,IAAI,gBAAgB,OAAO,cAAc;CAClD;;;;;;CAOA,OAAO,WAAW,OAA0C;EAC1D,OACE,iBAAiB,SACjB,YAAY,SACZ,MAAM,cAAc;CAExB;CAEA,QAAQ,OAAO,aAAa,KAAc;EACxC,OAAO,KAAK,WAAW,GAAG;CAC5B;AACF"}

package/dist/agents/index.cjs

@@ -1,17 +1,31 @@
-require("./errors.cjs");
-require("./responses.cjs");
-require("./transformers/tool-call.cjs");
-require("./transformers/subagent.cjs");
+const require_errors = require("./errors.cjs");
+const require_responses = require("./responses.cjs");
+const require_tool_call = require("./transformers/tool-call.cjs");
+const require_subagent = require("./transformers/subagent.cjs");
 require("./transformers/index.cjs");
 const require_ReactAgent = require("./ReactAgent.cjs");
-require("./middleware/types.cjs");
-require("./middleware.cjs");
-require("./tests/utils.cjs");
+const require_types = require("./middleware/types.cjs");
+const require_middleware = require("./middleware.cjs");
+const require_utils = require("./tests/utils.cjs");
 //#region src/agents/index.ts
 function createAgent(params) {
 	return new require_ReactAgent.ReactAgent(params);
 }
 //#endregion
+exports.FakeToolCallingModel = require_utils.FakeToolCallingModel;
+exports.MIDDLEWARE_BRAND = require_types.MIDDLEWARE_BRAND;
+exports.MiddlewareError = require_errors.MiddlewareError;
+exports.MultipleStructuredOutputsError = require_errors.MultipleStructuredOutputsError;
+exports.MultipleToolsBoundError = require_errors.MultipleToolsBoundError;
+exports.ProviderStrategy = require_responses.ProviderStrategy;
+exports.StructuredOutputParsingError = require_errors.StructuredOutputParsingError;
+exports.ToolInvocationError = require_errors.ToolInvocationError;
+exports.ToolStrategy = require_responses.ToolStrategy;
 exports.createAgent = createAgent;
+exports.createMiddleware = require_middleware.createMiddleware;
+exports.createSubagentTransformer = require_subagent.createSubagentTransformer;
+exports.createToolCallTransformer = require_tool_call.createToolCallTransformer;
+exports.providerStrategy = require_responses.providerStrategy;
+exports.toolStrategy = require_responses.toolStrategy;
 
 //# sourceMappingURL=index.cjs.map

package/dist/agents/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ReactAgent"],"sources":["../../src/agents/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport type {\n  StateDefinitionInit,\n  StreamTransformer,\n} from \"@langchain/langgraph\";\n\nimport type { ResponseFormatUndefined } from \"./responses.js\";\nimport type {\n  CreateAgentParams,\n  AgentTypeConfig,\n  CombineTools,\n  CombineStreamTransformers,\n} from \"./types.js\";\nimport type {\n  AnyAgentMiddleware,\n  AnyAnnotationRoot,\n} from \"./middleware/types.js\";\nimport type { ExtractZodArrayTypes } from \"./types.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  JsonSchemaFormat,\n} from \"./responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools\n * and middleware to create systems that can reason about tasks, decide which tools to use, and iteratively\n * work towards solutions.\n *\n * The agent follows the ReAct pattern, interleaving reasoning steps with tool calls to iteratively\n * work towards solutions. It can handle multiple tool calls in sequence or parallel, maintain state\n * across interactions, and provide auditable decision processes.\n *\n * ## Core Components\n *\n * ### Model\n * The reasoning engine can be specified as:\n * - **String identifier**: `\"openai:gpt-4o\"` for simple setup\n * - **Model instance**: Configured model object for full control\n * - **Dynamic function**: Select models at runtime based on state\n *\n * ### Tools\n * Tools give agents the ability to take actions:\n * - Pass an array of tools created with the `tool` function\n * - Or provide a configured `ToolNode` for custom error handling\n *\n * ### Prompt\n * Shape how your agent approaches tasks:\n * - String for simple instructions\n * - SystemMessage for structured prompts\n * - Function for dynamic prompts based on state\n *\n * ### Middleware\n * Middleware allows you to extend the agent's behavior:\n * - Add pre/post-model processing for context injection or validation\n * - Add dynamic control flows, e.g. terminate invocation or retries\n * - Add human-in-the-loop capabilities\n * - Add tool calls to the agent\n * - Add tool results to the agent\n *\n * ## Advanced Features\n *\n * - **Structured Output**: Use `responseFormat` with a Zod schema to get typed responses\n * - **Memory**: Extend the state schema to remember information across interactions\n * - **Streaming**: Get real-time updates as the agent processes\n *\n * @param options - Configuration options for the agent\n * @param options.llm - The language model as an instance of a chat model\n * @param options.model - The language model as a string identifier, see more in {@link https://docs.langchain.com/oss/javascript/langchain/models#basic-usage | Models}.\n * @param options.tools - Array of tools or configured ToolNode\n * @param options.prompt - System instructions (string, SystemMessage, or function)\n * @param options.responseFormat - Zod schema for structured output\n * @param options.stateSchema - Custom state schema for memory\n * @param options.middleware - Array of middleware for extending agent behavior, see more in {@link https://docs.langchain.com/oss/javascript/langchain/middleware | Middleware}.\n *\n * @returns A ReactAgent instance with `invoke` and `stream` methods\n *\n * @example Basic agent with tools\n * ```ts\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const search = tool(\n *   ({ query }) => `Results for: ${query}`,\n *   {\n *     name: \"search\",\n *     description: \"Search for information\",\n *     schema: z.object({\n *       query: z.string().describe(\"The search query\"),\n *     })\n *   }\n * );\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [search],\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{ role: \"user\", content: \"Search for ReAct agents\" }],\n * });\n * ```\n *\n * @example Structured output\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const ContactInfo = z.object({\n *   name: z.string(),\n *   email: z.string(),\n *   phone: z.string(),\n * });\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [],\n *   responseFormat: ContactInfo,\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{\n *     role: \"user\",\n *     content: \"Extract: John Doe, john@example.com, (555) 123-4567\"\n *   }],\n * });\n *\n * console.log(result.structuredResponse);\n * // { name: 'John Doe', email: 'john@example.com', phone: '(555) 123-4567' }\n * ```\n *\n * @example Streaming responses\n * ```ts\n * const stream = await agent.stream(\n *   { messages: [{ role: \"user\", content: \"What's the weather?\" }] },\n *   { streamMode: \"values\" }\n * );\n *\n * for await (const chunk of stream) {\n *   // ...\n * }\n * ```\n *\n * @example With StateSchema\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { StateSchema, ReducedValue } from \"@langchain/langgraph\";\n * import { z } from \"zod\";\n *\n * const AgentState = new StateSchema({\n *   userId: z.string(),\n *   count: z.number().default(0),\n *   history: new ReducedValue(\n *     z.array(z.string()).default(() => []),\n *     { inputSchema: z.string(), reducer: (c, n) => [...c, n] }\n *   ),\n * });\n *\n * const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [searchTool],\n *   stateSchema: AgentState,\n * });\n * ```\n */\n// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    InteropZodType<StructuredResponseFormat>\n  > & {\n    responseFormat: InteropZodType<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  StructuredResponseFormat extends readonly InteropZodType<any>[],\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    StructuredResponseFormat\n  > & {\n    responseFormat: StructuredResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 6: With responseFormat as single SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema\n  > & {\n    responseFormat: SerializableSchema;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 7: With responseFormat as array of SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema[]\n  > & {\n    responseFormat: SerializableSchema[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 8: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TypedToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: TypedToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 9: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 10: With responseFormat as ProviderStrategy\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ProviderStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ProviderStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 11: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 12: With responseFormat explicitly undefined\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 13: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  TStateSchema extends StateDefinitionInit,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> =\n    readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    any\n  >\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n> {\n  return new ReactAgent(params);\n}\n\n// Re-export types and utilities\nexport * from \"./types.js\";\nexport * from \"./errors.js\";\nexport * from \"./nodes/types.js\";\nexport type { JumpToTarget } from \"./constants.js\";\nexport type { Runtime } from \"./runtime.js\";\nexport {\n  toolStrategy,\n  providerStrategy,\n  ToolStrategy,\n  ProviderStrategy,\n  type TypedToolStrategy,\n  type ResponseFormat,\n  type ResponseFormatUndefined,\n} from \"./responses.js\";\nexport { createMiddleware } from \"./middleware.js\";\nexport { MIDDLEWARE_BRAND } from \"./middleware/types.js\";\nexport type * from \"./middleware/types.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { ReactAgent } from \"./ReactAgent.js\";\nexport {\n  createToolCallTransformer,\n  createSubagentTransformer,\n  type AgentRunStream,\n  type ToolCallStreamUnion,\n  type SubagentRunStream,\n} from \"./transformers/index.js\";\n"],"mappings":";;;;;;;;;;AA+pBA,SAAgB,YAad,QAeA;AACA,QAAO,IAAIA,mBAAAA,WAAW,OAAO"}
+{"version":3,"file":"index.cjs","names":["ReactAgent"],"sources":["../../src/agents/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport type {\n  StateDefinitionInit,\n  StreamTransformer,\n} from \"@langchain/langgraph\";\n\nimport type { ResponseFormatUndefined } from \"./responses.js\";\nimport type {\n  CreateAgentParams,\n  AgentTypeConfig,\n  CombineTools,\n  CombineStreamTransformers,\n} from \"./types.js\";\nimport type {\n  AnyAgentMiddleware,\n  AnyAnnotationRoot,\n} from \"./middleware/types.js\";\nimport type { ExtractZodArrayTypes } from \"./types.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  JsonSchemaFormat,\n} from \"./responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools\n * and middleware to create systems that can reason about tasks, decide which tools to use, and iteratively\n * work towards solutions.\n *\n * The agent follows the ReAct pattern, interleaving reasoning steps with tool calls to iteratively\n * work towards solutions. It can handle multiple tool calls in sequence or parallel, maintain state\n * across interactions, and provide auditable decision processes.\n *\n * ## Core Components\n *\n * ### Model\n * The reasoning engine can be specified as:\n * - **String identifier**: `\"openai:gpt-4o\"` for simple setup\n * - **Model instance**: Configured model object for full control\n * - **Dynamic function**: Select models at runtime based on state\n *\n * ### Tools\n * Tools give agents the ability to take actions:\n * - Pass an array of tools created with the `tool` function\n * - Or provide a configured `ToolNode` for custom error handling\n *\n * ### Prompt\n * Shape how your agent approaches tasks:\n * - String for simple instructions\n * - SystemMessage for structured prompts\n * - Function for dynamic prompts based on state\n *\n * ### Middleware\n * Middleware allows you to extend the agent's behavior:\n * - Add pre/post-model processing for context injection or validation\n * - Add dynamic control flows, e.g. terminate invocation or retries\n * - Add human-in-the-loop capabilities\n * - Add tool calls to the agent\n * - Add tool results to the agent\n *\n * ## Advanced Features\n *\n * - **Structured Output**: Use `responseFormat` with a Zod schema to get typed responses\n * - **Memory**: Extend the state schema to remember information across interactions\n * - **Streaming**: Get real-time updates as the agent processes\n *\n * @param options - Configuration options for the agent\n * @param options.llm - The language model as an instance of a chat model\n * @param options.model - The language model as a string identifier, see more in {@link https://docs.langchain.com/oss/javascript/langchain/models#basic-usage | Models}.\n * @param options.tools - Array of tools or configured ToolNode\n * @param options.prompt - System instructions (string, SystemMessage, or function)\n * @param options.responseFormat - Zod schema for structured output\n * @param options.stateSchema - Custom state schema for memory\n * @param options.middleware - Array of middleware for extending agent behavior, see more in {@link https://docs.langchain.com/oss/javascript/langchain/middleware | Middleware}.\n *\n * @returns A ReactAgent instance with `invoke` and `stream` methods\n *\n * @example Basic agent with tools\n * ```ts\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const search = tool(\n *   ({ query }) => `Results for: ${query}`,\n *   {\n *     name: \"search\",\n *     description: \"Search for information\",\n *     schema: z.object({\n *       query: z.string().describe(\"The search query\"),\n *     })\n *   }\n * );\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [search],\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{ role: \"user\", content: \"Search for ReAct agents\" }],\n * });\n * ```\n *\n * @example Structured output\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const ContactInfo = z.object({\n *   name: z.string(),\n *   email: z.string(),\n *   phone: z.string(),\n * });\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [],\n *   responseFormat: ContactInfo,\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{\n *     role: \"user\",\n *     content: \"Extract: John Doe, john@example.com, (555) 123-4567\"\n *   }],\n * });\n *\n * console.log(result.structuredResponse);\n * // { name: 'John Doe', email: 'john@example.com', phone: '(555) 123-4567' }\n * ```\n *\n * @example Streaming responses\n * ```ts\n * const stream = await agent.stream(\n *   { messages: [{ role: \"user\", content: \"What's the weather?\" }] },\n *   { streamMode: \"values\" }\n * );\n *\n * for await (const chunk of stream) {\n *   // ...\n * }\n * ```\n *\n * @example With StateSchema\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { StateSchema, ReducedValue } from \"@langchain/langgraph\";\n * import { z } from \"zod\";\n *\n * const AgentState = new StateSchema({\n *   userId: z.string(),\n *   count: z.number().default(0),\n *   history: new ReducedValue(\n *     z.array(z.string()).default(() => []),\n *     { inputSchema: z.string(), reducer: (c, n) => [...c, n] }\n *   ),\n * });\n *\n * const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [searchTool],\n *   stateSchema: AgentState,\n * });\n * ```\n */\n// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    InteropZodType<StructuredResponseFormat>\n  > & {\n    responseFormat: InteropZodType<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  StructuredResponseFormat extends readonly InteropZodType<any>[],\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    StructuredResponseFormat\n  > & {\n    responseFormat: StructuredResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 6: With responseFormat as single SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema\n  > & {\n    responseFormat: SerializableSchema;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 7: With responseFormat as array of SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema[]\n  > & {\n    responseFormat: SerializableSchema[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 8: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TypedToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: TypedToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 9: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 10: With responseFormat as ProviderStrategy\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ProviderStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ProviderStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 11: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 12: With responseFormat explicitly undefined\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 13: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  TStateSchema extends StateDefinitionInit,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> =\n    readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    any\n  >\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n> {\n  return new ReactAgent(params);\n}\n\n// Re-export types and utilities\nexport * from \"./types.js\";\nexport * from \"./errors.js\";\nexport * from \"./nodes/types.js\";\nexport type { JumpToTarget } from \"./constants.js\";\nexport type { Runtime } from \"./runtime.js\";\nexport {\n  toolStrategy,\n  providerStrategy,\n  ToolStrategy,\n  ProviderStrategy,\n  type TypedToolStrategy,\n  type ResponseFormat,\n  type ResponseFormatUndefined,\n} from \"./responses.js\";\nexport { createMiddleware } from \"./middleware.js\";\nexport { MIDDLEWARE_BRAND } from \"./middleware/types.js\";\nexport type * from \"./middleware/types.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { ReactAgent } from \"./ReactAgent.js\";\nexport {\n  createToolCallTransformer,\n  createSubagentTransformer,\n  type AgentRunStream,\n  type ToolCallStreamUnion,\n  type SubagentRunStream,\n} from \"./transformers/index.js\";\n"],"mappings":";;;;;;;;;;AA+pBA,SAAgB,YAad,QAeA;CACA,OAAO,IAAIA,mBAAAA,WAAW,MAAM;AAC9B"}

package/dist/agents/index.d.cts

@@ -8,6 +8,7 @@ import { AgentTypeConfig, BuiltInState, CombineStreamTransformers, CombineTools,
 import { createToolCallTransformer } from "./transformers/tool-call.cjs";
 import { AgentRunStream, SubagentRunStream, ToolCallStreamUnion } from "./transformers/types.cjs";
 import { createSubagentTransformer } from "./transformers/subagent.cjs";
+import "./transformers/index.cjs";
 import { ReactAgent } from "./ReactAgent.cjs";
 import { createMiddleware } from "./middleware.cjs";
 import { FakeToolCallingModel } from "./tests/utils.cjs";
@@ -15,7 +16,6 @@ import { ClientTool, ServerTool } from "@langchain/core/tools";
 import { InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
 import { StateDefinitionInit, StreamTransformer } from "@langchain/langgraph";
 import { SerializableSchema } from "@langchain/core/utils/standard_schema";
-
 //#region src/agents/index.d.ts
 /**
  * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools
@@ -236,5 +236,5 @@ declare function createAgent<StructuredResponseFormat extends Record<string, any
   streamTransformers?: TStreamTransformers;
 }): ReactAgent<AgentTypeConfig<StructuredResponseFormat, TStateSchema, ContextSchema, TMiddleware, CombineTools<TTools, TMiddleware>, CombineStreamTransformers<TStreamTransformers, TMiddleware>>>;
 //#endregion
-export { createAgent };
+export { type AfterAgentHook, type AfterModelHook, type AgentMiddleware, type AgentRunStream, AgentTypeConfig, type AnyAgentMiddleware, type AnyAnnotationRoot, type BeforeAgentHook, type BeforeModelHook, BuiltInState, CombineStreamTransformers, CombineTools, CreateAgentParams, DefaultAgentTypeConfig, type DefaultMiddlewareTypeConfig, ExecutedToolCall, ExtractZodArrayTypes, FakeToolCallingModel, InferAgentContext, InferAgentContextSchema, InferAgentMiddleware, InferAgentResponse, InferAgentState, InferAgentStateSchema, InferAgentStreamTransformers, InferAgentTools, InferAgentType, type InferChannelType, type InferContextInput, type InferMergedInputState, type InferMergedState, type InferMiddlewareContext, type InferMiddlewareContextInput, type InferMiddlewareContextInputs, type InferMiddlewareContextSchema, type InferMiddlewareContexts, type InferMiddlewareFullContext, type InferMiddlewareInputState, type InferMiddlewareInputStates, type InferMiddlewareSchema, type InferMiddlewareState, type InferMiddlewareStates, InferMiddlewareStreamTransformers, InferMiddlewareStreamTransformersArray, type InferMiddlewareStreamTransformersFromConfig, InferMiddlewareTools, InferMiddlewareToolsArray, type InferMiddlewareToolsFromConfig, type InferMiddlewareType, type InferSchemaInput, type InferSchemaUpdateType, type InferSchemaValue, type InferSchemaValueType, Interrupt, JumpTo, type JumpToTarget, MIDDLEWARE_BRAND, MiddlewareError, type MiddlewareResult, type MiddlewareTypeConfig, ModelRequest, MultipleStructuredOutputsError, MultipleToolsBoundError, N, type NormalizedSchemaInput, type NormalizedSchemaUpdate, ProviderStrategy, type ReactAgent, ResolveAgentTypeConfig, type ResolveMiddlewareTypeConfig, type ResponseFormat, type ResponseFormatUndefined, type Runtime$1 as Runtime, StructuredOutputParsingError, type SubagentRunStream, type ToAnnotationRoot, ToolCall, type ToolCallHandler, type ToolCallRequest, type ToolCallStreamUnion, ToolInvocationError, ToolResult, ToolStrategy, ToolsToMessageToolSet, type TypedToolStrategy, UserInput, WithStateGraphNodes, type WrapModelCallHandler, type WrapModelCallHook, type WrapToolCallHook, createAgent, createMiddleware, createSubagentTransformer, createToolCallTransformer, providerStrategy, toolStrategy };
 //# sourceMappingURL=index.d.cts.map

package/dist/agents/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/agents/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/agents/index.ts"],"mappings":"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"}

package/dist/agents/index.d.ts

@@ -8,6 +8,7 @@ import { AgentTypeConfig, BuiltInState, CombineStreamTransformers, CombineTools,
 import { createToolCallTransformer } from "./transformers/tool-call.js";
 import { AgentRunStream, SubagentRunStream, ToolCallStreamUnion } from "./transformers/types.js";
 import { createSubagentTransformer } from "./transformers/subagent.js";
+import "./transformers/index.js";
 import { ReactAgent } from "./ReactAgent.js";
 import { createMiddleware } from "./middleware.js";
 import { FakeToolCallingModel } from "./tests/utils.js";
@@ -15,7 +16,6 @@ import { ClientTool, ServerTool } from "@langchain/core/tools";
 import { StateDefinitionInit, StreamTransformer } from "@langchain/langgraph";
 import { InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
 import { SerializableSchema } from "@langchain/core/utils/standard_schema";
-
 //#region src/agents/index.d.ts
 /**
  * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools
@@ -236,5 +236,5 @@ declare function createAgent<StructuredResponseFormat extends Record<string, any
   streamTransformers?: TStreamTransformers;
 }): ReactAgent<AgentTypeConfig<StructuredResponseFormat, TStateSchema, ContextSchema, TMiddleware, CombineTools<TTools, TMiddleware>, CombineStreamTransformers<TStreamTransformers, TMiddleware>>>;
 //#endregion
-export { createAgent };
+export { type AfterAgentHook, type AfterModelHook, type AgentMiddleware, type AgentRunStream, AgentTypeConfig, type AnyAgentMiddleware, type AnyAnnotationRoot, type BeforeAgentHook, type BeforeModelHook, BuiltInState, CombineStreamTransformers, CombineTools, CreateAgentParams, DefaultAgentTypeConfig, type DefaultMiddlewareTypeConfig, ExecutedToolCall, ExtractZodArrayTypes, FakeToolCallingModel, InferAgentContext, InferAgentContextSchema, InferAgentMiddleware, InferAgentResponse, InferAgentState, InferAgentStateSchema, InferAgentStreamTransformers, InferAgentTools, InferAgentType, type InferChannelType, type InferContextInput, type InferMergedInputState, type InferMergedState, type InferMiddlewareContext, type InferMiddlewareContextInput, type InferMiddlewareContextInputs, type InferMiddlewareContextSchema, type InferMiddlewareContexts, type InferMiddlewareFullContext, type InferMiddlewareInputState, type InferMiddlewareInputStates, type InferMiddlewareSchema, type InferMiddlewareState, type InferMiddlewareStates, InferMiddlewareStreamTransformers, InferMiddlewareStreamTransformersArray, type InferMiddlewareStreamTransformersFromConfig, InferMiddlewareTools, InferMiddlewareToolsArray, type InferMiddlewareToolsFromConfig, type InferMiddlewareType, type InferSchemaInput, type InferSchemaUpdateType, type InferSchemaValue, type InferSchemaValueType, Interrupt, JumpTo, type JumpToTarget, MIDDLEWARE_BRAND, MiddlewareError, type MiddlewareResult, type MiddlewareTypeConfig, ModelRequest, MultipleStructuredOutputsError, MultipleToolsBoundError, N, type NormalizedSchemaInput, type NormalizedSchemaUpdate, ProviderStrategy, type ReactAgent, ResolveAgentTypeConfig, type ResolveMiddlewareTypeConfig, type ResponseFormat, type ResponseFormatUndefined, type Runtime$1 as Runtime, StructuredOutputParsingError, type SubagentRunStream, type ToAnnotationRoot, ToolCall, type ToolCallHandler, type ToolCallRequest, type ToolCallStreamUnion, ToolInvocationError, ToolResult, ToolStrategy, ToolsToMessageToolSet, type TypedToolStrategy, UserInput, WithStateGraphNodes, type WrapModelCallHandler, type WrapModelCallHook, type WrapToolCallHook, createAgent, createMiddleware, createSubagentTransformer, createToolCallTransformer, providerStrategy, toolStrategy };
 //# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/agents/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/agents/index.ts"],"mappings":"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"}

package/dist/agents/index.js

@@ -1,17 +1,17 @@
-import "./errors.js";
-import "./responses.js";
-import "./transformers/tool-call.js";
-import "./transformers/subagent.js";
+import { MiddlewareError, MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError } from "./errors.js";
+import { ProviderStrategy, ToolStrategy, providerStrategy, toolStrategy } from "./responses.js";
+import { createToolCallTransformer } from "./transformers/tool-call.js";
+import { createSubagentTransformer } from "./transformers/subagent.js";
 import "./transformers/index.js";
 import { ReactAgent } from "./ReactAgent.js";
-import "./middleware/types.js";
-import "./middleware.js";
-import "./tests/utils.js";
+import { MIDDLEWARE_BRAND } from "./middleware/types.js";
+import { createMiddleware } from "./middleware.js";
+import { FakeToolCallingModel } from "./tests/utils.js";
 //#region src/agents/index.ts
 function createAgent(params) {
 	return new ReactAgent(params);
 }
 //#endregion
-export { createAgent };
+export { FakeToolCallingModel, MIDDLEWARE_BRAND, MiddlewareError, MultipleStructuredOutputsError, MultipleToolsBoundError, ProviderStrategy, StructuredOutputParsingError, ToolInvocationError, ToolStrategy, createAgent, createMiddleware, createSubagentTransformer, createToolCallTransformer, providerStrategy, toolStrategy };
 
 //# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/agents/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport type {\n  StateDefinitionInit,\n  StreamTransformer,\n} from \"@langchain/langgraph\";\n\nimport type { ResponseFormatUndefined } from \"./responses.js\";\nimport type {\n  CreateAgentParams,\n  AgentTypeConfig,\n  CombineTools,\n  CombineStreamTransformers,\n} from \"./types.js\";\nimport type {\n  AnyAgentMiddleware,\n  AnyAnnotationRoot,\n} from \"./middleware/types.js\";\nimport type { ExtractZodArrayTypes } from \"./types.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  JsonSchemaFormat,\n} from \"./responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools\n * and middleware to create systems that can reason about tasks, decide which tools to use, and iteratively\n * work towards solutions.\n *\n * The agent follows the ReAct pattern, interleaving reasoning steps with tool calls to iteratively\n * work towards solutions. It can handle multiple tool calls in sequence or parallel, maintain state\n * across interactions, and provide auditable decision processes.\n *\n * ## Core Components\n *\n * ### Model\n * The reasoning engine can be specified as:\n * - **String identifier**: `\"openai:gpt-4o\"` for simple setup\n * - **Model instance**: Configured model object for full control\n * - **Dynamic function**: Select models at runtime based on state\n *\n * ### Tools\n * Tools give agents the ability to take actions:\n * - Pass an array of tools created with the `tool` function\n * - Or provide a configured `ToolNode` for custom error handling\n *\n * ### Prompt\n * Shape how your agent approaches tasks:\n * - String for simple instructions\n * - SystemMessage for structured prompts\n * - Function for dynamic prompts based on state\n *\n * ### Middleware\n * Middleware allows you to extend the agent's behavior:\n * - Add pre/post-model processing for context injection or validation\n * - Add dynamic control flows, e.g. terminate invocation or retries\n * - Add human-in-the-loop capabilities\n * - Add tool calls to the agent\n * - Add tool results to the agent\n *\n * ## Advanced Features\n *\n * - **Structured Output**: Use `responseFormat` with a Zod schema to get typed responses\n * - **Memory**: Extend the state schema to remember information across interactions\n * - **Streaming**: Get real-time updates as the agent processes\n *\n * @param options - Configuration options for the agent\n * @param options.llm - The language model as an instance of a chat model\n * @param options.model - The language model as a string identifier, see more in {@link https://docs.langchain.com/oss/javascript/langchain/models#basic-usage | Models}.\n * @param options.tools - Array of tools or configured ToolNode\n * @param options.prompt - System instructions (string, SystemMessage, or function)\n * @param options.responseFormat - Zod schema for structured output\n * @param options.stateSchema - Custom state schema for memory\n * @param options.middleware - Array of middleware for extending agent behavior, see more in {@link https://docs.langchain.com/oss/javascript/langchain/middleware | Middleware}.\n *\n * @returns A ReactAgent instance with `invoke` and `stream` methods\n *\n * @example Basic agent with tools\n * ```ts\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const search = tool(\n *   ({ query }) => `Results for: ${query}`,\n *   {\n *     name: \"search\",\n *     description: \"Search for information\",\n *     schema: z.object({\n *       query: z.string().describe(\"The search query\"),\n *     })\n *   }\n * );\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [search],\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{ role: \"user\", content: \"Search for ReAct agents\" }],\n * });\n * ```\n *\n * @example Structured output\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const ContactInfo = z.object({\n *   name: z.string(),\n *   email: z.string(),\n *   phone: z.string(),\n * });\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [],\n *   responseFormat: ContactInfo,\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{\n *     role: \"user\",\n *     content: \"Extract: John Doe, john@example.com, (555) 123-4567\"\n *   }],\n * });\n *\n * console.log(result.structuredResponse);\n * // { name: 'John Doe', email: 'john@example.com', phone: '(555) 123-4567' }\n * ```\n *\n * @example Streaming responses\n * ```ts\n * const stream = await agent.stream(\n *   { messages: [{ role: \"user\", content: \"What's the weather?\" }] },\n *   { streamMode: \"values\" }\n * );\n *\n * for await (const chunk of stream) {\n *   // ...\n * }\n * ```\n *\n * @example With StateSchema\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { StateSchema, ReducedValue } from \"@langchain/langgraph\";\n * import { z } from \"zod\";\n *\n * const AgentState = new StateSchema({\n *   userId: z.string(),\n *   count: z.number().default(0),\n *   history: new ReducedValue(\n *     z.array(z.string()).default(() => []),\n *     { inputSchema: z.string(), reducer: (c, n) => [...c, n] }\n *   ),\n * });\n *\n * const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [searchTool],\n *   stateSchema: AgentState,\n * });\n * ```\n */\n// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    InteropZodType<StructuredResponseFormat>\n  > & {\n    responseFormat: InteropZodType<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  StructuredResponseFormat extends readonly InteropZodType<any>[],\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    StructuredResponseFormat\n  > & {\n    responseFormat: StructuredResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 6: With responseFormat as single SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema\n  > & {\n    responseFormat: SerializableSchema;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 7: With responseFormat as array of SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema[]\n  > & {\n    responseFormat: SerializableSchema[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 8: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TypedToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: TypedToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 9: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 10: With responseFormat as ProviderStrategy\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ProviderStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ProviderStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 11: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 12: With responseFormat explicitly undefined\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 13: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  TStateSchema extends StateDefinitionInit,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> =\n    readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    any\n  >\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n> {\n  return new ReactAgent(params);\n}\n\n// Re-export types and utilities\nexport * from \"./types.js\";\nexport * from \"./errors.js\";\nexport * from \"./nodes/types.js\";\nexport type { JumpToTarget } from \"./constants.js\";\nexport type { Runtime } from \"./runtime.js\";\nexport {\n  toolStrategy,\n  providerStrategy,\n  ToolStrategy,\n  ProviderStrategy,\n  type TypedToolStrategy,\n  type ResponseFormat,\n  type ResponseFormatUndefined,\n} from \"./responses.js\";\nexport { createMiddleware } from \"./middleware.js\";\nexport { MIDDLEWARE_BRAND } from \"./middleware/types.js\";\nexport type * from \"./middleware/types.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { ReactAgent } from \"./ReactAgent.js\";\nexport {\n  createToolCallTransformer,\n  createSubagentTransformer,\n  type AgentRunStream,\n  type ToolCallStreamUnion,\n  type SubagentRunStream,\n} from \"./transformers/index.js\";\n"],"mappings":";;;;;;;;;;AA+pBA,SAAgB,YAad,QAeA;AACA,QAAO,IAAI,WAAW,OAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/agents/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport type {\n  StateDefinitionInit,\n  StreamTransformer,\n} from \"@langchain/langgraph\";\n\nimport type { ResponseFormatUndefined } from \"./responses.js\";\nimport type {\n  CreateAgentParams,\n  AgentTypeConfig,\n  CombineTools,\n  CombineStreamTransformers,\n} from \"./types.js\";\nimport type {\n  AnyAgentMiddleware,\n  AnyAnnotationRoot,\n} from \"./middleware/types.js\";\nimport type { ExtractZodArrayTypes } from \"./types.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  JsonSchemaFormat,\n} from \"./responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools\n * and middleware to create systems that can reason about tasks, decide which tools to use, and iteratively\n * work towards solutions.\n *\n * The agent follows the ReAct pattern, interleaving reasoning steps with tool calls to iteratively\n * work towards solutions. It can handle multiple tool calls in sequence or parallel, maintain state\n * across interactions, and provide auditable decision processes.\n *\n * ## Core Components\n *\n * ### Model\n * The reasoning engine can be specified as:\n * - **String identifier**: `\"openai:gpt-4o\"` for simple setup\n * - **Model instance**: Configured model object for full control\n * - **Dynamic function**: Select models at runtime based on state\n *\n * ### Tools\n * Tools give agents the ability to take actions:\n * - Pass an array of tools created with the `tool` function\n * - Or provide a configured `ToolNode` for custom error handling\n *\n * ### Prompt\n * Shape how your agent approaches tasks:\n * - String for simple instructions\n * - SystemMessage for structured prompts\n * - Function for dynamic prompts based on state\n *\n * ### Middleware\n * Middleware allows you to extend the agent's behavior:\n * - Add pre/post-model processing for context injection or validation\n * - Add dynamic control flows, e.g. terminate invocation or retries\n * - Add human-in-the-loop capabilities\n * - Add tool calls to the agent\n * - Add tool results to the agent\n *\n * ## Advanced Features\n *\n * - **Structured Output**: Use `responseFormat` with a Zod schema to get typed responses\n * - **Memory**: Extend the state schema to remember information across interactions\n * - **Streaming**: Get real-time updates as the agent processes\n *\n * @param options - Configuration options for the agent\n * @param options.llm - The language model as an instance of a chat model\n * @param options.model - The language model as a string identifier, see more in {@link https://docs.langchain.com/oss/javascript/langchain/models#basic-usage | Models}.\n * @param options.tools - Array of tools or configured ToolNode\n * @param options.prompt - System instructions (string, SystemMessage, or function)\n * @param options.responseFormat - Zod schema for structured output\n * @param options.stateSchema - Custom state schema for memory\n * @param options.middleware - Array of middleware for extending agent behavior, see more in {@link https://docs.langchain.com/oss/javascript/langchain/middleware | Middleware}.\n *\n * @returns A ReactAgent instance with `invoke` and `stream` methods\n *\n * @example Basic agent with tools\n * ```ts\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const search = tool(\n *   ({ query }) => `Results for: ${query}`,\n *   {\n *     name: \"search\",\n *     description: \"Search for information\",\n *     schema: z.object({\n *       query: z.string().describe(\"The search query\"),\n *     })\n *   }\n * );\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [search],\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{ role: \"user\", content: \"Search for ReAct agents\" }],\n * });\n * ```\n *\n * @example Structured output\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const ContactInfo = z.object({\n *   name: z.string(),\n *   email: z.string(),\n *   phone: z.string(),\n * });\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [],\n *   responseFormat: ContactInfo,\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{\n *     role: \"user\",\n *     content: \"Extract: John Doe, john@example.com, (555) 123-4567\"\n *   }],\n * });\n *\n * console.log(result.structuredResponse);\n * // { name: 'John Doe', email: 'john@example.com', phone: '(555) 123-4567' }\n * ```\n *\n * @example Streaming responses\n * ```ts\n * const stream = await agent.stream(\n *   { messages: [{ role: \"user\", content: \"What's the weather?\" }] },\n *   { streamMode: \"values\" }\n * );\n *\n * for await (const chunk of stream) {\n *   // ...\n * }\n * ```\n *\n * @example With StateSchema\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { StateSchema, ReducedValue } from \"@langchain/langgraph\";\n * import { z } from \"zod\";\n *\n * const AgentState = new StateSchema({\n *   userId: z.string(),\n *   count: z.number().default(0),\n *   history: new ReducedValue(\n *     z.array(z.string()).default(() => []),\n *     { inputSchema: z.string(), reducer: (c, n) => [...c, n] }\n *   ),\n * });\n *\n * const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [searchTool],\n *   stateSchema: AgentState,\n * });\n * ```\n */\n// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    InteropZodType<StructuredResponseFormat>\n  > & {\n    responseFormat: InteropZodType<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  StructuredResponseFormat extends readonly InteropZodType<any>[],\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    StructuredResponseFormat\n  > & {\n    responseFormat: StructuredResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ExtractZodArrayTypes<StructuredResponseFormat> extends Record<string, any>\n      ? ExtractZodArrayTypes<StructuredResponseFormat>\n      : Record<string, any>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 6: With responseFormat as single SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema\n  > & {\n    responseFormat: SerializableSchema;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 7: With responseFormat as array of SerializableSchema\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    SerializableSchema[]\n  > & {\n    responseFormat: SerializableSchema[];\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    Record<string, unknown>,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 8: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TypedToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: TypedToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 9: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ToolStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ToolStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 10: With responseFormat as ProviderStrategy\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ProviderStrategy<StructuredResponseFormat>\n  > & {\n    responseFormat: ProviderStrategy<StructuredResponseFormat>;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 11: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 12: With responseFormat explicitly undefined\nexport function createAgent<\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: Omit<\n    CreateAgentParams<\n      ResponseFormatUndefined,\n      TStateSchema,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    ResponseFormatUndefined,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Overload 13: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  TStateSchema extends StateDefinitionInit | undefined = undefined,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject =\n    AnyAnnotationRoot,\n  const TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  const TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  const TStreamTransformers extends ReadonlyArray<\n    () => StreamTransformer<any>\n  > = readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n    tools?: TTools;\n    streamTransformers?: TStreamTransformers;\n  }\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  TStateSchema extends StateDefinitionInit,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddleware extends readonly AnyAgentMiddleware[] =\n    readonly AnyAgentMiddleware[],\n  TTools extends readonly (ClientTool | ServerTool)[] = readonly (\n    | ClientTool\n    | ServerTool\n  )[],\n  TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> =\n    readonly [],\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    any\n  >\n): ReactAgent<\n  AgentTypeConfig<\n    StructuredResponseFormat,\n    TStateSchema,\n    ContextSchema,\n    TMiddleware,\n    CombineTools<TTools, TMiddleware>,\n    CombineStreamTransformers<TStreamTransformers, TMiddleware>\n  >\n> {\n  return new ReactAgent(params);\n}\n\n// Re-export types and utilities\nexport * from \"./types.js\";\nexport * from \"./errors.js\";\nexport * from \"./nodes/types.js\";\nexport type { JumpToTarget } from \"./constants.js\";\nexport type { Runtime } from \"./runtime.js\";\nexport {\n  toolStrategy,\n  providerStrategy,\n  ToolStrategy,\n  ProviderStrategy,\n  type TypedToolStrategy,\n  type ResponseFormat,\n  type ResponseFormatUndefined,\n} from \"./responses.js\";\nexport { createMiddleware } from \"./middleware.js\";\nexport { MIDDLEWARE_BRAND } from \"./middleware/types.js\";\nexport type * from \"./middleware/types.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { ReactAgent } from \"./ReactAgent.js\";\nexport {\n  createToolCallTransformer,\n  createSubagentTransformer,\n  type AgentRunStream,\n  type ToolCallStreamUnion,\n  type SubagentRunStream,\n} from \"./transformers/index.js\";\n"],"mappings":";;;;;;;;;;AA+pBA,SAAgB,YAad,QAeA;CACA,OAAO,IAAI,WAAW,MAAM;AAC9B"}

package/dist/agents/middleware/constants.cjs

@@ -1,6 +1,7 @@
-require("../../_virtual/_rolldown/runtime.cjs");
 let zod_v3 = require("zod/v3");
 //#region src/agents/middleware/constants.ts
+/** LangGraph's messages handlers skip runs tagged with this, keeping middleware-internal model calls out of the messages stream. */
+const INTERNAL_CALL_TAG = "nostream";
 const RetrySchema = zod_v3.z.object({
 	/**
 	* Maximum number of retry attempts after the initial call.
@@ -35,6 +36,7 @@ const RetrySchema = zod_v3.z.object({
 	jitter: zod_v3.z.boolean().default(true)
 });
 //#endregion
+exports.INTERNAL_CALL_TAG = INTERNAL_CALL_TAG;
 exports.RetrySchema = RetrySchema;
 
 //# sourceMappingURL=constants.cjs.map

package/dist/agents/middleware/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.cjs","names":["z"],"sources":["../../../src/agents/middleware/constants.ts"],"sourcesContent":["import { z } from \"zod/v3\";\n\nexport const RetrySchema = z.object({\n  /**\n   * Maximum number of retry attempts after the initial call.\n   * Default is 2 retries (3 total attempts). Must be >= 0.\n   */\n  maxRetries: z.number().min(0).default(2),\n\n  /**\n   * Either an array of error constructors to retry on, or a function\n   * that takes an error and returns `true` if it should be retried.\n   * Default is to retry on all errors.\n   */\n  retryOn: z\n    .union([\n      z.function().args(z.instanceof(Error)).returns(z.boolean()),\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      z.array(z.custom<new (...args: any[]) => Error>()),\n    ])\n    .default(() => () => true),\n\n  /**\n   * Multiplier for exponential backoff. Each retry waits\n   * `initialDelayMs * (backoffFactor ** retryNumber)` milliseconds.\n   * Set to 0.0 for constant delay. Default is 2.0.\n   */\n  backoffFactor: z.number().min(0).default(2.0),\n\n  /**\n   * Initial delay in milliseconds before first retry. Default is 1000 (1 second).\n   */\n  initialDelayMs: z.number().min(0).default(1000),\n\n  /**\n   * Maximum delay in milliseconds between retries. Caps exponential\n   * backoff growth. Default is 60000 (60 seconds).\n   */\n  maxDelayMs: z.number().min(0).default(60000),\n\n  /**\n   * Whether to add random jitter (±25%) to delay to avoid thundering herd.\n   * Default is `true`.\n   */\n  jitter: z.boolean().default(true),\n});\n"],"mappings":";;;AAEA,MAAa,cAAcA,OAAAA,EAAE,OAAO;;;;;CAKlC,YAAYA,OAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;;;;;;CAOxC,SAASA,OAAAA,EACN,MAAM,CACLA,OAAAA,EAAE,UAAU,CAAC,KAAKA,OAAAA,EAAE,WAAW,MAAM,CAAC,CAAC,QAAQA,OAAAA,EAAE,SAAS,CAAC,EAE3DA,OAAAA,EAAE,MAAMA,OAAAA,EAAE,QAAuC,CAAC,CACnD,CAAC,CACD,oBAAoB,KAAK;;;;;;CAO5B,eAAeA,OAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAI;;;;CAK7C,gBAAgBA,OAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,IAAK;;;;;CAM/C,YAAYA,OAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,IAAM;;;;;CAM5C,QAAQA,OAAAA,EAAE,SAAS,CAAC,QAAQ,KAAK;CAClC,CAAC"}
+{"version":3,"file":"constants.cjs","names":["z"],"sources":["../../../src/agents/middleware/constants.ts"],"sourcesContent":["import { z } from \"zod/v3\";\n\n/** LangGraph's messages handlers skip runs tagged with this, keeping middleware-internal model calls out of the messages stream. */\nexport const INTERNAL_CALL_TAG = \"nostream\";\n\nexport const RetrySchema = z.object({\n  /**\n   * Maximum number of retry attempts after the initial call.\n   * Default is 2 retries (3 total attempts). Must be >= 0.\n   */\n  maxRetries: z.number().min(0).default(2),\n\n  /**\n   * Either an array of error constructors to retry on, or a function\n   * that takes an error and returns `true` if it should be retried.\n   * Default is to retry on all errors.\n   */\n  retryOn: z\n    .union([\n      z.function().args(z.instanceof(Error)).returns(z.boolean()),\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      z.array(z.custom<new (...args: any[]) => Error>()),\n    ])\n    .default(() => () => true),\n\n  /**\n   * Multiplier for exponential backoff. Each retry waits\n   * `initialDelayMs * (backoffFactor ** retryNumber)` milliseconds.\n   * Set to 0.0 for constant delay. Default is 2.0.\n   */\n  backoffFactor: z.number().min(0).default(2.0),\n\n  /**\n   * Initial delay in milliseconds before first retry. Default is 1000 (1 second).\n   */\n  initialDelayMs: z.number().min(0).default(1000),\n\n  /**\n   * Maximum delay in milliseconds between retries. Caps exponential\n   * backoff growth. Default is 60000 (60 seconds).\n   */\n  maxDelayMs: z.number().min(0).default(60000),\n\n  /**\n   * Whether to add random jitter (±25%) to delay to avoid thundering herd.\n   * Default is `true`.\n   */\n  jitter: z.boolean().default(true),\n});\n"],"mappings":";;;AAGA,MAAa,oBAAoB;AAEjC,MAAa,cAAcA,OAAAA,EAAE,OAAO;;;;;CAKlC,YAAYA,OAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;;;;;;CAOvC,SAASA,OAAAA,EACN,MAAM,CACLA,OAAAA,EAAE,SAAS,CAAC,CAAC,KAAKA,OAAAA,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,QAAQA,OAAAA,EAAE,QAAQ,CAAC,GAE1DA,OAAAA,EAAE,MAAMA,OAAAA,EAAE,OAAsC,CAAC,CACnD,CAAC,CAAC,CACD,oBAAoB,IAAI;;;;;;CAO3B,eAAeA,OAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAG;;;;CAK5C,gBAAgBA,OAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAI;;;;;CAM9C,YAAYA,OAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAK;;;;;CAM3C,QAAQA,OAAAA,EAAE,QAAQ,CAAC,CAAC,QAAQ,IAAI;AAClC,CAAC"}