aios-protocol — Canonical Agent OS Protocol

This crate defines the shared types, event taxonomy, and trait interfaces that all Agent OS projects (Arcan, Lago, Praxis, Autonomic) depend on.

It is intentionally dependency-light (no runtime deps like tokio, axum, or redb) so it can be used as a pure contract crate.

Module Overview

• [ids] — Typed ID wrappers (SessionId, EventId, BranchId, BlobHash, etc.)
• [event] — EventEnvelope + EventKind (~55 variants, forward-compatible)
• [state] — AgentStateVector, BudgetState (homeostasis vitals)
• [mode] — OperatingMode, GatingProfile (operating constraints)
• [policy] — Capability, PolicySet, PolicyEvaluation
• [tool] — ToolCall, ToolOutcome, ToolDefinition, ToolResult, Tool trait, ToolRegistry
• [sandbox] — SandboxTier, SandboxLimits, NetworkPolicy
• [memory] — SoulProfile, Observation, Provenance, MemoryScope
• [session] — SessionManifest, BranchInfo, CheckpointManifest
• [payment] — PaymentPort for agent financial operations (x402, MPP)
• [ports] — Runtime boundary ports (event store, provider, tools, policy, approvals, memory)
• [error] — KernelError, KernelResult