deepagents 1.8.6 → 1.8.8

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as zod_v30 from "zod/v3";
-import * as langchain from "langchain";
+import * as _langchain from "langchain";
 import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, CreateAgentParams, HumanMessage, InferMiddlewareStates, InterruptOnConfig, ProviderStrategy, ReactAgent, ResponseFormat, ResponseFormatUndefined, Runtime, StructuredTool, SystemMessage, ToolMessage, ToolStrategy } from "langchain";
-import * as _langchain_langgraph0 from "@langchain/langgraph";
+import * as _langgraph from "@langchain/langgraph";
 import { AnnotationRoot, Command, ReducedValue, StateSchema } from "@langchain/langgraph";
 import { z } from "zod/v4";
 import * as _langchain_core_tools0 from "@langchain/core/tools";
@@ -475,19 +475,21 @@ interface FilesystemMiddlewareOptions {
   customToolDescriptions?: Record<string, string> | null;
   /** Optional token limit before evicting a tool result to the filesystem (default: 20000 tokens, ~80KB) */
   toolTokenLimitBeforeEvict?: number | null;
+  /** Optional token limit before evicting a HumanMessage to the filesystem (default: 50000 tokens, ~200KB) */
+  humanMessageTokenLimitBeforeEvict?: number | null;
 }
 /**
  * Create filesystem middleware with all tools and features.
  */
 declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOptions): AgentMiddleware<StateSchema<{
   files: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain.DynamicStructuredTool<z.ZodObject<{
+}>, undefined, unknown, (_langchain.DynamicStructuredTool<z.ZodObject<{
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, unknown, "ls"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "ls"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
   limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -499,7 +501,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, unknown, "read_file"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "read_file"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   content: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>, {
@@ -511,7 +513,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, string | ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | Command<unknown, {
   files: Record<string, FileData>;
   messages: ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "write_file"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string>, unknown, "write_file"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   old_string: z.ZodString;
   new_string: z.ZodString;
@@ -529,7 +531,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, string | ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | Command<unknown, {
   files: Record<string, FileData>;
   messages: ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "edit_file"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string>, unknown, "edit_file"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
@@ -538,7 +540,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, unknown, "glob"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "glob"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   glob: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -550,7 +552,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, unknown, "grep"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "grep"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   command: z.ZodString;
 }, z.core.$strip>, {
   command: string;
@@ -759,7 +761,7 @@ interface SubAgentMiddlewareOptions {
 /**
  * Create subagent middleware with task tool
  */
-declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [langchain.DynamicStructuredTool<z.ZodObject<{
+declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [_langchain.DynamicStructuredTool<z.ZodObject<{
   description: z.ZodString;
   subagent_type: z.ZodString;
 }, z.core.$strip>, {
@@ -941,7 +943,7 @@ declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): Agent
    * Marked as private so it's not included in the final agent state.
    */
   memoryContents: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>;
-  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+  files: _langgraph.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
 }>, undefined, unknown, readonly (_langchain_core_tools0.ClientTool | _langchain_core_tools0.ServerTool)[]>;
 //#endregion
 //#region src/middleware/skills.d.ts
@@ -2224,7 +2226,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[] | undefined;
-}>, undefined, unknown, readonly [langchain.DynamicStructuredTool<zod_v30.ZodObject<{
+}>, undefined, unknown, readonly [_langchain.DynamicStructuredTool<zod_v30.ZodObject<{
   todos: zod_v30.ZodArray<zod_v30.ZodObject<{
     content: zod_v30.ZodString;
     status: zod_v30.ZodEnum<["pending", "in_progress", "completed"]>;
@@ -2255,21 +2257,21 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
-}, _langchain_langgraph0.Command<unknown, {
+}, _langgraph.Command<unknown, {
   todos: {
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "write_todos">]>, AgentMiddleware<_langchain_langgraph0.StateSchema<{
-  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string>, unknown, "write_todos">]>, AgentMiddleware<_langgraph.StateSchema<{
+  files: _langgraph.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+}>, undefined, unknown, (_langchain.DynamicStructuredTool<zod.ZodObject<{
   path: zod.ZodDefault<zod.ZodOptional<zod.ZodString>>;
 }, zod_v4_core0.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, unknown, "ls"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "ls"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   file_path: zod.ZodString;
   offset: zod.ZodDefault<zod.ZodOptional<zod.ZodCoercedNumber<unknown>>>;
   limit: zod.ZodDefault<zod.ZodOptional<zod.ZodCoercedNumber<unknown>>>;
@@ -2281,7 +2283,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, unknown, "read_file"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "read_file"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   file_path: zod.ZodString;
   content: zod.ZodDefault<zod.ZodString>;
 }, zod_v4_core0.$strip>, {
@@ -2290,10 +2292,10 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
 }, {
   file_path: string;
   content?: string | undefined;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langgraph.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "write_file"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string>, unknown, "write_file"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   file_path: zod.ZodString;
   old_string: zod.ZodString;
   new_string: zod.ZodString;
@@ -2308,10 +2310,10 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   old_string: string;
   new_string: string;
   replace_all?: boolean | undefined;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langgraph.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "edit_file"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string>, unknown, "edit_file"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   pattern: zod.ZodString;
   path: zod.ZodDefault<zod.ZodOptional<zod.ZodString>>;
 }, zod_v4_core0.$strip>, {
@@ -2320,7 +2322,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, unknown, "glob"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "glob"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   pattern: zod.ZodString;
   path: zod.ZodDefault<zod.ZodOptional<zod.ZodString>>;
   glob: zod.ZodNullable<zod.ZodOptional<zod.ZodString>>;
@@ -2332,13 +2334,13 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, unknown, "grep"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "grep"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   command: zod.ZodString;
 }, zod_v4_core0.$strip>, {
   command: string;
 }, {
   command: string;
-}, string, unknown, "execute">)[]>, AgentMiddleware<undefined, undefined, unknown, readonly [langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "execute">)[]>, AgentMiddleware<undefined, undefined, unknown, readonly [_langchain.DynamicStructuredTool<zod.ZodObject<{
   description: zod.ZodString;
   subagent_type: zod.ZodString;
 }, zod_v4_core0.$strip>, {
@@ -2347,7 +2349,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
 }, {
   description: string;
   subagent_type: string;
-}, string | _langchain_langgraph0.Command<unknown, Record<string, unknown>, string>, unknown, "task">]>, AgentMiddleware<zod.ZodObject<{
+}, string | _langgraph.Command<unknown, Record<string, unknown>, string>, unknown, "task">]>, AgentMiddleware<zod.ZodObject<{
   _summarizationSessionId: zod.ZodOptional<zod.ZodString>;
   _summarizationEvent: zod.ZodOptional<zod.ZodObject<{
     cutoffIndex: zod.ZodNumber;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import * as langchain from "langchain";
+import * as _langchain from "langchain";
 import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, CreateAgentParams, HumanMessage, InferMiddlewareStates, InterruptOnConfig, ProviderStrategy, ReactAgent, ResponseFormat, ResponseFormatUndefined, Runtime, StructuredTool, SystemMessage, ToolMessage, ToolStrategy } from "langchain";
 import { Runnable } from "@langchain/core/runnables";
-import * as _langchain_langgraph0 from "@langchain/langgraph";
+import * as _langgraph from "@langchain/langgraph";
 import { AnnotationRoot, Command, ReducedValue, StateSchema } from "@langchain/langgraph";
 import { z } from "zod/v4";
 import * as _messages from "@langchain/core/messages";
@@ -475,19 +475,21 @@ interface FilesystemMiddlewareOptions {
   customToolDescriptions?: Record<string, string> | null;
   /** Optional token limit before evicting a tool result to the filesystem (default: 20000 tokens, ~80KB) */
   toolTokenLimitBeforeEvict?: number | null;
+  /** Optional token limit before evicting a HumanMessage to the filesystem (default: 50000 tokens, ~200KB) */
+  humanMessageTokenLimitBeforeEvict?: number | null;
 }
 /**
  * Create filesystem middleware with all tools and features.
  */
 declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOptions): AgentMiddleware<StateSchema<{
   files: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain.DynamicStructuredTool<z.ZodObject<{
+}>, undefined, unknown, (_langchain.DynamicStructuredTool<z.ZodObject<{
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, unknown, "ls"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "ls"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
   limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -499,7 +501,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, unknown, "read_file"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "read_file"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   content: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>, {
@@ -511,7 +513,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, string | ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | Command<unknown, {
   files: Record<string, FileData>;
   messages: ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "write_file"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string>, unknown, "write_file"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   old_string: z.ZodString;
   new_string: z.ZodString;
@@ -529,7 +531,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, string | ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | Command<unknown, {
   files: Record<string, FileData>;
   messages: ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "edit_file"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string>, unknown, "edit_file"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
@@ -538,7 +540,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, unknown, "glob"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "glob"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   glob: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -550,7 +552,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, unknown, "grep"> | langchain.DynamicStructuredTool<z.ZodObject<{
+}, string, unknown, "grep"> | _langchain.DynamicStructuredTool<z.ZodObject<{
   command: z.ZodString;
 }, z.core.$strip>, {
   command: string;
@@ -759,7 +761,7 @@ interface SubAgentMiddlewareOptions {
 /**
  * Create subagent middleware with task tool
  */
-declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [langchain.DynamicStructuredTool<z.ZodObject<{
+declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [_langchain.DynamicStructuredTool<z.ZodObject<{
   description: z.ZodString;
   subagent_type: z.ZodString;
 }, z.core.$strip>, {
@@ -941,7 +943,7 @@ declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): Agent
    * Marked as private so it's not included in the final agent state.
    */
   memoryContents: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>;
-  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+  files: _langgraph.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
 }>, undefined, unknown, readonly (_langchain_core_tools0.ClientTool | _langchain_core_tools0.ServerTool)[]>;
 //#endregion
 //#region src/middleware/skills.d.ts
@@ -2224,7 +2226,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[] | undefined;
-}>, undefined, unknown, readonly [langchain.DynamicStructuredTool<zod_v30.ZodObject<{
+}>, undefined, unknown, readonly [_langchain.DynamicStructuredTool<zod_v30.ZodObject<{
   todos: zod_v30.ZodArray<zod_v30.ZodObject<{
     content: zod_v30.ZodString;
     status: zod_v30.ZodEnum<["pending", "in_progress", "completed"]>;
@@ -2255,21 +2257,21 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
-}, _langchain_langgraph0.Command<unknown, {
+}, _langgraph.Command<unknown, {
   todos: {
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "write_todos">]>, AgentMiddleware<_langchain_langgraph0.StateSchema<{
-  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string>, unknown, "write_todos">]>, AgentMiddleware<_langgraph.StateSchema<{
+  files: _langgraph.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+}>, undefined, unknown, (_langchain.DynamicStructuredTool<zod.ZodObject<{
   path: zod.ZodDefault<zod.ZodOptional<zod.ZodString>>;
 }, zod_v4_core0.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, unknown, "ls"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "ls"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   file_path: zod.ZodString;
   offset: zod.ZodDefault<zod.ZodOptional<zod.ZodCoercedNumber<unknown>>>;
   limit: zod.ZodDefault<zod.ZodOptional<zod.ZodCoercedNumber<unknown>>>;
@@ -2281,7 +2283,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, unknown, "read_file"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "read_file"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   file_path: zod.ZodString;
   content: zod.ZodDefault<zod.ZodString>;
 }, zod_v4_core0.$strip>, {
@@ -2290,10 +2292,10 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
 }, {
   file_path: string;
   content?: string | undefined;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langgraph.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "write_file"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string>, unknown, "write_file"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   file_path: zod.ZodString;
   old_string: zod.ZodString;
   new_string: zod.ZodString;
@@ -2308,10 +2310,10 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   old_string: string;
   new_string: string;
   replace_all?: boolean | undefined;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langgraph.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, unknown, "edit_file"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string>, unknown, "edit_file"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   pattern: zod.ZodString;
   path: zod.ZodDefault<zod.ZodOptional<zod.ZodString>>;
 }, zod_v4_core0.$strip>, {
@@ -2320,7 +2322,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, unknown, "glob"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "glob"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   pattern: zod.ZodString;
   path: zod.ZodDefault<zod.ZodOptional<zod.ZodString>>;
   glob: zod.ZodNullable<zod.ZodOptional<zod.ZodString>>;
@@ -2332,13 +2334,13 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, unknown, "grep"> | langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "grep"> | _langchain.DynamicStructuredTool<zod.ZodObject<{
   command: zod.ZodString;
 }, zod_v4_core0.$strip>, {
   command: string;
 }, {
   command: string;
-}, string, unknown, "execute">)[]>, AgentMiddleware<undefined, undefined, unknown, readonly [langchain.DynamicStructuredTool<zod.ZodObject<{
+}, string, unknown, "execute">)[]>, AgentMiddleware<undefined, undefined, unknown, readonly [_langchain.DynamicStructuredTool<zod.ZodObject<{
   description: zod.ZodString;
   subagent_type: zod.ZodString;
 }, zod_v4_core0.$strip>, {
@@ -2347,7 +2349,7 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
 }, {
   description: string;
   subagent_type: string;
-}, string | _langchain_langgraph0.Command<unknown, Record<string, unknown>, string>, unknown, "task">]>, AgentMiddleware<zod.ZodObject<{
+}, string | _langgraph.Command<unknown, Record<string, unknown>, string>, unknown, "task">]>, AgentMiddleware<zod.ZodObject<{
   _summarizationSessionId: zod.ZodOptional<zod.ZodString>;
   _summarizationEvent: zod.ZodOptional<zod.ZodObject<{
     cutoffIndex: zod.ZodNumber;

package/dist/index.js

@@ -627,6 +627,62 @@ indicate omitted lines in the middle of the content):
 
 {content_sample}`;
 /**
+* Message template for evicted HumanMessages.
+*/
+const TOO_LARGE_HUMAN_MSG = `Message content too large and was saved to the filesystem at: {file_path}
+
+You can read the full content using the read_file tool with pagination (offset and limit parameters).
+
+Here is a preview showing the head and tail of the content:
+
+{content_sample}`;
+/**
+* Extract text content from a message.
+*
+* For string content, returns it directly. For array content (mixed block types
+* like text + image), joins all text blocks. Returns empty string if no text found.
+*/
+function extractTextFromMessage(message) {
+	if (typeof message.content === "string") return message.content;
+	if (Array.isArray(message.content)) return message.content.filter((block) => block.type === "text" && typeof block.text === "string").map((block) => block.text).join("\n");
+	return String(message.content);
+}
+/**
+* Build replacement content for an evicted HumanMessage, preserving non-text blocks.
+*
+* For plain string content, returns the replacement text directly. For list content
+* with mixed block types (e.g., text + image), replaces all text blocks with a single
+* text block containing the replacement text while keeping non-text blocks intact.
+*/
+function buildEvictedHumanContent(message, replacementText) {
+	if (typeof message.content === "string") return replacementText;
+	if (Array.isArray(message.content)) {
+		const mediaBlocks = message.content.filter((block) => typeof block === "object" && block !== null && block.type !== "text");
+		if (mediaBlocks.length === 0) return replacementText;
+		return [{
+			type: "text",
+			text: replacementText
+		}, ...mediaBlocks];
+	}
+	return replacementText;
+}
+/**
+* Build a truncated HumanMessage for the model request.
+*
+* Computes a preview from the full content still in state and returns a
+* lightweight replacement the model will see. Pure string computation — no
+* backend I/O.
+*/
+function buildTruncatedHumanMessage(message, filePath) {
+	const contentSample = createContentPreview(extractTextFromMessage(message));
+	return new HumanMessage({
+		content: buildEvictedHumanContent(message, TOO_LARGE_HUMAN_MSG.replace("{file_path}", filePath).replace("{content_sample}", contentSample)),
+		id: message.id,
+		additional_kwargs: { ...message.additional_kwargs },
+		response_metadata: { ...message.response_metadata }
+	});
+}
+/**
 * Create a preview of content showing head and tail with truncation marker.
 *
 * @param contentStr - The full content string to preview.
@@ -995,7 +1051,7 @@ function createExecuteTool(backend, options) {
 * Create filesystem middleware with all tools and features.
 */
 function createFilesystemMiddleware(options = {}) {
-	const { backend = (runtime) => new StateBackend(runtime), systemPrompt: customSystemPrompt = null, customToolDescriptions = null, toolTokenLimitBeforeEvict = 2e4 } = options;
+	const { backend = (runtime) => new StateBackend(runtime), systemPrompt: customSystemPrompt = null, customToolDescriptions = null, toolTokenLimitBeforeEvict = 2e4, humanMessageTokenLimitBeforeEvict = 5e4 } = options;
 	const baseSystemPrompt = customSystemPrompt || FILESYSTEM_SYSTEM_PROMPT;
 	const allToolsByName = {
 		ls: createLsTool(backend, { customDescription: customToolDescriptions?.ls }),
@@ -1013,6 +1069,32 @@ function createFilesystemMiddleware(options = {}) {
 		name: "FilesystemMiddleware",
 		stateSchema: FilesystemStateSchema,
 		tools: Object.values(allToolsByName),
+		async beforeAgent(state) {
+			if (!humanMessageTokenLimitBeforeEvict) return;
+			const messages = state.messages;
+			if (!messages || messages.length === 0) return;
+			const last = messages[messages.length - 1];
+			if (!HumanMessage.isInstance(last)) return;
+			if (last.additional_kwargs?.lc_evicted_to) return;
+			const contentStr = extractTextFromMessage(last);
+			const threshold = 4 * humanMessageTokenLimitBeforeEvict;
+			if (contentStr.length <= threshold) return;
+			const resolvedBackend = await resolveBackend(backend, { state: state || {} });
+			const filePath = `/conversation_history/${crypto.randomUUID().replace(/-/g, "").slice(0, 12)}`;
+			const writeResult = await resolvedBackend.write(filePath, contentStr);
+			if (writeResult.error) return;
+			const result = { messages: [new HumanMessage({
+				content: last.content,
+				id: last.id,
+				additional_kwargs: {
+					...last.additional_kwargs,
+					lc_evicted_to: filePath
+				},
+				response_metadata: { ...last.response_metadata }
+			})] };
+			if (writeResult.filesUpdate) result.files = writeResult.filesUpdate;
+			return result;
+		},
 		wrapModelCall: async (request, handler) => {
 			const supportsExecution = isSandboxBackend(await resolveBackend(backend, {
 				...request.runtime,
@@ -1023,9 +1105,17 @@ function createFilesystemMiddleware(options = {}) {
 			let filesystemPrompt = baseSystemPrompt;
 			if (supportsExecution) filesystemPrompt = `${filesystemPrompt}\n\n${EXECUTION_SYSTEM_PROMPT}`;
 			const newSystemMessage = request.systemMessage.concat(filesystemPrompt);
+			let messages = request.messages;
+			if (humanMessageTokenLimitBeforeEvict && messages) {
+				if (messages.some((msg) => HumanMessage.isInstance(msg) && msg.additional_kwargs?.lc_evicted_to)) messages = messages.map((msg) => {
+					if (HumanMessage.isInstance(msg) && msg.additional_kwargs?.lc_evicted_to) return buildTruncatedHumanMessage(msg, msg.additional_kwargs.lc_evicted_to);
+					return msg;
+				});
+			}
 			return handler({
 				...request,
 				tools,
+				messages,
 				systemMessage: newSystemMessage
 			});
 		},