cc-viewer 1.6.182 → 1.6.183

package/concepts/es/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## Definición
+Busca contenido de archivos usando el motor ripgrep. Ofrece soporte completo de expresiones regulares, filtrado por tipo de archivo y tres modos de salida para que puedas intercambiar precisión por compacidad.
 
-Potente herramienta de búsqueda de contenido basada en ripgrep. Soporta expresiones regulares, filtrado por tipo de archivo y múltiples modos de salida.
+## Cuándo usar
+
+- Localizar cada sitio de llamada de una función o cada referencia a un identificador
+- Verificar si una cadena o mensaje de error aparece en algún lugar del código
+- Contar apariciones de un patrón para calibrar el impacto antes de refactorizar
+- Estrechar una búsqueda a un tipo de archivo (`type: "ts"`) o glob (`glob: "**/*.tsx"`)
+- Extraer coincidencias que abarcan varias líneas, como definiciones de struct multilínea o bloques JSX, con `multiline: true`
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `pattern` | string | Sí | Patrón de búsqueda con expresión regular |
-| `path` | string | No | Ruta de búsqueda (archivo o directorio), por defecto el directorio de trabajo actual |
-| `glob` | string | No | Filtro de nombre de archivo (como `*.js`, `*.{ts,tsx}`) |
-| `type` | string | No | Filtro de tipo de archivo (como `js`, `py`, `rust`), más eficiente que glob |
-| `output_mode` | enum | No | Modo de salida: `files_with_matches` (por defecto), `content`, `count` |
-| `-i` | boolean | No | Búsqueda insensible a mayúsculas/minúsculas |
-| `-n` | boolean | No | Mostrar números de línea (solo modo content), por defecto true |
-| `-A` | number | No | Número de líneas a mostrar después de la coincidencia |
-| `-B` | number | No | Número de líneas a mostrar antes de la coincidencia |
-| `-C` / `context` | number | No | Número de líneas a mostrar antes y después de la coincidencia |
-| `head_limit` | number | No | Limitar el número de entradas de salida, por defecto 0 (ilimitado) |
-| `offset` | number | No | Omitir los primeros N resultados |
-| `multiline` | boolean | No | Habilitar modo de coincidencia multilínea, por defecto false |
-
-## Casos de uso
-
-**Adecuado para:**
-- Buscar cadenas o patrones específicos en la base de código
-- Encontrar ubicaciones de uso de funciones/variables
-- Filtrar resultados de búsqueda por tipo de archivo
-- Contar el número de coincidencias
-
-**No adecuado para:**
-- Buscar archivos por nombre — usar Glob
-- Exploración abierta que requiere múltiples rondas de búsqueda — usar Task (tipo Explore)
+- `pattern` (string, obligatorio): La expresión regular a buscar. Usa la sintaxis de ripgrep, por lo que las llaves literales necesitan escape (por ejemplo `interface\{\}` para encontrar `interface{}`).
+- `path` (string, opcional): Archivo o directorio donde buscar. Por defecto, el directorio de trabajo actual.
+- `glob` (string, opcional): Filtro de nombre de archivo como `*.js` o `*.{ts,tsx}`.
+- `type` (string, opcional): Atajo de tipo de archivo como `js`, `py`, `rust`, `go`. Más eficiente que `glob` para lenguajes estándar.
+- `output_mode` (enum, opcional): `files_with_matches` (por defecto, devuelve solo rutas), `content` (devuelve las líneas coincidentes) o `count` (devuelve conteos de coincidencias).
+- `-i` (boolean, opcional): Coincidencia insensible a mayúsculas/minúsculas.
+- `-n` (boolean, opcional): Incluye números de línea en modo `content`. Por defecto es `true`.
+- `-A` (number, opcional): Líneas de contexto a mostrar después de cada coincidencia (requiere modo `content`).
+- `-B` (number, opcional): Líneas de contexto antes de cada coincidencia (requiere modo `content`).
+- `-C` / `context` (number, opcional): Líneas de contexto a ambos lados de cada coincidencia.
+- `multiline` (boolean, opcional): Permite que los patrones abarquen saltos de línea (`.` coincide con `\n`). Por defecto `false`.
+- `head_limit` (number, opcional): Limita las líneas, rutas de archivo o entradas de conteo devueltas. Por defecto 250; pasa `0` para ilimitado (úsalo con moderación).
+- `offset` (number, opcional): Omite los primeros N resultados antes de aplicar `head_limit`. Por defecto `0`.
+
+## Ejemplos
+
+### Ejemplo 1: Encontrar todos los sitios de llamada de una función
+Establece `pattern: "registerHandler\\("`, `output_mode: "content"` y `-C: 2` para ver las líneas circundantes de cada llamada.
+
+### Ejemplo 2: Contar coincidencias por tipo
+Establece `pattern: "TODO"`, `type: "py"` y `output_mode: "count"` para ver los totales de TODO por archivo en las fuentes Python.
+
+### Ejemplo 3: Coincidencia de struct multilínea
+Usa `pattern: "struct Config \\{[\\s\\S]*?version"` con `multiline: true` para capturar un campo declarado varias líneas dentro de un struct de Go.
 
 ## Notas
 
