summarization

Public alias for _DeepAgentsSummarizationMiddleware.

This is the name external callers should import and reference.

Emit a deprecation warning with caller-controlled stack attribution.

langchain_core.warn_deprecated formats a standard message but hardcodes stacklevel=4 in its internal warnings.warn call. That value targets a decorator-wrapped frame layout; when called directly from a deprecated method's body the warning is attributed one frame too high (above the user's call site). This wrapper captures the formatted upstream warning and re-emits it with an explicit stacklevel, so the warning points at the user's call site.

Append text to a system message.

Compute default summarization settings based on model profile.

Routes file operations to different backends by path prefix.

Matches paths against route prefixes (longest first) and delegates to the corresponding backend. Unmatched paths use the default backend.

Protocol for pluggable memory backends (single, unified).

Backends can store files in different locations (state, filesystem, database, etc.) and provide a uniform interface for file operations.

All file data is represented as dicts with the following structure:

{
    "content": str,  # Text content (utf-8) or base64-encoded binary
    "encoding": str,  # "utf-8" for text, "base64" for binary data
    "created_at": str,  # ISO format timestamp
    "modified_at": str,  # ISO format timestamp
}

Result of a single file upload operation.

The response is designed to allow partial success in batch operations.

The errors are standardized using FileOperationError literals for certain recoverable conditions for use cases that involve LLMs performing file operations.

Input schema for the compact_conversation tool.

Represents a summarization event.

Dictionary-based summarization trigger with AND semantics.

Settings for truncating large tool-call arguments in older messages.

This is a lightweight, pre-summarization optimization that fires at a lower token threshold than full conversation compaction. When triggered, only the args values on AIMessage.tool_calls in messages before the keep window are shortened — recent messages are left intact.

Typical large arguments include write_file content, edit_file patches, and verbose execute outputs.

State for the summarization middleware.

Extends AgentState with a private field for tracking summarization events.

Default settings computed from model profile.

Middleware that provides a compact_conversation tool for manual compaction.

This middleware composes with a SummarizationMiddleware instance, reusing its summarization engine (model, backend, trigger thresholds) to let the agent compact its own context window.

This middleware never compacts automatically. Compaction only occurs when compact_conversation is called as a normal tool call (by the model or by an explicit user action, e.g. as implemented in the deepagents-cli).

To avoid compacting too early, compact tool execution is gated by _is_eligible_for_compaction, which requires reported usage to reach about 50% of the configured auto-summarization trigger.

The tool and auto-summarization share the same _summarization_event state key, so they interoperate correctly.

For a simpler setup, use create_summarization_tool_middleware which handles both steps.