Cross-session context persistence and resumption
Project description
agent-session-linker
Cross-session context persistence and resumption
Part of the AumOS open-source agent infrastructure portfolio.
Features
SessionManagerprovides create/save/load/list/delete lifecycle management over a pluggableStorageBackendABC 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
ContextInjectorselects 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
ContextSummarizercompresses 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
SessionLinkerchains 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
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_session_linker-0.2.0.tar.gz.
File metadata
- Download URL: agent_session_linker-0.2.0.tar.gz
- Upload date:
- Size: 136.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f9dc0c22d0a2dad05bdb45e96009f572bc2b2b8cfb58043e51274f5e3ac21114
|
|
| MD5 |
acf01a45046f8275a8775540d605f114
|
|
| BLAKE2b-256 |
11d3d782d105adace8c5d17375cdeea40d4b9035a4734ebc6034dd8c50f7b412
|
File details
Details for the file agent_session_linker-0.2.0-py3-none-any.whl.
File metadata
- Download URL: agent_session_linker-0.2.0-py3-none-any.whl
- Upload date:
- Size: 101.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
31fa6e84738a604de978ede448e78c59c86edcea62aa20e420546354b3c5484f
|
|
| MD5 |
318f7bb7943ec5438b91d3a65c2b3273
|
|
| BLAKE2b-256 |
5ec71319c556c70564d131ac9a320f6ee9a2a04ca70bd1ad2357ea4aab879243
|