langchain 1.0.0-alpha.8 → 1.0.0-alpha.9

package/dist/agents/annotation.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotation.js","names":["PreHookAnnotation: AnnotationRoot<{\n  llmInputMessages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n}>","stateSchema: AnyAnnotationRoot | InteropZodObject","annotationFields: Record<string, any>","_: unknown","update: unknown","current: unknown[]","update: unknown[]","config: (typeof ZOD_TYPE_CONFIGS)[keyof typeof ZOD_TYPE_CONFIGS]","defaultValueFn: () => unknown","zodType: any","config"],"sources":["../../src/agents/annotation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  Annotation,\n  Messages,\n  AnnotationRoot,\n  messagesStateReducer,\n  type BinaryOperatorAggregate,\n  type LastValue,\n} from \"@langchain/langgraph\";\nimport type { InteropZodToStateDefinition } from \"@langchain/langgraph/zod\";\nimport {\n  isInteropZodSchema,\n  getInteropZodObjectShape,\n  getInteropZodDefaultGetter,\n  type InteropZodObject,\n} from \"@langchain/core/utils/types\";\n\n/**\n * Special type to indicate that no response format is provided.\n * When this type is used, the structuredResponse property should not be present in the result.\n */\nexport type ResponseFormatUndefined = {\n  __responseFormatUndefined: true;\n};\n\nexport const PreHookAnnotation: AnnotationRoot<{\n  llmInputMessages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n}> = Annotation.Root({\n  llmInputMessages: Annotation<BaseMessage[], Messages>({\n    reducer: (_, update) => messagesStateReducer([], update),\n    default: () => [],\n  }),\n  messages: Annotation<BaseMessage[], Messages>({\n    reducer: messagesStateReducer,\n    default: () => [],\n  }),\n});\nexport type PreHookAnnotation = typeof PreHookAnnotation;\n\n// Base annotation without structuredResponse (for ResponseFormatUndefined)\nexport const createAgentBaseAnnotation = () =>\n  Annotation.Root({\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n  });\n\n// Full annotation with structuredResponse (for regular cases)\nexport const createAgentAnnotation = <\n  T extends Record<string, any> = Record<string, any>\n>(): AnnotationRoot<{\n  structuredResponse: LastValue<T>;\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n}> =>\n  Annotation.Root({\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n    structuredResponse: Annotation<T>(),\n  });\n\n// Create annotation conditionally - for ResponseFormatUndefined, don't include structuredResponse\nexport function createAgentAnnotationConditional<\n  T extends Record<string, any> | ResponseFormatUndefined\n>(\n  hasStructuredResponse = true\n): AnnotationRoot<{\n  structuredResponse: LastValue<T extends ResponseFormatUndefined ? never : T>;\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n}> {\n  const baseAnnotation = {\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n  };\n\n  if (!hasStructuredResponse) {\n    return Annotation.Root(baseAnnotation) as AnnotationRoot<{\n      structuredResponse: LastValue<\n        T extends ResponseFormatUndefined ? never : T\n      >;\n      messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n    }>;\n  }\n\n  return Annotation.Root({\n    ...baseAnnotation,\n    structuredResponse:\n      Annotation<T extends ResponseFormatUndefined ? never : T>(),\n  });\n}\n\n// Helper type to select the right annotation based on the response format type\nexport type ReactAgentAnnotation<\n  T extends Record<string, any> | ResponseFormatUndefined\n> = T extends ResponseFormatUndefined\n  ? ReturnType<typeof createAgentBaseAnnotation>\n  : T extends Record<string, any>\n  ? ReturnType<typeof createAgentAnnotation<T>>\n  : never;\n\nexport type ToAnnotationRoot<A extends AnyAnnotationRoot | InteropZodObject> =\n  A extends AnyAnnotationRoot\n    ? A\n    : A extends InteropZodObject\n    ? AnnotationRoot<InteropZodToStateDefinition<A>>\n    : never;\n\nexport type AnyAnnotationRoot = AnnotationRoot<any>;\n\n/**\n * Enhances a state schema to ensure proper message handling.\n * If a Zod schema is provided, it creates an annotation that includes the messagesStateReducer\n * and infers appropriate reducers for all other fields.\n *\n * @param stateSchema - The state schema to enhance.\n * @returns The enhanced state schema.\n */\nexport function enhanceStateSchemaWithMessageReducer(\n  stateSchema: AnyAnnotationRoot | InteropZodObject\n) {\n  /**\n   * If it's already an annotation, return as-is\n   */\n  if (typeof stateSchema === \"object\" && \"State\" in stateSchema) {\n    return stateSchema;\n  }\n\n  /**\n   * If it's a Zod schema, create annotations for all fields\n   */\n  if (isInteropZodSchema(stateSchema)) {\n    const shape = getInteropZodObjectShape(stateSchema);\n    const annotationFields: Record<string, any> = {};\n\n    /**\n     * Process each field in the Zod schema\n     */\n    for (const [key, zodType] of Object.entries(shape)) {\n      annotationFields[key] =\n        key === \"messages\"\n          ? /**\n             * Special handling for messages field - always use messagesStateReducer\n             */\n            Annotation<BaseMessage[]>({\n              reducer: messagesStateReducer,\n              default: () => [],\n            })\n          : /**\n             * For other fields, create appropriate annotations based on type\n             */\n            createAnnotationForZodType(zodType);\n    }\n\n    /**\n     * Ensure messages field exists even if not in the Zod schema\n     */\n    if (!annotationFields.messages) {\n      annotationFields.messages = Annotation<BaseMessage[]>({\n        reducer: messagesStateReducer,\n        default: () => [],\n      });\n    }\n\n    return Annotation.Root(annotationFields);\n  }\n\n  /**\n   * Fallback: create a base annotation with message reducer only\n   */\n  return Annotation.Root({\n    messages: Annotation<BaseMessage[]>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n  });\n}\n\n/**\n * Type configuration for different Zod types\n */\nconst ZOD_TYPE_CONFIGS = {\n  ZodString: {\n    reducer: (_: unknown, update: unknown) => update,\n    fallbackDefault: \"\",\n  },\n  ZodNumber: {\n    reducer: (_: unknown, update: unknown) => update,\n    fallbackDefault: 0,\n  },\n  ZodBoolean: {\n    reducer: (_: unknown, update: unknown) => update,\n    fallbackDefault: false,\n  },\n  ZodArray: {\n    reducer: (_: unknown, update: unknown) => update,\n    fallbackDefault: [] as unknown[],\n  },\n  ZodRecord: {\n    reducer: (current: unknown[], update: unknown[]) => ({\n      ...current,\n      ...update,\n    }),\n    fallbackDefault: {} as Record<string, unknown>,\n  },\n  ZodObject: {\n    reducer: (current: unknown[], update: unknown[]) => ({\n      ...current,\n      ...update,\n    }),\n    fallbackDefault: {} as Record<string, unknown>,\n  },\n} as const;\n\n/**\n * Creates an annotation based on type configuration and default value\n */\nfunction createAnnotationFromConfig(\n  config: (typeof ZOD_TYPE_CONFIGS)[keyof typeof ZOD_TYPE_CONFIGS],\n  defaultValueFn: () => unknown\n) {\n  return Annotation<any>({\n    reducer: config.reducer,\n    default: defaultValueFn,\n  });\n}\n\n/**\n * Creates an appropriate annotation for a given Zod type.\n */\nfunction createAnnotationForZodType(zodType: any): any {\n  const typeName = zodType._def?.typeName;\n  const defaultGetter = getInteropZodDefaultGetter(zodType);\n  const isOptional = typeName === \"ZodOptional\";\n\n  /**\n   * Handle Zod wrapper first\n   */\n  if (\n    typeName === \"ZodDefault\" ||\n    typeName === \"ZodOptional\" ||\n    typeName === \"ZodNullable\"\n  ) {\n    const innerTypeName = zodType._def.innerType._def?.typeName;\n    const config =\n      ZOD_TYPE_CONFIGS[innerTypeName as keyof typeof ZOD_TYPE_CONFIGS];\n    return config\n      ? createAnnotationFromConfig(\n          config,\n          () =>\n            defaultGetter?.() ||\n            (isOptional ? undefined : config?.fallbackDefault)\n        )\n      : Annotation<unknown>({\n          reducer: (_: unknown, update: unknown) => update,\n          default: () => defaultGetter?.(),\n        });\n  }\n\n  /**\n   * Handle regular types\n   */\n  const config = ZOD_TYPE_CONFIGS[typeName as keyof typeof ZOD_TYPE_CONFIGS];\n  if (config) {\n    return createAnnotationFromConfig(\n      config,\n      () => defaultGetter?.() || config?.fallbackDefault\n    );\n  }\n\n  /**\n   * Fallback for unknown types\n   */\n  return Annotation<unknown>({\n    reducer: (_: unknown, update: unknown) => update,\n    default: () => defaultGetter?.(),\n  });\n}\n"],"mappings":";;;;AA0BA,MAAaA,oBAGR,WAAW,KAAK;CACnB,kBAAkB,WAAoC;EACpD,SAAS,CAAC,GAAG,WAAW,qBAAqB,CAAE,GAAE,OAAO;EACxD,SAAS,MAAM,CAAE;CAClB,EAAC;CACF,UAAU,WAAoC;EAC5C,SAAS;EACT,SAAS,MAAM,CAAE;CAClB,EAAC;AACH,EAAC;AAIF,MAAa,4BAA4B,MACvC,WAAW,KAAK,EACd,UAAU,WAAoC;CAC5C,SAAS;CACT,SAAS,MAAM,CAAE;AAClB,EAAC,CACH,EAAC;AAGJ,MAAa,wBAAwB,MAMnC,WAAW,KAAK;CACd,UAAU,WAAoC;EAC5C,SAAS;EACT,SAAS,MAAM,CAAE;CAClB,EAAC;CACF,oBAAoB,YAAe;AACpC,EAAC;AAGJ,SAAgB,iCAGd,wBAAwB,MAIvB;CACD,MAAM,iBAAiB,EACrB,UAAU,WAAoC;EAC5C,SAAS;EACT,SAAS,MAAM,CAAE;CAClB,EAAC,CACH;AAED,KAAI,CAAC,sBACH,QAAO,WAAW,KAAK,eAAe;AAQxC,QAAO,WAAW,KAAK;EACrB,GAAG;EACH,oBACE,YAA2D;CAC9D,EAAC;AACH;;;;;;;;;AA4BD,SAAgB,qCACdC,aACA;;;;AAIA,KAAI,OAAO,gBAAgB,YAAY,WAAW,YAChD,QAAO;;;;AAMT,KAAI,mBAAmB,YAAY,EAAE;EACnC,MAAM,QAAQ,yBAAyB,YAAY;EACnD,MAAMC,mBAAwC,CAAE;;;;AAKhD,OAAK,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,QAAQ,MAAM,EAChD,iBAAiB,OACf,QAAQ,aAIJ,WAA0B;GACxB,SAAS;GACT,SAAS,MAAM,CAAE;EAClB,EAAC,GAIF,2BAA2B,QAAQ;;;;AAM3C,MAAI,CAAC,iBAAiB,UACpB,iBAAiB,WAAW,WAA0B;GACpD,SAAS;GACT,SAAS,MAAM,CAAE;EAClB,EAAC;AAGJ,SAAO,WAAW,KAAK,iBAAiB;CACzC;;;;AAKD,QAAO,WAAW,KAAK,EACrB,UAAU,WAA0B;EAClC,SAAS;EACT,SAAS,MAAM,CAAE;CAClB,EAAC,CACH,EAAC;AACH;;;;AAKD,MAAM,mBAAmB;CACvB,WAAW;EACT,SAAS,CAACC,GAAYC,WAAoB;EAC1C,iBAAiB;CAClB;CACD,WAAW;EACT,SAAS,CAACD,GAAYC,WAAoB;EAC1C,iBAAiB;CAClB;CACD,YAAY;EACV,SAAS,CAACD,GAAYC,WAAoB;EAC1C,iBAAiB;CAClB;CACD,UAAU;EACR,SAAS,CAACD,GAAYC,WAAoB;EAC1C,iBAAiB,CAAE;CACpB;CACD,WAAW;EACT,SAAS,CAACC,SAAoBC,YAAuB;GACnD,GAAG;GACH,GAAG;EACJ;EACD,iBAAiB,CAAE;CACpB;CACD,WAAW;EACT,SAAS,CAACD,SAAoBC,YAAuB;GACnD,GAAG;GACH,GAAG;EACJ;EACD,iBAAiB,CAAE;CACpB;AACF;;;;AAKD,SAAS,2BACPC,QACAC,gBACA;AACA,QAAO,WAAgB;EACrB,SAAS,OAAO;EAChB,SAAS;CACV,EAAC;AACH;;;;AAKD,SAAS,2BAA2BC,SAAmB;CACrD,MAAM,WAAW,QAAQ,MAAM;CAC/B,MAAM,gBAAgB,2BAA2B,QAAQ;CACzD,MAAM,aAAa,aAAa;;;;AAKhC,KACE,aAAa,gBACb,aAAa,iBACb,aAAa,eACb;EACA,MAAM,gBAAgB,QAAQ,KAAK,UAAU,MAAM;EACnD,MAAMC,WACJ,iBAAiB;AACnB,SAAOA,WACH,2BACEA,UACA,MACE,iBAAiB,KAChB,aAAa,SAAYA,UAAQ,iBACrC,GACD,WAAoB;GAClB,SAAS,CAACP,GAAYC,WAAoB;GAC1C,SAAS,MAAM,iBAAiB;EACjC,EAAC;CACP;;;;CAKD,MAAM,SAAS,iBAAiB;AAChC,KAAI,OACF,QAAO,2BACL,QACA,MAAM,iBAAiB,IAAI,QAAQ,gBACpC;;;;AAMH,QAAO,WAAoB;EACzB,SAAS,CAACD,GAAYC,WAAoB;EAC1C,SAAS,MAAM,iBAAiB;CACjC,EAAC;AACH"}
+{"version":3,"file":"annotation.js","names":["middlewareList: TMiddleware","zodSchema: Record<string, any>","PreHookAnnotation: AnnotationRoot<{\n  llmInputMessages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n}>","_x: Messages","update: Messages"],"sources":["../../src/agents/annotation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod/v3\";\nimport {\n  Messages,\n  AnnotationRoot,\n  MessagesZodMeta,\n  type BinaryOperatorAggregate,\n} from \"@langchain/langgraph\";\nimport { withLangGraph } from \"@langchain/langgraph/zod\";\n\nimport type { AgentMiddleware } from \"./middleware/types.js\";\n\nexport function createAgentAnnotationConditional<\n  TMiddleware extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  hasStructuredResponse = true,\n  middlewareList: TMiddleware = [] as unknown as TMiddleware\n) {\n  /**\n   * Create Zod schema object to preserve jsonSchemaExtra\n   * metadata for LangGraph Studio using v3-compatible withLangGraph\n   */\n  const zodSchema: Record<string, any> = {\n    messages: withLangGraph(z.custom<BaseMessage[]>(), MessagesZodMeta),\n    jumpTo: z\n      .union([z.literal(\"model_request\"), z.literal(\"tools\"), z.undefined()])\n      .optional(),\n  };\n\n  /**\n   * Add middleware state properties to the Zod schema\n   */\n  for (const middleware of middlewareList) {\n    if (middleware.stateSchema) {\n      const { shape } = middleware.stateSchema;\n      for (const [key, schema] of Object.entries(shape)) {\n        /**\n         * Skip private state properties\n         */\n        if (key.startsWith(\"_\")) {\n          continue;\n        }\n\n        if (!(key in zodSchema)) {\n          zodSchema[key] = schema;\n        }\n      }\n    }\n  }\n\n  // Only include structuredResponse when responseFormat is defined\n  if (hasStructuredResponse) {\n    zodSchema.structuredResponse = z.any().optional();\n  }\n\n  return z.object(zodSchema);\n}\n\nexport const PreHookAnnotation: AnnotationRoot<{\n  llmInputMessages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n}> = z.object({\n  llmInputMessages: withLangGraph(z.custom<BaseMessage[]>(), {\n    reducer: {\n      fn: (_x: Messages, update: Messages) =>\n        MessagesZodMeta.reducer!.fn([], update),\n    },\n    default: () => [],\n  }),\n  /**\n   * Use MessagesZodMeta to preserve jsonSchemaExtra metadata\n   * for LangGraph Studio UI to render proper messages input field\n   */\n  messages: withLangGraph(z.custom<BaseMessage[]>(), MessagesZodMeta),\n}) as unknown as AnnotationRoot<{\n  llmInputMessages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n}>;\nexport type PreHookAnnotation = typeof PreHookAnnotation;\n"],"mappings":";;;;;AAaA,SAAgB,iCAGd,wBAAwB,MACxBA,iBAA8B,CAAE,GAChC;;;;;CAKA,MAAMC,YAAiC;EACrC,UAAU,cAAc,EAAE,QAAuB,EAAE,gBAAgB;EACnE,QAAQ,EACL,MAAM;GAAC,EAAE,QAAQ,gBAAgB;GAAE,EAAE,QAAQ,QAAQ;GAAE,EAAE,WAAW;EAAC,EAAC,CACtE,UAAU;CACd;;;;AAKD,MAAK,MAAM,cAAc,eACvB,KAAI,WAAW,aAAa;EAC1B,MAAM,EAAE,OAAO,GAAG,WAAW;AAC7B,OAAK,MAAM,CAAC,KAAK,OAAO,IAAI,OAAO,QAAQ,MAAM,EAAE;;;;AAIjD,OAAI,IAAI,WAAW,IAAI,CACrB;AAGF,OAAI,EAAE,OAAO,YACX,UAAU,OAAO;EAEpB;CACF;AAIH,KAAI,uBACF,UAAU,qBAAqB,EAAE,KAAK,CAAC,UAAU;AAGnD,QAAO,EAAE,OAAO,UAAU;AAC3B;AAED,MAAaC,oBAGR,EAAE,OAAO;CACZ,kBAAkB,cAAc,EAAE,QAAuB,EAAE;EACzD,SAAS,EACP,IAAI,CAACC,IAAcC,WACjB,gBAAgB,QAAS,GAAG,CAAE,GAAE,OAAO,CAC1C;EACD,SAAS,MAAM,CAAE;CAClB,EAAC;CAKF,UAAU,cAAc,EAAE,QAAuB,EAAE,gBAAgB;AACpE,EAAC"}

