cc-viewer 1.7.21 → 1.7.23

package/concepts/es/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+Gestiona documentos de proyecto en la base de conocimiento de proyectos de Claude del usuario: leer, buscar, escribir y eliminar documentos, u obtener información del proyecto.
+
+## Cuándo usar
+
+- Persistir un documento (entregable, notas, material de referencia) en el proyecto del usuario para que sobreviva a la sesión.
+- Leer o buscar documentos de proyecto existentes para fundamentar la tarea actual en contexto previo.
+- Subir un archivo local al proyecto sin cargar su contenido en el contexto.
+- Eliminar un documento de proyecto obsoleto.
+
+## Parámetros
+
+- `method` (string, obligatorio): Uno de `project_info`, `project_read`, `project_search`, `project_write`, `project_delete`.
+- `path` (string, opcional): Para `project_read`/`project_write`/`project_delete`: la ruta del documento. Para `project_write`: una ruta existente se reemplaza en su lugar; un nombre de archivo nuevo sin barra (sin "/") recibe el namespace `claude/<name>`.
+- `content` (string, opcional): Para `project_write`: texto del documento en línea. Mutuamente excluyente con `local_path`.
+- `local_path` (string, opcional): Para `project_write`: un archivo dentro del directorio de trabajo para subir — su contenido nunca entra en tu contexto. Mutuamente excluyente con `content`.
+- `present_to_user` (boolean, opcional): Para `project_write`: marca este documento como el entregable que el usuario necesita ver. Por defecto false; déjalo sin establecer para guardados rutinarios y escrituras en bloque.
+- `query` (string, opcional): Para `project_search`: consulta a la base de conocimiento.
+- `n` (number, opcional): Para `project_search`: número de resultados (por defecto 5).
+
+## Ejemplos
+
+### Ejemplo 1: Escribir el entregable en el proyecto
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+Sube el archivo local sin traer su contenido al contexto, y lo marca como el entregable del usuario.
+
+### Ejemplo 2: Buscar en la base de conocimiento
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## Notas
+
+- `content` es para texto que compones en línea; `local_path` es para cualquier cosa que ya esté en disco — nunca mezcles los dos.
+- Usa `present_to_user=true` con moderación: solo para el único documento que el usuario pidió o sobre el que debe actuar.

package/concepts/es/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+Propone una meta de finalización verificable para la sesión. La meta se muestra al usuario en un diálogo de aprobación (por defecto) y, una vez establecida, guía el resto de la conversación hacia un resultado comprobable.
+
+## Cuándo usar
+
+- La sesión tiene un estado final concreto que un evaluador podría verificar desde la conversación (p. ej. "all tests in test/auth pass").
+- Quieres la aprobación explícita del usuario sobre qué significa "hecho" antes de hacer trabajo sustancial.
+- Las propias palabras del usuario ya expresaron el resultado y quieres registrarlo como la meta de la sesión.
+
+## Activación
+
+- Desactivado por defecto (feature flag del lado del servidor).
+- Excluido de las sesiones interactivas y en segundo plano.
+- Se desactiva con la clave de configuración `modelProposedGoals: "disabled"`.
+
+## Parámetros
+
+- `condition` (string, obligatorio): La condición de finalización, escrita de modo que un evaluador separado pueda verificarla desde la conversación (p. ej. "all tests in test/auth pass (bun test exits 0)"). Máximo 500 caracteres — el usuario debe poder leer la condición completa en el diálogo de aprobación.
+- `ask_user` (boolean, opcional): Si preguntar al usuario su aprobación antes de establecer la meta. Por defecto true (se muestra un diálogo de aprobación). Ponlo en false SOLO cuando las propias palabras del usuario en esta conversación expresaron este resultado como lo que quiere; la meta se establece entonces directamente con un aviso visible, y el usuario puede limpiarla con `/goal clear`.
+
+## Ejemplos
+
+### Ejemplo 1: Proponer una meta respaldada por tests
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+El usuario ve la condición en un diálogo de aprobación y puede aceptarla, editarla o rechazarla.
+
+### Ejemplo 2: Adoptar directamente el resultado expresado por el usuario
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+Solo válido porque el usuario expresó explícitamente ese resultado antes en la conversación.
+
+## Notas
+
+- Mantén `condition` corta y objetivamente comprobable — metas vagas ("make it better") frustran el propósito.
+- `ask_user=false` está estrictamente limitado a resultados que el propio usuario expresó; cualquier otra cosa debe pasar por el diálogo de aprobación.

