deepagents 1.7.5 → 1.8.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as langchain from "langchain";
-import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, HumanMessage, InferMiddlewareStates, InterruptOnConfig, ReactAgent, ResponseFormat, ResponseFormatUndefined, StructuredTool, SystemMessage, ToolMessage } from "langchain";
+import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, HumanMessage, InferMiddlewareStates, InterruptOnConfig, ProviderStrategy, ReactAgent, ResponseFormat, ResponseFormatUndefined, StructuredTool, SystemMessage, ToolMessage, ToolStrategy } from "langchain";
 import { Runnable } from "@langchain/core/runnables";
 import * as _langchain_langgraph0 from "@langchain/langgraph";
 import { AnnotationRoot, Command, ReducedValue, StateSchema } from "@langchain/langgraph";
@@ -10,11 +10,10 @@ import { z as z$1 } from "zod";
 import * as zod_v30 from "zod/v3";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
 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_tools0 from "@langchain/core/tools";
 import { ClientTool, ServerTool, StructuredTool as StructuredTool$1 } from "@langchain/core/tools";
-import "@langchain/core/language_models/chat_models";
+import { BaseLanguageModel, LanguageModelLike } from "@langchain/core/language_models/base";
+import { BaseChatModel } from "@langchain/core/language_models/chat_models";
 import { InteropZodObject } from "@langchain/core/utils/types";
 
 //#region src/backends/protocol.d.ts
