feat: onboarding overhaul, persona-based setup (#132)

2026-01-15 03:28:37 +04:00
parent a1a2714c01
commit ffae80dce7
32 changed files with 1870 additions and 445 deletions
@@ -0,0 +1,43 @@
+# Chat sessions
+
+Chat sessions store one resume token per engine per chat (per sender in group chats), so new messages can auto-resume without replying. Reply-to-continue still works and updates the stored session for that engine.
+
+## Enable chat sessions
+
+```toml
+[transports.telegram]
+session_mode = "chat" # stateless | chat
+```
+
+With `session_mode = "chat"`, new messages in the chat continue the current thread automatically.
+
+## Reset a session
+
+Use `/new` to clear the stored session for the current scope:
+
+- In a private chat, it resets the chat.
+- In a group, it resets **your** session in that chat.
+- In a forum topic, it resets the topic session.
+
+See `/new` in [Commands & directives](../reference/commands-and-directives.md).
+
+## Resume lines and branching
+
+Chat sessions do not remove reply-to-continue. If resume lines are visible, you can reply to any older message to branch the conversation.
+
+If you prefer a cleaner chat, hide resume lines:
+
+```toml
+[transports.telegram]
+show_resume_line = false
+```
+
+## How it behaves in groups
+
+In group chats, Takopi stores a session per sender, so different people can work independently in the same chat.
+
+## Related
+
+- [Conversation modes](../tutorials/conversation-modes.md)
+- [Forum topics](topics.md)
+- [Commands & directives](../reference/commands-and-directives.md)