package/concepts/es/Tool-PushNotification.md

@@ -14,6 +14,12 @@ Envía una notificación de escritorio desde la sesión actual de Claude Code. S
 
 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.
 
+## Activación
+
+- Desactivado por defecto (feature flag del lado del servidor).
+- La entrega se realiza a través de infraestructura alojada por Anthropic — no disponible en Amazon Bedrock, Claude Platform on AWS, Google Cloud ni Microsoft Foundry.
+- El push al teléfono requiere además un cliente de Remote Control conectado.
+
 ## 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".

package/concepts/es/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+Ejecuta JavaScript en un contexto vm de Node.js persistente dentro de la sesión. Se admite `await` de nivel superior, y las variables/funciones definidas en una llamada siguen disponibles en llamadas posteriores.
+
+## Cuándo usar
+
+- Cálculo rápido, transformación de datos o manipulación de JSON que es más fácil en código que en one-liners de shell.
+- Scripting de múltiples pasos donde el estado intermedio debe persistir entre llamadas (contadores, resultados acumulados).
+- Probar interactivamente una API o el comportamiento de una librería antes de escribirlo en un archivo.
+
+## Activación
+
+- Desactivado por defecto — establece `CLAUDE_CODE_REPL=true` para habilitarlo.
+- En sesiones de terminal (`cli`) y claude.ai (`remote`), un feature flag del lado del servidor también puede habilitarlo.
+- Cuando está desactivado, REPL queda oculto de la lista de herramientas del modelo. Cuando está activado, `Read`, `Glob`, `Grep`, `Bash`, `PowerShell` y `NotebookEdit` se sustituyen por atajos de REPL.
+
+## Parámetros
+
+- `code` (string, obligatorio): Código JavaScript a ejecutar. Admite await de nivel superior. El estado persiste entre llamadas.
+- `description` (string, opcional): Descripción clara y concisa de lo que hace este script, en voz activa (5–10 palabras), p. ej. "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, opcional): Timeout en milisegundos. Por defecto 30000; máximo 600000.
+
+## Ejemplos
+
+### Ejemplo 1: Calcular y reutilizar estado
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+Devuelve `2`; `counts` permanece definida para llamadas REPL posteriores en la misma sesión.
+
+### Ejemplo 2: Await de nivel superior con un timeout más largo
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## Notas
+
+- El estado es por sesión: reiniciar la sesión borra todas las definiciones.
+- Esto es un entorno JavaScript (Node) — usa Bash para comandos shell, trabajo pesado de sistema de archivos o runtimes que no sean JS.
+- El código de larga ejecución debe establecer un `timeout` explícito; el valor por defecto de 30s interrumpe cualquier cosa más lenta.

package/concepts/es/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+Lee un único recurso expuesto por un servidor MCP (Model Context Protocol) conectado, direccionado por su URI.
+
+## Cuándo usar
+
+- Un servidor MCP anuncia un recurso (archivo, registro, documento) cuyo contenido necesitas en el contexto.
+- Tienes una URI de recurso concreta — de `ListMcpResources`, de la documentación del servidor o de un resultado de herramienta anterior.
+
+## Activación
+
+- Siempre habilitado, pero no expuesto en la lista de herramientas del modelo — pensado para uso thin-client / sidecar.
+
+## Parámetros
+
+- `server` (string, obligatorio): El nombre del servidor MCP.
+- `uri` (string, obligatorio): La URI del recurso a leer.
+
+## Ejemplos
+
+### Ejemplo 1: Leer un recurso de servidor por URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+Devuelve el contenido del recurso tal como lo proporciona el servidor MCP `github`.
+
+## Notas
+
+- Usa `ListMcpResources` primero si no sabes qué recursos expone un servidor; usa `ReadMcpResourceDir` para listados estilo directorio.
+- El esquema de URI es específico del servidor (`file://`, `https://`, esquemas personalizados) — comprueba lo que anuncia el servidor objetivo.

