Forked from crunch3r/ai-toolbox
Forked from crunch3r/ai-toolbox
src / locales / es.ts
src / locales / es.ts
/**
* Spanish (es) translations for AI Toolbox plugin
*/
import type { FullTranslationSet } from './types';
export const esTranslations: FullTranslationSet = {
fileSystem: {
categoryTitle: '📁 Herramientas del sistema de archivos',
tools: [
{ toolName: 'list_directory', description: 'Lista los archivos y carpetas en el área de trabajo', parameters: ['path (opcional)'] },
{ toolName: 'read_file', description: 'Lee el contenido de un archivo de texto', parameters: ['file_name'] },
{ toolName: 'save_file', description: 'Crea o sobrescribe un archivo', parameters: ['file_name, content'] },
{ toolName: 'replace_text_in_file', description: 'Reemplaza una cadena exacta en el archivo (USAR PARA INSERCIÓN/SUSTITUCIÓN COMPLEJA — nunca usar line_operations para esto)', parameters: ['file_name, old_string, new_string'] },
{ toolName: 'insert_at_line', description: '⚠️ Solo inserción única — evítalo para cambios estructurales de varios pasos (usa save_file/replace_text_in_file). Inserta texto en un número de línea específico.', parameters: ['file_name, line_number, content'] },
{ toolName: 'append_file', description: 'Añade contenido al final del archivo', parameters: ['file_name, content'] },
{ toolName: 'delete_lines_in_file', description: 'Elimina líneas específicas del archivo', parameters: ['file_name, start_line, end_line (opcional)'] },
{ toolName: 'line_operations', description: 'Inserta/elimina/reordena líneas estilo awk sin dependencias de shell; tres capas de salvaguardas (anclaje por patrón, huella digital de línea, validación de límites) + verificación de integridad MD5 tras la escritura', parameters: ['file_name, operation, target_line or pattern anchors (+ options)'] },
{ toolName: 'make_directory', description: 'Crea un nuevo directorio', parameters: ['directory_name'] },
{ toolName: 'move_file', description: 'Mueve o renombra archivo/directorio', parameters: ['source, destination'] },
{ toolName: 'copy_file', description: 'Copia un archivo a una nueva ubicación', parameters: ['source, destination'] },
{ toolName: 'delete_path', description: 'Elimina un archivo o directorio (destructivo)', parameters: ['path'] },
{ toolName: 'delete_files_by_pattern', description: 'Elimina archivos que coincidan con una expresión regular', parameters: ['pattern (regex)'] },
{ toolName: 'find_files', description: 'Busca archivos por patrón de nombre recursivamente', parameters: ['pattern, max_depth (opcional)'] },
{ toolName: 'fuzzy_find_local_files', description: 'Búsqueda difusa de archivos por similitud de nombre/ruta', parameters: ['query, path (opcional), max_results (opcional)'] },
{ toolName: 'get_file_metadata', description: 'Obtiene tamaño, fechas e información de tipo del archivo', parameters: ['path'] },
{ toolName: 'change_directory', description: 'Cambia el directorio de trabajo', parameters: ['directory'] },
{ toolName: 'read_document', description: 'Lee documentos PDF o DOCX', parameters: ['file_path'] },
{ toolName: 'analyze_project', description: 'Ejecuta análisis de linting en todo el proyecto', parameters: [] },
{ toolName: 'read_file_chunked', description: 'Lee archivos en chunks estructurados para superar límites de caracteres, devolviendo índices de inicio/fin para control de streaming en archivos enormes', parameters: ['file_name, chunk_size/max_chunks (opcional)'] },
{ toolName: 'ripgrep', description: 'Búsqueda de contenido recursiva con ripgrep en worker aislado — todo el escaneo se ejecuta fuera del hilo principal (watchdog de 3 s termina workers atascados); insensible a mayúsculas por defecto (-i); regex inválidos reintentan como literal y se reportan vía pattern_mode; node_modules excluido por defecto', parameters: ['pattern, path, mode, case_insensitive, include_glob, exclude_globs, max_depth'] },
{ toolName: 'find_replace_all', description: 'Búsqueda y reemplazo regex en varios archivos con vista previa dry-run, copias .bak y filtros de extensión — prevención de cuelgues por límite de profundidad integrada', parameters: ['pattern, replacement (opcional), directory/dry_run/confirm (+ filters)'] },
{ toolName: 'pattern_scan', description: 'Búsqueda recursiva de contenido que devuelve las líneas coincidentes como {file, line, content}; regex inseguras se degradan automáticamente a literal; límites de 256 KB / 10k líneas por archivo con registros de omisión; límite de reloj real de 3 s aborta el scan cooperativamente → resultados PARCIALES con flag aborted', parameters: ['pattern (+ root/mode/caps options)'] },
{ toolName: 'directory_tree', description: 'Visualiza la estructura del directorio en formato árbol con profundidad máxima, tamaños opcionales y exclusión automática de directorios grandes', parameters: ['path/max_depth/show_size (opcional)'] },
{ toolName: 'file_diff', description: 'Compara dos archivos y devuelve un diff unificado con marcadores +/− y números de línea', parameters: ['file_a, file_b'] },
{ toolName: 'apply_patch', description: 'Aplica parches unified-diff o byte-anchor binarios completamente en proceso (sin shell): hunks add/replace/context por línea con verificación', parameters: ['file_path, patch_content (+ mode)'] },
],
},
webSearch: {
categoryTitle: '🌐 Herramientas web e investigación',
tools: [
{ toolName: 'web_search', description: 'Busca en DuckDuckGo/Google/Bing con cadena de reintentos', parameters: ['query, providers (opcional)'] },
{ toolName: 'wikipedia_search', description: 'Busca resúmenes de páginas en Wikipedia', parameters: ['query, lang (opcional)'] },
{ toolName: 'fetch_web_content', description: 'Obtiene el contenido limpio del texto de una página web', parameters: ['url'] },
{ toolName: 'rag_web_content', description: 'Extracción semántica de páginas web basada en RAG', parameters: ['url, query'] },
{ toolName: 'browser_session_control', description: 'Controla acciones del navegador (clic, escritura, etc.)', parameters: ['array actions, bandera read_page'] },
],
},
browserAutomation: {
categoryTitle: '🌐 Herramientas de automatización web',
tools: [
{ toolName: 'browser_open_page', description: 'Renderizado de página única con Puppeteer', parameters: ['url, screenshot_path (opcional), actions (opcional)'] },
{ toolName: 'browser_session_close', description: 'Cierra una sesión persistente del navegador de forma ordenada, evitando procesos Chromium huérfanos', parameters: [] },
{ toolName: 'preview_html', description: 'Renderiza HTML crudo o un archivo .html existente en el navegador predeterminado del sistema', parameters: ['source (HTML string or path)'] },
{ toolName: 'open_file', description: 'Abre archivos/URLs en la aplicación predeterminada del sistema (Windows start / macOS open / Linux xdg-open)', parameters: ['target'] },
],
},
gitOperations: {
categoryTitle: '🐙 Herramientas Git y GitHub',
tools: [
{ toolName: 'git_status', description: 'Muestra los archivos modificados del repositorio', parameters: [] },
{ toolName: 'git_diff', description: 'Ve los cambios en detalle', parameters: ['file_path (opcional), cached (opcional)'] },
{ toolName: 'git_commit', description: 'Commitea los cambios en el staging area', parameters: ['message'] },
{ toolName: 'git_log', description: 'Muestra el historial de commits', parameters: ['max_count (opcional)'] },
{ toolName: 'git_add', description: 'Pone en staging archivos específicos o todos los cambios', parameters: ['paths (opcional)'] },
{ toolName: 'git_checkout', description: 'Cambia a una rama existente o crea una nueva', parameters: ['branch_name, create_new (opcional)'] },
{ toolName: 'gh_create_issue', description: 'Crea un nuevo issue en GitHub', parameters: ['title, body (opcional), labels (opcional)'] },
{ toolName: 'gh_list_issues', description: 'Lista issues del repositorio', parameters: ['state (opcional), labels (opcional), limit (opcional)'] },
{ toolName: 'gh_view_comments', description: 'Muestra comentarios de un issue o PR', parameters: ['number, type (opcional)'] },
{ toolName: 'gh_create_pr', description: 'Crea una pull request', parameters: ['title, body, head_branch, base_branch (opcional)'] },
{ toolName: 'gh_list_prs', description: 'Lista pull requests', parameters: ['state (opcional), limit (opcional)'] },
{ toolName: 'gh_view_pr_diff', description: 'Obtiene el diff/patch de una PR', parameters: ['number'] },
{ toolName: 'gh_push', description: 'Empuja commits al repositorio remoto', parameters: ['branch (opcional)'] },
{ toolName: 'git_stash', description: 'Gestiona cambios sin commitear: guardar, aplicar, descartar y listar stashes (Git CLI nativo — isomorphic-git no soporta stash)', parameters: ['operation (+ options)'] },
{ toolName: 'git_blame', description: 'Historial de commits por línea mostrando autor, marca de tiempo y hash; la validación de ruta previene ataques de traversal', parameters: ['file_path (+ options)'] },
],
},
databaseQueries: {
categoryTitle: '💾 Herramientas de consulta de base de datos',
tools: [
{ toolName: 'query_database', description: 'Ejecuta consultas SQLite de solo lectura', parameters: ['query (cadena SQL)'] },
],
},
documentParsing: {
categoryTitle: '📄 Herramientas de análisis de documentos',
tools: [
{ toolName: 'read_document', description: 'Lee documentos PDF o DOCX', parameters: ['file_path'] },
],
},
backgroundCommands: {
categoryTitle: '⏱️ Herramientas de comandos en segundo plano',
tools: [
{ toolName: 'run_background_command', description: 'Inicia un proceso de larga duración en segundo plano', parameters: ['command, timeout_hours (obligatorio), name (obligatorio)'] },
{ toolName: 'check_background_command', description: 'Comprueba el estado y la salida del comando en ejecución', parameters: ['id'] },
{ toolName: 'cancel_background_command', description: 'Termina un comando en segundo plano en ejecución', parameters: ['id'] },
],
},
codeRefactoring: {
categoryTitle: '🧬 Herramientas de refactorización de código',
tools: [
{ toolName: 'refactor_code', description: 'Refactorización basada en AST (Babel): renombrar identificadores, mover funciones entre archivos, extraer funciones, limpieza de imports muertos — segura sintácticamente con copia .bak y rollback automático ante fallos; soporta diffs dry-run', parameters: ['file_path, operation, per-operation fields, dry_run (opcional)'] },
],
},
execution: {
categoryTitle: '⚡ Herramientas de ejecución',
tools: [
{ toolName: 'run_javascript', description: 'Ejecuta JavaScript en un contexto VM de Node aislado; eval/require/child_process bloqueados, timeout predeterminado 5 s', parameters: ['javascript, timeout_seconds (opcional)'] },
{ toolName: 'run_python', description: 'Ejecuta Python en una sandbox controlada; imports os/subprocess/sys bloqueados, timeout predeterminado 10 s', parameters: ['python, timeout_seconds (opcional)'] },
{ toolName: 'execute_command', description: '⚠️ Ejecuta comandos de shell con sanitización multinivel y límites de pipe — deshabilitado por defecto', parameters: ['command (+ options)'] },
{ toolName: 'run_in_terminal', description: 'Lanza una ventana de terminal nativa del SO (cmd/PowerShell/zsh/bash) con variables de entorno y opciones de visibilidad', parameters: [] },
{ toolName: 'run_tests', description: 'Detecta automáticamente el framework de pruebas desde package.json (Jest/Mocha/Vitest) y ejecuta la suite del proyecto, devolviendo resultados', parameters: [] },
],
},
textProcessing: {
categoryTitle: '📝 Herramientas de procesamiento de texto',
tools: [
{ toolName: 'text_transform', description: 'Sustitución de texto basada en regex con grupos de captura ($1/$2), rangos de líneas y modos global/insensible a mayúsculas — más seguro que sed de shell', parameters: ['file_name, pattern, replacement (opcional), flags (opcional)'] },
{ toolName: 'text_extract', description: 'Extracción estructurada de campos de texto delimitado (CSV/TSV/personalizado) usando índices de campo basados en cero', parameters: ['file_name, fields, delimiter (opcional), output_format (opcional)'] },
{ toolName: 'markdown_table_gen', description: 'Genera una tabla Markdown válida a partir de un array de objetos con encabezados, alineación y truncamiento', parameters: ['data, headers (opcional)'] },
],
},
taskPlanning: {
categoryTitle: '📋 Herramientas de planificación de tareas',
tools: [
{ toolName: 'create_plan', description: 'Crea un plan de ejecución multietapa (1–30 pasos); reemplaza cualquier plan activo y devuelve planId + stepCount', parameters: ['goal, steps'] },
{ toolName: 'get_plan', description: 'Devuelve el plan activo con estados de pasos, porcentaje de completado y tiempo transcurrido; null si no existe plan', parameters: [] },
{ toolName: 'update_plan_step', description: 'Actualiza un paso del plan mediante la máquina de estados (pending→in_progress→done; any→blocked; blocked→pending) — note obligatorio al bloquear', parameters: ['planId, index, status, note (required if blocked)'] },
{ toolName: 'remove_plan', description: 'Elimina un plan persistido del almacén de estado de trabajo; vista previa dry-run salvo confirm=true — solo para planes INCONCLUIDOS, los completados se eliminan solos vía update_plan_step en el último done', parameters: ['planId, confirm (required to remove)'] },
],
},
contextManagement: {
categoryTitle: '🧠 Herramientas de contexto y memoria',
tools: [
{ toolName: 'auto_summarize_context', description: 'Analiza la actividad reciente de la sesión en busca de patrones, uso frecuente de herramientas y decisiones dignas de recordar; se guarda en memoria persistente con alcance global', parameters: ['session_events (+ config_changes)'] },
{ toolName: 'get_context_memory', description: 'Recupera entradas de contexto anteriores filtradas por tipo (decision/pattern/configuration/file_change/error/summary); el scoring recencia×frecuencia muestra primero las entradas recientes y frecuentemente accedidas', parameters: ['type (opcional), limit (opcional)'] },
{ toolName: 'search_context', description: 'Búsqueda difusa de texto en títulos, cuerpos y etiquetas de entradas de contexto; las entradas de sesión expiradas se eliminan antes de buscar (TTL 24 h)', parameters: ['query, max_results (opcional)'] },
{ toolName: 'context_summary', description: 'Resumen estadístico de la memoria persistente: total de entradas, desglose por tipo y recuentos de actividad reciente', parameters: [] },
{ toolName: 'delete_context_entry', description: 'Elimina una entrada de contexto específica por su ID único sin borrar el resto del historial', parameters: ['entry_id'] },
{ toolName: 'clear_context_memory', description: 'Borra todas las entradas de contexto guardadas automáticamente (⚠️ irreversible; requiere confirm=true)', parameters: ['confirm'] },
{ toolName: 'track_important_event', description: 'Registra manualmente un evento, decisión o hito con etiquetas personalizadas para recuperación categorizada', parameters: ['title, content, tags (opcional)'] },
{ toolName: 'save_session_summary', description: 'Guarda un resumen de sesión estructurado (logros, tareas pendientes, decisiones) comprimido para superar el límite SDK de 10k', parameters: ['task_description (+ optional sections)'] },
{ toolName: 'get_session_summary', description: 'Recupera el último resumen de sesión guardado con fallback compatible hacia atrás para datos legacy', parameters: [] },
{ toolName: 'save_memory', description: 'Persiste un hecho en .ai_toolbox_memory.msgpack para continuidad entre sesiones (RAM + copia atómica en disco)', parameters: ['fact'] },
{ toolName: 'get_memory', description: 'Recupera todas las entradas de memoria guardadas; primero se consulta el archivo local del proyecto, luego el almacén persistente', parameters: [] },
{ toolName: 'delete_memory', description: 'Elimina una entrada de memoria específica por su clave única (devuelta durante el guardado)', parameters: ['entry_id'] },
{ toolName: 'list_sessions', description: 'Navega resúmenes de sesión guardados con controles de paginación y límite', parameters: ['limit (opcional), offset (opcional)'] },
{ toolName: 'search_sessions', description: 'Búsqueda por palabras clave en resúmenes de sesión almacenados, del más reciente al más antiguo', parameters: ['query, max_results (opcional)'] },
{ toolName: 'clear_session_index', description: 'Elimina solo todas las entradas ligeras del índice de sesiones — los resúmenes no se tocan (requiere confirm=true)', parameters: ['confirm'] },
{ toolName: 'manage_projects', description: 'Gestiona el registro interproyectos — mutaciones Y lecturas: registrar / dar de baja / actualizar / borrar todos + info / list / search (herramienta única para TODAS las operaciones del registro; acciones destructivas requieren confirm=true)', parameters: ['action (register|unregister|update|clear_all|info|list|search), project_name, working_dir_path (requerido para register/unregister/update/info), source_dirs (opcional), query + max_results (para search), confirm (requerido para acciones destructivas)'] },
{ toolName: 'register_project', description: '[ALIAS OBSOLETO de manage_projects(action="register")] Registra o actualiza un proyecto en el registro interproyectos por nombre + ruta de directorio de trabajo (+ dirs fuente opcionales)', parameters: ['project_name, working_dir_path, source_dirs (opcional)'] },
{ toolName: 'get_project_info', description: '[ALIAS OBSOLETO de manage_projects(action="info")] Recupera los detalles de un proyecto registrado por su ruta de directorio de trabajo', parameters: ['working_dir_path'] },
{ toolName: 'list_projects', description: '[ALIAS OBSOLETO de manage_projects(action="list")] Lista todos los proyectos registrados con rutas, último acceso y recuentos de sesiones', parameters: [] },
{ toolName: 'search_projects', description: '[ALIAS OBSOLETO de manage_projects(action="search")] Busca proyectos registrados por nombre o subcadena de ruta; la sincronización perezosa del registro auto-registra proyectos encontrados en memoria de sesión', parameters: ['query, max_results (opcional)'] },
{ toolName: 'switch_context', description: 'Cambia el almacenamiento de contexto al directorio de trabajo de otro proyecto para recordar memoria/sesiones (confirm-first según banner Step 0.7)', parameters: ['target_working_dir_path'] },
{ toolName: 'restore_session_context', description: 'Restaura TODO lo persistido de sesiones anteriores del proyecto actual en UNA sola llamada de solo lectura: último resumen de sesión + planes persistidos + entradas de contexto (puntos de control automáticos agrupados) + hechos memorizados + índice de sesiones recientes — el único punto de entrada "read session mem"', parameters: ['include_sessions_index, max_chars (ambos opcionales)'] },
{ toolName: 'memory_recall', description: 'Recuerdo READ-ONLY basado en ID sobre la capa de memoria: mode=index lista filas compactas id/título/fecha de entradas de contexto + hechos memorizados + sesiones; mode=fetch devuelve registros completos para hasta 10 ids con motivos de fallo autoexplicativos (summary_never_persisted es esperado por diseño)', parameters: ['mode (index|fetch), kind, limit (solo index) / ids ≤10, per_item_chars (solo fetch)'] },
],
},
vectorRag: {
categoryTitle: '🔍 Herramientas Vector RAG',
tools: [
{ toolName: 'rag_index_files', description: 'Indexa un directorio de archivos TS/JS/MD/JSON/YAML/texto para búsqueda semántica con procesamiento por lotes', parameters: ['directoryPath, filePattern (opcional), batchSize (opcional)'] },
{ toolName: 'rag_index_pdf', description: 'Indexa un PDF en chunks limitados por página (~300 palabras cada uno) con procedencia page_number — lecturas acotadas seguras contra OOM', parameters: ['filePath, chunkSize/overlap (opcional)'] },
{ toolName: 'rag_index_docx', description: 'Extrae texto DOCX vía mammoth en chunks limitados por palabra a través del mismo pipeline de embeddings que PDF', parameters: ['filePath, chunkSize/overlap (opcional)'] },
{ toolName: 'rag_index_xlsx', description: 'Indexa todas las hojas de una hoja de cálculo como arrays de filas con prefijo opcional de nombre de hoja para trazabilidad', parameters: ['filePath, chunkSize (opcional), includeSheetNames (opcional)'] },
{ toolName: 'rag_query_vector', description: 'Consulta por similitud coseno sobre el índice vectorial que devuelve top-k chunks con contenido y puntuaciones', parameters: ['query, topK (opcional)'] },
{ toolName: 'rag_clear_index', description: 'Borra todo el índice vectorial (requiere confirm=true); útil antes de un reindexado completo', parameters: ['confirm'] },
{ toolName: 'rag_web_content', description: 'Obtiene una URL y devuelve solo los chunks de texto relevantes para la consulta — extracción acotada y deduplicada', parameters: ['url, query'] },
],
},
uiGeneration: {
categoryTitle: '🎨 Herramientas de generación de UI',
tools: [
{ toolName: 'generate_ui_component', description: 'Crea componentes interactivos HTML/CSS/JS (botones, formularios, tablas) a partir de una descripción del usuario', parameters: [] },
{ toolName: 'render_and_preview_ui', description: 'Renderiza componentes en el navegador con vista previa en vivo para prototipado rápido', parameters: [] },
{ toolName: 'extract_ui_data', description: 'Extrae datos estructurados de páginas mediante selectores CSS/XPath devolviendo salida tabular al chat', parameters: [] },
],
},
httpClient: {
categoryTitle: '📡 Herramientas de cliente HTTP',
tools: [
{ toolName: 'http_request', description: 'Cliente genérico GET/POST/PUT/DELETE/PATCH con lógica de reintento, configuración de timeout y subida multipart — protegido contra SSRF (⚠️ deshabilitado por defecto)', parameters: ['url, method (+ options)'] },
{ toolName: 'http_get_json', description: 'Peticiones GET que esperan respuestas JSON con parseo automático y validación opcional de esquema', parameters: ['url (+ headers/options)'] },
{ toolName: 'http_post_json', description: 'Peticiones POST con payload JSON, manejo automático de content-type y soporte de token de autenticación; devuelve código de estado', parameters: ['url, body (+ options)'] },
],
},
utilities: {
categoryTitle: '🔧 Herramientas utilitarias',
tools: [
{ toolName: 'markdown_preview', description: 'Representa un archivo Markdown como HTML y lo abre en el navegador predeterminado', parameters: ['file_path'] },
{ toolName: 'get_repeat_tool_advice', description: 'Devuelve el estado actual del recordatorio de herramientas repetidas y avisos activos; sirve para comprobar si el modelo está en bucle de repetición', parameters: ['toolName, args (optional)'] },
{ toolName: 'get_update_info', description: 'Lee el estado actual de actualización de AI Toolbox sin cambios: versión instalada, si se conoce una versión publicada más nueva (comprobación con caché de 24 h contra el archivo .VERSION del hub) y su URL de página de marketplace cuando esté disponible — renderízala como enlace clicable en el chat', parameters: [] },
{ toolName: 'dismiss_update_reminder', description: 'Registra "ahora no" para una versión de recordatorio de actualización para que deje de notificar cada turno; esa versión queda silenciada de forma permanente, las versiones estrictamente nuevas siguen notificando', parameters: ['version'] },
],
},
imageProcessing: {
categoryTitle: '🖼️ Herramientas de procesamiento y análisis de imágenes',
tools: [
{ toolName: 'image_to_text', description: 'Extracción OCR de texto vía Tesseract.js con puntuaciones de confianza y detección de idioma (máx. 50 MB)', parameters: ['imagePath, language (opcional)'] },
{ toolName: 'describe_image', description: 'Obtiene metadatos de imagen: dimensiones, formato, tamaño y marcas de tiempo para PNG/JPG/BMP/GIF/WebP/TIFF', parameters: ['imagePath'] },
{ toolName: 'screenshot_desktop', description: 'Captura una captura de pantalla del escritorio multiplataforma (GDI+/screencapture/ImageMagick)', parameters: ['outputPath/format/quality (opcional)'] },
{ toolName: 'compare_images', description: 'Comparación a nivel de bytes y dimensiones de dos imágenes; estado de coincidencia exacta para codificaciones idénticas', parameters: ['image1Path, image2Path'] },
],
},
backupRestore: {
categoryTitle: '💾 Herramientas de copia de seguridad y restauración',
tools: [
{ toolName: 'create_backup', description: 'Crea una instantánea ZIP comprimida de todo el directorio de trabajo en .ai_toolbox_backups/ (requiere confirm=true)', parameters: ['confirm, destination/targetDirectory (opcional)'] },
{ toolName: 'list_backups', description: 'Lista copias de seguridad ordenadas por fecha o tamaño con nombre, ruta, tamaño y marca de creación', parameters: ['sortBy/limit (opcional)'] },
{ toolName: 'restore_backup', description: 'Restaura el directorio de trabajo desde un archivo de copia (⚠️ sobrescribe todos los archivos; requiere confirm=true)', parameters: ['backupFile, confirm'] },
{ toolName: 'delete_backup', description: 'Elimina un archivo de copia específico (⚠️ irreversible; valida existencia primero)', parameters: ['backupFile, confirm'] },
{ toolName: 'cleanup_backups', description: 'Lista y opcionalmente elimina copias .bak de edición — dry-run por defecto, se requiere confirmación para eliminar', parameters: ['confirm (opcional)'] },
{ toolName: 'restore_from_bak', description: 'Restaura un archivo desde su copia de seguridad .bak creada por herramientas de modificación de archivos (replace_text_in_file, insert_at_line, append_file, delete_lines_in_file)', parameters: ['file_name'] },
{ toolName: 'list_available_bak_backups', description: 'Escanea el directorio de trabajo actual en busca de todos los archivos .bak creados por herramientas de modificación de archivos; consulta disponible antes de restaurar', parameters: [] },
],
},
dataVisualization: {
categoryTitle: '📈 Herramientas de visualización de datos',
tools: [
{ toolName: 'generate_chart', description: 'Renderiza gráficos bar/line/pie/doughnut/scatter/radar a imagen PNG desde datos crudos; fallback HTML cuando el renderizador no está disponible', parameters: ['type, data (+ title/colors/output_path optional)'] },
],
},
// ── UNIFIED LANGUAGE v2 (26.10): textos de prompt en runtime. S4 (<SYSTEM_INSTRUCTION>) es
// NEUTRAL por diseño y se mantiene byte-identico en TODAS las locales (solo con GO del owner). ──
runtimeTexts: {
workingDirDetected: '⚠️ DIRECTORIO DE TRABAJO DETECTADO',
workingDirMentionedLine: 'El usuario mencionó una ruta de directorio en su mensaje:',
workingDirConfirmAsk: 'Pide al usuario confirmación antes de cambiar el directorio de trabajo.',
workingDirExampleLabel: 'Respuesta de ejemplo:',
// Espacios finales tras ". " y "? " replican la estructura de la plantilla en (una frase por línea).
workingDirExampleText: "He visto que mencionas el directorio '{path}'. \n¿Quieres que lo establezca como tu directorio de trabajo? \nTodas las operaciones de archivos posteriores usarán este directorio como base.",
workingDirReplyHint: "Responde con '{yes}' para confirmar, o con '{no}' para rechazar.",
workingDirOriginalMessageLabel: 'Mensaje original del usuario:',
projectDetectedTitle: '⚠️ PROYECTO REGISTRADO DETECTADO',
projectFoundLead: 'He encontrado un proyecto registrado que coincide con tu mensaje:',
projectNameLabel: 'Proyecto: "{name}"',
projectPathLabel: 'Ruta: {path}',
projectSwitchQuestion: '¿Quieres que cambie tu directorio de trabajo a este proyecto?',
sessionMemoryLoadedTitle: '📋 MEMORIA DE SESIÓN CARGADA',
previousSessionLabel: 'Resumen de la sesión anterior:',
// S4 — deliberadamente neutral (byte-identico en todas las locales, veredicto del owner 06.10)
checkpointWarningHeader: 'TOKEN LIMIT WARNING — ACKNOWLEDGE BEFORE RESPONDING:',
checkpointActionRequiredLead: 'ACTION REQUIRED: Before responding to the user\'s message, explicitly acknowledge this token limit warning.',
checkpointIfConfirmedLine: 'If the user replied with one of the confirmation options shown in the warning above → trigger the context management save tool now.',
checkpointIfDeclinedLine: 'If the user declined or did NOT give a confirmation reply → ask them if they want to proceed with a context save.',
checkpointDoNotProceedLine: 'Do not proceed with normal conversation until this warning has been addressed.',
sessionWarningHead: '⚠️ ADVERTENCIA DE SESIÓN: Has alcanzado el {pct}% de tu límite de tokens. Se recomienda encarecidamente guardar la memoria de sesión antes de continuar.',
bufferedEventsLine: 'Eventos con seguimiento automático en buffer (se guardarán con el checkpoint): {count}',
contextSaveQuestion: "¿Quieres proceder con un guardado de contexto? Responde con '{yes}' para iniciar el guardado de memoria de sesión, o con '{no}' para continuar.",
attachedFilesTitle: '📎 ARCHIVOS ADJUNTOS DISPONIBLES:',
attachedFilesLead: 'Tienes acceso a los siguientes archivos adjuntos. Puedes leerlos usando la herramienta read_document por nombre de archivo:',
// Cita el título del banner EN a propósito — documentTools.ts referencia esa cadena exacta (contrato).
attachmentErrorCrossRef: "Nota: si este es un archivo adjunto, usa el nombre exacto de la lista \"ATTACHED FILES AVAILABLE\".",
ragContextHeader: '--- CONTEXTO DE DOCUMENTOS RELEVANTES ---',
answerLanguageLine: 'Responde al usuario en {language}.',
},
// ── UNIFIED LANGUAGE v2 (26.10): etiquetas del panel de configuración — horneadas en el arranque. ──
uiLabels: {
languageRow: {
displayName: '🌐 Idioma',
options: { auto: 'Automático (sigue a LM Studio)', en: 'English', de: 'Deutsch (Alemán)', es: 'Español', zhCN: 'Chino simplificado', zhTW: 'Chino tradicional' },
},
godMode: { displayName: '⚡⚠️ GOD MODE - ACTIVAR TODAS LAS HERRAMIENTAS ⚠️⚡', subtitle: 'AVISO: Activa todas las categorías de herramientas al instante. Úsalo con precaución.', hint: 'Cuando está activado, SE OMITEN todos los interruptores individuales y cada herramienta se activa sin importar la configuración.' },
fileSystem: { displayName: '📁 Herramientas de Sistema de Archivos', hint: 'Activar operaciones de lectura/escritura/búsqueda de archivos' },
webSearch: { displayName: '🌐 Herramientas Web & Investigación', hint: 'Activar búsqueda DuckDuckGo/Wikipedia' },
packageManage: { displayName: 'Herramientas de Gestión de Paquetes', subtitle: 'Operaciones npm/pip/cargo', hint: 'Activar herramientas del gestor de paquetes. Desactivadas por defecto por seguridad.' },
gitOperations: { displayName: '🐙 Herramientas Git & GitHub', subtitle: 'Control de versionado & API', hint: 'Activar operaciones de git y acceso a la API de GitHub.' },
gitAutoCommit: { displayName: '💾 Auto-Commit de Git', subtitle: '⚙️ Parte de Herramientas Git & GitHub', hint: 'Commitea los cambios automáticamente tras las operaciones' },
defaultBranch: { displayName: '🌿 Rama Predeterminada', subtitle: '⚙️ Parte de Herramientas Git & GitHub', hint: 'Nombre de rama para nuevos repositorios y operaciones de git' },
databaseQueries: { displayName: '🗄️ Consultas a Base de Datos', hint: 'Activar consultas SQLite solo de lectura' },
documentParsing: { displayName: '📄 Análisis de Documentos', hint: 'Activar lectura de documentos PDF/DOCX' },
backgroundCommands: { displayName: '⏳ Comandos en Segundo Plano', hint: 'Activar seguimiento de procesos de larga duración' },
imageProcessing: { displayName: '🖼️ Herramientas de Procesamiento de Imágenes', subtitle: 'OCR, Capturas y Comparación', hint: 'Activar OCR de imágenes (Tesseract.js), captura de pantalla y herramientas de comparación de imágenes.' },
httpClient: { displayName: '🔌 Herramientas de Cliente HTTP', subtitle: 'Cliente REST genérico', hint: 'Activar cliente HTTP genérico para hacer peticiones a cualquier API REST (GET, POST, PUT, DELETE).' },
vectorRag: { displayName: '📊 Vector RAG / Búsqueda Semántica', subtitle: 'Búsqueda semántica de documentos', hint: 'Activar búsqueda semántica con embeddings vectoriales para la recuperación inteligente de documentos.' },
uiGeneration: { displayName: '🎨 Herramientas de Generación Interactiva de UI', subtitle: 'Generar y renderizar componentes de UI interactivos', hint: 'Activar herramientas para generar componentes HTML/CSS/JS (botones, formularios, gráficos, paneles) y renderizarlos en el navegador.' },
contextManagement: { displayName: '🧠 Herramientas de Gestión Automática de Contexto', subtitle: 'Seguimiento automático de sesiones y gestión de memoria', hint: 'Activar herramientas para guardar automáticamente decisiones importantes, patrones y configuraciones en la memoria persistente.' },
documentRAG: { displayName: '📚 Document RAG / Chat con Archivos', subtitle: 'Activar indexación de archivos y búsqueda semántica para el chat', hint: 'Adjunta documentos a tus mensajes de chat. El plugin recuperará automáticamente contenido relevante de los archivos adjuntos mediante búsqueda semántica.' },
textProcessing: { displayName: '📝 Herramientas de Procesamiento de Texto (equivalentes sed/awk)', subtitle: 'Transformaciones de texto basadas en regex y extracción de campos', hint: 'Activar herramientas para sustitución masiva de texto, coincidencia de patrones y extracción estructurada de datos sin dependencias de shell.' },
refactorCode: { displayName: '🔧 Herramientas de Refactorización AST de Código', subtitle: 'Renombrar, mover, extraer funciones y limpiar imports no usados', hint: 'Activar herramientas de refactorización de código basadas en AST (rename_identifier, move_function, extract_function, unused_import_cleanup).' },
utility: { displayName: '🛠️ Herramientas de Utilidad y Mantenimiento', subtitle: 'Copias de seguridad, generación de gráficos, vista previa de markdown, operaciones de líneas', hint: 'Activar herramientas utilitarias (create_backup, list_backups, restore_backup, delete_backup, cleanup_backups, generate_chart, markdown_preview).' },
taskPlanning: { displayName: '📋 Herramientas de Planificación de Tareas', subtitle: 'Herramientas de flujo de trabajo multinivel estructuradas', hint: 'Activar create_plan, update_plan_step y get_plan para la ejecución estructurada de tareas.' },
clusterAwareToolOrder: { displayName: '🧭 Orden de Herramientas con Conciencia de Clústeres', subtitle: 'Ordena las herramientas expuestas por nivel de prioridad + centralidad del módulo en lugar de alfabéticamente.', hint: 'Usa el grafo de dependencias estático de ARCHITECTURE.md (sin E/S de fs). Desactívalo para restaurar el orden alfabético legacy.' },
retrievalLimit: { displayName: '🔢 Límite de Recuperación', subtitle: 'Máx. de chunks por consulta', hint: 'Número máximo de chunks relevantes de documentos que se recuperarán por cada consulta.' },
retrievalAffinityThreshold: { displayName: '🎯 Umbral de Afinidad de Recuperación', subtitle: 'Puntuación mínima de relevancia (0-1)', hint: 'Los chunks por debajo de esta puntuación de similitud se filtrarán. Más bajo = más resultados, pero potencialmente menos relevantes.' },
executionJavaScript: { displayName: '⚡ Permitir Ejecución de JavaScript', subtitle: "Habilita la herramienta 'run_javascript'", hint: 'AVISO: el código se ejecuta en tu máquina.' },
executionPython: { displayName: '🐍 Permitir Ejecución de Python', subtitle: "Habilita la herramienta 'run_python'", hint: 'AVISO: el código se ejecuta en tu máquina.' },
executionTerminal: { displayName: '💻 Permitir Ejecución de Terminal', subtitle: "Habilita la herramienta 'run_in_terminal'", hint: 'Abre ventanas de terminal reales.' },
executionShell: { displayName: '🔧 Permitir Ejecución de Comandos Shell', subtitle: "Habilita la herramienta 'execute_command'", hint: 'AVISO: los comandos se ejecutan en tu máquina.' },
executionTests: { displayName: '🧪 Permitir Ejecución de Pruebas', subtitle: "Habilita la herramienta 'run_tests'", hint: 'AVISO: ejecuta npm jest / pytest / go test — puede instalar paquetes y ejecutar código.' },
searchFallbackChain: { displayName: '🔍 Cadena de Recurrido de Búsqueda', hint: 'Motor de búsqueda primario. Reincide automáticamente en otros si no está disponible.' },
safesearch: { displayName: '🛡️ Búsqueda Segura', options: { off: 'Desactivada', moderate: 'Moderada', strict: 'Estricta' } },
browserAutomation: { displayName: '🖥️ Herramientas de Automatización del Navegador', subtitle: 'Control y automatización de navegador headless', hint: 'Activar automatización de navegador headless basada en Puppeteer para scraping web, pruebas e interacción con la interfaz.' },
browserTimeout: { displayName: '⏱️ Tiempo Límite del Navegador', subtitle: '⚙️ Parte de Herramientas de Automatización del Navegador', hint: 'Tiempo máximo (ms) que se espera en las operaciones del navegador antes de expirar.' },
headlessMode: { displayName: '👻 Modo Headless', subtitle: '⚙️ Parte de Herramientas de Automatización del Navegador', hint: 'Ejecutar el navegador sin interfaz gráfica (recomendado para automatización).' },
pathValidationEnabled: { displayName: '🔒 Validación de Rutas', hint: 'Prevenir ataques de traversía de directorios' },
binaryFileDetection: { displayName: '📁 Detección de Archivos Binarios', hint: 'Detectar archivos binarios mediante comprobación de byte nulo' },
regexReDoSProtection: { displayName: '🛡️ Protección ReDoS', hint: 'Proteger contra denegación de servicio por regex' },
statePersistenceEnabled: { displayName: '💽 Persistencia de Estado', hint: 'Persistir el estado de ejecución de herramientas entre sesiones' },
notificationsEnabled: { displayName: '🔔 Notificaciones de Escritorio', hint: 'Mostrar notificaciones del sistema' },
updateCheckEnabled: { displayName: '🔄 Comprobación de Actualizaciones del Plugin', subtitle: 'Comprobación silenciosa del .VERSION del hub de LM Studio — sin herramientas nuevas, sin permisos de SO', hint: "Una vez al día el plugin comprueba en silencio el archivo .VERSION publicado en el hub de LM Studio para detectar una versión estrictamente más nueva. Si existe, notifica mediante toast de escritorio (Notificaciones de Escritorio ACTIVADAS) o una sola línea en el chat (DESACTIVADAS). Silencioso cuando estás al día o con una versión descartada; el estado sobrevive a reinstalaciones." },
temporalAwareness: { displayName: '⏰ Conciencia Temporal', subtitle: 'Inyecta la fecha/hora actual en cada mensaje', hint: 'Permite que la IA sepa la hora actual.' },
dateFormatStyle: { displayName: '📅 Estilo de Formato de Fecha', options: { standard: 'Estándar ([Zeit: ...])', heuteIst: 'Modo HEUTE IST (Prominente)' } },
contextGuardEnabled: { displayName: '🧠 Gestión de Tokens de ContextGuard', subtitle: 'Compresión automática del historial y lectura inteligente', hint: 'Comprime automáticamente el historial de chat cuando se alcanza el límite de tokens. Habilita la lectura inteligente de archivos y el filtrado de salida de terminal.' },
contextGuardCompressionPercent: { displayName: '📊 Disparador de Compresión (% de la Ventana de Contexto)', subtitle: '⚙️ Ajuste de ContextGuard', hint: "La compresión del historial se dispara cuando el uso del contexto alcanza este porcentaje de la ventana de contexto del modelo activo. Si LM Studio informa la ventana real del modelo, se usa; de lo contrario aplica un respaldo integrado de 30k." },
contextGuardAgenticDensity: { displayName: '🔢 Densidad de Caracteres por Token (Agentico)', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Caracteres por token usados para estimar tokens desde la longitud en caracteres (mezcla agéntica de prosa + salida de herramientas; banda medida en vivo ~3,2-3,4 — el valor por defecto 3,6 es fijado por el owner por encima de esa banda). Mayor = contenido más denso = menos tokens estimados; menor estima más y dispara compactación antes.' },
contextGuardForceSummaryOnCompress: { displayName: '💾 Forzar Guardado de Memoria de Sesión Antes de Comprimir', subtitle: '⚙️ Ajuste de ContextGuard', hint: "Cuando el contexto alcanza tu disparador de compresión, se genera un resumen estructurado de la sesión (descripción de tarea, logros, tareas pendientes) con el Modelo de Resumen y se persiste ANTES de comprimir el historial. No fatal: ante cualquier fallo sigue ejecutándose el checkpoint de telemetría anterior." },
contextGuardSmartReading: { displayName: '🔍 Lectura Inteligente de Archivos', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Extrae palabras clave de las consultas del usuario para leer solo las partes relevantes de los archivos. Ahorra tokens y agiliza las respuestas.' },
contextGuardSummaryModel: { displayName: '🤖 Nombre del Modelo de Resumen', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Nombre del modelo de LM Studio usado para resumir el historial. Déjalo vacío para usar tu modelo de chat actual.' },
contextGuardTerminalFilterEnabled: { displayName: '📌 Filtrado de Salida de Terminal', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Trunca automáticamente las salidas largas de terminal para ahorrar tokens.' },
contextGuardTerminalFilterLength: { displayName: '📏 Longitud Máxima de Salida de Terminal', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Caracteres máximos antes de que la salida de terminal sea truncada y resumida.' },
compactionEnabled: { displayName: '✂️ Podado Pre-Resumen de Compactación', subtitle: '⚙️ Familia C de Compactación', hint: 'Antes de resumir el historial, los payloads de herramientas por encima del presupuesto en bytes se reemplazan por una vista previa de cabecera/cola más un localizador opaco; el resultado completo permanece almacenado literalmente en .ai_toolbox/compaction/.' },
compactionMaxResultBytes: { displayName: '📏 Tamaño Máx. del Resultado de Herramienta Antes del Podado (bytes)', subtitle: '⚙️ Familia C de Compactación', hint: 'Presupuesto en bytes por payload de resultado de herramienta en el historial de chat. Los resultados superiores se podan a vista previa + localizador antes del resumen (copia literal almacenada en disco).' },
contextUsageFooter: { displayName: '📊 Pie de Uso de Contexto en Resultados de Herramientas', subtitle: '⚙️ Conciencia del Límite del Lado LLM', hint: "Una vez que el uso proyectado del contexto supera la mitad de la ventana del modelo, cada resultado de herramienta gana un pie corto como [ctx ~48.3k/64k = 76%] — añadido a los resultados de cadena y como campo ctx_footer aditivo en resultados de objeto plano (cada herramienta registrada devuelve uno) — para que el modelo siempre vea el uso actual de tokens. A partir del >=90% se añade un aviso de límite cercano." },
autoTrackingEnabled: { displayName: '🤖 Seguimiento Automático Activado', subtitle: 'Recuerda eventos importantes automáticamente', hint: 'Sigue en segundo plano, en silencio, decisiones, completados y correcciones de errores. Activado por defecto.' },
autoTrackTokenThreshold: { displayName: 'Umbral de Tokens del Auto-Seguimiento', subtitle: 'Ajuste de Auto-Seguimiento', hint: 'Dispara el guardado de memoria de sesión cuando el uso de tokens alcanza este porcentaje (por defecto: 75%). Ayuda a prevenir desbordes de contexto.' },
autoTrackDecisions: { displayName: '📌 Seguir Decisiones Automáticamente', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Detecta frases como "he decidido", "conclusión", "vamos con".' },
autoTrackCompletions: { displayName: '✅ Seguir Completados Automáticamente', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Detecta frases como "completado con éxito", "implementación terminada".' },
autoTrackErrors: { displayName: '🐛 Seguir Correcciones de Errores Automáticamente', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Detecta frases como "corregido el error", "resuelto el problema".' },
autoSummaryInterval: { displayName: '📊 Intervalo de Resumen de Sesión', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Número de mensajes entre resúmenes automáticos de sesión. Mayor = menos frecuente.' },
// Budget-Guard-Arc i18n (06.11, regla del owner "todas las descripciones SIEMPRE traducidas"): el fallback EN de config.ts sigue byte-pinned.
budgetGuardEnabled: { displayName: '🛡️ Budget Guard (protección del límite de contexto)', hint: 'Interruptor maestro de la protección determinista de presupuesto de contexto — puerta M1 pre-lectura, tope M2 de spill consciente del presupuesto, auto-persistencia M3 en el borde del 85 %. Activado por defecto (06.11); desactívalo para restaurar el comportamiento legacy idéntico byte a byte.' },
budgetGuardAdvisoryThresholdPct: { displayName: '🔢 Umbral de aviso Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'Puerta M1 pre-lectura: por encima de este % del límite de contexto, las herramientas de lectura devuelven un aviso de presupuesto auto-descrito en vez del volcado completo.' },
budgetGuardSpillThresholdPct: { displayName: '✂️ Umbral de spill Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'Tope M2: los resultados de herramienta se vierten a disco más allá de este % del límite (gana la cota más estricta: absoluta vs. relativa al presupuesto).' },
budgetGuardAutopauseThresholdPct: { displayName: '💾 Borde de auto-persistencia Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'M3: persistencia automática de la memoria de sesión en este borde de %, máximo una vez por sesión.' },
budgetGuardSafetyMarginPct: { displayName: '🧮 Margen de seguridad Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'Reserva retenida fuera del límite de contexto para el cálculo M2 — límite × (1 − margen/100); defecto 8 ⇒ spill al 92 %.' },
},
general: {
pluginName: 'Complemento AI Toolbox',
enabledTools: 'Herramientas habilitadas:',
disabledTools: 'Herramientas deshabilitadas:',
errorPrefix: 'Error:',
successPrefix: 'Éxito:',
yesWord: 'SÍ',
noWord: 'NO',
},
};
/**
* Spanish (es) translations for AI Toolbox plugin
*/
import type { FullTranslationSet } from './types';
export const esTranslations: FullTranslationSet = {
fileSystem: {
categoryTitle: '📁 Herramientas del sistema de archivos',
tools: [
{ toolName: 'list_directory', description: 'Lista los archivos y carpetas en el área de trabajo', parameters: ['path (opcional)'] },
{ toolName: 'read_file', description: 'Lee el contenido de un archivo de texto', parameters: ['file_name'] },
{ toolName: 'save_file', description: 'Crea o sobrescribe un archivo', parameters: ['file_name, content'] },
{ toolName: 'replace_text_in_file', description: 'Reemplaza una cadena exacta en el archivo (USAR PARA INSERCIÓN/SUSTITUCIÓN COMPLEJA — nunca usar line_operations para esto)', parameters: ['file_name, old_string, new_string'] },
{ toolName: 'insert_at_line', description: '⚠️ Solo inserción única — evítalo para cambios estructurales de varios pasos (usa save_file/replace_text_in_file). Inserta texto en un número de línea específico.', parameters: ['file_name, line_number, content'] },
{ toolName: 'append_file', description: 'Añade contenido al final del archivo', parameters: ['file_name, content'] },
{ toolName: 'delete_lines_in_file', description: 'Elimina líneas específicas del archivo', parameters: ['file_name, start_line, end_line (opcional)'] },
{ toolName: 'line_operations', description: 'Inserta/elimina/reordena líneas estilo awk sin dependencias de shell; tres capas de salvaguardas (anclaje por patrón, huella digital de línea, validación de límites) + verificación de integridad MD5 tras la escritura', parameters: ['file_name, operation, target_line or pattern anchors (+ options)'] },
{ toolName: 'make_directory', description: 'Crea un nuevo directorio', parameters: ['directory_name'] },
{ toolName: 'move_file', description: 'Mueve o renombra archivo/directorio', parameters: ['source, destination'] },
{ toolName: 'copy_file', description: 'Copia un archivo a una nueva ubicación', parameters: ['source, destination'] },
{ toolName: 'delete_path', description: 'Elimina un archivo o directorio (destructivo)', parameters: ['path'] },
{ toolName: 'delete_files_by_pattern', description: 'Elimina archivos que coincidan con una expresión regular', parameters: ['pattern (regex)'] },
{ toolName: 'find_files', description: 'Busca archivos por patrón de nombre recursivamente', parameters: ['pattern, max_depth (opcional)'] },
{ toolName: 'fuzzy_find_local_files', description: 'Búsqueda difusa de archivos por similitud de nombre/ruta', parameters: ['query, path (opcional), max_results (opcional)'] },
{ toolName: 'get_file_metadata', description: 'Obtiene tamaño, fechas e información de tipo del archivo', parameters: ['path'] },
{ toolName: 'change_directory', description: 'Cambia el directorio de trabajo', parameters: ['directory'] },
{ toolName: 'read_document', description: 'Lee documentos PDF o DOCX', parameters: ['file_path'] },
{ toolName: 'analyze_project', description: 'Ejecuta análisis de linting en todo el proyecto', parameters: [] },
{ toolName: 'read_file_chunked', description: 'Lee archivos en chunks estructurados para superar límites de caracteres, devolviendo índices de inicio/fin para control de streaming en archivos enormes', parameters: ['file_name, chunk_size/max_chunks (opcional)'] },
{ toolName: 'ripgrep', description: 'Búsqueda de contenido recursiva con ripgrep en worker aislado — todo el escaneo se ejecuta fuera del hilo principal (watchdog de 3 s termina workers atascados); insensible a mayúsculas por defecto (-i); regex inválidos reintentan como literal y se reportan vía pattern_mode; node_modules excluido por defecto', parameters: ['pattern, path, mode, case_insensitive, include_glob, exclude_globs, max_depth'] },
{ toolName: 'find_replace_all', description: 'Búsqueda y reemplazo regex en varios archivos con vista previa dry-run, copias .bak y filtros de extensión — prevención de cuelgues por límite de profundidad integrada', parameters: ['pattern, replacement (opcional), directory/dry_run/confirm (+ filters)'] },
{ toolName: 'pattern_scan', description: 'Búsqueda recursiva de contenido que devuelve las líneas coincidentes como {file, line, content}; regex inseguras se degradan automáticamente a literal; límites de 256 KB / 10k líneas por archivo con registros de omisión; límite de reloj real de 3 s aborta el scan cooperativamente → resultados PARCIALES con flag aborted', parameters: ['pattern (+ root/mode/caps options)'] },
{ toolName: 'directory_tree', description: 'Visualiza la estructura del directorio en formato árbol con profundidad máxima, tamaños opcionales y exclusión automática de directorios grandes', parameters: ['path/max_depth/show_size (opcional)'] },
{ toolName: 'file_diff', description: 'Compara dos archivos y devuelve un diff unificado con marcadores +/− y números de línea', parameters: ['file_a, file_b'] },
{ toolName: 'apply_patch', description: 'Aplica parches unified-diff o byte-anchor binarios completamente en proceso (sin shell): hunks add/replace/context por línea con verificación', parameters: ['file_path, patch_content (+ mode)'] },
],
},
webSearch: {
categoryTitle: '🌐 Herramientas web e investigación',
tools: [
{ toolName: 'web_search', description: 'Busca en DuckDuckGo/Google/Bing con cadena de reintentos', parameters: ['query, providers (opcional)'] },
{ toolName: 'wikipedia_search', description: 'Busca resúmenes de páginas en Wikipedia', parameters: ['query, lang (opcional)'] },
{ toolName: 'fetch_web_content', description: 'Obtiene el contenido limpio del texto de una página web', parameters: ['url'] },
{ toolName: 'rag_web_content', description: 'Extracción semántica de páginas web basada en RAG', parameters: ['url, query'] },
{ toolName: 'browser_session_control', description: 'Controla acciones del navegador (clic, escritura, etc.)', parameters: ['array actions, bandera read_page'] },
],
},
browserAutomation: {
categoryTitle: '🌐 Herramientas de automatización web',
tools: [
{ toolName: 'browser_open_page', description: 'Renderizado de página única con Puppeteer', parameters: ['url, screenshot_path (opcional), actions (opcional)'] },
{ toolName: 'browser_session_close', description: 'Cierra una sesión persistente del navegador de forma ordenada, evitando procesos Chromium huérfanos', parameters: [] },
{ toolName: 'preview_html', description: 'Renderiza HTML crudo o un archivo .html existente en el navegador predeterminado del sistema', parameters: ['source (HTML string or path)'] },
{ toolName: 'open_file', description: 'Abre archivos/URLs en la aplicación predeterminada del sistema (Windows start / macOS open / Linux xdg-open)', parameters: ['target'] },
],
},
gitOperations: {
categoryTitle: '🐙 Herramientas Git y GitHub',
tools: [
{ toolName: 'git_status', description: 'Muestra los archivos modificados del repositorio', parameters: [] },
{ toolName: 'git_diff', description: 'Ve los cambios en detalle', parameters: ['file_path (opcional), cached (opcional)'] },
{ toolName: 'git_commit', description: 'Commitea los cambios en el staging area', parameters: ['message'] },
{ toolName: 'git_log', description: 'Muestra el historial de commits', parameters: ['max_count (opcional)'] },
{ toolName: 'git_add', description: 'Pone en staging archivos específicos o todos los cambios', parameters: ['paths (opcional)'] },
{ toolName: 'git_checkout', description: 'Cambia a una rama existente o crea una nueva', parameters: ['branch_name, create_new (opcional)'] },
{ toolName: 'gh_create_issue', description: 'Crea un nuevo issue en GitHub', parameters: ['title, body (opcional), labels (opcional)'] },
{ toolName: 'gh_list_issues', description: 'Lista issues del repositorio', parameters: ['state (opcional), labels (opcional), limit (opcional)'] },
{ toolName: 'gh_view_comments', description: 'Muestra comentarios de un issue o PR', parameters: ['number, type (opcional)'] },
{ toolName: 'gh_create_pr', description: 'Crea una pull request', parameters: ['title, body, head_branch, base_branch (opcional)'] },
{ toolName: 'gh_list_prs', description: 'Lista pull requests', parameters: ['state (opcional), limit (opcional)'] },
{ toolName: 'gh_view_pr_diff', description: 'Obtiene el diff/patch de una PR', parameters: ['number'] },
{ toolName: 'gh_push', description: 'Empuja commits al repositorio remoto', parameters: ['branch (opcional)'] },
{ toolName: 'git_stash', description: 'Gestiona cambios sin commitear: guardar, aplicar, descartar y listar stashes (Git CLI nativo — isomorphic-git no soporta stash)', parameters: ['operation (+ options)'] },
{ toolName: 'git_blame', description: 'Historial de commits por línea mostrando autor, marca de tiempo y hash; la validación de ruta previene ataques de traversal', parameters: ['file_path (+ options)'] },
],
},
databaseQueries: {
categoryTitle: '💾 Herramientas de consulta de base de datos',
tools: [
{ toolName: 'query_database', description: 'Ejecuta consultas SQLite de solo lectura', parameters: ['query (cadena SQL)'] },
],
},
documentParsing: {
categoryTitle: '📄 Herramientas de análisis de documentos',
tools: [
{ toolName: 'read_document', description: 'Lee documentos PDF o DOCX', parameters: ['file_path'] },
],
},
backgroundCommands: {
categoryTitle: '⏱️ Herramientas de comandos en segundo plano',
tools: [
{ toolName: 'run_background_command', description: 'Inicia un proceso de larga duración en segundo plano', parameters: ['command, timeout_hours (obligatorio), name (obligatorio)'] },
{ toolName: 'check_background_command', description: 'Comprueba el estado y la salida del comando en ejecución', parameters: ['id'] },
{ toolName: 'cancel_background_command', description: 'Termina un comando en segundo plano en ejecución', parameters: ['id'] },
],
},
codeRefactoring: {
categoryTitle: '🧬 Herramientas de refactorización de código',
tools: [
{ toolName: 'refactor_code', description: 'Refactorización basada en AST (Babel): renombrar identificadores, mover funciones entre archivos, extraer funciones, limpieza de imports muertos — segura sintácticamente con copia .bak y rollback automático ante fallos; soporta diffs dry-run', parameters: ['file_path, operation, per-operation fields, dry_run (opcional)'] },
],
},
execution: {
categoryTitle: '⚡ Herramientas de ejecución',
tools: [
{ toolName: 'run_javascript', description: 'Ejecuta JavaScript en un contexto VM de Node aislado; eval/require/child_process bloqueados, timeout predeterminado 5 s', parameters: ['javascript, timeout_seconds (opcional)'] },
{ toolName: 'run_python', description: 'Ejecuta Python en una sandbox controlada; imports os/subprocess/sys bloqueados, timeout predeterminado 10 s', parameters: ['python, timeout_seconds (opcional)'] },
{ toolName: 'execute_command', description: '⚠️ Ejecuta comandos de shell con sanitización multinivel y límites de pipe — deshabilitado por defecto', parameters: ['command (+ options)'] },
{ toolName: 'run_in_terminal', description: 'Lanza una ventana de terminal nativa del SO (cmd/PowerShell/zsh/bash) con variables de entorno y opciones de visibilidad', parameters: [] },
{ toolName: 'run_tests', description: 'Detecta automáticamente el framework de pruebas desde package.json (Jest/Mocha/Vitest) y ejecuta la suite del proyecto, devolviendo resultados', parameters: [] },
],
},
textProcessing: {
categoryTitle: '📝 Herramientas de procesamiento de texto',
tools: [
{ toolName: 'text_transform', description: 'Sustitución de texto basada en regex con grupos de captura ($1/$2), rangos de líneas y modos global/insensible a mayúsculas — más seguro que sed de shell', parameters: ['file_name, pattern, replacement (opcional), flags (opcional)'] },
{ toolName: 'text_extract', description: 'Extracción estructurada de campos de texto delimitado (CSV/TSV/personalizado) usando índices de campo basados en cero', parameters: ['file_name, fields, delimiter (opcional), output_format (opcional)'] },
{ toolName: 'markdown_table_gen', description: 'Genera una tabla Markdown válida a partir de un array de objetos con encabezados, alineación y truncamiento', parameters: ['data, headers (opcional)'] },
],
},
taskPlanning: {
categoryTitle: '📋 Herramientas de planificación de tareas',
tools: [
{ toolName: 'create_plan', description: 'Crea un plan de ejecución multietapa (1–30 pasos); reemplaza cualquier plan activo y devuelve planId + stepCount', parameters: ['goal, steps'] },
{ toolName: 'get_plan', description: 'Devuelve el plan activo con estados de pasos, porcentaje de completado y tiempo transcurrido; null si no existe plan', parameters: [] },
{ toolName: 'update_plan_step', description: 'Actualiza un paso del plan mediante la máquina de estados (pending→in_progress→done; any→blocked; blocked→pending) — note obligatorio al bloquear', parameters: ['planId, index, status, note (required if blocked)'] },
{ toolName: 'remove_plan', description: 'Elimina un plan persistido del almacén de estado de trabajo; vista previa dry-run salvo confirm=true — solo para planes INCONCLUIDOS, los completados se eliminan solos vía update_plan_step en el último done', parameters: ['planId, confirm (required to remove)'] },
],
},
contextManagement: {
categoryTitle: '🧠 Herramientas de contexto y memoria',
tools: [
{ toolName: 'auto_summarize_context', description: 'Analiza la actividad reciente de la sesión en busca de patrones, uso frecuente de herramientas y decisiones dignas de recordar; se guarda en memoria persistente con alcance global', parameters: ['session_events (+ config_changes)'] },
{ toolName: 'get_context_memory', description: 'Recupera entradas de contexto anteriores filtradas por tipo (decision/pattern/configuration/file_change/error/summary); el scoring recencia×frecuencia muestra primero las entradas recientes y frecuentemente accedidas', parameters: ['type (opcional), limit (opcional)'] },
{ toolName: 'search_context', description: 'Búsqueda difusa de texto en títulos, cuerpos y etiquetas de entradas de contexto; las entradas de sesión expiradas se eliminan antes de buscar (TTL 24 h)', parameters: ['query, max_results (opcional)'] },
{ toolName: 'context_summary', description: 'Resumen estadístico de la memoria persistente: total de entradas, desglose por tipo y recuentos de actividad reciente', parameters: [] },
{ toolName: 'delete_context_entry', description: 'Elimina una entrada de contexto específica por su ID único sin borrar el resto del historial', parameters: ['entry_id'] },
{ toolName: 'clear_context_memory', description: 'Borra todas las entradas de contexto guardadas automáticamente (⚠️ irreversible; requiere confirm=true)', parameters: ['confirm'] },
{ toolName: 'track_important_event', description: 'Registra manualmente un evento, decisión o hito con etiquetas personalizadas para recuperación categorizada', parameters: ['title, content, tags (opcional)'] },
{ toolName: 'save_session_summary', description: 'Guarda un resumen de sesión estructurado (logros, tareas pendientes, decisiones) comprimido para superar el límite SDK de 10k', parameters: ['task_description (+ optional sections)'] },
{ toolName: 'get_session_summary', description: 'Recupera el último resumen de sesión guardado con fallback compatible hacia atrás para datos legacy', parameters: [] },
{ toolName: 'save_memory', description: 'Persiste un hecho en .ai_toolbox_memory.msgpack para continuidad entre sesiones (RAM + copia atómica en disco)', parameters: ['fact'] },
{ toolName: 'get_memory', description: 'Recupera todas las entradas de memoria guardadas; primero se consulta el archivo local del proyecto, luego el almacén persistente', parameters: [] },
{ toolName: 'delete_memory', description: 'Elimina una entrada de memoria específica por su clave única (devuelta durante el guardado)', parameters: ['entry_id'] },
{ toolName: 'list_sessions', description: 'Navega resúmenes de sesión guardados con controles de paginación y límite', parameters: ['limit (opcional), offset (opcional)'] },
{ toolName: 'search_sessions', description: 'Búsqueda por palabras clave en resúmenes de sesión almacenados, del más reciente al más antiguo', parameters: ['query, max_results (opcional)'] },
{ toolName: 'clear_session_index', description: 'Elimina solo todas las entradas ligeras del índice de sesiones — los resúmenes no se tocan (requiere confirm=true)', parameters: ['confirm'] },
{ toolName: 'manage_projects', description: 'Gestiona el registro interproyectos — mutaciones Y lecturas: registrar / dar de baja / actualizar / borrar todos + info / list / search (herramienta única para TODAS las operaciones del registro; acciones destructivas requieren confirm=true)', parameters: ['action (register|unregister|update|clear_all|info|list|search), project_name, working_dir_path (requerido para register/unregister/update/info), source_dirs (opcional), query + max_results (para search), confirm (requerido para acciones destructivas)'] },
{ toolName: 'register_project', description: '[ALIAS OBSOLETO de manage_projects(action="register")] Registra o actualiza un proyecto en el registro interproyectos por nombre + ruta de directorio de trabajo (+ dirs fuente opcionales)', parameters: ['project_name, working_dir_path, source_dirs (opcional)'] },
{ toolName: 'get_project_info', description: '[ALIAS OBSOLETO de manage_projects(action="info")] Recupera los detalles de un proyecto registrado por su ruta de directorio de trabajo', parameters: ['working_dir_path'] },
{ toolName: 'list_projects', description: '[ALIAS OBSOLETO de manage_projects(action="list")] Lista todos los proyectos registrados con rutas, último acceso y recuentos de sesiones', parameters: [] },
{ toolName: 'search_projects', description: '[ALIAS OBSOLETO de manage_projects(action="search")] Busca proyectos registrados por nombre o subcadena de ruta; la sincronización perezosa del registro auto-registra proyectos encontrados en memoria de sesión', parameters: ['query, max_results (opcional)'] },
{ toolName: 'switch_context', description: 'Cambia el almacenamiento de contexto al directorio de trabajo de otro proyecto para recordar memoria/sesiones (confirm-first según banner Step 0.7)', parameters: ['target_working_dir_path'] },
{ toolName: 'restore_session_context', description: 'Restaura TODO lo persistido de sesiones anteriores del proyecto actual en UNA sola llamada de solo lectura: último resumen de sesión + planes persistidos + entradas de contexto (puntos de control automáticos agrupados) + hechos memorizados + índice de sesiones recientes — el único punto de entrada "read session mem"', parameters: ['include_sessions_index, max_chars (ambos opcionales)'] },
{ toolName: 'memory_recall', description: 'Recuerdo READ-ONLY basado en ID sobre la capa de memoria: mode=index lista filas compactas id/título/fecha de entradas de contexto + hechos memorizados + sesiones; mode=fetch devuelve registros completos para hasta 10 ids con motivos de fallo autoexplicativos (summary_never_persisted es esperado por diseño)', parameters: ['mode (index|fetch), kind, limit (solo index) / ids ≤10, per_item_chars (solo fetch)'] },
],
},
vectorRag: {
categoryTitle: '🔍 Herramientas Vector RAG',
tools: [
{ toolName: 'rag_index_files', description: 'Indexa un directorio de archivos TS/JS/MD/JSON/YAML/texto para búsqueda semántica con procesamiento por lotes', parameters: ['directoryPath, filePattern (opcional), batchSize (opcional)'] },
{ toolName: 'rag_index_pdf', description: 'Indexa un PDF en chunks limitados por página (~300 palabras cada uno) con procedencia page_number — lecturas acotadas seguras contra OOM', parameters: ['filePath, chunkSize/overlap (opcional)'] },
{ toolName: 'rag_index_docx', description: 'Extrae texto DOCX vía mammoth en chunks limitados por palabra a través del mismo pipeline de embeddings que PDF', parameters: ['filePath, chunkSize/overlap (opcional)'] },
{ toolName: 'rag_index_xlsx', description: 'Indexa todas las hojas de una hoja de cálculo como arrays de filas con prefijo opcional de nombre de hoja para trazabilidad', parameters: ['filePath, chunkSize (opcional), includeSheetNames (opcional)'] },
{ toolName: 'rag_query_vector', description: 'Consulta por similitud coseno sobre el índice vectorial que devuelve top-k chunks con contenido y puntuaciones', parameters: ['query, topK (opcional)'] },
{ toolName: 'rag_clear_index', description: 'Borra todo el índice vectorial (requiere confirm=true); útil antes de un reindexado completo', parameters: ['confirm'] },
{ toolName: 'rag_web_content', description: 'Obtiene una URL y devuelve solo los chunks de texto relevantes para la consulta — extracción acotada y deduplicada', parameters: ['url, query'] },
],
},
uiGeneration: {
categoryTitle: '🎨 Herramientas de generación de UI',
tools: [
{ toolName: 'generate_ui_component', description: 'Crea componentes interactivos HTML/CSS/JS (botones, formularios, tablas) a partir de una descripción del usuario', parameters: [] },
{ toolName: 'render_and_preview_ui', description: 'Renderiza componentes en el navegador con vista previa en vivo para prototipado rápido', parameters: [] },
{ toolName: 'extract_ui_data', description: 'Extrae datos estructurados de páginas mediante selectores CSS/XPath devolviendo salida tabular al chat', parameters: [] },
],
},
httpClient: {
categoryTitle: '📡 Herramientas de cliente HTTP',
tools: [
{ toolName: 'http_request', description: 'Cliente genérico GET/POST/PUT/DELETE/PATCH con lógica de reintento, configuración de timeout y subida multipart — protegido contra SSRF (⚠️ deshabilitado por defecto)', parameters: ['url, method (+ options)'] },
{ toolName: 'http_get_json', description: 'Peticiones GET que esperan respuestas JSON con parseo automático y validación opcional de esquema', parameters: ['url (+ headers/options)'] },
{ toolName: 'http_post_json', description: 'Peticiones POST con payload JSON, manejo automático de content-type y soporte de token de autenticación; devuelve código de estado', parameters: ['url, body (+ options)'] },
],
},
utilities: {
categoryTitle: '🔧 Herramientas utilitarias',
tools: [
{ toolName: 'markdown_preview', description: 'Representa un archivo Markdown como HTML y lo abre en el navegador predeterminado', parameters: ['file_path'] },
{ toolName: 'get_repeat_tool_advice', description: 'Devuelve el estado actual del recordatorio de herramientas repetidas y avisos activos; sirve para comprobar si el modelo está en bucle de repetición', parameters: ['toolName, args (optional)'] },
{ toolName: 'get_update_info', description: 'Lee el estado actual de actualización de AI Toolbox sin cambios: versión instalada, si se conoce una versión publicada más nueva (comprobación con caché de 24 h contra el archivo .VERSION del hub) y su URL de página de marketplace cuando esté disponible — renderízala como enlace clicable en el chat', parameters: [] },
{ toolName: 'dismiss_update_reminder', description: 'Registra "ahora no" para una versión de recordatorio de actualización para que deje de notificar cada turno; esa versión queda silenciada de forma permanente, las versiones estrictamente nuevas siguen notificando', parameters: ['version'] },
],
},
imageProcessing: {
categoryTitle: '🖼️ Herramientas de procesamiento y análisis de imágenes',
tools: [
{ toolName: 'image_to_text', description: 'Extracción OCR de texto vía Tesseract.js con puntuaciones de confianza y detección de idioma (máx. 50 MB)', parameters: ['imagePath, language (opcional)'] },
{ toolName: 'describe_image', description: 'Obtiene metadatos de imagen: dimensiones, formato, tamaño y marcas de tiempo para PNG/JPG/BMP/GIF/WebP/TIFF', parameters: ['imagePath'] },
{ toolName: 'screenshot_desktop', description: 'Captura una captura de pantalla del escritorio multiplataforma (GDI+/screencapture/ImageMagick)', parameters: ['outputPath/format/quality (opcional)'] },
{ toolName: 'compare_images', description: 'Comparación a nivel de bytes y dimensiones de dos imágenes; estado de coincidencia exacta para codificaciones idénticas', parameters: ['image1Path, image2Path'] },
],
},
backupRestore: {
categoryTitle: '💾 Herramientas de copia de seguridad y restauración',
tools: [
{ toolName: 'create_backup', description: 'Crea una instantánea ZIP comprimida de todo el directorio de trabajo en .ai_toolbox_backups/ (requiere confirm=true)', parameters: ['confirm, destination/targetDirectory (opcional)'] },
{ toolName: 'list_backups', description: 'Lista copias de seguridad ordenadas por fecha o tamaño con nombre, ruta, tamaño y marca de creación', parameters: ['sortBy/limit (opcional)'] },
{ toolName: 'restore_backup', description: 'Restaura el directorio de trabajo desde un archivo de copia (⚠️ sobrescribe todos los archivos; requiere confirm=true)', parameters: ['backupFile, confirm'] },
{ toolName: 'delete_backup', description: 'Elimina un archivo de copia específico (⚠️ irreversible; valida existencia primero)', parameters: ['backupFile, confirm'] },
{ toolName: 'cleanup_backups', description: 'Lista y opcionalmente elimina copias .bak de edición — dry-run por defecto, se requiere confirmación para eliminar', parameters: ['confirm (opcional)'] },
{ toolName: 'restore_from_bak', description: 'Restaura un archivo desde su copia de seguridad .bak creada por herramientas de modificación de archivos (replace_text_in_file, insert_at_line, append_file, delete_lines_in_file)', parameters: ['file_name'] },
{ toolName: 'list_available_bak_backups', description: 'Escanea el directorio de trabajo actual en busca de todos los archivos .bak creados por herramientas de modificación de archivos; consulta disponible antes de restaurar', parameters: [] },
],
},
dataVisualization: {
categoryTitle: '📈 Herramientas de visualización de datos',
tools: [
{ toolName: 'generate_chart', description: 'Renderiza gráficos bar/line/pie/doughnut/scatter/radar a imagen PNG desde datos crudos; fallback HTML cuando el renderizador no está disponible', parameters: ['type, data (+ title/colors/output_path optional)'] },
],
},
// ── UNIFIED LANGUAGE v2 (26.10): textos de prompt en runtime. S4 (<SYSTEM_INSTRUCTION>) es
// NEUTRAL por diseño y se mantiene byte-identico en TODAS las locales (solo con GO del owner). ──
runtimeTexts: {
workingDirDetected: '⚠️ DIRECTORIO DE TRABAJO DETECTADO',
workingDirMentionedLine: 'El usuario mencionó una ruta de directorio en su mensaje:',
workingDirConfirmAsk: 'Pide al usuario confirmación antes de cambiar el directorio de trabajo.',
workingDirExampleLabel: 'Respuesta de ejemplo:',
// Espacios finales tras ". " y "? " replican la estructura de la plantilla en (una frase por línea).
workingDirExampleText: "He visto que mencionas el directorio '{path}'. \n¿Quieres que lo establezca como tu directorio de trabajo? \nTodas las operaciones de archivos posteriores usarán este directorio como base.",
workingDirReplyHint: "Responde con '{yes}' para confirmar, o con '{no}' para rechazar.",
workingDirOriginalMessageLabel: 'Mensaje original del usuario:',
projectDetectedTitle: '⚠️ PROYECTO REGISTRADO DETECTADO',
projectFoundLead: 'He encontrado un proyecto registrado que coincide con tu mensaje:',
projectNameLabel: 'Proyecto: "{name}"',
projectPathLabel: 'Ruta: {path}',
projectSwitchQuestion: '¿Quieres que cambie tu directorio de trabajo a este proyecto?',
sessionMemoryLoadedTitle: '📋 MEMORIA DE SESIÓN CARGADA',
previousSessionLabel: 'Resumen de la sesión anterior:',
// S4 — deliberadamente neutral (byte-identico en todas las locales, veredicto del owner 06.10)
checkpointWarningHeader: 'TOKEN LIMIT WARNING — ACKNOWLEDGE BEFORE RESPONDING:',
checkpointActionRequiredLead: 'ACTION REQUIRED: Before responding to the user\'s message, explicitly acknowledge this token limit warning.',
checkpointIfConfirmedLine: 'If the user replied with one of the confirmation options shown in the warning above → trigger the context management save tool now.',
checkpointIfDeclinedLine: 'If the user declined or did NOT give a confirmation reply → ask them if they want to proceed with a context save.',
checkpointDoNotProceedLine: 'Do not proceed with normal conversation until this warning has been addressed.',
sessionWarningHead: '⚠️ ADVERTENCIA DE SESIÓN: Has alcanzado el {pct}% de tu límite de tokens. Se recomienda encarecidamente guardar la memoria de sesión antes de continuar.',
bufferedEventsLine: 'Eventos con seguimiento automático en buffer (se guardarán con el checkpoint): {count}',
contextSaveQuestion: "¿Quieres proceder con un guardado de contexto? Responde con '{yes}' para iniciar el guardado de memoria de sesión, o con '{no}' para continuar.",
attachedFilesTitle: '📎 ARCHIVOS ADJUNTOS DISPONIBLES:',
attachedFilesLead: 'Tienes acceso a los siguientes archivos adjuntos. Puedes leerlos usando la herramienta read_document por nombre de archivo:',
// Cita el título del banner EN a propósito — documentTools.ts referencia esa cadena exacta (contrato).
attachmentErrorCrossRef: "Nota: si este es un archivo adjunto, usa el nombre exacto de la lista \"ATTACHED FILES AVAILABLE\".",
ragContextHeader: '--- CONTEXTO DE DOCUMENTOS RELEVANTES ---',
answerLanguageLine: 'Responde al usuario en {language}.',
},
// ── UNIFIED LANGUAGE v2 (26.10): etiquetas del panel de configuración — horneadas en el arranque. ──
uiLabels: {
languageRow: {
displayName: '🌐 Idioma',
options: { auto: 'Automático (sigue a LM Studio)', en: 'English', de: 'Deutsch (Alemán)', es: 'Español', zhCN: 'Chino simplificado', zhTW: 'Chino tradicional' },
},
godMode: { displayName: '⚡⚠️ GOD MODE - ACTIVAR TODAS LAS HERRAMIENTAS ⚠️⚡', subtitle: 'AVISO: Activa todas las categorías de herramientas al instante. Úsalo con precaución.', hint: 'Cuando está activado, SE OMITEN todos los interruptores individuales y cada herramienta se activa sin importar la configuración.' },
fileSystem: { displayName: '📁 Herramientas de Sistema de Archivos', hint: 'Activar operaciones de lectura/escritura/búsqueda de archivos' },
webSearch: { displayName: '🌐 Herramientas Web & Investigación', hint: 'Activar búsqueda DuckDuckGo/Wikipedia' },
packageManage: { displayName: 'Herramientas de Gestión de Paquetes', subtitle: 'Operaciones npm/pip/cargo', hint: 'Activar herramientas del gestor de paquetes. Desactivadas por defecto por seguridad.' },
gitOperations: { displayName: '🐙 Herramientas Git & GitHub', subtitle: 'Control de versionado & API', hint: 'Activar operaciones de git y acceso a la API de GitHub.' },
gitAutoCommit: { displayName: '💾 Auto-Commit de Git', subtitle: '⚙️ Parte de Herramientas Git & GitHub', hint: 'Commitea los cambios automáticamente tras las operaciones' },
defaultBranch: { displayName: '🌿 Rama Predeterminada', subtitle: '⚙️ Parte de Herramientas Git & GitHub', hint: 'Nombre de rama para nuevos repositorios y operaciones de git' },
databaseQueries: { displayName: '🗄️ Consultas a Base de Datos', hint: 'Activar consultas SQLite solo de lectura' },
documentParsing: { displayName: '📄 Análisis de Documentos', hint: 'Activar lectura de documentos PDF/DOCX' },
backgroundCommands: { displayName: '⏳ Comandos en Segundo Plano', hint: 'Activar seguimiento de procesos de larga duración' },
imageProcessing: { displayName: '🖼️ Herramientas de Procesamiento de Imágenes', subtitle: 'OCR, Capturas y Comparación', hint: 'Activar OCR de imágenes (Tesseract.js), captura de pantalla y herramientas de comparación de imágenes.' },
httpClient: { displayName: '🔌 Herramientas de Cliente HTTP', subtitle: 'Cliente REST genérico', hint: 'Activar cliente HTTP genérico para hacer peticiones a cualquier API REST (GET, POST, PUT, DELETE).' },
vectorRag: { displayName: '📊 Vector RAG / Búsqueda Semántica', subtitle: 'Búsqueda semántica de documentos', hint: 'Activar búsqueda semántica con embeddings vectoriales para la recuperación inteligente de documentos.' },
uiGeneration: { displayName: '🎨 Herramientas de Generación Interactiva de UI', subtitle: 'Generar y renderizar componentes de UI interactivos', hint: 'Activar herramientas para generar componentes HTML/CSS/JS (botones, formularios, gráficos, paneles) y renderizarlos en el navegador.' },
contextManagement: { displayName: '🧠 Herramientas de Gestión Automática de Contexto', subtitle: 'Seguimiento automático de sesiones y gestión de memoria', hint: 'Activar herramientas para guardar automáticamente decisiones importantes, patrones y configuraciones en la memoria persistente.' },
documentRAG: { displayName: '📚 Document RAG / Chat con Archivos', subtitle: 'Activar indexación de archivos y búsqueda semántica para el chat', hint: 'Adjunta documentos a tus mensajes de chat. El plugin recuperará automáticamente contenido relevante de los archivos adjuntos mediante búsqueda semántica.' },
textProcessing: { displayName: '📝 Herramientas de Procesamiento de Texto (equivalentes sed/awk)', subtitle: 'Transformaciones de texto basadas en regex y extracción de campos', hint: 'Activar herramientas para sustitución masiva de texto, coincidencia de patrones y extracción estructurada de datos sin dependencias de shell.' },
refactorCode: { displayName: '🔧 Herramientas de Refactorización AST de Código', subtitle: 'Renombrar, mover, extraer funciones y limpiar imports no usados', hint: 'Activar herramientas de refactorización de código basadas en AST (rename_identifier, move_function, extract_function, unused_import_cleanup).' },
utility: { displayName: '🛠️ Herramientas de Utilidad y Mantenimiento', subtitle: 'Copias de seguridad, generación de gráficos, vista previa de markdown, operaciones de líneas', hint: 'Activar herramientas utilitarias (create_backup, list_backups, restore_backup, delete_backup, cleanup_backups, generate_chart, markdown_preview).' },
taskPlanning: { displayName: '📋 Herramientas de Planificación de Tareas', subtitle: 'Herramientas de flujo de trabajo multinivel estructuradas', hint: 'Activar create_plan, update_plan_step y get_plan para la ejecución estructurada de tareas.' },
clusterAwareToolOrder: { displayName: '🧭 Orden de Herramientas con Conciencia de Clústeres', subtitle: 'Ordena las herramientas expuestas por nivel de prioridad + centralidad del módulo en lugar de alfabéticamente.', hint: 'Usa el grafo de dependencias estático de ARCHITECTURE.md (sin E/S de fs). Desactívalo para restaurar el orden alfabético legacy.' },
retrievalLimit: { displayName: '🔢 Límite de Recuperación', subtitle: 'Máx. de chunks por consulta', hint: 'Número máximo de chunks relevantes de documentos que se recuperarán por cada consulta.' },
retrievalAffinityThreshold: { displayName: '🎯 Umbral de Afinidad de Recuperación', subtitle: 'Puntuación mínima de relevancia (0-1)', hint: 'Los chunks por debajo de esta puntuación de similitud se filtrarán. Más bajo = más resultados, pero potencialmente menos relevantes.' },
executionJavaScript: { displayName: '⚡ Permitir Ejecución de JavaScript', subtitle: "Habilita la herramienta 'run_javascript'", hint: 'AVISO: el código se ejecuta en tu máquina.' },
executionPython: { displayName: '🐍 Permitir Ejecución de Python', subtitle: "Habilita la herramienta 'run_python'", hint: 'AVISO: el código se ejecuta en tu máquina.' },
executionTerminal: { displayName: '💻 Permitir Ejecución de Terminal', subtitle: "Habilita la herramienta 'run_in_terminal'", hint: 'Abre ventanas de terminal reales.' },
executionShell: { displayName: '🔧 Permitir Ejecución de Comandos Shell', subtitle: "Habilita la herramienta 'execute_command'", hint: 'AVISO: los comandos se ejecutan en tu máquina.' },
executionTests: { displayName: '🧪 Permitir Ejecución de Pruebas', subtitle: "Habilita la herramienta 'run_tests'", hint: 'AVISO: ejecuta npm jest / pytest / go test — puede instalar paquetes y ejecutar código.' },
searchFallbackChain: { displayName: '🔍 Cadena de Recurrido de Búsqueda', hint: 'Motor de búsqueda primario. Reincide automáticamente en otros si no está disponible.' },
safesearch: { displayName: '🛡️ Búsqueda Segura', options: { off: 'Desactivada', moderate: 'Moderada', strict: 'Estricta' } },
browserAutomation: { displayName: '🖥️ Herramientas de Automatización del Navegador', subtitle: 'Control y automatización de navegador headless', hint: 'Activar automatización de navegador headless basada en Puppeteer para scraping web, pruebas e interacción con la interfaz.' },
browserTimeout: { displayName: '⏱️ Tiempo Límite del Navegador', subtitle: '⚙️ Parte de Herramientas de Automatización del Navegador', hint: 'Tiempo máximo (ms) que se espera en las operaciones del navegador antes de expirar.' },
headlessMode: { displayName: '👻 Modo Headless', subtitle: '⚙️ Parte de Herramientas de Automatización del Navegador', hint: 'Ejecutar el navegador sin interfaz gráfica (recomendado para automatización).' },
pathValidationEnabled: { displayName: '🔒 Validación de Rutas', hint: 'Prevenir ataques de traversía de directorios' },
binaryFileDetection: { displayName: '📁 Detección de Archivos Binarios', hint: 'Detectar archivos binarios mediante comprobación de byte nulo' },
regexReDoSProtection: { displayName: '🛡️ Protección ReDoS', hint: 'Proteger contra denegación de servicio por regex' },
statePersistenceEnabled: { displayName: '💽 Persistencia de Estado', hint: 'Persistir el estado de ejecución de herramientas entre sesiones' },
notificationsEnabled: { displayName: '🔔 Notificaciones de Escritorio', hint: 'Mostrar notificaciones del sistema' },
updateCheckEnabled: { displayName: '🔄 Comprobación de Actualizaciones del Plugin', subtitle: 'Comprobación silenciosa del .VERSION del hub de LM Studio — sin herramientas nuevas, sin permisos de SO', hint: "Una vez al día el plugin comprueba en silencio el archivo .VERSION publicado en el hub de LM Studio para detectar una versión estrictamente más nueva. Si existe, notifica mediante toast de escritorio (Notificaciones de Escritorio ACTIVADAS) o una sola línea en el chat (DESACTIVADAS). Silencioso cuando estás al día o con una versión descartada; el estado sobrevive a reinstalaciones." },
temporalAwareness: { displayName: '⏰ Conciencia Temporal', subtitle: 'Inyecta la fecha/hora actual en cada mensaje', hint: 'Permite que la IA sepa la hora actual.' },
dateFormatStyle: { displayName: '📅 Estilo de Formato de Fecha', options: { standard: 'Estándar ([Zeit: ...])', heuteIst: 'Modo HEUTE IST (Prominente)' } },
contextGuardEnabled: { displayName: '🧠 Gestión de Tokens de ContextGuard', subtitle: 'Compresión automática del historial y lectura inteligente', hint: 'Comprime automáticamente el historial de chat cuando se alcanza el límite de tokens. Habilita la lectura inteligente de archivos y el filtrado de salida de terminal.' },
contextGuardCompressionPercent: { displayName: '📊 Disparador de Compresión (% de la Ventana de Contexto)', subtitle: '⚙️ Ajuste de ContextGuard', hint: "La compresión del historial se dispara cuando el uso del contexto alcanza este porcentaje de la ventana de contexto del modelo activo. Si LM Studio informa la ventana real del modelo, se usa; de lo contrario aplica un respaldo integrado de 30k." },
contextGuardAgenticDensity: { displayName: '🔢 Densidad de Caracteres por Token (Agentico)', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Caracteres por token usados para estimar tokens desde la longitud en caracteres (mezcla agéntica de prosa + salida de herramientas; banda medida en vivo ~3,2-3,4 — el valor por defecto 3,6 es fijado por el owner por encima de esa banda). Mayor = contenido más denso = menos tokens estimados; menor estima más y dispara compactación antes.' },
contextGuardForceSummaryOnCompress: { displayName: '💾 Forzar Guardado de Memoria de Sesión Antes de Comprimir', subtitle: '⚙️ Ajuste de ContextGuard', hint: "Cuando el contexto alcanza tu disparador de compresión, se genera un resumen estructurado de la sesión (descripción de tarea, logros, tareas pendientes) con el Modelo de Resumen y se persiste ANTES de comprimir el historial. No fatal: ante cualquier fallo sigue ejecutándose el checkpoint de telemetría anterior." },
contextGuardSmartReading: { displayName: '🔍 Lectura Inteligente de Archivos', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Extrae palabras clave de las consultas del usuario para leer solo las partes relevantes de los archivos. Ahorra tokens y agiliza las respuestas.' },
contextGuardSummaryModel: { displayName: '🤖 Nombre del Modelo de Resumen', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Nombre del modelo de LM Studio usado para resumir el historial. Déjalo vacío para usar tu modelo de chat actual.' },
contextGuardTerminalFilterEnabled: { displayName: '📌 Filtrado de Salida de Terminal', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Trunca automáticamente las salidas largas de terminal para ahorrar tokens.' },
contextGuardTerminalFilterLength: { displayName: '📏 Longitud Máxima de Salida de Terminal', subtitle: '⚙️ Ajuste de ContextGuard', hint: 'Caracteres máximos antes de que la salida de terminal sea truncada y resumida.' },
compactionEnabled: { displayName: '✂️ Podado Pre-Resumen de Compactación', subtitle: '⚙️ Familia C de Compactación', hint: 'Antes de resumir el historial, los payloads de herramientas por encima del presupuesto en bytes se reemplazan por una vista previa de cabecera/cola más un localizador opaco; el resultado completo permanece almacenado literalmente en .ai_toolbox/compaction/.' },
compactionMaxResultBytes: { displayName: '📏 Tamaño Máx. del Resultado de Herramienta Antes del Podado (bytes)', subtitle: '⚙️ Familia C de Compactación', hint: 'Presupuesto en bytes por payload de resultado de herramienta en el historial de chat. Los resultados superiores se podan a vista previa + localizador antes del resumen (copia literal almacenada en disco).' },
contextUsageFooter: { displayName: '📊 Pie de Uso de Contexto en Resultados de Herramientas', subtitle: '⚙️ Conciencia del Límite del Lado LLM', hint: "Una vez que el uso proyectado del contexto supera la mitad de la ventana del modelo, cada resultado de herramienta gana un pie corto como [ctx ~48.3k/64k = 76%] — añadido a los resultados de cadena y como campo ctx_footer aditivo en resultados de objeto plano (cada herramienta registrada devuelve uno) — para que el modelo siempre vea el uso actual de tokens. A partir del >=90% se añade un aviso de límite cercano." },
autoTrackingEnabled: { displayName: '🤖 Seguimiento Automático Activado', subtitle: 'Recuerda eventos importantes automáticamente', hint: 'Sigue en segundo plano, en silencio, decisiones, completados y correcciones de errores. Activado por defecto.' },
autoTrackTokenThreshold: { displayName: 'Umbral de Tokens del Auto-Seguimiento', subtitle: 'Ajuste de Auto-Seguimiento', hint: 'Dispara el guardado de memoria de sesión cuando el uso de tokens alcanza este porcentaje (por defecto: 75%). Ayuda a prevenir desbordes de contexto.' },
autoTrackDecisions: { displayName: '📌 Seguir Decisiones Automáticamente', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Detecta frases como "he decidido", "conclusión", "vamos con".' },
autoTrackCompletions: { displayName: '✅ Seguir Completados Automáticamente', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Detecta frases como "completado con éxito", "implementación terminada".' },
autoTrackErrors: { displayName: '🐛 Seguir Correcciones de Errores Automáticamente', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Detecta frases como "corregido el error", "resuelto el problema".' },
autoSummaryInterval: { displayName: '📊 Intervalo de Resumen de Sesión', subtitle: '⚙️ Ajuste de Auto-Seguimiento', hint: 'Número de mensajes entre resúmenes automáticos de sesión. Mayor = menos frecuente.' },
// Budget-Guard-Arc i18n (06.11, regla del owner "todas las descripciones SIEMPRE traducidas"): el fallback EN de config.ts sigue byte-pinned.
budgetGuardEnabled: { displayName: '🛡️ Budget Guard (protección del límite de contexto)', hint: 'Interruptor maestro de la protección determinista de presupuesto de contexto — puerta M1 pre-lectura, tope M2 de spill consciente del presupuesto, auto-persistencia M3 en el borde del 85 %. Activado por defecto (06.11); desactívalo para restaurar el comportamiento legacy idéntico byte a byte.' },
budgetGuardAdvisoryThresholdPct: { displayName: '🔢 Umbral de aviso Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'Puerta M1 pre-lectura: por encima de este % del límite de contexto, las herramientas de lectura devuelven un aviso de presupuesto auto-descrito en vez del volcado completo.' },
budgetGuardSpillThresholdPct: { displayName: '✂️ Umbral de spill Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'Tope M2: los resultados de herramienta se vierten a disco más allá de este % del límite (gana la cota más estricta: absoluta vs. relativa al presupuesto).' },
budgetGuardAutopauseThresholdPct: { displayName: '💾 Borde de auto-persistencia Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'M3: persistencia automática de la memoria de sesión en este borde de %, máximo una vez por sesión.' },
budgetGuardSafetyMarginPct: { displayName: '🧮 Margen de seguridad Budget Guard (%)', subtitle: '⚙️ Ajuste de Budget Guard', hint: 'Reserva retenida fuera del límite de contexto para el cálculo M2 — límite × (1 − margen/100); defecto 8 ⇒ spill al 92 %.' },
},
general: {
pluginName: 'Complemento AI Toolbox',
enabledTools: 'Herramientas habilitadas:',
disabledTools: 'Herramientas deshabilitadas:',
errorPrefix: 'Error:',
successPrefix: 'Éxito:',
yesWord: 'SÍ',
noWord: 'NO',
},
};