package/dist/agents/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.cjs","names":[],"sources":["../../src/agents/constants.ts"],"sourcesContent":["export const PROMPT_RUNNABLE_NAME = \"prompt\";\n"],"mappings":";;AAAA,MAAa,uBAAuB"}
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../src/agents/constants.ts"],"sourcesContent":["/**\n * jump targets (user facing)\n */\nexport const JUMP_TO_TARGETS = [\"model\", \"tools\", \"end\"] as const;\nexport type JumpToTarget = (typeof JUMP_TO_TARGETS)[number];\n\nexport const PROMPT_RUNNABLE_NAME = \"prompt\";\n"],"mappings":";;AAMA,MAAa,uBAAuB"}

package/dist/agents/constants.d.cts

@@ -0,0 +1,9 @@
+//#region src/agents/constants.d.ts
+/**
+ * jump targets (user facing)
+ */
+declare const JUMP_TO_TARGETS: readonly ["model", "tools", "end"];
+type JumpToTarget = (typeof JUMP_TO_TARGETS)[number];
+//#endregion
+export { JumpToTarget };
+//# sourceMappingURL=constants.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","names":["JUMP_TO_TARGETS","JumpToTarget","PROMPT_RUNNABLE_NAME"],"sources":["../../src/agents/constants.d.ts"],"sourcesContent":["/**\n * jump targets (user facing)\n */\nexport declare const JUMP_TO_TARGETS: readonly [\"model\", \"tools\", \"end\"];\nexport type JumpToTarget = (typeof JUMP_TO_TARGETS)[number];\nexport declare const PROMPT_RUNNABLE_NAME = \"prompt\";\n"],"mappings":";;AAGA;AACA;cADqBA;KACTC,YAAAA,WAAuBD"}

