diff --git a/.env.example b/.env.example index f40f148..a7f14d2 100644 --- a/.env.example +++ b/.env.example @@ -4,6 +4,8 @@ COMPOSE_PROJECT_NAME=portable-agent POSTGRES_ADMIN_USER=platform_admin POSTGRES_ADMIN_PASSWORD=local_admin_change_me POSTGRES_PORT=5432 +# Для пулов Temporal и приложений нужно больше соединений, чем стандартные 100 PostgreSQL. +POSTGRES_MAX_CONNECTIONS=200 ACTION_DB_USER=actions ACTION_DB_PASSWORD=local_actions_change_me diff --git a/README.md b/README.md index 292f677..8ad25e3 100644 --- a/README.md +++ b/README.md @@ -93,6 +93,10 @@ task test:connection сохраняет локальные данные. `task reset` удаляет только volumes текущего Compose project и всегда требует явного подтверждения. +`POSTGRES_MAX_CONNECTIONS=200` — безопасный дефолт для локального полного стенда: Temporal и +остальные сервисы могут одновременно держать пулы соединений. Его не следует переносить в +production без расчёта лимитов PostgreSQL и пулов каждого сервиса. + `deploy` поднимает окружение, затем `run-test-lab.ps1` передаёт локальную тестовую конфигурацию в соседний репозиторий `portable-agent-test-lab`. Сам black-box сценарий принадлежит `test-lab`: он отправляет demo-команду в Channel Gateway, подтверждает действие, ждёт Temporal workflow и проверяет, @@ -113,6 +117,12 @@ Compose project и всегда удаляет только созданные ### Настоящий Telegram локально +Профиль настоящего Telegram переопределяет список коннекторов в Channel Gateway и Conversation +Service на `google-calendar`. +Поэтому действие из реального бота не может случайно попасть в `fake-calendar`: до подтверждения +пользователь увидит карточку подключения Google, если OAuth-соединения ещё нет. Базовый Compose +профиль остаётся на `fake-calendar`, чтобы CI и локальные e2e-тесты были воспроизводимыми. + Создай тестового бота через BotFather и добавь только в локальный `.env`: ```dotenv diff --git a/compose/compose.yaml b/compose/compose.yaml index 9ff96a9..49bd87c 100644 --- a/compose/compose.yaml +++ b/compose/compose.yaml @@ -4,6 +4,7 @@ services: postgres: profiles: [core] image: ${POSTGRES_IMAGE:?set POSTGRES_IMAGE} + command: [postgres, -c, "max_connections=${POSTGRES_MAX_CONNECTIONS:-200}"] environment: POSTGRES_USER: ${POSTGRES_ADMIN_USER:?set POSTGRES_ADMIN_USER} POSTGRES_PASSWORD: ${POSTGRES_ADMIN_PASSWORD:?set POSTGRES_ADMIN_PASSWORD} diff --git a/compose/telegram.real.yaml b/compose/telegram.real.yaml index cbdd3de..a7892ce 100644 --- a/compose/telegram.real.yaml +++ b/compose/telegram.real.yaml @@ -1,4 +1,12 @@ services: + channel-gateway: + environment: + AGENT_AVAILABLE_CONNECTORS: '["google-calendar"]' + + conversation-service: + environment: + AVAILABLE_CONNECTORS: google-calendar + telegram-adapter: environment: TELEGRAM_API_URL: https://api.telegram.org diff --git a/docs/checkpoint-2026-10-26.md b/docs/checkpoint-2026-10-26.md new file mode 100644 index 0000000..0058ebd --- /dev/null +++ b/docs/checkpoint-2026-10-26.md @@ -0,0 +1,53 @@ +# Точка продолжения: Google Calendar через Telegram + +Дата проверки: 26 октября 2026 года, часовой пояс `Europe/Moscow`. + +## Проверенный результат + +1. В отдельном Google Cloud проекте Portable Agent включён Calendar API. OAuth-приложение + `Portable Agent Local` работает в режиме Testing с одним тестовым пользователем. +2. Web OAuth client использует redirect URI + `http://localhost:18088/api/v1/connections/callback`. Client ID и Client Secret находятся + только в игнорируемом `portable-agent-deploy/.env`. В Git и в этом документе секретов нет. +3. Локальный `connection-service` получил Google OAuth-доступ. `channel-gateway` и + `conversation-service` в режиме настоящего Telegram предлагают `google-calendar`. +4. Через настоящий Telegram были отправлены команда и подтверждение встречи + «Portable Agent E2E Google» на 27 октября 2026 года, 17:00–17:30 МСК. + В `action-service` действие стало `SUCCEEDED`. Отдельный GET к Google Calendar API подтвердил + событие со статусом `confirmed`. Диагностические встречи удалены. + +Временный Cloudflare Quick Tunnel отвечал локально, но Telegram отверг его новый hostname с +`Failed to resolve host`. Для проверки входящие обновления получали официальным Telegram +`getUpdates` после `deleteWebhook` и передавали в локальный +`http://localhost:18086/webhooks/telegram` с тем же секретным заголовком. Сейчас webhook удалён: +бот не обрабатывает новые сообщения автоматически, пока не заработает туннель или локальный +polling mode. Это ограничение тестового транспорта; реальный Google API и остальная цепочка +проверены. + +## Pull requests + +| Репозиторий | PR | Суть | +| --- | --- | --- | +| `calendar-mcp` | [#23](https://github.com/portable-agent/calendar-mcp/pull/23) | RFC3339-время с секундами для Google API и регрессионный тест | +| `agent-runtime` | [#22](https://github.com/portable-agent/agent-runtime/pull/22) | Понятные уточнения вместо ложного `AGENT_UNAVAILABLE` | +| `conversation-service` | [#13](https://github.com/portable-agent/conversation-service/pull/13) | Новый разговор после закрытой сессии | +| `telegram-adapter` | [#5](https://github.com/portable-agent/telegram-adapter/pull/5) | `/start` без привязки и обновление уязвимой зависимости | +| `deploy` | [#25](https://github.com/portable-agent/deploy/pull/25) | Реальный маршрут Google, команды переключения и лимит соединений PostgreSQL | + +Смотри актуальные GitHub checks в PR: их состояние меняется после каждого push. Локальные проверки +Java, Python, Node и Compose проходили перед публикацией. Pull requests оставлены открытыми +для ревью. + +## Что делать дальше + +1. Довести CI всех пяти PR до зелёного состояния и выполнить ревью. +2. После мержа обновить локальные `main` и версии образов в `deploy/config/versions.env`, + если менялись публикуемые образы. +3. Сделать официальный локальный polling mode Telegram Adapter или стабильный туннель, + чтобы реальная проверка не требовала ручной передачи обновлений. +4. После выполнения Action отправлять в чат итог «встреча создана» либо понятную ошибку: + сейчас `answerCallbackQuery` показывает только краткий ответ на нажатие кнопки. +5. Повторить end-to-end проверку из чистого локального запуска и занести её в test-lab. + +Не добавляй OAuth credentials, access/refresh tokens, Telegram bot token или полные HTTP-ответы +Google в Git и логи. diff --git a/mkdocs.yml b/mkdocs.yml index d69e495..1977b18 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -10,6 +10,7 @@ nav: - Разработка: development.md - Новый сервис: new-service.md - Эксплуатация: runbook.md + - Проверка Google Calendar 2026-10-26: checkpoint-2026-10-26.md - Решения: - Отдельный deploy-репозиторий: decisions/0001-deploy-repository.md - Платформа разработки: decisions/0002-developer-platform.md diff --git a/scripts/check-compose.ps1 b/scripts/check-compose.ps1 index c55c959..c48b901 100644 --- a/scripts/check-compose.ps1 +++ b/scripts/check-compose.ps1 @@ -331,6 +331,10 @@ foreach ($required in @("TELEGRAM_REAL_BOT_TOKEN", "TELEGRAM_REAL_WEBHOOK_SECRET throw "Real Telegram override не содержит $required." } } +if ($realTelegram -notmatch '(?ms)^ channel-gateway:\s+environment:\s+AGENT_AVAILABLE_CONNECTORS: ''\["google-calendar"\]''' ` + -or $realTelegram -notmatch '(?ms)^ conversation-service:\s+environment:\s+AVAILABLE_CONNECTORS: google-calendar') { + throw "Реальный Telegram должен направлять предложения и проверку подключения в Google Calendar." +} $realTelegramScript = Get-Content -Raw -LiteralPath "scripts/start-telegram-real.ps1" $envExample = Get-Content -Raw -LiteralPath ".env.example" foreach ($required in @("getMe", "setWebhook", "getWebhookInfo", "trycloudflare", "allowed_updates", "callback_query")) { @@ -354,14 +358,17 @@ if ($realTelegramScript -notmatch '\[switch\]\$Model' ` -or $realTelegramScript -notmatch 'compose/model.local.yaml') { throw "Настоящий Telegram должен поддерживать тот же локальный AI-профиль." } -if ($realTelegramScript -match 'up -d --build --wait --force-recreate telegram-adapter cloudflared' ` - -or $realTelegramScript -notmatch 'up -d --no-deps --no-build --wait --force-recreate telegram-adapter cloudflared') { - throw "Повторный запуск Telegram не должен пересобирать уже поднятые приложения." +if ($realTelegramScript -match 'up -d --build --wait --force-recreate' ` + -or $realTelegramScript -notmatch 'up -d --no-deps --no-build --wait --force-recreate channel-gateway conversation-service telegram-adapter cloudflared') { + throw "Запуск реального Telegram должен переключать маршрут Google без пересборки приложений." } $stopTelegramScript = Get-Content -Raw -LiteralPath "scripts/stop-telegram-real.ps1" if ($stopTelegramScript -notmatch 'deleteWebhook') { throw "Остановка настоящего Telegram должна удалить временный webhook." } +if ($stopTelegramScript -notmatch '(?s)up -d --no-deps --no-build --wait --force-recreate\s+`\s+channel-gateway conversation-service') { + throw "Остановка настоящего Telegram должна вернуть тестовый маршрут календаря." +} $taskfile = Get-Content -Raw -LiteralPath "Taskfile.yml" foreach ($taskName in @("services:model:up", "telegram:real:up", "telegram:real:model:up", "telegram:real:down")) { if ($taskfile -notmatch "(?m)^ $([regex]::Escape($taskName)):") { diff --git a/scripts/start-telegram-real.ps1 b/scripts/start-telegram-real.ps1 index a184840..6ac21b3 100644 --- a/scripts/start-telegram-real.ps1 +++ b/scripts/start-telegram-real.ps1 @@ -39,7 +39,7 @@ $composeFiles += @("-f", "compose/apps.local.yaml", "-f", "compose/telegram.real if ($Model) { $composeFiles += @("-f", "compose/model.local.yaml") } & docker compose @envFiles @composeFiles --profile core --profile apps --profile telegram-real ` - up -d --no-deps --no-build --wait --force-recreate telegram-adapter cloudflared + up -d --no-deps --no-build --wait --force-recreate channel-gateway conversation-service telegram-adapter cloudflared if ($LASTEXITCODE -ne 0) { throw "Real Telegram mode did not start." } $tunnelUrl = $null diff --git a/scripts/stop-telegram-real.ps1 b/scripts/stop-telegram-real.ps1 index da55ca6..4012101 100644 --- a/scripts/stop-telegram-real.ps1 +++ b/scripts/stop-telegram-real.ps1 @@ -25,4 +25,7 @@ if ($LASTEXITCODE -ne 0) { throw "Failed to stop the temporary Telegram webhook. & "$PSScriptRoot/service-local.ps1" -Action Restart -Service telegram-adapter if ($LASTEXITCODE -ne 0) { throw "Failed to return Telegram Adapter to the fake API." } +& docker compose @envFiles @composeFiles --profile apps up -d --no-deps --no-build --wait --force-recreate ` + channel-gateway conversation-service +if ($LASTEXITCODE -ne 0) { throw "Failed to return the calendar route to the fake API." } Write-Host "The temporary webhook was removed. Telegram Adapter uses the fake API again."