Metadata-Version: 2.4
Name: agentobserve-py
Version: 0.1.0
Summary: Unified observability dashboard for the agent stack — metrics, audit, escalations, policy, health
Project-URL: Homepage, https://github.com/naveenkumarbaskaran/agentobserve
Project-URL: Repository, https://github.com/naveenkumarbaskaran/agentobserve
Project-URL: Issues, https://github.com/naveenkumarbaskaran/agentobserve/issues
Author: Naveen Kumar Baskaran
License: Apache-2.0
Keywords: agents,audit,dashboard,enterprise,llm,metrics,observability
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.11
Provides-Extra: all
Requires-Dist: agentobserve[rich,web]; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: rich
Requires-Dist: rich>=13.0; extra == 'rich'
Provides-Extra: web
Requires-Dist: fastapi>=0.111; extra == 'web'
Requires-Dist: uvicorn>=0.30; extra == 'web'
Description-Content-Type: text/markdown

<div align="center">
  <img src="assets/banner.svg" alt="agentobserve" width="100%"/>
</div>

<div align="center">

[![CI](https://github.com/naveenkumarbaskaran/agentobserve/actions/workflows/ci.yml/badge.svg)](https://github.com/naveenkumarbaskaran/agentobserve/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/agentobserve.svg)](https://pypi.org/project/agentobserve/)
[![Python](https://img.shields.io/pypi/pyversions/agentobserve.svg)](https://pypi.org/project/agentobserve/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

</div>

---

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

## Install

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

## Quickstart

```python
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

```python
from agentplane import PolicyEngine
from agentobserve import ObserveDashboard

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

## Snapshot API

```python
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
