Nothing dispatches anonymously.
A workflow names its purpose, acceptance criteria, runtime, and tool grants before the first action.
intent: review the change
acceptance: verdict = PASSAPACHE 2.0 · SELF-HOSTED · EVENT-SOURCED
AiOverload is the control plane between an agent’s intent and its actions — deterministic workflows, governed tools, human approvals, and a run log you can replay.
run.started8 steps · definition hash pinned
step.completedinspect · acceptance criteria attached
step.heldreview_2 · risk 0.81
Review approves a push the gate cannot vouch for.awaiting decisionExecution remains stopped.
aioctl replay 9c4e71a801 / THE MISSING LAYER
Agent frameworks help models do more. AiOverload governs what happens when they act: what was requested, which rules applied, who approved the risk, and what actually ran.
Named intents, goals, acceptance criteria, agents, tools, and credentials live in reviewed manifests — not implicit session state.
The reflex gate routes steps and holds risk. Gateway enforcement makes the declared tool plane default-deny at the wire.
Approvals, refusals, retries, and outputs are events. Replay reconstructs the run against its definition hash.
02 / ONE GOVERNED RUN
Scroll the run or select a stage. The console follows the decision trail.
A workflow names its purpose, acceptance criteria, runtime, and tool grants before the first action.
intent: review the change
acceptance: verdict = PASSA small, non-generative model scores typed questions inside deterministic rails. Above threshold, the run parks.
step.held · risk = 0.81
gate unreachable → fail closedApprove with constraints or reject the step. The operator’s words become input on the same event log.
approval: review only
constraint: do not pushRe-run the decision logic against the ordered events and pinned definition — not a flattened after-action report.
aioctl replay <run-id>
definition: verifiedWORKFLOW MANIFEST
workflow: dev-review-loop-reflex
goal: reviewed, verified change
acceptance:
- tests: pass
- reviewer: PASS
tools: declared-only
definition: sha256:84f2…c91aREFLEX DECISION
step: review_2
risk: 0.81
threshold: 0.70
decision: HOLD
reason: external side effect
cannot be vouched forOPERATOR INPUT
$ aioctl approve 9c4e71a8 review_2 \
--input "review ok — do not push"
approval.recorded
actor: operator
scope: review_2 only
run.runningREPLAY VERIFICATION
$ aioctl replay 9c4e71a8
definition.verified 84f2…c91a
events.replayed 17/17
approval.verified review_2
run.completed 8/8 stepsILLUSTRATIVE INTERFACE · NOT LIVE TELEMETRY
03 / SYSTEM ANATOMY
Separate control, decision, execution, and observation surfaces compose over NATS JetStream. Every wire payload has a schema; every action has an owner.
ordered events · durable state · aioctl replay04 / THE HUMAN DOOR
Try the decision model. Approval resumes only the held step; rejection keeps it stopped. Both outcomes join the illustrative event trail.
Interactive illustration — no engine connection or real run is created.
step.heldAwaiting an operator decision.05 / A DIFFERENT JOB
Use the framework you prefer. AiOverload owns the governed execution around it.
| Question | Typical agent setup | AiOverload |
|---|---|---|
| What may run? | Whatever the session can reach | Declared workflows and default-deny tools |
| Who approved risk? | A chat message or an external queue | A held step and a recorded operator decision |
| Where are the rules? | Configuration across machines | Reviewed manifests and GitOps state |
| What happened? | Application logs and traces | Replayable, event-sourced run state |
06 / KEEP GOING
Product narrative, implementation detail, known limits, and release state each have their own page — no important caveat buried in a footer.
Why accountable autonomy needs a governed-execution layer.
↗02 / RULESManifests, risk holds, approvals, credentials, and GitOps.
↗03 / RUNThe shortest path from source to a replayable local run.
↗04 / LIMITSContainment layers and open gaps, without the sales filter.
↗05 / PROOFGenerated facts and claim status stamped with an engine commit.
↗06 / CHANGEWhat landed on main, in plain language, with merge stamps.
↗OPEN SOURCE / APACHE 2.0
No customer theatre, invented benchmarks, or black-box promises. The project is new, small, and built to be inspected.
git clone https://github.com/JohGirard/AiOverload.git