langchain 1.0.0-alpha.5 → 1.0.0-alpha.6

package/dist/agents/middlewareAgent/nodes/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","names":["state: TStateSchema","config?: LangGraphRunnableConfig","relevantContext: Record<string, unknown>","runtime: Runtime<TContextSchema>","controls: Controls<TStateSchema>","target: \"model\" | \"tools\"","stateUpdate?: Partial<TStateSchema>","result?: Partial<TStateSchema> | Error","result"],"sources":["../../../../src/agents/middlewareAgent/nodes/middleware.ts"],"sourcesContent":["/* eslint-disable no-instanceof/no-instanceof */\nimport { z } from \"zod\";\nimport { LangGraphRunnableConfig, Command } from \"@langchain/langgraph\";\n\nimport { RunnableCallable } from \"../../RunnableCallable.js\";\nimport type {\n  Runtime,\n  Controls,\n  ControlAction,\n  AgentMiddleware,\n  MiddlewareResult,\n} from \"../types.js\";\nimport {\n  derivePrivateState,\n  parseToolCalls,\n  parseToolResults,\n} from \"./utils.js\";\n\ntype NodeOutput<TStateSchema extends Record<string, any>> =\n  | TStateSchema\n  | Command<any, TStateSchema, string>;\n\nexport abstract class MiddlewareNode<\n  TStateSchema extends Record<string, any>,\n  TContextSchema extends Record<string, any>\n> extends RunnableCallable<TStateSchema, NodeOutput<TStateSchema>> {\n  abstract middleware: AgentMiddleware<\n    z.ZodObject<z.ZodRawShape>,\n    z.ZodObject<z.ZodRawShape>\n  >;\n\n  abstract runHook(\n    state: TStateSchema,\n    config?: Runtime<TContextSchema>,\n    controls?: Controls<TStateSchema>\n  ): Promise<MiddlewareResult<TStateSchema>>;\n\n  async invokeMiddleware(\n    state: TStateSchema,\n    config?: LangGraphRunnableConfig\n  ): Promise<NodeOutput<TStateSchema>> {\n    /**\n     * Filter context based on middleware's contextSchema\n     */\n    let filteredContext = {} as TContextSchema;\n    /**\n     * Check both config.context and config.configurable.context\n     */\n    if (this.middleware.contextSchema && config?.context) {\n      /**\n       * Extract only the fields relevant to this middleware's schema\n       */\n      const schemaShape = this.middleware.contextSchema?.shape;\n      if (schemaShape) {\n        const relevantContext: Record<string, unknown> = {};\n        for (const key of Object.keys(schemaShape)) {\n          if (key in config.context) {\n            relevantContext[key] = config.context[key];\n          }\n        }\n        /**\n         * Parse to apply defaults and validation\n         */\n        filteredContext = this.middleware.contextSchema.parse(\n          relevantContext\n        ) as TContextSchema;\n      }\n    }\n\n    /**\n     * ToDo: implement later\n     */\n    const runtime: Runtime<TContextSchema> = {\n      toolCalls: parseToolCalls(state.messages),\n      toolResults: parseToolResults(state.messages),\n      context: filteredContext,\n    };\n\n    const controls: Controls<TStateSchema> = {\n      jumpTo: (\n        target: \"model\" | \"tools\",\n        stateUpdate?: Partial<TStateSchema>\n      ): ControlAction<TStateSchema> => ({\n        type: \"jump\",\n        target,\n        stateUpdate,\n      }),\n      terminate: (\n        result?: Partial<TStateSchema> | Error\n      ): ControlAction<TStateSchema> => {\n        if (result instanceof Error) {\n          throw result;\n        }\n        return { type: \"terminate\", result };\n      },\n    };\n\n    const result = await this.runHook(state, runtime, controls);\n\n    /**\n     * If result is undefined, return current state\n     */\n    if (!result) {\n      return state;\n    }\n\n    /**\n     * If result is a control action, handle it\n     */\n    // if (typeof result === \"object\" && \"type\" in result) {\n    //   // Handle control actions\n    //   const action = result as ControlAction<TStateSchema>;\n    //   if (action.type === \"terminate\") {\n    //     if (action.error) {\n    //       throw action.error;\n    //     }\n    //     return { ...state, ...(action.result || {}) };\n    //   }\n\n    //   if (action.type === \"jump\") {\n    //     return new Command<any, TStateSchema, string>({\n    //       goto: action.target,\n    //       update: { ...state, ...(action.stateUpdate || {}) },\n    //     });\n    //   }\n\n    //   throw new Error(`Invalid control action: ${JSON.stringify(action)}`);\n    // }\n\n    /**\n     * If result is a state update, merge it with current state\n     */\n    return { ...state, ...result };\n  }\n\n  get nodeOptions(): {\n    input: z.ZodObject<TStateSchema>;\n  } {\n    return {\n      input: derivePrivateState(\n        this.middleware.stateSchema\n      ) as z.ZodObject<TStateSchema>,\n    };\n  }\n}\n"],"mappings":";;;;AAsBA,IAAsB,iBAAtB,cAGU,iBAAyD;CAYjE,MAAM,iBACJA,OACAC,QACmC;;;;EAInC,IAAI,kBAAkB,CAAE;;;;AAIxB,MAAI,KAAK,WAAW,iBAAiB,QAAQ,SAAS;;;;GAIpD,MAAM,cAAc,KAAK,WAAW,eAAe;AACnD,OAAI,aAAa;IACf,MAAMC,kBAA2C,CAAE;AACnD,SAAK,MAAM,OAAO,OAAO,KAAK,YAAY,CACxC,KAAI,OAAO,OAAO,SAChB,gBAAgB,OAAO,OAAO,QAAQ;;;;IAM1C,kBAAkB,KAAK,WAAW,cAAc,MAC9C,gBACD;GACF;EACF;;;;EAKD,MAAMC,UAAmC;GACvC,WAAW,eAAe,MAAM,SAAS;GACzC,aAAa,iBAAiB,MAAM,SAAS;GAC7C,SAAS;EACV;EAED,MAAMC,WAAmC;GACvC,QAAQ,CACNC,QACAC,iBACiC;IACjC,MAAM;IACN;IACA;GACD;GACD,WAAW,CACTC,aACgC;AAChC,QAAIC,oBAAkB,MACpB,OAAMA;AAER,WAAO;KAAE,MAAM;KAAa;IAAQ;GACrC;EACF;EAED,MAAM,SAAS,MAAM,KAAK,QAAQ,OAAO,SAAS,SAAS;;;;AAK3D,MAAI,CAAC,OACH,QAAO;;;;;;;AA6BT,SAAO;GAAE,GAAG;GAAO,GAAG;EAAQ;CAC/B;CAED,IAAI,cAEF;AACA,SAAO,EACL,OAAO,mBACL,KAAK,WAAW,YACjB,CACF;CACF;AACF"}
+{"version":3,"file":"middleware.js","names":["state: TStateSchema","config?: LangGraphRunnableConfig","relevantContext: Record<string, unknown>","runtime: Runtime<TContextSchema>","controls: Controls<TStateSchema>","target: \"model\" | \"tools\"","stateUpdate?: Partial<TStateSchema>","result?: Partial<TStateSchema> | Error","result"],"sources":["../../../../src/agents/middlewareAgent/nodes/middleware.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable no-instanceof/no-instanceof */\nimport { z } from \"zod/v3\";\nimport { LangGraphRunnableConfig, Command } from \"@langchain/langgraph\";\n\nimport { RunnableCallable } from \"../../RunnableCallable.js\";\nimport type {\n  Runtime,\n  Controls,\n  ControlAction,\n  AgentMiddleware,\n  MiddlewareResult,\n} from \"../types.js\";\nimport {\n  derivePrivateState,\n  parseToolCalls,\n  parseToolResults,\n} from \"./utils.js\";\n\ntype NodeOutput<TStateSchema extends Record<string, any>> =\n  | TStateSchema\n  | Command<any, TStateSchema, string>;\n\nexport abstract class MiddlewareNode<\n  TStateSchema extends Record<string, any>,\n  TContextSchema extends Record<string, any>\n> extends RunnableCallable<TStateSchema, NodeOutput<TStateSchema>> {\n  abstract middleware: AgentMiddleware<\n    z.ZodObject<z.ZodRawShape>,\n    z.ZodObject<z.ZodRawShape>\n  >;\n\n  abstract runHook(\n    state: TStateSchema,\n    config?: Runtime<TContextSchema>,\n    controls?: Controls<TStateSchema>\n  ): Promise<MiddlewareResult<TStateSchema>>;\n\n  async invokeMiddleware(\n    state: TStateSchema,\n    config?: LangGraphRunnableConfig\n  ): Promise<NodeOutput<TStateSchema>> {\n    /**\n     * Filter context based on middleware's contextSchema\n     */\n    let filteredContext = {} as TContextSchema;\n    /**\n     * Check both config.context and config.configurable.context\n     */\n    if (this.middleware.contextSchema && config?.context) {\n      /**\n       * Extract only the fields relevant to this middleware's schema\n       */\n      const schemaShape = this.middleware.contextSchema?.shape;\n      if (schemaShape) {\n        const relevantContext: Record<string, unknown> = {};\n        for (const key of Object.keys(schemaShape)) {\n          if (key in config.context) {\n            relevantContext[key] = config.context[key];\n          }\n        }\n        /**\n         * Parse to apply defaults and validation\n         */\n        filteredContext = this.middleware.contextSchema.parse(\n          relevantContext\n        ) as TContextSchema;\n      }\n    }\n\n    /**\n     * ToDo: implement later\n     */\n    const runtime: Runtime<TContextSchema> = {\n      toolCalls: parseToolCalls(state.messages),\n      toolResults: parseToolResults(state.messages),\n      context: filteredContext,\n    };\n\n    const controls: Controls<TStateSchema> = {\n      jumpTo: (\n        target: \"model\" | \"tools\",\n        stateUpdate?: Partial<TStateSchema>\n      ): ControlAction<TStateSchema> => ({\n        type: \"jump\",\n        target,\n        stateUpdate,\n      }),\n      terminate: (\n        result?: Partial<TStateSchema> | Error\n      ): ControlAction<TStateSchema> => {\n        if (result instanceof Error) {\n          throw result;\n        }\n        return { type: \"terminate\", result };\n      },\n    };\n\n    const result = await this.runHook(state, runtime, controls);\n\n    /**\n     * If result is undefined, return current state\n     */\n    if (!result) {\n      return state;\n    }\n\n    /**\n     * If result is a control action, handle it\n     */\n    // if (typeof result === \"object\" && \"type\" in result) {\n    //   // Handle control actions\n    //   const action = result as ControlAction<TStateSchema>;\n    //   if (action.type === \"terminate\") {\n    //     if (action.error) {\n    //       throw action.error;\n    //     }\n    //     return { ...state, ...(action.result || {}) };\n    //   }\n\n    //   if (action.type === \"jump\") {\n    //     return new Command<any, TStateSchema, string>({\n    //       goto: action.target,\n    //       update: { ...state, ...(action.stateUpdate || {}) },\n    //     });\n    //   }\n\n    //   throw new Error(`Invalid control action: ${JSON.stringify(action)}`);\n    // }\n\n    /**\n     * If result is a state update, merge it with current state\n     */\n    return { ...state, ...result };\n  }\n\n  get nodeOptions(): {\n    input: z.ZodObject<TStateSchema>;\n  } {\n    return {\n      input: derivePrivateState(\n        this.middleware.stateSchema\n      ) as z.ZodObject<TStateSchema>,\n    };\n  }\n}\n"],"mappings":";;;;AAuBA,IAAsB,iBAAtB,cAGU,iBAAyD;CAYjE,MAAM,iBACJA,OACAC,QACmC;;;;EAInC,IAAI,kBAAkB,CAAE;;;;AAIxB,MAAI,KAAK,WAAW,iBAAiB,QAAQ,SAAS;;;;GAIpD,MAAM,cAAc,KAAK,WAAW,eAAe;AACnD,OAAI,aAAa;IACf,MAAMC,kBAA2C,CAAE;AACnD,SAAK,MAAM,OAAO,OAAO,KAAK,YAAY,CACxC,KAAI,OAAO,OAAO,SAChB,gBAAgB,OAAO,OAAO,QAAQ;;;;IAM1C,kBAAkB,KAAK,WAAW,cAAc,MAC9C,gBACD;GACF;EACF;;;;EAKD,MAAMC,UAAmC;GACvC,WAAW,eAAe,MAAM,SAAS;GACzC,aAAa,iBAAiB,MAAM,SAAS;GAC7C,SAAS;EACV;EAED,MAAMC,WAAmC;GACvC,QAAQ,CACNC,QACAC,iBACiC;IACjC,MAAM;IACN;IACA;GACD;GACD,WAAW,CACTC,aACgC;AAChC,QAAIC,oBAAkB,MACpB,OAAMA;AAER,WAAO;KAAE,MAAM;KAAa;IAAQ;GACrC;EACF;EAED,MAAM,SAAS,MAAM,KAAK,QAAQ,OAAO,SAAS,SAAS;;;;AAK3D,MAAI,CAAC,OACH,QAAO;;;;;;;AA6BT,SAAO;GAAE,GAAG;GAAO,GAAG;EAAQ;CAC/B;CAED,IAAI,cAEF;AACA,SAAO,EACL,OAAO,mBACL,KAAK,WAAW,YACjB,CACF;CACF;AACF"}

