kestrel-feature-story-archive

Schema-rich agent life-story archive for Kestrel Sovereign.

An agent maintains a queryable, semantic archive of its life-story: interactions, observations, and reflections, organized as a timeline with vector search and contradiction detection. This is a reusable framework capability — a sibling package alongside kestrel-feature-healthcare / -visual / -reflection / -observability — not a host-product feature. Any Kestrel host can consume it.

Status

Bootstrap skeleton (FEAT-1). Business logic lands in FEAT-2..5:

FEAT-2 — entity models (Story, StoryChunk, StoryEvent) + Alembic migrations
FEAT-3 — TimelineBuilder (session → Story/StoryEvent/StoryChunk extractor)
FEAT-4 — VectorSearch integration for semantic story retrieval
FEAT-5 — sharing, replay, export, contradiction detection services

This package migrates the 8,240-LOC Story Archive stack from Frinz into a reusable feature package so other consumers (RemoteCares/RPM Azure pilot) can leverage it. Records are scoped to agent_did (the canonical owner identity per the Agent Identity Contract).

Installation

uv pip install kestrel-feature-story-archive

The package registers StoryFeature through the kestrel_sovereign.features entry-point group and registers its entity models via the kestrel_entities.models entry-point for Alembic autogen.

Development

uv sync --extra test
uv run --extra test pytest

Architecture

Records are agent_did-scoped and persisted via kestrel-feature-entities ORM layer. The feature consumes the DatabaseBackend from the host and leverages the Timeline and VectorSearch protocols (kestrel-sovereign-sdk v0.16.0+).

No product-specific terminology anywhere in this package — vocabulary is agent / agent_did / owner throughout. This is a framework capability.

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_story_archive-0.3.2.tar.gz (82.2 kB view details)

Uploaded Jul 14, 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_story_archive-0.3.2-py3-none-any.whl (91.2 kB view details)

Uploaded Jul 14, 2026 Python 3

File details

Details for the file kestrel_feature_story_archive-0.3.2.tar.gz.

File metadata

Download URL: kestrel_feature_story_archive-0.3.2.tar.gz
Upload date: Jul 14, 2026
Size: 82.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kestrel_feature_story_archive-0.3.2.tar.gz
Algorithm	Hash digest
SHA256	`3bd7d7852ad2bd0dfdc9f8b2d61b5775973429ae4a38e646f6f6910c2c9b8ee0`
MD5	`9ba93a0dd5df0345aeb4cecc358c4782`
BLAKE2b-256	`01aabdb13725ec47ce776c1f753270765ac8614fc9b6c44ce4b339512f51c2b6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for kestrel_feature_story_archive-0.3.2.tar.gz:

Publisher: publish.yml on KestrelSovereignAI/kestrel-feature-story-archive

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_story_archive-0.3.2.tar.gz
- Subject digest: 3bd7d7852ad2bd0dfdc9f8b2d61b5775973429ae4a38e646f6f6910c2c9b8ee0
- Sigstore transparency entry: 2169718106
- Sigstore integration time: Jul 14, 2026
Source repository:
- Permalink: KestrelSovereignAI/kestrel-feature-story-archive@3d981b49bab7a8f0e97c6c62994c0762ab654407
- Branch / Tag: refs/tags/v0.3.2
- Owner: https://github.com/KestrelSovereignAI
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@3d981b49bab7a8f0e97c6c62994c0762ab654407
- Trigger Event: push