package/dist/agents/constants.d.ts

@@ -0,0 +1,9 @@
+//#region src/agents/constants.d.ts
+/**
+ * jump targets (user facing)
+ */
+declare const JUMP_TO_TARGETS: readonly ["model", "tools", "end"];
+type JumpToTarget = (typeof JUMP_TO_TARGETS)[number];
+//#endregion
+export { JumpToTarget };
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":["JUMP_TO_TARGETS","JumpToTarget","PROMPT_RUNNABLE_NAME"],"sources":["../../src/agents/constants.d.ts"],"sourcesContent":["/**\n * jump targets (user facing)\n */\nexport declare const JUMP_TO_TARGETS: readonly [\"model\", \"tools\", \"end\"];\nexport type JumpToTarget = (typeof JUMP_TO_TARGETS)[number];\nexport declare const PROMPT_RUNNABLE_NAME = \"prompt\";\n"],"mappings":";;AAGA;AACA;cADqBA;KACTC,YAAAA,WAAuBD"}

package/dist/agents/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../../src/agents/constants.ts"],"sourcesContent":["export const PROMPT_RUNNABLE_NAME = \"prompt\";\n"],"mappings":";AAAA,MAAa,uBAAuB"}
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/agents/constants.ts"],"sourcesContent":["/**\n * jump targets (user facing)\n */\nexport const JUMP_TO_TARGETS = [\"model\", \"tools\", \"end\"] as const;\nexport type JumpToTarget = (typeof JUMP_TO_TARGETS)[number];\n\nexport const PROMPT_RUNNABLE_NAME = \"prompt\";\n"],"mappings":";AAMA,MAAa,uBAAuB"}

package/dist/agents/errors.cjs

