langchain 1.0.0-alpha.5 → 1.0.0-alpha.7

package/dist/agents/middlewareAgent/annotation.cjs

@@ -2,12 +2,18 @@ const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
 const __langchain_langgraph = require_rolldown_runtime.__toESM(require("@langchain/langgraph"));
 
 //#region src/agents/middlewareAgent/annotation.ts
-function createAgentAnnotationConditional(hasStructuredResponse = true, middlewares = []) {
-	const baseAnnotation = { messages: (0, __langchain_langgraph.Annotation)({
-		reducer: __langchain_langgraph.messagesStateReducer,
-		default: () => []
-	}) };
-	for (const middleware of middlewares) if (middleware.stateSchema) {
+function createAgentAnnotationConditional(hasStructuredResponse = true, middlewareList = []) {
+	const baseAnnotation = {
+		messages: (0, __langchain_langgraph.Annotation)({
+			reducer: __langchain_langgraph.messagesStateReducer,
+			default: () => []
+		}),
+		jumpTo: (0, __langchain_langgraph.Annotation)({
+			reducer: (_x, y) => y,
+			default: () => void 0
+		})
+	};
+	for (const middleware of middlewareList) if (middleware.stateSchema) {
 		let parsedDefaults = {};
 		try {
 			parsedDefaults = middleware.stateSchema.parse({});

package/dist/agents/middlewareAgent/annotation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"annotation.cjs","names":["middlewares: TMiddlewares","baseAnnotation: Record<string, any>","messagesStateReducer","parsedDefaults: Record<string, any>","x: any","y: any","Annotation"],"sources":["../../../src/agents/middlewareAgent/annotation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  Annotation,\n  Messages,\n  AnnotationRoot,\n  messagesStateReducer,\n  type BinaryOperatorAggregate,\n  type LastValue,\n} from \"@langchain/langgraph\";\nimport type { ResponseFormatUndefined } from \"../responses.js\";\nimport type { AgentMiddleware, InferMiddlewareStates } from \"./types.js\";\n\n// Create annotation conditionally - for ResponseFormatUndefined, don't include structuredResponse\n// Helper type for the merged annotation\ntype MergedAnnotationSpec<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddlewares extends readonly AgentMiddleware<any, any, any>[]\n> = {\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n} & (T extends ResponseFormatUndefined\n  ? {}\n  : { structuredResponse: LastValue<T> }) &\n  InferMiddlewareStates<TMiddlewares>;\n\nexport function createAgentAnnotationConditional<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddlewares extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  hasStructuredResponse = true,\n  middlewares: TMiddlewares = [] as unknown as TMiddlewares\n): AnnotationRoot<MergedAnnotationSpec<T, TMiddlewares>> {\n  const baseAnnotation: Record<string, any> = {\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n  };\n\n  // Add middleware state properties to the annotation\n  for (const middleware of middlewares) {\n    if (middleware.stateSchema) {\n      // Parse empty object to get default values\n      let parsedDefaults: Record<string, any> = {};\n      try {\n        parsedDefaults = middleware.stateSchema.parse({});\n      } catch {\n        // If parsing fails, we'll use undefined as defaults\n      }\n\n      const { shape } = middleware.stateSchema;\n      for (const [key] of Object.entries(shape)) {\n        /**\n         * Skip private state properties\n         */\n        if (key.startsWith(\"_\")) {\n          continue;\n        }\n\n        if (!(key in baseAnnotation)) {\n          const defaultValue = parsedDefaults[key] ?? undefined;\n          baseAnnotation[key] = Annotation({\n            reducer: (x: any, y: any) => y ?? x,\n            default: () => defaultValue,\n          });\n        }\n      }\n    }\n  }\n\n  if (!hasStructuredResponse) {\n    return Annotation.Root(baseAnnotation) as AnnotationRoot<\n      MergedAnnotationSpec<T, TMiddlewares>\n    >;\n  }\n\n  return Annotation.Root({\n    ...baseAnnotation,\n    structuredResponse:\n      Annotation<T extends ResponseFormatUndefined ? never : T>(),\n  }) as unknown as AnnotationRoot<MergedAnnotationSpec<T, TMiddlewares>>;\n}\n"],"mappings":";;;;AAyBA,SAAgB,iCAId,wBAAwB,MACxBA,cAA4B,CAAE,GACyB;CACvD,MAAMC,iBAAsC,EAC1C,gDAA8C;EAC5C,SAASC;EACT,SAAS,MAAM,CAAE;CAClB,EAAC,CACH;AAGD,MAAK,MAAM,cAAc,YACvB,KAAI,WAAW,aAAa;EAE1B,IAAIC,iBAAsC,CAAE;AAC5C,MAAI;GACF,iBAAiB,WAAW,YAAY,MAAM,CAAE,EAAC;EAClD,QAAO,CAEP;EAED,MAAM,EAAE,OAAO,GAAG,WAAW;AAC7B,OAAK,MAAM,CAAC,IAAI,IAAI,OAAO,QAAQ,MAAM,EAAE;;;;AAIzC,OAAI,IAAI,WAAW,IAAI,CACrB;AAGF,OAAI,EAAE,OAAO,iBAAiB;IAC5B,MAAM,eAAe,eAAe,QAAQ;IAC5C,eAAe,6CAAkB;KAC/B,SAAS,CAACC,GAAQC,MAAW,KAAK;KAClC,SAAS,MAAM;IAChB,EAAC;GACH;EACF;CACF;AAGH,KAAI,CAAC,sBACH,QAAOC,iCAAW,KAAK,eAAe;AAKxC,QAAOA,iCAAW,KAAK;EACrB,GAAG;EACH,2DAC6D;CAC9D,EAAC;AACH"}
+{"version":3,"file":"annotation.cjs","names":["middlewareList: TMiddleware","baseAnnotation: Record<string, any>","messagesStateReducer","_x: any","y: any","parsedDefaults: Record<string, any>","x: any","Annotation"],"sources":["../../../src/agents/middlewareAgent/annotation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  Annotation,\n  Messages,\n  AnnotationRoot,\n  messagesStateReducer,\n  type BinaryOperatorAggregate,\n  type LastValue,\n} from \"@langchain/langgraph\";\nimport type { ResponseFormatUndefined } from \"../annotation.js\";\nimport type { AgentMiddleware, InferMiddlewareStates } from \"./types.js\";\n\n// Create annotation conditionally - for ResponseFormatUndefined, don't include structuredResponse\n// Helper type for the merged annotation\ntype MergedAnnotationSpec<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddleware extends readonly AgentMiddleware<any, any, any>[]\n> = {\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n  jumpTo: LastValue<\"model_request\" | \"tools\" | undefined>;\n} & (T extends ResponseFormatUndefined\n  ? {}\n  : { structuredResponse: LastValue<T> }) &\n  InferMiddlewareStates<TMiddleware>;\n\nexport function createAgentAnnotationConditional<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddleware extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  hasStructuredResponse = true,\n  middlewareList: TMiddleware = [] as unknown as TMiddleware\n): AnnotationRoot<MergedAnnotationSpec<T, TMiddleware>> {\n  const baseAnnotation: Record<string, any> = {\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n    jumpTo: Annotation<\"model_request\" | \"tools\" | undefined>({\n      /**\n       * Since `jumpTo` acts as a control command, we only want\n       * to apply it if explicitly set.\n       */\n      reducer: (_x: any, y: any) => y,\n      default: () => undefined,\n    }),\n  };\n\n  // Add middleware state properties to the annotation\n  for (const middleware of middlewareList) {\n    if (middleware.stateSchema) {\n      // Parse empty object to get default values\n      let parsedDefaults: Record<string, any> = {};\n      try {\n        parsedDefaults = middleware.stateSchema.parse({});\n      } catch {\n        // If parsing fails, we'll use undefined as defaults\n      }\n\n      const { shape } = middleware.stateSchema;\n      for (const [key] of Object.entries(shape)) {\n        /**\n         * Skip private state properties\n         */\n        if (key.startsWith(\"_\")) {\n          continue;\n        }\n\n        if (!(key in baseAnnotation)) {\n          const defaultValue = parsedDefaults[key] ?? undefined;\n          baseAnnotation[key] = Annotation({\n            reducer: (x: any, y: any) => y ?? x,\n            default: () => defaultValue,\n          });\n        }\n      }\n    }\n  }\n\n  if (!hasStructuredResponse) {\n    return Annotation.Root(baseAnnotation) as AnnotationRoot<\n      MergedAnnotationSpec<T, TMiddleware>\n    >;\n  }\n\n  return Annotation.Root({\n    ...baseAnnotation,\n    structuredResponse:\n      Annotation<T extends ResponseFormatUndefined ? never : T>(),\n  }) as unknown as AnnotationRoot<MergedAnnotationSpec<T, TMiddleware>>;\n}\n"],"mappings":";;;;AA0BA,SAAgB,iCAId,wBAAwB,MACxBA,iBAA8B,CAAE,GACsB;CACtD,MAAMC,iBAAsC;EAC1C,gDAA8C;GAC5C,SAASC;GACT,SAAS,MAAM,CAAE;EAClB,EAAC;EACF,8CAA0D;GAKxD,SAAS,CAACC,IAASC,MAAW;GAC9B,SAAS,MAAM;EAChB,EAAC;CACH;AAGD,MAAK,MAAM,cAAc,eACvB,KAAI,WAAW,aAAa;EAE1B,IAAIC,iBAAsC,CAAE;AAC5C,MAAI;GACF,iBAAiB,WAAW,YAAY,MAAM,CAAE,EAAC;EAClD,QAAO,CAEP;EAED,MAAM,EAAE,OAAO,GAAG,WAAW;AAC7B,OAAK,MAAM,CAAC,IAAI,IAAI,OAAO,QAAQ,MAAM,EAAE;;;;AAIzC,OAAI,IAAI,WAAW,IAAI,CACrB;AAGF,OAAI,EAAE,OAAO,iBAAiB;IAC5B,MAAM,eAAe,eAAe,QAAQ;IAC5C,eAAe,6CAAkB;KAC/B,SAAS,CAACC,GAAQF,MAAW,KAAK;KAClC,SAAS,MAAM;IAChB,EAAC;GACH;EACF;CACF;AAGH,KAAI,CAAC,sBACH,QAAOG,iCAAW,KAAK,eAAe;AAKxC,QAAOA,iCAAW,KAAK;EACrB,GAAG;EACH,2DAC6D;CAC9D,EAAC;AACH"}

package/dist/agents/middlewareAgent/annotation.js

@@ -1,12 +1,18 @@
 import { Annotation, messagesStateReducer } from "@langchain/langgraph";
 
 //#region src/agents/middlewareAgent/annotation.ts
-function createAgentAnnotationConditional(hasStructuredResponse = true, middlewares = []) {
-	const baseAnnotation = { messages: Annotation({
-		reducer: messagesStateReducer,
-		default: () => []
-	}) };
-	for (const middleware of middlewares) if (middleware.stateSchema) {
+function createAgentAnnotationConditional(hasStructuredResponse = true, middlewareList = []) {
+	const baseAnnotation = {
+		messages: Annotation({
+			reducer: messagesStateReducer,
+			default: () => []
+		}),
+		jumpTo: Annotation({
+			reducer: (_x, y) => y,
+			default: () => void 0
+		})
+	};
+	for (const middleware of middlewareList) if (middleware.stateSchema) {
 		let parsedDefaults = {};
 		try {
 			parsedDefaults = middleware.stateSchema.parse({});

package/dist/agents/middlewareAgent/annotation.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotation.js","names":["middlewares: TMiddlewares","baseAnnotation: Record<string, any>","parsedDefaults: Record<string, any>","x: any","y: any"],"sources":["../../../src/agents/middlewareAgent/annotation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  Annotation,\n  Messages,\n  AnnotationRoot,\n  messagesStateReducer,\n  type BinaryOperatorAggregate,\n  type LastValue,\n} from \"@langchain/langgraph\";\nimport type { ResponseFormatUndefined } from \"../responses.js\";\nimport type { AgentMiddleware, InferMiddlewareStates } from \"./types.js\";\n\n// Create annotation conditionally - for ResponseFormatUndefined, don't include structuredResponse\n// Helper type for the merged annotation\ntype MergedAnnotationSpec<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddlewares extends readonly AgentMiddleware<any, any, any>[]\n> = {\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n} & (T extends ResponseFormatUndefined\n  ? {}\n  : { structuredResponse: LastValue<T> }) &\n  InferMiddlewareStates<TMiddlewares>;\n\nexport function createAgentAnnotationConditional<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddlewares extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  hasStructuredResponse = true,\n  middlewares: TMiddlewares = [] as unknown as TMiddlewares\n): AnnotationRoot<MergedAnnotationSpec<T, TMiddlewares>> {\n  const baseAnnotation: Record<string, any> = {\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n  };\n\n  // Add middleware state properties to the annotation\n  for (const middleware of middlewares) {\n    if (middleware.stateSchema) {\n      // Parse empty object to get default values\n      let parsedDefaults: Record<string, any> = {};\n      try {\n        parsedDefaults = middleware.stateSchema.parse({});\n      } catch {\n        // If parsing fails, we'll use undefined as defaults\n      }\n\n      const { shape } = middleware.stateSchema;\n      for (const [key] of Object.entries(shape)) {\n        /**\n         * Skip private state properties\n         */\n        if (key.startsWith(\"_\")) {\n          continue;\n        }\n\n        if (!(key in baseAnnotation)) {\n          const defaultValue = parsedDefaults[key] ?? undefined;\n          baseAnnotation[key] = Annotation({\n            reducer: (x: any, y: any) => y ?? x,\n            default: () => defaultValue,\n          });\n        }\n      }\n    }\n  }\n\n  if (!hasStructuredResponse) {\n    return Annotation.Root(baseAnnotation) as AnnotationRoot<\n      MergedAnnotationSpec<T, TMiddlewares>\n    >;\n  }\n\n  return Annotation.Root({\n    ...baseAnnotation,\n    structuredResponse:\n      Annotation<T extends ResponseFormatUndefined ? never : T>(),\n  }) as unknown as AnnotationRoot<MergedAnnotationSpec<T, TMiddlewares>>;\n}\n"],"mappings":";;;AAyBA,SAAgB,iCAId,wBAAwB,MACxBA,cAA4B,CAAE,GACyB;CACvD,MAAMC,iBAAsC,EAC1C,UAAU,WAAoC;EAC5C,SAAS;EACT,SAAS,MAAM,CAAE;CAClB,EAAC,CACH;AAGD,MAAK,MAAM,cAAc,YACvB,KAAI,WAAW,aAAa;EAE1B,IAAIC,iBAAsC,CAAE;AAC5C,MAAI;GACF,iBAAiB,WAAW,YAAY,MAAM,CAAE,EAAC;EAClD,QAAO,CAEP;EAED,MAAM,EAAE,OAAO,GAAG,WAAW;AAC7B,OAAK,MAAM,CAAC,IAAI,IAAI,OAAO,QAAQ,MAAM,EAAE;;;;AAIzC,OAAI,IAAI,WAAW,IAAI,CACrB;AAGF,OAAI,EAAE,OAAO,iBAAiB;IAC5B,MAAM,eAAe,eAAe,QAAQ;IAC5C,eAAe,OAAO,WAAW;KAC/B,SAAS,CAACC,GAAQC,MAAW,KAAK;KAClC,SAAS,MAAM;IAChB,EAAC;GACH;EACF;CACF;AAGH,KAAI,CAAC,sBACH,QAAO,WAAW,KAAK,eAAe;AAKxC,QAAO,WAAW,KAAK;EACrB,GAAG;EACH,oBACE,YAA2D;CAC9D,EAAC;AACH"}
+{"version":3,"file":"annotation.js","names":["middlewareList: TMiddleware","baseAnnotation: Record<string, any>","_x: any","y: any","parsedDefaults: Record<string, any>","x: any"],"sources":["../../../src/agents/middlewareAgent/annotation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  Annotation,\n  Messages,\n  AnnotationRoot,\n  messagesStateReducer,\n  type BinaryOperatorAggregate,\n  type LastValue,\n} from \"@langchain/langgraph\";\nimport type { ResponseFormatUndefined } from \"../annotation.js\";\nimport type { AgentMiddleware, InferMiddlewareStates } from \"./types.js\";\n\n// Create annotation conditionally - for ResponseFormatUndefined, don't include structuredResponse\n// Helper type for the merged annotation\ntype MergedAnnotationSpec<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddleware extends readonly AgentMiddleware<any, any, any>[]\n> = {\n  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;\n  jumpTo: LastValue<\"model_request\" | \"tools\" | undefined>;\n} & (T extends ResponseFormatUndefined\n  ? {}\n  : { structuredResponse: LastValue<T> }) &\n  InferMiddlewareStates<TMiddleware>;\n\nexport function createAgentAnnotationConditional<\n  T extends Record<string, any> | ResponseFormatUndefined,\n  TMiddleware extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  hasStructuredResponse = true,\n  middlewareList: TMiddleware = [] as unknown as TMiddleware\n): AnnotationRoot<MergedAnnotationSpec<T, TMiddleware>> {\n  const baseAnnotation: Record<string, any> = {\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n    jumpTo: Annotation<\"model_request\" | \"tools\" | undefined>({\n      /**\n       * Since `jumpTo` acts as a control command, we only want\n       * to apply it if explicitly set.\n       */\n      reducer: (_x: any, y: any) => y,\n      default: () => undefined,\n    }),\n  };\n\n  // Add middleware state properties to the annotation\n  for (const middleware of middlewareList) {\n    if (middleware.stateSchema) {\n      // Parse empty object to get default values\n      let parsedDefaults: Record<string, any> = {};\n      try {\n        parsedDefaults = middleware.stateSchema.parse({});\n      } catch {\n        // If parsing fails, we'll use undefined as defaults\n      }\n\n      const { shape } = middleware.stateSchema;\n      for (const [key] of Object.entries(shape)) {\n        /**\n         * Skip private state properties\n         */\n        if (key.startsWith(\"_\")) {\n          continue;\n        }\n\n        if (!(key in baseAnnotation)) {\n          const defaultValue = parsedDefaults[key] ?? undefined;\n          baseAnnotation[key] = Annotation({\n            reducer: (x: any, y: any) => y ?? x,\n            default: () => defaultValue,\n          });\n        }\n      }\n    }\n  }\n\n  if (!hasStructuredResponse) {\n    return Annotation.Root(baseAnnotation) as AnnotationRoot<\n      MergedAnnotationSpec<T, TMiddleware>\n    >;\n  }\n\n  return Annotation.Root({\n    ...baseAnnotation,\n    structuredResponse:\n      Annotation<T extends ResponseFormatUndefined ? never : T>(),\n  }) as unknown as AnnotationRoot<MergedAnnotationSpec<T, TMiddleware>>;\n}\n"],"mappings":";;;AA0BA,SAAgB,iCAId,wBAAwB,MACxBA,iBAA8B,CAAE,GACsB;CACtD,MAAMC,iBAAsC;EAC1C,UAAU,WAAoC;GAC5C,SAAS;GACT,SAAS,MAAM,CAAE;EAClB,EAAC;EACF,QAAQ,WAAkD;GAKxD,SAAS,CAACC,IAASC,MAAW;GAC9B,SAAS,MAAM;EAChB,EAAC;CACH;AAGD,MAAK,MAAM,cAAc,eACvB,KAAI,WAAW,aAAa;EAE1B,IAAIC,iBAAsC,CAAE;AAC5C,MAAI;GACF,iBAAiB,WAAW,YAAY,MAAM,CAAE,EAAC;EAClD,QAAO,CAEP;EAED,MAAM,EAAE,OAAO,GAAG,WAAW;AAC7B,OAAK,MAAM,CAAC,IAAI,IAAI,OAAO,QAAQ,MAAM,EAAE;;;;AAIzC,OAAI,IAAI,WAAW,IAAI,CACrB;AAGF,OAAI,EAAE,OAAO,iBAAiB;IAC5B,MAAM,eAAe,eAAe,QAAQ;IAC5C,eAAe,OAAO,WAAW;KAC/B,SAAS,CAACC,GAAQF,MAAW,KAAK;KAClC,SAAS,MAAM;IAChB,EAAC;GACH;EACF;CACF;AAGH,KAAI,CAAC,sBACH,QAAO,WAAW,KAAK,eAAe;AAKxC,QAAO,WAAW,KAAK;EACrB,GAAG;EACH,oBACE,YAA2D;CAC9D,EAAC;AACH"}

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

@@ -0,0 +1,5 @@
+//#region src/agents/middlewareAgent/constants.d.ts
+declare const JUMP_TO_TARGETS: readonly ["model", "tools", "end"];
+//#endregion
+export { JUMP_TO_TARGETS };
+//# sourceMappingURL=constants.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","names":["JUMP_TO_TARGETS"],"sources":["../../../src/agents/middlewareAgent/constants.d.ts"],"sourcesContent":["export declare const JUMP_TO_TARGETS: readonly [\"model\", \"tools\", \"end\"];\n"],"mappings":";cAAqBA"}

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

@@ -0,0 +1,5 @@
+//#region src/agents/middlewareAgent/constants.d.ts
+declare const JUMP_TO_TARGETS: readonly ["model", "tools", "end"];
+//#endregion
+export { JUMP_TO_TARGETS };
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":["JUMP_TO_TARGETS"],"sources":["../../../src/agents/middlewareAgent/constants.d.ts"],"sourcesContent":["export declare const JUMP_TO_TARGETS: readonly [\"model\", \"tools\", \"end\"];\n"],"mappings":";cAAqBA"}

package/dist/agents/middlewareAgent/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>","ReactAgent"],"sources":["../../../src/agents/middlewareAgent/index.ts"],"sourcesContent":["import type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\n\nimport { type AnyAnnotationRoot } from \"../annotation.js\";\nimport type { CreateAgentParams, AgentMiddleware } from \"./types.js\";\nimport type { ExtractZodArrayTypes } from \"../types.js\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  ResponseFormatUndefined,\n  JsonSchemaFormat,\n} from \"../responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a StateGraph agent that relies on a chat model utilizing tool calling.\n *\n * @example\n * ```ts\n * import { ChatOpenAI } from \"@langchain/openai\";\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const model = new ChatOpenAI({\n *   model: \"gpt-4o\",\n * });\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({ llm: model, tools: [getWeather] });\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// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  T extends readonly InteropZodType<any>[],\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<T> extends Record<string, any>\n      ? ExtractZodArrayTypes<T>\n      : Record<string, any>,\n    ContextSchema,\n    T\n  > & {\n    responseFormat: T;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<\n  ExtractZodArrayTypes<T> extends Record<string, any>\n    ? ExtractZodArrayTypes<T>\n    : Record<string, any>,\n  ContextSchema,\n  TMiddlewares\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddlewares>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddlewares>;\n\n// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddlewares>;\n\n// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 6: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 7: With responseFormat as ProviderStrategy\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 8: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & { middlewares?: TMiddlewares }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddlewares>;\n\n// Overload 9: With responseFormat explicitly undefined\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddlewares>;\n\n// Overload 10: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddlewares>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddlewares extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddlewares> {\n  return new ReactAgent(params);\n}\n\nexport { createMiddleware } from \"./middleware.js\";\n"],"mappings":";;;;AA4RA,SAAgB,YAKdA,QACmE;AACnE,QAAO,IAAIC,8BAAW;AACvB"}
+{"version":3,"file":"index.cjs","names":["params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>","ReactAgent"],"sources":["../../../src/agents/middlewareAgent/index.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\n\nimport type {\n  AnyAnnotationRoot,\n  ResponseFormatUndefined,\n} from \"../annotation.js\";\nimport type { CreateAgentParams, AgentMiddleware } from \"./types.js\";\nimport type { ExtractZodArrayTypes } from \"../types.js\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  JsonSchemaFormat,\n} from \"../responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools\n * and middleware to create systems that can reason about tasks, decide which tools to use, and iteratively\n * work towards solutions.\n *\n * The agent follows the ReAct pattern, interleaving reasoning steps with tool calls to iteratively\n * work towards solutions. It can handle multiple tool calls in sequence or parallel, maintain state\n * across interactions, and provide auditable decision processes.\n *\n * ## Core Components\n *\n * ### Model\n * The reasoning engine can be specified as:\n * - **String identifier**: `\"openai:gpt-4o\"` for simple setup\n * - **Model instance**: Configured model object for full control\n * - **Dynamic function**: Select models at runtime based on state\n *\n * ### Tools\n * Tools give agents the ability to take actions:\n * - Pass an array of tools created with the `tool` function\n * - Or provide a configured `ToolNode` for custom error handling\n *\n * ### Prompt\n * Shape how your agent approaches tasks:\n * - String for simple instructions\n * - SystemMessage for structured prompts\n * - Function for dynamic prompts based on state\n *\n * ### Middleware\n * Middleware allows you to extend the agent's behavior:\n * - Add pre/post-model processing for context injection or validation\n * - Add dynamic control flows, e.g. terminate invocation or retries\n * - Add human-in-the-loop capabilities\n * - Add tool calls to the agent\n * - Add tool results to the agent\n *\n * ## Advanced Features\n *\n * - **Structured Output**: Use `responseFormat` with a Zod schema to get typed responses\n * - **Memory**: Extend the state schema to remember information across interactions\n * - **Streaming**: Get real-time updates as the agent processes\n *\n * @param options - Configuration options for the agent\n * @param options.llm - The language model as an instance of a chat model\n * @param options.model - The language model as a string identifier, see more in {@link https://docs.langchain.com/oss/javascript/langchain/models#basic-usage | Models}.\n * @param options.tools - Array of tools or configured ToolNode\n * @param options.prompt - System instructions (string, SystemMessage, or function)\n * @param options.responseFormat - Zod schema for structured output\n * @param options.stateSchema - Custom state schema for memory\n * @param options.middleware - Array of middleware for extending agent behavior, see more in {@link https://docs.langchain.com/oss/javascript/langchain/middleware | Middleware}.\n *\n * @returns A ReactAgent instance with `invoke` and `stream` methods\n *\n * @example Basic agent with tools\n * ```ts\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const search = tool(\n *   ({ query }) => `Results for: ${query}`,\n *   {\n *     name: \"search\",\n *     description: \"Search for information\",\n *     schema: z.object({\n *       query: z.string().describe(\"The search query\"),\n *     })\n *   }\n * );\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [search],\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{ role: \"user\", content: \"Search for ReAct agents\" }],\n * });\n * ```\n *\n * @example Structured output\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const ContactInfo = z.object({\n *   name: z.string(),\n *   email: z.string(),\n *   phone: z.string(),\n * });\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [],\n *   responseFormat: ContactInfo,\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{\n *     role: \"user\",\n *     content: \"Extract: John Doe, john@example.com, (555) 123-4567\"\n *   }],\n * });\n *\n * console.log(result.structuredResponse);\n * // { name: 'John Doe', email: 'john@example.com', phone: '(555) 123-4567' }\n * ```\n *\n * @example Streaming responses\n * ```ts\n * const stream = await agent.stream(\n *   { messages: [{ role: \"user\", content: \"What's the weather?\" }] },\n *   { streamMode: \"values\" }\n * );\n *\n * for await (const chunk of stream) {\n *   // ...\n * }\n * ```\n */\n// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  T extends readonly InteropZodType<any>[],\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<T> extends Record<string, any>\n      ? ExtractZodArrayTypes<T>\n      : Record<string, any>,\n    ContextSchema,\n    T\n  > & {\n    responseFormat: T;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<\n  ExtractZodArrayTypes<T> extends Record<string, any>\n    ? ExtractZodArrayTypes<T>\n    : Record<string, any>,\n  ContextSchema,\n  TMiddleware\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 6: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 7: With responseFormat as ProviderStrategy\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 8: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & { middleware?: TMiddleware }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 9: With responseFormat explicitly undefined\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 10: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddleware extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware> {\n  return new ReactAgent(params);\n}\n\nexport { createMiddleware } from \"./middleware.js\";\n"],"mappings":";;;;AA6WA,SAAgB,YAKdA,QACkE;AAClE,QAAO,IAAIC,8BAAW;AACvB"}

package/dist/agents/middlewareAgent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>"],"sources":["../../../src/agents/middlewareAgent/index.ts"],"sourcesContent":["import type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\n\nimport { type AnyAnnotationRoot } from \"../annotation.js\";\nimport type { CreateAgentParams, AgentMiddleware } from \"./types.js\";\nimport type { ExtractZodArrayTypes } from \"../types.js\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  ResponseFormatUndefined,\n  JsonSchemaFormat,\n} from \"../responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a StateGraph agent that relies on a chat model utilizing tool calling.\n *\n * @example\n * ```ts\n * import { ChatOpenAI } from \"@langchain/openai\";\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const model = new ChatOpenAI({\n *   model: \"gpt-4o\",\n * });\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({ llm: model, tools: [getWeather] });\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// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  T extends readonly InteropZodType<any>[],\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<T> extends Record<string, any>\n      ? ExtractZodArrayTypes<T>\n      : Record<string, any>,\n    ContextSchema,\n    T\n  > & {\n    responseFormat: T;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<\n  ExtractZodArrayTypes<T> extends Record<string, any>\n    ? ExtractZodArrayTypes<T>\n    : Record<string, any>,\n  ContextSchema,\n  TMiddlewares\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddlewares>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddlewares>;\n\n// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddlewares>;\n\n// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 6: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 7: With responseFormat as ProviderStrategy\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<T, ContextSchema, TMiddlewares>;\n\n// Overload 8: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & { middlewares?: TMiddlewares }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddlewares>;\n\n// Overload 9: With responseFormat explicitly undefined\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddlewares>;\n\n// Overload 10: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddlewares extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middlewares?: TMiddlewares;\n  }\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddlewares>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddlewares extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddlewares> {\n  return new ReactAgent(params);\n}\n\nexport { createMiddleware } from \"./middleware.js\";\n"],"mappings":";;;;AA4RA,SAAgB,YAKdA,QACmE;AACnE,QAAO,IAAI,WAAW;AACvB"}
+{"version":3,"file":"index.js","names":["params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>"],"sources":["../../../src/agents/middlewareAgent/index.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\n\nimport type {\n  AnyAnnotationRoot,\n  ResponseFormatUndefined,\n} from \"../annotation.js\";\nimport type { CreateAgentParams, AgentMiddleware } from \"./types.js\";\nimport type { ExtractZodArrayTypes } from \"../types.js\";\nimport type {\n  ToolStrategy,\n  TypedToolStrategy,\n  ProviderStrategy,\n  ResponseFormat,\n  JsonSchemaFormat,\n} from \"../responses.js\";\nimport { ReactAgent } from \"./ReactAgent.js\";\n\n/**\n * Creates a production-ready ReAct (Reasoning + Acting) agent that combines language models with tools\n * and middleware to create systems that can reason about tasks, decide which tools to use, and iteratively\n * work towards solutions.\n *\n * The agent follows the ReAct pattern, interleaving reasoning steps with tool calls to iteratively\n * work towards solutions. It can handle multiple tool calls in sequence or parallel, maintain state\n * across interactions, and provide auditable decision processes.\n *\n * ## Core Components\n *\n * ### Model\n * The reasoning engine can be specified as:\n * - **String identifier**: `\"openai:gpt-4o\"` for simple setup\n * - **Model instance**: Configured model object for full control\n * - **Dynamic function**: Select models at runtime based on state\n *\n * ### Tools\n * Tools give agents the ability to take actions:\n * - Pass an array of tools created with the `tool` function\n * - Or provide a configured `ToolNode` for custom error handling\n *\n * ### Prompt\n * Shape how your agent approaches tasks:\n * - String for simple instructions\n * - SystemMessage for structured prompts\n * - Function for dynamic prompts based on state\n *\n * ### Middleware\n * Middleware allows you to extend the agent's behavior:\n * - Add pre/post-model processing for context injection or validation\n * - Add dynamic control flows, e.g. terminate invocation or retries\n * - Add human-in-the-loop capabilities\n * - Add tool calls to the agent\n * - Add tool results to the agent\n *\n * ## Advanced Features\n *\n * - **Structured Output**: Use `responseFormat` with a Zod schema to get typed responses\n * - **Memory**: Extend the state schema to remember information across interactions\n * - **Streaming**: Get real-time updates as the agent processes\n *\n * @param options - Configuration options for the agent\n * @param options.llm - The language model as an instance of a chat model\n * @param options.model - The language model as a string identifier, see more in {@link https://docs.langchain.com/oss/javascript/langchain/models#basic-usage | Models}.\n * @param options.tools - Array of tools or configured ToolNode\n * @param options.prompt - System instructions (string, SystemMessage, or function)\n * @param options.responseFormat - Zod schema for structured output\n * @param options.stateSchema - Custom state schema for memory\n * @param options.middleware - Array of middleware for extending agent behavior, see more in {@link https://docs.langchain.com/oss/javascript/langchain/middleware | Middleware}.\n *\n * @returns A ReactAgent instance with `invoke` and `stream` methods\n *\n * @example Basic agent with tools\n * ```ts\n * import { createAgent, tool } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const search = tool(\n *   ({ query }) => `Results for: ${query}`,\n *   {\n *     name: \"search\",\n *     description: \"Search for information\",\n *     schema: z.object({\n *       query: z.string().describe(\"The search query\"),\n *     })\n *   }\n * );\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [search],\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{ role: \"user\", content: \"Search for ReAct agents\" }],\n * });\n * ```\n *\n * @example Structured output\n * ```ts\n * import { createAgent } from \"langchain\";\n * import { z } from \"zod\";\n *\n * const ContactInfo = z.object({\n *   name: z.string(),\n *   email: z.string(),\n *   phone: z.string(),\n * });\n *\n * const agent = createAgent({\n *   llm: \"openai:gpt-4o\",\n *   tools: [],\n *   responseFormat: ContactInfo,\n * });\n *\n * const result = await agent.invoke({\n *   messages: [{\n *     role: \"user\",\n *     content: \"Extract: John Doe, john@example.com, (555) 123-4567\"\n *   }],\n * });\n *\n * console.log(result.structuredResponse);\n * // { name: 'John Doe', email: 'john@example.com', phone: '(555) 123-4567' }\n * ```\n *\n * @example Streaming responses\n * ```ts\n * const stream = await agent.stream(\n *   { messages: [{ role: \"user\", content: \"What's the weather?\" }] },\n *   { streamMode: \"values\" }\n * );\n *\n * for await (const chunk of stream) {\n *   // ...\n * }\n * ```\n */\n// Overload 1: With responseFormat as single InteropZodType\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, InteropZodType<T>> & {\n    responseFormat: InteropZodType<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 2: With responseFormat as array of InteropZodTypes (infers union type)\nexport function createAgent<\n  T extends readonly InteropZodType<any>[],\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    ExtractZodArrayTypes<T> extends Record<string, any>\n      ? ExtractZodArrayTypes<T>\n      : Record<string, any>,\n    ContextSchema,\n    T\n  > & {\n    responseFormat: T;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<\n  ExtractZodArrayTypes<T> extends Record<string, any>\n    ? ExtractZodArrayTypes<T>\n    : Record<string, any>,\n  ContextSchema,\n  TMiddleware\n>;\n\n// Overload 3: With responseFormat as JsonSchemaFormat (JSON schema object)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat\n  > & {\n    responseFormat: JsonSchemaFormat;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 4: With responseFormat as array of JsonSchemaFormat (JSON schema objects)\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat[];\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 4.5: With responseFormat as union of JsonSchemaFormat | JsonSchemaFormat[]\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    Record<string, unknown>,\n    ContextSchema,\n    JsonSchemaFormat | JsonSchemaFormat[]\n  > & {\n    responseFormat: JsonSchemaFormat | JsonSchemaFormat[];\n    middleware?: TMiddleware;\n  }\n): ReactAgent<Record<string, unknown>, ContextSchema, TMiddleware>;\n\n// Overload 5: With responseFormat as TypedToolStrategy (for union types from toolStrategy)\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, TypedToolStrategy<T>> & {\n    responseFormat: TypedToolStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 6: With responseFormat as single ToolStrategy instance\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ToolStrategy<T>> & {\n    responseFormat: ToolStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 7: With responseFormat as ProviderStrategy\nexport function createAgent<\n  T extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<T, ContextSchema, ProviderStrategy<T>> & {\n    responseFormat: ProviderStrategy<T>;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<T, ContextSchema, TMiddleware>;\n\n// Overload 8: Without responseFormat property at all - with proper middleware state typing\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & { middleware?: TMiddleware }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 9: With responseFormat explicitly undefined\nexport function createAgent<\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: Omit<\n    CreateAgentParams<ResponseFormatUndefined, ContextSchema, never>,\n    \"responseFormat\"\n  > & {\n    responseFormat?: undefined;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<ResponseFormatUndefined, ContextSchema, TMiddleware>;\n\n// Overload 10: For other ResponseFormat values (failsafe)\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  ContextSchema extends\n    | AnyAnnotationRoot\n    | InteropZodObject = AnyAnnotationRoot,\n  TMiddleware extends readonly AgentMiddleware<\n    any,\n    any,\n    any\n  >[] = readonly AgentMiddleware<any, any, any>[]\n>(\n  params: CreateAgentParams<\n    StructuredResponseFormat,\n    ContextSchema,\n    ResponseFormat\n  > & {\n    responseFormat: ResponseFormat;\n    middleware?: TMiddleware;\n  }\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware>;\n\n// Implementation\nexport function createAgent<\n  StructuredResponseFormat extends Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject,\n  TMiddleware extends readonly AgentMiddleware<any, any, any>[] = []\n>(\n  params: CreateAgentParams<StructuredResponseFormat, ContextSchema, any>\n): ReactAgent<StructuredResponseFormat, ContextSchema, TMiddleware> {\n  return new ReactAgent(params);\n}\n\nexport { createMiddleware } from \"./middleware.js\";\n"],"mappings":";;;;AA6WA,SAAgB,YAKdA,QACkE;AAClE,QAAO,IAAI,WAAW;AACvB"}

package/dist/agents/middlewareAgent/middleware/bigTool.cjs

@@ -0,0 +1,162 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_chat_models_universal = require('../../../chat_models/universal.cjs');
+const require_middleware = require('../middleware.cjs');
+const __langchain_core_messages = require_rolldown_runtime.__toESM(require("@langchain/core/messages"));
+const __langchain_core_language_models_chat_models = require_rolldown_runtime.__toESM(require("@langchain/core/language_models/chat_models"));
+const zod_v3 = require_rolldown_runtime.__toESM(require("zod/v3"));
+
+//#region src/agents/middlewareAgent/middleware/bigTool.ts
+/**
+* Zod schema for tool selection structured output.
+*/
+const ToolSelectionSchema = zod_v3.z.object({ selectedTools: zod_v3.z.array(zod_v3.z.string()).describe("List of selected tool names") });
+const DEFAULT_SYSTEM_PROMPT = "Your goal is to select the most relevant tool for answering the user's query.";
+const DEFAULT_INCLUDE_FULL_HISTORY = false;
+const DEFAULT_MAX_RETRIES = 3;
+/**
+* Options for configuring the LLM Tool Selector middleware.
+*/
+const LLMToolSelectorOptionsSchema = zod_v3.z.object({
+	model: zod_v3.z.string().or(zod_v3.z.instanceof(__langchain_core_language_models_chat_models.BaseChatModel)).optional(),
+	systemPrompt: zod_v3.z.string().default(DEFAULT_SYSTEM_PROMPT),
+	maxTools: zod_v3.z.number().optional(),
+	includeFullHistory: zod_v3.z.boolean().default(DEFAULT_INCLUDE_FULL_HISTORY),
+	maxRetries: zod_v3.z.number().default(DEFAULT_MAX_RETRIES)
+});
+/**
+* Middleware for selecting tools using an LLM-based strategy.
+*
+* This middleware analyzes the user's query and available tools to select
+* the most relevant tools for the task, reducing the cognitive load on the
+* main model and improving response quality.
+*
+* @param options - Configuration options for the middleware
+* @param options.model - The language model to use for tool selection (default: the provided model from the agent options).
+* @param options.systemPrompt - System prompt for the tool selection model.
+* @param options.maxTools - Maximum number of tools to select.
+* @param options.includeFullHistory - Whether to include the full conversation history in the tool selection prompt.
+* @param options.maxRetries - Maximum number of retries if the model selects incorrect tools.
+*
+* @example
+* ```ts
+* import { llmToolSelectorMiddleware } from "langchain/agents/middleware";
+*
+* const middleware = llmToolSelectorMiddleware({
+*   maxTools: 3,
+*   systemPrompt: "Select the most relevant tools for the user's query."
+* });
+*
+* const agent = createAgent({
+*   model: "openai:gpt-4o",
+*   tools: [tool1, tool2, tool3, tool4, tool5],
+*   middleware: [middleware],
+* });
+* ```
+*/
+function llmToolSelectorMiddleware(options) {
+	return require_middleware.createMiddleware({
+		name: "LLMToolSelector",
+		contextSchema: LLMToolSelectorOptionsSchema,
+		async modifyModelRequest(request, _, runtime) {
+			const model = runtime.context.model ?? options.model;
+			const maxTools = runtime.context.maxTools ?? options.maxTools;
+			const includeFullHistory = runtime.context.includeFullHistory === DEFAULT_INCLUDE_FULL_HISTORY ? options.includeFullHistory ?? runtime.context.includeFullHistory : runtime.context.includeFullHistory ?? options.includeFullHistory;
+			const maxRetries = runtime.context.maxRetries === DEFAULT_MAX_RETRIES ? options.maxRetries ?? runtime.context.maxRetries : runtime.context.maxRetries ?? options.maxRetries;
+			const defaultSystemPrompt = runtime.context.systemPrompt === DEFAULT_SYSTEM_PROMPT ? options.systemPrompt ?? runtime.context.systemPrompt : runtime.context.systemPrompt ?? options.systemPrompt;
+			/**
+			* If no tools available, return request unchanged
+			*/
+			if (!request.tools || request.tools.length === 0) return request;
+			/**
+			* Extract tool information
+			*/
+			const toolInfo = runtime.tools.map((tool) => ({
+				name: tool.name,
+				description: tool.description,
+				tool
+			}));
+			/**
+			* Build tool representation for the prompt
+			*/
+			const toolRepresentation = toolInfo.map(({ name, description }) => `- ${name}: ${description}`).join("\n");
+			/**
+			* Build system message
+			*/
+			let systemMessage = `You are an agent that can use the following tools:\n${toolRepresentation}\n${defaultSystemPrompt}`;
+			if (includeFullHistory) {
+				const userMessages = request.messages.filter(__langchain_core_messages.HumanMessage.isInstance).map((msg) => msg.content).join("\n");
+				systemMessage += `\nThe full conversation history is:\n${userMessages}`;
+			}
+			if (maxTools !== void 0) systemMessage += ` You can select up to ${maxTools} tools.`;
+			/**
+			* Get the latest user message
+			*/
+			const latestMessage = request.messages.at(-1);
+			const userContent = typeof latestMessage?.content === "string" ? latestMessage?.content : JSON.stringify(latestMessage?.content);
+			/**
+			* Create tool selection model
+			*/
+			const toolSelectionModel = !model ? request.model : typeof model === "string" ? await require_chat_models_universal.initChatModel(model) : model;
+			const validToolNames = toolInfo.map(({ name }) => name);
+			const structuredModel = await toolSelectionModel.withStructuredOutput(ToolSelectionSchema);
+			let attempts = 0;
+			let selectedToolNames = [...validToolNames];
+			while (attempts <= maxRetries) try {
+				const response = await structuredModel.invoke([{
+					role: "system",
+					content: systemMessage
+				}, {
+					role: "user",
+					content: userContent
+				}]);
+				selectedToolNames = response.selectedTools;
+				/**
+				* Validate that selected tools exist
+				*/
+				const invalidTools = selectedToolNames.filter((name) => !validToolNames.includes(name));
+				if (selectedToolNames.length === 0) {
+					systemMessage += `\n\nNote: You have not selected any tools. Please select at least one tool.`;
+					attempts++;
+				} else if (invalidTools.length === 0 && maxTools && selectedToolNames.length > maxTools) {
+					systemMessage += `\n\nNote: You have selected more tools than the maximum allowed. You can select up to ${maxTools} tools.`;
+					attempts++;
+				} else if (invalidTools.length === 0)
+ /**
+				* Success
+				*/
+				break;
+				else if (attempts < maxRetries) {
+					/**
+					* Retry with feedback about invalid tools
+					*/
+					systemMessage += `\n\nNote: The following tools are not available: ${invalidTools.join(", ")}. Please select only from the available tools.`;
+					attempts++;
+				} else {
+					/**
+					* Filter out invalid tools on final attempt
+					*/
+					selectedToolNames = selectedToolNames.filter((name) => validToolNames.includes(name));
+					break;
+				}
+			} catch {
+				/**
+				* Fall back to using all tools
+				*/
+				if (attempts >= maxRetries) return request;
+				attempts++;
+			}
+			/**
+			* Filter tools based on selection
+			*/
+			const selectedTools = toolInfo.filter(({ name }) => selectedToolNames.includes(name)).map(({ name }) => name);
+			return {
+				...request,
+				tools: selectedTools
+			};
+		}
+	});
+}
+
+//#endregion
+exports.llmToolSelectorMiddleware = llmToolSelectorMiddleware;
+//# sourceMappingURL=bigTool.cjs.map

package/dist/agents/middlewareAgent/middleware/bigTool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigTool.cjs","names":["z","BaseChatModel","options: LLMToolSelectorConfig","createMiddleware","HumanMessage","msg: BaseMessage","initChatModel","selectedToolNames: string[]"],"sources":["../../../../src/agents/middlewareAgent/middleware/bigTool.ts"],"sourcesContent":["import { z } from \"zod/v3\";\nimport { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport type { InferInteropZodInput } from \"@langchain/core/utils/types\";\nimport { BaseMessage, HumanMessage } from \"@langchain/core/messages\";\n\nimport { createMiddleware } from \"../middleware.js\";\nimport { initChatModel } from \"../../../chat_models/universal.js\";\nimport type { ModelRequest } from \"../types.js\";\n\n/**\n * Zod schema for tool selection structured output.\n */\nconst ToolSelectionSchema = z.object({\n  selectedTools: z.array(z.string()).describe(\"List of selected tool names\"),\n});\n\nconst DEFAULT_SYSTEM_PROMPT =\n  \"Your goal is to select the most relevant tool for answering the user's query.\";\nconst DEFAULT_INCLUDE_FULL_HISTORY = false;\nconst DEFAULT_MAX_RETRIES = 3;\n\n/**\n * Options for configuring the LLM Tool Selector middleware.\n */\nexport const LLMToolSelectorOptionsSchema = z.object({\n  /**\n   * The language model to use for tool selection (default: the provided model from the agent options).\n   */\n  model: z.string().or(z.instanceof(BaseChatModel)).optional(),\n  /**\n   * System prompt for the tool selection model.\n   */\n  systemPrompt: z.string().default(DEFAULT_SYSTEM_PROMPT),\n  /**\n   * Maximum number of tools to select.\n   */\n  maxTools: z.number().optional(),\n  /**\n   * Whether to include the full conversation history in the tool selection prompt.\n   */\n  includeFullHistory: z.boolean().default(DEFAULT_INCLUDE_FULL_HISTORY),\n  /**\n   * Maximum number of retries if the model selects incorrect tools.\n   */\n  maxRetries: z.number().default(DEFAULT_MAX_RETRIES),\n});\nexport type LLMToolSelectorConfig = InferInteropZodInput<\n  typeof LLMToolSelectorOptionsSchema\n>;\n\n/**\n * Middleware for selecting tools using an LLM-based strategy.\n *\n * This middleware analyzes the user's query and available tools to select\n * the most relevant tools for the task, reducing the cognitive load on the\n * main model and improving response quality.\n *\n * @param options - Configuration options for the middleware\n * @param options.model - The language model to use for tool selection (default: the provided model from the agent options).\n * @param options.systemPrompt - System prompt for the tool selection model.\n * @param options.maxTools - Maximum number of tools to select.\n * @param options.includeFullHistory - Whether to include the full conversation history in the tool selection prompt.\n * @param options.maxRetries - Maximum number of retries if the model selects incorrect tools.\n *\n * @example\n * ```ts\n * import { llmToolSelectorMiddleware } from \"langchain/agents/middleware\";\n *\n * const middleware = llmToolSelectorMiddleware({\n *   maxTools: 3,\n *   systemPrompt: \"Select the most relevant tools for the user's query.\"\n * });\n *\n * const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [tool1, tool2, tool3, tool4, tool5],\n *   middleware: [middleware],\n * });\n * ```\n */\nexport function llmToolSelectorMiddleware(options: LLMToolSelectorConfig) {\n  return createMiddleware({\n    name: \"LLMToolSelector\",\n    contextSchema: LLMToolSelectorOptionsSchema,\n    async modifyModelRequest(request, _, runtime): Promise<ModelRequest> {\n      const model = runtime.context.model ?? options.model;\n      const maxTools = runtime.context.maxTools ?? options.maxTools;\n      const includeFullHistory =\n        runtime.context.includeFullHistory === DEFAULT_INCLUDE_FULL_HISTORY\n          ? options.includeFullHistory ?? runtime.context.includeFullHistory\n          : runtime.context.includeFullHistory ?? options.includeFullHistory;\n      const maxRetries =\n        runtime.context.maxRetries === DEFAULT_MAX_RETRIES\n          ? options.maxRetries ?? runtime.context.maxRetries\n          : runtime.context.maxRetries ?? options.maxRetries;\n      const defaultSystemPrompt =\n        runtime.context.systemPrompt === DEFAULT_SYSTEM_PROMPT\n          ? options.systemPrompt ?? runtime.context.systemPrompt\n          : runtime.context.systemPrompt ?? options.systemPrompt;\n\n      /**\n       * If no tools available, return request unchanged\n       */\n      if (!request.tools || request.tools.length === 0) {\n        return request;\n      }\n\n      /**\n       * Extract tool information\n       */\n      const toolInfo = runtime.tools.map((tool) => ({\n        name: tool.name as string,\n        description: tool.description,\n        tool,\n      }));\n\n      /**\n       * Build tool representation for the prompt\n       */\n      const toolRepresentation = toolInfo\n        .map(({ name, description }) => `- ${name}: ${description}`)\n        .join(\"\\n\");\n\n      /**\n       * Build system message\n       */\n      let systemMessage = `You are an agent that can use the following tools:\\n${toolRepresentation}\\n${defaultSystemPrompt}`;\n\n      if (includeFullHistory) {\n        const userMessages = request.messages\n          .filter(HumanMessage.isInstance)\n          .map((msg: BaseMessage) => msg.content)\n          .join(\"\\n\");\n        systemMessage += `\\nThe full conversation history is:\\n${userMessages}`;\n      }\n\n      if (maxTools !== undefined) {\n        systemMessage += ` You can select up to ${maxTools} tools.`;\n      }\n\n      /**\n       * Get the latest user message\n       */\n      const latestMessage = request.messages.at(-1);\n      const userContent =\n        typeof latestMessage?.content === \"string\"\n          ? latestMessage?.content\n          : JSON.stringify(latestMessage?.content);\n\n      /**\n       * Create tool selection model\n       */\n      const toolSelectionModel = !model\n        ? (request.model as BaseChatModel)\n        : typeof model === \"string\"\n        ? await initChatModel(model)\n        : model;\n\n      const validToolNames = toolInfo.map(({ name }) => name);\n      const structuredModel = await toolSelectionModel.withStructuredOutput(\n        ToolSelectionSchema\n      );\n\n      let attempts = 0;\n      let selectedToolNames: string[] = [...validToolNames];\n\n      while (attempts <= maxRetries) {\n        try {\n          const response = await structuredModel.invoke([\n            { role: \"system\", content: systemMessage },\n            { role: \"user\", content: userContent },\n          ]);\n\n          selectedToolNames = response.selectedTools;\n\n          /**\n           * Validate that selected tools exist\n           */\n          const invalidTools = selectedToolNames.filter(\n            (name) => !validToolNames.includes(name)\n          );\n\n          if (selectedToolNames.length === 0) {\n            systemMessage += `\\n\\nNote: You have not selected any tools. Please select at least one tool.`;\n            attempts++;\n          } else if (\n            invalidTools.length === 0 &&\n            maxTools &&\n            selectedToolNames.length > maxTools\n          ) {\n            systemMessage += `\\n\\nNote: You have selected more tools than the maximum allowed. You can select up to ${maxTools} tools.`;\n            attempts++;\n          } else if (invalidTools.length === 0) {\n            /**\n             * Success\n             */\n            break;\n          } else if (attempts < maxRetries) {\n            /**\n             * Retry with feedback about invalid tools\n             */\n            systemMessage += `\\n\\nNote: The following tools are not available: ${invalidTools.join(\n              \", \"\n            )}. Please select only from the available tools.`;\n            attempts++;\n          } else {\n            /**\n             * Filter out invalid tools on final attempt\n             */\n            selectedToolNames = selectedToolNames.filter((name) =>\n              validToolNames.includes(name)\n            );\n            break;\n          }\n        } catch {\n          /**\n           * Fall back to using all tools\n           */\n          if (attempts >= maxRetries) {\n            return request;\n          }\n          attempts++;\n        }\n      }\n\n      /**\n       * Filter tools based on selection\n       */\n      const selectedTools = toolInfo\n        .filter(({ name }) => selectedToolNames.includes(name))\n        .map(({ name }) => name);\n\n      return {\n        ...request,\n        tools: selectedTools,\n      };\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/agents/middlewareAgent/middleware/bigTool.d.cts

@@ -0,0 +1,113 @@
+import { AgentMiddleware } from "../types.cjs";
+import { InferInteropZodInput } from "@langchain/core/utils/types";
+import * as _langchain_core_messages0 from "@langchain/core/messages";
+import { z } from "zod/v3";
+import * as _langchain_core_language_models_chat_models0 from "@langchain/core/language_models/chat_models";
+import { BaseChatModel } from "@langchain/core/language_models/chat_models";
+
+//#region src/agents/middlewareAgent/middleware/bigTool.d.ts
+/**
+ * Options for configuring the LLM Tool Selector middleware.
+ */
+declare const LLMToolSelectorOptionsSchema: z.ZodObject<{
+  /**
+   * The language model to use for tool selection (default: the provided model from the agent options).
+   */
+  model: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>>, z.ZodTypeDef, BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>>>]>>;
+  /**
+   * System prompt for the tool selection model.
+   */
+  systemPrompt: z.ZodDefault<z.ZodString>;
+  /**
+   * Maximum number of tools to select.
+   */
+  maxTools: z.ZodOptional<z.ZodNumber>;
+  /**
+   * Whether to include the full conversation history in the tool selection prompt.
+   */
+  includeFullHistory: z.ZodDefault<z.ZodBoolean>;
+  /**
+   * Maximum number of retries if the model selects incorrect tools.
+   */
+  maxRetries: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+  model?: string | BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>> | undefined;
+  systemPrompt: string;
+  maxTools?: number | undefined;
+  includeFullHistory: boolean;
+  maxRetries: number;
+}, {
+  model?: string | BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>> | undefined;
+  systemPrompt?: string | undefined;
+  maxTools?: number | undefined;
+  includeFullHistory?: boolean | undefined;
+  maxRetries?: number | undefined;
+}>;
+type LLMToolSelectorConfig = InferInteropZodInput<typeof LLMToolSelectorOptionsSchema>;
+/**
+ * Middleware for selecting tools using an LLM-based strategy.
+ *
+ * This middleware analyzes the user's query and available tools to select
+ * the most relevant tools for the task, reducing the cognitive load on the
+ * main model and improving response quality.
+ *
+ * @param options - Configuration options for the middleware
+ * @param options.model - The language model to use for tool selection (default: the provided model from the agent options).
+ * @param options.systemPrompt - System prompt for the tool selection model.
+ * @param options.maxTools - Maximum number of tools to select.
+ * @param options.includeFullHistory - Whether to include the full conversation history in the tool selection prompt.
+ * @param options.maxRetries - Maximum number of retries if the model selects incorrect tools.
+ *
+ * @example
+ * ```ts
+ * import { llmToolSelectorMiddleware } from "langchain/agents/middleware";
+ *
+ * const middleware = llmToolSelectorMiddleware({
+ *   maxTools: 3,
+ *   systemPrompt: "Select the most relevant tools for the user's query."
+ * });
+ *
+ * const agent = createAgent({
+ *   model: "openai:gpt-4o",
+ *   tools: [tool1, tool2, tool3, tool4, tool5],
+ *   middleware: [middleware],
+ * });
+ * ```
+ */
+declare function llmToolSelectorMiddleware(options: LLMToolSelectorConfig): AgentMiddleware<undefined, z.ZodObject<{
+  /**
+   * The language model to use for tool selection (default: the provided model from the agent options).
+   */
+  model: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>>, z.ZodTypeDef, BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>>>]>>;
+  /**
+   * System prompt for the tool selection model.
+   */
+  systemPrompt: z.ZodDefault<z.ZodString>;
+  /**
+   * Maximum number of tools to select.
+   */
+  maxTools: z.ZodOptional<z.ZodNumber>;
+  /**
+   * Whether to include the full conversation history in the tool selection prompt.
+   */
+  includeFullHistory: z.ZodDefault<z.ZodBoolean>;
+  /**
+   * Maximum number of retries if the model selects incorrect tools.
+   */
+  maxRetries: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+  model?: string | BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>> | undefined;
+  systemPrompt: string;
+  maxTools?: number | undefined;
+  includeFullHistory: boolean;
+  maxRetries: number;
+}, {
+  model?: string | BaseChatModel<_langchain_core_language_models_chat_models0.BaseChatModelCallOptions, _langchain_core_messages0.BaseMessageChunk<_langchain_core_messages0.MessageStructure, _langchain_core_messages0.MessageType>> | undefined;
+  systemPrompt?: string | undefined;
+  maxTools?: number | undefined;
+  includeFullHistory?: boolean | undefined;
+  maxRetries?: number | undefined;
+}>, any>;
+//#endregion
+export { LLMToolSelectorConfig, llmToolSelectorMiddleware };
+//# sourceMappingURL=bigTool.d.cts.map

