refactor(reverse-proxy): rebase on main + address review feedback

* move TELEGRAM_API_ROOT / TELEGRAM_PROXY_SECRET in .env.example to sit
  next to TELEGRAM_PROXY_URL (per @grinev review)
* document both env vars in README.md (table + new "Reverse Proxy"
  subsection with nginx example) (per @grinev review)
* drop package.json `overrides.remark` block — telegram-markdown-v2 is
  gone from main, ERR_REQUIRE_ESM no longer reachable, override is dead
* rebase config.ts / index.ts / file-download.ts / voice.ts on current
  main; reverse-proxy logic itself unchanged

Author: avfirsov

.env.example

@@ -12,9 +12,26 @@ TELEGRAM_ALLOWED_USER_ID=
 #   TELEGRAM_PROXY_URL=http://proxy.example.com:8080
 # TELEGRAM_PROXY_URL=
 
+# Telegram Reverse-Proxy mode (optional, alternative to TELEGRAM_PROXY_URL)
+# For corporate networks that block api.telegram.org but allow your own server.
+# Point TELEGRAM_API_ROOT at an HTTPS endpoint that reverse-proxies to
+# https://api.telegram.org (e.g. nginx). Applied to Bot API calls AND file
+# downloads. TELEGRAM_PROXY_SECRET (optional) is sent as the X-Proxy-Secret
+# header so the reverse proxy can authorize callers. See README for an example
+# nginx config.
+# TELEGRAM_API_ROOT=https://tg-proxy.yourdomain.com
+# TELEGRAM_PROXY_SECRET=some-long-random-string
+
 # OpenCode API URL (optional, default: http://localhost:4096)
 # OPENCODE_API_URL=http://localhost:4096
 
+# Automatically restart a local OpenCode server when health-checks fail (default: false)
+# Only works when OPENCODE_API_URL points to localhost / 127.0.0.1 / ::1 / 0.0.0.0.
+# OPENCODE_AUTO_RESTART_ENABLED=false
+
+# OpenCode health monitor interval in seconds when auto-restart is enabled (default: 300)
+# OPENCODE_MONITOR_INTERVAL_SEC=300
+
 # OpenCode Server Authentication (optional)
 # OPENCODE_SERVER_USERNAME=opencode
 # OPENCODE_SERVER_PASSWORD=
@@ -76,6 +93,11 @@ OPENCODE_MODEL_ID=big-pickle
 # Hide tool file edit documents sent as .txt attachments (default: false)
 # HIDE_TOOL_FILE_MESSAGES=false
 
+# Track background sessions in the currently selected project/worktree (default: true)
+# Sends short notifications when detached or non-current sessions in the current directory reply,
+# ask questions, or request permissions. Other projects/worktrees are not tracked.
+# TRACK_BACKGROUND_SESSIONS=true
+
 # Assistant message formatting mode (default: markdown)
 # markdown = convert assistant replies to Telegram MarkdownV2
 # raw = show assistant replies as plain text
@@ -105,15 +127,22 @@ OPENCODE_MODEL_ID=big-pickle
 
 # Text-to-Speech credentials (optional)
 # TTS reply behavior is controlled globally with /tts and persisted in settings.json.
-# Set both TTS_API_URL and TTS_API_KEY to enable audio replies.
+# Provider: "openai" (default) or "google".
+#
+# --- OpenAI-compatible (default) ---
+# Set TTS_API_URL and TTS_API_KEY to any OpenAI-compatible TTS endpoint.
 # TTS_API_URL=
 # TTS_API_KEY=
 # TTS_MODEL=gpt-4o-mini-tts
 # TTS_VOICE=alloy
-
-# Reverse-proxy mode (alternative to TELEGRAM_PROXY_URL for corp networks that
-# block api.telegram.org but allow your own server). Point these at an nginx
-# that reverse-proxies to https://api.telegram.org and requires a shared secret
-# header. See docs for an example config.
-#   TELEGRAM_API_ROOT=https://tg-proxy.yourdomain.com
-#   TELEGRAM_PROXY_SECRET=some-long-random-string
+#
+# --- Google Cloud TTS ---
+# 1. Create a project at https://console.cloud.google.com
+# 2. Enable "Cloud Text-to-Speech API"
+# 3. Create a Service Account (IAM & Admin > Service Accounts)
+#    with role "Cloud Text-to-Speech API User"
+# 4. Download the JSON key file
+# Free tier: 1M characters/month (WaveNet/Neural2), 4M/month (Standard voices)
+# TTS_PROVIDER=google
+# TTS_VOICE=en-US-Studio-O
+# GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grinev/opencode-telegram-bot",
-  "version": "0.17.0",
+  "version": "0.20.1",
   "description": "Telegram bot client for OpenCode to run and monitor coding tasks from chat.",
   "type": "module",
   "main": "./dist/index.js",
@@ -51,6 +51,7 @@
   },
   "homepage": "https://github.com/grinev/opencode-telegram-bot#readme",
   "dependencies": {
+    "@google-cloud/text-to-speech": "^6.4.0",
     "@grammyjs/menu": "^1.3.1",
     "@opencode-ai/sdk": "^1.1.21",
     "better-sqlite3": "^12.6.2",
@@ -61,7 +62,6 @@
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",
     "socks-proxy-agent": "^8.0.5",
-    "telegram-markdown-v2": "^0.0.4",
     "unified": "^11.0.5"
   },
   "devDependencies": {
@@ -76,8 +76,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"
-  },
-  "overrides": {
-    "remark": "14.0.3"
   }
 }