ai-terminal-remote-bot 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# ai-terminal-remote-bot
+
+Secure remote terminal bot with Claude Code integration. Control your server and use Claude Code interactively from Telegram.
+
+## Features
+
+- **Remote Terminal**: Execute commands, navigate filesystem, view files
+- **Claude Code Integration**: Interactive AI sessions with real-time tool usage visibility
+- **Media Support**: Send documents, photos, and audio with automatic handling
+- **Audio Transcription**: Voice messages and audio files are transcribed using Whisper (JS/ONNX, offline, no API keys). First transcription downloads ~40MB model.
+- **Security Hardened**: Command validation, path restrictions, rate limiting, no shell injection
+- **Clean Architecture**: Strategy Pattern, DI, per-user sessions, SOLID principles
+
+## Install
+
+```bash
+npm install -g ai-terminal-remote-bot
+```
+
+Or clone and link:
+
+```bash
+git clone <repo>
+cd ai-terminal-remote-bot
+npm install
+npm link
+```
+
+## Setup
+
+```bash
+ai-terminal-remote-bot          # First run triggers setup wizard
+ai-terminal-remote-bot --config # Re-run setup anytime
+```
+
+You'll need:
+1. A Telegram bot token from [@BotFather](https://t.me/BotFather)
+2. Your Telegram user ID from [@userinfobot](https://t.me/userinfobot)
+
+Config is stored in `~/.ai-terminal-remote-bot/config.json` with `0600` permissions.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/run <cmd>` | Execute a shell command |
+| `/cd <dir>` | Change directory |
+| `/ls [args]` | List files |
+| `/cat <file>` | View file contents |
+| `/status` | System status (RAM, disk, uptime) |
+| `/procs` | Top processes by CPU |
+| `/kill <PID>` | Kill a process |
+| `/claude [prompt]` | Enter Claude mode / send prompt |
+| `/ask <question>` | One-shot Claude query |
+| `/new` | New Claude conversation |
+| `/exit` | Return to terminal mode |
+
+In **terminal mode**, plain text is executed as bash commands.
+In **Claude mode**, plain text is sent to Claude Code.
+
+## Security
+
+- Dangerous commands (rm -rf, shutdown, etc.) require confirmation
+- Irrecoverable commands (fork bombs, mkfs, dd) are blocked entirely
+- `/ls`, `/cat`, `/kill` use `execFile()` with args array (no shell)
+- Claude prompts use `spawn('claude', ['-p', prompt])` via argv (no shell interpolation)
+- Path validation against configurable allowed paths
+- Rate limiting: 30 requests/minute sliding window
+- Config file permissions enforced at `0600`
+
+## Architecture
+
+```
+cli.js → config.mjs → setup.mjs OR server.mjs
+                                      ├── platforms/telegram.mjs  (Strategy Pattern)
+                                      ├── modules/terminal.mjs    (execFile/spawn)
+                                      ├── modules/claude.mjs      (spawn with argv)
+                                      ├── modules/media.mjs       (safe file handling)
+                                      ├── security.mjs            (validation layer)
+                                      └── utils.mjs               (pure functions)
+```
+
+## License
+
+MIT

package/cli.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env -S node --disable-warning=DEP0040
+
+/**
+ * CLI entry point - parses flags, delegates to setup or server.
+ * Default behavior: launch bot as background daemon.
+ */
+
+import { readFileSync, writeFileSync, unlinkSync, existsSync, openSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { spawn } from 'child_process';
+import { loadConfig, configExists, CONFIG_DIR } from './src/config.mjs';
+import { runSetup } from './src/setup.mjs';
+import { startServer } from './src/server.mjs';
+import { initI18n, t } from './src/i18n/index.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8'));
+
+const PID_FILE = join(CONFIG_DIR, 'bot.pid');
+const LOG_FILE = join(CONFIG_DIR, 'bot.log');
+
+const args = process.argv.slice(2);
+
+// --- Helpers ---
+
+function readPid() {
+  try {
+    return parseInt(readFileSync(PID_FILE, 'utf8').trim(), 10);
+  } catch {
+    return null;
+  }
+}
+
+function isRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function stopBot() {
+  const pid = readPid();
+  if (!pid || !isRunning(pid)) {
+    console.log(t('cli.botNotRunning'));
+    return false;
+  }
+  try {
+    process.kill(pid, 'SIGTERM');
+    try { unlinkSync(PID_FILE); } catch {}
+    console.log(t('cli.botStopped'));
+    return true;
+  } catch (err) {
+    console.error(t('cli.botStopFailed', { pid, error: err.message }));
+    return false;
+  }
+}
+
+function startDaemon() {
+  const pid = readPid();
+  if (pid && isRunning(pid)) {
+    console.log(t('cli.botAlreadyRunning', { pid }));
+    return;
+  }
+  // Clean stale PID file
+  if (pid) {
+    try { unlinkSync(PID_FILE); } catch {}
+  }
+
+  const logFd = openSync(LOG_FILE, 'a');
+  const child = spawn(process.execPath, ['--disable-warning=DEP0040', fileURLToPath(import.meta.url), '--daemon'], {
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    cwd: __dirname,
+  });
+
+  writeFileSync(PID_FILE, String(child.pid));
+  child.unref();
+
+  console.log(t('cli.botStarted', { pid: child.pid, log: LOG_FILE }));
+}
+
+// --- Flag handling ---
+
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(`ai-terminal-remote-bot v${pkg.version}`);
+  process.exit(0);
+}
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+ai-terminal-remote-bot v${pkg.version}
+
+Usage:
+  ai-terminal-remote-bot            Start bot as background daemon
+  ai-terminal-remote-bot --config   Run setup wizard
+  ai-terminal-remote-bot --stop     Stop the running bot
+  ai-terminal-remote-bot --restart  Restart the bot
+  ai-terminal-remote-bot --status   Check if bot is running
+  ai-terminal-remote-bot --fg       Run in foreground (for debugging)
+  ai-terminal-remote-bot --version  Show version
+  ai-terminal-remote-bot --help     Show this help
+`);
+  process.exit(0);
+}
+
+if (args.includes('--config')) {
+  await runSetup();
+  process.exit(0);
+}
+
+// Everything below needs config
+if (!configExists()) {
+  console.log(t('cli.noConfig'));
+  await runSetup();
+  process.exit(0);
+}
+
+const config = loadConfig();
+initI18n(config.language);
+
+// --stop
+if (args.includes('--stop')) {
+  stopBot();
+  process.exit(0);
+}
+
+// --restart
+if (args.includes('--restart')) {
+  stopBot();
+  startDaemon();
+  process.exit(0);
+}
+
+// --status
+if (args.includes('--status')) {
+  const pid = readPid();
+  if (pid && isRunning(pid)) {
+    console.log(t('cli.botRunning', { pid }));
+  } else {
+    if (pid) { try { unlinkSync(PID_FILE); } catch {} }
+    console.log(t('cli.botNotRunning'));
+  }
+  process.exit(0);
+}
+
+// --daemon (hidden internal flag — the actual server process)
+if (args.includes('--daemon')) {
+  console.log(`ai-terminal-remote-bot v${pkg.version}`);
+  console.log(t('cli.startInfo', { platform: config.platform, userId: config.allowedUserId }));
+  await startServer(config);
+  // should not reach here unless server exits
+  process.exit(0);
+}
+
+// --fg (foreground mode for debugging)
+if (args.includes('--fg')) {
+  console.log(`ai-terminal-remote-bot v${pkg.version}`);
+  console.log(t('cli.startInfo', { platform: config.platform, userId: config.allowedUserId }));
+  await startServer(config);
+  process.exit(0);
+}
+
+// Default: start as background daemon
+console.log(`ai-terminal-remote-bot v${pkg.version}`);
+startDaemon();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "ai-terminal-remote-bot",
+  "version": "1.0.0",
+  "description": "Secure remote terminal bot with Claude Code integration",
+  "type": "module",
+  "bin": {
+    "ai-terminal-remote-bot": "./cli.js"
+  },
+  "main": "cli.js",
+  "scripts": {
+    "start": "node --disable-warning=DEP0040 cli.js",
+    "dev": "node --disable-warning=DEP0040 --watch cli.js"
+  },
+  "keywords": [
+    "telegram",
+    "bot",
+    "terminal",
+    "claude",
+    "remote"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.4.1",
+    "telegraf": "^4.16.3",
+    "wavefile": "^11.0.0"
+  }
+}