package/concepts/es/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+Lista las entradas de un recurso estilo directorio expuesto por un servidor MCP conectado, direccionado por su URI.
+
+## Cuándo usar
+
+- Un servidor MCP organiza los recursos jerárquicamente y necesitas enumerar un nivel de esa jerarquía.
+- Quieres explorar antes de leer recursos individuales con `ReadMcpResource`.
+
+## Activación
+
+- Siempre habilitado, pero no expuesto en la lista de herramientas del modelo — pensado para uso thin-client / sidecar.
+
+## Parámetros
+
+- `server` (string, obligatorio): El nombre del servidor MCP.
+- `uri` (string, obligatorio): La URI del recurso de directorio a listar.
+
+## Ejemplos
+
+### Ejemplo 1: Listar un directorio de recursos
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+Devuelve las entradas hijas que el servidor expone bajo esa URI de directorio.
+
+## Notas
+
+- Solo los servidores que modelan sus recursos como directorios admiten esto; los servidores planos devolverán un error o un listado vacío — recurre a `ListMcpResources`.
+- Combínalo con `ReadMcpResource` para profundizar en las entradas que parezcan relevantes.

package/concepts/es/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+Lee las notificaciones encoladas para el asistente en la sesión actual — actividad de GitHub en PRs suscritos (`github_webhook`), disparos de triggers programados (`trigger_fire`) y mensajes que llegan de otras sesiones de Claude (`mcp_send_message`).
+
+## Cuándo usar
+
+- Te notificaron que algo ocurrió — un PR suscrito se actualizó, un trigger programado se disparó, otra sesión te envió un mensaje — y necesitas el payload real.
+- Vaciar un backlog: los lotes grandes se devuelven en partes, así que sigue llamando hasta que el resultado reporte 0 `remaining`.
+
+## Parámetros
+
+Esta herramienta no toma parámetros.
+
+## Ejemplos
+
+### Ejemplo 1: Vaciar notificaciones pendientes
+
+```
+ReadNotifications()
+```
+
+Devuelve las notificaciones encoladas, las más antiguas primero. El resultado incluye un contador `remaining` de notificaciones aún encoladas después de este vaciado — vuelve a llamar a la herramienta para leerlas.
+
+## Notas
+
+- Los vaciados tienen un presupuesto de tamaño: una llamada de seguimiento devuelve el resto de la MISMA cola (más lo que haya llegado nuevo), no solo las nuevas llegadas. Itera hasta que `remaining` sea 0.
+- Las notificaciones se originan en webhooks de GitHub sobre PRs suscritos, triggers programados y mensajes de otras sesiones de Claude; no hay parámetro de filtrado en la versión actual.

package/concepts/es/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ Llama a la API de activadores remotos de claude.ai para gestionar la ejecución
 - 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
 
+## Activación
+
+- Requiere un plan Pro, Max, Team o Enterprise de claude.ai.
+- No disponible en Amazon Bedrock, Claude Platform on AWS, Google Cloud ni Microsoft Foundry.
+- Requiere feature flags del lado del servidor y los ajustes de política `allow_remote_sessions` / `allow_routines`.
+- No es para las propias sesiones remotas.
+
 ## Parámetros
 
 - `action` (string, requerido): la operación a realizar — uno de `list`, `get`, `create`, `update` o `run`

package/concepts/es/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@ Programa cuándo reanudar el trabajo en el modo dinámico `/loop`. La herramient
 - 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)
 
+## Activación
+
+- No disponible en Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform ni Microsoft Foundry.
+- También desactivado cuando la obtención de feature flags está deshabilitada (variables de entorno de telemetría/tráfico).
+
 ## 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.

