deepagents 1.6.1 → 1.6.3

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as zod_v30 from "zod/v3";
-import * as langchain8 from "langchain";
+import * as langchain9 from "langchain";
 import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, InferMiddlewareStates, InterruptOnConfig, ReactAgent, ResponseFormat, ResponseFormatUndefined, StructuredTool, SystemMessage, ToolMessage } from "langchain";
-import * as _Command from "@langchain/langgraph";
+import * as _langchain_langgraph0 from "@langchain/langgraph";
 import { AnnotationRoot, Command, ReducedValue, StateSchema } from "@langchain/langgraph";
 import { z } from "zod/v4";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
@@ -11,7 +11,7 @@ import { z as z$1 } from "zod";
 import * as zod_v4_core0 from "zod/v4/core";
 import * as _langchain_core_language_models_base0 from "@langchain/core/language_models/base";
 import { BaseLanguageModel, LanguageModelLike } from "@langchain/core/language_models/base";
-import * as _langchain_core_tools3 from "@langchain/core/tools";
+import * as _langchain_core_tools5 from "@langchain/core/tools";
 import { ClientTool, ServerTool, StructuredTool as StructuredTool$1 } from "@langchain/core/tools";
 import { Runnable } from "@langchain/core/runnables";
 import "@langchain/core/language_models/chat_models";