package/src/config.mjs

@@ -0,0 +1,65 @@
+/**
+ * Config management - reads/writes ~/.ai-terminal-remote-bot/config.json with 0600 perms.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.ai-terminal-remote-bot');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const CONFIG_PERMS = 0o600;
+const DIR_PERMS = 0o700;
+
+const DEFAULTS = {
+  language: 'en',
+  platform: 'telegram',
+  botToken: '',
+  allowedUserId: 0,
+  allowedPaths: [],
+  mediaDir: '',
+  maxOutputLength: 4000,
+  commandTimeout: 30000,
+  claudeTimeout: 300000,
+};
+
+/**
+ * Load config from disk. Returns null if not found.
+ */
+export function loadConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) return null;
+
+  // Verify permissions
+  const stat = fs.statSync(CONFIG_FILE);
+  const mode = stat.mode & 0o777;
+  if (mode !== CONFIG_PERMS) {
+    fs.chmodSync(CONFIG_FILE, CONFIG_PERMS);
+  }
+
+  const raw = fs.readFileSync(CONFIG_FILE, 'utf8');
+  const config = JSON.parse(raw);
+  return { ...DEFAULTS, ...config };
+}
+
+/**
+ * Save config to disk with secure permissions.
+ */
+export function saveConfig(config) {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { mode: DIR_PERMS, recursive: true });
+  }
+
+  const merged = { ...DEFAULTS, ...config };
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2), { mode: CONFIG_PERMS });
+  return merged;
+}
+
+/**
+ * Check if a valid config exists.
+ */
+export function configExists() {
+  const config = loadConfig();
+  return config && config.botToken && config.allowedUserId;
+}
+
+export { CONFIG_DIR, CONFIG_FILE };

