Skip to Content
Aionis v0.2 is ready for local agent loops, MCP clients, SDK integrations, and self-managed Runtime deployments.

State Model

Aionis models memory as external execution state. The Runtime uses stateful adjudicators that turn memory evidence into Agent-facing surfaces.

State Categories

StateMeaningDefault prompt posture
Current stateValid evidence for the next action.use_now when authority and scope allow.
Failed branchA route that was tried and rejected.do_not_use or inspect_before_use.
Contested memoryEvidence conflicts with newer or stronger evidence.Inspect-first until resolved.
Stale memoryPreviously useful history that may no longer apply.Inspect-first or blocked.
Procedure memoryReusable workflow evidence.Use when scoped, stable, and not contradicted.
Archived memoryCold history kept outside hot prompt context.rehydrate on demand.

Why State Beats Summary

Plain summaries tend to collapse important distinctions:

"We tried path A, then moved to path B."

Aionis keeps the operational difference:

path A = failed branch / counter-evidence path B = current active path / possible procedure

That difference is what prevents history from becoming accidental instruction.

Execution Tree State

Execution memory can be represented as an execution-state tree:

LayerContains
Raw evidenceTool calls, attempts, validator results, handoffs, feedback.
Current active pathThe branch Aionis believes should carry forward.
Failed branchesBranches retained as counter-evidence instead of primary routes.
Compressed proceduresReusable workflow candidates derived from successful evidence.
Rehydrate pointersLinks back to raw evidence when compact context needs detail.

The Agent receives the useful state: current path, blocked routes, procedure candidates, and rehydrate hints.

State Is Scoped

State is always interpreted inside a scope:

Scope fieldExample
tenant_iddefault
scoperepo:checkout-service
run_idrun-20250615-001
task_signaturecheckout-migration
consumer_agent_idworker-1
consumer_team_idcheckout-team

Most unexpected “Aionis did not remember” issues are scope mismatch issues.

Source Guide

AIONIS_STATE_MODEL.md