@@ -35,7 +35,8 @@ var ToolInvocationError = class extends Error {
 	toolError;
 	constructor(toolError, toolCall) {
 		const error = toolError instanceof Error ? toolError : new Error(String(toolError));
-		super(`Error invoking tool '${toolCall.name}' with kwargs ${JSON.stringify(toolCall.args)} with error:\n ${error.stack}\n Please fix the error and try again.`);
+		const toolArgs = JSON.stringify(toolCall.args);
+		super(`Error invoking tool '${toolCall.name}' with kwargs ${toolArgs} with error: ${error.stack}\n Please fix the error and try again.`);
 		this.toolCall = toolCall;
 		this.toolError = error;
 	}

package/dist/agents/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":["toolNames: string[]","toolName: string","errors: string[]","toolError: unknown","toolCall: ToolCall"],"sources":["../../src/agents/errors.ts"],"sourcesContent":["/* eslint-disable no-instanceof/no-instanceof */\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\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  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    super(\n      `Error invoking tool '${toolCall.name}' with kwargs ${JSON.stringify(\n        toolCall.args\n      )} ` +\n        `with error:\\n ${error.stack}\\n Please fix the error and try again.`\n    );\n\n    this.toolCall = toolCall;\n    this.toolError = error;\n  }\n}\n"],"mappings":";;AAGA,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MACE,uKAGD;CACF;AACF;;;;AAKD,IAAa,iCAAb,cAAoD,MAAM;CACxD,AAAgB;CAEhB,YAAYA,WAAqB;EAC/B,MACE,CAAC,qCAAqC,EAAE,UAAU,KAChD,KACD,CAAC,iGAAgC,CACmC,CACtE;EACD,KAAK,YAAY;CAClB;AACF;;;;AAKD,IAAa,+BAAb,cAAkD,MAAM;CACtD,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,UAAkBC,QAAkB;EAC9C,MACE,CAAC,4CAA4C,EAAE,SAAS,EAAE,EAAE,OACzD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACxB,KAAK,GAAG,CAAC,CAAC,CAAC,CACf;EACD,KAAK,WAAW;EAChB,KAAK,SAAS;CACf;AACF;;;;AAKD,IAAa,sBAAb,cAAyC,MAAM;CAC7C,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,WAAoBC,UAAoB;EAClD,MAAM,QACJ,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,UAAU;EACtE,MACE,CAAC,qBAAqB,EAAE,SAAS,KAAK,cAAc,EAAE,KAAK,UACzD,SAAS,KACV,CAAC,eAAC,EACgB,MAAM,MAAM,sCAAsC,CAAC,CACvE;EAED,KAAK,WAAW;EAChB,KAAK,YAAY;CAClB;AACF"}
+{"version":3,"file":"errors.cjs","names":["toolNames: string[]","toolName: string","errors: string[]","toolError: unknown","toolCall: ToolCall"],"sources":["../../src/agents/errors.ts"],"sourcesContent":["/* eslint-disable no-instanceof/no-instanceof */\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\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  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"],"mappings":";;AAGA,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MACE,uKAGD;CACF;AACF;;;;AAKD,IAAa,iCAAb,cAAoD,MAAM;CACxD,AAAgB;CAEhB,YAAYA,WAAqB;EAC/B,MACE,CAAC,qCAAqC,EAAE,UAAU,KAChD,KACD,CAAC,iGAAgC,CACmC,CACtE;EACD,KAAK,YAAY;CAClB;AACF;;;;AAKD,IAAa,+BAAb,cAAkD,MAAM;CACtD,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,UAAkBC,QAAkB;EAC9C,MACE,CAAC,4CAA4C,EAAE,SAAS,EAAE,EAAE,OACzD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACxB,KAAK,GAAG,CAAC,CAAC,CAAC,CACf;EACD,KAAK,WAAW;EAChB,KAAK,SAAS;CACf;AACF;;;;AAKD,IAAa,sBAAb,cAAyC,MAAM;CAC7C,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,WAAoBC,UAAoB;EAClD,MAAM,QACJ,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,UAAU;EACtE,MAAM,WAAW,KAAK,UAAU,SAAS,KAAK;EAC9C,MACE,CAAC,qBAAqB,EAAE,SAAS,KAAK,cAAc,EAAE,SAAS,aAAa,EAAE,MAAM,MAAM,sCAAsC,CAAC,CAClI;EAED,KAAK,WAAW;EAChB,KAAK,YAAY;CAClB;AACF"}

package/dist/agents/errors.js

@@ -34,7 +34,8 @@ var ToolInvocationError = class extends Error {
 	toolError;
 	constructor(toolError, toolCall) {
 		const error = toolError instanceof Error ? toolError : new Error(String(toolError));
-		super(`Error invoking tool '${toolCall.name}' with kwargs ${JSON.stringify(toolCall.args)} with error:\n ${error.stack}\n Please fix the error and try again.`);
+		const toolArgs = JSON.stringify(toolCall.args);
+		super(`Error invoking tool '${toolCall.name}' with kwargs ${toolArgs} with error: ${error.stack}\n Please fix the error and try again.`);
 		this.toolCall = toolCall;
 		this.toolError = error;
 	}

package/dist/agents/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":["toolNames: string[]","toolName: string","errors: string[]","toolError: unknown","toolCall: ToolCall"],"sources":["../../src/agents/errors.ts"],"sourcesContent":["/* eslint-disable no-instanceof/no-instanceof */\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\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  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    super(\n      `Error invoking tool '${toolCall.name}' with kwargs ${JSON.stringify(\n        toolCall.args\n      )} ` +\n        `with error:\\n ${error.stack}\\n Please fix the error and try again.`\n    );\n\n    this.toolCall = toolCall;\n    this.toolError = error;\n  }\n}\n"],"mappings":";AAGA,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MACE,uKAGD;CACF;AACF;;;;AAKD,IAAa,iCAAb,cAAoD,MAAM;CACxD,AAAgB;CAEhB,YAAYA,WAAqB;EAC/B,MACE,CAAC,qCAAqC,EAAE,UAAU,KAChD,KACD,CAAC,iGAAgC,CACmC,CACtE;EACD,KAAK,YAAY;CAClB;AACF;;;;AAKD,IAAa,+BAAb,cAAkD,MAAM;CACtD,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,UAAkBC,QAAkB;EAC9C,MACE,CAAC,4CAA4C,EAAE,SAAS,EAAE,EAAE,OACzD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACxB,KAAK,GAAG,CAAC,CAAC,CAAC,CACf;EACD,KAAK,WAAW;EAChB,KAAK,SAAS;CACf;AACF;;;;AAKD,IAAa,sBAAb,cAAyC,MAAM;CAC7C,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,WAAoBC,UAAoB;EAClD,MAAM,QACJ,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,UAAU;EACtE,MACE,CAAC,qBAAqB,EAAE,SAAS,KAAK,cAAc,EAAE,KAAK,UACzD,SAAS,KACV,CAAC,eAAC,EACgB,MAAM,MAAM,sCAAsC,CAAC,CACvE;EAED,KAAK,WAAW;EAChB,KAAK,YAAY;CAClB;AACF"}
+{"version":3,"file":"errors.js","names":["toolNames: string[]","toolName: string","errors: string[]","toolError: unknown","toolCall: ToolCall"],"sources":["../../src/agents/errors.ts"],"sourcesContent":["/* eslint-disable no-instanceof/no-instanceof */\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\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  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"],"mappings":";AAGA,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MACE,uKAGD;CACF;AACF;;;;AAKD,IAAa,iCAAb,cAAoD,MAAM;CACxD,AAAgB;CAEhB,YAAYA,WAAqB;EAC/B,MACE,CAAC,qCAAqC,EAAE,UAAU,KAChD,KACD,CAAC,iGAAgC,CACmC,CACtE;EACD,KAAK,YAAY;CAClB;AACF;;;;AAKD,IAAa,+BAAb,cAAkD,MAAM;CACtD,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,UAAkBC,QAAkB;EAC9C,MACE,CAAC,4CAA4C,EAAE,SAAS,EAAE,EAAE,OACzD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACxB,KAAK,GAAG,CAAC,CAAC,CAAC,CACf;EACD,KAAK,WAAW;EAChB,KAAK,SAAS;CACf;AACF;;;;AAKD,IAAa,sBAAb,cAAyC,MAAM;CAC7C,AAAgB;CAEhB,AAAgB;CAEhB,YAAYC,WAAoBC,UAAoB;EAClD,MAAM,QACJ,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,UAAU;EACtE,MAAM,WAAW,KAAK,UAAU,SAAS,KAAK;EAC9C,MACE,CAAC,qBAAqB,EAAE,SAAS,KAAK,cAAc,EAAE,SAAS,aAAa,EAAE,MAAM,MAAM,sCAAsC,CAAC,CAClI;EAED,KAAK,WAAW;EAChB,KAAK,YAAY;CAClB;AACF"}