package/src/i18n/index.mjs

@@ -0,0 +1,53 @@
+/**
+ * i18n singleton — loads locale JSON, provides t(key, vars) for template strings.
+ */
+
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+let strings = {};
+let currentLang = 'en';
+
+/**
+ * Initialize i18n with the given language. Falls back to 'en' if locale not found.
+ * @param {string} lang - 'en' or 'es'
+ */
+export function initI18n(lang) {
+  currentLang = (lang === 'es') ? 'es' : 'en';
+  const localePath = join(__dirname, 'locales', `${currentLang}.json`);
+  try {
+    strings = JSON.parse(readFileSync(localePath, 'utf8'));
+  } catch {
+    // Fallback to English
+    currentLang = 'en';
+    strings = JSON.parse(readFileSync(join(__dirname, 'locales', 'en.json'), 'utf8'));
+  }
+}
+
+/**
+ * Translate a dot-notation key, replacing {{var}} placeholders.
+ * @param {string} key - e.g. 'server.rateLimit' or 'setup.botValidated'
+ * @param {object} [vars] - e.g. { username: 'bot', firstName: 'Bot' }
+ * @returns {string}
+ */
+export function t(key, vars) {
+  const parts = key.split('.');
+  let val = strings;
+  for (const p of parts) {
+    val = val?.[p];
+  }
+  if (typeof val !== 'string') return key;
+  if (!vars) return val;
+  return val.replace(/\{\{(\w+)\}\}/g, (_, name) => vars[name] ?? '');
+}
+
+/**
+ * Get the current language code.
+ * @returns {'en'|'es'}
+ */
+export function getLang() {
+  return currentLang;
+}

package/src/i18n/locales/en.json

