Skip to content

docs: document the new delete filesystem tool [deepagents]#4680

Merged
Nishitha M (imnishitha) merged 14 commits into
mainfrom
open-swe/deepagents-delete-tool-docs
Jul 7, 2026
Merged

docs: document the new delete filesystem tool [deepagents]#4680
Nishitha M (imnishitha) merged 14 commits into
mainfrom
open-swe/deepagents-delete-tool-docs

Conversation

@imnishitha

@imnishitha Nishitha M (imnishitha) commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

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_file to delete in 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/warnings
  • markdownlint --config .markdownlint.json <changed files> shows no new violations vs. main

Opened collaboratively by Nishitha Madhu and open-swe

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>
@github-actions github-actions Bot added deepagents For docs changes to Deep Agents langchain For docs changes to LangChain oss internal labels Jul 1, 2026
Nishitha M (imnishitha) and others added 8 commits July 1, 2026 12:36
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>
@imnishitha Nishitha M (imnishitha) marked this pull request as ready for review July 1, 2026 21:27
@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Thanks for opening a docs PR, Nishitha M (@imnishitha)! When it's ready for review, please add the relevant reviewers:

  • @npentrel, @lnhsingh, or @mdrxy (Deep Agents)
  • @npentrel or @lnhsingh (LangChain)

@npentrel Naomi Pentrel (npentrel) left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work - no notes

Comment thread src/oss/deepagents/human-in-the-loop.mdx Outdated
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-opensw-1783449218-7296d22

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.

@imnishitha Nishitha M (imnishitha) merged commit cbcf665 into main Jul 7, 2026
24 checks passed
@imnishitha Nishitha M (imnishitha) deleted the open-swe/deepagents-delete-tool-docs branch July 7, 2026 18:36
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deepagents For docs changes to Deep Agents internal langchain For docs changes to LangChain oss

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants