langchain-ai/docs
1
0
Fork 0
mirror of https://github.com/langchain-ai/docs.git synced 2026-07-22 04:15:25 -04:00
Code Issues 490 Packages Projects Releases Wiki Activity

[GH-ISSUE #1262] [langchain]: Docs: ContextEditingMiddleware description is misleading regarding summarizing capability #184

New Issue
Open
opened 2026-02-17 17:19:21 -05:00 by yindo · 0 comments
yindo commented 2026-02-17 17:19:21 -05:00
Owner
Copy Link
Copy Source

Originally created by @lesong36 on GitHub (Nov 3, 2025).
Original GitHub issue: https://github.com/langchain-ai/docs/issues/1262

Type of issue

issue / bug

Language

Python

Description

The documentation for the ContextEditingMiddleware (found at https.docs.langchain.com/oss/python/langchain/middleware#context-editing) is confusing and overlaps with the SummarizationMiddleware.

The Problem

The page describes the middleware's purpose as:

Manage conversation context by trimming, summarizing, or clearing tool uses.

This description is misleading for the following reasons:

  1. summarizing is not a built-in feature of this middleware. The only built-in ContextEdit strategy provided in the context_editing.py source code is ClearToolUsesEdit.
  2. It creates confusion with SummarizationMiddleware. LangChain provides a separate, dedicated SummarizationMiddleware at the same level, whose sole purpose is summarizing.
  3. It misrepresents the middleware's function. The current implementation of ContextEditingMiddleware is a framework for applying ContextEdit strategies. The only out-of-the-box strategy provided (ClearToolUsesEdit) is for clearing tool uses, which in turn achieves trimming.

This leads new users to believe that summarizing is an option or configuration within ContextEditingMiddleware, which is incorrect. They should be guided to SummarizationMiddleware for that specific capability.

Suggested Solution

The documentation should be updated to clarify this middleware's specific role and its built-in capabilities, while clearly differentiating it from summarization.

Recommendation:

Change the description from:

Manage conversation context by trimming, summarizing, or clearing tool uses.

To something more precise, like:

Manages conversation context by applying pluggable editing strategies. The built-in ClearToolUsesEdit strategy, for example, trims context by clearing old tool results.

Alternatively, and perhaps even better:

Manages conversation context by applying pluggable editing strategies, such as the built-in ClearToolUsesEdit which removes old tool results.

For context summarization, please see the separate SummarizationMiddleware.

Originally created by @lesong36 on GitHub (Nov 3, 2025). Original GitHub issue: https://github.com/langchain-ai/docs/issues/1262 ### Type of issue issue / bug ### Language Python ### Description The documentation for the `ContextEditingMiddleware` (found at `https.docs.langchain.com/oss/python/langchain/middleware#context-editing`) is confusing and overlaps with the `SummarizationMiddleware`. ### **The Problem** The page describes the middleware's purpose as: > Manage conversation context by **trimming, summarizing, or clearing tool uses**. This description is misleading for the following reasons: 1. **`summarizing` is not a built-in feature of this middleware.** The only built-in `ContextEdit` strategy provided in the `context_editing.py` source code is `ClearToolUsesEdit`. 2. **It creates confusion with `SummarizationMiddleware`.** LangChain provides a separate, dedicated `SummarizationMiddleware` at the same level, whose sole purpose is `summarizing`. 3. **It misrepresents the middleware's function.** The current implementation of `ContextEditingMiddleware` is a *framework* for applying `ContextEdit` strategies. The *only* out-of-the-box strategy provided (`ClearToolUsesEdit`) is for `clearing tool uses`, which in turn achieves `trimming`. This leads new users to believe that `summarizing` is an option or configuration *within* `ContextEditingMiddleware`, which is incorrect. They should be guided to `SummarizationMiddleware` for that specific capability. ### **Suggested Solution** The documentation should be updated to clarify this middleware's *specific* role and its *built-in* capabilities, while clearly differentiating it from summarization. **Recommendation:** Change the description from: > Manage conversation context by trimming, summarizing, or clearing tool uses. To something more precise, like: > Manages conversation context by applying pluggable editing strategies. The built-in `ClearToolUsesEdit` strategy, for example, trims context by clearing old tool results. **Alternatively, and perhaps even better:** > Manages conversation context by applying pluggable editing strategies, such as the built-in `ClearToolUsesEdit` which removes old tool results. > > *For context summarization, please see the separate `SummarizationMiddleware`.*
yindo added the langchainexternal labels 2026-02-17 17:19:21 -05:00
yindo changed title from [langchain]: Docs: ContextEditingMiddleware description is misleading regarding summarizing capability to [GH-ISSUE #1262] [langchain]: Docs: ContextEditingMiddleware description is misleading regarding summarizing capability 2026-06-05 17:25:31 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
deepagents
docs-infra
external
external
help wanted
integration
internal
internal
javascript
js/ts
langchain
langgraph
langsmith
needs-title
pull-request
Mirrored from GitHub Pull Request
 python
reference
No Label external langchain
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#184
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?