antaris-contracts 1.0.0

Versioned state schemas, failure semantics, and debug CLI for the Antaris Analytics Suite.

antaris-contracts

Versioned state schemas, failure semantics, and debug tooling for the antaris-suite.

antaris-contracts defines the shared data contracts used across all antaris packages — ensuring consistent serialization, migration, and observability without coupling the packages to each other.

Installation

pip install antaris-contracts

What's Included

• State schemas — Versioned dataclass contracts for memory, router, guard, context, and telemetry state
• Migration tooling — Chained schema migrations with version detection and rollback safety
• Failure semantics — Canonical error types and failure modes documented in FAILURE_SEMANTICS.md
• Concurrency model — Lock ordering and thread-safety contracts in CONCURRENCY_MODEL.md
• antaris-debug CLI — Inspect memory stores, tail telemetry logs, validate schema files

CLI Usage

# Inspect a memory workspace
antaris-debug memory inspect ./my_agent_workspace

# Search memories
antaris-debug memory search ./my_agent_workspace "important decision"

# Tail a telemetry log
antaris-debug telemetry tail ./telemetry.jsonl

# Validate a schema file
antaris-debug schema validate ./state.json

Schema Usage

from antaris_contracts.schemas.memory import MemoryState
from antaris_contracts.schemas.router import RouterState
from antaris_contracts.migration import migrate

# Load and auto-migrate state
raw = json.loads(open("state.json").read())
state = migrate(raw, target_version="2.2.0")

Zero Runtime Dependencies

antaris-contracts has no runtime dependencies beyond the Python standard library. It is safe to import in any environment.

Part of antaris-suite

Package	Role
antaris-contracts	Schemas + contracts (this package)
antaris-memory	Persistent agent memory
antaris-router	Intelligent model routing
antaris-guard	Input/output safety layer
antaris-context	Context window management
antaris-pipeline	Orchestration + telemetrics

License

Apache 2.0 — see LICENSE