@@ -0,0 +1,114 @@
+{
+  "cli": {
+    "noConfig": "No configuration found. Starting setup...\n",
+    "startInfo": "Platform: {{platform}} | User: {{userId}}\n",
+    "botStarted": "🤖 Bot started (PID: {{pid}}). Log: {{log}}",
+    "botStopped": "Bot stopped.",
+    "botAlreadyRunning": "Bot is already running (PID: {{pid}}).",
+    "botNotRunning": "Bot is not running.",
+    "botRunning": "🤖 Bot is running (PID: {{pid}}).",
+    "botStopFailed": "Could not stop bot (PID: {{pid}}): {{error}}"
+  },
+  "setup": {
+    "existingConfig": "Existing config detected.\n",
+    "tokenHint": "📌 Create a bot with @BotFather using /newbot and paste the token here.",
+    "tokenPrompt": "Bot Token{{hint}}: ",
+    "tokenRequired": "\n❌ Token is required. Aborting.",
+    "validatingToken": "\nValidating token...",
+    "invalidToken": "❌ Invalid token. Check with @BotFather.",
+    "botValidated": "✅ Bot: @{{username}} ({{firstName}})\n",
+    "userIdHint": "📌 Send /start to @userinfobot on Telegram to get your numeric ID.",
+    "userIdPrompt": "Your Telegram User ID{{hint}}: ",
+    "userIdRequired": "\n❌ User ID is required. Send /start to @userinfobot to get it.",
+    "pathsHint": "📌 Directories where the bot can operate (cd, read files, run commands).",
+    "pathsExamples": "   Examples: /home/user,/var/www  |  Empty = full access",
+    "pathsPrompt": "Allowed paths{{hint}}: ",
+    "mediaDirHint": "\n📌 Directory where media files from Telegram are saved (images, audio, PDFs).",
+    "mediaDirAutoCreate": "   This folder is created automatically if it doesn't exist.",
+    "mediaDirExample": "   Example: {{example}}",
+    "mediaDirPrompt": "Media download path [{{default}}]: ",
+    "advancedOptions": "\n⚙️  Advanced options (press Enter to keep defaults):",
+    "cmdTimeoutPrompt": "Command timeout in minutes [{{default}}]: ",
+    "claudeTimeoutPrompt": "Claude timeout in minutes [{{default}}]: ",
+    "maxOutputPrompt": "Max output chars [{{default}}]: ",
+    "configSaved": "\n✅ Configuration saved.",
+    "runAgain": "   Run again to start the bot.\n"
+  },
+  "server": {
+    "rateLimit": "⏳ Rate limit. Please wait.",
+    "claudeBusy": "⏳ Claude is processing...",
+    "claudeProcessing": "🤖 Processing...",
+    "startMessage": "🖥️ *Remote Terminal*\n\n*Terminal:* text = bash, /run, /cd, /ls, /cat\n*System:* /status /procs /kill\n*Claude:* /claude — interactive session\n/exit — close | /claude_new — new session\n📂 `{{dir}}`  🔧 {{mode}}",
+    "runUsage": "Usage: /run <command>",
+    "catUsage": "Usage: /cat <file>",
+    "killUsage": "Usage: /kill <PID>",
+    "invalidPid": "❌ PID must be a number.",
+    "claudeMode": "🤖 *Claude Code Mode*\n📂 `{{dir}}`\n\nType and it's sent to Claude.\nSee what it does in real time.\nKeeps conversation context.\n\n/exit — Terminal | /claude_new — New conversation",
+    "askUsage": "Usage: /claude_ask <question>",
+    "newConversation": "🔄 New conversation.",
+    "terminalMode": "🖥️ Terminal mode.",
+    "fileSaved": "✅ `{{dest}}` ({{size}} KB)",
+    "claudeFileUploaded": "The user uploaded the file {{dest}} and says: {{caption}}",
+    "imageSaved": "🖼️ Image saved: `{{dest}}`",
+    "claudeImageWithCaption": "Look at this image I saved at {{dest}} and: {{caption}}",
+    "claudeImageAnalyze": "Look at the image I saved at {{dest}} and describe it. If it's a code or error screenshot, analyze it.",
+    "audioSaved": "🎤 Audio saved: `{{dest}}`\n\nTranscribing...",
+    "transcription": "🎤 *Transcription:*\n\n{{text}}",
+    "transcriptionFailed": "⚠️ Could not transcribe: {{error}}\nAudio saved as file.",
+    "sessionsTitle": "📋 Recent Claude sessions:",
+    "noSessions": "No Claude sessions yet.",
+    "sessionSelected": "✅ Session resumed. Send a message to continue.",
+    "pathNotAllowed": "⛔ Path not allowed: `{{path}}`",
+    "helpMessage": "📋 *Available Commands*\n\n*Terminal:*\nText → runs as bash command\n/run `<cmd>` — run command\n/cd `<dir>` — change directory\n/pwd — current directory\n/ls `[dir]` — list files\n/cat `<file>` — show file\n\n*System:*\n/status — system info\n/procs — running processes\n/kill `<PID>` — kill process\n\n*Claude:*\n/claude — enter Claude mode\n/claude\\_ask `<question>` — quick question\n/claude\\_new — new conversation\n/claude\\_sessions — list past sessions\n/exit — back to terminal\n\n*Other:*\n/mode — current mode\n/start — welcome message\n/help — this help"
+  },
+  "claude": {
+    "timeout": "Timeout (5min)",
+    "noResponse": "(no response)",
+    "toolRead": "📖 Reading: `{{path}}`",
+    "toolEdit": "✏️ Editing: `{{path}}`",
+    "toolWrite": "📝 Creating: `{{path}}`",
+    "toolGlob": "🔍 Searching: `{{pattern}}`",
+    "toolGrep": "🔎 Grep: `{{pattern}}`",
+    "toolBash": "⚡ `{{command}}`",
+    "toolWebSearch": "🌐 {{query}}",
+    "toolWebFetch": "🌐 Fetch: {{url}}",
+    "toolDefault": "🔧 {{tool}}",
+    "notInstalled": "Claude CLI is not installed. Install it with: npm install -g @anthropic-ai/claude-code"
+  },
+  "security": {
+    "emptyCommand": "Empty command.",
+    "blockedCommand": "Blocked command: dangerous pattern detected.",
+    "dangerousCommand": "Dangerous command — requires confirmation."
+  },
+  "telegram": {
+    "confirmYes": "Yes",
+    "confirmNo": "No",
+    "cmdHelp": "Command list",
+    "cmdStart": "Welcome message",
+    "cmdRun": "Run a command",
+    "cmdCd": "Change directory",
+    "cmdLs": "List files",
+    "cmdCat": "Show file contents",
+    "cmdStatus": "System info",
+    "cmdProcs": "Running processes",
+    "cmdKill": "Kill a process",
+    "cmdClaude": "Claude mode",
+    "cmdAsk": "Quick question to Claude",
+    "cmdNew": "New conversation",
+    "cmdSessions": "Claude sessions",
+    "cmdExit": "Back to terminal",
+    "cmdMode": "Current mode",
+    "cancelled": "❌ Cancelled.",
+    "selected": "✅ Selected",
+    "allowed": "✅ Allowed",
+    "denied": "❌ Denied",
+    "unauthorized": "⛔ Unauthorized.",
+    "botActive": "🤖 Bot active."
+  },
+  "utils": {
+    "truncated": "... (truncated)"
+  },
+  "transcriber": {
+    "ffmpegMissing": "ffmpeg is not installed. Install it with: sudo apt install ffmpeg"
+  }
+}

