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.1.0.tar.gz (111.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.1.0-py3-none-any.whl (79.8 kB view details)

Uploaded Python 3

File details

Details for the file agent_session_linker-0.1.0.tar.gz.

File metadata

  • Download URL: agent_session_linker-0.1.0.tar.gz
  • Upload date:
  • Size: 111.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.1.0.tar.gz
Algorithm Hash digest
SHA256 d7459acd33aa6395413f8e3e8cbfabbc833e607ae2d5ca8705b6522d7c6ce8a1
MD5 4a214a5292091547bafe14a74691f0e4
BLAKE2b-256 2c2f0943263bbb53da597d17f530ddc43a8701afc0f3b06cf166f40512c73e83

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agent_session_linker-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e794d2657d608a4d8b5cb1e175e3d9b73037abc063773aa7fbaa2b8977cf8ffd
MD5 5beaffa8cc4482b3a4e392afdb6901ca
BLAKE2b-256 2276b0de7f323a4a315744487b572464b387fdcdef0b9e3c98a8409edbff0aef

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