Skip to content

Releases

Poisson Break 0.1.0

Choose a tag to compare

@TaylorKolasinski TaylorKolasinski released this 16 Nov 16:42
v0.1.0
37da225

The first release, an alpha. Break runs an agent many times while changing how its tools behave
and what the user asks, keeps the conditions that fail more than a control, confirms them on
fresh runs with Poisson Trace's test, and checks a fix against them later. This version has one
way in, rollout (an agent Break calls as a Python function), ten tool faults, five input
operators, two search strategies that do not learn, and eight commands.

What a first user gets:

  • pip install poisson-break, then poisson-break init --example desk, hunt --yes and
    confirm --yes end with three findings on a help desk agent, with no key and no network.
  • Five examples, each written into a folder by init --example NAME and each run offline
    against a scripted model: desk, full-loop (hunt, confirm, a fix, recheck), stand-in (a
    write tool that is never really called), own-check (a failure rule of your own) and
    own-fault (a fault of your own). They ride in the wheel.
  • The docs: the catalogue, reading a finding, checking a fix, the rollout way in, recipes for
    making cases from LangSmith, Langfuse and Phoenix exports, what Break does not claim, and one
    page for each of the four extension points, and a reference for the commands, the settings
    file, the stored runs and the library. Every command the README and the docs show is
    run in CI from the installed wheel, and every program they show is run there too.
  • catalog --labels shows, beside a change, the labels it carries from the OWASP Top 10 for
    LLM Applications 2025 and NIST AI 100-2 E2025, where the table has a row for it. Each row
    quotes the published text it rests on.

Install

python -m venv .venv
. .venv/bin/activate
pip install poisson-break
poisson-break init --example desk
poisson-break hunt --yes
poisson-break confirm --yes

Break needs Python 3.11 or later, on macOS or Linux. pip installs poisson-prove 0.1.3 and poisson-trace 0.1.0a1 with it, each at that exact version. Run Break against a test environment: it calls your tools for real.

More