agent-session-linker

Cross-session context persistence and resumption

Part of the AumOS open-source agent infrastructure portfolio.

Features

• SessionManager provides create/save/load/list/delete lifecycle management over a pluggable StorageBackend ABC with checksum validation on every serialization round-trip
• Five storage backends out of the box: in-memory, filesystem (JSON files), SQLite, Redis, and S3 — swap backends without changing application code
• ContextInjector selects and injects prior session context into a new conversation based on relevance scoring and configurable freshness thresholds
• Entity extraction and cross-session linking tracks named entities (people, places, topics) across sessions so the agent can resume threads without being explicitly told what it discussed
• ContextSummarizer compresses long session histories to fit within token budgets while preserving the entities and decisions that matter
• Session middleware with automatic checkpoint creation and context-window management that prevents unbounded context growth
• SessionLinker chains related sessions by shared entities, enabling multi-session reasoning across conversations that span days or weeks

Quick Start

Install from PyPI:

pip install agent-session-linker

Verify the installation:

agent-session-linker version

Basic usage:

import agent_session_linker

# See examples/01_quickstart.py for a working example

Documentation

• Architecture
• Contributing
• Changelog
• Examples

Enterprise Upgrade

For production deployments requiring SLA-backed support and advanced integrations, contact the maintainers or see the commercial extensions documentation.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

Apache 2.0 — see LICENSE for full terms.

Part of AumOS — open-source agent infrastructure.