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

README.md

@@ -22,8 +22,9 @@ Bot container                  Agent containers
   /agents/N/  ←── volume ──→  agent_N: /workspace/
 ```
 
-- Бот сохраняет входящий файл в `{workspace_path}/incoming/{stamp}-{file}` и передаёт агенту `attachments=["incoming/{stamp}-{file}"]`
-- Агент пишет исходящий файл в свой `/workspace/output/file`, бот читает его из `{workspace_path}/output/file`
+- Бот сохраняет входящий файл прямо в `{workspace_path}/{file}` и передаёт агенту `attachments=["{file}"]`
+- Если файл с таким именем уже есть, бот сохраняет следующий как `file (1).ext`, `file (2).ext`, как в Windows
+- Агент пишет исходящий файл прямо в свой `/workspace/file`, бот читает его из `{workspace_path}/file`
 - `workspace_path` для каждого агента задаётся в `config/matrix-agents.yaml`
 
 **3. Конфиг агентов**
@@ -128,7 +129,7 @@ agents:
 - `user_agents` — маппинг Matrix user_id → agent_id. Если пользователь не найден — используется первый агент.
 - `base_url` — HTTP URL агент-эндпоинта (path-based routing через reverse proxy).
 - `workspace_path` — путь к воркспейсу агента внутри бот-контейнера на shared volume.
-  Бот сохраняет входящие файлы в `{workspace_path}/incoming/`, агент пишет исходящие в свой `/workspace/`.
+  Бот сохраняет входящие файлы прямо в `{workspace_path}/`, агент пишет исходящие прямо в свой `/workspace/`.
 - Для 25-30 агентов продолжайте тот же паттерн: `/agent_17/` + `/agents/17`, `/agent_29/` + `/agents/29`.
 
 Полный пример с комментариями: `config/matrix-agents.example.yaml`
@@ -137,6 +138,15 @@ agents:
 
 `docker-compose.prod.yml` — bot-only handoff через published image. Платформа добавляет этот сервис в свой compose рядом с agent containers, монтирует shared volume и задаёт переменные окружения. Этот compose не создаёт и не собирает агент-контейнеры.
 
+Перед redeploy можно проверить реальные agent routes из той же сети, где будет работать бот:
+```bash
+PYTHONPATH=. uv run python -m tools.check_matrix_agents \
+  --config config/matrix-agents.yaml \
+  --timeout 5
+```
+
+Проверка открывает фактический WebSocket URL каждого агента (`.../v1/agent_ws/{chat_id}/`) и ждёт первый `STATUS`. Для проверки полного запроса к агенту добавьте `--message "ping"`.
+
 Для запуска опубликованного image:
 ```bash
 export SURFACES_BOT_IMAGE=mput1/surfaces-bot:latest
@@ -147,7 +157,7 @@ docker compose --env-file .env -f docker-compose.prod.yml up -d
 
 ```text
 mput1/surfaces-bot:latest
-sha256:26ba3a49290ab7c1cf0fa97f3de3fefdc70b59df7e6f1e0c2255728f8e2369be
+sha256:2f135f3535f7765d4377b440cdabe41195ad2efbc3e175def159ae4689ef90bd
 ```
 
 Для сборки и публикации surface image:
@@ -183,12 +193,13 @@ rm -f lambda_matrix.db && rm -rf matrix_store
 
 ```
 Bot (/agents)              Agent (/workspace = /agents/N/)
-  /agents/0/incoming/  ←──── одно и то же хранилище ────→  /workspace/incoming/
-  /agents/0/output/    ←────────────────────────────────→  /workspace/output/
+  /agents/0/report.pdf  ←──── одно и то же хранилище ────→  /workspace/report.pdf
+  /agents/0/result.txt  ←────────────────────────────────→  /workspace/result.txt
 ```
 
-- **Входящий файл** (пользователь → агент): бот сохраняет в `{workspace_path}/incoming/{stamp}-{file}`, например `/agents/17/incoming/report.pdf`, и передаёт агенту `attachments=["incoming/{stamp}-{file}"]`
-- **Исходящий файл** (агент → пользователь): агент пишет в `/workspace/output/file`, бот читает из `{workspace_path}/output/file`, например `/agents/17/output/file`, и отправляет пользователю как Matrix file message
+- **Входящий файл** (пользователь → агент): бот сохраняет в `{workspace_path}/{file}`, например `/agents/17/report.pdf`, и передаёт агенту `attachments=["report.pdf"]`
+- **Коллизии имён**: если `/agents/17/report.pdf` уже существует, бот сохранит следующий файл как `/agents/17/report (1).pdf`, затем `/agents/17/report (2).pdf`
+- **Исходящий файл** (агент → пользователь): агент пишет в `/workspace/file`, бот читает из `{workspace_path}/file`, например `/agents/17/result.txt`, и отправляет пользователю как Matrix file message
 - `workspace_path` для каждого агента задаётся в `config/matrix-agents.yaml`
 
 ---