etaoi-schema 0.5.0

Shared wire schema for VIZ (Pydantic v2 source of truth)

agentviz-schema (Python)

Shared wire schema for VIZ — the Pydantic v2 source of truth for every type that crosses the SDK / server / UI boundary.

This package is consumed by:

• agentviz — Python SDK that streams telemetry over WebSocket
• agentviz-server — FastAPI backend that persists events to ClickHouse and fans them out over SSE
• agentviz-ui — Next.js UI (via the TypeScript mirror in ../typescript/)

The TypeScript mirror in ../typescript/ is hand-maintained from this source. A CI msgpack-roundtrip parity test (Phase 1 Plan 07) prevents drift.

Public surface

from agentviz_schema import (
    # Core domain
    Session, Trace, Span,
    # Events (discriminated union on `kind`)
    SpanStartEvent, SpanDeltaEvent, SpanEndEvent, Event,
    # Envelope (D-04)
    Envelope,
    # Handshake (D-06)
    Hello, Welcome, MismatchError,
    # Versioning policy (D-05)
    is_major_compatible,
    # Constants
    SCHEMA_VERSION,
    WS_CLOSE_SCHEMA_MISMATCH,    # 4400
    SSE_MISMATCH_HTTP_STATUS,    # 426
)

See CONTRIBUTING.md for the additive-only-within-major versioning policy.