2026-06-22 10:48:41 +08:00
# fs/ - filesystem capability family
2026-07-26 05:03:53 +08:00
English | [中文 ](README.zh.md )
2026-08-04 00:54:19 +08:00
The filesystem capability family: provider seam, interchangeable backends, policy, and model-facing tools. All **product ** packages.
2026-06-22 10:48:41 +08:00
| Package | Role | ctx key |
|---|---|---|
2026-08-04 00:54:19 +08:00
| [`fs/` ](fs/README.md ) | Filesystem provider seam and policy-event vocabulary | `ctx.fs` |
| [`fs-local/` ](fs-local/README.md ) | Local-filesystem backend | registers `ctx.fs` |
| [`fs-sandbox/` ](fs-sandbox/README.md ) | Sandbox-enforcing backend | registers `ctx.fs` |
| [`fs-policy/` ](fs-policy/README.md ) | Observed-state and mutation policy | `fs/*` listeners |
| [`tool-fs/` ](tool-fs/README.md ) | Model-facing file tools | registers on `ctx.tools` |
| [`tool-fs-search/` ](tool-fs-search/README.md ) | Process-backed discovery tools | registers on `ctx.tools` |
| [`tool-str-replace-editor/` ](tool-str-replace-editor/README.md ) | Model-facing string-replacement editor | registers on `ctx.tools` |
2026-06-22 10:48:41 +08:00
2026-08-04 00:54:19 +08:00
Backends replace one another behind `ctx.fs` ; policy and tools consume the seam independently. Discovery remains process-backed instead of expanding the provider contract. Child READMEs own containment, mutation, schema, and timeout details.
