vstorm-co / pydantic-ai-backend / 28284328567

100%

push

github

Feat/tool improvements (#58)

* feat: background (long-lived) process support for LocalBackend

Add full A-Z support for spawning, draining, and killing long-lived
background processes (e.g. dev servers) that must outlive a single
execute() call. execute() kills its whole process tree on timeout, so
servers can never survive it — background processes fill that gap.

- types: BackgroundHandle, BackgroundOutput, BackgroundProcessInfo
- protocol: BackgroundSandboxProtocol + AsyncBackgroundSandboxProtocol
  (new protocols, runtime_checkable; existing SandboxProtocol untouched
  so downstream isinstance() gating keeps working)
- LocalBackend: execute_background/read_background/kill_background/
  list_background/kill_all_background — Popen(start_new_session=True),
  stdout/stderr spooled to temp files, incremental drain by byte offset,
  killpg for whole-group teardown, temp dir cleaned on kill_all
- adapter: AsyncBackgroundSandboxAdapter + ensure_async() routing
- console toolset: run_in_background/read_output/kill_shell/list_shells,
  gated behind include_background (default True) and include_execute
- tests: 16 new tests, 100% coverage maintained

Local only — not merged, version unchanged (0.2.14).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* feat: read ceiling, glob mtime sort, edit staleness guard

Three tool behavior improvements (local; no version bump):

- read: cap a single read's output. A default read that overflows is
  truncated to a page; an explicit offset/limit that still overflows
  errors so the agent narrows it instead of flooding context
  (MAX_READ_OUTPUT = 200k chars).
- glob: order results by mtime (newest first) with a path tie-break,
  instead of by path — usually what an agent wants.
- edit: staleness guard at the tool layer. read_file/write_file record a
  content fingerprint; edit_file refuses with a "read it again" error
  when a previously-read file changed on disk since. Files never read
  through ... (continued)

165 of 165 new or added lines in 6 files covered. (100.0%)

1381 of 1381 relevant lines covered (100.0%)

1.0 hits per line