etaoi 0.0.4

Agent-native trace SDK for LangChain / LangGraph / deepagents (skeleton)

etaoi

Python SDK for VIZ — an agent-native trace visualizer for the LangChain ecosystem and LiveKit voice agents.

Status: Skeleton. This package exists so CI is green from day one; the real implementation (LangChain BaseCallbackHandler adapter, WebSocket transport, MessagePack serialization, background flush) lands in Phase 2 of the delivery roadmap.

When complete, a developer will be able to:

import etaoi

etaoi.attach(my_agent)  # streams telemetry to a local VIZ server

Etaoi Cloud (project API keys)

To stream to the hosted ingest instead of a local self-host server, pass a host plus your project's API keys:

import etaoi

etaoi.attach(
    my_agent,
    host="wss://ingest.etaoi.dev",   # https:// → wss://, bare host → wss://, default path /ingest
    public_key="pk_live_…",
    secret_key="sk_live_…",
)

The keys are sent as X-Etaoi-Public-Key / X-Etaoi-Secret-Key request headers on every (re)connect — and only when both are set, so self-host stays key-less. You can also configure them via environment variables (explicit params take precedence):

export ETAOI_HOST=ingest.etaoi.dev
export ETAOI_PUBLIC_KEY=pk_live_…
export ETAOI_SECRET_KEY=sk_live_…

etaoi.attach(my_agent)  # picks up ETAOI_HOST / ETAOI_PUBLIC_KEY / ETAOI_SECRET_KEY

If the server rejects the keys (WS close code 4401), the SDK logs a clear error (Etaoi: invalid API key — check public_key/secret_key) and stops reconnecting. It never raises into or blocks your agent.

For the wire schema this package depends on, see etaoi-schema.