session-design

What problem does it solve?

Provides a structured session management system to isolate conversational state, persist messages, and automate lifecycle maintenance so that multi-user and multi-channel agents can maintain consistent, auditable context without uncontrolled disk growth.

Core Features & Use Cases

• Session Key & Isolation: Generate deterministic session keys and support isolation modes for per-channel, per-peer, and group contexts.
• Indexed Storage & Archiving: Store messages with indexing, support compression and automatic archiving to control disk usage and retrieval speed.
• Maintenance & API: Automated cleanup, disk quota enforcement, and APIs for session create/get/add/query to integrate with gateways and agents.
• Use Case: A chatbot platform uses per-channel-peer isolation and automated archiving to keep recent conversation context for active users while compressing and archiving stale sessions.

Quick Start

Use the session-design skill to create or retrieve a session for a given agentId, channel, peerId and then add a message while enforcing per-channel isolation and disk quota.