Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
10 changes: 10 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 и проверяет,
Expand All @@ -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
Expand Down
1 change: 1 addition & 0 deletions compose/compose.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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}
Expand Down
8 changes: 8 additions & 0 deletions compose/telegram.real.yaml
Original file line number Diff line number Diff line change
@@ -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
Expand Down
53 changes: 53 additions & 0 deletions docs/checkpoint-2026-10-26.md
Original file line number Diff line number Diff line change
@@ -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 и логи.
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
13 changes: 10 additions & 3 deletions scripts/check-compose.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -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")) {
Expand All @@ -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)):") {
Expand Down
2 changes: 1 addition & 1 deletion scripts/start-telegram-real.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 3 additions & 0 deletions scripts/stop-telegram-real.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -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."
Loading