package/dist/agents/index.cjs

@@ -1,38 +1,14 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-const require_annotation = require('./annotation.cjs');
 const require_errors = require('./errors.cjs');
 const require_responses = require('./responses.cjs');
-const require_ToolNode = require('./nodes/ToolNode.cjs');
-const require_createAgent = require('./createAgent.cjs');
-const require_middleware = require('./middlewareAgent/middleware.cjs');
-const require_index = require('./middlewareAgent/index.cjs');
-const require_types = require('./types.cjs');
-require('./interrupt.cjs');
+const require_ReactAgent = require('./ReactAgent.cjs');
+const require_middleware = require('./middleware.cjs');
 const require_utils = require('./tests/utils.cjs');
-const __langchain_langgraph = require_rolldown_runtime.__toESM(require("@langchain/langgraph"));
 
 //#region src/agents/index.ts
-function createAgent$2(params) {
-	/**
-	* Check if middleware property is present
-	*/
-	if ("middleware" in params && params.middleware !== void 0) {
-		/**
-		* The user wants to use the middleware version of the agent.
-		* Let's verify that `preModelHook` and `postModelHook` are not provided
-		*/
-		if ("preModelHook" in params || "postModelHook" in params) throw new Error("The `preModelHook` and `postModelHook` parameters are not supported in the middleware version of the agent.");
-		/**
-		* Use v2 (middleware version)
-		*/
-		return require_index.createAgent(params);
-	} else
- /**
-	* Use v1 (original version)
-	*/
-	return require_createAgent.createAgent(params);
+function createAgent(params) {
+	return new require_ReactAgent.ReactAgent(params);
 }
 
 //#endregion
-exports.createAgent = createAgent$2;
+exports.createAgent = createAgent;
 //# sourceMappingURL=index.cjs.map

package/dist/agents/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createAgent","params: any","createAgentV2","createAgentV1"],"sources":["../../src/agents/index.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\nimport { MessagesAnnotation } from \"@langchain/langgraph\";\n\n// Import v1 (without middleware)\nimport { createAgent as createAgentV1 } from \"./createAgent.js\";\nimport { ReactAgent as ReactAgentV1 } from \"./ReactAgent.js\";\n\n// Import v2 (with middleware)\nimport { createAgent as createAgentV2 } from \"./middlewareAgent/index.js\";\nimport { ReactAgent as ReactAgentV2 } from \"./middlewareAgent/ReactAgent.js\";\n\nimport type {\n  AnyAnnotationRoot,\n  ResponseFormatUndefined,\n} from \"./annotation.js\";\nimport type { CreateAgentParams, ExtractZodArrayTypes } from \"./types.js\";\nimport type {\n  CreateAgentParams as CreateAgentParamsV2,\n  AgentMiddleware,\n} from \"./middlewareAgent/types.js\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  JsonSchemaFormat,\n} from \"./responses.js\";\n\n// Re-export types and utilities\nexport * from \"./types.js\";\nexport * from \"./errors.js\";\nexport * from \"./interrupt.js\";\nexport * from \"./annotation.js\";\nexport { ToolNode } from \"./nodes/ToolNode.js\";\nexport {\n  toolStrategy,\n  providerStrategy,\n  ToolStrategy,\n  ProviderStrategy,\n  type ResponseFormat,\n} from \"./responses.js\";\nexport { createMiddleware } from \"./middlewareAgent/index.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { AgentMiddleware } from \"./middlewareAgent/types.js\";\nexport type { ReactAgent } from \"./middlewareAgent/ReactAgent.js\";\n/**\n * Agents combine language models with tools to create systems that can reason\n * about tasks, decide which tools to use, and iteratively work towards solutions.\n * {@link createAgent} provides a production-ready ReAct (Reasoning + Acting)\n * agent implementation based on the paper {@link https://arxiv.org/abs/2210.03629|ReAct: Synergizing Reasoning and Acting in Language Models.}\n *\n * @example\n * ```ts\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod/v3\";\n *\n * const getWeather = tool((input) => {\n *   if ([\"sf\", \"san francisco\"].includes(input.location.toLowerCase())) {\n *     return \"It's 60 degrees and foggy.\";\n *   } else {\n *     return \"It's 90 degrees and sunny.\";\n *   }\n * }, {\n *   name: \"get_weather\",\n *   description: \"Call to get the current weather.\",\n *   schema: z.object({\n *     location: z.string().describe(\"Location to get the weather for.\"),\n *   })\n * })\n *\n * const agent = createAgent({\n *   // use chat model from \"@langchain/openai\"\n *   model: \"openai:gpt-4o-mini\",\n *   tools: [getWeather]\n * });\n *\n * const inputs = {\n *   messages: [{ role: \"user\", content: \"what is the weather in SF?\" }],\n * };\n *\n * const stream = await agent.stream(inputs, { streamMode: \"values\" });\n *\n * for await (const { messages } of stream) {\n *   console.log(messages);\n * }\n * // Returns the messages in the state at each step of execution\n * ```\n */\n\n// ===== V1 OVERLOADS (WITHOUT MIDDLEWARE) =====\n// These overloads come first to ensure proper type inference when middleware is NOT provided\n\n// Overload 1: V1 - With responseFormat as single InteropZodType\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    T,\n    ContextSchema,\n    InteropZodType<T>\n  > & {\n    responseFormat: InteropZodType<T>;\n  }\n): ReactAgentV1<StateSchema, T, ContextSchema>;\n\n// Overload 2: V1 - With responseFormat as array of InteropZodTypes\nexport function createAgent<\n  T extends readonly InteropZodType<any>[],\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    ExtractZodArrayTypes<T> extends Record<string, any>\n      ? ExtractZodArrayTypes<T>\n      : Record<string, any>,\n    ContextSchema,\n    T\n  > & {\n    responseFormat: T;\n  }\n): ReactAgentV1<\n  StateSchema,\n  ExtractZodArrayTypes<T> extends Record<string, any>\n    ? ExtractZodArrayTypes<T>\n    : Record<string, any>,\n  ContextSchema\n>;\n\n// Overload 3: V1 - With responseFormat as JsonSchemaFormat\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n  }\n): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n\n// Overload 4: V1 - With responseFormat as array of JsonSchemaFormat\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n  }\n): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n\n// Overload 5: V1 - With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n  }\n): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n\n// Overload 6: V1 - With responseFormat as TypedToolStrategy\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    T,\n    ContextSchema,\n    TypedToolStrategy<T>\n  > & {\n    responseFormat: TypedToolStrategy<T>;\n  }\n): ReactAgentV1<StateSchema, T, ContextSchema>;\n\n// Overload 7: V1 - With responseFormat as single ToolStrategy\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<StateSchema, T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n  }\n): ReactAgentV1<StateSchema, T, ContextSchema>;\n\n// Overload 8: V1 - With responseFormat as ProviderStrategy\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    T,\n    ContextSchema,\n    ProviderStrategy<T>\n  > & {\n    responseFormat: ProviderStrategy<T>;\n  }\n): ReactAgentV1<StateSchema, T, ContextSchema>;\n\n// Overload 9: V1 - Without responseFormat property at all\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: Omit<\n    CreateAgentParams<\n      StateSchema,\n      ResponseFormatUndefined,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  >\n): ReactAgentV1<StateSchema, ResponseFormatUndefined, ContextSchema>;\n\n// Overload 10: V1 - With responseFormat explicitly undefined\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: Omit<\n    CreateAgentParams<\n      StateSchema,\n      ResponseFormatUndefined,\n      ContextSchema,\n      never\n    >,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n  }\n): ReactAgentV1<StateSchema, ResponseFormatUndefined, ContextSchema>;\n\n// Overload 11: V1 - For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StateSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = typeof MessagesAnnotation,\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateAgentParams<\n    StateSchema,\n    StructuredResponseFormat,\n    ContextSchema,\n    any\n  > & {\n    responseFormat: any;\n  }\n): ReactAgentV1<StateSchema, StructuredResponseFormat, ContextSchema>;\n\n// ===== V2 OVERLOADS (WITH MIDDLEWARE) =====\n// These overloads explicitly require the middleware property\n\n// Overload 12: With responseFormat as single InteropZodType and middleware\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<T, ContextSchema, TMiddleware>;\n\n// Overload 13: With responseFormat as array of InteropZodTypes and middleware\nexport function createAgent<\n  T extends readonly InteropZodType<any>[],\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<\n    ExtractZodArrayTypes<T> extends Record<string, any>\n      ? ExtractZodArrayTypes<T>\n      : Record<string, any>,\n    ContextSchema,\n    T\n  > & {\n    responseFormat: T;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<\n  ExtractZodArrayTypes<T> extends Record<string, any>\n    ? ExtractZodArrayTypes<T>\n    : Record<string, any>,\n  ContextSchema,\n  TMiddleware\n>;\n\n// Overload 14: With responseFormat as JsonSchemaFormat and middleware\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 15: With responseFormat as array of JsonSchemaFormat and middleware\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 16: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[] and middleware\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 17: With responseFormat as TypedToolStrategy and middleware\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<T, ContextSchema, TMiddleware>;\n\n// Overload 18: With responseFormat as single ToolStrategy and middleware\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<T, ContextSchema, TMiddleware>;\n\n// Overload 19: With responseFormat as ProviderStrategy and middleware\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<T, ContextSchema, TMiddleware>;\n\n// Overload 20: Without responseFormat but with middleware\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParamsV2<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & { middleware: TMiddleware }\n): ReactAgentV2<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 21: With responseFormat explicitly undefined and middleware\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParamsV2<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 22: For other ResponseFormat values with middleware (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParamsV2<StructuredResponseFormat, ContextSchema, any> & {\n    responseFormat: any;\n    middleware: TMiddleware;\n  }\n): ReactAgentV2<StructuredResponseFormat, ContextSchema, TMiddleware>;\n\nexport function createAgent(params: any): any {\n  /**\n   * Check if middleware property is present\n   */\n  if (\"middleware\" in params && params.middleware !== undefined) {\n    /**\n     * The user wants to use the middleware version of the agent.\n     * Let's verify that `preModelHook` and `postModelHook` are not provided\n     */\n    if (\"preModelHook\" in params || \"postModelHook\" in params) {\n      throw new Error(\n        \"The `preModelHook` and `postModelHook` parameters are not supported in the middleware version of the agent.\"\n      );\n    }\n\n    /**\n     * Use v2 (middleware version)\n     */\n    return createAgentV2(params);\n  } else {\n    /**\n     * Use v1 (original version)\n     */\n    return createAgentV1(params);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAsgBA,SAAgBA,cAAYC,QAAkB;;;;AAI5C,KAAI,gBAAgB,UAAU,OAAO,eAAe,QAAW;;;;;AAK7D,MAAI,kBAAkB,UAAU,mBAAmB,OACjD,OAAM,IAAI,MACR;;;;AAOJ,SAAOC,0BAAc,OAAO;CAC7B;;;;AAIC,QAAOC,gCAAc,OAAO;AAE/B"}
+{"version":3,"file":"index.cjs","names":["params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>","ReactAgent"],"sources":["../../src/agents/index.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\n\nimport type { ResponseFormatUndefined } from \"./responses.js\";\nimport type { CreateAgentParams } from \"./types.js\";\nimport type { AgentMiddleware, AnyAnnotationRoot } from \"./middleware/types.js\";\nimport type { ExtractZodArrayTypes } from \"./types.js\";\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// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  T extends readonly InteropZodType<any>[],\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<T> extends Record<string, any>\n      ? ExtractZodArrayTypes<T>\n      : Record<string, any>,\n    ContextSchema,\n    T\n  > & {\n    responseFormat: T;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<\n  ExtractZodArrayTypes<T> extends Record<string, any>\n    ? ExtractZodArrayTypes<T>\n    : Record<string, any>,\n  ContextSchema,\n  TMiddleware\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 6: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 7: With responseFormat as ProviderStrategy\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 8: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & { middleware?: TMiddleware }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 9: With responseFormat explicitly undefined\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 10: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddleware extends readonly AgentMiddleware[] = []\n>(\n  params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware> {\n  return new ReactAgent(params);\n}\n\n// Re-export types and utilities\nexport * from \"./types.js\";\nexport * from \"./errors.js\";\nexport type { JumpToTarget } from \"./constants.js\";\nexport type { Runtime } from \"./runtime.js\";\nexport {\n  toolStrategy,\n  providerStrategy,\n  ToolStrategy,\n  ProviderStrategy,\n  type ResponseFormat,\n  type ResponseFormatUndefined,\n} from \"./responses.js\";\nexport { createMiddleware } from \"./middleware.js\";\nexport type {\n  ToolCallRequest,\n  ToolCallHandler,\n  ToolCallWrapper,\n} from \"./middleware/types.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { ReactAgent } from \"./ReactAgent.js\";\n"],"mappings":";;;;;;;AA+TA,SAAgB,YAKdA,QACkE;AAClE,QAAO,IAAIC,8BAAW;AACvB"}

