surfaces/docs/research
Mikhail Putilovskij 67499daa61 feat: extend platform mock + add research docs
platform/interface.py:
- Add Attachment, MessageChunk, AgentEvent types
- Add stream_message() to PlatformClient Protocol (door open for streaming)
- Add WebhookReceiver Protocol

platform/mock.py:
- Add attachment_mode config (url/binary/s3)
- Implement stream_message() — single chunk, ready for real streaming
- Add register_webhook_receiver() + simulate_agent_event() for testing

docs/research/:
- telegram-forum-topics.md — aiogram 3.x Forum Topics API, FSM patterns, UX analysis
- fsm-patterns.md — FSM storage options, StateData best practices
- matrix-spaces.md — matrix-nio Space API, room ordering, invite flow
- matrix-events.md — reactions, threads, typing, sync loop pitfalls
- telegram-chat-alternatives.md — 7 alternatives for multi-chat UX, virtual chats in DM recommended
2026-03-30 14:04:34 +03:00
..
.gitkeep init: surfaces-bot — Telegram & Matrix prototype 2026-03-27 00:35:42 +03:00
fsm-patterns.md feat: extend platform mock + add research docs 2026-03-30 14:04:34 +03:00
matrix-events.md feat: extend platform mock + add research docs 2026-03-30 14:04:34 +03:00
matrix-spaces.md feat: extend platform mock + add research docs 2026-03-30 14:04:34 +03:00
telegram-chat-alternatives.md feat: extend platform mock + add research docs 2026-03-30 14:04:34 +03:00
telegram-forum-topics.md feat: extend platform mock + add research docs 2026-03-30 14:04:34 +03:00