Skip to main content

Cross-session context persistence and resumption

Project description

agent-session-linker

Cross-session context persistence and resumption

CI PyPI version Python versions License

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

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


Download files

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

Source Distribution

agent_session_linker-0.2.0.tar.gz (136.1 kB view details)

Uploaded Source

Built Distribution

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

agent_session_linker-0.2.0-py3-none-any.whl (101.4 kB view details)

Uploaded Python 3

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

Hashes for agent_session_linker-0.2.0.tar.gz
Algorithm Hash digest
SHA256 f9dc0c22d0a2dad05bdb45e96009f572bc2b2b8cfb58043e51274f5e3ac21114
MD5 acf01a45046f8275a8775540d605f114
BLAKE2b-256 11d3d782d105adace8c5d17375cdeea40d4b9035a4734ebc6034dd8c50f7b412

See more details on using hashes here.

File details

Details for the file agent_session_linker-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_session_linker-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 31fa6e84738a604de978ede448e78c59c86edcea62aa20e420546354b3c5484f
MD5 318f7bb7943ec5438b91d3a65c2b3273
BLAKE2b-256 5ec71319c556c70564d131ac9a320f6ee9a2a04ca70bd1ad2357ea4aab879243

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page