package/dist/agents/middlewareAgent/nodes/utils.cjs

@@ -1,6 +1,6 @@
 const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
 const __langchain_core_messages = require_rolldown_runtime.__toESM(require("@langchain/core/messages"));
-const zod = require_rolldown_runtime.__toESM(require("zod"));
+const zod_v3 = require_rolldown_runtime.__toESM(require("zod/v3"));
 
 //#region src/agents/middlewareAgent/nodes/utils.ts
 /**
@@ -10,14 +10,14 @@ const zod = require_rolldown_runtime.__toESM(require("zod"));
 * Private properties (starting with _) are automatically made optional since
 * users cannot provide them when invoking the agent.
 */
-function initializeMiddlewareStates(middlewares, state) {
+function initializeMiddlewareStates(middlewareList, state) {
 	const middlewareStates = {};
-	for (const middleware of middlewares) if (middleware.stateSchema) {
+	for (const middleware of middlewareList) if (middleware.stateSchema) {
 		const { shape } = middleware.stateSchema;
 		const modifiedShape = {};
 		for (const [key, value] of Object.entries(shape)) if (key.startsWith("_")) modifiedShape[key] = value.optional();
 		else modifiedShape[key] = value;
-		const modifiedSchema = zod.z.object(modifiedShape);
+		const modifiedSchema = zod_v3.z.object(modifiedShape);
 		const parseResult = modifiedSchema.safeParse(state);
 		if (parseResult.success) {
 			Object.assign(middlewareStates, parseResult.data);
@@ -38,13 +38,13 @@ function initializeMiddlewareStates(middlewares, state) {
 * @returns A new schema containing only the private properties (underscore-prefixed), all made optional
 */
 function derivePrivateState(stateSchema) {
-	const builtInStateSchema = { messages: zod.z.custom(() => []) };
-	if (!stateSchema) return zod.z.object(builtInStateSchema);
+	const builtInStateSchema = { messages: zod_v3.z.custom(() => []) };
+	if (!stateSchema) return zod_v3.z.object(builtInStateSchema);
 	const { shape } = stateSchema;
 	const privateShape = builtInStateSchema;
 	for (const [key, value] of Object.entries(shape)) if (key.startsWith("_")) privateShape[key] = value.optional();
 	else privateShape[key] = value;
-	return zod.z.object(privateShape);
+	return zod_v3.z.object(privateShape);
 }
 /**
 * Parse out all tool calls from the messages

package/dist/agents/middlewareAgent/nodes/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["middlewares: readonly AgentMiddleware<any, any, any>[]","state: unknown","middlewareStates: Record<string, any>","modifiedShape: Record<string, any>","z","issue: ZodIssue","stateSchema?: z.ZodObject<z.ZodRawShape>","privateShape: Record<string, any>","messages: BaseMessage[]"],"sources":["../../../../src/agents/middlewareAgent/nodes/utils.ts"],"sourcesContent":["import {\n  type BaseMessage,\n  type ToolMessage,\n  type AIMessage,\n  isToolMessage,\n  isAIMessage,\n} from \"@langchain/core/messages\";\nimport { z, type ZodIssue, type ZodTypeAny } from \"zod\";\n\nimport type { AgentMiddleware, ToolCall, ToolResult } from \"../types.js\";\n\n/**\n * Helper function to initialize middleware state defaults.\n * This is used to ensure all middleware state properties are initialized.\n *\n * Private properties (starting with _) are automatically made optional since\n * users cannot provide them when invoking the agent.\n */\nexport function initializeMiddlewareStates(\n  middlewares: readonly AgentMiddleware<any, any, any>[],\n  state: unknown\n): Record<string, any> {\n  const middlewareStates: Record<string, any> = {};\n\n  for (const middleware of middlewares) {\n    if (middleware.stateSchema) {\n      // Create a modified schema where private properties are optional\n      const { shape } = middleware.stateSchema;\n      const modifiedShape: Record<string, any> = {};\n\n      for (const [key, value] of Object.entries(shape)) {\n        if (key.startsWith(\"_\")) {\n          // Make private properties optional\n          modifiedShape[key] = (value as ZodTypeAny).optional();\n        } else {\n          // Keep public properties as-is\n          modifiedShape[key] = value;\n        }\n      }\n\n      const modifiedSchema = z.object(modifiedShape);\n\n      // Use safeParse with the modified schema\n      const parseResult = modifiedSchema.safeParse(state);\n\n      if (parseResult.success) {\n        Object.assign(middlewareStates, parseResult.data);\n        continue;\n      }\n\n      /**\n       * If safeParse fails, there are required public fields missing\n       */\n      const requiredFields = parseResult.error.issues\n        .filter(\n          (issue: ZodIssue) =>\n            issue.code === \"invalid_type\" && issue.message === \"Required\"\n        )\n        .map(\n          (issue: ZodIssue) => `  - ${issue.path.join(\".\")}: ${issue.message}`\n        )\n        .join(\"\\n\");\n\n      throw new Error(\n        `Middleware \"${middleware.name}\" has required state fields that must be initialized:\\n` +\n          `${requiredFields}\\n\\n` +\n          `To fix this, either:\\n` +\n          `1. Provide default values in your middleware's state schema using .default():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().default(\"default value\")\\n` +\n          `   })\\n\\n` +\n          `2. Or make the fields optional using .optional():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().optional()\\n` +\n          `   })\\n\\n` +\n          `3. Or ensure you pass these values when invoking the agent:\\n` +\n          `   agent.invoke({\\n` +\n          `     messages: [...],\\n` +\n          `     ${parseResult.error.issues[0]?.path.join(\".\")}: \"value\"\\n` +\n          `   })`\n      );\n    }\n  }\n\n  return middlewareStates;\n}\n\n/**\n * Users can define private and public state for a middleware. Private state properties start with an underscore.\n * This function will return the private state properties from the state schema, making all of them optional.\n * @param stateSchema - The middleware state schema\n * @returns A new schema containing only the private properties (underscore-prefixed), all made optional\n */\nexport function derivePrivateState(stateSchema?: z.ZodObject<z.ZodRawShape>) {\n  const builtInStateSchema = {\n    messages: z.custom<BaseMessage[]>(() => []),\n  };\n\n  if (!stateSchema) {\n    return z.object(builtInStateSchema);\n  }\n\n  const { shape } = stateSchema;\n  const privateShape: Record<string, any> = builtInStateSchema;\n\n  // Filter properties that start with underscore and make them optional\n  for (const [key, value] of Object.entries(shape)) {\n    if (key.startsWith(\"_\")) {\n      // Make the private property optional\n      privateShape[key] = value.optional();\n    } else {\n      privateShape[key] = value;\n    }\n  }\n\n  // Return a new schema with only private properties (all optional)\n  return z.object(privateShape);\n}\n\n/**\n * Parse out all tool calls from the messages\n * @param messages - The messages to parse\n * @returns The tool calls\n */\nexport function parseToolCalls(messages: BaseMessage[]): ToolCall[] {\n  return (\n    messages\n      .filter(\n        (message) => isAIMessage(message) && (message as AIMessage).tool_calls\n      )\n      .map((message) => (message as AIMessage).tool_calls as ToolCall[])\n      .flat() || []\n  );\n}\n\n/**\n * Parse out all tool results from the messages\n * @param messages - The messages to parse\n * @returns The tool results\n */\nexport function parseToolResults(messages: BaseMessage[]): ToolResult[] {\n  return messages\n    .filter((message) => isToolMessage(message))\n    .map((message) => ({\n      id: (message as ToolMessage).tool_call_id,\n      result: (message as ToolMessage).content,\n    }));\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,SAAgB,2BACdA,aACAC,OACqB;CACrB,MAAMC,mBAAwC,CAAE;AAEhD,MAAK,MAAM,cAAc,YACvB,KAAI,WAAW,aAAa;EAE1B,MAAM,EAAE,OAAO,GAAG,WAAW;EAC7B,MAAMC,gBAAqC,CAAE;AAE7C,OAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,cAAc,OAAQ,MAAqB,UAAU;OAGrD,cAAc,OAAO;EAIzB,MAAM,iBAAiBC,MAAE,OAAO,cAAc;EAG9C,MAAM,cAAc,eAAe,UAAU,MAAM;AAEnD,MAAI,YAAY,SAAS;GACvB,OAAO,OAAO,kBAAkB,YAAY,KAAK;AACjD;EACD;;;;EAKD,MAAM,iBAAiB,YAAY,MAAM,OACtC,OACC,CAACC,UACC,MAAM,SAAS,kBAAkB,MAAM,YAAY,WACtD,CACA,IACC,CAACA,UAAoB,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC,EAAE,EAAE,MAAM,SAAS,CACrE,CACA,KAAK,KAAK;AAEb,QAAM,IAAI,MACR,CAAC,YAAY,EAAE,WAAW,KAAK,uDAAuD,EACjF,eAAe,0aAAI,EAad,YAAY,MAAM,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,gBAAW,CACxD;CAEZ;AAGH,QAAO;AACR;;;;;;;AAQD,SAAgB,mBAAmBC,aAA0C;CAC3E,MAAM,qBAAqB,EACzB,UAAUF,MAAE,OAAsB,MAAM,CAAE,EAAC,CAC5C;AAED,KAAI,CAAC,YACH,QAAOA,MAAE,OAAO,mBAAmB;CAGrC,MAAM,EAAE,OAAO,GAAG;CAClB,MAAMG,eAAoC;AAG1C,MAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,aAAa,OAAO,MAAM,UAAU;MAEpC,aAAa,OAAO;AAKxB,QAAOH,MAAE,OAAO,aAAa;AAC9B;;;;;;AAOD,SAAgB,eAAeI,UAAqC;AAClE,QACE,SACG,OACC,CAAC,uDAAwB,QAAQ,IAAK,QAAsB,WAC7D,CACA,IAAI,CAAC,YAAa,QAAsB,WAAyB,CACjE,MAAM,IAAI,CAAE;AAElB;;;;;;AAOD,SAAgB,iBAAiBA,UAAuC;AACtE,QAAO,SACJ,OAAO,CAAC,yDAA0B,QAAQ,CAAC,CAC3C,IAAI,CAAC,aAAa;EACjB,IAAK,QAAwB;EAC7B,QAAS,QAAwB;CAClC,GAAE;AACN"}
+{"version":3,"file":"utils.cjs","names":["middlewareList: readonly AgentMiddleware<any, any, any>[]","state: unknown","middlewareStates: Record<string, any>","modifiedShape: Record<string, any>","z","issue: ZodIssue","stateSchema?: z.ZodObject<z.ZodRawShape>","privateShape: Record<string, any>","messages: BaseMessage[]"],"sources":["../../../../src/agents/middlewareAgent/nodes/utils.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport {\n  type BaseMessage,\n  type ToolMessage,\n  type AIMessage,\n  isToolMessage,\n  isAIMessage,\n} from \"@langchain/core/messages\";\nimport { z, type ZodIssue, type ZodTypeAny } from \"zod/v3\";\n\nimport type { AgentMiddleware, ToolCall, ToolResult } from \"../types.js\";\n\n/**\n * Helper function to initialize middleware state defaults.\n * This is used to ensure all middleware state properties are initialized.\n *\n * Private properties (starting with _) are automatically made optional since\n * users cannot provide them when invoking the agent.\n */\nexport function initializeMiddlewareStates(\n  middlewareList: readonly AgentMiddleware<any, any, any>[],\n  state: unknown\n): Record<string, any> {\n  const middlewareStates: Record<string, any> = {};\n\n  for (const middleware of middlewareList) {\n    if (middleware.stateSchema) {\n      // Create a modified schema where private properties are optional\n      const { shape } = middleware.stateSchema;\n      const modifiedShape: Record<string, any> = {};\n\n      for (const [key, value] of Object.entries(shape)) {\n        if (key.startsWith(\"_\")) {\n          // Make private properties optional\n          modifiedShape[key] = (value as ZodTypeAny).optional();\n        } else {\n          // Keep public properties as-is\n          modifiedShape[key] = value;\n        }\n      }\n\n      const modifiedSchema = z.object(modifiedShape);\n\n      // Use safeParse with the modified schema\n      const parseResult = modifiedSchema.safeParse(state);\n\n      if (parseResult.success) {\n        Object.assign(middlewareStates, parseResult.data);\n        continue;\n      }\n\n      /**\n       * If safeParse fails, there are required public fields missing\n       */\n      const requiredFields = parseResult.error.issues\n        .filter(\n          (issue: ZodIssue) =>\n            issue.code === \"invalid_type\" && issue.message === \"Required\"\n        )\n        .map(\n          (issue: ZodIssue) => `  - ${issue.path.join(\".\")}: ${issue.message}`\n        )\n        .join(\"\\n\");\n\n      throw new Error(\n        `Middleware \"${middleware.name}\" has required state fields that must be initialized:\\n` +\n          `${requiredFields}\\n\\n` +\n          `To fix this, either:\\n` +\n          `1. Provide default values in your middleware's state schema using .default():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().default(\"default value\")\\n` +\n          `   })\\n\\n` +\n          `2. Or make the fields optional using .optional():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().optional()\\n` +\n          `   })\\n\\n` +\n          `3. Or ensure you pass these values when invoking the agent:\\n` +\n          `   agent.invoke({\\n` +\n          `     messages: [...],\\n` +\n          `     ${parseResult.error.issues[0]?.path.join(\".\")}: \"value\"\\n` +\n          `   })`\n      );\n    }\n  }\n\n  return middlewareStates;\n}\n\n/**\n * Users can define private and public state for a middleware. Private state properties start with an underscore.\n * This function will return the private state properties from the state schema, making all of them optional.\n * @param stateSchema - The middleware state schema\n * @returns A new schema containing only the private properties (underscore-prefixed), all made optional\n */\nexport function derivePrivateState(\n  stateSchema?: z.ZodObject<z.ZodRawShape>\n): z.ZodObject<z.ZodRawShape> {\n  const builtInStateSchema = {\n    messages: z.custom<BaseMessage[]>(() => []),\n  };\n\n  if (!stateSchema) {\n    return z.object(builtInStateSchema);\n  }\n\n  const { shape } = stateSchema;\n  const privateShape: Record<string, any> = builtInStateSchema;\n\n  // Filter properties that start with underscore and make them optional\n  for (const [key, value] of Object.entries(shape)) {\n    if (key.startsWith(\"_\")) {\n      // Make the private property optional\n      privateShape[key] = value.optional();\n    } else {\n      privateShape[key] = value;\n    }\n  }\n\n  // Return a new schema with only private properties (all optional)\n  return z.object(privateShape);\n}\n\n/**\n * Parse out all tool calls from the messages\n * @param messages - The messages to parse\n * @returns The tool calls\n */\nexport function parseToolCalls(messages: BaseMessage[]): ToolCall[] {\n  return (\n    messages\n      .filter(\n        (message) => isAIMessage(message) && (message as AIMessage).tool_calls\n      )\n      .map((message) => (message as AIMessage).tool_calls as ToolCall[])\n      .flat() || []\n  );\n}\n\n/**\n * Parse out all tool results from the messages\n * @param messages - The messages to parse\n * @returns The tool results\n */\nexport function parseToolResults(messages: BaseMessage[]): ToolResult[] {\n  return messages\n    .filter((message) => isToolMessage(message))\n    .map((message) => ({\n      id: (message as ToolMessage).tool_call_id,\n      result: (message as ToolMessage).content,\n    }));\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,2BACdA,gBACAC,OACqB;CACrB,MAAMC,mBAAwC,CAAE;AAEhD,MAAK,MAAM,cAAc,eACvB,KAAI,WAAW,aAAa;EAE1B,MAAM,EAAE,OAAO,GAAG,WAAW;EAC7B,MAAMC,gBAAqC,CAAE;AAE7C,OAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,cAAc,OAAQ,MAAqB,UAAU;OAGrD,cAAc,OAAO;EAIzB,MAAM,iBAAiBC,SAAE,OAAO,cAAc;EAG9C,MAAM,cAAc,eAAe,UAAU,MAAM;AAEnD,MAAI,YAAY,SAAS;GACvB,OAAO,OAAO,kBAAkB,YAAY,KAAK;AACjD;EACD;;;;EAKD,MAAM,iBAAiB,YAAY,MAAM,OACtC,OACC,CAACC,UACC,MAAM,SAAS,kBAAkB,MAAM,YAAY,WACtD,CACA,IACC,CAACA,UAAoB,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC,EAAE,EAAE,MAAM,SAAS,CACrE,CACA,KAAK,KAAK;AAEb,QAAM,IAAI,MACR,CAAC,YAAY,EAAE,WAAW,KAAK,uDAAuD,EACjF,eAAe,0aAAI,EAad,YAAY,MAAM,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,gBAAW,CACxD;CAEZ;AAGH,QAAO;AACR;;;;;;;AAQD,SAAgB,mBACdC,aAC4B;CAC5B,MAAM,qBAAqB,EACzB,UAAUF,SAAE,OAAsB,MAAM,CAAE,EAAC,CAC5C;AAED,KAAI,CAAC,YACH,QAAOA,SAAE,OAAO,mBAAmB;CAGrC,MAAM,EAAE,OAAO,GAAG;CAClB,MAAMG,eAAoC;AAG1C,MAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,aAAa,OAAO,MAAM,UAAU;MAEpC,aAAa,OAAO;AAKxB,QAAOH,SAAE,OAAO,aAAa;AAC9B;;;;;;AAOD,SAAgB,eAAeI,UAAqC;AAClE,QACE,SACG,OACC,CAAC,uDAAwB,QAAQ,IAAK,QAAsB,WAC7D,CACA,IAAI,CAAC,YAAa,QAAsB,WAAyB,CACjE,MAAM,IAAI,CAAE;AAElB;;;;;;AAOD,SAAgB,iBAAiBA,UAAuC;AACtE,QAAO,SACJ,OAAO,CAAC,yDAA0B,QAAQ,CAAC,CAC3C,IAAI,CAAC,aAAa;EACjB,IAAK,QAAwB;EAC7B,QAAS,QAAwB;CAClC,GAAE;AACN"}

package/dist/agents/middlewareAgent/nodes/utils.js

@@ -1,5 +1,5 @@
 import { isAIMessage, isToolMessage } from "@langchain/core/messages";
-import { z } from "zod";
+import { z } from "zod/v3";
 
 //#region src/agents/middlewareAgent/nodes/utils.ts
 /**
@@ -9,9 +9,9 @@ import { z } from "zod";
 * Private properties (starting with _) are automatically made optional since
 * users cannot provide them when invoking the agent.
 */
-function initializeMiddlewareStates(middlewares, state) {
+function initializeMiddlewareStates(middlewareList, state) {
 	const middlewareStates = {};
-	for (const middleware of middlewares) if (middleware.stateSchema) {
+	for (const middleware of middlewareList) if (middleware.stateSchema) {
 		const { shape } = middleware.stateSchema;
 		const modifiedShape = {};
 		for (const [key, value] of Object.entries(shape)) if (key.startsWith("_")) modifiedShape[key] = value.optional();

package/dist/agents/middlewareAgent/nodes/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["middlewares: readonly AgentMiddleware<any, any, any>[]","state: unknown","middlewareStates: Record<string, any>","modifiedShape: Record<string, any>","issue: ZodIssue","stateSchema?: z.ZodObject<z.ZodRawShape>","privateShape: Record<string, any>","messages: BaseMessage[]"],"sources":["../../../../src/agents/middlewareAgent/nodes/utils.ts"],"sourcesContent":["import {\n  type BaseMessage,\n  type ToolMessage,\n  type AIMessage,\n  isToolMessage,\n  isAIMessage,\n} from \"@langchain/core/messages\";\nimport { z, type ZodIssue, type ZodTypeAny } from \"zod\";\n\nimport type { AgentMiddleware, ToolCall, ToolResult } from \"../types.js\";\n\n/**\n * Helper function to initialize middleware state defaults.\n * This is used to ensure all middleware state properties are initialized.\n *\n * Private properties (starting with _) are automatically made optional since\n * users cannot provide them when invoking the agent.\n */\nexport function initializeMiddlewareStates(\n  middlewares: readonly AgentMiddleware<any, any, any>[],\n  state: unknown\n): Record<string, any> {\n  const middlewareStates: Record<string, any> = {};\n\n  for (const middleware of middlewares) {\n    if (middleware.stateSchema) {\n      // Create a modified schema where private properties are optional\n      const { shape } = middleware.stateSchema;\n      const modifiedShape: Record<string, any> = {};\n\n      for (const [key, value] of Object.entries(shape)) {\n        if (key.startsWith(\"_\")) {\n          // Make private properties optional\n          modifiedShape[key] = (value as ZodTypeAny).optional();\n        } else {\n          // Keep public properties as-is\n          modifiedShape[key] = value;\n        }\n      }\n\n      const modifiedSchema = z.object(modifiedShape);\n\n      // Use safeParse with the modified schema\n      const parseResult = modifiedSchema.safeParse(state);\n\n      if (parseResult.success) {\n        Object.assign(middlewareStates, parseResult.data);\n        continue;\n      }\n\n      /**\n       * If safeParse fails, there are required public fields missing\n       */\n      const requiredFields = parseResult.error.issues\n        .filter(\n          (issue: ZodIssue) =>\n            issue.code === \"invalid_type\" && issue.message === \"Required\"\n        )\n        .map(\n          (issue: ZodIssue) => `  - ${issue.path.join(\".\")}: ${issue.message}`\n        )\n        .join(\"\\n\");\n\n      throw new Error(\n        `Middleware \"${middleware.name}\" has required state fields that must be initialized:\\n` +\n          `${requiredFields}\\n\\n` +\n          `To fix this, either:\\n` +\n          `1. Provide default values in your middleware's state schema using .default():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().default(\"default value\")\\n` +\n          `   })\\n\\n` +\n          `2. Or make the fields optional using .optional():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().optional()\\n` +\n          `   })\\n\\n` +\n          `3. Or ensure you pass these values when invoking the agent:\\n` +\n          `   agent.invoke({\\n` +\n          `     messages: [...],\\n` +\n          `     ${parseResult.error.issues[0]?.path.join(\".\")}: \"value\"\\n` +\n          `   })`\n      );\n    }\n  }\n\n  return middlewareStates;\n}\n\n/**\n * Users can define private and public state for a middleware. Private state properties start with an underscore.\n * This function will return the private state properties from the state schema, making all of them optional.\n * @param stateSchema - The middleware state schema\n * @returns A new schema containing only the private properties (underscore-prefixed), all made optional\n */\nexport function derivePrivateState(stateSchema?: z.ZodObject<z.ZodRawShape>) {\n  const builtInStateSchema = {\n    messages: z.custom<BaseMessage[]>(() => []),\n  };\n\n  if (!stateSchema) {\n    return z.object(builtInStateSchema);\n  }\n\n  const { shape } = stateSchema;\n  const privateShape: Record<string, any> = builtInStateSchema;\n\n  // Filter properties that start with underscore and make them optional\n  for (const [key, value] of Object.entries(shape)) {\n    if (key.startsWith(\"_\")) {\n      // Make the private property optional\n      privateShape[key] = value.optional();\n    } else {\n      privateShape[key] = value;\n    }\n  }\n\n  // Return a new schema with only private properties (all optional)\n  return z.object(privateShape);\n}\n\n/**\n * Parse out all tool calls from the messages\n * @param messages - The messages to parse\n * @returns The tool calls\n */\nexport function parseToolCalls(messages: BaseMessage[]): ToolCall[] {\n  return (\n    messages\n      .filter(\n        (message) => isAIMessage(message) && (message as AIMessage).tool_calls\n      )\n      .map((message) => (message as AIMessage).tool_calls as ToolCall[])\n      .flat() || []\n  );\n}\n\n/**\n * Parse out all tool results from the messages\n * @param messages - The messages to parse\n * @returns The tool results\n */\nexport function parseToolResults(messages: BaseMessage[]): ToolResult[] {\n  return messages\n    .filter((message) => isToolMessage(message))\n    .map((message) => ({\n      id: (message as ToolMessage).tool_call_id,\n      result: (message as ToolMessage).content,\n    }));\n}\n"],"mappings":";;;;;;;;;;;AAkBA,SAAgB,2BACdA,aACAC,OACqB;CACrB,MAAMC,mBAAwC,CAAE;AAEhD,MAAK,MAAM,cAAc,YACvB,KAAI,WAAW,aAAa;EAE1B,MAAM,EAAE,OAAO,GAAG,WAAW;EAC7B,MAAMC,gBAAqC,CAAE;AAE7C,OAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,cAAc,OAAQ,MAAqB,UAAU;OAGrD,cAAc,OAAO;EAIzB,MAAM,iBAAiB,EAAE,OAAO,cAAc;EAG9C,MAAM,cAAc,eAAe,UAAU,MAAM;AAEnD,MAAI,YAAY,SAAS;GACvB,OAAO,OAAO,kBAAkB,YAAY,KAAK;AACjD;EACD;;;;EAKD,MAAM,iBAAiB,YAAY,MAAM,OACtC,OACC,CAACC,UACC,MAAM,SAAS,kBAAkB,MAAM,YAAY,WACtD,CACA,IACC,CAACA,UAAoB,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC,EAAE,EAAE,MAAM,SAAS,CACrE,CACA,KAAK,KAAK;AAEb,QAAM,IAAI,MACR,CAAC,YAAY,EAAE,WAAW,KAAK,uDAAuD,EACjF,eAAe,0aAAI,EAad,YAAY,MAAM,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,gBAAW,CACxD;CAEZ;AAGH,QAAO;AACR;;;;;;;AAQD,SAAgB,mBAAmBC,aAA0C;CAC3E,MAAM,qBAAqB,EACzB,UAAU,EAAE,OAAsB,MAAM,CAAE,EAAC,CAC5C;AAED,KAAI,CAAC,YACH,QAAO,EAAE,OAAO,mBAAmB;CAGrC,MAAM,EAAE,OAAO,GAAG;CAClB,MAAMC,eAAoC;AAG1C,MAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,aAAa,OAAO,MAAM,UAAU;MAEpC,aAAa,OAAO;AAKxB,QAAO,EAAE,OAAO,aAAa;AAC9B;;;;;;AAOD,SAAgB,eAAeC,UAAqC;AAClE,QACE,SACG,OACC,CAAC,YAAY,YAAY,QAAQ,IAAK,QAAsB,WAC7D,CACA,IAAI,CAAC,YAAa,QAAsB,WAAyB,CACjE,MAAM,IAAI,CAAE;AAElB;;;;;;AAOD,SAAgB,iBAAiBA,UAAuC;AACtE,QAAO,SACJ,OAAO,CAAC,YAAY,cAAc,QAAQ,CAAC,CAC3C,IAAI,CAAC,aAAa;EACjB,IAAK,QAAwB;EAC7B,QAAS,QAAwB;CAClC,GAAE;AACN"}
+{"version":3,"file":"utils.js","names":["middlewareList: readonly AgentMiddleware<any, any, any>[]","state: unknown","middlewareStates: Record<string, any>","modifiedShape: Record<string, any>","issue: ZodIssue","stateSchema?: z.ZodObject<z.ZodRawShape>","privateShape: Record<string, any>","messages: BaseMessage[]"],"sources":["../../../../src/agents/middlewareAgent/nodes/utils.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport {\n  type BaseMessage,\n  type ToolMessage,\n  type AIMessage,\n  isToolMessage,\n  isAIMessage,\n} from \"@langchain/core/messages\";\nimport { z, type ZodIssue, type ZodTypeAny } from \"zod/v3\";\n\nimport type { AgentMiddleware, ToolCall, ToolResult } from \"../types.js\";\n\n/**\n * Helper function to initialize middleware state defaults.\n * This is used to ensure all middleware state properties are initialized.\n *\n * Private properties (starting with _) are automatically made optional since\n * users cannot provide them when invoking the agent.\n */\nexport function initializeMiddlewareStates(\n  middlewareList: readonly AgentMiddleware<any, any, any>[],\n  state: unknown\n): Record<string, any> {\n  const middlewareStates: Record<string, any> = {};\n\n  for (const middleware of middlewareList) {\n    if (middleware.stateSchema) {\n      // Create a modified schema where private properties are optional\n      const { shape } = middleware.stateSchema;\n      const modifiedShape: Record<string, any> = {};\n\n      for (const [key, value] of Object.entries(shape)) {\n        if (key.startsWith(\"_\")) {\n          // Make private properties optional\n          modifiedShape[key] = (value as ZodTypeAny).optional();\n        } else {\n          // Keep public properties as-is\n          modifiedShape[key] = value;\n        }\n      }\n\n      const modifiedSchema = z.object(modifiedShape);\n\n      // Use safeParse with the modified schema\n      const parseResult = modifiedSchema.safeParse(state);\n\n      if (parseResult.success) {\n        Object.assign(middlewareStates, parseResult.data);\n        continue;\n      }\n\n      /**\n       * If safeParse fails, there are required public fields missing\n       */\n      const requiredFields = parseResult.error.issues\n        .filter(\n          (issue: ZodIssue) =>\n            issue.code === \"invalid_type\" && issue.message === \"Required\"\n        )\n        .map(\n          (issue: ZodIssue) => `  - ${issue.path.join(\".\")}: ${issue.message}`\n        )\n        .join(\"\\n\");\n\n      throw new Error(\n        `Middleware \"${middleware.name}\" has required state fields that must be initialized:\\n` +\n          `${requiredFields}\\n\\n` +\n          `To fix this, either:\\n` +\n          `1. Provide default values in your middleware's state schema using .default():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().default(\"default value\")\\n` +\n          `   })\\n\\n` +\n          `2. Or make the fields optional using .optional():\\n` +\n          `   stateSchema: z.object({\\n` +\n          `     myField: z.string().optional()\\n` +\n          `   })\\n\\n` +\n          `3. Or ensure you pass these values when invoking the agent:\\n` +\n          `   agent.invoke({\\n` +\n          `     messages: [...],\\n` +\n          `     ${parseResult.error.issues[0]?.path.join(\".\")}: \"value\"\\n` +\n          `   })`\n      );\n    }\n  }\n\n  return middlewareStates;\n}\n\n/**\n * Users can define private and public state for a middleware. Private state properties start with an underscore.\n * This function will return the private state properties from the state schema, making all of them optional.\n * @param stateSchema - The middleware state schema\n * @returns A new schema containing only the private properties (underscore-prefixed), all made optional\n */\nexport function derivePrivateState(\n  stateSchema?: z.ZodObject<z.ZodRawShape>\n): z.ZodObject<z.ZodRawShape> {\n  const builtInStateSchema = {\n    messages: z.custom<BaseMessage[]>(() => []),\n  };\n\n  if (!stateSchema) {\n    return z.object(builtInStateSchema);\n  }\n\n  const { shape } = stateSchema;\n  const privateShape: Record<string, any> = builtInStateSchema;\n\n  // Filter properties that start with underscore and make them optional\n  for (const [key, value] of Object.entries(shape)) {\n    if (key.startsWith(\"_\")) {\n      // Make the private property optional\n      privateShape[key] = value.optional();\n    } else {\n      privateShape[key] = value;\n    }\n  }\n\n  // Return a new schema with only private properties (all optional)\n  return z.object(privateShape);\n}\n\n/**\n * Parse out all tool calls from the messages\n * @param messages - The messages to parse\n * @returns The tool calls\n */\nexport function parseToolCalls(messages: BaseMessage[]): ToolCall[] {\n  return (\n    messages\n      .filter(\n        (message) => isAIMessage(message) && (message as AIMessage).tool_calls\n      )\n      .map((message) => (message as AIMessage).tool_calls as ToolCall[])\n      .flat() || []\n  );\n}\n\n/**\n * Parse out all tool results from the messages\n * @param messages - The messages to parse\n * @returns The tool results\n */\nexport function parseToolResults(messages: BaseMessage[]): ToolResult[] {\n  return messages\n    .filter((message) => isToolMessage(message))\n    .map((message) => ({\n      id: (message as ToolMessage).tool_call_id,\n      result: (message as ToolMessage).content,\n    }));\n}\n"],"mappings":";;;;;;;;;;;AAmBA,SAAgB,2BACdA,gBACAC,OACqB;CACrB,MAAMC,mBAAwC,CAAE;AAEhD,MAAK,MAAM,cAAc,eACvB,KAAI,WAAW,aAAa;EAE1B,MAAM,EAAE,OAAO,GAAG,WAAW;EAC7B,MAAMC,gBAAqC,CAAE;AAE7C,OAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,cAAc,OAAQ,MAAqB,UAAU;OAGrD,cAAc,OAAO;EAIzB,MAAM,iBAAiB,EAAE,OAAO,cAAc;EAG9C,MAAM,cAAc,eAAe,UAAU,MAAM;AAEnD,MAAI,YAAY,SAAS;GACvB,OAAO,OAAO,kBAAkB,YAAY,KAAK;AACjD;EACD;;;;EAKD,MAAM,iBAAiB,YAAY,MAAM,OACtC,OACC,CAACC,UACC,MAAM,SAAS,kBAAkB,MAAM,YAAY,WACtD,CACA,IACC,CAACA,UAAoB,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC,EAAE,EAAE,MAAM,SAAS,CACrE,CACA,KAAK,KAAK;AAEb,QAAM,IAAI,MACR,CAAC,YAAY,EAAE,WAAW,KAAK,uDAAuD,EACjF,eAAe,0aAAI,EAad,YAAY,MAAM,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,gBAAW,CACxD;CAEZ;AAGH,QAAO;AACR;;;;;;;AAQD,SAAgB,mBACdC,aAC4B;CAC5B,MAAM,qBAAqB,EACzB,UAAU,EAAE,OAAsB,MAAM,CAAE,EAAC,CAC5C;AAED,KAAI,CAAC,YACH,QAAO,EAAE,OAAO,mBAAmB;CAGrC,MAAM,EAAE,OAAO,GAAG;CAClB,MAAMC,eAAoC;AAG1C,MAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,MAAM,CAC9C,KAAI,IAAI,WAAW,IAAI,EAErB,aAAa,OAAO,MAAM,UAAU;MAEpC,aAAa,OAAO;AAKxB,QAAO,EAAE,OAAO,aAAa;AAC9B;;;;;;AAOD,SAAgB,eAAeC,UAAqC;AAClE,QACE,SACG,OACC,CAAC,YAAY,YAAY,QAAQ,IAAK,QAAsB,WAC7D,CACA,IAAI,CAAC,YAAa,QAAsB,WAAyB,CACjE,MAAM,IAAI,CAAE;AAElB;;;;;;AAOD,SAAgB,iBAAiBA,UAAuC;AACtE,QAAO,SACJ,OAAO,CAAC,YAAY,cAAc,QAAQ,CAAC,CAC3C,IAAI,CAAC,aAAa;EACjB,IAAK,QAAwB;EAC7B,QAAS,QAAwB;CAClC,GAAE;AACN"}

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

@@ -3,7 +3,7 @@ import { AnyAnnotationRoot, PreHookAnnotation, ToAnnotationRoot } from "../annot
 import { ToolNode } from "../nodes/ToolNode.cjs";
 import { AgentRuntime, ClientTool, ServerTool } from "../types.cjs";
 import { LanguageModelLike } from "@langchain/core/language_models/base";
-import { z } from "zod";
+import { z } from "zod/v3";
 import { InferInteropZodInput, InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
 import { LangGraphRunnableConfig, START } from "@langchain/langgraph";
 import { BaseMessage, BaseMessageLike, SystemMessage } from "@langchain/core/messages";
@@ -49,12 +49,6 @@ interface ToolResult {
    */
   error?: string;
 }
-interface AnthropicModelSettings {
-  cache_control: {
-    type: string;
-    ttl: string;
-  };
-}
 /**
  * Configuration for modifying a model call at runtime.
  * All fields are optional and only provided fields will override defaults.
@@ -91,11 +85,6 @@ interface ModelRequest {
    * Can be tool names (strings) or tool instances.
    */
   tools: (ClientTool | ServerTool)[];
-  /**
-   * The model settings to use for this step.
-   * Currently only supported for Anthropic models.
-   */
-  modelSettings?: AnthropicModelSettings | Record<string, any>;
 }
 /**
  * Runtime information available to middleware (readonly).
@@ -152,15 +141,15 @@ type InferMiddlewareState<T extends AgentMiddleware<any, any, any>> = T extends
  */
 type InferMiddlewareInputState<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<infer S, any, any> ? S extends z.ZodObject<any> ? FilterPrivateProps<z.input<S>> : {} : {};
 /**
- * Helper type to infer merged state from an array of middlewares (just the middleware states)
+ * Helper type to infer merged state from an array of middleware (just the middleware states)
  */
 type InferMiddlewareStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareState<First> & InferMiddlewareStates<Rest> : InferMiddlewareState<First> : {} : {};
 /**
- * Helper type to infer merged input state from an array of middlewares (with optional defaults)
+ * Helper type to infer merged input state from an array of middleware (with optional defaults)
  */
 type InferMiddlewareInputStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareInputState<First> & InferMiddlewareInputStates<Rest> : InferMiddlewareInputState<First> : {} : {};
 /**
- * Helper type to infer merged state from an array of middlewares (includes built-in state)
+ * Helper type to infer merged state from an array of middleware (includes built-in state)
  */
 
 /**
@@ -168,11 +157,11 @@ type InferMiddlewareInputStates<T extends readonly AgentMiddleware<any, any, any
  */
 type InferMiddlewareContextInput<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<any, infer C, any> ? C extends z.ZodObject<any> ? z.input<C> : {} : {};
 /**
- * Helper type to infer merged context from an array of middlewares
+ * Helper type to infer merged context from an array of middleware
  */
 
 /**
- * Helper type to infer merged input context from an array of middlewares (with optional defaults)
+ * Helper type to infer merged input context from an array of middleware (with optional defaults)
  */
 type InferMiddlewareContextInputs<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareContextInput<First> & InferMiddlewareContextInputs<Rest> : InferMiddlewareContextInput<First> : {} : {};
 /**
@@ -204,9 +193,7 @@ interface AgentMiddleware<TSchema extends z.ZodObject<z.ZodRawShape> | undefined
  */
 type Prompt<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = SystemMessage | string | ((state: AgentBuiltInState, config: LangGraphRunnableConfig<ToAnnotationRoot<ContextSchema>["State"]>) => BaseMessageLike[] | Promise<BaseMessageLike[]>) | Runnable;
 type DynamicLLMFunction<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = (state: AgentBuiltInState & PreHookAnnotation["State"], runtime: AgentRuntime<ToAnnotationRoot<ContextSchema>["State"]>) => Promise<LanguageModelLike> | LanguageModelLike;
-type CreateAgentParams<
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-StructuredResponseType extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, ResponseFormatType = InteropZodType<StructuredResponseType> | InteropZodType<unknown>[] | JsonSchemaFormat | JsonSchemaFormat[] | ResponseFormat | TypedToolStrategy<StructuredResponseType> | ToolStrategy<StructuredResponseType> | ProviderStrategy<StructuredResponseType> | ResponseFormatUndefined> = {
+type CreateAgentParams<StructuredResponseType extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, ResponseFormatType = InteropZodType<StructuredResponseType> | InteropZodType<unknown>[] | JsonSchemaFormat | JsonSchemaFormat[] | ResponseFormat | TypedToolStrategy<StructuredResponseType> | ToolStrategy<StructuredResponseType> | ProviderStrategy<StructuredResponseType> | ResponseFormatUndefined> = {
   /** The chat model that can utilize OpenAI-style tool calling. */
   llm?: LanguageModelLike | DynamicLLMFunction<ContextSchema>;
   /**
@@ -244,7 +231,7 @@ StructuredResponseType extends Record<string, any> = Record<string, any>, Contex
   prompt?: Prompt<ContextSchema>;
   /**
    * An optional schema for the context. It allows to pass in a typed context object into the agent
-   * invocation and allows to access it in hooks such as `prompt` and middlewares.
+   * invocation and allows to access it in hooks such as `prompt` and middleware.
    * As opposed to the agent state, defined in `stateSchema`, the context is not persisted between
    * agent invocations.
    *
@@ -340,10 +327,10 @@ StructuredResponseType extends Record<string, any> = Record<string, any>, Contex
    */
   responseFormat?: ResponseFormatType;
   /**
-   * Middlewares to run during agent execution.
+   * Middleware instances to run during agent execution.
    * Each middleware can define its own state schema and hook into the agent lifecycle.
    */
-  middlewares?: readonly AgentMiddleware<any, any, any>[];
+  middleware?: readonly AgentMiddleware<any, any, any>[];
   /**
    * An optional name for the agent.
    */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":["z","InteropZodObject","InteropZodType","InferInteropZodInput","LangGraphRunnableConfig","START","LanguageModelLike","SystemMessage","BaseMessageLike","BaseMessage","All","BaseCheckpointSaver","BaseStore","Runnable","PreHookAnnotation","AnyAnnotationRoot","ToAnnotationRoot","ResponseFormat","ToolStrategy","TypedToolStrategy","ProviderStrategy","ResponseFormatUndefined","JsonSchemaFormat","ToolNode","ClientTool","ServerTool","AgentRuntime","N","BuiltInState","ToolCall","Record","ToolResult","AnthropicModelSettings","ModelRequest","Runtime","TContext","Controls","TState","Partial","ControlAction","Error","TStateSchema","MiddlewareResult","AgentBuiltInState","FilterPrivateProps","T","K","InferMiddlewareState","AgentMiddleware","S","ZodObject","infer","InferMiddlewareInputState","input","InferMiddlewareStates","First","Rest","InferMiddlewareInputStates","InferMergedState","InferMergedInputState","InferMiddlewareContext","C","InferMiddlewareContextInput","InferMiddlewareContexts","InferMiddlewareContextInputs","ZodRawShape","TSchema","TContextSchema","TFullContext","Promise","ExecutedToolCall","LLMCall","Prompt","ContextSchema","DynamicLLMFunction","CreateAgentParams","StructuredResponseType","ResponseFormatType","AbortSignal","IsAllOptional","InferContextInput","InferAgentConfig","TMiddlewares","InternalAgentState"],"sources":["../../../src/agents/middlewareAgent/types.d.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport { z } from \"zod\";\nimport type { InteropZodObject, InteropZodType, InferInteropZodInput } from \"@langchain/core/utils/types\";\nimport type { LangGraphRunnableConfig, START } from \"@langchain/langgraph\";\nimport type { LanguageModelLike } from \"@langchain/core/language_models/base\";\nimport type { SystemMessage, BaseMessageLike, BaseMessage } from \"@langchain/core/messages\";\nimport type { All, BaseCheckpointSaver, BaseStore } from \"@langchain/langgraph-checkpoint\";\nimport type { Runnable } from \"@langchain/core/runnables\";\nimport type { PreHookAnnotation, AnyAnnotationRoot, ToAnnotationRoot } from \"../annotation.js\";\nimport type { ResponseFormat, ToolStrategy, TypedToolStrategy, ProviderStrategy, ResponseFormatUndefined, JsonSchemaFormat } from \"../responses.js\";\nimport type { ToolNode } from \"../nodes/ToolNode.js\";\nimport type { ClientTool, ServerTool, AgentRuntime } from \"../types.js\";\nexport type N = typeof START | \"model_request\" | \"tools\";\nexport interface BuiltInState {\n    messages: BaseMessage[];\n}\n/**\n * Information about a tool call that has been executed.\n */\nexport interface ToolCall {\n    /**\n     * The ID of the tool call.\n     */\n    id: string;\n    /**\n     * The name of the tool that was called.\n     */\n    name: string;\n    /**\n     * The arguments that were passed to the tool.\n     */\n    args: Record<string, any>;\n}\n/**\n * Information about a tool result from a tool execution.\n */\nexport interface ToolResult {\n    /**\n     * The ID of the tool call.\n     */\n    id: string;\n    /**\n     * The result of the tool call.\n     */\n    result: any;\n    /**\n     * An optional error message if the tool call failed.\n     */\n    error?: string;\n}\nexport interface AnthropicModelSettings {\n    cache_control: {\n        type: string;\n        ttl: string;\n    };\n}\n/**\n * Configuration for modifying a model call at runtime.\n * All fields are optional and only provided fields will override defaults.\n */\nexport interface ModelRequest {\n    /**\n     * The model to use for this step.\n     */\n    model: LanguageModelLike;\n    /**\n     * The messages to send to the model.\n     */\n    messages: BaseMessage[];\n    /**\n     * The system message for this step.\n     */\n    systemMessage?: BaseMessage;\n    /**\n     * Tool choice configuration (model-specific format).\n     * Can be one of:\n     * - `\"auto\"`: means the model can pick between generating a message or calling one or more tools.\n     * - `\"none\"`: means the model will not call any tool and instead generates a message.\n     * - `\"required\"`: means the model must call one or more tools.\n     * - `{ type: \"function\", function: { name: string } }`: The model will use the specified function.\n     */\n    toolChoice?: \"auto\" | \"none\" | \"required\" | {\n        type: \"function\";\n        function: {\n            name: string;\n        };\n    };\n    /**\n     * The tools to make available for this step.\n     * Can be tool names (strings) or tool instances.\n     */\n    tools: (ClientTool | ServerTool)[];\n    /**\n     * The model settings to use for this step.\n     * Currently only supported for Anthropic models.\n     */\n    modelSettings?: AnthropicModelSettings | Record<string, any>;\n}\n/**\n * Runtime information available to middleware (readonly).\n */\nexport interface Runtime<TContext = unknown> {\n    readonly toolCalls: ToolCall[];\n    readonly toolResults: ToolResult[];\n    // readonly tokenUsage: {\n    //   readonly inputTokens: number;\n    //   readonly outputTokens: number;\n    //   readonly totalTokens: number;\n    // };\n    readonly context: TContext;\n}\n/**\n * Control flow interface for middleware.\n */\nexport interface Controls<TState = unknown> {\n    jumpTo(target: \"model\" | \"tools\", stateUpdate?: Partial<TState>): ControlAction<TState>;\n    terminate(result?: Partial<TState> | Error): ControlAction<TState>;\n}\n/**\n * Control action type returned by control methods.\n */\nexport type ControlAction<TStateSchema> = {\n    type: \"jump\" | \"terminate\" | \"retry\";\n    target?: string;\n    stateUpdate?: Partial<TStateSchema>;\n    result?: any;\n    error?: Error;\n};\n/**\n * Result type for middleware functions.\n */\nexport type MiddlewareResult<TState> = TState | void;\n/**\n * Type for the agent's built-in state properties.\n */\nexport type AgentBuiltInState = {\n    messages: BaseMessage[];\n};\n/**\n * Helper type to filter out properties that start with underscore (private properties)\n */\ntype FilterPrivateProps<T> = {\n    [K in keyof T as K extends `_${string}` ? never : K]: T[K];\n};\n/**\n * Helper type to infer the state schema type from a middleware\n * This filters out private properties (those starting with underscore)\n */\nexport type InferMiddlewareState<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<infer S, any, any> ? S extends z.ZodObject<any> ? FilterPrivateProps<z.infer<S>> : {} : {};\n/**\n * Helper type to infer the input state schema type from a middleware (all properties optional)\n * This filters out private properties (those starting with underscore)\n */\nexport type InferMiddlewareInputState<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<infer S, any, any> ? S extends z.ZodObject<any> ? FilterPrivateProps<z.input<S>> : {} : {};\n/**\n * Helper type to infer merged state from an array of middlewares (just the middleware states)\n */\nexport type InferMiddlewareStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareState<First> & InferMiddlewareStates<Rest> : InferMiddlewareState<First> : {} : {};\n/**\n * Helper type to infer merged input state from an array of middlewares (with optional defaults)\n */\nexport type InferMiddlewareInputStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareInputState<First> & InferMiddlewareInputStates<Rest> : InferMiddlewareInputState<First> : {} : {};\n/**\n * Helper type to infer merged state from an array of middlewares (includes built-in state)\n */\nexport type InferMergedState<T extends readonly AgentMiddleware<any, any, any>[]> = InferMiddlewareStates<T> & AgentBuiltInState;\n/**\n * Helper type to infer merged input state from an array of middlewares (includes built-in state)\n */\nexport type InferMergedInputState<T extends readonly AgentMiddleware<any, any, any>[]> = InferMiddlewareInputStates<T> & AgentBuiltInState;\n/**\n * Helper type to infer the context schema type from a middleware\n */\nexport type InferMiddlewareContext<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<any, infer C, any> ? C extends z.ZodObject<any> ? z.infer<C> : {} : {};\n/**\n * Helper type to infer the input context schema type from a middleware (with optional defaults)\n */\nexport type InferMiddlewareContextInput<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<any, infer C, any> ? C extends z.ZodObject<any> ? z.input<C> : {} : {};\n/**\n * Helper type to infer merged context from an array of middlewares\n */\nexport type InferMiddlewareContexts<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareContext<First> & InferMiddlewareContexts<Rest> : InferMiddlewareContext<First> : {} : {};\n/**\n * Helper type to infer merged input context from an array of middlewares (with optional defaults)\n */\nexport type InferMiddlewareContextInputs<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareContextInput<First> & InferMiddlewareContextInputs<Rest> : InferMiddlewareContextInput<First> : {} : {};\n/**\n * Base middleware interface.\n */\nexport interface AgentMiddleware<TSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined, TContextSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined, TFullContext = any> {\n    stateSchema?: TSchema;\n    contextSchema?: TContextSchema;\n    name: string;\n    /**\n     * Runs before each LLM call, can modify call parameters, changes are not persistent\n     * e.g. if you change `model`, it will only be changed for the next model call\n     *\n     * @param options - Current call options (can be modified by previous middleware)\n     * @param state - Current state (read-only in this phase)\n     * @param runtime - Runtime context and metadata\n     * @returns Modified options or undefined to pass through\n     */\n    prepareModelRequest?(request: ModelRequest, state: (TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState, runtime: Runtime<TFullContext>): Promise<Partial<ModelRequest> | void> | Partial<ModelRequest> | void;\n    beforeModel?(state: (TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState, runtime: Runtime<TFullContext>, controls: Controls<(TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState>): Promise<MiddlewareResult<Partial<TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}>>>;\n    afterModel?(state: (TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState, runtime: Runtime<TFullContext>, controls: Controls<(TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState>): Promise<MiddlewareResult<Partial<TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}>>>;\n}\n/**\n * Information about a tool call that has been executed.\n */\nexport interface ExecutedToolCall {\n    /**\n     * The name of the tool that was called.\n     */\n    name: string;\n    /**\n     * The arguments that were passed to the tool.\n     */\n    args: Record<string, unknown>;\n    /**\n     * The ID of the tool call.\n     */\n    tool_id: string;\n    /**\n     * The result of the tool call (if available).\n     */\n    result?: unknown;\n}\n/**\n * Information about an LLM invocation.\n */\nexport interface LLMCall {\n    /**\n     * The messages that were sent to the LLM.\n     */\n    messages: BaseMessage[];\n    /**\n     * The response from the LLM.\n     */\n    response?: BaseMessage;\n}\n/**\n * Duplicate of the Prompt type from ../types.ts\n */\nexport type Prompt<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = SystemMessage | string | ((state: AgentBuiltInState, config: LangGraphRunnableConfig<ToAnnotationRoot<ContextSchema>[\"State\"]>) => BaseMessageLike[] | Promise<BaseMessageLike[]>) | Runnable;\nexport type DynamicLLMFunction<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = (state: AgentBuiltInState & PreHookAnnotation[\"State\"], runtime: AgentRuntime<ToAnnotationRoot<ContextSchema>[\"State\"]>) => Promise<LanguageModelLike> | LanguageModelLike;\nexport type CreateAgentParams<\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nStructuredResponseType extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, ResponseFormatType = InteropZodType<StructuredResponseType> | InteropZodType<unknown>[] | JsonSchemaFormat | JsonSchemaFormat[] | ResponseFormat | TypedToolStrategy<StructuredResponseType> | ToolStrategy<StructuredResponseType> | ProviderStrategy<StructuredResponseType> | ResponseFormatUndefined> = {\n    /** The chat model that can utilize OpenAI-style tool calling. */\n    llm?: LanguageModelLike | DynamicLLMFunction<ContextSchema>;\n    /**\n     * Initializes a ChatModel based on the provided model name and provider.\n     * It supports various model providers and allows for runtime configuration of model parameters.\n     *\n     * @uses {@link initChatModel}\n     * @example\n     * ```ts\n     * const agent = createAgent({\n     *   model: \"anthropic:claude-3-7-sonnet-latest\",\n     *   // ...\n     * });\n     * ```\n     */\n    model?: string;\n    /** A list of tools or a ToolNode. */\n    tools?: ToolNode | (ServerTool | ClientTool)[];\n    /**\n     * An optional prompt for the LLM. This takes full graph state BEFORE the LLM is called and prepares the input to LLM.\n     *\n     * Can take a few different forms:\n     *\n     * - str: This is converted to a SystemMessage and added to the beginning of the list of messages in state[\"messages\"].\n     * - SystemMessage: this is added to the beginning of the list of messages in state[\"messages\"].\n     * - Function: This function should take in full graph state and the output is then passed to the language model.\n     * - Runnable: This runnable should take in full graph state and the output is then passed to the language model.\n     *\n     * Note:\n     * Prior to `v0.2.46`, the prompt was set using `stateModifier` / `messagesModifier` parameters.\n     * This is now deprecated and will be removed in a future release.\n     *\n     * Cannot be used together with `prepareModelRequest`.\n     */\n    prompt?: Prompt<ContextSchema>;\n    /**\n     * An optional schema for the context. It allows to pass in a typed context object into the agent\n     * invocation and allows to access it in hooks such as `prompt` and middlewares.\n     * As opposed to the agent state, defined in `stateSchema`, the context is not persisted between\n     * agent invocations.\n     *\n     * @example\n     * ```ts\n     * const agent = createAgent({\n     *   llm: model,\n     *   tools: [getWeather],\n     *   contextSchema: z.object({\n     *     capital: z.string(),\n     *   }),\n     *   prompt: (state, config) => {\n     *     return [\n     *       new SystemMessage(`You are a helpful assistant. The capital of France is ${config.context.capital}.`),\n     *     ];\n     *   },\n     * });\n     *\n     * const result = await agent.invoke({\n     *   messages: [\n     *     new SystemMessage(\"You are a helpful assistant.\"),\n     *     new HumanMessage(\"What is the capital of France?\"),\n     *   ],\n     * }, {\n     *   context: {\n     *     capital: \"Paris\",\n     *   },\n     * });\n     * ```\n     */\n    contextSchema?: ContextSchema;\n    /** An optional checkpoint saver to persist the agent's state. */\n    checkpointSaver?: BaseCheckpointSaver | boolean;\n    /** An optional checkpoint saver to persist the agent's state. Alias of \"checkpointSaver\". */\n    checkpointer?: BaseCheckpointSaver | boolean;\n    /** An optional list of node names to interrupt before running. */\n    interruptBefore?: N[] | All;\n    /** An optional list of node names to interrupt after running. */\n    interruptAfter?: N[] | All;\n    store?: BaseStore;\n    /**\n     * An optional schema for the final agent output.\n     *\n     * If provided, output will be formatted to match the given schema and returned in the 'structuredResponse' state key.\n     * If not provided, `structuredResponse` will not be present in the output state.\n     *\n     * Can be passed in as:\n     *   - Zod schema\n     *     ```ts\n     *     const agent = createAgent({\n     *       responseFormat: z.object({\n     *         capital: z.string(),\n     *       }),\n     *       // ...\n     *     });\n     *     ```\n     *   - JSON schema\n     *     ```ts\n     *     const agent = createAgent({\n     *       responseFormat: {\n     *         type: \"json_schema\",\n     *         schema: {\n     *           type: \"object\",\n     *           properties: {\n     *             capital: { type: \"string\" },\n     *           },\n     *           required: [\"capital\"],\n     *         },\n     *       },\n     *       // ...\n     *     });\n     *     ```\n     *   - Create React Agent ResponseFormat\n     *     ```ts\n     *     import { providerStrategy, toolStrategy } from \"langchain\";\n     *     const agent = createAgent({\n     *       responseFormat: providerStrategy(\n     *         z.object({\n     *           capital: z.string(),\n     *         })\n     *       ),\n     *       // or\n     *       responseFormat: [\n     *         toolStrategy({ ... }),\n     *         toolStrategy({ ... }),\n     *       ]\n     *       // ...\n     *     });\n     *     ```\n     *\n     * **Note**: The graph will make a separate call to the LLM to generate the structured response after the agent loop is finished.\n     * This is not the only strategy to get structured responses, see more options in [this guide](https://langchain-ai.github.io/langgraph/how-tos/react-agent-structured-output/).\n     */\n    responseFormat?: ResponseFormatType;\n    /**\n     * Middlewares to run during agent execution.\n     * Each middleware can define its own state schema and hook into the agent lifecycle.\n     */\n    middlewares?: readonly AgentMiddleware<any, any, any>[];\n    /**\n     * An optional name for the agent.\n     */\n    name?: string;\n    /**\n     * An optional description for the agent.\n     * This can be used to describe the agent to the underlying supervisor LLM.\n     */\n    description?: string;\n    /**\n     * Use to specify how to expose the agent name to the underlying supervisor LLM.\n     *   - `undefined`: Relies on the LLM provider {@link AIMessage#name}. Currently, only OpenAI supports this.\n     *   - `\"inline\"`: Add the agent name directly into the content field of the {@link AIMessage} using XML-style tags.\n     *       Example: `\"How can I help you\"` -> `\"<name>agent_name</name><content>How can I help you?</content>\"`\n     */\n    includeAgentName?: \"inline\" | undefined;\n    /**\n     * An optional abort signal that indicates that the overall operation should be aborted.\n     */\n    signal?: AbortSignal;\n    /**\n     * Determines the version of the graph to create.\n     *\n     * Can be one of\n     * - `\"v1\"`: The tool node processes a single message. All tool calls in the message are\n     *           executed in parallel within the tool node.\n     * - `\"v2\"`: The tool node processes a single tool call. Tool calls are distributed across\n     *           multiple instances of the tool node using the Send API.\n     *\n     * @default `\"v2\"`\n     */\n    version?: \"v1\" | \"v2\";\n};\n/**\n * Helper type to check if all properties of a type are optional\n */\nexport type IsAllOptional<T> = T extends Record<string, any> ? {} extends T ? true : false : true;\n/**\n * Helper type to extract input type from context schema (with optional defaults)\n */\nexport type InferContextInput<ContextSchema extends AnyAnnotationRoot | InteropZodObject> = ContextSchema extends InteropZodObject ? InferInteropZodInput<ContextSchema> : ContextSchema extends AnyAnnotationRoot ? ToAnnotationRoot<ContextSchema>[\"State\"] : {};\n/**\n * Helper type to get the required config type based on context schema\n */\nexport type InferAgentConfig<ContextSchema extends AnyAnnotationRoot | InteropZodObject, TMiddlewares extends readonly AgentMiddleware<any, any, any>[]> = IsAllOptional<InferContextInput<ContextSchema> & InferMiddlewareContextInputs<TMiddlewares>> extends true ? LangGraphRunnableConfig<{\n    context?: InferContextInput<ContextSchema> & InferMiddlewareContextInputs<TMiddlewares>;\n}> | undefined : LangGraphRunnableConfig<{\n    context: InferContextInput<ContextSchema> & InferMiddlewareContextInputs<TMiddlewares>;\n}>;\nexport type InternalAgentState<StructuredResponseType extends Record<string, unknown> | undefined = Record<string, unknown>> = {\n    messages: BaseMessage[];\n    __preparedModelOptions?: ModelRequest;\n} & (StructuredResponseType extends ResponseFormatUndefined ? Record<string, never> : {\n    structuredResponse: StructuredResponseType;\n});\nexport {};\n"],"mappings":"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"}
+{"version":3,"file":"types.d.cts","names":["z","InteropZodObject","InteropZodType","InferInteropZodInput","LangGraphRunnableConfig","START","LanguageModelLike","SystemMessage","BaseMessageLike","BaseMessage","All","BaseCheckpointSaver","BaseStore","Runnable","PreHookAnnotation","AnyAnnotationRoot","ToAnnotationRoot","ResponseFormat","ToolStrategy","TypedToolStrategy","ProviderStrategy","ResponseFormatUndefined","JsonSchemaFormat","ToolNode","ClientTool","ServerTool","AgentRuntime","N","BuiltInState","ToolCall","Record","ToolResult","ModelRequest","Runtime","TContext","Controls","TState","Partial","ControlAction","Error","TStateSchema","MiddlewareResult","AgentBuiltInState","FilterPrivateProps","T","K","InferMiddlewareState","AgentMiddleware","S","ZodObject","infer","InferMiddlewareInputState","input","InferMiddlewareStates","First","Rest","InferMiddlewareInputStates","InferMergedState","InferMergedInputState","InferMiddlewareContext","C","InferMiddlewareContextInput","InferMiddlewareContexts","InferMiddlewareContextInputs","ZodRawShape","TSchema","TContextSchema","TFullContext","Promise","ExecutedToolCall","LLMCall","Prompt","ContextSchema","DynamicLLMFunction","CreateAgentParams","StructuredResponseType","ResponseFormatType","AbortSignal","IsAllOptional","InferContextInput","InferAgentConfig","TMiddleware","InternalAgentState"],"sources":["../../../src/agents/middlewareAgent/types.d.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { z } from \"zod/v3\";\nimport type { InteropZodObject, InteropZodType, InferInteropZodInput } from \"@langchain/core/utils/types\";\nimport type { LangGraphRunnableConfig, START } from \"@langchain/langgraph\";\nimport type { LanguageModelLike } from \"@langchain/core/language_models/base\";\nimport type { SystemMessage, BaseMessageLike, BaseMessage } from \"@langchain/core/messages\";\nimport type { All, BaseCheckpointSaver, BaseStore } from \"@langchain/langgraph-checkpoint\";\nimport type { Runnable } from \"@langchain/core/runnables\";\nimport type { PreHookAnnotation, AnyAnnotationRoot, ToAnnotationRoot } from \"../annotation.js\";\nimport type { ResponseFormat, ToolStrategy, TypedToolStrategy, ProviderStrategy, ResponseFormatUndefined, JsonSchemaFormat } from \"../responses.js\";\nimport type { ToolNode } from \"../nodes/ToolNode.js\";\nimport type { ClientTool, ServerTool, AgentRuntime } from \"../types.js\";\nexport type N = typeof START | \"model_request\" | \"tools\";\nexport interface BuiltInState {\n    messages: BaseMessage[];\n}\n/**\n * Information about a tool call that has been executed.\n */\nexport interface ToolCall {\n    /**\n     * The ID of the tool call.\n     */\n    id: string;\n    /**\n     * The name of the tool that was called.\n     */\n    name: string;\n    /**\n     * The arguments that were passed to the tool.\n     */\n    args: Record<string, any>;\n}\n/**\n * Information about a tool result from a tool execution.\n */\nexport interface ToolResult {\n    /**\n     * The ID of the tool call.\n     */\n    id: string;\n    /**\n     * The result of the tool call.\n     */\n    result: any;\n    /**\n     * An optional error message if the tool call failed.\n     */\n    error?: string;\n}\n/**\n * Configuration for modifying a model call at runtime.\n * All fields are optional and only provided fields will override defaults.\n */\nexport interface ModelRequest {\n    /**\n     * The model to use for this step.\n     */\n    model: LanguageModelLike;\n    /**\n     * The messages to send to the model.\n     */\n    messages: BaseMessage[];\n    /**\n     * The system message for this step.\n     */\n    systemMessage?: BaseMessage;\n    /**\n     * Tool choice configuration (model-specific format).\n     * Can be one of:\n     * - `\"auto\"`: means the model can pick between generating a message or calling one or more tools.\n     * - `\"none\"`: means the model will not call any tool and instead generates a message.\n     * - `\"required\"`: means the model must call one or more tools.\n     * - `{ type: \"function\", function: { name: string } }`: The model will use the specified function.\n     */\n    toolChoice?: \"auto\" | \"none\" | \"required\" | {\n        type: \"function\";\n        function: {\n            name: string;\n        };\n    };\n    /**\n     * The tools to make available for this step.\n     * Can be tool names (strings) or tool instances.\n     */\n    tools: (ClientTool | ServerTool)[];\n}\n/**\n * Runtime information available to middleware (readonly).\n */\nexport interface Runtime<TContext = unknown> {\n    readonly toolCalls: ToolCall[];\n    readonly toolResults: ToolResult[];\n    // readonly tokenUsage: {\n    //   readonly inputTokens: number;\n    //   readonly outputTokens: number;\n    //   readonly totalTokens: number;\n    // };\n    readonly context: TContext;\n}\n/**\n * Control flow interface for middleware.\n */\nexport interface Controls<TState = unknown> {\n    jumpTo(target: \"model\" | \"tools\", stateUpdate?: Partial<TState>): ControlAction<TState>;\n    terminate(result?: Partial<TState> | Error): ControlAction<TState>;\n}\n/**\n * Control action type returned by control methods.\n */\nexport type ControlAction<TStateSchema> = {\n    type: \"jump\" | \"terminate\" | \"retry\";\n    target?: string;\n    stateUpdate?: Partial<TStateSchema>;\n    result?: any;\n    error?: Error;\n};\n/**\n * Result type for middleware functions.\n */\nexport type MiddlewareResult<TState> = TState | void;\n/**\n * Type for the agent's built-in state properties.\n */\nexport type AgentBuiltInState = {\n    messages: BaseMessage[];\n};\n/**\n * Helper type to filter out properties that start with underscore (private properties)\n */\ntype FilterPrivateProps<T> = {\n    [K in keyof T as K extends `_${string}` ? never : K]: T[K];\n};\n/**\n * Helper type to infer the state schema type from a middleware\n * This filters out private properties (those starting with underscore)\n */\nexport type InferMiddlewareState<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<infer S, any, any> ? S extends z.ZodObject<any> ? FilterPrivateProps<z.infer<S>> : {} : {};\n/**\n * Helper type to infer the input state schema type from a middleware (all properties optional)\n * This filters out private properties (those starting with underscore)\n */\nexport type InferMiddlewareInputState<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<infer S, any, any> ? S extends z.ZodObject<any> ? FilterPrivateProps<z.input<S>> : {} : {};\n/**\n * Helper type to infer merged state from an array of middleware (just the middleware states)\n */\nexport type InferMiddlewareStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareState<First> & InferMiddlewareStates<Rest> : InferMiddlewareState<First> : {} : {};\n/**\n * Helper type to infer merged input state from an array of middleware (with optional defaults)\n */\nexport type InferMiddlewareInputStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareInputState<First> & InferMiddlewareInputStates<Rest> : InferMiddlewareInputState<First> : {} : {};\n/**\n * Helper type to infer merged state from an array of middleware (includes built-in state)\n */\nexport type InferMergedState<T extends readonly AgentMiddleware<any, any, any>[]> = InferMiddlewareStates<T> & AgentBuiltInState;\n/**\n * Helper type to infer merged input state from an array of middleware (includes built-in state)\n */\nexport type InferMergedInputState<T extends readonly AgentMiddleware<any, any, any>[]> = InferMiddlewareInputStates<T> & AgentBuiltInState;\n/**\n * Helper type to infer the context schema type from a middleware\n */\nexport type InferMiddlewareContext<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<any, infer C, any> ? C extends z.ZodObject<any> ? z.infer<C> : {} : {};\n/**\n * Helper type to infer the input context schema type from a middleware (with optional defaults)\n */\nexport type InferMiddlewareContextInput<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<any, infer C, any> ? C extends z.ZodObject<any> ? z.input<C> : {} : {};\n/**\n * Helper type to infer merged context from an array of middleware\n */\nexport type InferMiddlewareContexts<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareContext<First> & InferMiddlewareContexts<Rest> : InferMiddlewareContext<First> : {} : {};\n/**\n * Helper type to infer merged input context from an array of middleware (with optional defaults)\n */\nexport type InferMiddlewareContextInputs<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareContextInput<First> & InferMiddlewareContextInputs<Rest> : InferMiddlewareContextInput<First> : {} : {};\n/**\n * Base middleware interface.\n */\nexport interface AgentMiddleware<TSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined, TContextSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined, TFullContext = any> {\n    stateSchema?: TSchema;\n    contextSchema?: TContextSchema;\n    name: string;\n    /**\n     * Runs before each LLM call, can modify call parameters, changes are not persistent\n     * e.g. if you change `model`, it will only be changed for the next model call\n     *\n     * @param options - Current call options (can be modified by previous middleware)\n     * @param state - Current state (read-only in this phase)\n     * @param runtime - Runtime context and metadata\n     * @returns Modified options or undefined to pass through\n     */\n    prepareModelRequest?(request: ModelRequest, state: (TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState, runtime: Runtime<TFullContext>): Promise<Partial<ModelRequest> | void> | Partial<ModelRequest> | void;\n    beforeModel?(state: (TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState, runtime: Runtime<TFullContext>, controls: Controls<(TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState>): Promise<MiddlewareResult<Partial<TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}>>>;\n    afterModel?(state: (TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState, runtime: Runtime<TFullContext>, controls: Controls<(TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}) & AgentBuiltInState>): Promise<MiddlewareResult<Partial<TSchema extends z.ZodObject<any> ? z.infer<TSchema> : {}>>>;\n}\n/**\n * Information about a tool call that has been executed.\n */\nexport interface ExecutedToolCall {\n    /**\n     * The name of the tool that was called.\n     */\n    name: string;\n    /**\n     * The arguments that were passed to the tool.\n     */\n    args: Record<string, unknown>;\n    /**\n     * The ID of the tool call.\n     */\n    tool_id: string;\n    /**\n     * The result of the tool call (if available).\n     */\n    result?: unknown;\n}\n/**\n * Information about an LLM invocation.\n */\nexport interface LLMCall {\n    /**\n     * The messages that were sent to the LLM.\n     */\n    messages: BaseMessage[];\n    /**\n     * The response from the LLM.\n     */\n    response?: BaseMessage;\n}\n/**\n * Duplicate of the Prompt type from ../types.ts\n */\nexport type Prompt<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = SystemMessage | string | ((state: AgentBuiltInState, config: LangGraphRunnableConfig<ToAnnotationRoot<ContextSchema>[\"State\"]>) => BaseMessageLike[] | Promise<BaseMessageLike[]>) | Runnable;\nexport type DynamicLLMFunction<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = (state: AgentBuiltInState & PreHookAnnotation[\"State\"], runtime: AgentRuntime<ToAnnotationRoot<ContextSchema>[\"State\"]>) => Promise<LanguageModelLike> | LanguageModelLike;\nexport type CreateAgentParams<StructuredResponseType extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, ResponseFormatType = InteropZodType<StructuredResponseType> | InteropZodType<unknown>[] | JsonSchemaFormat | JsonSchemaFormat[] | ResponseFormat | TypedToolStrategy<StructuredResponseType> | ToolStrategy<StructuredResponseType> | ProviderStrategy<StructuredResponseType> | ResponseFormatUndefined> = {\n    /** The chat model that can utilize OpenAI-style tool calling. */\n    llm?: LanguageModelLike | DynamicLLMFunction<ContextSchema>;\n    /**\n     * Initializes a ChatModel based on the provided model name and provider.\n     * It supports various model providers and allows for runtime configuration of model parameters.\n     *\n     * @uses {@link initChatModel}\n     * @example\n     * ```ts\n     * const agent = createAgent({\n     *   model: \"anthropic:claude-3-7-sonnet-latest\",\n     *   // ...\n     * });\n     * ```\n     */\n    model?: string;\n    /** A list of tools or a ToolNode. */\n    tools?: ToolNode | (ServerTool | ClientTool)[];\n    /**\n     * An optional prompt for the LLM. This takes full graph state BEFORE the LLM is called and prepares the input to LLM.\n     *\n     * Can take a few different forms:\n     *\n     * - str: This is converted to a SystemMessage and added to the beginning of the list of messages in state[\"messages\"].\n     * - SystemMessage: this is added to the beginning of the list of messages in state[\"messages\"].\n     * - Function: This function should take in full graph state and the output is then passed to the language model.\n     * - Runnable: This runnable should take in full graph state and the output is then passed to the language model.\n     *\n     * Note:\n     * Prior to `v0.2.46`, the prompt was set using `stateModifier` / `messagesModifier` parameters.\n     * This is now deprecated and will be removed in a future release.\n     *\n     * Cannot be used together with `prepareModelRequest`.\n     */\n    prompt?: Prompt<ContextSchema>;\n    /**\n     * An optional schema for the context. It allows to pass in a typed context object into the agent\n     * invocation and allows to access it in hooks such as `prompt` and middleware.\n     * As opposed to the agent state, defined in `stateSchema`, the context is not persisted between\n     * agent invocations.\n     *\n     * @example\n     * ```ts\n     * const agent = createAgent({\n     *   llm: model,\n     *   tools: [getWeather],\n     *   contextSchema: z.object({\n     *     capital: z.string(),\n     *   }),\n     *   prompt: (state, config) => {\n     *     return [\n     *       new SystemMessage(`You are a helpful assistant. The capital of France is ${config.context.capital}.`),\n     *     ];\n     *   },\n     * });\n     *\n     * const result = await agent.invoke({\n     *   messages: [\n     *     new SystemMessage(\"You are a helpful assistant.\"),\n     *     new HumanMessage(\"What is the capital of France?\"),\n     *   ],\n     * }, {\n     *   context: {\n     *     capital: \"Paris\",\n     *   },\n     * });\n     * ```\n     */\n    contextSchema?: ContextSchema;\n    /** An optional checkpoint saver to persist the agent's state. */\n    checkpointSaver?: BaseCheckpointSaver | boolean;\n    /** An optional checkpoint saver to persist the agent's state. Alias of \"checkpointSaver\". */\n    checkpointer?: BaseCheckpointSaver | boolean;\n    /** An optional list of node names to interrupt before running. */\n    interruptBefore?: N[] | All;\n    /** An optional list of node names to interrupt after running. */\n    interruptAfter?: N[] | All;\n    store?: BaseStore;\n    /**\n     * An optional schema for the final agent output.\n     *\n     * If provided, output will be formatted to match the given schema and returned in the 'structuredResponse' state key.\n     * If not provided, `structuredResponse` will not be present in the output state.\n     *\n     * Can be passed in as:\n     *   - Zod schema\n     *     ```ts\n     *     const agent = createAgent({\n     *       responseFormat: z.object({\n     *         capital: z.string(),\n     *       }),\n     *       // ...\n     *     });\n     *     ```\n     *   - JSON schema\n     *     ```ts\n     *     const agent = createAgent({\n     *       responseFormat: {\n     *         type: \"json_schema\",\n     *         schema: {\n     *           type: \"object\",\n     *           properties: {\n     *             capital: { type: \"string\" },\n     *           },\n     *           required: [\"capital\"],\n     *         },\n     *       },\n     *       // ...\n     *     });\n     *     ```\n     *   - Create React Agent ResponseFormat\n     *     ```ts\n     *     import { providerStrategy, toolStrategy } from \"langchain\";\n     *     const agent = createAgent({\n     *       responseFormat: providerStrategy(\n     *         z.object({\n     *           capital: z.string(),\n     *         })\n     *       ),\n     *       // or\n     *       responseFormat: [\n     *         toolStrategy({ ... }),\n     *         toolStrategy({ ... }),\n     *       ]\n     *       // ...\n     *     });\n     *     ```\n     *\n     * **Note**: The graph will make a separate call to the LLM to generate the structured response after the agent loop is finished.\n     * This is not the only strategy to get structured responses, see more options in [this guide](https://langchain-ai.github.io/langgraph/how-tos/react-agent-structured-output/).\n     */\n    responseFormat?: ResponseFormatType;\n    /**\n     * Middleware instances to run during agent execution.\n     * Each middleware can define its own state schema and hook into the agent lifecycle.\n     */\n    middleware?: readonly AgentMiddleware<any, any, any>[];\n    /**\n     * An optional name for the agent.\n     */\n    name?: string;\n    /**\n     * An optional description for the agent.\n     * This can be used to describe the agent to the underlying supervisor LLM.\n     */\n    description?: string;\n    /**\n     * Use to specify how to expose the agent name to the underlying supervisor LLM.\n     *   - `undefined`: Relies on the LLM provider {@link AIMessage#name}. Currently, only OpenAI supports this.\n     *   - `\"inline\"`: Add the agent name directly into the content field of the {@link AIMessage} using XML-style tags.\n     *       Example: `\"How can I help you\"` -> `\"<name>agent_name</name><content>How can I help you?</content>\"`\n     */\n    includeAgentName?: \"inline\" | undefined;\n    /**\n     * An optional abort signal that indicates that the overall operation should be aborted.\n     */\n    signal?: AbortSignal;\n    /**\n     * Determines the version of the graph to create.\n     *\n     * Can be one of\n     * - `\"v1\"`: The tool node processes a single message. All tool calls in the message are\n     *           executed in parallel within the tool node.\n     * - `\"v2\"`: The tool node processes a single tool call. Tool calls are distributed across\n     *           multiple instances of the tool node using the Send API.\n     *\n     * @default `\"v2\"`\n     */\n    version?: \"v1\" | \"v2\";\n};\n/**\n * Helper type to check if all properties of a type are optional\n */\nexport type IsAllOptional<T> = T extends Record<string, any> ? {} extends T ? true : false : true;\n/**\n * Helper type to extract input type from context schema (with optional defaults)\n */\nexport type InferContextInput<ContextSchema extends AnyAnnotationRoot | InteropZodObject> = ContextSchema extends InteropZodObject ? InferInteropZodInput<ContextSchema> : ContextSchema extends AnyAnnotationRoot ? ToAnnotationRoot<ContextSchema>[\"State\"] : {};\n/**\n * Helper type to get the required config type based on context schema\n */\nexport type InferAgentConfig<ContextSchema extends AnyAnnotationRoot | InteropZodObject, TMiddleware extends readonly AgentMiddleware<any, any, any>[]> = IsAllOptional<InferContextInput<ContextSchema> & InferMiddlewareContextInputs<TMiddleware>> extends true ? LangGraphRunnableConfig<{\n    context?: InferContextInput<ContextSchema> & InferMiddlewareContextInputs<TMiddleware>;\n}> | undefined : LangGraphRunnableConfig<{\n    context: InferContextInput<ContextSchema> & InferMiddlewareContextInputs<TMiddleware>;\n}>;\nexport type InternalAgentState<StructuredResponseType extends Record<string, unknown> | undefined = Record<string, unknown>> = {\n    messages: BaseMessage[];\n    __preparedModelOptions?: ModelRequest;\n} & (StructuredResponseType extends ResponseFormatUndefined ? Record<string, never> : {\n    structuredResponse: StructuredResponseType;\n});\nexport {};\n"],"mappings":"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"}

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

@@ -6,7 +6,7 @@ import { BaseMessage, BaseMessageLike, SystemMessage } from "@langchain/core/mes
 import { Runnable } from "@langchain/core/runnables";
 import { LangGraphRunnableConfig, START } from "@langchain/langgraph";
 import { InferInteropZodInput, InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
-import { z } from "zod";
+import { z } from "zod/v3";
 import { LanguageModelLike } from "@langchain/core/language_models/base";
 import { All, BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
 
@@ -49,12 +49,6 @@ interface ToolResult {
    */
   error?: string;
 }
-interface AnthropicModelSettings {
-  cache_control: {
-    type: string;
-    ttl: string;
-  };
-}
 /**
  * Configuration for modifying a model call at runtime.
  * All fields are optional and only provided fields will override defaults.
@@ -91,11 +85,6 @@ interface ModelRequest {
    * Can be tool names (strings) or tool instances.
    */
   tools: (ClientTool | ServerTool)[];
-  /**
-   * The model settings to use for this step.
-   * Currently only supported for Anthropic models.
-   */
-  modelSettings?: AnthropicModelSettings | Record<string, any>;
 }
 /**
  * Runtime information available to middleware (readonly).
@@ -152,15 +141,15 @@ type InferMiddlewareState<T extends AgentMiddleware<any, any, any>> = T extends
  */
 type InferMiddlewareInputState<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<infer S, any, any> ? S extends z.ZodObject<any> ? FilterPrivateProps<z.input<S>> : {} : {};
 /**
- * Helper type to infer merged state from an array of middlewares (just the middleware states)
+ * Helper type to infer merged state from an array of middleware (just the middleware states)
  */
 type InferMiddlewareStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareState<First> & InferMiddlewareStates<Rest> : InferMiddlewareState<First> : {} : {};
 /**
- * Helper type to infer merged input state from an array of middlewares (with optional defaults)
+ * Helper type to infer merged input state from an array of middleware (with optional defaults)
  */
 type InferMiddlewareInputStates<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareInputState<First> & InferMiddlewareInputStates<Rest> : InferMiddlewareInputState<First> : {} : {};
 /**
- * Helper type to infer merged state from an array of middlewares (includes built-in state)
+ * Helper type to infer merged state from an array of middleware (includes built-in state)
  */
 
 /**
@@ -168,11 +157,11 @@ type InferMiddlewareInputStates<T extends readonly AgentMiddleware<any, any, any
  */
 type InferMiddlewareContextInput<T extends AgentMiddleware<any, any, any>> = T extends AgentMiddleware<any, infer C, any> ? C extends z.ZodObject<any> ? z.input<C> : {} : {};
 /**
- * Helper type to infer merged context from an array of middlewares
+ * Helper type to infer merged context from an array of middleware
  */
 
 /**
- * Helper type to infer merged input context from an array of middlewares (with optional defaults)
+ * Helper type to infer merged input context from an array of middleware (with optional defaults)
  */
 type InferMiddlewareContextInputs<T extends readonly AgentMiddleware<any, any, any>[]> = T extends readonly [] ? {} : T extends readonly [infer First, ...infer Rest] ? First extends AgentMiddleware<any, any, any> ? Rest extends readonly AgentMiddleware<any, any, any>[] ? InferMiddlewareContextInput<First> & InferMiddlewareContextInputs<Rest> : InferMiddlewareContextInput<First> : {} : {};
 /**
@@ -204,9 +193,7 @@ interface AgentMiddleware<TSchema extends z.ZodObject<z.ZodRawShape> | undefined
  */
 type Prompt<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = SystemMessage | string | ((state: AgentBuiltInState, config: LangGraphRunnableConfig<ToAnnotationRoot<ContextSchema>["State"]>) => BaseMessageLike[] | Promise<BaseMessageLike[]>) | Runnable;
 type DynamicLLMFunction<ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = (state: AgentBuiltInState & PreHookAnnotation["State"], runtime: AgentRuntime<ToAnnotationRoot<ContextSchema>["State"]>) => Promise<LanguageModelLike> | LanguageModelLike;
-type CreateAgentParams<
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-StructuredResponseType extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, ResponseFormatType = InteropZodType<StructuredResponseType> | InteropZodType<unknown>[] | JsonSchemaFormat | JsonSchemaFormat[] | ResponseFormat | TypedToolStrategy<StructuredResponseType> | ToolStrategy<StructuredResponseType> | ProviderStrategy<StructuredResponseType> | ResponseFormatUndefined> = {
+type CreateAgentParams<StructuredResponseType extends Record<string, any> = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, ResponseFormatType = InteropZodType<StructuredResponseType> | InteropZodType<unknown>[] | JsonSchemaFormat | JsonSchemaFormat[] | ResponseFormat | TypedToolStrategy<StructuredResponseType> | ToolStrategy<StructuredResponseType> | ProviderStrategy<StructuredResponseType> | ResponseFormatUndefined> = {
   /** The chat model that can utilize OpenAI-style tool calling. */
   llm?: LanguageModelLike | DynamicLLMFunction<ContextSchema>;
   /**
@@ -244,7 +231,7 @@ StructuredResponseType extends Record<string, any> = Record<string, any>, Contex
   prompt?: Prompt<ContextSchema>;
   /**
    * An optional schema for the context. It allows to pass in a typed context object into the agent
-   * invocation and allows to access it in hooks such as `prompt` and middlewares.
+   * invocation and allows to access it in hooks such as `prompt` and middleware.
    * As opposed to the agent state, defined in `stateSchema`, the context is not persisted between
    * agent invocations.
    *
@@ -340,10 +327,10 @@ StructuredResponseType extends Record<string, any> = Record<string, any>, Contex
    */
   responseFormat?: ResponseFormatType;
   /**
-   * Middlewares to run during agent execution.
+   * Middleware instances to run during agent execution.
    * Each middleware can define its own state schema and hook into the agent lifecycle.
    */
-  middlewares?: readonly AgentMiddleware<any, any, any>[];
+  middleware?: readonly AgentMiddleware<any, any, any>[];
   /**
    * An optional name for the agent.
    */