THE RUNTIME
The event log is not an audit add-on. It is the runtime.
AiOverload turns agent work into deterministic workflows. A run starts from a versioned definition, advances through ordered events on NATS JetStream, and can be reconstructed decision by decision. The log holds dispatch, holds, approvals, retries, outputs, and terminal state.
Declare
Workflow, goal, acceptance, tools.
Decide
Route, allow, hold, or block.
Dispatch
Worker, sidecar, scoped access.
Judge
Check output against acceptance.
Record
Append every transition to the log.
The important consequence: a report is not generated after the fact and asked to explain a run. The evidence is the same ordered state that drove it.
CONTRACTS BEFORE CODE
Every surface agrees on the message.
Unknown keys are loud errors. Services agree by schema, not by convention. At the stamped engine commit, 34 JSON schemas describe the wire contracts exchanged by the engine and reflex gate.
| Contract | What it pins down |
|---|---|
| Workflow definition | Steps, goals, acceptance criteria, dependencies, runtime, and grants |
| Run events | Ordered transitions and the payloads attached to them |
| Reflex decisions | Typed questions and constrained decisions, not free-form chat |
| Tool plane | Registry-allowlisted MCP servers and per-run grants |
| Sidecar boundary | argv-only execution and the run workspace contract |
This discipline makes drift visible early: a producer and consumer either agree on the schema or the build fails.
REFLEX GATE
Small judgment. Deterministic rails.
The reflex gate is a decision service, not another autonomous agent. A small non-generative model answers typed questions; deterministic thresholds turn those answers into routing, escalation, and holds.
- Step escalation: risk above
0.70holds for human input. - Tool escalation: gateway-routed calls at or above
0.45escalate. - Fail closed: if the gate is unreachable at dispatch, a gated step does not proceed ungoverned.
- Measured regression: verdict and goal judgments have CI-enforced accuracy floors on a pinned model checkpoint.
The gate is triage. It does not make the containment boundary stronger, and it does not see harness-native tools that never cross the gateway. Those limits are part of the threat model.
TOOL PLANE
An undeclared server does not exist on the wire.
For gateway-routed work, the agent manifest’s allowlist is rendered into the run configuration and enforced by agentgateway. Default-deny is therefore both a configuration rule and a network rule.
Per-run credentials are minted and revoked for supported gateway-backed provider runs. The LLM plane through the gateway remains opt-in, and subscription-based harness sessions can inherit credentials instead. The security page grades those boundaries separately rather than calling every runtime “sandboxed.”
manifest grant → run config → agentgateway → allowlisted MCP server
└─ undeclared target → denied at the wire
REPLAY
History you can execute, not just read.
Replay takes the ordered events and the definition hash, then re-verifies the run’s decisions. That gives operators a concrete way to inspect why a run waited, who changed its course, and whether the recorded definition matches.
aioctl replay <run-id>
definition.verified 84f2…c91a
events.replayed 17/17
approval.verified review_2
run.completed 8/8 steps
The output above is illustrative formatting, not a captured benchmark. The capability claim is pinned to the engine’s aioctl replay implementation and end-to-end tests.
COMING FROM DEVOPS?
Familiar ideas, applied to agent execution.
| If you know… | The AiOverload equivalent |
|---|---|
| GitOps | Agents, workflows, and grants declared in a reviewed repository |
| Kubernetes admission control | Pre-flight policy decisions and gateway refusal before execution |
| CI/CD manual approval | step.held, explicit operator input, and a recorded decision |
| Terraform drift detection | Reconciliation between desired registry state and the served fleet |
| Distributed tracing + audit logs | Ordered run events that can be replayed against the definition |