agentobserve-py 0.1.0

agentobserve is a unified observability dashboard for the agent infrastructure stack. One view across agentplane policies, agenthooks executions, escalation events, and agent health.

Install

pip install agentobserve                    # zero-dep core
pip install "agentobserve[rich]"            # terminal dashboard
pip install "agentobserve[rich,web]"        # terminal + web dashboard

Quickstart

from agentobserve import ObserveDashboard, Collector

# Point at your audit files
collector = Collector(
    agentplane_audit="~/.agentplane/audit.jsonl",
    agenthooks_audit="~/.agenthooks/audit.jsonl",
)

dash = ObserveDashboard(collector=collector)
dash.print_snapshot()   # one-shot terminal print
dash.run()              # blocking live dashboard (Ctrl+C to exit)

With live agentplane engine

from agentplane import PolicyEngine
from agentobserve import ObserveDashboard

engine = PolicyEngine()
dash = ObserveDashboard(engine=engine)
dash.print_snapshot()

Snapshot API

snap = dash.snapshot()

snap.agent_count        # total agents seen
snap.active_count       # agents with status "active"
snap.degraded_count     # agents in degraded mode
snap.unplugged_count    # unplugged agents
snap.total_evals        # total policy evaluations
snap.block_rate         # fraction of evaluations that were blocked
snap.total_hook_executions  # total agenthooks executions

snap.to_dict()          # JSON-serializable dict

Stack

agentplane    → control plane   (runtime policy, versioning, escalation)
agenthooks    → extensibility   (hookpoints, customer hooks)
agentobserve  → observability   (unified view across all layers)  ← you are here
AgentGuard    → safety          (injection, PII, jailbreak)

Apache 2.0 · Built for production enterprise agents