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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":["InteropZodObject","InteropZodType","MessagesAnnotation","ReactAgent","ReactAgentV1","ReactAgentV2","AnyAnnotationRoot","ResponseFormatUndefined","CreateAgentParams","ExtractZodArrayTypes","CreateAgentParamsV2","AgentMiddleware","ToolStrategy","TypedToolStrategy","ProviderStrategy","JsonSchemaFormat","ToolNode","toolStrategy","providerStrategy","ResponseFormat","createMiddleware","FakeToolCallingModel","createAgent","Record","StateSchema","T","ContextSchema","Omit","StructuredResponseFormat","TMiddleware"],"sources":["../../src/agents/index.d.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { InteropZodObject, InteropZodType } from \"@langchain/core/utils/types\";\nimport { MessagesAnnotation } from \"@langchain/langgraph\";\nimport { ReactAgent as ReactAgentV1 } from \"./ReactAgent.js\";\nimport { ReactAgent as ReactAgentV2 } from \"./middlewareAgent/ReactAgent.js\";\nimport type { AnyAnnotationRoot, ResponseFormatUndefined } from \"./annotation.js\";\nimport type { CreateAgentParams, ExtractZodArrayTypes } from \"./types.js\";\nimport type { CreateAgentParams as CreateAgentParamsV2, AgentMiddleware } from \"./middlewareAgent/types.js\";\nimport type { ToolStrategy, TypedToolStrategy, ProviderStrategy, JsonSchemaFormat } from \"./responses.js\";\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 { toolStrategy, providerStrategy, ToolStrategy, ProviderStrategy, type ResponseFormat, } 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// ===== V1 OVERLOADS (WITHOUT MIDDLEWARE) =====\n// These overloads come first to ensure proper type inference when middleware is NOT provided\n// Overload 1: V1 - With responseFormat as single InteropZodType\nexport 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>> & {\n    responseFormat: InteropZodType<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 2: V1 - With responseFormat as array of InteropZodTypes\nexport 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> & {\n    responseFormat: T;\n}): ReactAgentV1<StateSchema, ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema>;\n// Overload 3: V1 - With responseFormat as JsonSchemaFormat\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {\n    responseFormat: JsonSchemaFormat;\n}): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n// Overload 4: V1 - With responseFormat as array of JsonSchemaFormat\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat[];\n}): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n// Overload 5: V1 - With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n}): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n// Overload 6: V1 - With responseFormat as TypedToolStrategy\nexport 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>> & {\n    responseFormat: TypedToolStrategy<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 7: V1 - With responseFormat as single ToolStrategy\nexport 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>> & {\n    responseFormat: ToolStrategy<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 8: V1 - With responseFormat as ProviderStrategy\nexport 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>> & {\n    responseFormat: ProviderStrategy<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 9: V1 - Without responseFormat property at all\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: Omit<CreateAgentParams<StateSchema, ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\">): ReactAgentV1<StateSchema, ResponseFormatUndefined, ContextSchema>;\n// Overload 10: V1 - With responseFormat explicitly undefined\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: Omit<CreateAgentParams<StateSchema, ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    responseFormat?: undefined;\n}): ReactAgentV1<StateSchema, ResponseFormatUndefined, ContextSchema>;\n// Overload 11: V1 - For other ResponseFormat values (failsafe)\nexport 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> & {\n    responseFormat: any;\n}): ReactAgentV1<StateSchema, StructuredResponseFormat, ContextSchema>;\n// ===== V2 OVERLOADS (WITH MIDDLEWARE) =====\n// These overloads explicitly require the middleware property\n// Overload 12: With responseFormat as single InteropZodType and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 13: With responseFormat as array of InteropZodTypes and middleware\nexport 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: CreateAgentParamsV2<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, T> & {\n    responseFormat: T;\n    middleware: TMiddleware;\n}): ReactAgentV2<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, TMiddleware>;\n// Overload 14: With responseFormat as JsonSchemaFormat and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParamsV2<Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {\n    responseFormat: JsonSchemaFormat;\n    middleware: TMiddleware;\n}): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 15: With responseFormat as array of JsonSchemaFormat and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParamsV2<Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat[];\n    middleware: TMiddleware;\n}): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 16: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[] and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParamsV2<Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware: TMiddleware;\n}): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 17: With responseFormat as TypedToolStrategy and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 18: With responseFormat as single ToolStrategy and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 19: With responseFormat as ProviderStrategy and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 20: Without responseFormat but with middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: Omit<CreateAgentParamsV2<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    middleware: TMiddleware;\n}): ReactAgentV2<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 21: With responseFormat explicitly undefined and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: Omit<CreateAgentParamsV2<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    responseFormat?: undefined;\n    middleware: TMiddleware;\n}): ReactAgentV2<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 22: For other ResponseFormat values with middleware (failsafe)\nexport 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: CreateAgentParamsV2<StructuredResponseFormat, ContextSchema, any> & {\n    responseFormat: any;\n    middleware: TMiddleware;\n}): ReactAgentV2<StructuredResponseFormat, ContextSchema, TMiddleware>;\n"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":["InteropZodObject","InteropZodType","ResponseFormatUndefined","CreateAgentParams","AgentMiddleware","AnyAnnotationRoot","ExtractZodArrayTypes","ToolStrategy","TypedToolStrategy","ProviderStrategy","ResponseFormat","JsonSchemaFormat","ReactAgent","createAgent","Record","T","ContextSchema","TMiddleware","Omit","StructuredResponseFormat","JumpToTarget","Runtime","toolStrategy","providerStrategy","createMiddleware","ToolCallRequest","ToolCallHandler","ToolCallWrapper","FakeToolCallingModel"],"sources":["../../src/agents/index.d.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { InteropZodObject, InteropZodType } from \"@langchain/core/utils/types\";\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 { ToolStrategy, TypedToolStrategy, ProviderStrategy, ResponseFormat, JsonSchemaFormat } from \"./responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\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 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>> & {\n    responseFormat: InteropZodType<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport 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> & {\n    responseFormat: T;\n    middleware?: TMiddleware;\n}): ReactAgent<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, TMiddleware>;\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport 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>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 6: With responseFormat as single ToolStrategy instance\nexport 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>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 7: With responseFormat as ProviderStrategy\nexport 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>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 8: Without responseFormat property at all - with proper middleware state typing\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: Omit<CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    middleware?: TMiddleware;\n}): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 9: With responseFormat explicitly undefined\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: Omit<CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n}): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 10: For other ResponseFormat values (failsafe)\nexport 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> & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n}): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware>;\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 { toolStrategy, providerStrategy, ToolStrategy, ProviderStrategy, type ResponseFormat, type ResponseFormatUndefined, } from \"./responses.js\";\nexport { createMiddleware } from \"./middleware.js\";\nexport type { ToolCallRequest, ToolCallHandler, ToolCallWrapper, } from \"./middleware/types.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { ReactAgent } from \"./ReactAgent.js\";\n"],"mappings":"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"}

