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

[docs] Update api-contract.md for current architecture and unresolved SDK questions #11

New issue
Open
opened 2026-03-26 22:04:07 +00:00 by putilovskiy_mikhail · 0 comments
putilovskiy_mikhail commented 2026-03-26 22:04:07 +00:00
Owner
Copy link

Задача

Актуализировать docs/api-contract.md под текущую архитектуру и явно отделить уже принятые решения от незакрытых SDK-вопросов.

Текущий контекст

  • Мы больше не ждём платформу как blocker и фиксируем решения со своей стороны.
  • Локальная реализация сейчас живёт через sdk/interface.py и sdk/mock.py.
  • docs/api-contract.md уже частично описывает нашу сторону контракта, но в нём остаются открытые вопросы.

Что нужно сделать

  • Явно зафиксировать уже принятые решения.
  • Переписать остаточные вопросы в форме что именно ещё не закреплено, без фраз типа уточнить у платформы как единственного следующего шага.
  • Проверить согласованность с sdk/interface.py, sdk/mock.py, docs/surface-protocol.md.

Примечание

Актуальные пути: sdk/interface.py, sdk/mock.py. Старый platform/ больше не является рабочим путём проекта.

## Задача Актуализировать `docs/api-contract.md` под текущую архитектуру и явно отделить уже принятые решения от незакрытых SDK-вопросов. ## Текущий контекст - Мы больше не ждём платформу как blocker и фиксируем решения со своей стороны. - Локальная реализация сейчас живёт через `sdk/interface.py` и `sdk/mock.py`. - `docs/api-contract.md` уже частично описывает нашу сторону контракта, но в нём остаются открытые вопросы. ## Что нужно сделать - Явно зафиксировать уже принятые решения. - Переписать остаточные вопросы в форме `что именно ещё не закреплено`, без фраз типа `уточнить у платформы` как единственного следующего шага. - Проверить согласованность с `sdk/interface.py`, `sdk/mock.py`, `docs/surface-protocol.md`. ## Примечание Актуальные пути: `sdk/interface.py`, `sdk/mock.py`. Старый `platform/` больше не является рабочим путём проекта.
putilovskiy_mikhail changed title from [docs] Уточнить api-contract.md — стриминг, файлы, лимиты to [docs] Update api-contract.md for current architecture and unresolved SDK questions 2026-03-31 23:00:09 +00:00
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#11
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?