AI Creator Studio Telegram

# Architecture

AI Creator Studio Telegram uses Telegram as the user interface and Hermes Agent as the autonomous orchestrator.

## Runtime Services

- `bot`: Telegram command and callback handling.
- `api`: internal API for estimation, usage, projects, providers, and healthcheck.
- `worker`: BullMQ worker for image/video generation jobs.
- `admin-web`: internal Next.js dashboard.
- `postgres`: persistent project, job, media, usage, and audit data.
- `redis`: queue, session, and rate-limit state.
- `minio` or external S3: media object storage.

## Agent Flow

```text
User -> Telegram Bot -> Hermes Agent -> Prompt Analysis -> Prompt Enhancement
-> Workflow Planning -> Provider Selection -> Queue -> Worker -> Provider
-> Validation -> Storage -> Telegram Result Card
```

Hermes is not a passive executor. It owns requirement analysis, workflow planning, provider selection, validation, retry decisions, and project history.

## Provider Adapter Contract

Provider integrations must implement:

- `estimate`
- `generate`
- `getBalance`
- `getRateLimit`

The mock provider is included so the project can be tested without paid provider keys.