package/dist/agents/index.d.ts

@@ -1,162 +1,191 @@
-import { AnyAnnotationRoot, PreHookAnnotation, ReactAgentAnnotation, ResponseFormatUndefined, ToAnnotationRoot, createAgentAnnotation, createAgentAnnotationConditional, createAgentBaseAnnotation, enhanceStateSchemaWithMessageReducer } from "./annotation.js";
 import { MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError } from "./errors.js";
-import { JsonSchemaFormat, ProviderStrategy, ResponseFormat, ToolStrategy, TypedToolStrategy, providerStrategy, toolStrategy } from "./responses.js";
-import { ToolNode } from "./nodes/ToolNode.js";
-import { AgentRuntime, AgentState, ClientTool, CreateAgentParams, ExecutedToolCall, ExtractZodArrayTypes, ExtractZodType, InferResponseFormatType, InternalAgentState, META_EXTRAS_DESCRIPTION_PREFIX, N, Prompt, ReducedZodChannel, ServerTool, WithStateGraphNodes } from "./types.js";
-import { AgentMiddleware, CreateAgentParams as CreateAgentParams$1 } from "./middlewareAgent/types.js";
-import { createMiddleware } from "./middlewareAgent/middleware.js";
+import { JsonSchemaFormat, ProviderStrategy, ResponseFormat, ResponseFormatUndefined, ToolStrategy, TypedToolStrategy, providerStrategy, toolStrategy } from "./responses.js";
+import { JumpToTarget } from "./constants.js";
+import { Runtime } from "./runtime.js";
+import { AgentMiddleware, AnyAnnotationRoot, ToolCallHandler, ToolCallRequest, ToolCallWrapper } from "./middleware/types.js";
+import { BuiltInState, CreateAgentParams, ExecutedToolCall, ExtractZodArrayTypes, Interrupt, JumpTo, N, ToolCall, ToolResult, UserInput, WithStateGraphNodes } from "./types.js";
 import { ReactAgent } from "./ReactAgent.js";
-import { ReactAgent as ReactAgent$1 } from "./middlewareAgent/ReactAgent.js";
-import { HumanInterrupt, HumanInterruptConfig, HumanResponse, Interrupt, interrupt } from "./interrupt.js";
+import { createMiddleware } from "./middleware.js";
 import { FakeToolCallingModel } from "./tests/utils.js";
-import { MessagesAnnotation } from "@langchain/langgraph";
 import { InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
 
 //#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.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["InteropZodObject","InteropZodType","MessagesAnnotation","ReactAgent","ReactAgentV1","ReactAgentV2","AnyAnnotationRoot","ResponseFormatUndefined","CreateAgentParams","ExtractZodArrayTypes","CreateAgentParamsV2","AgentMiddleware","ToolStrategy","TypedToolStrategy","ProviderStrategy","JsonSchemaFormat","ToolNode","toolStrategy","providerStrategy","ResponseFormat","createMiddleware","FakeToolCallingModel","createAgent","Record","StateSchema","T","ContextSchema","Omit","StructuredResponseFormat","TMiddleware"],"sources":["../../src/agents/index.d.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { InteropZodObject, InteropZodType } from \"@langchain/core/utils/types\";\nimport { MessagesAnnotation } from \"@langchain/langgraph\";\nimport { ReactAgent as ReactAgentV1 } from \"./ReactAgent.js\";\nimport { ReactAgent as ReactAgentV2 } from \"./middlewareAgent/ReactAgent.js\";\nimport type { AnyAnnotationRoot, ResponseFormatUndefined } from \"./annotation.js\";\nimport type { CreateAgentParams, ExtractZodArrayTypes } from \"./types.js\";\nimport type { CreateAgentParams as CreateAgentParamsV2, AgentMiddleware } from \"./middlewareAgent/types.js\";\nimport type { ToolStrategy, TypedToolStrategy, ProviderStrategy, JsonSchemaFormat } from \"./responses.js\";\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 { toolStrategy, providerStrategy, ToolStrategy, ProviderStrategy, type ResponseFormat, } 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// ===== V1 OVERLOADS (WITHOUT MIDDLEWARE) =====\n// These overloads come first to ensure proper type inference when middleware is NOT provided\n// Overload 1: V1 - With responseFormat as single InteropZodType\nexport 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>> & {\n    responseFormat: InteropZodType<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 2: V1 - With responseFormat as array of InteropZodTypes\nexport 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> & {\n    responseFormat: T;\n}): ReactAgentV1<StateSchema, ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema>;\n// Overload 3: V1 - With responseFormat as JsonSchemaFormat\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {\n    responseFormat: JsonSchemaFormat;\n}): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n// Overload 4: V1 - With responseFormat as array of JsonSchemaFormat\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat[];\n}): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n// Overload 5: V1 - With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: CreateAgentParams<StateSchema, Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n}): ReactAgentV1<StateSchema, Record<string, unknown>, ContextSchema>;\n// Overload 6: V1 - With responseFormat as TypedToolStrategy\nexport 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>> & {\n    responseFormat: TypedToolStrategy<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 7: V1 - With responseFormat as single ToolStrategy\nexport 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>> & {\n    responseFormat: ToolStrategy<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 8: V1 - With responseFormat as ProviderStrategy\nexport 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>> & {\n    responseFormat: ProviderStrategy<T>;\n}): ReactAgentV1<StateSchema, T, ContextSchema>;\n// Overload 9: V1 - Without responseFormat property at all\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: Omit<CreateAgentParams<StateSchema, ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\">): ReactAgentV1<StateSchema, ResponseFormatUndefined, ContextSchema>;\n// Overload 10: V1 - With responseFormat explicitly undefined\nexport declare function createAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot>(params: Omit<CreateAgentParams<StateSchema, ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    responseFormat?: undefined;\n}): ReactAgentV1<StateSchema, ResponseFormatUndefined, ContextSchema>;\n// Overload 11: V1 - For other ResponseFormat values (failsafe)\nexport 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> & {\n    responseFormat: any;\n}): ReactAgentV1<StateSchema, StructuredResponseFormat, ContextSchema>;\n// ===== V2 OVERLOADS (WITH MIDDLEWARE) =====\n// These overloads explicitly require the middleware property\n// Overload 12: With responseFormat as single InteropZodType and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 13: With responseFormat as array of InteropZodTypes and middleware\nexport 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: CreateAgentParamsV2<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, T> & {\n    responseFormat: T;\n    middleware: TMiddleware;\n}): ReactAgentV2<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, TMiddleware>;\n// Overload 14: With responseFormat as JsonSchemaFormat and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParamsV2<Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {\n    responseFormat: JsonSchemaFormat;\n    middleware: TMiddleware;\n}): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 15: With responseFormat as array of JsonSchemaFormat and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParamsV2<Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat[];\n    middleware: TMiddleware;\n}): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 16: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[] and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: CreateAgentParamsV2<Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware: TMiddleware;\n}): ReactAgentV2<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 17: With responseFormat as TypedToolStrategy and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 18: With responseFormat as single ToolStrategy and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 19: With responseFormat as ProviderStrategy and middleware\nexport 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: CreateAgentParamsV2<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware: TMiddleware;\n}): ReactAgentV2<T, ContextSchema, TMiddleware>;\n// Overload 20: Without responseFormat but with middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: Omit<CreateAgentParamsV2<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    middleware: TMiddleware;\n}): ReactAgentV2<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 21: With responseFormat explicitly undefined and middleware\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware<any, any, any>[] = readonly AgentMiddleware<any, any, any>[]>(params: Omit<CreateAgentParamsV2<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    responseFormat?: undefined;\n    middleware: TMiddleware;\n}): ReactAgentV2<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 22: For other ResponseFormat values with middleware (failsafe)\nexport 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: CreateAgentParamsV2<StructuredResponseFormat, ContextSchema, any> & {\n    responseFormat: any;\n    middleware: TMiddleware;\n}): ReactAgentV2<StructuredResponseFormat, ContextSchema, TMiddleware>;\n"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["InteropZodObject","InteropZodType","ResponseFormatUndefined","CreateAgentParams","AgentMiddleware","AnyAnnotationRoot","ExtractZodArrayTypes","ToolStrategy","TypedToolStrategy","ProviderStrategy","ResponseFormat","JsonSchemaFormat","ReactAgent","createAgent","Record","T","ContextSchema","TMiddleware","Omit","StructuredResponseFormat","JumpToTarget","Runtime","toolStrategy","providerStrategy","createMiddleware","ToolCallRequest","ToolCallHandler","ToolCallWrapper","FakeToolCallingModel"],"sources":["../../src/agents/index.d.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { InteropZodObject, InteropZodType } from \"@langchain/core/utils/types\";\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 { ToolStrategy, TypedToolStrategy, ProviderStrategy, ResponseFormat, JsonSchemaFormat } from \"./responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\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 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>> & {\n    responseFormat: InteropZodType<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport 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> & {\n    responseFormat: T;\n    middleware?: TMiddleware;\n}): ReactAgent<ExtractZodArrayTypes<T> extends Record<string, any> ? ExtractZodArrayTypes<T> : Record<string, any>, ContextSchema, TMiddleware>;\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat> & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: CreateAgentParams<Record<string, unknown>, ContextSchema, JsonSchemaFormat | JsonSchemaFormat[]> & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n}): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport 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>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 6: With responseFormat as single ToolStrategy instance\nexport 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>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 7: With responseFormat as ProviderStrategy\nexport 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>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware?: TMiddleware;\n}): ReactAgent<T, ContextSchema, TMiddleware>;\n// Overload 8: Without responseFormat property at all - with proper middleware state typing\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: Omit<CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    middleware?: TMiddleware;\n}): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 9: With responseFormat explicitly undefined\nexport declare function createAgent<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[]>(params: Omit<CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>, \"responseFormat\"> & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n}): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n// Overload 10: For other ResponseFormat values (failsafe)\nexport 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> & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n}): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware>;\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 { toolStrategy, providerStrategy, ToolStrategy, ProviderStrategy, type ResponseFormat, type ResponseFormatUndefined, } from \"./responses.js\";\nexport { createMiddleware } from \"./middleware.js\";\nexport type { ToolCallRequest, ToolCallHandler, ToolCallWrapper, } from \"./middleware/types.js\";\nexport { FakeToolCallingModel } from \"./tests/utils.js\";\nexport type { ReactAgent } from \"./ReactAgent.js\";\n"],"mappings":"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"}

package/dist/agents/index.js

@@ -1,36 +1,14 @@
-import { PreHookAnnotation, createAgentAnnotation, createAgentAnnotationConditional, createAgentBaseAnnotation, enhanceStateSchemaWithMessageReducer } from "./annotation.js";
 import { MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError } from "./errors.js";
 import { ProviderStrategy, ToolStrategy, providerStrategy, toolStrategy } from "./responses.js";
-import { ToolNode } from "./nodes/ToolNode.js";
-import { createAgent } from "./createAgent.js";
-import { createMiddleware } from "./middlewareAgent/middleware.js";
-import { createAgent as createAgent$1 } from "./middlewareAgent/index.js";
-import { META_EXTRAS_DESCRIPTION_PREFIX } from "./types.js";
-import { interrupt } from "./interrupt.js";
+import { ReactAgent } from "./ReactAgent.js";
+import { createMiddleware } from "./middleware.js";
 import { FakeToolCallingModel } from "./tests/utils.js";
 
 //#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 createAgent$1(params);
-	} else
- /**
-	* Use v1 (original version)
-	*/
-	return createAgent(params);
+function createAgent(params) {
+	return new ReactAgent(params);
 }
 
 //#endregion
-export { createAgent$2 as createAgent };
+export { createAgent };
 //# sourceMappingURL=index.js.map