SIGN IN SIGN UP

chore(deepagents): clarify LocalShellBackend virtualMode behavior (#577)

## Summary

Fixes #544.

Clarifies `LocalShellBackend` path semantics without introducing a
breaking default change. This keeps legacy behavior intact while making
the bounded-workspace setup explicit in docs and examples.

## Changes

### deepagents (`LocalShellBackend`)

- Clarified `LocalShellBackendOptions` docs to explicitly note that
`rootDir` does not bound filesystem paths when `virtualMode` is `false`.
- Updated `LocalShellBackend` examples to use `virtualMode: true` when
bounded path semantics are intended.
- Added unit coverage to assert legacy behavior is preserved: with
`virtualMode: false`, absolute writes can resolve outside `rootDir`.
H
Hunter Lovell committed
27ebdc3fea9ffa1aeda50ad9341bcf9eede1dc9c
Parent: 18557db
Committed by GitHub <noreply@github.com> on 6/2/2026, 10:44:34 PM