Repository navigation
Releases: jspv/sheath
Releases · jspv/sheath
Release list
0.3.0
search and read_file share 1-based line numbers
- Breaking:
read_file(path, offset=0, limit)is nowread_file(path, start_line=1, limit), andstart_lineis 1-based.offsetwas 0-based whilesearchreports 1-based
lines, so passing a hit'slineasoffsetstarted the read one line after the match. searchtakescontext(0–10). Each hit then also carriesbeforeandafter, the
bounded text of up to that many neighbouring lines, so a match can be seen in one call.
Context is read the same way for ripgrep and the Python fallback, so both give identical
results; a neighbour that is itself a match still appears as context.
edit_file, glob filtering, search output modes, numbered reads
- New
edit_file(path, old, new, replace_all=False)tool in thefilesbundle: replaces exact
text, so changing part of a file no longer means resending all of it throughwrite_file.
oldmust be unique unlessreplace_allis set; a miss or an ambiguous match is an error
that names the lines involved (or a near match differing only in case or whitespace) and
leaves the file untouched. The write is atomic and keeps the file's line endings and
permissions. It refuses the directorieswrite_filerefuses, binary and non-UTF-8 files,
and files over 10 MiB; its reply shows the edited lines, numbered and bounded. list_filestakes a globpatternmatched against paths relative topath(*within one
folder,**across folders, e.g.**/*.csv).searchtakesoutput:"hits"(default, unchanged),"files"(each matching file once)
or"count"(matching lines per file). For the file outputsmax_matchescaps files, not
lines. Both backends give the same results.read_filetakesline_numbers, prefixing each line with its number and a tab.
sheath 0.2.1
Fixes run_python helpers (load/save without an import) and spill handling for MCP tools loaded under progressive disclosure; adds agent_kwargs on the facade paths. One behavior change: create_agent now refuses shell_executor, file_access_store and background_agents. See CHANGELOG.md for details.
sheath 0.2.0
Breaking release: renamed from tether-harness. See CHANGELOG.md for details.