package/dist/agents/index.d.cts

@@ -1,162 +1,191 @@
-import { AnyAnnotationRoot, PreHookAnnotation, ReactAgentAnnotation, ResponseFormatUndefined, ToAnnotationRoot, createAgentAnnotation, createAgentAnnotationConditional, createAgentBaseAnnotation, enhanceStateSchemaWithMessageReducer } from "./annotation.cjs";
 import { MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError } from "./errors.cjs";
-import { JsonSchemaFormat, ProviderStrategy, ResponseFormat, ToolStrategy, TypedToolStrategy, providerStrategy, toolStrategy } from "./responses.cjs";
-import { ToolNode } from "./nodes/ToolNode.cjs";
-import { AgentRuntime, AgentState, ClientTool, CreateAgentParams, ExecutedToolCall, ExtractZodArrayTypes, ExtractZodType, InferResponseFormatType, InternalAgentState, META_EXTRAS_DESCRIPTION_PREFIX, N, Prompt, ReducedZodChannel, ServerTool, WithStateGraphNodes } from "./types.cjs";
-import { AgentMiddleware, CreateAgentParams as CreateAgentParams$1 } from "./middlewareAgent/types.cjs";
-import { createMiddleware } from "./middlewareAgent/middleware.cjs";
+import { JsonSchemaFormat, ProviderStrategy, ResponseFormat, ResponseFormatUndefined, ToolStrategy, TypedToolStrategy, providerStrategy, toolStrategy } from "./responses.cjs";
+import { JumpToTarget } from "./constants.cjs";
+import { Runtime } from "./runtime.cjs";
+import { AgentMiddleware, AnyAnnotationRoot, ToolCallHandler, ToolCallRequest, ToolCallWrapper } from "./middleware/types.cjs";
+import { BuiltInState, CreateAgentParams, ExecutedToolCall, ExtractZodArrayTypes, Interrupt, JumpTo, N, ToolCall, ToolResult, UserInput, WithStateGraphNodes } from "./types.cjs";
 import { ReactAgent } from "./ReactAgent.cjs";
