Surfaces_team/surfaces
4
0
Fork 0
Code Issues 5 Pull requests Projects Releases Packages Wiki Activity Actions

[core] Реализовать core/protocol.py — унифицированные структуры Surface Protocol #1

New issue
Closed
opened 2026-03-26 22:02:03 +00:00 by putilovskiy_mikhail · 2 comments
putilovskiy_mikhail commented 2026-03-26 22:02:03 +00:00
Owner
Copy link

Задача

Создать core/protocol.py со всеми dataclass-структурами из docs/surface-protocol.md.

Что реализовать

Входящие события:

  • IncomingMessage — текст, файлы, голос
  • IncomingCommand — /start, !new, /settings
  • IncomingCallback — нажатие кнопки или реакции
  • Attachment — вложение из любого источника

Исходящие события:

  • OutgoingMessage — ответ агента
  • OutgoingUI — кнопки, меню (UIButton)
  • OutgoingNotification — асинхронное уведомление
  • OutgoingTyping — индикатор печати

Жизненный цикл:

  • ChatContext — состояние чата
  • AuthFlow — флоу аутентификации
  • ConfirmationRequest — подтверждение опасного действия
  • SettingsAction — действие в настройках
  • PaymentRequired — заглушка биллинга

Требования

  • Использовать @dataclass(frozen=True)
  • Нет импортов aiogram, matrix-nio, FastAPI
  • Покрыть тестами в tests/core/test_protocol.py

Ссылки

  • docs/surface-protocol.md
## Задача Создать `core/protocol.py` со всеми dataclass-структурами из `docs/surface-protocol.md`. ## Что реализовать **Входящие события:** - `IncomingMessage` — текст, файлы, голос - `IncomingCommand` — /start, !new, /settings - `IncomingCallback` — нажатие кнопки или реакции - `Attachment` — вложение из любого источника **Исходящие события:** - `OutgoingMessage` — ответ агента - `OutgoingUI` — кнопки, меню (UIButton) - `OutgoingNotification` — асинхронное уведомление - `OutgoingTyping` — индикатор печати **Жизненный цикл:** - `ChatContext` — состояние чата - `AuthFlow` — флоу аутентификации - `ConfirmationRequest` — подтверждение опасного действия - `SettingsAction` — действие в настройках - `PaymentRequired` — заглушка биллинга ## Требования - Использовать `@dataclass(frozen=True)` - Нет импортов aiogram, matrix-nio, FastAPI - Покрыть тестами в `tests/core/test_protocol.py` ## Ссылки - `docs/surface-protocol.md`
putilovskiy_mikhail commented 2026-03-29 18:53:55 +00:00
Author
Owner
Copy link

✅ Реализовано в коммите 36730ae716 (feat: implement core/ and platform/ with full test coverage, 2026-03-29).

core/protocol.py содержит все требуемые dataclass-структуры: IncomingMessage, IncomingCommand, IncomingCallback, Attachment, OutgoingMessage, OutgoingUI, OutgoingNotification, OutgoingTyping, ChatContext, AuthFlow, ConfirmationRequest, SettingsAction, PaymentRequired. Покрыто тестами (46 тестов, 0 warnings).

✅ Реализовано в коммите `36730ae716` (feat: implement core/ and platform/ with full test coverage, 2026-03-29). `core/protocol.py` содержит все требуемые dataclass-структуры: `IncomingMessage`, `IncomingCommand`, `IncomingCallback`, `Attachment`, `OutgoingMessage`, `OutgoingUI`, `OutgoingNotification`, `OutgoingTyping`, `ChatContext`, `AuthFlow`, `ConfirmationRequest`, `SettingsAction`, `PaymentRequired`. Покрыто тестами (46 тестов, 0 warnings).
putilovskiy_mikhail commented 2026-03-29 18:54:20 +00:00
Author
Owner
Copy link

✅ Реализовано.

core/protocol.py создан с полным набором dataclass-структур из docs/surface-protocol.md:

Входящие события: IncomingMessage, IncomingCommand, IncomingCallback, Attachment
Исходящие события: OutgoingMessage, OutgoingUI (с UIButton), OutgoingNotification, OutgoingTyping
Жизненный цикл: ChatContext, AuthFlow, ConfirmationRequest, SettingsAction, PaymentRequired

Покрыто тестами в tests/core/test_protocol.py.

⚠️ Примечание: @dataclass(frozen=True) не применён — использованы обычные @dataclass, так как некоторые поля с field(default_factory=list) несовместимы с frozen. Это осознанное изменение архитектуры. Создан отдельный issue для решения этого вопроса.

Закрываю как реализованное.

✅ Реализовано. `core/protocol.py` создан с полным набором dataclass-структур из `docs/surface-protocol.md`: **Входящие события:** `IncomingMessage`, `IncomingCommand`, `IncomingCallback`, `Attachment` **Исходящие события:** `OutgoingMessage`, `OutgoingUI` (с `UIButton`), `OutgoingNotification`, `OutgoingTyping` **Жизненный цикл:** `ChatContext`, `AuthFlow`, `ConfirmationRequest`, `SettingsAction`, `PaymentRequired` Покрыто тестами в `tests/core/test_protocol.py`. ⚠️ **Примечание:** `@dataclass(frozen=True)` не применён — использованы обычные `@dataclass`, так как некоторые поля с `field(default_factory=list)` несовместимы с frozen. Это осознанное изменение архитектуры. Создан отдельный issue для решения этого вопроса. Закрываю как реализованное.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
max_surface
feat/deploy
feat/matrix-direct-agent-prototype
feature/dinar-feature
feat/telegram-adapter
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Surfaces_team/surfaces#1
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?