feat(deploy): finalize MVP deployment and file transfer approach

docs/deploy-architecture.md

@@ -68,7 +68,7 @@ agents:
 - `user_agents` — маппинг Matrix user_id → agent_id. Если пользователь не найден — используется первый агент из списка.
 - `agents[].base_url` — HTTP URL агент-эндпоинта. Бот подключается через AgentApi.
 - `agents[].workspace_path` — абсолютный путь к воркспейсу агента **внутри контейнера бота** (т.е. на shared volume).
-  Бот сохраняет входящие файлы в `{workspace_path}/incoming/`, читает исходящие из `{workspace_path}/`.
+  Бот сохраняет входящие файлы прямо в `{workspace_path}/`, читает исходящие из `{workspace_path}/`.
 - Для 25-30 агентов продолжайте тот же паттерн до нужного номера: `/agent_17/` + `/agents/17`, `/agent_29/` + `/agents/29`.
 
 ## Surface Image Build Contract
@@ -89,7 +89,7 @@ Published image:
 
 ```text
 mput1/surfaces-bot:latest
-sha256:26ba3a49290ab7c1cf0fa97f3de3fefdc70b59df7e6f1e0c2255728f8e2369be
+sha256:2f135f3535f7765d4377b440cdabe41195ad2efbc3e175def159ae4689ef90bd
 ```
 
 `SURFACES_BOT_IMAGE` должен указывать на registry namespace, куда текущий Docker account может пушить. Ошибка `insufficient_scope` означает, что пользователь не залогинен в этот namespace, repository не создан, или у аккаунта нет push-доступа.
@@ -153,14 +153,15 @@ AgentApi(
 ### Пользователь → Агент (входящий файл)
 
 1. Matrix-бот получает файл от пользователя
-2. Сохраняет в workspace агента: `/agents/{N}/incoming/{filename}`
-3. Вызывает `agent.send_message(text, attachments=["incoming/filename"])`
+2. Сохраняет в workspace агента: `/agents/{N}/{filename}`
+3. Если файл уже существует, выбирает следующее имя: `filename (1).ext`, `filename (2).ext`
+4. Вызывает `agent.send_message(text, attachments=["filename"])`
    — путь относительно `/workspace` агента
 
 ### Агент → Пользователь (исходящий файл)
 
-1. Агент эмитит `MsgEventSendFile(path="output/report.pdf")`
-2. Matrix-бот читает файл: `/agents/{N}/output/report.pdf`
+1. Агент эмитит `MsgEventSendFile(path="report.pdf")`
+2. Matrix-бот читает файл: `/agents/{N}/report.pdf`
 3. Отправляет как Matrix file message пользователю
 
 **Ключевое:** production handoff через `docker-compose.prod.yml` и internal E2E через `docker-compose.fullstack.yml` используют один и тот же `/agents` contract на стороне поверхности. Прямой HTTP-доступ к файлам не нужен.