kestrel-feature-observability

Lifecycle event observability for Kestrel Sovereign agents. Attaches an ObservabilityHook to the agent's hook system; every lifecycle event is logged to the agent's observability_store. Prometheus metrics emit through the SDK's shared registry, so a single /metrics scrape stays coherent across the framework + every feature package.

Installation

uv pip install kestrel-feature-observability

For real Prometheus output:

uv pip install 'kestrel-feature-observability[metrics]'

The feature is auto-discovered by Kestrel Sovereign via the kestrel_sovereign.features entry point — install it alongside kestrel-sovereign and ObservabilityFeature registers itself at startup.

Tools

Tool	Category	Description
`observability_summary`	DATA_ACCESS	Recent metric and error counts
`observability_query`	DATA_ACCESS	Query lifecycle events by type and time window
`observability_session`	DATA_ACCESS	Per-session event timeline

Privacy

The hook is observational — it never blocks, denies, or modifies. User-message content is not logged (only length); tool errors are truncated to 200 chars; exceptions in the hook are swallowed so they cannot affect agent operation.

Dependencies

kestrel-sovereign-sdk>=0.14.1,<1 — base Feature, tool, ToolCategory, Hook, and shared metrics module
Optional [metrics] extra → kestrel-sovereign-sdk[metrics] → prometheus-client

No runtime dependency on kestrel-sovereign itself; the feature accesses agent.observability_store via duck typing, so it works against any host that provides one.

Development

uv pip install -e '.[test]'
uv run pytest

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kestrel_feature_observability-0.3.0.tar.gz (17.5 kB view details)

Uploaded Jul 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

kestrel_feature_observability-0.3.0-py3-none-any.whl (20.8 kB view details)

Uploaded Jul 4, 2026 Python 3

File details

Details for the file kestrel_feature_observability-0.3.0.tar.gz.

File metadata

Download URL: kestrel_feature_observability-0.3.0.tar.gz
Upload date: Jul 4, 2026
Size: 17.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kestrel_feature_observability-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`5768379da186d539c89e17dd27fc4a6121cbc686d0f17e0bbfbda2a43aa6db40`
MD5	`3faae092c205f61f19aae0899062cfd2`
BLAKE2b-256	`9cfba23ef0fbaefe1320940b906435713c87e88261e1ff54b60e0788ee0afb2d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for kestrel_feature_observability-0.3.0.tar.gz:

Publisher: publish.yml on KestrelSovereignAI/kestrel-feature-observability

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: kestrel_feature_observability-0.3.0.tar.gz
- Subject digest: 5768379da186d539c89e17dd27fc4a6121cbc686d0f17e0bbfbda2a43aa6db40
- Sigstore transparency entry: 2071737424
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: KestrelSovereignAI/kestrel-feature-observability@834b3aee5fe6d7411a07635f95841b74c1b2069b
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/KestrelSovereignAI
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@834b3aee5fe6d7411a07635f95841b74c1b2069b
- Trigger Event: push