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

[PR #3539] [MERGED] fix: update deepagents docs to reference permissions across pages #3581

New Issue
Closed
opened 2026-06-05 18:23:33 -04:00 by yindo · 0 comments
yindo commented 2026-06-05 18:23:33 -04:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3539
Author: @open-swe[bot]
Created: 4/10/2026
Status: ✅ Merged
Merged: 4/10/2026
Merged by: @sydney-runkle

Base: main ← Head: open-swe/a44cf872-4adb-50bd-7b02-69fe1b475243

📝 Commits (3)

  • f9e23ca Update deepagents docs to reference permissions across going-to-production, memory, and backends pages. Improve permissions page per feedback: reorder examples, rename sandbox->isolate, add read-only memory example.
  • 1880aed Remove JS permissions example from backends page — permissions not yet implemented in JS
  • fccbeb6 fix some things open swe missed and add some more changes to other pages for cohesiveness

📊 Changes

7 files changed (+118 additions, -14 deletions)

View changed files

📝 src/oss/deepagents/backends.mdx (+35 -1)
📝 src/oss/deepagents/going-to-production.mdx (+5 -2)
📝 src/oss/deepagents/harness.mdx (+19 -0)
📝 src/oss/deepagents/memory.mdx (+3 -3)
📝 src/oss/deepagents/overview.mdx (+10 -0)
📝 src/oss/deepagents/permissions.mdx (+45 -8)
📝 src/oss/deepagents/subagents.mdx (+1 -0)

📄 Description

Description

Updates deepagents docs pages to properly reference the new permissions system.

Permissions page improvements:

  • Reordered examples: "Isolate to a workspace directory" first, "Deny all access" last
  • Renamed "Sandbox" to "Isolate" to avoid overloaded terminology
  • Added "Read-only memory" example protecting both /memories/ and /policies/
  • Fixed "Protect specific files" example to include trailing deny-all rule

Cross-page references added:

  • going-to-production.mdx: New "Filesystem permissions" subsection under Guardrails
  • memory.mdx: References permissions alongside policy hooks for read-only enforcement
  • backends.mdx: Tip before "Add policy hooks" pointing to permissions as a simpler alternative
  • harness.mdx: New "Filesystem permissions" section in the capabilities overview
  • subagents.mdx: Added permissions field to SubAgent spec tables (Python and JS)
  • overview.mdx: Added permissions to "When to use" list, Core capabilities cards, and Get started card groups

Test Plan

  • Verify permissions page examples are reordered sensibly (isolate first, deny-all last)
  • Verify "Protect specific files" example has trailing deny-all
  • Verify "Read-only memory" example denies writes to both /memories/ and /policies/
  • Verify going-to-production guardrails section mentions permissions
  • Verify memory read-only section references permissions
  • Verify backends page has tip before policy hooks section
  • Verify harness page has new filesystem permissions section
  • Verify subagents page lists permissions field in both Python and JS tables
  • Verify overview page has permissions in capabilities and card groups

Opened collaboratively by Nick Hollon and open-swe.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/3539 **Author:** [@open-swe[bot]](https://github.com/apps/open-swe) **Created:** 4/10/2026 **Status:** ✅ Merged **Merged:** 4/10/2026 **Merged by:** [@sydney-runkle](https://github.com/sydney-runkle) **Base:** `main` ← **Head:** `open-swe/a44cf872-4adb-50bd-7b02-69fe1b475243` --- ### 📝 Commits (3) - [`f9e23ca`](https://github.com/langchain-ai/docs/commit/f9e23cad291d477636a337d8fd2c672336851b17) Update deepagents docs to reference permissions across going-to-production, memory, and backends pages. Improve permissions page per feedback: reorder examples, rename sandbox->isolate, add read-only memory example. - [`1880aed`](https://github.com/langchain-ai/docs/commit/1880aed475c71aa3a623e2101f6a1754c1ae983a) Remove JS permissions example from backends page — permissions not yet implemented in JS - [`fccbeb6`](https://github.com/langchain-ai/docs/commit/fccbeb6d3b3fb46e077917d3bc2c207c7dfb88c1) fix some things open swe missed and add some more changes to other pages for cohesiveness ### 📊 Changes **7 files changed** (+118 additions, -14 deletions) <details> <summary>View changed files</summary> 📝 `src/oss/deepagents/backends.mdx` (+35 -1) 📝 `src/oss/deepagents/going-to-production.mdx` (+5 -2) 📝 `src/oss/deepagents/harness.mdx` (+19 -0) 📝 `src/oss/deepagents/memory.mdx` (+3 -3) 📝 `src/oss/deepagents/overview.mdx` (+10 -0) 📝 `src/oss/deepagents/permissions.mdx` (+45 -8) 📝 `src/oss/deepagents/subagents.mdx` (+1 -0) </details> ### 📄 Description ## Description Updates deepagents docs pages to properly reference the new permissions system. **Permissions page improvements:** - Reordered examples: "Isolate to a workspace directory" first, "Deny all access" last - Renamed "Sandbox" to "Isolate" to avoid overloaded terminology - Added "Read-only memory" example protecting both `/memories/` and `/policies/` - Fixed "Protect specific files" example to include trailing deny-all rule **Cross-page references added:** - `going-to-production.mdx`: New "Filesystem permissions" subsection under Guardrails - `memory.mdx`: References permissions alongside policy hooks for read-only enforcement - `backends.mdx`: Tip before "Add policy hooks" pointing to permissions as a simpler alternative - `harness.mdx`: New "Filesystem permissions" section in the capabilities overview - `subagents.mdx`: Added `permissions` field to SubAgent spec tables (Python and JS) - `overview.mdx`: Added permissions to "When to use" list, Core capabilities cards, and Get started card groups ## Test Plan - [ ] Verify permissions page examples are reordered sensibly (isolate first, deny-all last) - [ ] Verify "Protect specific files" example has trailing deny-all - [ ] Verify "Read-only memory" example denies writes to both `/memories/` and `/policies/` - [ ] Verify going-to-production guardrails section mentions permissions - [ ] Verify memory read-only section references permissions - [ ] Verify backends page has tip before policy hooks section - [ ] Verify harness page has new filesystem permissions section - [ ] Verify subagents page lists `permissions` field in both Python and JS tables - [ ] Verify overview page has permissions in capabilities and card groups _Opened collaboratively by Nick Hollon and open-swe._ --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-06-05 18:23:33 -04:00
yindo closed this issue 2026-06-05 18:23:33 -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 pull-request
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#3581
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?