langchain 1.0.0-alpha.7 → 1.0.0-alpha.8

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","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 { 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 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":";;;;;;;;;AAogBA,SAAgBA,cAAYC,QAAkB;;;;AAI5C,KAAI,gBAAgB,UAAU,OAAO,eAAe,QAAW;;;;;AAK7D,MAAI,kBAAkB,UAAU,mBAAmB,OACjD,OAAM,IAAI,MACR;;;;AAOJ,SAAOC,cAAc,OAAO;CAC7B;;;;AAIC,QAAOC,YAAc,OAAO;AAE/B"}
+{"version":3,"file":"index.js","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,cAAc,OAAO;CAC7B;;;;AAIC,QAAOC,YAAc,OAAO;AAE/B"}

package/dist/agents/interrupt.d.cts

@@ -1,4 +1,8 @@
+import { ActionRequest } from "./middlewareAgent/middleware/hitl.cjs";
+import { interrupt } from "@langchain/langgraph";
+
 //#region src/agents/interrupt.d.ts
+
 /**
  * Represents information about an interrupt.
  */
@@ -34,21 +38,6 @@ interface HumanInterruptConfig {
    */
   allow_accept: boolean;
 }
-/**
- * Represents a request for human action within the graph execution.
- * Contains the action type and any associated arguments needed for the action.
- */
-interface ActionRequest {
-  /**
-   * The type or name of action being requested (e.g., "Approve XYZ action")
-   */
-  action: string;
-  /**
-   * Key-value pairs of arguments needed for the action
-   */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  args: Record<string, any>;
-}
 /**
  * Represents an interrupt triggered by the graph that requires human intervention.
  * This is passed to the `interrupt` function when execution is paused for human input.
@@ -88,5 +77,5 @@ type HumanResponse = {
   args: null | string | ActionRequest;
 };
 //#endregion
-export { ActionRequest, HumanInterrupt, HumanInterruptConfig, HumanResponse, Interrupt };
+export { HumanInterrupt, HumanInterruptConfig, HumanResponse, Interrupt, interrupt };
 //# sourceMappingURL=interrupt.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"interrupt.d.cts","names":["interrupt","Interrupt","TValue","HumanInterruptConfig","ActionRequest","Record","HumanInterrupt","HumanResponse"],"sources":["../../src/agents/interrupt.d.ts"],"sourcesContent":["export { interrupt } from \"@langchain/langgraph\";\n/**\n * Represents information about an interrupt.\n */\nexport interface Interrupt<TValue = unknown> {\n    /**\n     * The ID of the interrupt.\n     */\n    id: string;\n    /**\n     * The requests for human input.\n     */\n    value: TValue;\n}\n/**\n * Configuration interface that defines what actions are allowed for a human interrupt.\n * This controls the available interaction options when the graph is paused for human input.\n */\nexport interface HumanInterruptConfig {\n    /**\n     * Whether the human can choose to ignore/skip the current step\n     */\n    allow_ignore: boolean;\n    /**\n     * Whether the human can provide a text response/feedback\n     */\n    allow_respond: boolean;\n    /**\n     * Whether the human can edit the provided content/state\n     */\n    allow_edit: boolean;\n    /**\n     * Whether the human can accept/approve the current state\n     */\n    allow_accept: boolean;\n}\n/**\n * Represents a request for human action within the graph execution.\n * Contains the action type and any associated arguments needed for the action.\n */\nexport interface ActionRequest {\n    /**\n     * The type or name of action being requested (e.g., \"Approve XYZ action\")\n     */\n    action: string;\n    /**\n     * Key-value pairs of arguments needed for the action\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    args: Record<string, any>;\n}\n/**\n * Represents an interrupt triggered by the graph that requires human intervention.\n * This is passed to the `interrupt` function when execution is paused for human input.\n */\nexport interface HumanInterrupt {\n    /**\n     * The specific action being requested from the human\n     */\n    action_request: ActionRequest;\n    /**\n     * Configuration defining what actions are allowed\n     */\n    config: HumanInterruptConfig;\n    /**\n     * Optional detailed description of what input is needed\n     */\n    description?: string;\n}\n/**\n * The response provided by a human to an interrupt, which is returned when graph execution resumes.\n */\nexport type HumanResponse = {\n    /**\n     * The type of response:\n     * - \"accept\": Approves the current state without changes\n     * - \"ignore\": Skips/ignores the current step\n     * - \"response\": Provides text feedback or instructions\n     * - \"edit\": Modifies the current state/content\n     */\n    type: \"accept\" | \"ignore\" | \"response\" | \"edit\";\n    /**\n     * The response payload:\n     * - null: For ignore/accept actions\n     * - string: For text responses\n     * - ActionRequest: For edit actions with updated content\n     */\n    args: null | string | ActionRequest;\n};\n"],"mappings":";AAIA;AAcA;AAsBA;AAeiBM,UAnDAL,SAmDc,CAAA,SAAA,OAAA,CAAA,CAAA;EAAA;;;EAQC,EAAA,EAAA,MAAA;EASpBM;;;SA5DDL;;;;;;UAMMC,oBAAAA;;;;;;;;;;;;;;;;;;;;;;UAsBAC,aAAAA;;;;;;;;;QASPC;;;;;;UAMOC,cAAAA;;;;kBAIGF;;;;UAIRD;;;;;;;;;KASAI,aAAAA;;;;;;;;;;;;;;;wBAecH"}
+{"version":3,"file":"interrupt.d.cts","names":["interrupt","ActionRequest","Interrupt","TValue","HumanInterruptConfig","HumanInterrupt","HumanResponse"],"sources":["../../src/agents/interrupt.d.ts"],"sourcesContent":["export { interrupt } from \"@langchain/langgraph\";\nimport type { ActionRequest } from \"./middlewareAgent/middleware/hitl.js\";\n/**\n * Represents information about an interrupt.\n */\nexport interface Interrupt<TValue = unknown> {\n    /**\n     * The ID of the interrupt.\n     */\n    id: string;\n    /**\n     * The requests for human input.\n     */\n    value: TValue;\n}\n/**\n * Configuration interface that defines what actions are allowed for a human interrupt.\n * This controls the available interaction options when the graph is paused for human input.\n */\nexport interface HumanInterruptConfig {\n    /**\n     * Whether the human can choose to ignore/skip the current step\n     */\n    allow_ignore: boolean;\n    /**\n     * Whether the human can provide a text response/feedback\n     */\n    allow_respond: boolean;\n    /**\n     * Whether the human can edit the provided content/state\n     */\n    allow_edit: boolean;\n    /**\n     * Whether the human can accept/approve the current state\n     */\n    allow_accept: boolean;\n}\n/**\n * Represents an interrupt triggered by the graph that requires human intervention.\n * This is passed to the `interrupt` function when execution is paused for human input.\n */\nexport interface HumanInterrupt {\n    /**\n     * The specific action being requested from the human\n     */\n    action_request: ActionRequest;\n    /**\n     * Configuration defining what actions are allowed\n     */\n    config: HumanInterruptConfig;\n    /**\n     * Optional detailed description of what input is needed\n     */\n    description?: string;\n}\n/**\n * The response provided by a human to an interrupt, which is returned when graph execution resumes.\n */\nexport type HumanResponse = {\n    /**\n     * The type of response:\n     * - \"accept\": Approves the current state without changes\n     * - \"ignore\": Skips/ignores the current step\n     * - \"response\": Provides text feedback or instructions\n     * - \"edit\": Modifies the current state/content\n     */\n    type: \"accept\" | \"ignore\" | \"response\" | \"edit\";\n    /**\n     * The response payload:\n     * - null: For ignore/accept actions\n     * - string: For text responses\n     * - ActionRequest: For edit actions with updated content\n     */\n    args: null | string | ActionRequest;\n};\n"],"mappings":";;;;;;;AAKA;AAciBI,UAdAF,SAcAE,CAAoB,SAAA,OAAA,CAAA,CAAA;EAsBpBC;;;EAIgB,EAAA,EAIrBD,MAAAA;EAAoB;AAShC;;SA7CWD;;;;;;UAMMC,oBAAAA;;;;;;;;;;;;;;;;;;;;;;UAsBAC,cAAAA;;;;kBAIGJ;;;;UAIRG;;;;;;;;;KASAE,aAAAA;;;;;;;;;;;;;;;wBAecL"}

package/dist/agents/interrupt.d.ts

@@ -1,4 +1,5 @@
-import "@langchain/langgraph";
+import { ActionRequest } from "./middlewareAgent/middleware/hitl.js";
+import { interrupt as interrupt$1 } from "@langchain/langgraph";
 
 //#region src/agents/interrupt.d.ts
 
@@ -37,21 +38,6 @@ interface HumanInterruptConfig {
    */
   allow_accept: boolean;
 }
-/**
- * Represents a request for human action within the graph execution.
- * Contains the action type and any associated arguments needed for the action.
- */
-interface ActionRequest {
-  /**
-   * The type or name of action being requested (e.g., "Approve XYZ action")
-   */
-  action: string;
-  /**
-   * Key-value pairs of arguments needed for the action
-   */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  args: Record<string, any>;
-}
 /**
  * Represents an interrupt triggered by the graph that requires human intervention.
  * This is passed to the `interrupt` function when execution is paused for human input.
@@ -91,5 +77,5 @@ type HumanResponse = {
   args: null | string | ActionRequest;
 };
 //#endregion
-export { ActionRequest, HumanInterrupt, HumanInterruptConfig, HumanResponse, Interrupt };
+export { HumanInterrupt, HumanInterruptConfig, HumanResponse, Interrupt, interrupt$1 as interrupt };
 //# sourceMappingURL=interrupt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"interrupt.d.ts","names":["interrupt","Interrupt","TValue","HumanInterruptConfig","ActionRequest","Record","HumanInterrupt","HumanResponse"],"sources":["../../src/agents/interrupt.d.ts"],"sourcesContent":["export { interrupt } from \"@langchain/langgraph\";\n/**\n * Represents information about an interrupt.\n */\nexport interface Interrupt<TValue = unknown> {\n    /**\n     * The ID of the interrupt.\n     */\n    id: string;\n    /**\n     * The requests for human input.\n     */\n    value: TValue;\n}\n/**\n * Configuration interface that defines what actions are allowed for a human interrupt.\n * This controls the available interaction options when the graph is paused for human input.\n */\nexport interface HumanInterruptConfig {\n    /**\n     * Whether the human can choose to ignore/skip the current step\n     */\n    allow_ignore: boolean;\n    /**\n     * Whether the human can provide a text response/feedback\n     */\n    allow_respond: boolean;\n    /**\n     * Whether the human can edit the provided content/state\n     */\n    allow_edit: boolean;\n    /**\n     * Whether the human can accept/approve the current state\n     */\n    allow_accept: boolean;\n}\n/**\n * Represents a request for human action within the graph execution.\n * Contains the action type and any associated arguments needed for the action.\n */\nexport interface ActionRequest {\n    /**\n     * The type or name of action being requested (e.g., \"Approve XYZ action\")\n     */\n    action: string;\n    /**\n     * Key-value pairs of arguments needed for the action\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    args: Record<string, any>;\n}\n/**\n * Represents an interrupt triggered by the graph that requires human intervention.\n * This is passed to the `interrupt` function when execution is paused for human input.\n */\nexport interface HumanInterrupt {\n    /**\n     * The specific action being requested from the human\n     */\n    action_request: ActionRequest;\n    /**\n     * Configuration defining what actions are allowed\n     */\n    config: HumanInterruptConfig;\n    /**\n     * Optional detailed description of what input is needed\n     */\n    description?: string;\n}\n/**\n * The response provided by a human to an interrupt, which is returned when graph execution resumes.\n */\nexport type HumanResponse = {\n    /**\n     * The type of response:\n     * - \"accept\": Approves the current state without changes\n     * - \"ignore\": Skips/ignores the current step\n     * - \"response\": Provides text feedback or instructions\n     * - \"edit\": Modifies the current state/content\n     */\n    type: \"accept\" | \"ignore\" | \"response\" | \"edit\";\n    /**\n     * The response payload:\n     * - null: For ignore/accept actions\n     * - string: For text responses\n     * - ActionRequest: For edit actions with updated content\n     */\n    args: null | string | ActionRequest;\n};\n"],"mappings":";;;;;;AAIA;AAciBG,UAdAF,SAcAE,CAAoB,SAAA,OAAA,CAAA,CAAA;EAsBpBC;AAejB;;EAA+B,EAAA,EAIXA,MAAAA;EAAa;AAID;AAShC;SA5DWF;;;;;;UAMMC,oBAAAA;;;;;;;;;;;;;;;;;;;;;;UAsBAC,aAAAA;;;;;;;;;QASPC;;;;;;UAMOC,cAAAA;;;;kBAIGF;;;;UAIRD;;;;;;;;;KASAI,aAAAA;;;;;;;;;;;;;;;wBAecH"}
+{"version":3,"file":"interrupt.d.ts","names":["interrupt","ActionRequest","Interrupt","TValue","HumanInterruptConfig","HumanInterrupt","HumanResponse"],"sources":["../../src/agents/interrupt.d.ts"],"sourcesContent":["export { interrupt } from \"@langchain/langgraph\";\nimport type { ActionRequest } from \"./middlewareAgent/middleware/hitl.js\";\n/**\n * Represents information about an interrupt.\n */\nexport interface Interrupt<TValue = unknown> {\n    /**\n     * The ID of the interrupt.\n     */\n    id: string;\n    /**\n     * The requests for human input.\n     */\n    value: TValue;\n}\n/**\n * Configuration interface that defines what actions are allowed for a human interrupt.\n * This controls the available interaction options when the graph is paused for human input.\n */\nexport interface HumanInterruptConfig {\n    /**\n     * Whether the human can choose to ignore/skip the current step\n     */\n    allow_ignore: boolean;\n    /**\n     * Whether the human can provide a text response/feedback\n     */\n    allow_respond: boolean;\n    /**\n     * Whether the human can edit the provided content/state\n     */\n    allow_edit: boolean;\n    /**\n     * Whether the human can accept/approve the current state\n     */\n    allow_accept: boolean;\n}\n/**\n * Represents an interrupt triggered by the graph that requires human intervention.\n * This is passed to the `interrupt` function when execution is paused for human input.\n */\nexport interface HumanInterrupt {\n    /**\n     * The specific action being requested from the human\n     */\n    action_request: ActionRequest;\n    /**\n     * Configuration defining what actions are allowed\n     */\n    config: HumanInterruptConfig;\n    /**\n     * Optional detailed description of what input is needed\n     */\n    description?: string;\n}\n/**\n * The response provided by a human to an interrupt, which is returned when graph execution resumes.\n */\nexport type HumanResponse = {\n    /**\n     * The type of response:\n     * - \"accept\": Approves the current state without changes\n     * - \"ignore\": Skips/ignores the current step\n     * - \"response\": Provides text feedback or instructions\n     * - \"edit\": Modifies the current state/content\n     */\n    type: \"accept\" | \"ignore\" | \"response\" | \"edit\";\n    /**\n     * The response payload:\n     * - null: For ignore/accept actions\n     * - string: For text responses\n     * - ActionRequest: For edit actions with updated content\n     */\n    args: null | string | ActionRequest;\n};\n"],"mappings":";;;;;;;AAKA;AAciBI,UAdAF,SAcAE,CAAoB,SAAA,OAAA,CAAA,CAAA;EAsBpBC;;;EAIgB,EAAA,EAIrBD,MAAAA;EAAoB;AAShC;;SA7CWD;;;;;;UAMMC,oBAAAA;;;;;;;;;;;;;;;;;;;;;;UAsBAC,cAAAA;;;;kBAIGJ;;;;UAIRG;;;;;;;;;KASAE,aAAAA;;;;;;;;;;;;;;;wBAecL"}

package/dist/agents/interrupt.js

@@ -1 +1,3 @@
-import "@langchain/langgraph";
+import { interrupt as interrupt$1 } from "@langchain/langgraph";
+
+export { interrupt$1 as interrupt };

package/dist/agents/middlewareAgent/ReactAgent.cjs

@@ -2,8 +2,8 @@ const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
 const require_utils = require('../utils.cjs');
 const require_ToolNode = require('../nodes/ToolNode.cjs');
 const require_annotation = require('./annotation.cjs');
-const require_utils$1 = require('./nodes/utils.cjs');
 const require_AgentNode = require('./nodes/AgentNode.cjs');
+const require_utils$1 = require('./nodes/utils.cjs');
 const require_BeforeModalNode = require('./nodes/BeforeModalNode.cjs');
 const require_AfterModalNode = require('./nodes/AfterModalNode.cjs');
 const __langchain_core_messages = require_rolldown_runtime.__toESM(require("@langchain/core/messages"));
@@ -13,6 +13,7 @@ const __langchain_langgraph = require_rolldown_runtime.__toESM(require("@langcha
 var ReactAgent = class {
 	#graph;
 	#toolBehaviorVersion = "v2";
+	#agentNode;
 	constructor(options) {
 		this.options = options;
 		this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;
@@ -32,6 +33,20 @@ var ReactAgent = class {
 		const beforeModelNodes = [];
 		const afterModelNodes = [];
 		const modifyModelRequestHookMiddleware = [];
+		const retryModelRequestHookMiddleware = [];
+		this.#agentNode = new require_AgentNode.AgentNode({
+			model: this.options.model,
+			systemPrompt: this.options.systemPrompt,
+			includeAgentName: this.options.includeAgentName,
+			name: this.options.name,
+			responseFormat: this.options.responseFormat,
+			middleware: this.options.middleware,
+			toolClasses,
+			shouldReturnDirect,
+			signal: this.options.signal,
+			modifyModelRequestHookMiddleware,
+			retryModelRequestHookMiddleware
+		});
 		const middlewareNames = /* @__PURE__ */ new Set();
 		const middleware = this.options.middleware ?? [];
 		for (let i = 0; i < middleware.length; i++) {
@@ -41,7 +56,7 @@ var ReactAgent = class {
 			if (middlewareNames.has(m.name)) throw new Error(`Middleware ${m.name} is defined multiple times`);
 			middlewareNames.add(m.name);
 			if (m.beforeModel) {
-				beforeModelNode = new require_BeforeModalNode.BeforeModelNode(m);
+				beforeModelNode = new require_BeforeModalNode.BeforeModelNode(m, { getPrivateState: () => this.#agentNode.getState()._privateState });
 				const name = `${m.name}.before_model`;
 				beforeModelNodes.push({
 					index: i,
@@ -51,7 +66,7 @@ var ReactAgent = class {
 				allNodeWorkflows.addNode(name, beforeModelNode, beforeModelNode.nodeOptions);
 			}
 			if (m.afterModel) {
-				afterModelNode = new require_AfterModalNode.AfterModelNode(m);
+				afterModelNode = new require_AfterModalNode.AfterModelNode(m, { getPrivateState: () => this.#agentNode.getState()._privateState });
 				const name = `${m.name}.after_model`;
 				afterModelNodes.push({
 					index: i,
@@ -64,26 +79,19 @@ var ReactAgent = class {
 				...beforeModelNode?.getState(),
 				...afterModelNode?.getState()
 			})]);
+			if (m.retryModelRequest) retryModelRequestHookMiddleware.push([m, () => ({
+				...beforeModelNode?.getState(),
+				...afterModelNode?.getState()
+			})]);
 		}
 		/**
 		* Add Nodes
 		*/
-		allNodeWorkflows.addNode("model_request", new require_AgentNode.AgentNode({
-			model: this.options.model,
-			systemPrompt: this.options.systemPrompt,
-			includeAgentName: this.options.includeAgentName,
-			name: this.options.name,
-			responseFormat: this.options.responseFormat,
-			middleware: this.options.middleware,
-			toolClasses,
-			shouldReturnDirect,
-			signal: this.options.signal,
-			modifyModelRequestHookMiddleware
-		}), require_AgentNode.AgentNode.nodeOptions);
+		allNodeWorkflows.addNode("model_request", this.#agentNode, require_AgentNode.AgentNode.nodeOptions);
 		/**
 		* add single tool node for all tools
 		*/
-		if (toolClasses.length > 0) {
+		if (toolClasses.filter(require_utils.isClientTool).length > 0) {
 			const toolNode = new require_ToolNode.ToolNode(toolClasses.filter(require_utils.isClientTool), { signal: this.options.signal });
 			allNodeWorkflows.addNode("tools", toolNode);
 		}
@@ -133,7 +141,7 @@ var ReactAgent = class {
 		/**
 		* add edges for tools node
 		*/
-		if (toolClasses.length > 0) {
+		if (toolClasses.filter(require_utils.isClientTool).length > 0) {
 			let toolReturnTarget;
 			if (beforeModelNodes.length > 0) toolReturnTarget = beforeModelNodes[0].name;
 			else toolReturnTarget = "model_request";
@@ -322,6 +330,24 @@ var ReactAgent = class {
 		return updatedState;
 	}
 	/**
+	* Populate the private state of the agent node from the previous state.
+	*/
+	async #populatePrivateState(config) {
+		/**
+		* not needed if thread_id is not provided
+		*/
+		if (!config?.configurable?.thread_id) return;
+		const prevState = await this.#graph.getState(config);
+		/**
+		* not need if state is empty
+		*/
+		if (!prevState.values._privateState) return;
+		this.#agentNode.setState({
+			structuredResponse: void 0,
+			_privateState: prevState.values._privateState
+		});
+	}
+	/**
 	* Executes the agent with the given state and returns the final state after all processing.
 	*
 	* This method runs the agent's entire workflow synchronously, including:
@@ -366,17 +392,19 @@ var ReactAgent = class {
 	*/
 	async invoke(state, config) {
 		const initializedState = await this.#initializeMiddlewareStates(state);
+		await this.#populatePrivateState(config);
 		return this.#graph.invoke(initializedState, config);
 	}
 	/**
-	* Executes the agent with streaming, returning an async iterable of events as they occur.
+	* Executes the agent with streaming, returning an async iterable of state updates as they occur.
 	*
 	* This method runs the agent's workflow similar to `invoke`, but instead of waiting for
-	* completion, it streams events in real-time. This allows you to:
+	* completion, it streams high-level state updates in real-time. This allows you to:
 	* - Display intermediate results to users as they're generated
 	* - Monitor the agent's progress through each step
-	* - Handle tool calls and results as they happen
-	* - Update UI with streaming responses from the LLM
+	* - React to state changes as nodes complete
+	*
+	* For more granular event-level streaming (like individual LLM tokens), use `streamEvents` instead.
 	*
 	* @param state - The initial state for the agent execution. Can be:
 	*   - An object containing `messages` array and any middleware-specific state properties
@@ -390,8 +418,56 @@ var ReactAgent = class {
 	* @param config.streamMode - The streaming mode for the agent execution, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/streaming#supported-stream-modes | Supported stream modes}.
 	* @param config.recursionLimit - The recursion limit for the agent execution.
 	*
-	* @returns A Promise that resolves to an IterableReadableStream of events.
-	*          Events include:
+	* @returns A Promise that resolves to an IterableReadableStream of state updates.
+	*          Each update contains the current state after a node completes.
+	*
+	* @example
+	* ```typescript
+	* const agent = new ReactAgent({
+	*   llm: myModel,
+	*   tools: [calculator, webSearch]
+	* });
+	*
+	* const stream = await agent.stream({
+	*   messages: [{ role: "human", content: "What's 2+2 and the weather in NYC?" }]
+	* });
+	*
+	* for await (const chunk of stream) {
+	*   console.log(chunk); // State update from each node
+	* }
+	* ```
+	*/
+	async stream(state, config) {
+		const initializedState = await this.#initializeMiddlewareStates(state);
+		return this.#graph.stream(initializedState, config);
+	}
+	/**
+	* Executes the agent with low-level event streaming, returning detailed events as they occur.
+	*
+	* This method provides fine-grained control over streaming, emitting events for every
+	* operation during execution. This is useful when you need to:
+	* - Stream individual LLM tokens as they're generated
+	* - Monitor detailed execution flow with timing information
+	* - Handle specific event types (model start/end, tool calls, etc.)
+	* - Debug or trace agent behavior at a granular level
+	*
+	* For simpler state-based streaming, use `stream` instead.
+	*
+	* @param state - The initial state for the agent execution. Can be:
+	*   - An object containing `messages` array and any middleware-specific state properties
+	*   - A Command object for more advanced control flow
+	*
+	* @param config - Optional runtime configuration including:
+	* @param config.context - The context for the agent execution.
+	* @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.
+	* @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.
+	* @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.
+	* @param config.recursionLimit - The recursion limit for the agent execution.
+	* @param config.streamMode - The streaming mode for the agent execution, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/streaming#supported-stream-modes | Supported stream modes}.
+	*
+	* @param streamOptions - Additional streaming options (passed to LangGraph's streamEvents).
+	*
+	* @returns An IterableReadableStream of detailed events including:
 	*          - `on_chat_model_start`: When the LLM begins processing
 	*          - `on_chat_model_stream`: Streaming tokens from the LLM
 	*          - `on_chat_model_end`: When the LLM completes
@@ -408,21 +484,26 @@ var ReactAgent = class {
 	*   tools: [calculator, webSearch]
 	* });
 	*
-	* const stream = await agent.stream({
+	* const stream = await agent.streamEvents({
 	*   messages: [{ role: "human", content: "What's 2+2 and the weather in NYC?" }]
+	* }, {
+	*   version: "v2"
 	* });
 	*
 	* for await (const event of stream) {
-	*   //
+	*   if (event.event === "on_chat_model_stream") {
+	*     process.stdout.write(event.data.chunk.content); // Stream tokens
+	*   }
 	* }
 	* ```
 	*/
-	async stream(state, config) {
+	async streamEvents(state, config, streamOptions) {
 		const initializedState = await this.#initializeMiddlewareStates(state);
+		await this.#populatePrivateState(config);
 		return this.#graph.streamEvents(initializedState, {
 			...config,
-			version: "v2"
-		});
+			version: config?.version ?? "v2"
+		}, streamOptions);
 	}
 	/**
 	* Visualize the graph as a PNG image.
@@ -455,6 +536,42 @@ var ReactAgent = class {
 		const representation = await this.#graph.getGraphAsync();
 		return representation.drawMermaid(params);
 	}
+	/**
+	* The following are internal methods to enable support for LangGraph Platform.
+	* They are not part of the createAgent public API.
+	*
+	* Note: we intentionally return as `never` to avoid type errors due to type inference.
+	*/
+	/**
+	* @internal
+	*/
+	getGraphAsync(config) {
+		return this.#graph.getGraphAsync(config);
+	}
+	/**
+	* @internal
+	*/
+	getState(config, options) {
+		return this.#graph.getState(config, options);
+	}
+	/**
+	* @internal
+	*/
+	getStateHistory(config, options) {
+		return this.#graph.getStateHistory(config, options);
+	}
+	/**
+	* @internal
+	*/
+	getSubgraphs(namespace, recurse) {
+		return this.#graph.getSubgraphs(namespace, recurse);
+	}
+	/**
+	* @internal
+	*/
+	getSubgraphAsync(namespace, recurse) {
+		return this.#graph.getSubgraphsAsync(namespace, recurse);
+	}
 };
 
 //#endregion