docs: document the new delete filesystem tool [deepagents]#4680
Merged
Nishitha M (imnishitha) merged 14 commits intoJul 7, 2026
Conversation
Consolidates docs updates for langchain-ai/deepagents#3659, #3691, and #3851, which added a Python-only `delete` tool (backends optionally implement delete/adelete) and later extended it to remove directories recursively, renaming it from `delete_file` to `delete`. Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Add `delete` as a row in the overview tool table instead of a prose aside, and drop the "in Python" qualifier on sandbox pages since it read awkwardly alongside the other filesystem tools. Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Replace inline 'Python also includes delete'/'in Python, delete' phrasing with :::python / :::js fenced sections so the delete tool only renders on Python pages, matching the pattern already used elsewhere (permissions.mdx, backends.mdx). Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Contributor
|
Thanks for opening a docs PR, Nishitha M (@imnishitha)! When it's ready for review, please add the relevant reviewers:
|
Naomi Pentrel (npentrel)
approved these changes
Jul 2, 2026
Naomi Pentrel (npentrel)
left a comment
Contributor
There was a problem hiding this comment.
Great work - no notes
Contributor
|
Mintlify preview branch generated: Site preview: https://langchain-5e9cc07a-preview-opensw-1783449218-7296d22.mintlify.app Important Preview links may take a few minutes to start working while the deployment finishes. Changed documentation pages (preview deep links):
Only the top 5 changed markdown files by diff size are listed. |
1 task
Lauren Hirata Singh (lnhsingh)
added a commit
that referenced
this pull request
Jul 7, 2026
## Description Adds a single consolidated changelog entry for the `deepagents` 0.7.0 alpha releases, covering the `delete` filesystem tool, `write_file` overwrite behavior, default middleware override by name, and the `FilesystemMiddleware` tools allowlist (already documented in #4746, #4680, #4701). Individual alpha versions (a1, a2, ...) are not called out separately. ## Test Plan - [ ] `npx markdownlint-cli src/oss/python/releases/changelog.mdx` — no new lint errors introduced by this change _Opened collaboratively by Nishitha Madhu and open-swe_ --------- Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com> Co-authored-by: Lauren Hirata Singh <lauren@langchain.dev>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Depends on: langchain-ai/deepagents #3659, #3691 #3851
Updates the built-in tool lists and tables across the Deep Agents docs (overview, permissions, backends, sandboxes, context engineering, CLI overview, and frontend sandbox pattern), and renames
delete_filetodeletein the Python human-in-the-loop examples.JS-specific content is intentionally left unchanged, as the deepagents JS SDK does not yet support the delete tool. Python-only code fences are used so these changes appear only in the Python documentation.
Test Plan
vale --glob='!**/node_modules/**' <changed files>passes with 0 errors/warningsmarkdownlint --config .markdownlint.json <changed files>shows no new violations vs.mainOpened collaboratively by Nishitha Madhu and open-swe