Files
deepseek-harness/packages/fs
ZiyaZhang 9a299f9827 fix(fs-local): degrade basis I/O failures to null
Descriptor-phase errnos in readTextForDiff fold to before: null so a file
deleted or made unreadable after the caller's preflight cannot fail the
committed write; cancellation and non-errno faults still propagate. Drops
the now-covered isFile v8 ignore, extends llm-replay with catalog
capability parity (defaultMaxTokens/reasoningEfforts), and records the
fs-write-overwrite-bounded keyless snapshot pinning the over-limit
whole-file fallback through the real acp-agent composition.
2026-08-08 11:49:42 -07:00
..

fs/ - filesystem capability family

English | 中文

The filesystem capability family: provider seam, interchangeable backends, policy, and model-facing tools. All product packages.

Package Role ctx key
fs/ Filesystem provider seam and policy-event vocabulary ctx.fs
fs-local/ Local-filesystem backend registers ctx.fs
fs-sandbox/ Sandbox-enforcing backend registers ctx.fs
fs-policy/ Observed-state and mutation policy fs/* listeners
tool-fs/ Model-facing file tools registers on ctx.tools
tool-fs-search/ Process-backed discovery tools registers on ctx.tools
tool-str-replace-editor/ Model-facing string-replacement editor registers on ctx.tools

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.