deepagents 1.3.1 → 1.4.0

package/dist/index.d.ts

@@ -1,9 +1,17 @@
 import * as langchain0 from "langchain";
-import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, InterruptOnConfig, ReactAgent, StructuredTool } from "langchain";
-import { AnnotationRoot } from "@langchain/langgraph";
-import { StructuredTool as StructuredTool$1 } from "@langchain/core/tools";
-import { BaseLanguageModel, LanguageModelLike } from "@langchain/core/language_models/base";
+import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, InterruptOnConfig, ReactAgent, StructuredTool, ToolMessage } from "langchain";
+import * as _Command from "@langchain/langgraph";
+import { AnnotationRoot, Command } from "@langchain/langgraph";
+import { z } from "zod/v4";
+import * as zod_v30 from "zod/v3";
+import * as _messages from "@langchain/core/messages";
+import * as zod0 from "zod";
+import * as zod_v4_core0 from "zod/v4/core";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
+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_tools1 from "@langchain/core/tools";
+import { StructuredTool as StructuredTool$1 } from "@langchain/core/tools";
 import { Runnable } from "@langchain/core/runnables";
 import { InteropZodObject } from "@langchain/core/utils/types";
 
@@ -91,6 +99,42 @@ interface EditResult {
   /** Metadata for the edit operation, attached to the ToolMessage */
   metadata?: Record<string, unknown>;
 }
+/**
+ * Result of code execution.
+ * Simplified schema optimized for LLM consumption.
+ */
+interface ExecuteResponse {
+  /** Combined stdout and stderr output of the executed command */
+  output: string;
+  /** The process exit code. 0 indicates success, non-zero indicates failure */
+  exitCode: number | null;
+  /** Whether the output was truncated due to backend limitations */
+  truncated: boolean;
+}
+/**
+ * Standardized error codes for file upload/download operations.
+ */
+type FileOperationError = "file_not_found" | "permission_denied" | "is_directory" | "invalid_path";
+/**
+ * Result of a single file download operation.
+ */
+interface FileDownloadResponse {
+  /** The file path that was requested */
+  path: string;
+  /** File contents as Uint8Array on success, null on failure */
+  content: Uint8Array | null;
+  /** Standardized error code on failure, null on success */
+  error: FileOperationError | null;
+}
+/**
+ * Result of a single file upload operation.
+ */
+interface FileUploadResponse {
+  /** The file path that was requested */
+  path: string;
+  /** Standardized error code on failure, null on success */
+  error: FileOperationError | null;
+}
 /**
  * Protocol for pluggable memory backends (single, unified).
  *
@@ -166,7 +210,44 @@ interface BackendProtocol {
    * @returns EditResult with error, path, filesUpdate, and occurrences
    */
   edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): MaybePromise<EditResult>;
+  /**
+   * Upload multiple files.
+   *
+   * @param files - List of [path, content] tuples to upload
+   * @returns List of FileUploadResponse objects, one per input file
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): MaybePromise<FileUploadResponse[]>;
+  /**
+   * Download multiple files.
+   *
+   * @param paths - List of file paths to download
+   * @returns List of FileDownloadResponse objects, one per input path
+   */
+  downloadFiles(paths: string[]): MaybePromise<FileDownloadResponse[]>;
 }
+/**
+ * Protocol for sandboxed backends with isolated runtime.
+ * Sandboxed backends run in isolated environments (e.g., containers)
+ * and communicate via defined interfaces.
+ */
+interface SandboxBackendProtocol extends BackendProtocol {
+  /**
+   * Execute a command in the sandbox.
+   *
+   * @param command - Full shell command string to execute
+   * @returns ExecuteResponse with combined output, exit code, and truncation flag
+   */
+  execute(command: string): MaybePromise<ExecuteResponse>;
+  /** Unique identifier for the sandbox backend instance */
+  readonly id: string;
+}
+/**
+ * Type guard to check if a backend supports execution.
+ *
+ * @param backend - Backend instance to check
+ * @returns True if the backend implements SandboxBackendProtocol
+ */
+declare function isSandboxBackend(backend: BackendProtocol): backend is SandboxBackendProtocol;
 /**
  * State and store container for backend initialization.
  *
@@ -219,7 +300,88 @@ interface FilesystemMiddlewareOptions {
 /**
  * Create filesystem middleware with all tools and features.
  */
-declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOptions): langchain0.AgentMiddleware<any, undefined, any>;
+declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOptions): AgentMiddleware<z.ZodObject<{
+  files: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    content: z.ZodArray<z.ZodString>;
+    created_at: z.ZodString;
+    modified_at: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>, undefined, unknown, (langchain0.DynamicStructuredTool<z.ZodObject<{
+  path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>, {
+  path: string;
+}, {
+  path?: string | undefined;
+}, string, "ls"> | langchain0.DynamicStructuredTool<z.ZodObject<{
+  file_path: z.ZodString;
+  offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+  limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+}, z.core.$strip>, {
+  file_path: string;
+  offset: number;
+  limit: number;
+}, {
+  file_path: string;
+  offset?: unknown;
+  limit?: unknown;
+}, string, "read_file"> | langchain0.DynamicStructuredTool<z.ZodObject<{
+  file_path: z.ZodString;
+  content: z.ZodString;
+}, z.core.$strip>, {
+  file_path: string;
+  content: string;
+}, {
+  file_path: string;
+  content: string;
+}, string | ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | Command<unknown, {
+  files: Record<string, FileData>;
+  messages: ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
+}, string>, "write_file"> | langchain0.DynamicStructuredTool<z.ZodObject<{
+  file_path: z.ZodString;
+  old_string: z.ZodString;
+  new_string: z.ZodString;
+  replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, {
+  file_path: string;
+  old_string: string;
+  new_string: string;
+  replace_all: boolean;
+}, {
+  file_path: string;
+  old_string: string;
+  new_string: string;
+  replace_all?: boolean | undefined;
+}, string | ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | Command<unknown, {
+  files: Record<string, FileData>;
+  messages: ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
+}, string>, "edit_file"> | langchain0.DynamicStructuredTool<z.ZodObject<{
+  pattern: z.ZodString;
+  path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>, {
+  pattern: string;
+  path: string;
+}, {
+  pattern: string;
+  path?: string | undefined;
+}, string, "glob"> | langchain0.DynamicStructuredTool<z.ZodObject<{
+  pattern: z.ZodString;
+  path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  glob: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>, {
+  pattern: string;
+  path: string;
+  glob?: string | null | undefined;
+}, {
+  pattern: string;
+  path?: string | undefined;
+  glob?: string | null | undefined;
+}, string, "grep"> | langchain0.DynamicStructuredTool<z.ZodObject<{
+  command: z.ZodString;
+}, z.core.$strip>, {
+  command: string;
+}, {
+  command: string;
+}, string, "execute">)[]>;
 //#endregion
 //#region src/middleware/subagents.d.ts
 /**
@@ -231,7 +393,7 @@ interface CompiledSubAgent {
   /** The description of the agent */
   description: string;
   /** The agent instance */
-  runnable: ReactAgent<any, any, any, any> | Runnable;
+  runnable: ReactAgent | Runnable;
 }
 /**
  * Type definitions for subagents
@@ -299,7 +461,7 @@ declare function createSubAgentMiddleware(options: SubAgentMiddlewareOptions): A
  * });
  * ```
  */
-declare function createPatchToolCallsMiddleware(): AgentMiddleware;
+declare function createPatchToolCallsMiddleware(): AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools1.ClientTool | _langchain_core_tools1.ServerTool)[]>;
 //#endregion
 //#region src/backends/state.d.ts
 /**
@@ -362,6 +524,25 @@ declare class StateBackend implements BackendProtocol {
    * Structured glob matching returning FileInfo objects.
    */
   globInfo(pattern: string, path?: string): FileInfo[];
+  /**
+   * Upload multiple files.
+   *
+   * Note: Since LangGraph state must be updated via Command objects,
+   * the caller must apply filesUpdate via Command after calling this method.
+   *
+   * @param files - List of [path, content] tuples to upload
+   * @returns List of FileUploadResponse objects, one per input file
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): FileUploadResponse[] & {
+    filesUpdate?: Record<string, FileData>;
+  };
+  /**
+   * Download multiple files.
+   *
+   * @param paths - List of file paths to download
+   * @returns List of FileDownloadResponse objects, one per input path
+   */
+  downloadFiles(paths: string[]): FileDownloadResponse[];
 }
 //#endregion
 //#region src/backends/store.d.ts
@@ -457,6 +638,20 @@ declare class StoreBackend implements BackendProtocol {
    * Structured glob matching returning FileInfo objects.
    */
   globInfo(pattern: string, path?: string): Promise<FileInfo[]>;
+  /**
+   * Upload multiple files.
+   *
+   * @param files - List of [path, content] tuples to upload
+   * @returns List of FileUploadResponse objects, one per input file
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download multiple files.
+   *
+   * @param paths - List of file paths to download
+   * @returns List of FileDownloadResponse objects, one per input path
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
 }
 //#endregion
 //#region src/backends/filesystem.d.ts
@@ -540,6 +735,20 @@ declare class FilesystemBackend implements BackendProtocol {
    * Structured glob matching returning FileInfo objects.
    */
   globInfo(pattern: string, searchPath?: string): Promise<FileInfo[]>;
+  /**
+   * Upload multiple files to the filesystem.
+   *
+   * @param files - List of [path, content] tuples to upload
+   * @returns List of FileUploadResponse objects, one per input file
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download multiple files from the filesystem.
+   *
+   * @param paths - List of file paths to download
+   * @returns List of FileDownloadResponse objects, one per input path
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
 }
 //#endregion
 //#region src/backends/composite.d.ts
@@ -615,6 +824,98 @@ declare class CompositeBackend implements BackendProtocol {
    * @returns EditResult with path, occurrences, or error
    */
   edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
+  /**
+   * Execute a command via the default backend.
+   * Execution is not path-specific, so it always delegates to the default backend.
+   *
+   * @param command - Full shell command string to execute
+   * @returns ExecuteResponse with combined output, exit code, and truncation flag
+   * @throws Error if the default backend doesn't support command execution
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload multiple files, batching by backend for efficiency.
+   *
+   * @param files - List of [path, content] tuples to upload
+   * @returns List of FileUploadResponse objects, one per input file
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download multiple files, batching by backend for efficiency.
+   *
+   * @param paths - List of file paths to download
+   * @returns List of FileDownloadResponse objects, one per input path
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+}
+//#endregion
+//#region src/backends/sandbox.d.ts
+/**
+ * Base sandbox implementation with execute() as the only abstract method.
+ *
+ * This class provides default implementations for all SandboxBackendProtocol
+ * methods using shell commands executed via execute(). Concrete implementations
+ * only need to implement the execute() method.
+ *
+ * Requires Node.js 20+ on the sandbox host.
+ */
+declare abstract class BaseSandbox implements SandboxBackendProtocol {
+  /** Unique identifier for the sandbox backend */
+  abstract readonly id: string;
+  /**
+   * Execute a command in the sandbox.
+   * This is the only method concrete implementations must provide.
+   */
+  abstract execute(command: string): MaybePromise<ExecuteResponse>;
+  /**
+   * Upload multiple files to the sandbox.
+   * Implementations must support partial success.
+   */
+  abstract uploadFiles(files: Array<[string, Uint8Array]>): MaybePromise<FileUploadResponse[]>;
+  /**
+   * Download multiple files from the sandbox.
+   * Implementations must support partial success.
+   */
+  abstract downloadFiles(paths: string[]): MaybePromise<FileDownloadResponse[]>;
+  /**
+   * List files and directories in the specified directory (non-recursive).
+   *
+   * @param path - Absolute path to directory
+   * @returns List of FileInfo objects for files and directories directly in the directory.
+   */
+  lsInfo(path: string): Promise<FileInfo[]>;
+  /**
+   * Read file content with line numbers.
+   *
+   * @param filePath - Absolute file path
+   * @param offset - Line offset to start reading from (0-indexed)
+   * @param limit - Maximum number of lines to read
+   * @returns Formatted file content with line numbers, or error message
+   */
+  read(filePath: string, offset?: number, limit?: number): Promise<string>;
+  /**
+   * Read file content as raw FileData.
+   *
+   * @param filePath - Absolute file path
+   * @returns Raw file content as FileData
+   */
+  readRaw(filePath: string): Promise<FileData>;
+  /**
+   * Structured search results or error string for invalid input.
+   */
+  grepRaw(pattern: string, path?: string, glob?: string | null): Promise<GrepMatch[] | string>;
+  /**
+   * Structured glob matching returning FileInfo objects.
+   */
+  globInfo(pattern: string, path?: string): Promise<FileInfo[]>;
+  /**
+   * Create a new file with content.
+   */
+  write(filePath: string, content: string): Promise<WriteResult>;
+  /**
+   * Edit a file by replacing string occurrences.
+   */
+  edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
 }
 //#endregion
 //#region src/agent.d.ts
@@ -670,6 +971,540 @@ interface CreateDeepAgentParams<ContextSchema extends AnnotationRoot<any> | Inte
  * @param params Configuration parameters for the agent
  * @returns ReactAgent instance ready for invocation
  */
-declare function createDeepAgent<ContextSchema extends AnnotationRoot<any> | InteropZodObject = AnnotationRoot<any>>(params?: CreateDeepAgentParams<ContextSchema>): ReactAgent<any, any, ContextSchema, any>;
+declare function createDeepAgent<ContextSchema extends InteropZodObject = InteropZodObject>(params?: CreateDeepAgentParams<ContextSchema>): ReactAgent<AgentTypeConfig<Record<string, any>, undefined, ContextSchema, (AgentMiddleware<any, any, any, readonly (_langchain_core_tools1.ClientTool | _langchain_core_tools1.ServerTool)[]> | AgentMiddleware<zod_v30.ZodObject<{
+  todos: zod_v30.ZodDefault<zod_v30.ZodArray<zod_v30.ZodObject<{
+    content: zod_v30.ZodString;
+    status: zod_v30.ZodEnum<["pending", "in_progress", "completed"]>;
+  }, "strip", zod_v30.ZodTypeAny, {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }, {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }>, "many">>;
+}, "strip", zod_v30.ZodTypeAny, {
+  todos: {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }[];
+}, {
+  todos?: {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }[] | undefined;
+}>, undefined, unknown, readonly [_langchain_core_tools1.DynamicStructuredTool<zod_v30.ZodObject<{
+  todos: zod_v30.ZodArray<zod_v30.ZodObject<{
+    content: zod_v30.ZodString;
+    status: zod_v30.ZodEnum<["pending", "in_progress", "completed"]>;
+  }, "strip", zod_v30.ZodTypeAny, {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }, {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }>, "many">;
+}, "strip", zod_v30.ZodTypeAny, {
+  todos: {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }[];
+}, {
+  todos: {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }[];
+}>, {
+  todos: {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }[];
+}, {
+  todos: {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }[];
+}, _Command.Command<unknown, {
+  todos: {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+  }[];
+  messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
+}, string>, "write_todos">]> | AgentMiddleware<zod0.ZodObject<{
+  files: zod0.ZodDefault<zod0.ZodRecord<zod0.ZodString, zod0.ZodObject<{
+    content: zod0.ZodArray<zod0.ZodString>;
+    created_at: zod0.ZodString;
+    modified_at: zod0.ZodString;
+  }, zod_v4_core0.$strip>>>;
+}, zod_v4_core0.$strip>, undefined, unknown, (_langchain_core_tools1.DynamicStructuredTool<zod0.ZodObject<{
+  path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
+}, zod_v4_core0.$strip>, {
+  path: string;
+}, {
+  path?: string | undefined;
+}, string, "ls"> | _langchain_core_tools1.DynamicStructuredTool<zod0.ZodObject<{
+  file_path: zod0.ZodString;
+  offset: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodCoercedNumber<unknown>>>;
+  limit: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodCoercedNumber<unknown>>>;
+}, zod_v4_core0.$strip>, {
+  file_path: string;
+  offset: number;
+  limit: number;
+}, {
+  file_path: string;
+  offset?: unknown;
+  limit?: unknown;
+}, string, "read_file"> | _langchain_core_tools1.DynamicStructuredTool<zod0.ZodObject<{
+  file_path: zod0.ZodString;
+  content: zod0.ZodString;
+}, zod_v4_core0.$strip>, {
+  file_path: string;
+  content: string;
+}, {
+  file_path: string;
+  content: string;
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _Command.Command<unknown, {
+  files: Record<string, FileData>;
+  messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
+}, string>, "write_file"> | _langchain_core_tools1.DynamicStructuredTool<zod0.ZodObject<{
+  file_path: zod0.ZodString;
+  old_string: zod0.ZodString;
+  new_string: zod0.ZodString;
+  replace_all: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodBoolean>>;
+}, zod_v4_core0.$strip>, {
+  file_path: string;
+  old_string: string;
+  new_string: string;
+  replace_all: boolean;
+}, {
+  file_path: string;
+  old_string: string;
+  new_string: string;
+  replace_all?: boolean | undefined;
+}, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _Command.Command<unknown, {
+  files: Record<string, FileData>;
+  messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
+}, string>, "edit_file"> | _langchain_core_tools1.DynamicStructuredTool<zod0.ZodObject<{
+  pattern: zod0.ZodString;
+  path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
+}, zod_v4_core0.$strip>, {
+  pattern: string;
+  path: string;
+}, {
+  pattern: string;
+  path?: string | undefined;
+}, string, "glob"> | _langchain_core_tools1.DynamicStructuredTool<zod0.ZodObject<{
+  pattern: zod0.ZodString;
+  path: zod0.ZodDefault<zod0.ZodOptional<zod0.ZodString>>;
+  glob: zod0.ZodNullable<zod0.ZodOptional<zod0.ZodString>>;
+}, zod_v4_core0.$strip>, {
+  pattern: string;
+  path: string;
+  glob?: string | null | undefined;
+}, {
+  pattern: string;
+  path?: string | undefined;
+  glob?: string | null | undefined;
+}, string, "grep"> | _langchain_core_tools1.DynamicStructuredTool<zod0.ZodObject<{
+  command: zod0.ZodString;
+}, zod_v4_core0.$strip>, {
+  command: string;
+}, {
+  command: string;
+}, string, "execute">)[]> | 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>;
+    messages: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+  }, "strip", zod_v30.ZodTypeAny, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }>, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }>, zod_v30.ZodArray<zod_v30.ZodEffects<zod_v30.ZodObject<{
+    fraction: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+    tokens: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+    messages: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+  }, "strip", zod_v30.ZodTypeAny, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }>, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }>, "many">]>>;
+  keep: zod_v30.ZodOptional<zod_v30.ZodEffects<zod_v30.ZodObject<{
+    fraction: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+    tokens: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+    messages: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+  }, "strip", zod_v30.ZodTypeAny, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }>, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }, {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }>>;
+  tokenCounter: zod_v30.ZodOptional<zod_v30.ZodFunction<zod_v30.ZodTuple<[zod_v30.ZodArray<zod_v30.ZodType<_messages.BaseMessage<_messages.MessageStructure<_messages.MessageToolSet>, _messages.MessageType>, zod_v30.ZodTypeDef, _messages.BaseMessage<_messages.MessageStructure<_messages.MessageToolSet>, _messages.MessageType>>, "many">], zod_v30.ZodUnknown>, zod_v30.ZodUnion<[zod_v30.ZodNumber, zod_v30.ZodPromise<zod_v30.ZodNumber>]>>>;
+  summaryPrompt: zod_v30.ZodDefault<zod_v30.ZodString>;
+  trimTokensToSummarize: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+  summaryPrefix: zod_v30.ZodOptional<zod_v30.ZodString>;
+  maxTokensBeforeSummary: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+  messagesToKeep: zod_v30.ZodOptional<zod_v30.ZodNumber>;
+} & {
+  model: zod_v30.ZodOptional<zod_v30.ZodType<BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions>, zod_v30.ZodTypeDef, BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions>>>;
+}, "strip", zod_v30.ZodTypeAny, {
+  trigger?: {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }[] | {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  } | undefined;
+  keep?: {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  } | undefined;
+  tokenCounter?: ((args_0: _messages.BaseMessage<_messages.MessageStructure<_messages.MessageToolSet>, _messages.MessageType>[], ...args: unknown[]) => number | Promise<number>) | undefined;
+  summaryPrompt: string;
+  trimTokensToSummarize?: number | undefined;
+  summaryPrefix?: string | undefined;
+  maxTokensBeforeSummary?: number | undefined;
+  messagesToKeep?: number | undefined;
+  model?: BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
+}, {
+  trigger?: {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }[] | {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  } | undefined;
+  keep?: {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  } | undefined;
+  tokenCounter?: ((args_0: _messages.BaseMessage<_messages.MessageStructure<_messages.MessageToolSet>, _messages.MessageType>[], ...args: unknown[]) => number | Promise<number>) | undefined;
+  summaryPrompt?: string | undefined;
+  trimTokensToSummarize?: number | undefined;
+  summaryPrefix?: string | undefined;
+  maxTokensBeforeSummary?: number | undefined;
+  messagesToKeep?: number | undefined;
+  model?: BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
+}>, {
+  trigger?: {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  }[] | {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  } | undefined;
+  keep?: {
+    fraction?: number | undefined;
+    tokens?: number | undefined;
+    messages?: number | undefined;
+  } | undefined;
+  tokenCounter?: ((args_0: _messages.BaseMessage<_messages.MessageStructure<_messages.MessageToolSet>, _messages.MessageType>[], ...args: unknown[]) => number | Promise<number>) | undefined;
+  summaryPrompt: string;
+  trimTokensToSummarize?: number | undefined;
+  summaryPrefix?: string | undefined;
+  maxTokensBeforeSummary?: number | undefined;
+  messagesToKeep?: number | undefined;
+  model?: BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
+}, readonly (_langchain_core_tools1.ClientTool | _langchain_core_tools1.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>;
+  unsupportedModelBehavior: zod_v30.ZodOptional<zod_v30.ZodEnum<["ignore", "warn", "raise"]>>;
+}, "strip", zod_v30.ZodTypeAny, {
+  enableCaching?: boolean | undefined;
+  ttl?: "1h" | "5m" | undefined;
+  minMessagesToCache?: number | undefined;
+  unsupportedModelBehavior?: "ignore" | "raise" | "warn" | undefined;
+}, {
+  enableCaching?: boolean | undefined;
+  ttl?: "1h" | "5m" | undefined;
+  minMessagesToCache?: number | undefined;
+  unsupportedModelBehavior?: "ignore" | "raise" | "warn" | undefined;
+}>, {
+  enableCaching?: boolean | undefined;
+  ttl?: "1h" | "5m" | undefined;
+  minMessagesToCache?: number | undefined;
+  unsupportedModelBehavior?: "ignore" | "raise" | "warn" | undefined;
+}, readonly (_langchain_core_tools1.ClientTool | _langchain_core_tools1.ServerTool)[]> | AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools1.ClientTool | _langchain_core_tools1.ServerTool)[]>)[], readonly StructuredTool$1<_langchain_core_tools1.ToolSchemaBase, any, any, any>[]>>;
+//#endregion
+//#region src/config.d.ts
+/**
+ * Configuration and settings for deepagents.
+ *
+ * Provides project detection, path management, and environment configuration
+ * for skills and agent memory middleware.
+ */
+/**
+ * Options for creating a Settings instance.
+ */
+interface SettingsOptions {
+  /** Starting directory for project detection (defaults to cwd) */
+  startPath?: string;
+}
+/**
+ * Settings interface for project detection and path management.
+ *
+ * Provides access to:
+ * - Project root detection (via .git directory)
+ * - User-level deepagents directory (~/.deepagents)
+ * - Agent-specific directories and files
+ * - Skills directories (user and project level)
+ */
+interface Settings {
+  /** Detected project root directory, or null if not in a git project */
+  readonly projectRoot: string | null;
+  /** Base user-level .deepagents directory (~/.deepagents) */
+  readonly userDeepagentsDir: string;
+  /** Check if currently in a git project */
+  readonly hasProject: boolean;
+  /**
+   * Get the agent directory path.
+   * @param agentName - Name of the agent
+   * @returns Path to ~/.deepagents/{agentName}
+   * @throws Error if agent name is invalid
+   */
+  getAgentDir(agentName: string): string;
+  /**
+   * Ensure agent directory exists and return path.
+   * @param agentName - Name of the agent
+   * @returns Path to ~/.deepagents/{agentName}
+   * @throws Error if agent name is invalid
+   */
+  ensureAgentDir(agentName: string): string;
+  /**
+   * Get user-level agent.md path for a specific agent.
+   * @param agentName - Name of the agent
+   * @returns Path to ~/.deepagents/{agentName}/agent.md
+   */
+  getUserAgentMdPath(agentName: string): string;
+  /**
+   * Get project-level agent.md path.
+   * @returns Path to {projectRoot}/.deepagents/agent.md, or null if not in a project
+   */
+  getProjectAgentMdPath(): string | null;
+  /**
+   * Get user-level skills directory path for a specific agent.
+   * @param agentName - Name of the agent
+   * @returns Path to ~/.deepagents/{agentName}/skills/
+   */
+  getUserSkillsDir(agentName: string): string;
+  /**
+   * Ensure user-level skills directory exists and return path.
+   * @param agentName - Name of the agent
+   * @returns Path to ~/.deepagents/{agentName}/skills/
+   */
+  ensureUserSkillsDir(agentName: string): string;
+  /**
+   * Get project-level skills directory path.
+   * @returns Path to {projectRoot}/.deepagents/skills/, or null if not in a project
+   */
+  getProjectSkillsDir(): string | null;
+  /**
+   * Ensure project-level skills directory exists and return path.
+   * @returns Path to {projectRoot}/.deepagents/skills/, or null if not in a project
+   */
+  ensureProjectSkillsDir(): string | null;
+  /**
+   * Ensure project .deepagents directory exists.
+   * @returns Path to {projectRoot}/.deepagents/, or null if not in a project
+   */
+  ensureProjectDeepagentsDir(): string | null;
+}
+/**
+ * Find the project root by looking for .git directory.
+ *
+ * Walks up the directory tree from startPath (or cwd) looking for a .git
+ * directory, which indicates the project root.
+ *
+ * @param startPath - Directory to start searching from. Defaults to current working directory.
+ * @returns Path to the project root if found, null otherwise.
+ */
+declare function findProjectRoot(startPath?: string): string | null;
+/**
+ * Create a Settings instance with detected environment.
+ *
+ * @param options - Configuration options
+ * @returns Settings instance with project detection and path management
+ */
+declare function createSettings(options?: SettingsOptions): Settings;
+//#endregion
+//#region src/middleware/skills.d.ts
+/**
+ * Options for the skills middleware.
+ */
+interface SkillsMiddlewareOptions {
+  /** Path to the user-level skills directory (per-agent) */
+  skillsDir: string;
+  /** The agent identifier for path references in prompts */
+  assistantId: string;
+  /** Optional path to project-level skills directory */
+  projectSkillsDir?: string;
+}
+/**
+ * Create middleware for loading and exposing agent skills.
+ *
+ * This middleware implements Anthropic's agent skills pattern:
+ * - Loads skills metadata (name, description) from YAML frontmatter at session start
+ * - Injects skills list into system prompt for discoverability
+ * - Agent reads full SKILL.md content when a skill is relevant (progressive disclosure)
+ *
+ * Supports both user-level and project-level skills:
+ * - User skills: ~/.deepagents/{AGENT_NAME}/skills/
+ * - Project skills: {PROJECT_ROOT}/.deepagents/skills/
+ * - Project skills override user skills with the same name
+ *
+ * @param options - Configuration options
+ * @returns AgentMiddleware for skills loading and injection
+ */
+declare function createSkillsMiddleware(options: SkillsMiddlewareOptions): AgentMiddleware;
+//#endregion
+//#region src/middleware/agent-memory.d.ts
+/**
+ * Options for the agent memory middleware.
+ */
+interface AgentMemoryMiddlewareOptions {
+  /** Settings instance with project detection and paths */
+  settings: Settings;
+  /** The agent identifier */
+  assistantId: string;
+  /** Optional custom template for injecting agent memory into system prompt */
+  systemPromptTemplate?: string;
+}
+/**
+ * Create middleware for loading agent-specific long-term memory.
+ *
+ * This middleware loads the agent's long-term memory from a file (agent.md)
+ * and injects it into the system prompt. The memory is loaded once at the
+ * start of the conversation and stored in state.
+ *
+ * @param options - Configuration options
+ * @returns AgentMiddleware for memory loading and injection
+ */
+declare function createAgentMemoryMiddleware(options: AgentMemoryMiddlewareOptions): AgentMiddleware<any, undefined, unknown, readonly (_langchain_core_tools1.ClientTool | _langchain_core_tools1.ServerTool)[]>;
+//#endregion
+//#region src/skills/loader.d.ts
+/**
+ * Skill loader for parsing and loading agent skills from SKILL.md files.
+ *
+ * This module implements Anthropic's agent skills pattern with YAML frontmatter parsing.
+ * Each skill is a directory containing a SKILL.md file with:
+ * - YAML frontmatter (name, description required)
+ * - Markdown instructions for the agent
+ * - Optional supporting files (scripts, configs, etc.)
+ *
+ * @example
+ * ```markdown
+ * ---
+ * name: web-research
+ * description: Structured approach to conducting thorough web research
+ * ---
+ *
+ * # Web Research Skill
+ *
+ * ## When to Use
+ * - User asks you to research a topic
+ * ...
+ * ```
+ *
+ * @see https://agentskills.io/specification
+ */
+/** Maximum size for SKILL.md files (10MB) */
+declare const MAX_SKILL_FILE_SIZE: number;
+/** Agent Skills spec constraints */
+declare const MAX_SKILL_NAME_LENGTH = 64;
+declare const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
+/**
+ * Metadata for a skill per Agent Skills spec.
+ * @see https://agentskills.io/specification
+ */
+interface SkillMetadata {
+  /** Name of the skill (max 64 chars, lowercase alphanumeric and hyphens) */
+  name: string;
+  /** Description of what the skill does (max 1024 chars) */
+  description: string;
+  /** Absolute path to the SKILL.md file */
+  path: string;
+  /** Source of the skill ('user' or 'project') */
+  source: "user" | "project";
+  /** Optional: License name or reference to bundled license file */
+  license?: string;
+  /** Optional: Environment requirements (max 500 chars) */
+  compatibility?: string;
+  /** Optional: Arbitrary key-value mapping for additional metadata */
+  metadata?: Record<string, string>;
+  /** Optional: Space-delimited list of pre-approved tools */
+  allowedTools?: string;
+}
+/**
+ * Options for listing skills.
+ */
+interface ListSkillsOptions {
+  /** Path to user-level skills directory */
+  userSkillsDir?: string | null;
+  /** Path to project-level skills directory */
+  projectSkillsDir?: string | null;
+}
+/**
+ * Parse YAML frontmatter from a SKILL.md file per Agent Skills spec.
+ *
+ * @param skillMdPath - Path to the SKILL.md file
+ * @param source - Source of the skill ('user' or 'project')
+ * @returns SkillMetadata with all fields, or null if parsing fails
+ */
+declare function parseSkillMetadata(skillMdPath: string, source: "user" | "project"): SkillMetadata | null;
+/**
+ * List skills from user and/or project directories.
+ *
+ * When both directories are provided, project skills with the same name as
+ * user skills will override them.
+ *
+ * @param options - Options specifying which directories to search
+ * @returns Merged list of skill metadata from both sources, with project skills
+ *          taking precedence over user skills when names conflict
+ */
+declare function listSkills(options: ListSkillsOptions): SkillMetadata[];
 //#endregion
-export { type BackendFactory, type BackendProtocol, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type EditResult, type FileData, type FileInfo, FilesystemBackend, type FilesystemMiddlewareOptions, type GrepMatch, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createDeepAgent, createFilesystemMiddleware, createPatchToolCallsMiddleware, createSubAgentMiddleware };
+export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type EditResult, type ExecuteResponse, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type GrepMatch, type ListSkillsOptions, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type SandboxBackendProtocol, type Settings, type SettingsOptions, type SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
+//# sourceMappingURL=index.d.ts.map