-import { ReactAgent as ReactAgent$1 } from "./middlewareAgent/ReactAgent.cjs";
-import { HumanInterrupt, HumanInterruptConfig, HumanResponse, Interrupt, interrupt } from "./interrupt.cjs";
+import { createMiddleware } from "./middleware.cjs";
 import { FakeToolCallingModel } from "./tests/utils.cjs";
 import { InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
-import { MessagesAnnotation } from "@langchain/langgraph";
 
 //#region src/agents/index.d.ts
 
 /**
- * Agents combine language models with tools to create systems that can reason
- * about tasks, decide which tools to use, and iteratively work towards solutions.
- * {@link createAgent} provides a production-ready ReAct (Reasoning + Acting)
- * agent implementation based on the paper {@link https://arxiv.org/abs/2210.03629|ReAct: Synergizing Reasoning and Acting in Language Models.}
+ * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools
+ * and middleware to create systems that can reason about tasks, decide which tools to use, and iteratively
+ * work towards solutions.
  *
- * @example
+ * The agent follows the ReAct pattern, interleaving reasoning steps with tool calls to iteratively
+ * work towards solutions. It can handle multiple tool calls in sequence or parallel, maintain state
+ * across interactions, and provide auditable decision processes.
+ *
+ * ## Core Components
+ *
+ * ### Model
+ * The reasoning engine can be specified as:
+ * - **String identifier**: `"openai:gpt-4o"` for simple setup
+ * - **Model instance**: Configured model object for full control
+ * - **Dynamic function**: Select models at runtime based on state
+ *
+ * ### Tools
+ * Tools give agents the ability to take actions:
+ * - Pass an array of tools created with the `tool` function
+ * - Or provide a configured `ToolNode` for custom error handling
+ *
+ * ### Prompt
+ * Shape how your agent approaches tasks:
+ * - String for simple instructions
+ * - SystemMessage for structured prompts
+ * - Function for dynamic prompts based on state
+ *
+ * ### Middleware
+ * Middleware allows you to extend the agent's behavior:
+ * - Add pre/post-model processing for context injection or validation
+ * - Add dynamic control flows, e.g. terminate invocation or retries
+ * - Add human-in-the-loop capabilities
+ * - Add tool calls to the agent
+ * - Add tool results to the agent
+ *
+ * ## Advanced Features
+ *
+ * - **Structured Output**: Use `responseFormat` with a Zod schema to get typed responses
+ * - **Memory**: Extend the state schema to remember information across interactions
+ * - **Streaming**: Get real-time updates as the agent processes
+ *
+ * @param options - Configuration options for the agent
+ * @param options.llm - The language model as an instance of a chat model
+ * @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}.
+ * @param options.tools - Array of tools or configured ToolNode
+ * @param options.prompt - System instructions (string, SystemMessage, or function)
+ * @param options.responseFormat - Zod schema for structured output
+ * @param options.stateSchema - Custom state schema for memory
+ * @param options.middleware - Array of middleware for extending agent behavior, see more in {@link https://docs.langchain.com/oss/javascript/langchain/middleware | Middleware}.
+ *
+ * @returns A ReactAgent instance with `invoke` and `stream` methods
+ *
+ * @example Basic agent with tools
  * ```ts
  * import { createAgent, tool } from "langchain";
- * import { z } from "zod/v3";
+ * import { z } from "zod";
  *
- * const getWeather = tool((input) => {
- *   if (["sf", "san francisco"].includes(input.location.toLowerCase())) {
- *     return "It's 60 degrees and foggy.";
- *   } else {
- *     return "It's 90 degrees and sunny.";
+ * const search = tool(
+ *   ({ query }) => `Results for: ${query}`,
+ *   {
+ *     name: "search",
+ *     description: "Search for information",
+ *     schema: z.object({
+ *       query: z.string().describe("The search query"),
+ *     })
  *   }
- * }, {
- *   name: "get_weather",
- *   description: "Call to get the current weather.",
- *   schema: z.object({
- *     location: z.string().describe("Location to get the weather for."),
- *   })
- * })
+ * );
+ *
+ * const agent = createAgent({
+ *   llm: "openai:gpt-4o",
+ *   tools: [search],
+ * });
+ *
+ * const result = await agent.invoke({
+ *   messages: [{ role: "user", content: "Search for ReAct agents" }],
+ * });
+ * ```
+ *
+ * @example Structured output
+ * ```ts
+ * import { createAgent } from "langchain";
+ * import { z } from "zod";
+ *
+ * const ContactInfo = z.object({
+ *   name: z.string(),
+ *   email: z.string(),
+ *   phone: z.string(),
+ * });
  *
  * const agent = createAgent({
- *   // use chat model from "@langchain/openai"
- *   model: "openai:gpt-4o-mini",
- *   tools: [getWeather]
+ *   llm: "openai:gpt-4o",
+ *   tools: [],
+ *   responseFormat: ContactInfo,
  * });
  *
- * const inputs = {
- *   messages: [{ role: "user", content: "what is the weather in SF?" }],
- * };
+ * const result = await agent.invoke({
+ *   messages: [{
+ *     role: "user",
+ *     content: "Extract: John Doe, john@example.com, (555) 123-4567"
+ *   }],
+ * });
  *
- * const stream = await agent.stream(inputs, { streamMode: "values" });
+ * console.log(result.structuredResponse);
+ * // { name: 'John Doe', email: 'john@example.com', phone: '(555) 123-4567' }
+ * ```
  *
- * for await (const { messages } of stream) {
- *   console.log(messages);
+ * @example Streaming responses
+ * ```ts
+ * const stream = await agent.stream(
+ *   { messages: [{ role: "user", content: "What's the weather?" }] },
+ *   { streamMode: "values" }
+ * );
+ *
+ * for await (const chunk of stream) {
+ *   // ...
  * }
- * // Returns the messages in the state at each step of execution
  * ```
  */
-// ===== V1 OVERLOADS (WITHOUT MIDDLEWARE) =====
-// These overloads come first to ensure proper type inference when middleware is NOT provided
-// Overload 1: V1 - With responseFormat as single InteropZodType
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, T, ContextSchema, InteropZodType<T>> & {
+// Overload 1: With responseFormat as single InteropZodType
+declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<T, ContextSchema, InteropZodType<T>> & {
   responseFormat: InteropZodType<T>;
-}): ReactAgent<StateSchema, T, ContextSchema>;
-// Overload 2: V1 - With responseFormat as array of InteropZodTypes
-declare function createAgent<T extends readonly InteropZodType<any>[], StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, T> & {
+  middleware?: TMiddleware;
+}): ReactAgent<T, ContextSchema, TMiddleware>;
+// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)
+declare function createAgent<T extends readonly InteropZodType<any>[], ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, T> & {
   responseFormat: T;
-}): ReactAgent<StateSchema, ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema>;
-// Overload 3: V1 - With responseFormat as JsonSchemaFormat
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {
+  middleware?: TMiddleware;
+}): ReactAgent<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, TMiddleware>;
+// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)
+declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {
   responseFormat: JsonSchemaFormat;
-}): ReactAgent<StateSchema, Record<string, unknown>, ContextSchema>;
-// Overload 4: V1 - With responseFormat as array of JsonSchemaFormat
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {
+  middleware?: TMiddleware;
+}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;
+// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)
+declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {
   responseFormat: JsonSchemaFormat[];
-}): ReactAgent<StateSchema, Record<string, unknown>, ContextSchema>;
-// Overload 5: V1 - With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {
+  middleware?: TMiddleware;
+}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;
+// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]
+declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {
   responseFormat: JsonSchemaFormat | JsonSchemaFormat[];
-}): ReactAgent<StateSchema, Record<string, unknown>, ContextSchema>;
-// Overload 6: V1 - With responseFormat as TypedToolStrategy
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, T, ContextSchema, TypedToolStrategy<T>> & {
+  middleware?: TMiddleware;
+}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;
+// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)
+declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<T, ContextSchema, TypedToolStrategy<T>> & {
   responseFormat: TypedToolStrategy<T>;
-}): ReactAgent<StateSchema, T, ContextSchema>;
-// Overload 7: V1 - With responseFormat as single ToolStrategy
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, T, ContextSchema, ToolStrategy<T>> & {
+  middleware?: TMiddleware;
+}): ReactAgent<T, ContextSchema, TMiddleware>;
+// Overload 6: With responseFormat as single ToolStrategy instance
+declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<T, ContextSchema, ToolStrategy<T>> & {
   responseFormat: ToolStrategy<T>;
-}): ReactAgent<StateSchema, T, ContextSchema>;
-// Overload 8: V1 - With responseFormat as ProviderStrategy
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, T, ContextSchema, ProviderStrategy<T>> & {
+  middleware?: TMiddleware;
+}): ReactAgent<T, ContextSchema, TMiddleware>;
+// Overload 7: With responseFormat as ProviderStrategy
+declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<T, ContextSchema, ProviderStrategy<T>> & {
   responseFormat: ProviderStrategy<T>;
-}): ReactAgent<StateSchema, T, ContextSchema>;
-// Overload 9: V1 - Without responseFormat property at all
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: Omit<CreateAgentParams<StateSchema, ResponseFormatUndefined, ContextSchema, never>, "responseFormat">): ReactAgent<StateSchema, ResponseFormatUndefined, ContextSchema>;
-// Overload 10: V1 - With responseFormat explicitly undefined
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: Omit<CreateAgentParams<StateSchema, ResponseFormatUndefined, ContextSchema, never>, "responseFormat"> & {
+  middleware?: TMiddleware;
+}): ReactAgent<T, ContextSchema, TMiddleware>;
+// Overload 8: Without responseFormat property at all - with proper middleware state typing
+declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: Omit<CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>, "responseFormat"> & {
+  middleware?: TMiddleware;
+}): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;
+// Overload 9: With responseFormat explicitly undefined
+declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: Omit<CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>, "responseFormat"> & {
   responseFormat?: undefined;
-}): ReactAgent<StateSchema, ResponseFormatUndefined, ContextSchema>;
-// Overload 11: V1 - For other ResponseFormat values (failsafe)
-declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, StructuredResponseFormat extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, StructuredResponseFormat, ContextSchema, any> & {
-  responseFormat: any;
-}): ReactAgent<StateSchema, StructuredResponseFormat, ContextSchema>;
-// ===== V2 OVERLOADS (WITH MIDDLEWARE) =====
-// These overloads explicitly require the middleware property
-// Overload 12: With responseFormat as single InteropZodType and middleware
-declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<T, ContextSchema, InteropZodType<T>> & {
-  responseFormat: InteropZodType<T>;
-  middleware: TMiddleware;
-}): ReactAgent$1<T, ContextSchema, TMiddleware>;
-// Overload 13: With responseFormat as array of InteropZodTypes and middleware
-declare function createAgent<T extends readonly InteropZodType<any>[], ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, T> & {
-  responseFormat: T;
-  middleware: TMiddleware;
-}): ReactAgent$1<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, TMiddleware>;
-// Overload 14: With responseFormat as JsonSchemaFormat and middleware
-declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {
-  responseFormat: JsonSchemaFormat;
-  middleware: TMiddleware;
-}): ReactAgent$1<Record<string, unknown>, ContextSchema, TMiddleware>;
-// Overload 15: With responseFormat as array of JsonSchemaFormat and middleware
-declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {
-  responseFormat: JsonSchemaFormat[];
-  middleware: TMiddleware;
-}): ReactAgent$1<Record<string, unknown>, ContextSchema, TMiddleware>;
-// Overload 16: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[] and middleware
-declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {
-  responseFormat: JsonSchemaFormat | JsonSchemaFormat[];
-  middleware: TMiddleware;
-}): ReactAgent$1<Record<string, unknown>, ContextSchema, TMiddleware>;
-// Overload 17: With responseFormat as TypedToolStrategy and middleware
-declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<T, ContextSchema, TypedToolStrategy<T>> & {
-  responseFormat: TypedToolStrategy<T>;
-  middleware: TMiddleware;
-}): ReactAgent$1<T, ContextSchema, TMiddleware>;
-// Overload 18: With responseFormat as single ToolStrategy and middleware
-declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<T, ContextSchema, ToolStrategy<T>> & {
-  responseFormat: ToolStrategy<T>;
-  middleware: TMiddleware;
-}): ReactAgent$1<T, ContextSchema, TMiddleware>;
-// Overload 19: With responseFormat as ProviderStrategy and middleware
-declare function createAgent<T extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<T, ContextSchema, ProviderStrategy<T>> & {
-  responseFormat: ProviderStrategy<T>;
-  middleware: TMiddleware;
-}): ReactAgent$1<T, ContextSchema, TMiddleware>;
-// Overload 20: Without responseFormat but with middleware
-declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: Omit<CreateAgentParams$1<ResponseFormatUndefined, ContextSchema, never>, "responseFormat"> & {
-  middleware: TMiddleware;
-}): ReactAgent$1<ResponseFormatUndefined, ContextSchema, TMiddleware>;
-// Overload 21: With responseFormat explicitly undefined and middleware
-declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: Omit<CreateAgentParams$1<ResponseFormatUndefined, ContextSchema, never>, "responseFormat"> & {
-  responseFormat?: undefined;
-  middleware: TMiddleware;
-}): ReactAgent$1<ResponseFormatUndefined, ContextSchema, TMiddleware>;
-// Overload 22: For other ResponseFormat values with middleware (failsafe)
-declare function createAgent<StructuredResponseFormat extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParams$1<StructuredResponseFormat, ContextSchema, any> & {
-  responseFormat: any;
-  middleware: TMiddleware;
-}): ReactAgent$1<StructuredResponseFormat, ContextSchema, TMiddleware>;
+  middleware?: TMiddleware;
+}): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;
+// Overload 10: For other ResponseFormat values (failsafe)
+declare function createAgent<StructuredResponseFormat extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<StructuredResponseFormat, ContextSchema, ResponseFormat> & {
+  responseFormat: ResponseFormat;
+  middleware?: TMiddleware;
+}): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware>;
+// Re-export types and utilities
+
 //#endregion
 export { createAgent };
 //# sourceMappingURL=index.d.cts.map