diff --git a/.story_kit/work/1_upcoming/176_story_matrix_bot_conversation_context_and_multi_room.md b/.story_kit/work/1_upcoming/176_story_matrix_bot_conversation_context_and_multi_room.md new file mode 100644 index 0000000..78b3ed6 --- /dev/null +++ b/.story_kit/work/1_upcoming/176_story_matrix_bot_conversation_context_and_multi_room.md @@ -0,0 +1,36 @@ +--- +name: Matrix Bot Conversation Context and Multi-Room +--- + +# Matrix Bot Conversation Context and Multi-Room + +## User Story + +As a developer, I want the Matrix bot to remember recent conversation history and work across multiple rooms so that conversations feel natural and different projects or teams can have their own rooms. + +## Background + +Story 174 delivers a basic Matrix bot that responds to individual messages with no memory. This story adds: +- Per-room conversation context so the bot remembers what you were just talking about +- Multi-room support so a single Story Kit instance can serve multiple rooms (e.g., a project room and a 1:1 DM) + +## Acceptance Criteria + +- [ ] Bot maintains a rolling conversation history per room (last N messages, configurable) +- [ ] Conversation context is included when calling the LLM so it can reference earlier messages +- [ ] Bot handles multiple rooms independently (configured in `bot.toml` as a list of room IDs) +- [ ] Each room has its own independent conversation history +- [ ] History is in-memory only — restarting the server resets context (persistence is a future concern) +- [ ] Bot correctly attributes messages to different Matrix users in the conversation history + +## Out of Scope +- Persistent conversation history across restarts +- Per-room configuration (different LLM models, different tool access) +- Thread-based conversations (Matrix threads) +- User-specific context or preferences + +## Technical Notes +- Store conversation history as a `HashMap>` with a configurable max length +- Trim oldest messages when the history exceeds the limit +- Include Matrix display names in the message context so the LLM knows who said what +- Depends on 174 (Matrix bot infrastructure)