@@ -314,13 +314,13 @@ interface FilesystemMiddlewareOptions {
  */
 declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOptions): AgentMiddleware<StateSchema<{
   files: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain8.DynamicStructuredTool<z.ZodObject<{
+}>, undefined, unknown, (langchain9.DynamicStructuredTool<z.ZodObject<{
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, "ls"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "ls"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
   limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -332,7 +332,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, "read_file"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "read_file"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   content: z.ZodString;
 }, z.core.$strip>, {
@@ -344,7 +344,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>, "write_file"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string>, "write_file"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   old_string: z.ZodString;
   new_string: z.ZodString;
@@ -362,7 +362,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>, "edit_file"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string>, "edit_file"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
@@ -371,7 +371,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, "glob"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "glob"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   glob: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -383,7 +383,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, "grep"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "grep"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   command: z.ZodString;
 }, z.core.$strip>, {
   command: string;
@@ -449,7 +449,7 @@ interface SubAgentMiddlewareOptions {
 /**
  * Create subagent middleware with task tool
  */
-declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [langchain8.DynamicStructuredTool<z.ZodObject<{
+declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [langchain9.DynamicStructuredTool<z.ZodObject<{
   description: z.ZodString;
   subagent_type: z.ZodString;
 }, z.core.$strip>, {
@@ -468,6 +468,12 @@ declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): A
  * the corresponding ToolMessage responses, this middleware adds synthetic
  * ToolMessages saying the tool call was cancelled.
  *
+ * This middleware patches in two places:
+ * 1. `beforeAgent`: Patches state at the start of the agent loop (handles most cases)
+ * 2. `wrapModelCall`: Patches the request right before model invocation (handles
+ *    edge cases like HITL rejection during graph resume where state updates from
+ *    beforeAgent may not be applied in time)
+ *
  * @returns AgentMiddleware that patches dangling tool calls
  *
  * @example
@@ -481,7 +487,7 @@ declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): A
  * });
  * ```
  */
-declare function createPatchToolCallsMiddleware(): AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
+declare function createPatchToolCallsMiddleware(): AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools5.ClientTool | _langchain_core_tools5.ServerTool)[]>;
 //#endregion
 //#region src/backends/state.d.ts
 /**
@@ -605,9 +611,14 @@ interface MemoryMiddlewareOptions {
  * });
  * ```
  */
-declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): AgentMiddleware<z$1.ZodObject<{
+declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): AgentMiddleware<StateSchema<{
+  /**
+   * Dict mapping source paths to their loaded content.
+   * 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>>;
-}, z$1.core.$strip>, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
+  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+}>, undefined, unknown, readonly (_langchain_core_tools5.ClientTool | _langchain_core_tools5.ServerTool)[]>;
 //#endregion
 //#region src/middleware/skills.d.ts
 declare const MAX_SKILL_FILE_SIZE: number;
@@ -688,7 +699,8 @@ declare function createSkillsMiddleware(options: SkillsMiddlewareOptions): Agent
     metadata?: Record<string, string> | undefined;
     allowedTools?: string[] | undefined;
   }[] | undefined>;
-}>, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
+  files: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+}>, undefined, unknown, readonly (_langchain_core_tools5.ClientTool | _langchain_core_tools5.ServerTool)[]>;
 //#endregion
 //#region src/backends/store.d.ts
 /**
@@ -1350,7 +1362,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[] | undefined;
-}>, undefined, unknown, readonly [langchain8.DynamicStructuredTool<zod_v30.ZodObject<{
+}>, undefined, unknown, readonly [langchain9.DynamicStructuredTool<zod_v30.ZodObject<{
   todos: zod_v30.ZodArray<zod_v30.ZodObject<{
     content: zod_v30.ZodString;
     status: zod_v30.ZodEnum<["pending", "in_progress", "completed"]>;
@@ -1381,39 +1393,21 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
-}, _Command.Command<unknown, {
+}, _langchain_langgraph0.Command<unknown, {
   todos: {
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, "write_todos">]>, ...(AgentMiddleware<_Command.StateSchema<{
-  skillsMetadata: _Command.ReducedValue<{
-    name: string;
-    description: string;
-    path: string;
-    license?: string | null | undefined;
-    compatibility?: string | null | undefined;
-    metadata?: Record<string, string> | undefined;
-    allowedTools?: string[] | undefined;
-  }[] | undefined, {
-    name: string;
-    description: string;
-    path: string;
-    license?: string | null | undefined;
-    compatibility?: string | null | undefined;
-    metadata?: Record<string, string> | undefined;
-    allowedTools?: string[] | undefined;
-  }[] | undefined>;
-}>, undefined, unknown, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<_Command.StateSchema<{
-  files: _Command.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string>, "write_todos">]>, AgentMiddleware<_langchain_langgraph0.StateSchema<{
+  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+}>, undefined, unknown, (langchain9.DynamicStructuredTool<zod0.ZodObject<{
   path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
 }, zod_v4_core0.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, "ls"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "ls"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   file_path: zod0.ZodString;
   offset: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodCoercedNumber<unknown>>>;
   limit: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodCoercedNumber<unknown>>>;
@@ -1425,7 +1419,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, "read_file"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "read_file"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   file_path: zod0.ZodString;
   content: zod0.ZodString;
 }, zod_v4_core0.$strip>, {
@@ -1434,10 +1428,10 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
 }, {
   file_path: string;
   content: string;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _Command.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, "write_file"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string>, "write_file"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   file_path: zod0.ZodString;
   old_string: zod0.ZodString;
   new_string: zod0.ZodString;
@@ -1452,10 +1446,10 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   old_string: string;
   new_string: string;
   replace_all?: boolean | undefined;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _Command.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, "edit_file"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string>, "edit_file"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   pattern: zod0.ZodString;
   path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
 }, zod_v4_core0.$strip>, {
@@ -1464,7 +1458,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, "glob"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "glob"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   pattern: zod0.ZodString;
   path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
   glob: zod0.ZodNullable<zod0.ZodOptional<zod0.ZodString>>;
@@ -1476,13 +1470,22 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, "grep"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "grep"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   command: zod0.ZodString;
 }, zod_v4_core0.$strip>, {
   command: string;
 }, {
   command: string;
-}, string, "execute">)[]> | AgentMiddleware<undefined, zod_v30.ZodObject<{
+}, string, "execute">)[]>, AgentMiddleware<undefined, undefined, unknown, readonly [langchain9.DynamicStructuredTool<zod0.ZodObject<{
+  description: zod0.ZodString;
+  subagent_type: zod0.ZodString;
+}, zod_v4_core0.$strip>, {
+  description: string;
+  subagent_type: string;
+}, {
+  description: string;
+  subagent_type: string;
+}, string | _langchain_langgraph0.Command<unknown, Record<string, unknown>, string>, "task">]>, AgentMiddleware<undefined, zod_v30.ZodObject<{
   trigger: zod_v30.ZodOptional<zod_v30.ZodUnion<[zod_v30.ZodEffects<zod_v30.ZodObject<{
     fraction: zod_v30.ZodOptional<zod_v30.ZodNumber>;
     tokens: zod_v30.ZodOptional<zod_v30.ZodNumber>;
@@ -1619,7 +1622,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   maxTokensBeforeSummary?: number | undefined;
   messagesToKeep?: number | undefined;
   model?: _langchain_core_language_models_base0.BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
-}, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, zod_v30.ZodObject<{
+}, readonly (ClientTool | ServerTool)[]>, AgentMiddleware<undefined, zod_v30.ZodObject<{
   enableCaching: zod_v30.ZodOptional<zod_v30.ZodBoolean>;
   ttl: zod_v30.ZodOptional<zod_v30.ZodEnum<["5m", "1h"]>>;
   minMessagesToCache: zod_v30.ZodOptional<zod_v30.ZodNumber>;
@@ -1639,18 +1642,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   ttl?: "1h" | "5m" | undefined;
   minMessagesToCache?: number | undefined;
   unsupportedModelBehavior?: "ignore" | "raise" | "warn" | undefined;
-}, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, undefined, unknown, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, undefined, unknown, readonly [langchain8.DynamicStructuredTool<zod0.ZodObject<{
-  description: zod0.ZodString;
-  subagent_type: zod0.ZodString;
-}, zod_v4_core0.$strip>, {
-  description: string;
-  subagent_type: string;
-}, {
-  description: string;
-  subagent_type: string;
-}, string | _Command.Command<unknown, Record<string, unknown>, string>, "task">]> | AgentMiddleware<zod0.ZodObject<{
-  memoryContents: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
-}, zod_v4_core0.$strip>, undefined, unknown, readonly (ClientTool | ServerTool)[]>)[], ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools, TSubagents>>;
+}, readonly (ClientTool | ServerTool)[]>, AgentMiddleware<undefined, undefined, unknown, readonly (ClientTool | ServerTool)[]>, ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools, TSubagents>>;
 //#endregion
 //#region src/config.d.ts
 /**
@@ -1753,6 +1745,31 @@ declare function findProjectRoot(startPath?: string): string | null;
  */
 declare function createSettings(options?: SettingsOptions): Settings;
 //#endregion
+//#region src/values.d.ts
+/**
+ * Shared ReducedValue for file data state management.
+ *
+ * This provides a reusable pattern for managing file state with automatic
+ * merging of concurrent updates from parallel subagents. Files can be updated
+ * or deleted (using null values) and the reducer handles the merge logic.
+ *
+ * Similar to LangGraph's messagesValue, this encapsulates the common pattern
+ * of managing files in agent state so you don't have to manually configure
+ * the ReducedValue each time.
+ *
+ * @example
+ * ```typescript
+ * import { filesValue } from "@anthropic/deepagents";
+ * import { StateSchema } from "@langchain/langgraph";
+ *
+ * const MyStateSchema = new StateSchema({
+ *   files: filesValue,
+ *   // ... other state fields
+ * });
+ * ```
+ */
+declare const filesValue: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+//#endregion
 //#region src/middleware/agent-memory.d.ts
 /**
  * Options for the agent memory middleware.
@@ -1778,7 +1795,7 @@ interface AgentMemoryMiddlewareOptions {
  * @deprecated Use `createMemoryMiddleware` from `./memory.js` instead.
  * This function uses direct filesystem access which limits portability.
  */
-declare function createAgentMemoryMiddleware(options: AgentMemoryMiddlewareOptions): AgentMiddleware<any, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
+declare function createAgentMemoryMiddleware(options: AgentMemoryMiddlewareOptions): AgentMiddleware<any, undefined, unknown, readonly (_langchain_core_tools5.ClientTool | _langchain_core_tools5.ServerTool)[]>;
 //#endregion
 //#region src/skills/loader.d.ts
 /**
@@ -1832,5 +1849,5 @@ declare function parseSkillMetadata(skillMdPath: string, source: "user" | "proje
  */
 declare function listSkills(options: ListSkillsOptions): SkillMetadata[];
 //#endregion
-export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type DeepAgent, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FlattenSubAgentMiddleware, type GrepMatch, type InferDeepAgentSubagents, type InferDeepAgentType, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
+export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type DeepAgent, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FlattenSubAgentMiddleware, type GrepMatch, type InferDeepAgentSubagents, type InferDeepAgentType, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, filesValue, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import * as langchain8 from "langchain";
+import * as langchain9 from "langchain";
 import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, InferMiddlewareStates, InterruptOnConfig, ReactAgent, ResponseFormat, ResponseFormatUndefined, StructuredTool, SystemMessage, ToolMessage } from "langchain";
-import * as _Command from "@langchain/langgraph";
+import * as _langchain_langgraph0 from "@langchain/langgraph";
 import { AnnotationRoot, Command, ReducedValue, StateSchema } from "@langchain/langgraph";
 import { z } from "zod/v4";
 import * as _messages from "@langchain/core/messages";
@@ -314,13 +314,13 @@ interface FilesystemMiddlewareOptions {
  */
 declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOptions): AgentMiddleware<StateSchema<{
   files: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain8.DynamicStructuredTool<z.ZodObject<{
+}>, undefined, unknown, (langchain9.DynamicStructuredTool<z.ZodObject<{
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, "ls"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "ls"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
   limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -332,7 +332,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, "read_file"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "read_file"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   content: z.ZodString;
 }, z.core.$strip>, {
@@ -344,7 +344,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>, "write_file"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string>, "write_file"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
   old_string: z.ZodString;
   new_string: z.ZodString;
@@ -362,7 +362,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>, "edit_file"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string>, "edit_file"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>, {
@@ -371,7 +371,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, "glob"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "glob"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   pattern: z.ZodString;
   path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   glob: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -383,7 +383,7 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, "grep"> | langchain8.DynamicStructuredTool<z.ZodObject<{
+}, string, "grep"> | langchain9.DynamicStructuredTool<z.ZodObject<{
   command: z.ZodString;
 }, z.core.$strip>, {
   command: string;
@@ -449,7 +449,7 @@ interface SubAgentMiddlewareOptions {
 /**
  * Create subagent middleware with task tool
  */
-declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [langchain8.DynamicStructuredTool<z.ZodObject<{
+declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): AgentMiddleware$1<undefined, undefined, unknown, readonly [langchain9.DynamicStructuredTool<z.ZodObject<{
   description: z.ZodString;
   subagent_type: z.ZodString;
 }, z.core.$strip>, {
@@ -468,6 +468,12 @@ declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): A
  * the corresponding ToolMessage responses, this middleware adds synthetic
  * ToolMessages saying the tool call was cancelled.
  *
+ * This middleware patches in two places:
+ * 1. `beforeAgent`: Patches state at the start of the agent loop (handles most cases)
+ * 2. `wrapModelCall`: Patches the request right before model invocation (handles
+ *    edge cases like HITL rejection during graph resume where state updates from
+ *    beforeAgent may not be applied in time)
+ *
  * @returns AgentMiddleware that patches dangling tool calls
  *
  * @example
@@ -605,9 +611,14 @@ interface MemoryMiddlewareOptions {
  * });
  * ```
  */
-declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): AgentMiddleware<z$1.ZodObject<{
+declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): AgentMiddleware<StateSchema<{
+  /**
+   * Dict mapping source paths to their loaded content.
+   * 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>>;
-}, z$1.core.$strip>, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
+  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+}>, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
 //#endregion
 //#region src/middleware/skills.d.ts
 declare const MAX_SKILL_FILE_SIZE: number;
@@ -688,6 +699,7 @@ declare function createSkillsMiddleware(options: SkillsMiddlewareOptions): Agent
     metadata?: Record<string, string> | undefined;
     allowedTools?: string[] | undefined;
   }[] | undefined>;
+  files: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
 }>, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
 //#endregion
 //#region src/backends/store.d.ts
@@ -1350,7 +1362,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[] | undefined;
-}>, undefined, unknown, readonly [langchain8.DynamicStructuredTool<zod_v30.ZodObject<{
+}>, undefined, unknown, readonly [langchain9.DynamicStructuredTool<zod_v30.ZodObject<{
   todos: zod_v30.ZodArray<zod_v30.ZodObject<{
     content: zod_v30.ZodString;
     status: zod_v30.ZodEnum<["pending", "in_progress", "completed"]>;
@@ -1381,39 +1393,21 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
-}, _Command.Command<unknown, {
+}, _langchain_langgraph0.Command<unknown, {
   todos: {
     content: string;
     status: "completed" | "in_progress" | "pending";
   }[];
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, "write_todos">]>, ...(AgentMiddleware<_Command.StateSchema<{
-  skillsMetadata: _Command.ReducedValue<{
-    name: string;
-    description: string;
-    path: string;
-    license?: string | null | undefined;
-    compatibility?: string | null | undefined;
-    metadata?: Record<string, string> | undefined;
-    allowedTools?: string[] | undefined;
-  }[] | undefined, {
-    name: string;
-    description: string;
-    path: string;
-    license?: string | null | undefined;
-    compatibility?: string | null | undefined;
-    metadata?: Record<string, string> | undefined;
-    allowedTools?: string[] | undefined;
-  }[] | undefined>;
-}>, undefined, unknown, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<_Command.StateSchema<{
-  files: _Command.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
-}>, undefined, unknown, (langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string>, "write_todos">]>, AgentMiddleware<_langchain_langgraph0.StateSchema<{
+  files: _langchain_langgraph0.ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+}>, undefined, unknown, (langchain9.DynamicStructuredTool<zod0.ZodObject<{
   path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
 }, zod_v4_core0.$strip>, {
   path: string;
 }, {
   path?: string | undefined;
-}, string, "ls"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "ls"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   file_path: zod0.ZodString;
   offset: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodCoercedNumber<unknown>>>;
   limit: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodCoercedNumber<unknown>>>;
@@ -1425,7 +1419,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   file_path: string;
   offset?: unknown;
   limit?: unknown;
-}, string, "read_file"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "read_file"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   file_path: zod0.ZodString;
   content: zod0.ZodString;
 }, zod_v4_core0.$strip>, {
@@ -1434,10 +1428,10 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
 }, {
   file_path: string;
   content: string;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _Command.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, "write_file"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string>, "write_file"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   file_path: zod0.ZodString;
   old_string: zod0.ZodString;
   new_string: zod0.ZodString;
@@ -1452,10 +1446,10 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   old_string: string;
   new_string: string;
   replace_all?: boolean | undefined;
-}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _Command.Command<unknown, {
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, "edit_file"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string>, "edit_file"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   pattern: zod0.ZodString;
   path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
 }, zod_v4_core0.$strip>, {
@@ -1464,7 +1458,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
 }, {
   pattern: string;
   path?: string | undefined;
-}, string, "glob"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "glob"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   pattern: zod0.ZodString;
   path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
   glob: zod0.ZodNullable<zod0.ZodOptional<zod0.ZodString>>;
@@ -1476,13 +1470,22 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   pattern: string;
   path?: string | undefined;
   glob?: string | null | undefined;
-}, string, "grep"> | langchain8.DynamicStructuredTool<zod0.ZodObject<{
+}, string, "grep"> | langchain9.DynamicStructuredTool<zod0.ZodObject<{
   command: zod0.ZodString;
 }, zod_v4_core0.$strip>, {
   command: string;
 }, {
   command: string;
-}, string, "execute">)[]> | AgentMiddleware<undefined, zod_v30.ZodObject<{
+}, string, "execute">)[]>, AgentMiddleware<undefined, undefined, unknown, readonly [langchain9.DynamicStructuredTool<zod0.ZodObject<{
+  description: zod0.ZodString;
+  subagent_type: zod0.ZodString;
+}, zod_v4_core0.$strip>, {
+  description: string;
+  subagent_type: string;
+}, {
+  description: string;
+  subagent_type: string;
+}, string | _langchain_langgraph0.Command<unknown, Record<string, unknown>, string>, "task">]>, AgentMiddleware<undefined, zod_v30.ZodObject<{
   trigger: zod_v30.ZodOptional<zod_v30.ZodUnion<[zod_v30.ZodEffects<zod_v30.ZodObject<{
     fraction: zod_v30.ZodOptional<zod_v30.ZodNumber>;
     tokens: zod_v30.ZodOptional<zod_v30.ZodNumber>;
@@ -1619,7 +1622,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   maxTokensBeforeSummary?: number | undefined;
   messagesToKeep?: number | undefined;
   model?: _langchain_core_language_models_base0.BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
-}, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, zod_v30.ZodObject<{
+}, readonly (ClientTool | ServerTool)[]>, AgentMiddleware<undefined, zod_v30.ZodObject<{
   enableCaching: zod_v30.ZodOptional<zod_v30.ZodBoolean>;
   ttl: zod_v30.ZodOptional<zod_v30.ZodEnum<["5m", "1h"]>>;
   minMessagesToCache: zod_v30.ZodOptional<zod_v30.ZodNumber>;
@@ -1639,18 +1642,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   ttl?: "1h" | "5m" | undefined;
   minMessagesToCache?: number | undefined;
   unsupportedModelBehavior?: "ignore" | "raise" | "warn" | undefined;
-}, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, undefined, unknown, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, undefined, unknown, readonly [langchain8.DynamicStructuredTool<zod0.ZodObject<{
-  description: zod0.ZodString;
-  subagent_type: zod0.ZodString;
-}, zod_v4_core0.$strip>, {
-  description: string;
-  subagent_type: string;
-}, {
-  description: string;
-  subagent_type: string;
-}, string | _Command.Command<unknown, Record<string, unknown>, string>, "task">]> | AgentMiddleware<zod0.ZodObject<{
-  memoryContents: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
-}, zod_v4_core0.$strip>, undefined, unknown, readonly (ClientTool | ServerTool)[]>)[], ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools, TSubagents>>;
+}, readonly (ClientTool | ServerTool)[]>, AgentMiddleware<undefined, undefined, unknown, readonly (ClientTool | ServerTool)[]>, ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools, TSubagents>>;
 //#endregion
 //#region src/config.d.ts
 /**
@@ -1753,6 +1745,31 @@ declare function findProjectRoot(startPath?: string): string | null;
  */
 declare function createSettings(options?: SettingsOptions): Settings;
 //#endregion
+//#region src/values.d.ts
+/**
+ * Shared ReducedValue for file data state management.
+ *
+ * This provides a reusable pattern for managing file state with automatic
+ * merging of concurrent updates from parallel subagents. Files can be updated
+ * or deleted (using null values) and the reducer handles the merge logic.
+ *
+ * Similar to LangGraph's messagesValue, this encapsulates the common pattern
+ * of managing files in agent state so you don't have to manually configure
+ * the ReducedValue each time.
+ *
+ * @example
+ * ```typescript
+ * import { filesValue } from "@anthropic/deepagents";
+ * import { StateSchema } from "@langchain/langgraph";
+ *
+ * const MyStateSchema = new StateSchema({
+ *   files: filesValue,
+ *   // ... other state fields
+ * });
+ * ```
+ */
+declare const filesValue: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
+//#endregion
 //#region src/middleware/agent-memory.d.ts
 /**
  * Options for the agent memory middleware.
@@ -1832,5 +1849,5 @@ declare function parseSkillMetadata(skillMdPath: string, source: "user" | "proje
  */
 declare function listSkills(options: ListSkillsOptions): SkillMetadata[];
 //#endregion
-export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type DeepAgent, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FlattenSubAgentMiddleware, type GrepMatch, type InferDeepAgentSubagents, type InferDeepAgentType, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
+export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type DeepAgent, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FlattenSubAgentMiddleware, type GrepMatch, type InferDeepAgentSubagents, type InferDeepAgentType, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, filesValue, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
 //# sourceMappingURL=index.d.ts.map