package/concepts/es/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+Busca en el registro de conectores MCP por palabra clave para descubrir conectores que puedan ayudar a completar la tarea.
+
+## Cuándo usar
+
+- La tarea se beneficiaría de un servicio externo (una base de datos, un rastreador de issues, una API SaaS) y quieres comprobar si existe un conector MCP para él.
+- El usuario nombra un producto y pide conectarlo — busca en el registro un conector coincidente.
+
+## Activación
+
+- Solo disponible en sesiones remotas (claude.ai) en la API first-party.
+
+## Parámetros
+
+- `keywords` (array de strings, obligatorio): Frases de palabra clave que describen la intención del usuario o un producto nombrado. De 1 a 8 elementos, cada uno de 1 a 64 caracteres.
+
+## Ejemplos
+
+### Ejemplo 1: Encontrar un conector para un producto nombrado
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+Devuelve entradas del registro cuyos conectores coinciden con las palabras clave. Resuelve los detalles completos del conector con `SuggestConnectors`.
+
+## Notas
+
+- Solo lectura y seguro para concurrencia; los resultados están limitados en tamaño.
+- Buscar no instala nada — es puramente descubrimiento.

package/concepts/es/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+Envía feedback estructurado sobre Claude Code a Anthropic — reportes de errores, ideas de funcionalidades o capacidades faltantes — sin salir de la sesión.
+
+## Cuándo usar
+
+- El usuario pide reportar un bug o enviar feedback sobre Claude Code en sí.
+- Encuentras un defecto claro del producto (comando roto, comportamiento incorrecto, crash) que merece ser reportado.
+- El usuario describe una funcionalidad que le gustaría que existiera (una idea o capacidad faltante).
+
+## Parámetros
+
+- `type` (string, obligatorio): Uno de `bug`, `idea`, `missing_capability`.
+- `title` (string, obligatorio): Resumen corto y específico del problema en una sola línea.
+- `details` (string, obligatorio): Viñetas etiquetadas, en orden: **What happened:** (observado vs. esperado, texto exacto del error si es corto); **What the user said:** (citado, o "User didn't comment; observed by the model."); **Repro:** (pasos mínimos); **Evidence:** (request IDs, timestamps, rutas, versiones — omítelo si no hay); opcionalmente un **Cause:** final solo si se verificó en la sesión. De una a tres líneas por viñeta; sin párrafos narrativos, sin especulación, sin secretos.
+- `area` (string, opcional): Etiqueta corta que nombra la parte de Claude Code de la que trata (p. ej. "hooks config", "/help", "file editing"). Déjalo en blanco si no está claro.
+- `failure_mode` (string, opcional): Para reportes de comportamiento del modelo, el modo de fallo más cercano (p. ej. `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short`, o `other`). Omítelo solo cuando el reporte es un bug puro de producto/herramienta.
+- `task_category` (string, opcional): Qué estaba haciendo la sesión cuando ocurrió el problema: `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review`, o `other`.
+
+## Ejemplos
+
+### Ejemplo 1: Reportar un bug del producto
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## Notas
+
+- Nunca incluyas secretos, tokens o datos privados del usuario en `details`.
+- Cita las palabras del usuario cuando estén disponibles; de lo contrario, indica que el modelo observó el problema.
+- Mantén el reporte factual — la especulación sobre la causa raíz va en `**Cause:**` solo cuando se verificó en la sesión.

package/concepts/es/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+Envía uno o más archivos a otra sesión de Claude Code — una par listada por `ListAgents`, o una dirección de sesión explícita.
+
+## Cuándo usar
+
+- Una sesión par necesita un archivo de tu directorio de trabajo (un informe, un parche, un fixture) para continuar su propia tarea.
+- Estás coordinando trabajo entre sesiones y quieres entregar artefactos, no solo texto (usa `SendMessage` para texto).
+
+## Activación
+
+- La transferencia de archivos entre sesiones debe estar disponible en la sesión; cuando no lo está, la validación falla con "Cross-session file transfer is not available in this session."
+- Restringida por las mismas condiciones de mensajería entre sesiones que `ListAgents` (feature flags del lado del servidor, desactivados por defecto).
+
+## Parámetros
+
+- `to` (string, obligatorio): Destinatario — un nombre de sesión par de `ListAgents`, o una dirección explícita `uds:<socket>` / `bridge:<session id>`.
+- `files` (array de strings, obligatorio): Rutas de archivos (absolutas o relativas al directorio de trabajo actual) a enviar. Pasa siempre un array, incluso para un solo archivo. De 1 a 16 archivos, como máximo 30 MiB cada uno.
+- `message` (string, opcional): Mensaje corto entregado junto con los archivos.
+
+## Ejemplos
+
+### Ejemplo 1: Enviar un informe a una sesión par
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## Notas
+
+- Las transferencias a máquinas remotas pueden requerir aprobación adicional.
+- Leer el contenido de los archivos es parte del envío — se deniega si las lecturas de archivos están deshabilitadas por reglas de permisos.

