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