package/dist/agents/middlewareAgent/middleware/bigTool.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigTool.d.cts","names":["_langchain_core_messages0","___types_js2","z","BaseChatModel","InferInteropZodInput","LLMToolSelectorOptionsSchema","ZodString","_langchain_core_language_models_chat_models0","BaseChatModelCallOptions","MessageStructure","MessageType","BaseMessageChunk","ZodTypeDef","ZodType","ZodUnion","ZodOptional","ZodDefault","ZodNumber","ZodBoolean","ZodTypeAny","ZodObject","LLMToolSelectorConfig","llmToolSelectorMiddleware","AgentMiddleware"],"sources":["../../../../src/agents/middlewareAgent/middleware/bigTool.d.ts"],"sourcesContent":["import { z } from \"zod/v3\";\nimport { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport type { InferInteropZodInput } from \"@langchain/core/utils/types\";\n/**\n * Options for configuring the LLM Tool Selector middleware.\n */\nexport declare const LLMToolSelectorOptionsSchema: z.ZodObject<{\n    /**\n     * The language model to use for tool selection (default: the provided model from the agent options).\n     */\n    model: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>>, z.ZodTypeDef, BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>>>]>>;\n    /**\n     * System prompt for the tool selection model.\n     */\n    systemPrompt: z.ZodDefault<z.ZodString>;\n    /**\n     * Maximum number of tools to select.\n     */\n    maxTools: z.ZodOptional<z.ZodNumber>;\n    /**\n     * Whether to include the full conversation history in the tool selection prompt.\n     */\n    includeFullHistory: z.ZodDefault<z.ZodBoolean>;\n    /**\n     * Maximum number of retries if the model selects incorrect tools.\n     */\n    maxRetries: z.ZodDefault<z.ZodNumber>;\n}, \"strip\", z.ZodTypeAny, {\n    model?: string | BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>> | undefined;\n    systemPrompt: string;\n    maxTools?: number | undefined;\n    includeFullHistory: boolean;\n    maxRetries: number;\n}, {\n    model?: string | BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>> | undefined;\n    systemPrompt?: string | undefined;\n    maxTools?: number | undefined;\n    includeFullHistory?: boolean | undefined;\n    maxRetries?: number | undefined;\n}>;\nexport type LLMToolSelectorConfig = InferInteropZodInput<typeof LLMToolSelectorOptionsSchema>;\n/**\n * Middleware for selecting tools using an LLM-based strategy.\n *\n * This middleware analyzes the user's query and available tools to select\n * the most relevant tools for the task, reducing the cognitive load on the\n * main model and improving response quality.\n *\n * @param options - Configuration options for the middleware\n * @param options.model - The language model to use for tool selection (default: the provided model from the agent options).\n * @param options.systemPrompt - System prompt for the tool selection model.\n * @param options.maxTools - Maximum number of tools to select.\n * @param options.includeFullHistory - Whether to include the full conversation history in the tool selection prompt.\n * @param options.maxRetries - Maximum number of retries if the model selects incorrect tools.\n *\n * @example\n * ```ts\n * import { llmToolSelectorMiddleware } from \"langchain/agents/middleware\";\n *\n * const middleware = llmToolSelectorMiddleware({\n *   maxTools: 3,\n *   systemPrompt: \"Select the most relevant tools for the user's query.\"\n * });\n *\n * const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [tool1, tool2, tool3, tool4, tool5],\n *   middleware: [middleware],\n * });\n * ```\n */\nexport declare function llmToolSelectorMiddleware(options: LLMToolSelectorConfig): import(\"../types.js\").AgentMiddleware<undefined, z.ZodObject<{\n    /**\n     * The language model to use for tool selection (default: the provided model from the agent options).\n     */\n    model: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>>, z.ZodTypeDef, BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>>>]>>;\n    /**\n     * System prompt for the tool selection model.\n     */\n    systemPrompt: z.ZodDefault<z.ZodString>;\n    /**\n     * Maximum number of tools to select.\n     */\n    maxTools: z.ZodOptional<z.ZodNumber>;\n    /**\n     * Whether to include the full conversation history in the tool selection prompt.\n     */\n    includeFullHistory: z.ZodDefault<z.ZodBoolean>;\n    /**\n     * Maximum number of retries if the model selects incorrect tools.\n     */\n    maxRetries: z.ZodDefault<z.ZodNumber>;\n}, \"strip\", z.ZodTypeAny, {\n    model?: string | BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>> | undefined;\n    systemPrompt: string;\n    maxTools?: number | undefined;\n    includeFullHistory: boolean;\n    maxRetries: number;\n}, {\n    model?: string | BaseChatModel<import(\"@langchain/core/language_models/chat_models\").BaseChatModelCallOptions, import(\"@langchain/core/messages\").BaseMessageChunk<import(\"@langchain/core/messages\").MessageStructure, import(\"@langchain/core/messages\").MessageType>> | undefined;\n    systemPrompt?: string | undefined;\n    maxTools?: number | undefined;\n    includeFullHistory?: boolean | undefined;\n    maxRetries?: number | undefined;\n}>, any>;\n"],"mappings":"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"}