@@ -484,13 +483,13 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
   limit?: unknown;
 }, string, "read_file"> | langchain.DynamicStructuredTool<z.ZodObject<{
   file_path: z.ZodString;
-  content: z.ZodString;
+  content: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>, {
   file_path: string;
   content: string;
 }, {
   file_path: string;
-  content: string;
+  content?: string | undefined;
 }, string | ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | Command<unknown, {
   files: Record<string, FileData>;
   messages: ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
@@ -1009,6 +1008,122 @@ declare function createSkillsMiddleware(options: SkillsMiddlewareOptions): Agent
   files: ReducedValue<FilesRecord | undefined, FilesRecordUpdate | undefined>;
 }>, undefined, unknown, readonly (_langchain_core_tools0.ClientTool | _langchain_core_tools0.ServerTool)[]>;
 //#endregion
+//#region src/middleware/summarization.d.ts
+/**
+ * Context size specification for summarization triggers and retention policies.
+ */
+interface ContextSize {
+  /** Type of context measurement */
+  type: "messages" | "tokens" | "fraction";
+  /** Threshold value */
+  value: number;
+}
+/**
+ * Settings for truncating large tool arguments in old messages.
+ */
+interface TruncateArgsSettings {
+  /**
+   * Threshold to trigger argument truncation.
+   * If not provided, truncation is disabled.
+   */
+  trigger?: ContextSize;
+  /**
+   * Context retention policy for message truncation.
+   * Defaults to keeping last 20 messages.
+   */
+  keep?: ContextSize;
+  /**
+   * Maximum character length for tool arguments before truncation.
+   * Defaults to 2000.
+   */
+  maxLength?: number;
+  /**
+   * Text to replace truncated arguments with.
+   * Defaults to "...(argument truncated)".
+   */
+  truncationText?: string;
+}
+/**
+ * Options for the summarization middleware.
+ */
+interface SummarizationMiddlewareOptions {
+  /**
+   * The language model to use for generating summaries.
+   * Can be a model string (e.g., "gpt-4o-mini") or a language model instance.
+   */
+  model: string | BaseChatModel | BaseLanguageModel;
+  /**
+   * Backend instance or factory for persisting conversation history.
+   */
+  backend: BackendProtocol | BackendFactory | ((config: {
+    state: unknown;
+    store?: BaseStore;
+  }) => StateBackend);
+  /**
+   * Threshold(s) that trigger summarization.
+   * Can be a single ContextSize or an array for multiple triggers.
+   */
+  trigger?: ContextSize | ContextSize[];
+  /**
+   * Context retention policy after summarization.
+   * Defaults to keeping last 20 messages.
+   */
+  keep?: ContextSize;
+  /**
+   * Prompt template for generating summaries.
+   */
+  summaryPrompt?: string;
+  /**
+   * Max tokens to include when generating summary.
+   * Defaults to 4000.
+   */
+  trimTokensToSummarize?: number;
+  /**
+   * Path prefix for storing conversation history.
+   * Defaults to "/conversation_history".
+   */
+  historyPathPrefix?: string;
+  /**
+   * Settings for truncating large tool arguments in old messages.
+   * If not provided, argument truncation is disabled.
+   */
+  truncateArgsSettings?: TruncateArgsSettings;
+}
+/**
+ * Compute summarization defaults based on model profile.
+ * Mirrors Python's `_compute_summarization_defaults`.
+ *
+ * If the model has a profile with `maxInputTokens`, uses fraction-based
+ * settings. Otherwise, uses fixed token/message counts.
+ *
+ * @param resolvedModel - The resolved chat model instance.
+ */
+declare function computeSummarizationDefaults(resolvedModel: BaseChatModel): {
+  trigger: ContextSize;
+  keep: ContextSize;
+  truncateArgsSettings: TruncateArgsSettings;
+};
+/**
+ * Create summarization middleware with backend support for conversation history offloading.
+ *
+ * This middleware:
+ * 1. Monitors conversation length against configured thresholds
+ * 2. When triggered, offloads old messages to backend storage
+ * 3. Generates a summary of offloaded messages
+ * 4. Replaces old messages with the summary, preserving recent context
+ *
+ * @param options - Configuration options
+ * @returns AgentMiddleware for summarization and history offloading
+ */
+declare function createSummarizationMiddleware(options: SummarizationMiddlewareOptions): AgentMiddleware<z$1.ZodObject<{
+  _summarizationSessionId: z$1.ZodOptional<z$1.ZodString>;
+  _summarizationEvent: z$1.ZodOptional<z$1.ZodObject<{
+    cutoffIndex: z$1.ZodNumber;
+    summaryMessage: z$1.ZodCustom<HumanMessage<_messages.MessageStructure<_messages.MessageToolSet>>, HumanMessage<_messages.MessageStructure<_messages.MessageToolSet>>>;
+    filePath: z$1.ZodNullable<z$1.ZodString>;
+  }, z$1.core.$strip>>;
+}, z$1.core.$strip>, undefined, unknown, readonly (ClientTool | ServerTool)[]>;
+//#endregion
 //#region src/backends/store.d.ts
 /**
  * Backend that stores files in LangGraph's BaseStore (persistent).
@@ -1127,8 +1242,8 @@ declare class StoreBackend implements BackendProtocol {
  * as plain text, and metadata (timestamps) are derived from filesystem stats.
  */
 declare class FilesystemBackend implements BackendProtocol {
-  private cwd;
-  private virtualMode;
+  protected cwd: string;
+  protected virtualMode: boolean;
   private maxFileSizeBytes;
   constructor(options?: {
     rootDir?: string;
@@ -1332,6 +1447,175 @@ declare class CompositeBackend implements BackendProtocol {
   downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
 }
 //#endregion
+//#region src/backends/local-shell.d.ts
+/**
+ * Options for creating a LocalShellBackend instance.
+ */
+interface LocalShellBackendOptions {
+  /**
+   * Working directory for both filesystem operations and shell commands.
+   * @defaultValue `process.cwd()`
+   */
+  rootDir?: string;
+  /**
+   * Enable virtual path mode for filesystem operations.
+   * When true, treats rootDir as a virtual root filesystem.
+   * Does NOT restrict shell commands.
+   * @defaultValue `false`
+   */
+  virtualMode?: boolean;
+  /**
+   * Maximum time in seconds to wait for shell command execution.
+   * Commands exceeding this timeout will be terminated.
+   * @defaultValue `120`
+   */
+  timeout?: number;
+  /**
+   * Maximum number of bytes to capture from command output.
+   * Output exceeding this limit will be truncated.
+   * @defaultValue `100_000`
+   */
+  maxOutputBytes?: number;
+  /**
+   * Environment variables for shell commands. If undefined, starts with an empty
+   * environment (unless inheritEnv is true).
+   * @defaultValue `undefined`
+   */
+  env?: Record<string, string>;
+  /**
+   * Whether to inherit the parent process's environment variables.
+   * When false, only variables in env dict are available.
+   * When true, inherits all process.env variables and applies env overrides.
+   * @defaultValue `false`
+   */
+  inheritEnv?: boolean;
+  /**
+   * Files to create on disk during `create()`.
+   * Keys are file paths (resolved via the backend's path handling),
+   * values are string content.
+   * @defaultValue `undefined`
+   */
+  initialFiles?: Record<string, string>;
+}
+/**
+ * Filesystem backend with unrestricted local shell command execution.
+ *
+ * This backend extends FilesystemBackend to add shell command execution
+ * capabilities. Commands are executed directly on the host system without any
+ * sandboxing, process isolation, or security restrictions.
+ *
+ * **Security Warning:**
+ * This backend grants agents BOTH direct filesystem access AND unrestricted
+ * shell execution on your local machine. Use with extreme caution and only in
+ * appropriate environments.
+ *
+ * **Appropriate use cases:**
+ * - Local development CLIs (coding assistants, development tools)
+ * - Personal development environments where you trust the agent's code
+ * - CI/CD pipelines with proper secret management
+ *
+ * **Inappropriate use cases:**
+ * - Production environments (e.g., web servers, APIs, multi-tenant systems)
+ * - Processing untrusted user input or executing untrusted code
+ *
+ * Use StateBackend, StoreBackend, or extend BaseSandbox for production.
+ *
+ * @example
+ * ```typescript
+ * import { LocalShellBackend } from "@langchain/deepagents";
+ *
+ * // Create backend with explicit environment
+ * const backend = new LocalShellBackend({
+ *   rootDir: "/home/user/project",
+ *   env: { PATH: "/usr/bin:/bin" },
+ * });
+ *
+ * // Execute shell commands (runs directly on host)
+ * const result = await backend.execute("ls -la");
+ * console.log(result.output);
+ * console.log(result.exitCode);
+ *
+ * // Use filesystem operations (inherited from FilesystemBackend)
+ * const content = await backend.read("/README.md");
+ * await backend.write("/output.txt", "Hello world");
+ *
+ * // Inherit all environment variables
+ * const backend2 = new LocalShellBackend({
+ *   rootDir: "/home/user/project",
+ *   inheritEnv: true,
+ * });
+ * ```
+ */
+declare class LocalShellBackend extends FilesystemBackend implements SandboxBackendProtocol {
+  #private;
+  constructor(options?: LocalShellBackendOptions);
+  /** Unique identifier for this backend instance (format: "local-{random_hex}"). */
+  get id(): string;
+  /** Whether the backend has been initialized and is ready to use. */
+  get isInitialized(): boolean;
+  /** Alias for `isInitialized`, matching the standard sandbox interface. */
+  get isRunning(): boolean;
+  /**
+   * Initialize the backend by ensuring the rootDir exists.
+   *
+   * Creates the rootDir (and any parent directories) if it does not already
+   * exist. Safe to call on an existing directory. Must be called before
+   * `execute()`, or use the static `LocalShellBackend.create()` factory.
+   *
+   * @throws {SandboxError} If already initialized (`ALREADY_INITIALIZED`)
+   */
+  initialize(): Promise<void>;
+  /**
+   * Mark the backend as no longer running.
+   *
+   * For local shell backends there is no remote resource to tear down,
+   * so this simply flips the `isRunning` / `isInitialized` flag.
+   */
+  close(): Promise<void>;
+  /**
+   * Read a file, adapting error messages to the standard sandbox format.
+   */
+  read(filePath: string, offset?: number, limit?: number): Promise<string>;
+  /**
+   * Edit a file, adapting error messages to the standard sandbox format.
+   */
+  edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
+  /**
+   * List directory contents, returning paths relative to rootDir.
+   */
+  lsInfo(dirPath: string): Promise<FileInfo[]>;
+  /**
+   * Glob matching that returns relative paths and includes directories.
+   */
+  globInfo(pattern: string, searchPath?: string): Promise<FileInfo[]>;
+  /**
+   * Execute a shell command directly on the host system.
+   *
+   * Commands are executed directly on your host system using `spawn()`
+   * with `shell: true`. There is NO sandboxing, isolation, or security
+   * restrictions. The command runs with your user's full permissions.
+   *
+   * The command is executed using the system shell with the working directory
+   * set to the backend's rootDir. Stdout and stderr are combined into a single
+   * output stream, with stderr lines prefixed with `[stderr]`.
+   *
+   * @param command - Shell command string to execute
+   * @returns ExecuteResponse containing output, exit code, and truncation flag
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Create and initialize a new LocalShellBackend in one step.
+   *
+   * This is the recommended way to create a backend when the rootDir may
+   * not exist yet. It combines construction and initialization (ensuring
+   * rootDir exists) into a single async operation.
+   *
+   * @param options - Configuration options for the backend
+   * @returns An initialized and ready-to-use backend
+   */
+  static create(options?: LocalShellBackendOptions): Promise<LocalShellBackend>;
+}
+//#endregion
 //#region src/backends/sandbox.d.ts
 /**
  * Base sandbox implementation with execute() as the only abstract method.
@@ -1435,6 +1719,9 @@ declare abstract class BaseSandbox implements SandboxBackendProtocol {
 //#endregion
 //#region src/types.d.ts
 type AnyAnnotationRoot = AnnotationRoot<any>;
+interface TypedToolStrategy<T = unknown> extends Array<ToolStrategy<any>> {
+  _schemaType?: T;
+}
 /**
  * Helper type to extract middleware from a SubAgent definition
  * Handles both mutable and readonly middleware arrays
@@ -1454,6 +1741,36 @@ type InferSubAgentMiddlewareStates<T extends readonly (SubAgent | CompiledSubAge
  * Combined state type including custom middleware and subagent middleware states
  */
 type MergedDeepAgentState<TMiddleware extends readonly AgentMiddleware[], TSubagents extends readonly (SubAgent | CompiledSubAgent)[]> = InferMiddlewareStates<TMiddleware> & InferSubAgentMiddlewareStates<TSubagents>;
+/**
+ * Union of all response format types accepted by `createDeepAgent`.
+ *
+ * Matches the formats supported by LangChain's `createAgent`:
+ * - `ToolStrategy<T>` — from `ToolStrategy.fromSchema(schema)`
+ * - `ProviderStrategy<T>` — from `providerStrategy(schema)`
+ * - `TypedToolStrategy<T>` — from `toolStrategy(schema)`
+ * - `ResponseFormat` — the base union of the above single-strategy types
+ */
+type SupportedResponseFormat = ResponseFormat | TypedToolStrategy<any>;
+/**
+ * Utility type to extract the parsed response type from a ResponseFormat strategy.
+ *
+ * Maps `ToolStrategy<T>`, `ProviderStrategy<T>`, and `TypedToolStrategy<T>` to `T`
+ * (the parsed output type), so that `structuredResponse` is correctly typed as the
+ * schema's inferred type rather than the strategy wrapper.
+ *
+ * When no `responseFormat` is provided (i.e. `T` defaults to the full
+ * `SupportedResponseFormat` union), this resolves to `ResponseFormatUndefined` so
+ * that `structuredResponse` is excluded from the agent's output state.
+ *
+ * @example
+ * ```typescript
+ * type T1 = InferStructuredResponse<ToolStrategy<{ city: string }>>; // { city: string }
+ * type T2 = InferStructuredResponse<ProviderStrategy<{ answer: string }>>; // { answer: string }
+ * type T3 = InferStructuredResponse<TypedToolStrategy<{ city: string }>>; // { city: string }
+ * type T4 = InferStructuredResponse<SupportedResponseFormat>; // ResponseFormatUndefined (default/unset)
+ * ```
+ */
+type InferStructuredResponse<T extends SupportedResponseFormat> = SupportedResponseFormat extends T ? ResponseFormatUndefined : T extends TypedToolStrategy<infer U> ? U : T extends ToolStrategy<infer U> ? U : T extends ProviderStrategy<infer U> ? U : ResponseFormatUndefined;
 /**
  * Type bag that extends AgentTypeConfig with subagent type information.
  *
@@ -1595,7 +1912,7 @@ type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent>
  * @typeParam TSubagents - The subagents array type for extracting subagent middleware states
  * @typeParam TTools - The tools array type
  */
-interface CreateDeepAgentParams<TResponse extends ResponseFormat = ResponseFormat, ContextSchema extends AnnotationRoot<any> | InteropZodObject = AnnotationRoot<any>, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[], TSubagents extends readonly (SubAgent | CompiledSubAgent)[] = readonly (SubAgent | CompiledSubAgent)[], TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[]> {
+interface CreateDeepAgentParams<TResponse extends SupportedResponseFormat = SupportedResponseFormat, ContextSchema extends AnnotationRoot<any> | InteropZodObject = AnnotationRoot<any>, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[], TSubagents extends readonly (SubAgent | CompiledSubAgent)[] = readonly (SubAgent | CompiledSubAgent)[], TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[]> {
   /** The model to use (model name string or LanguageModelLike instance). Defaults to claude-sonnet-4-5-20250929 */
   model?: BaseLanguageModel | string;
   /** Tools the agent should have access to */
@@ -1675,7 +1992,7 @@ interface CreateDeepAgentParams<TResponse extends ResponseFormat = ResponseForma
  * - Todo management (todoListMiddleware)
  * - Filesystem tools (createFilesystemMiddleware)
  * - Subagent delegation (createSubAgentMiddleware)
- * - Conversation summarization (summarizationMiddleware)
+ * - Conversation summarization (createSummarizationMiddleware) with backend offloading
  * - Prompt caching (anthropicPromptCachingMiddleware)
  * - Tool call patching (createPatchToolCallsMiddleware)
  * - Human-in-the-loop (humanInTheLoopMiddleware) - optional
@@ -1699,7 +2016,7 @@ interface CreateDeepAgentParams<TResponse extends ResponseFormat = ResponseForma
  * // result.research is properly typed as string
  * ```
  */
-declare function createDeepAgent<TResponse extends ResponseFormat = ResponseFormat, ContextSchema extends InteropZodObject = InteropZodObject, const TMiddleware extends readonly AgentMiddleware[] = readonly [], const TSubagents extends readonly (SubAgent | CompiledSubAgent)[] = readonly [], const TTools extends readonly (ClientTool | ServerTool)[] = readonly []>(params?: CreateDeepAgentParams<TResponse, ContextSchema, TMiddleware, TSubagents, TTools>): DeepAgent<DeepAgentTypeConfig<TResponse, undefined, ContextSchema, readonly [AgentMiddleware<zod_v30.ZodObject<{
+declare function createDeepAgent<TResponse extends SupportedResponseFormat = SupportedResponseFormat, ContextSchema extends InteropZodObject = InteropZodObject, const TMiddleware extends readonly AgentMiddleware[] = readonly [], const TSubagents extends readonly (SubAgent | CompiledSubAgent)[] = readonly [], const TTools extends readonly (ClientTool | ServerTool)[] = readonly []>(params?: CreateDeepAgentParams<TResponse, ContextSchema, TMiddleware, TSubagents, TTools>): DeepAgent<DeepAgentTypeConfig<InferStructuredResponse<TResponse>, undefined, ContextSchema, readonly [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"]>;
@@ -1779,13 +2096,13 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   limit?: unknown;
 }, string, "read_file"> | langchain.DynamicStructuredTool<zod.ZodObject<{
   file_path: zod.ZodString;
-  content: zod.ZodString;
+  content: zod.ZodDefault<zod.ZodString>;
 }, zod_v4_core0.$strip>, {
   file_path: string;
   content: string;
 }, {
   file_path: string;
-  content: string;
+  content?: string | undefined;
 }, string | _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>> | _langchain_langgraph0.Command<unknown, {
   files: Record<string, FileData>;
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
@@ -1843,144 +2160,14 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
 }, {
   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>;
-    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<_langchain_core_language_models_base0.BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions>, zod_v30.ZodTypeDef, _langchain_core_language_models_base0.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?: _langchain_core_language_models_base0.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?: _langchain_core_language_models_base0.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?: _langchain_core_language_models_base0.BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
-}, readonly (ClientTool | ServerTool)[]>, AgentMiddleware<undefined, zod_v30.ZodObject<{
+}, string | _langchain_langgraph0.Command<unknown, Record<string, unknown>, string>, "task">]>, AgentMiddleware<zod.ZodObject<{
+  _summarizationSessionId: zod.ZodOptional<zod.ZodString>;
+  _summarizationEvent: zod.ZodOptional<zod.ZodObject<{
+    cutoffIndex: zod.ZodNumber;
+    summaryMessage: zod.ZodCustom<_messages.HumanMessage<_messages.MessageStructure<_messages.MessageToolSet>>, _messages.HumanMessage<_messages.MessageStructure<_messages.MessageToolSet>>>;
+    filePath: zod.ZodNullable<zod.ZodString>;
+  }, zod_v4_core0.$strip>>;
+}, zod_v4_core0.$strip>, undefined, unknown, 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>;
@@ -2207,5 +2394,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, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_SUBAGENT_PROMPT, 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, GENERAL_PURPOSE_SUBAGENT, 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 SandboxDeleteOptions, SandboxError, type SandboxErrorCode, type SandboxGetOrCreateOptions, type SandboxInfo, type SandboxListOptions, type SandboxListResponse, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, TASK_SYSTEM_PROMPT, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, filesValue, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
+export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_SUBAGENT_PROMPT, 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, GENERAL_PURPOSE_SUBAGENT, type GrepMatch, type InferDeepAgentSubagents, type InferDeepAgentType, type InferStructuredResponse, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, LocalShellBackend, type LocalShellBackendOptions, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type SandboxDeleteOptions, SandboxError, type SandboxErrorCode, type SandboxGetOrCreateOptions, type SandboxInfo, type SandboxListOptions, type SandboxListResponse, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type SupportedResponseFormat, TASK_SYSTEM_PROMPT, type WriteResult, computeSummarizationDefaults, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, createSummarizationMiddleware, filesValue, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
 //# sourceMappingURL=index.d.ts.map