0.1.0
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_verdictalwaysnull). - Two execution modes — one-shot
acpx execand 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 acpx0.12.0. - Operational tooling — read-only
doctor, confined retention/cleanup, process-liveness crash recovery, and local dev gates viamake verify/./scripts/verify_local.sh.
Install
pip install agent-run-supervisor==0.1.0
agent-run-supervisor doctorOr from source with uv:
git clone https://github.com/jovijovi/agent-run-supervisor.git
cd agent-run-supervisor
make sync && make verifyRequirements
- 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_rootsis 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.