package/src/i18n/locales/es.json

@@ -0,0 +1,114 @@
+{
+  "cli": {
+    "noConfig": "No se encontró configuración. Iniciando setup...\n",
+    "startInfo": "Plataforma: {{platform}} | Usuario: {{userId}}\n",
+    "botStarted": "🤖 Bot iniciado (PID: {{pid}}). Log: {{log}}",
+    "botStopped": "Bot detenido.",
+    "botAlreadyRunning": "El bot ya está corriendo (PID: {{pid}}).",
+    "botNotRunning": "El bot no está corriendo.",
+    "botRunning": "🤖 El bot está corriendo (PID: {{pid}}).",
+    "botStopFailed": "No se pudo detener el bot (PID: {{pid}}): {{error}}"
+  },
+  "setup": {
+    "existingConfig": "Configuración existente detectada.\n",
+    "tokenHint": "📌 Crea un bot con @BotFather usando /newbot y pega el token aquí.",
+    "tokenPrompt": "Token del Bot{{hint}}: ",
+    "tokenRequired": "\n❌ El token es obligatorio. Abortando.",
+    "validatingToken": "\nValidando token...",
+    "invalidToken": "❌ Token inválido. Verificá con @BotFather.",
+    "botValidated": "✅ Bot: @{{username}} ({{firstName}})\n",
+    "userIdHint": "📌 Enviá /start a @userinfobot en Telegram para obtener tu ID numérico.",
+    "userIdPrompt": "Tu ID de usuario de Telegram{{hint}}: ",
+    "userIdRequired": "\n❌ El ID de usuario es obligatorio. Enviá /start a @userinfobot para obtenerlo.",
+    "pathsHint": "📌 Directorios donde el bot puede operar (cd, leer archivos, ejecutar comandos).",
+    "pathsExamples": "   Ejemplos: /home/user,/var/www  |  Vacío = acceso total",
+    "pathsPrompt": "Rutas permitidas{{hint}}: ",
+    "mediaDirHint": "\n📌 Directorio donde se guardan los archivos multimedia de Telegram (imágenes, audio, PDFs).",
+    "mediaDirAutoCreate": "   Esta carpeta se crea automáticamente si no existe.",
+    "mediaDirExample": "   Ejemplo: {{example}}",
+    "mediaDirPrompt": "Ruta de descarga de medios [{{default}}]: ",
+    "advancedOptions": "\n⚙️  Opciones avanzadas (presioná Enter para mantener los valores por defecto):",
+    "cmdTimeoutPrompt": "Timeout de comandos en minutos [{{default}}]: ",
+    "claudeTimeoutPrompt": "Timeout de Claude en minutos [{{default}}]: ",
+    "maxOutputPrompt": "Máximo de caracteres de salida [{{default}}]: ",
+    "configSaved": "\n✅ Configuración guardada.",
+    "runAgain": "   Ejecutá de nuevo para iniciar el bot.\n"
+  },
+  "server": {
+    "rateLimit": "⏳ Límite de velocidad. Esperá un momento.",
+    "claudeBusy": "⏳ Claude está procesando...",
+    "claudeProcessing": "🤖 Procesando...",
+    "startMessage": "🖥️ *Terminal Remota*\n\n*Terminal:* texto = bash, /run, /cd, /ls, /cat\n*Sistema:* /status /procs /kill\n*Claude:* /claude — sesión interactiva\n/exit — cerrar | /claude_new — nueva sesión\n📂 `{{dir}}`  🔧 {{mode}}",
+    "runUsage": "Uso: /run <comando>",
+    "catUsage": "Uso: /cat <archivo>",
+    "killUsage": "Uso: /kill <PID>",
+    "invalidPid": "❌ El PID debe ser un número.",
+    "claudeMode": "🤖 *Modo Claude Code*\n📂 `{{dir}}`\n\nEscribí y se envía a Claude.\nVé lo que hace en tiempo real.\nMantiene el contexto de la conversación.\n\n/exit — Terminal | /claude_new — Nueva conversación",
+    "askUsage": "Uso: /claude_ask <pregunta>",
+    "newConversation": "🔄 Nueva conversación.",
+    "terminalMode": "🖥️ Modo terminal.",
+    "fileSaved": "✅ `{{dest}}` ({{size}} KB)",
+    "claudeFileUploaded": "El usuario subió el archivo {{dest}} y dice: {{caption}}",
+    "imageSaved": "🖼️ Imagen guardada: `{{dest}}`",
+    "claudeImageWithCaption": "Mirá esta imagen que guardé en {{dest}} y: {{caption}}",
+    "claudeImageAnalyze": "Mirá la imagen que guardé en {{dest}} y describila. Si es un screenshot de código o error, analizalo.",
+    "audioSaved": "🎤 Audio guardado: `{{dest}}`\n\nTranscribiendo...",
+    "transcription": "🎤 *Transcripción:*\n\n{{text}}",
+    "transcriptionFailed": "⚠️ No se pudo transcribir: {{error}}\nAudio guardado como archivo.",
+    "sessionsTitle": "📋 Sesiones recientes de Claude:",
+    "noSessions": "No hay sesiones de Claude aún.",
+    "sessionSelected": "✅ Sesión reanudada. Enviá un mensaje para continuar.",
+    "pathNotAllowed": "⛔ Ruta no permitida: `{{path}}`",
+    "helpMessage": "📋 *Comandos Disponibles*\n\n*Terminal:*\nTexto → se ejecuta como comando bash\n/run `<cmd>` — ejecutar comando\n/cd `<dir>` — cambiar directorio\n/pwd — directorio actual\n/ls `[dir]` — listar archivos\n/cat `<archivo>` — mostrar archivo\n\n*Sistema:*\n/status — info del sistema\n/procs — procesos activos\n/kill `<PID>` — matar proceso\n\n*Claude:*\n/claude — entrar a modo Claude\n/claude\\_ask `<pregunta>` — pregunta rápida\n/claude\\_new — nueva conversación\n/claude\\_sessions — listar sesiones anteriores\n/exit — volver a terminal\n\n*Otros:*\n/mode — modo actual\n/start — mensaje de bienvenida\n/help — esta ayuda"
+  },
+  "claude": {
+    "timeout": "Timeout (5min)",
+    "noResponse": "(sin respuesta)",
+    "toolRead": "📖 Leyendo: `{{path}}`",
+    "toolEdit": "✏️ Editando: `{{path}}`",
+    "toolWrite": "📝 Creando: `{{path}}`",
+    "toolGlob": "🔍 Buscando: `{{pattern}}`",
+    "toolGrep": "🔎 Grep: `{{pattern}}`",
+    "toolBash": "⚡ `{{command}}`",
+    "toolWebSearch": "🌐 {{query}}",
+    "toolWebFetch": "🌐 Fetch: {{url}}",
+    "toolDefault": "🔧 {{tool}}",
+    "notInstalled": "Claude CLI no está instalado. Instalalo con: npm install -g @anthropic-ai/claude-code"
+  },
+  "security": {
+    "emptyCommand": "Comando vacío.",
+    "blockedCommand": "Comando bloqueado: patrón peligroso detectado.",
+    "dangerousCommand": "Comando peligroso — requiere confirmación."
+  },
+  "telegram": {
+    "confirmYes": "Sí",
+    "confirmNo": "No",
+    "cmdHelp": "Lista de comandos",
+    "cmdStart": "Mensaje de bienvenida",
+    "cmdRun": "Ejecutar comando",
+    "cmdCd": "Cambiar directorio",
+    "cmdLs": "Listar archivos",
+    "cmdCat": "Mostrar archivo",
+    "cmdStatus": "Info del sistema",
+    "cmdProcs": "Procesos activos",
+    "cmdKill": "Matar proceso",
+    "cmdClaude": "Modo Claude",
+    "cmdAsk": "Pregunta rápida a Claude",
+    "cmdNew": "Nueva conversación",
+    "cmdSessions": "Sesiones de Claude",
+    "cmdExit": "Volver a terminal",
+    "cmdMode": "Modo actual",
+    "cancelled": "❌ Cancelado.",
+    "selected": "✅ Seleccionada",
+    "allowed": "✅ Permitido",
+    "denied": "❌ Denegado",
+    "unauthorized": "⛔ No autorizado.",
+    "botActive": "🤖 Bot activo."
+  },
+  "utils": {
+    "truncated": "... (truncado)"
+  },
+  "transcriber": {
+    "ffmpegMissing": "ffmpeg no está instalado. Instalalo con: sudo apt install ffmpeg"
+  }
+}