.env.example

PORT=5556

# Optional: Telegram bot token from BotFather. If unset, only uniform API (POST /v1/plan, /v1/execute) and /health run.
TELEGRAM_BOT_TOKEN=

# Optional: "polling" (local dev, single agent) or "webhook" (deployed; required if backend also runs to avoid conflict)
# If APP_BASE_URL is set, webhook mode is used automatically.
TELEGRAM_MODE=polling

# Required for webhook mode: agent's public URL (e.g. ngrok). Agent will register this URL with Telegram.
TELEGRAM_WEBHOOK_PATH=/telegram/webhook
TELEGRAM_WEBHOOK_SECRET=
APP_BASE_URL=

# llm-service connection
LLM_SERVICE_BASE_URL=http://localhost:3002
LLM_SERVICE_HMAC_SECRET=
# Optional: request timeout in ms for planner/llm-service calls (default 120000)
# LLM_REQUEST_TIMEOUT_MS=120000

# Backend: context enrichment and Telegram ingest/verify (agent forwards updates to backend)
# BACKEND_SERVICE_KEY must match backend's AGENT_SERVICE_KEY.
BACKEND_BASE_URL=
BACKEND_SERVICE_KEY=
BACKEND_CONTEXT_PATH=/api/v1/agent/context
# Optional: request timeout in ms for backend API calls (default 30000)
# BACKEND_REQUEST_TIMEOUT_MS=30000
# Frontend app base URL used for signing links sent in Telegram
FRONTEND_BASE_URL=https://flowforge.app

# Optional system prompt prepended before user messages
# LLM_SYSTEM_PROMPT=You are a helpful assistant.
 
# Redis & Rate Limiting
REDIS_URL=redis://localhost:6379
# Max x number of message in y ms
TELEGRAM_RATE_LIMIT_MAX=5 
TELEGRAM_RATE_LIMIT_WINDOW_MS=10000