-- Usa sintaxis ripgrep (no grep), los caracteres especiales como llaves necesitan escape
-- El modo `files_with_matches` solo devuelve rutas de archivos, es el más eficiente
-- El modo `content` devuelve el contenido de las líneas coincidentes, soporta líneas de contexto
-- La coincidencia multilínea requiere establecer `multiline: true`
-- Siempre preferir usar la herramienta Grep en lugar de los comandos `grep` o `rg` en Bash
-
-## Texto original
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- Siempre prefiere `Grep` sobre ejecutar `grep` o `rg` a través de `Bash`; la herramienta está optimizada para permisos correctos y salida estructurada.
+- El modo de salida por defecto es `files_with_matches`, que es el más económico. Cambia a `content` solo cuando necesites ver las líneas en sí.
+- Los flags de contexto (`-A`, `-B`, `-C`) son ignorados a menos que `output_mode` sea `content`.
+- Los grandes conjuntos de resultados consumen tokens de contexto. Usa `head_limit`, `offset` o filtros `glob`/`type` más ajustados para mantener el enfoque.
+- Para descubrir nombres de archivo, usa `Glob`; para investigaciones abiertas que abarcan muchas rondas, despacha una `Agent` con el agente Explore.

package/concepts/es/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+Inicia un monitor en segundo plano que transmite eventos desde un script de larga ejecución. Cada línea de la salida estándar se convierte en una notificación — sigue trabajando mientras los eventos llegan al chat.
+
+## Cuándo usar
+
+- Seguir errores, advertencias o firmas de fallos en un archivo de registro mientras se ejecuta un despliegue
+- Sondear una API remota, un PR o un pipeline de CI cada 30 segundos para detectar nuevos eventos de estado
+- Vigilar cambios en un directorio del sistema de archivos o en la salida de compilación en tiempo real
+- Esperar una condición específica a lo largo de muchas iteraciones (por ejemplo, un hito de paso de entrenamiento o el vaciado de una cola)
+- **No** para un simple "esperar hasta que termine" — usar `Bash` con `run_in_background` para eso; emite una notificación de finalización cuando el proceso termina
+
+## Parámetros
+
+- `command` (cadena, obligatorio): El comando de shell o script a ejecutar. Cada línea escrita en la salida estándar se convierte en un evento de notificación independiente. El monitor termina cuando el proceso sale.
+- `description` (cadena, obligatorio): Una etiqueta corta y legible que se muestra en cada notificación. Ser específico — "errores en deploy.log" es mejor que "viendo logs". Esta etiqueta identifica qué monitor se activó.
+- `timeout_ms` (número, predeterminado `300000`, máx `3600000`): Plazo de terminación forzada en milisegundos. Después de esta duración el proceso se termina. Se ignora cuando `persistent: true`.
+- `persistent` (booleano, predeterminado `false`): Cuando es `true`, el monitor se ejecuta durante toda la sesión sin tiempo de espera. Detenerlo explícitamente con `TaskStop`.
+
+## Ejemplos
+
+### Ejemplo 1: Seguir un archivo de registro en busca de errores y fallos
+
+Este ejemplo cubre todos los estados terminales: marcador de éxito, traceback, palabras clave de error comunes, terminación por OOM y salida inesperada del proceso.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+Usar `grep --line-buffered` en cada tubería. Sin él, el sistema operativo almacena en búfer la salida en bloques de 4 KB y los eventos pueden retrasarse minutos. El patrón de alternancia cubre tanto la ruta de éxito (`deployed`) como las rutas de fallo (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`). Un monitor que solo observa el marcador de éxito permanece silencioso durante un fallo — el silencio es idéntico a "aún en ejecución".
+
+### Ejemplo 2: Sondear una API remota cada 30 segundos
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` evita que un fallo de red transitorio finalice el bucle. Los intervalos de sondeo de 30 segundos o más son apropiados para las APIs remotas para evitar límites de tasa. Ajustar el patrón de grep para capturar tanto las respuestas de éxito como las de error, de modo que los errores del lado de la API no queden enmascarados por el silencio.
+
+## Notas
+
+- **Usar siempre `grep --line-buffered` en tuberías.** Sin él, el búfer de la tubería retrasa los eventos minutos porque el sistema operativo acumula la salida hasta llenar un bloque de 4 KB. `--line-buffered` fuerza un vaciado después de cada línea.
+- **El filtro debe cubrir tanto las firmas de éxito como las de fallo.** Un monitor que solo observa el marcador de éxito permanece silencioso ante un fallo, un cuelgue o una salida inesperada. Ampliar la alternancia: incluir `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` y marcadores de estado terminal similares junto a la palabra clave de éxito.
+- **Intervalos de sondeo: 30 segundos o más para APIs remotas.** El sondeo frecuente de servicios externos arriesga errores de límite de tasa o bloqueos. Para verificaciones locales de sistema de archivos o procesos, 0,5–1 segundo es apropiado.
+- **Usar `persistent: true` para monitores de toda la sesión.** El `timeout_ms` predeterminado de 300.000 ms (5 minutos) termina el proceso. Para monitores que deben ejecutarse hasta ser detenidos explícitamente, establecer `persistent: true` y llamar a `TaskStop` cuando se termine.
+- **Parada automática ante inundación de eventos.** Cada línea de la salida estándar es un mensaje de conversación. Si el filtro es demasiado amplio y produce demasiados eventos, el monitor se detiene automáticamente. Reiniciar con un patrón `grep` más estricto. Las líneas que llegan en 200 ms se agrupan en una sola notificación.

package/concepts/es/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## Definición
+Modifica una sola celda en un notebook de Jupyter (`.ipynb`). Permite reemplazar el código fuente de una celda, insertar una nueva celda o eliminar una celda existente preservando el resto de la estructura del notebook.
 
-Reemplaza, inserta o elimina celdas específicas en un Jupyter notebook (archivo .ipynb).
+## Cuándo usar
+
+- Corregir o actualizar una celda de código en un notebook de análisis sin reescribir todo el archivo
+- Sustituir una celda markdown para mejorar la narrativa o añadir documentación
+- Insertar una nueva celda de código o markdown en una posición conocida dentro de un notebook existente
+- Eliminar una celda obsoleta o defectuosa para que las celdas posteriores ya no dependan de ella
+- Preparar un notebook reproducible iterando sobre las celdas una a la vez
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `notebook_path` | string | Sí | Ruta absoluta del archivo notebook |
-| `new_source` | string | Sí | Nuevo contenido de la celda |
-| `cell_id` | string | No | ID de la celda a editar. En modo inserción, la nueva celda se inserta después de este ID |
-| `cell_type` | enum | No | Tipo de celda: `code` o `markdown`. Requerido en modo inserción |
-| `edit_mode` | enum | No | Modo de edición: `replace` (por defecto), `insert`, `delete` |
+- `notebook_path` (string, obligatorio): Ruta absoluta al archivo `.ipynb`. Las rutas relativas son rechazadas.
+- `new_source` (string, obligatorio): El nuevo código fuente de la celda. Para `replace` e `insert` se convierte en el cuerpo de la celda; para `delete` se ignora pero sigue siendo requerido por el esquema.
+- `cell_id` (string, opcional): ID de la celda objetivo. En los modos `replace` y `delete`, la herramienta actúa sobre esta celda. En modo `insert`, la nueva celda se inserta inmediatamente después de la celda con este ID; omítelo para insertar al principio del notebook.
+- `cell_type` (enum, opcional): Ya sea `code` o `markdown`. Obligatorio cuando `edit_mode` es `insert`. Cuando se omite durante `replace`, se preserva el tipo existente de la celda.
+- `edit_mode` (enum, opcional): `replace` (por defecto), `insert` o `delete`.
 
-## Casos de uso
+## Ejemplos
 
-**Adecuado para:**
-- Modificar celdas de código o markdown en Jupyter notebooks
-- Agregar nuevas celdas a un notebook
-- Eliminar celdas de un notebook
+### Ejemplo 1: Reemplazar una celda de código con bug
+Llama a `NotebookEdit` con `notebook_path` establecido a la ruta absoluta, `cell_id` al ID de la celda objetivo y `new_source` conteniendo el código Python corregido. Deja `edit_mode` en su valor por defecto `replace`.
 
-## Notas
+### Ejemplo 2: Insertar una explicación markdown
+Para añadir una celda markdown justo después de una celda existente `setup`, establece `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id` al ID de la celda setup y pon la narrativa en `new_source`.
 
-- `cell_number` tiene índice base 0
-- El modo `insert` inserta una nueva celda en la posición especificada
-- El modo `delete` elimina la celda en la posición especificada
-- La ruta debe ser absoluta
+### Ejemplo 3: Eliminar una celda obsoleta
+Establece `edit_mode: "delete"` y proporciona el `cell_id` de la celda a eliminar. Proporciona cualquier cadena para `new_source`; no se aplica.
 
-## Texto original
+## Notas
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- Siempre pasa una ruta absoluta. `NotebookEdit` no resuelve rutas relativas contra el directorio de trabajo.
+- La herramienta reescribe solo la celda objetivo; los conteos de ejecución, salidas y metadatos de las celdas no relacionadas permanecen intactos.
+- Insertar sin un `cell_id` coloca la nueva celda al principio mismo del notebook.
+- `cell_type` es obligatorio para inserciones. Para reemplazos, omítelo salvo que explícitamente quieras convertir una celda de código a markdown o viceversa.
+- Para inspeccionar celdas y obtener sus IDs, usa primero la herramienta `Read` sobre el notebook; devuelve las celdas con su contenido y salidas.
+- Usa `Edit` normal para archivos de código fuente plano; `NotebookEdit` es específico para el JSON `.ipynb` y entiende su estructura de celdas.

package/concepts/es/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+Envía una notificación de escritorio desde la sesión actual de Claude Code. Si Remote Control está conectado, también envía la notificación al teléfono del usuario, atrayendo su atención desde donde esté de vuelta a la sesión.
+
+## Cuándo usar
+
+- Una tarea de larga duración finalizó mientras el usuario probablemente no estaba en el terminal
+- Una compilación, ejecución de pruebas o despliegue se completó y el resultado está listo para revisión
+- Se alcanzó un punto de decisión que requiere la entrada del usuario antes de poder continuar
+- Surgió un error o bloqueo que no se puede resolver de forma autónoma
+- El usuario solicitó explícitamente ser notificado cuando una tarea o condición específica se cumpla
+
+## Cuándo no usar
+
+No envíe una notificación para actualizaciones de progreso rutinarias durante una tarea, ni para confirmar que respondió algo que el usuario claramente acaba de preguntar y está esperando. No notifique cuando una tarea corta finaliza — si el usuario la acaba de enviar y está esperando, la notificación no aporta valor y erosiona la confianza en notificaciones futuras. Incline fuertemente hacia no enviarla.
+
+## Parámetros
+
+- `message` (cadena, obligatorio): el cuerpo de la notificación. Mantenga menos de 200 caracteres; los sistemas operativos móviles truncan cadenas más largas. Comience con lo que el usuario tomaría como acción: "build failed: 2 auth tests" es más útil que "task complete".
+- `status` (cadena, obligatorio): siempre establecer en `"proactive"`. Es un marcador fijo y no cambia.
+
+## Ejemplos
+
+### Ejemplo 1: notificar al completar un análisis largo
+
+Se solicitó una auditoría de dependencias de todo el repositorio que tardó varios minutos. El usuario se alejó. Cuando el informe está listo:
+
+```
+message: "Auditoría de dependencias lista: 3 CVEs de alta gravedad en lodash, axios, jsonwebtoken. Informe: audit-report.txt"
+status: "proactive"
+```
+
+### Ejemplo 2: marcar un punto de decisión durante trabajo autónomo
+
+Durante una refactorización de varios pasos, se descubre que dos módulos tienen interfaces en conflicto y no pueden fusionarse sin una decisión de diseño:
+
+```
+message: "Refactorización pausada: AuthService y UserService tienen interfaces de token en conflicto. Se necesita su decisión para continuar."
+status: "proactive"
+```
+
+## Notas
+
+- Incline hacia **no** enviar. La notificación interrumpe al usuario sin importar lo que esté haciendo. Trátela como un costo que debe justificarse con el valor de la información.
+- Comience con contenido procesable. Las primeras palabras deben indicar qué ocurrió y qué, si acaso, debe hacer el usuario — no una etiqueta de estado genérica.
+- Mantenga `message` bajo 200 caracteres. Los sistemas operativos móviles truncarán cadenas más largas, cortando la parte más importante si aparece al final.
+- Si el resultado indica que el push no fue enviado porque Remote Control no está conectado, ese es el comportamiento esperado. No se necesita reintento ni acción adicional; la notificación de escritorio local sigue disparándose.
+- Evite el spam de notificaciones. Si envía notificaciones frecuentemente por eventos menores, el usuario empezará a ignorarlas. Reserve esta herramienta para momentos en que haya una probabilidad real de que el usuario se haya alejado y quiera saber el resultado ahora.

package/concepts/es/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## Definición
+Carga el contenido de un solo archivo del sistema de archivos local. Soporta texto plano, código fuente, imágenes, PDFs y notebooks de Jupyter, devolviendo resultados con números de línea basados en 1 al estilo `cat -n`.
 
-Lee el contenido de archivos del sistema de archivos local. Soporta archivos de texto, imágenes, PDF y Jupyter notebook.
+## Cuándo usar
+
+- Leer un archivo fuente en una ruta conocida antes de editar o analizar
+- Inspeccionar archivos de configuración, lockfiles, registros o artefactos generados
+- Ver capturas de pantalla o diagramas que el usuario pegó en la conversación
+- Extraer un rango específico de páginas de un manual PDF largo
+- Abrir un notebook `.ipynb` para revisar celdas de código, markdown y salidas de celdas juntas
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `file_path` | string | Sí | Ruta absoluta del archivo |
-| `offset` | number | No | Número de línea inicial (para lectura segmentada de archivos grandes) |
-| `limit` | number | No | Número de líneas a leer (para lectura segmentada de archivos grandes) |
-| `pages` | string | No | Rango de páginas PDF (como "1-5", "3", "10-20"), solo aplicable a PDF |
+- `file_path` (string, obligatorio): Ruta absoluta al archivo objetivo. Las rutas relativas son rechazadas.
+- `offset` (integer, opcional): Número de línea basado en 1 desde el que empezar a leer. Útil para archivos grandes cuando se combina con `limit`.
+- `limit` (integer, opcional): Máximo número de líneas a devolver empezando en `offset`. Por defecto 2000 líneas desde la parte superior del archivo cuando se omite.
+- `pages` (string, opcional): Rango de páginas para archivos PDF, por ejemplo `"1-5"`, `"3"` o `"10-20"`. Obligatorio para PDFs de más de 10 páginas; máximo 20 páginas por solicitud.
+
+## Ejemplos
+
+### Ejemplo 1: Leer un archivo pequeño completo
+Llama a `Read` solo con `file_path` establecido a `/Users/me/project/src/index.ts`. Se devuelven hasta 2000 líneas con números de línea, lo que suele ser suficiente para el contexto de edición.
 
-## Casos de uso
+### Ejemplo 2: Paginar un registro largo
+Usa `offset: 5001` y `limit: 500` en un archivo de registro de varios miles de líneas para recuperar una ventana estrecha sin desperdiciar tokens de contexto.
 
-**Adecuado para:**
-- Leer archivos de código, archivos de configuración y otros archivos de texto
-- Ver archivos de imagen (Claude es un modelo multimodal)
-- Leer documentos PDF
-- Leer Jupyter notebooks (devuelve todas las celdas y salidas)
-- Leer múltiples archivos en paralelo para obtener contexto
+### Ejemplo 3: Extraer páginas específicas de PDF
+Para un PDF de 120 páginas en `/tmp/spec.pdf`, establece `pages: "8-15"` para extraer solo el capítulo que necesitas. Omitir `pages` en un PDF grande produce un error.
 
-**No adecuado para:**
-- Leer directorios — usar el comando `ls` de Bash
-- Exploración abierta de la base de código — usar Task (tipo Explore)
+### Ejemplo 4: Ver una imagen
+Pasa la ruta absoluta de una captura de pantalla PNG o JPG. La imagen se renderiza visualmente para que Claude Code pueda razonar directamente sobre ella.
 
 ## Notas
 
-- La ruta debe ser absoluta, no relativa
-- Por defecto lee las primeras 2000 líneas del archivo
-- Las líneas que excedan 2000 caracteres serán truncadas
-- La salida usa formato `cat -n`, los números de línea comienzan en 1
-- Los PDF grandes (más de 10 páginas) deben especificar el parámetro `pages`, máximo 20 páginas por vez
-- Leer un archivo inexistente devuelve un error (no se bloquea)
-- Se pueden hacer múltiples llamadas Read en paralelo en un solo mensaje
-
-## Texto original
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- Siempre prefiere rutas absolutas. Si el usuario proporciona una, confía en ella tal como está.
+- Las líneas de más de 2000 caracteres se truncan; trata el contenido devuelto como posiblemente recortado para datos extremadamente anchos.
+- ¿Leyendo varios archivos independientes? Emite varias llamadas `Read` en la misma respuesta para que se ejecuten en paralelo.
+- `Read` no puede listar directorios. Usa una llamada `ls` con `Bash` o la herramienta `Glob` en su lugar.
+- Leer un archivo existente pero vacío devuelve un recordatorio del sistema en lugar de los bytes del archivo, así que maneja esa señal explícitamente.
+- Un `Read` exitoso es requerido antes de poder usar `Edit` en el mismo archivo en la sesión actual.

package/concepts/es/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+Llama a la API de activadores remotos de claude.ai para gestionar la ejecución de tareas programadas y bajo demanda. El token OAuth se gestiona internamente por la herramienta y nunca se expone al modelo ni al shell.
+
+## Cuándo usar
+
+- Gestionar agentes remotos (activadores) en claude.ai, incluyendo listar, inspeccionar y actualizar los existentes
+- Crear una nueva tarea automatizada basada en cron que ejecute un agente de Claude según un calendario recurrente
+- Ejecutar un activador existente bajo demanda sin esperar a su próxima ejecución programada
+- Listar o auditar todos los activadores actuales para revisar su configuración y estado
+- Actualizar la configuración de un activador, como el calendario, la carga útil o la descripción, sin necesidad de recrearlo
+
+## Parámetros
+
+- `action` (string, requerido): la operación a realizar — uno de `list`, `get`, `create`, `update` o `run`
+- `trigger_id` (string, requerido para `get`, `update` y `run`): el identificador del activador sobre el que operar; debe coincidir con el patrón `^[\w-]+$` (solo caracteres de palabra y guiones)
+- `body` (object, requerido para `create` y `update`; opcional para `run`): la carga útil de la solicitud enviada a la API
+
+## Ejemplos
+
+### Ejemplo 1: listar todos los activadores
+
+```json
+{
+  "action": "list"
+}
+```
+
+Llama a `GET /v1/code/triggers` y devuelve un array JSON con todos los activadores asociados a la cuenta autenticada.
+
+### Ejemplo 2: crear un nuevo activador que se ejecute cada mañana de día laborable
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "Generar un resumen diario cada día laborable a las 08:00 UTC"
+  }
+}
+```
+
+Llama a `POST /v1/code/triggers` con el cuerpo proporcionado y devuelve el objeto del activador recién creado, incluyendo su `trigger_id` asignado.
+
+### Ejemplo 3: ejecutar un activador bajo demanda
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Llama inmediatamente a `POST /v1/code/triggers/my-report-trigger/run`, omitiendo la hora programada.
+
+### Ejemplo 4: obtener un activador individual
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Llama a `GET /v1/code/triggers/my-report-trigger` y devuelve la configuración completa del activador.
+
+## Notas
+
+- El token OAuth es inyectado en proceso por la herramienta — nunca copie, pegue ni registre tokens manualmente; hacerlo crea un riesgo de seguridad y es innecesario cuando se utiliza esta herramienta.
+- Prefiera esta herramienta sobre `curl` puro u otros clientes HTTP para todas las llamadas a la API de activadores; el uso directo de HTTP omite la inyección segura del token y puede exponer credenciales.
+- La herramienta devuelve la respuesta JSON sin procesar de la API; el llamador es responsable de analizar la respuesta y gestionar los códigos de estado de error.
+- El valor de `trigger_id` debe coincidir con el patrón `^[\w-]+$` — solo se permiten caracteres alfanuméricos, guiones bajos y guiones; los espacios o caracteres especiales harán que la solicitud falle.

package/concepts/es/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+Programa cuándo reanudar el trabajo en el modo dinámico `/loop`. La herramienta permite a Claude autogestionar el ritmo de las iteraciones de una tarea, durmiendo durante el intervalo elegido y luego disparándose nuevamente con el mismo prompt de bucle.
+
+## Cuándo usar
+
+- Al autogestionar el ritmo de una tarea dinámica `/loop` donde el intervalo de iteración depende del estado del trabajo en lugar de un reloj fijo
+- Al esperar a que finalice una compilación larga, despliegue o ejecución de pruebas antes de revisar los resultados
+- Al insertar ticks de inactividad entre iteraciones cuando no hay una señal específica que monitorear en este momento
+- Al ejecutar un bucle autónomo sin prompt del usuario — pasar el centinela literal `<<autonomous-loop-dynamic>>` como `prompt`
+- Al sondear un proceso cuyo estado está a punto de cambiar (usar un retraso corto para mantener el caché caliente)
+
+## Parámetros
+
+- `delaySeconds` (número, requerido): Segundos hasta la reanudación. El tiempo de ejecución limita automáticamente el valor a `[60, 3600]`, por lo que no es necesario limitarlo manualmente.
+- `reason` (cadena, requerido): Una frase corta que explica el retraso elegido. Se muestra al usuario y se registra en la telemetría. Sea específico — "verificando compilación larga de bun" es más útil que "esperando."
+- `prompt` (cadena, requerido): La entrada `/loop` que se disparará al despertar. Pasar la misma cadena en cada turno para que el siguiente disparo repita la tarea. Para un bucle autónomo sin prompt del usuario, pasar el centinela literal `<<autonomous-loop-dynamic>>`.
+
+## Ejemplos
+
+### Ejemplo 1: retraso corto para volver a verificar una señal que cambia rápidamente (mantener caché caliente)
+
+Una compilación acaba de iniciarse y normalmente termina en dos o tres minutos.
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "verificando compilación de bun que se espera termine en ~2 min",
+  "prompt": "verificar estado de compilación y reportar cualquier error"
+}
+```
+
+120 segundos mantiene el contexto de la conversación en el caché de prompts de Anthropic (TTL 5 min), por lo que el siguiente despertar es más rápido y económico.
+
+### Ejemplo 2: tick de inactividad largo (aceptar fallo de caché, amortizar en una espera más larga)
+
+Una migración de base de datos está en ejecución y normalmente tarda 20–40 minutos.
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "la migración suele tardar 20–40 min; verificando en 20 min",
+  "prompt": "verificar estado de migración y continuar si ha terminado"
+}
+```
+
+El caché estará frío al despertar, pero la espera de 20 minutos amortiza más que suficientemente el único fallo de caché. Sondear cada 5 minutos pagaría el mismo costo de fallo 4 veces sin ningún beneficio.
+
+## Notas
+
+- **TTL de caché de 5 minutos**: El caché de prompts de Anthropic expira después de 300 segundos. Los retrasos por debajo de 300 s mantienen el contexto caliente; los retrasos por encima de 300 s incurren en un fallo de caché en el siguiente despertar.
+- **Evitar exactamente 300 s**: Es lo peor de ambos mundos — se paga el fallo de caché sin obtener una espera significativamente más larga. Reducir a 270 s (mantener caché caliente) o comprometerse con 1200 s o más (un fallo compra una espera mucho más larga).
+- **Valor predeterminado para ticks de inactividad**: Cuando no hay una señal específica que monitorear, usar **1200–1800 s** (20–30 min). Esto permite que el bucle verifique periódicamente sin quemar el caché 12 veces por hora sin razón.
+- **Limitación automática**: El tiempo de ejecución limita `delaySeconds` a `[60, 3600]`. Los valores por debajo de 60 se convierten en 60; los valores por encima de 3600 se convierten en 3600. No es necesario gestionar estos límites manualmente.
+- **Omitir la llamada para terminar el bucle**: Si se pretende detener las iteraciones, no llamar a ScheduleWakeup. Simplemente omitir la llamada termina el bucle.
+- **Pasar el mismo `prompt` en cada turno**: El campo `prompt` debe llevar la instrucción `/loop` original en cada invocación para que el siguiente despertar sepa qué tarea reanudar.

package/concepts/es/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## Definición
+Entrega un mensaje de un miembro del equipo a otro dentro de un equipo activo, o hace un broadcast a todos los compañeros a la vez. Este es el único canal que los compañeros pueden escuchar — cualquier cosa escrita en la salida de texto normal es invisible para ellos.
 
-Envía mensajes entre agentes dentro de un equipo. Se utiliza para comunicación directa, difusión y mensajes de protocolo (solicitudes/respuestas de apagado, aprobación de planes).
+## Cuándo usar
+
+- Asignar una tarea o delegar un subproblema a un compañero con nombre durante la colaboración en equipo.
+- Solicitar estado, hallazgos intermedios o una revisión de código a otro agente.
+- Hacer broadcast de una decisión, restricción compartida o anuncio de apagado a todo el equipo mediante `*`.
+- Responder a un prompt de protocolo como una solicitud de apagado o una solicitud de aprobación de plan del líder del equipo.
+- Cerrar el ciclo al final de una tarea delegada para que el líder pueda marcar el elemento como completo.
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `to` | string | Sí | Destinatario: nombre del compañero, o `"*"` para difundir a todos |
-| `message` | string / object | Sí | Mensaje de texto o objeto de protocolo estructurado |
-| `summary` | string | No | Vista previa de 5-10 palabras mostrada en la interfaz |
+- `to` (string, obligatorio): El `name` del compañero objetivo según esté registrado en el equipo, o `*` para hacer broadcast a todos los compañeros a la vez.
+- `message` (string u objeto, obligatorio): Texto plano para comunicación normal, o un objeto estructurado para respuestas de protocolo como `shutdown_response` y `plan_approval_response`.
+- `summary` (string, opcional): Una vista previa de 5 a 10 palabras mostrada en el registro de actividad del equipo para mensajes de texto plano. Obligatorio para mensajes de cadena largos; se ignora cuando `message` es un objeto de protocolo.
+
+## Ejemplos
+
+### Ejemplo 1: Delegación directa de tarea
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## Tipos de mensaje
+### Ejemplo 2: Broadcast de una restricción compartida
 
-### Texto plano
-Mensajes directos entre compañeros de equipo para coordinación, actualizaciones de estado y discusiones sobre tareas.
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### Solicitud de apagado
-Solicita a un compañero que se apague de forma ordenada: `{ type: "shutdown_request", reason: "..." }`
+### Ejemplo 3: Respuesta de protocolo
 
-### Respuesta de apagado
-El compañero aprueba o rechaza el apagado: `{ type: "shutdown_response", approve: true/false }`
+Responde a una solicitud de apagado del líder usando un mensaje estructurado:
 
-### Respuesta de aprobación de plan
-Aprueba o rechaza el plan de un compañero: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## Difusión vs. Directo
+### Ejemplo 4: Respuesta de aprobación de plan
 
-- **Directo** (`to: "nombre-del-compañero"`): Enviar a un compañero específico — preferido para la mayoría de las comunicaciones
-- **Difusión** (`to: "*"`): Enviar a todos los compañeros — usar con moderación, solo para anuncios críticos a nivel de equipo
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## Herramientas relacionadas
+## Notas
 
-| Herramienta | Propósito |
-|-------------|-----------|
-| `TeamCreate` | Crear un nuevo equipo |
-| `TeamDelete` | Eliminar el equipo al finalizar |
-| `Agent` | Generar compañeros de equipo que se unen al equipo |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | Gestionar la lista de tareas compartida |
+- Tu salida de texto regular del asistente NO se transmite a los compañeros. Si quieres que otro agente vea algo, debe pasar por `SendMessage`. Este es el error más común en los flujos de trabajo de equipo.
+- El broadcast (`to: "*"`) es costoso — despierta a cada compañero y consume su contexto. Resérvalo para anuncios que realmente afecten a todos. Prefiere envíos dirigidos.
+- Mantén los mensajes concisos y orientados a la acción. Incluye las rutas de archivos, restricciones y formato de respuesta esperado que el destinatario necesita; recuerda que no tienen memoria compartida contigo.
+- Los objetos de mensaje de protocolo (`shutdown_response`, `plan_approval_response`) tienen formas fijas. No mezcles campos de protocolo en mensajes de texto plano ni viceversa.
+- Los mensajes son asíncronos. El destinatario recibirá el tuyo en su próximo turno; no asumas que lo ha leído o actuado hasta que responda.
+- Un `summary` bien escrito hace que el registro de actividad del equipo sea escaneable para el líder — trátalo como la línea de asunto de un commit.