package/concepts/es/Tool-SendMessage.md

@@ -10,6 +10,11 @@ Entrega un mensaje de un miembro del equipo a otro dentro de un equipo activo, o
 - 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.
 
+## Activación
+
+- Restringida por las mismas condiciones de mensajería entre sesiones que `ListAgents` (feature flags del lado del servidor, desactivados por defecto).
+- Los compañeros requieren además que los equipos de agentes experimentales estén habilitados.
+
 ## Parámetros
 
 - `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.

package/concepts/es/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+Envía uno o más archivos al usuario — artefactos generados, capturas de pantalla, informes — con control sobre cómo los presenta el cliente.
+
+## Cuándo usar
+
+- Produjiste un archivo que el usuario necesita (un informe, una imagen, una página HTML) y quieres hacerlo visible, no solo mencionar su ruta.
+- Responder con un adjunto (`status="normal"`), o hacer visible de forma proactiva algo que el usuario no ha pedido pero necesita ver ahora (`status="proactive"`).
+
+## Activación
+
+- Solo disponible cuando hay un cliente de Remote Control conectado, o cuando la sesión se ejecuta en un entorno de nube gestionado (p. ej. Claude Code en la web).
+- No disponible en Amazon Bedrock, Google Cloud ni Microsoft Foundry.
+- Requiere que la sesión permita enviar archivos (una capacidad restringida por configuración/función); no se ofrece en modo brief.
+
+## Parámetros
+
+- `files` (array de strings, obligatorio): Rutas de archivos (absolutas o relativas al directorio de trabajo actual) a enviar al usuario. Pasa siempre un array, incluso para un solo archivo.
+- `caption` (string, opcional): Leyenda corta para el/los archivo(s).
+- `status` (string, obligatorio): `proactive` al hacer visible un archivo que el usuario no ha pedido y necesita ver ahora — un artefacto generado, un informe completado; `normal` al responder a algo que el usuario acaba de decir.
+- `display` (string, opcional): `render` abre el archivo en línea en el panel lateral (HTML, SVG, Mermaid, imágenes, PDFs); `attach` muestra solo una tarjeta de descarga (entregables que el usuario guardará y abrirá en otro lugar). Omítelo para que el cliente decida por tipo de archivo.
+
+## Ejemplos
+
+### Ejemplo 1: Entregar un informe generado
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## Notas
+
+- Elige `display="attach"` para archivos que el usuario guarda y abre en otra aplicación; `render` para cualquier cosa que deba mirar de inmediato.

package/concepts/es/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+Envía un mensaje al usuario — el canal de salida visible principal en sesiones estilo brief. También conocido por su alias heredado `Brief`.
+
+## Cuándo usar
+
+- Responder a algo que el usuario acaba de decir (`status="normal"`).
+- Hacer visible de forma proactiva algo que el usuario no ha pedido y necesita ver ahora — una tarea que se completa mientras no está, un bloqueo con el que te topaste, una actualización de estado no solicitada (`status="proactive"`).
+
+## Activación
+
+- Oculto en sesiones interactivas por defecto; la mayoría de las sesiones CLI interactivas hablan directamente con el usuario en su lugar.
+- Habilitado en modo brief o mediante feature flags del lado del servidor.
+
+## Parámetros
+
+En modo brief:
+
+- `message` (string, obligatorio): El mensaje para el usuario. Admite formato markdown.
+- `attachments` (array, opcional): Adjuntos mostrados junto al mensaje. Cada entrada es una ruta de archivo (absoluta o relativa al directorio de trabajo actual) para un archivo legible localmente, o un objeto pre-resuelto `{file_uuid, file_name, size, is_image}` obtenido de una herramienta de dispositivo como `attach_file`.
+- `status` (string, obligatorio): `proactive` para actualizaciones no solicitadas que el usuario necesita ahora; `normal` al responder al usuario.
+
+En compilaciones sin modo brief solo está disponible `message`.
+
+## Ejemplos
+
+### Ejemplo 1: Aviso de finalización proactivo
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## Notas
+
+- Usa `proactive` con moderación — está pensado para cosas que genuinamente necesitan la atención del usuario ahora.

package/concepts/es/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+Resuelve los payloads completos de conectores para los valores `directoryUuid` devueltos por `SearchMcpRegistry`, para poder ofrecer al usuario conectores concretos que habilitar.
+
+## Cuándo usar
+
+- Después de que `SearchMcpRegistry` devuelva conectores candidatos, para obtener sus detalles completos y presentarlos.
+
+## Activación
+
+- Solo disponible en sesiones remotas (claude.ai) en la API first-party.
+
+## Parámetros
+
+- `uuids` (array de strings, obligatorio): Valores `directoryUuid` o `server_id` a resolver. De 1 a 32 elementos, cada uno de 1 a 64 caracteres.
+
+## Ejemplos
+
+### Ejemplo 1: Resolver dos resultados del registro
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## Notas
+
+- Nunca adivines UUIDs — solo resuelve identificadores que hayan venido de `SearchMcpRegistry`.
+- La herramienta no conecta nada por sí misma; habilitar un conector ocurre fuera de banda.

package/concepts/es/Tool-SuggestPluginInstall.md

@@ -0,0 +1,39 @@
+# SuggestPluginInstall
+
+Muestra una tarjeta de instalación de plugin en línea a partir de resultados de `SearchPlugins`, vinculando las sugerencias de plugins con la solicitud del usuario.
+
+## Cuándo usar
+
+- Una búsqueda de plugins hizo aflorar plugins que coinciden con lo que el usuario intenta hacer, y quieres ofrecerlos para su instalación.
+
+## Activación
+
+- Solo cuando hay un cliente de Remote Control conectado, o la sesión se ejecuta en un entorno de nube gestionado.
+- Deshabilitado bajo configuraciones empresariales HIPAA.
+- No en modo brief.
+
+## Parámetros
+
+- `contextLabel` (string, obligatorio): Encabezado corto que vincula la sugerencia con la solicitud del usuario (máximo 128 caracteres).
+- `plugins` (array, obligatorio): Plugins procedentes de resultados de `SearchPlugins` — de 1 a 16 entradas, cada una con:
+  - `pluginId` (string, obligatorio)
+  - `pluginName` (string, obligatorio)
+  - `description` (string, obligatorio)
+  - `skills` (array, opcional): Hasta 32 entradas `{name, description?}` que describen las skills del plugin.
+
+## Ejemplos
+
+### Ejemplo 1: Ofrecer un plugin coincidente
+
+```
+SuggestPluginInstall(
+  contextLabel="For reviewing pull requests",
+  plugins=[{pluginId="pr-toolkit", pluginName="PR Toolkit", description="Review helpers"}]
+)
+```
+
+La tarjeta se muestra al usuario; habilitar el plugin ocurre fuera de banda. Llama a `ListPlugins` en el seguimiento para descubrir qué se instaló realmente.
+
+## Notas
+
+- Solo incluye plugins que provengan de resultados de búsqueda — nunca inventes entradas de plugins.

package/concepts/es/Tool-SuggestSkills.md

@@ -0,0 +1,33 @@
+# SuggestSkills
+
+Muestra una tarjeta de skills independientes que el usuario puede añadir (skills que aún no están habilitadas), basada en palabras clave de tema.
+
+## Cuándo usar
+
+- La solicitud del usuario coincide con skills que no tiene habilitadas (`trigger="user_asked"` cuando las pidió, `trigger="proactive"` cuando la sugieres sin que te lo pidan).
+
+## Activación
+
+- Solo cuando hay un cliente de Remote Control conectado, o la sesión se ejecuta en un entorno de nube gestionado.
+- Deshabilitado bajo configuraciones empresariales HIPAA.
+- No en modo brief.
+
+## Parámetros
+
+- `keywords` (array de strings, obligatorio): Palabras clave de tema de la solicitud del usuario. De 1 a 8 elementos, cada uno de 1 a 64 caracteres.
+- `contextLabel` (string, opcional): Etiqueta corta que vincula la sugerencia con la solicitud (máximo 128 caracteres).
+- `trigger` (string, opcional): Cómo empezó esta sugerencia — `user_asked` o `proactive`.
+
+## Ejemplos
+
+### Ejemplo 1: Sugerir skills por tema
+
+```
+SuggestSkills(keywords=["data visualization", "charts"], contextLabel="For building the dashboard", trigger="user_asked")
+```
+
+Las skills ya habilitadas se filtran fuera del resultado.
+
+## Notas
+
+- Solo muestra una tarjeta de sugerencia — añadir una skill ocurre fuera de banda; llama a `ListSkills` después para confirmarlo.

package/concepts/es/Tool-TaskCreate.md

@@ -12,6 +12,12 @@ Crea una nueva tarea en la lista de tareas del equipo actual (o la lista de tare
 
 Omite `TaskCreate` para acciones triviales de un solo paso, conversación pura o cualquier cosa completable en dos o tres llamadas directas de herramientas.
 
+## Activación
+
+- Disponible por defecto en la mayoría de los modelos.
+- No disponible en las familias Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 y posteriores (v2.1.233+) salvo que se active explícitamente mediante `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- Todo el sistema de tareas se desactiva cuando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parámetros
 
 - `subject` (string, obligatorio): Título corto en imperativo, p. ej. `Fix login redirect on Safari`. Mantenlo en torno a ochenta caracteres o menos.

