Skip to content

0.1.0

Choose a tag to compare

@jovijovi jovijovi released this 06 Jul 10:10
288eeb3

First public pre-release of agent-run-supervisor — a local-first Python library and CLI that supervises ACP/acpx external AGENT runs and produces redacted, auditable evidence.

Highlights

  • Role-bound supervision — validate AgentRoleSpec, compile default-deny acpx policy/argv, and classify supervisor-owned status (business_verdict always null).
  • Two execution modes — one-shot acpx exec and a local persistent-session lifecycle (create, send, status, close, abort, list).
  • Auditable by default — restrictive-permission artifacts (0700/0600), redaction boundary, and deterministic fixture replay for acpx 0.12.0.
  • Operational tooling — read-only doctor, confined retention/cleanup, process-liveness crash recovery, and local dev gates via make verify / ./scripts/verify_local.sh.

Install

pip install agent-run-supervisor==0.1.0
agent-run-supervisor doctor

Or from source with uv:

git clone https://github.com/jovijovi/agent-run-supervisor.git
cd agent-run-supervisor
make sync && make verify

Requirements

  • Runtime: Python ≥ 3.11, standard-library only (zero third-party runtime dependencies).
  • Real AGENT runs: Node.js, acpx, and the target AGENT CLI must be available locally.

Notes

  • This is an alpha release (0.1.0); surfaces and result schemas may still change.
  • The supervisor validates cwd intent only — allowed_roots is not an OS/filesystem sandbox.
  • No business verdict, IM delivery, Gateway lifecycle, or public ingress is included; see project non-goals in the README.

Full changelog

See CHANGELOG.md.