Metadata-Version: 2.4
Name: kestrel-feature-observability-fleet
Version: 0.4.0
Summary: Fleet-scoped observability HostFeature for Kestrel Sovereign — fleet-wide event store (entities/tenant-scoped), host-root ingest/query, a streamable live stream, and the orchestrator swimlane panel
Project-URL: Homepage, https://kestrelsovereign.com
Project-URL: Source, https://github.com/KestrelSovereignAI/kestrel-feature-observability-fleet
Project-URL: Issues, https://github.com/KestrelSovereignAI/kestrel-feature-observability-fleet/issues
Author: UncleSaurus
Maintainer: UncleSaurus
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,fleet,host-feature,kestrel,observability
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Monitoring
Requires-Python: <3.15,>=3.11
Requires-Dist: kestrel-feature-entities<1,>=0.1
Requires-Dist: kestrel-sovereign-sdk<0.30,>=0.29.2
Provides-Extra: test
Requires-Dist: fastapi>=0.110.0; extra == 'test'
Requires-Dist: httpx>=0.27.0; extra == 'test'
Requires-Dist: kestrel-feature-entities<1,>=0.1; extra == 'test'
Requires-Dist: kestrel-sovereign-sdk<0.30,>=0.29.2; extra == 'test'
Requires-Dist: pytest-asyncio>=1.1.0; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Description-Content-Type: text/markdown

# kestrel-feature-observability-fleet

Fleet-scoped observability **HostFeature** for Kestrel Sovereign.

This is the fleet *consumer/aggregator*: a host-scoped feature (discovered via the
`kestrel_sovereign.host_features` entry-point group) that owns a **fleet-wide,
tenant-scoped event store** (via `kestrel-feature-entities`), serves **host-root**
ingest/query endpoints and a **streamable live stream**, and ships the
**orchestrator swimlane** console panel.

The per-agent *producer* (the emitter hook) lives separately in
[`kestrel-feature-observability`](https://github.com/KestrelSovereignAI/kestrel-feature-observability) —
producer and consumer are deliberately split by scope so the per-agent emitter
stays lightweight (no DB/ORM stack) while the DB layer is confined to the host.

Part of the fleet-host-features epic: `KestrelSovereignAI/kestrel-claws#27`.

## Install

```bash
uv pip install kestrel-feature-observability-fleet
```

Auto-discovered by the Kestrel Sovereign host at host scope; enable via the host
feature manifest. Requires a host running the host-feature runtime
(kestrel-sovereign `HostFeature` support, SDK ≥ 0.29.2).

## Status

Scaffold — the entities model, host-root ingest/query endpoints, streamable
stream, and swimlane panel are implemented per the Phase 2 issue.
