> ## Documentation index
> Fetch the complete documentation index at: https://tgcloud.docs7.io/llms.txt
> Ask it with GET https://tgcloud.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.

# Ресурсы

> Встроенная справка платформы tgcloud://docs/*

# Ресурсы

Сервер отдаёт справку платформы как MCP-ресурсы. Агент читает их без вызова
инструмента. Текст английский — тот же язык, что у core.telegram.org/bots/serverless,
чтобы справочник можно было сверять со страницей платформы.

| URI | Содержание |
|---|---|
| `tgcloud://docs/project-structure` | Каталог `tgcloud/`, handlers, endpoints, lib, schema.js. Импорты проекта — относительный путь **с** `.js`. Хостинг статики Mini App |
| `tgcloud://docs/cli` | Справочник CLI: команды, `--dry-run` / `--safe` / `--yes` / `--local`, upgrade, webhook |
| `tgcloud://docs/sdk-db` | `sdk/db`: типы колонок (`text`, `integer`, `real`, `numeric`, `blob`, `boolean`, `json`) и mode, query builder, raw SQL, без foreign keys, дропы через `.deprecated` |
| `tgcloud://docs/sdk-api` | `sdk/api`: весь Bot API, `BotApiError`, `InputFile` |
| `tgcloud://docs/sdk-fetch` | `sdk/fetch`: HTTP-клиент, body-хелперы, лимит 32 МБ |
| `tgcloud://docs/limits` | Задокументированные лимиты и квоты, которые не опубликованы |

Внутри скаффолда сначала читайте `AGENTS.md` и `docs/tgcloud-sdk.md`.
Они совпадают с CLI, который создал проект. Ресурсы — запасной справочник,
когда проекта под рукой нет.

Держатель истины в репозитории: `resources/docs/*.md`. `npm run docs:check`
проверяет, что каждый файл зарегистрирован, что две копии скилла совпадают
и что у каждой английской страницы есть соседи ru, zh, ar, de и fr.

## Лимиты платформы

`tgcloud://docs/limits` собирает опубликованные лимиты: 50 МБ на загрузку в
Bot API (10 МБ для фото), 20 МБ на скачивание через `getFile` и 32 МБ на тело
ответа `fetch`. Вывод `console` показывает `tgcloud run`, публичного предела
размера нет.

Квоты времени выполнения — память, CPU, таймаут handler и endpoint, частота
вызовов, размер базы — **не опубликованы**. Не выдумывайте числа. `run_handler`
печатает время выполнения запуска: измеряйте свой путь, держите handler
коротким и выносите тяжёлую работу из пути обновления через `fetch`. За
значениями обращайтесь в @BotFather → бот → Serverless или в официальные каналы
платформы.

Тот же ресурс перечисляет возможности, которых в среде выполнения **нет**:
транзакции и атомарные пакеты в базе, собственные входящие HTTP-эндпоинты
(вебхуком владеет платформа), хранилище секретов и переменные окружения, а
также задания по расписанию — с поддерживаемой заменой для каждой.