package/concepts/es/Tool-TaskGet.md

@@ -12,6 +12,12 @@ Recupera el registro completo de una sola tarea por ID, incluyendo su descripci
 
 Prefiere `TaskList` cuando solo necesites una vista de alto nivel; reserva `TaskGet` para el registro específico que pretendes leer cuidadosamente o modificar.
 
+## Activación
+
+- Disponible por defecto en la mayoría de los modelos.
+- No disponible en las familias Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 y posteriores (v2.1.233+) salvo que se active explícitamente mediante `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- Todo el sistema de tareas se desactiva cuando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parámetros
 
 - `taskId` (string, obligatorio): El identificador de la tarea devuelto por `TaskCreate` o `TaskList`. Los IDs son estables durante toda la vida de la tarea.

package/concepts/es/Tool-TaskList.md

@@ -12,6 +12,12 @@ Devuelve cada tarea del equipo (o sesión) actual en forma resumida. Úsala para
 
 `TaskList` es de solo lectura y económico; llámalo libremente cuando necesites una visión general.
 
+## Activación
+
+- Disponible por defecto en la mayoría de los modelos.
+- No disponible en las familias Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 y posteriores (v2.1.233+) salvo que se active explícitamente mediante `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- Todo el sistema de tareas se desactiva cuando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parámetros
 
 `TaskList` no recibe parámetros. Siempre devuelve el conjunto completo de tareas del contexto activo.

package/concepts/es/Tool-TaskUpdate.md

@@ -10,6 +10,12 @@ Modifica una tarea existente — su estado, contenido, propiedad, metadatos o ar
 - Registrar dependencias recién descubiertas con `addBlocks` / `addBlockedBy`.
 - Adjuntar `metadata` estructurada como IDs de tickets externos o pistas de prioridad.
 
+## Activación
+
+- Disponible por defecto en la mayoría de los modelos.
+- No disponible en las familias Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 y posteriores (v2.1.233+) salvo que se active explícitamente mediante `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- Todo el sistema de tareas se desactiva cuando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parámetros
 
 - `taskId` (string, obligatorio): La tarea a modificar. Obtenlo de `TaskList` o `TaskCreate`.