Skip to content

Releases: RaziStuff/agent-black-box

Agent Black Box v0.1.0 Local Alpha

Pre-release

Choose a tag to compare

@RaziStuff RaziStuff released this 30 Jun 18:05

Agent Black Box v0.1.0 Local Alpha

This is the first public local-alpha release of Agent Black Box: a local-first flight recorder, replay debugger, and handoff kit for AI agent workflows.

Landing page:

https://razistuff.github.io/agent-black-box/

What Is Included

  • Local trace recording with abb record
  • Run inspection with abb runs, abb show, abb artifacts, and abb search
  • Replay fixtures with abb fixture create and abb replay
  • Run diffing with abb diff
  • Handoff packets with abb handoff
  • Portable .abb bundles with abb bundle export and abb bundle import
  • Compare packets for request/response and input/output debugging
  • Local HTTP API discovery with abb endpoints --json and abb endpoints --openapi
  • Agent integration kit generation with abb agent-kit
  • Local run deletion with abb delete RUN_ID --yes
  • Browser dashboard via abb start

Download

Recommended for design partners:

  • agent-black-box-0.1.0-design-partner.zip

Package artifacts:

  • agent_black_box-0.1.0-py3-none-any.whl
  • agent-black-box-0.1.0.tar.gz

Design Partners

We are looking for the first three public design partners for the local alpha.

Quick Start

unzip agent-black-box-0.1.0-design-partner.zip
cd agent-black-box-0.1.0-design-partner
sh install.sh
. .venv/bin/activate
abb doctor
abb record -- python3 examples/basic_agent.py
abb runs

Local-First Privacy

Agent Black Box stores data locally by default in .abb/. Handoff JSON files are compact summaries and do not include full artifact payloads. Full portable .abb bundles should be shared intentionally because they can include local trace artifacts.

Use abb delete RUN_ID --yes to remove a run, its local trace rows, replay fixtures, artifact rows, unreferenced artifact object files, and default export files. Use --keep-exports when you want to delete the run but keep generated export files.

Verification

The release was verified with:

  • python3 -m unittest discover -s tests
  • python3 scripts/release-readiness.py --skip-smoke --no-report
  • sh scripts/smoke.sh
  • Fresh clone build, wheel install, abb doctor, abb record, and abb delete

Known environment skips during local smoke:

  • Browser UI render smoke requires Playwright.
  • HTTP client smoke may require local socket permissions in restricted sandboxes.

Checksums

agent_black_box-0.1.0-py3-none-any.whl
SHA-256: 38769901a1fa13ca536413adce6ffe5af461c5b0108325cc77227294fc0110e9

agent-black-box-0.1.0.tar.gz
SHA-256: 4d81eec3fad71c41cd6fec330ac276f8f6385e8d42fc740e0da5633f18159451

agent-black-box-0.1.0-design-partner.zip
SHA-256: 20e3f38638c03fd24a94199ef2d058313214055c1a05a7fb67f678f5cc91db62