session-key-architecture

What problem does it solve?

Session keys are the backbone of routing messages to the correct conversation context, agent sessions, and project bindings across multiple platforms, enabling consistent routing and cross-thread continuity.

Core Features & Use Cases

• Documents platform-specific session key formats (per-user, per-chat, channel-shared, and thread-isolated variants)
• Describes BaseSessionKeyer as a fallback mechanism for cross-thread persistence
• Provides guidance for debugging routing issues, project binding lookups, and platform integration decisions
• Use Case: diagnosing why a /project switch does not persist when starting a new thread, and applying a base key to maintain binding
• Use Case: designing a new platform integration with thread isolation and fallback keys

Quick Start

Describe how your platform derives session keys for a new integration and how to use the base key to maintain binding across threads.