cc-viewer 1.7.22 → 1.8.0

package/concepts/en/Tools.md

@@ -15,16 +15,19 @@ Below is a categorized index of all tools.
 | [TaskGet](Tool-TaskGet.md) | Get task details |
 | [TaskUpdate](Tool-TaskUpdate.md) | Update task status, dependencies, etc. |
 | [TaskList](Tool-TaskList.md) | List all tasks |
+| [ListAgents](Tool-ListAgents.md) | List the agents available in the session |
 
 ## Team & Orchestration
 
 | Tool | Purpose |
 |------|---------|
-| [TeamCreate](Tool-TeamCreate.md) | Create an agent team for collaborative work |
-| [TeamDelete](Tool-TeamDelete.md) | Disband an agent team |
 | [SendMessage](Tool-SendMessage.md) | Send a message to another agent |
 | [Workflow](Tool-Workflow.md) | Run a deterministic multi-agent orchestration script |
 | [Monitor](Tool-Monitor.md) | Stream events from a long-running script as notifications |
+| [SendFile](Tool-SendFile.md) | Send files to another Claude Code session |
+| [SendUserFile](Tool-SendUserFile.md) | Send files to the user |
+| [SendUserMessage](Tool-SendUserMessage.md) | Send a message to the user (legacy Brief tool) |
+| [EndConversation](Tool-EndConversation.md) | End the current conversation |
 
 ## File Operations
 
@@ -48,6 +51,7 @@ Below is a categorized index of all tools.
 | Tool | Purpose |
 |------|---------|
 | [Bash](Tool-Bash.md) | Execute shell commands |
+| [REPL](Tool-REPL.md) | Run JavaScript in a persistent Node.js REPL |
 
 ## Web
 
@@ -66,6 +70,10 @@ Below is a categorized index of all tools.
 | [ExitPlanMode](Tool-ExitPlanMode.md) | Exit plan mode and submit the plan for user approval |
 | [AskUserQuestion](Tool-AskUserQuestion.md) | Ask the user a question for clarification or decisions |
 | [ReportFindings](Tool-ReportFindings.md) | Report code-review findings as a typed list for the host UI |
+| [TodoWrite](Tool-TodoWrite.md) | Write a structured todo list for the session |
+| [SendFeedback](Tool-SendFeedback.md) | Send structured feedback about Claude Code to Anthropic |
+| [Projects](Tool-Projects.md) | Manage project knowledge-base documents |
+| [ProposeGoal](Tool-ProposeGoal.md) | Propose a verifiable completion goal for the session |
 
 ## Worktrees
 
@@ -84,6 +92,7 @@ Below is a categorized index of all tools.
 | [ScheduleWakeup](Tool-ScheduleWakeup.md) | Self-pace /loop iterations by scheduling the next wakeup |
 | [PushNotification](Tool-PushNotification.md) | Send a desktop/mobile notification to the user |
 | [RemoteTrigger](Tool-RemoteTrigger.md) | Manage claude.ai remote-trigger routines |
+| [ReadNotifications](Tool-ReadNotifications.md) | Read pending session notifications |
 
 ## Extensions
 
@@ -91,10 +100,23 @@ Below is a categorized index of all tools.
 |------|---------|
 | [Skill](Tool-Skill.md) | Execute a skill (slash command) |
 
+## MCP & Extensions
+
+| Tool | Purpose |
+|------|---------|
+| [ListMcpResources](Tool-ListMcpResources.md) | List resources exposed by connected MCP servers |
+| [ReadMcpResource](Tool-ReadMcpResource.md) | Read a single MCP server resource by URI |
+| [ReadMcpResourceDir](Tool-ReadMcpResourceDir.md) | List a directory-style MCP resource by URI |
+| [SearchMcpRegistry](Tool-SearchMcpRegistry.md) | Search the MCP connector registry by keyword |
+| [SuggestConnectors](Tool-SuggestConnectors.md) | Resolve connector details from registry search results |
+| [ListConnectors](Tool-ListConnectors.md) | List installed MCP connectors |
+| [SuggestPluginInstall](Tool-SuggestPluginInstall.md) | Render an inline plugin install card |
+| [SuggestSkills](Tool-SuggestSkills.md) | Render a card of addable skills |
+| [ListPlugins](Tool-ListPlugins.md) | List enabled claude.ai plugins |
+| [ListSkills](Tool-ListSkills.md) | List enabled claude.ai skills |
+
 ## IDE Integration
 
 | Tool | Purpose |
 |------|---------|
-| [getDiagnostics](Tool-getDiagnostics.md) | Get VS Code language diagnostics |
-| [executeCode](Tool-executeCode.md) | Execute code in a Jupyter kernel |
 | [LSP](Tool-LSP.md) | Language-server queries (definitions, references, symbols) |

package/concepts/es/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/es/Tool-Artifact.md

@@ -9,6 +9,13 @@ Renderiza un archivo HTML o Markdown en un Artifact — una página web alojada
 - Listar los artifacts existentes del usuario para encontrar uno de una sesión anterior (`action: "list"`)
 - **No** para contenido que debe mantenerse local, respuestas de texto simple o cualquier cosa que necesite recursos de red externos al visualizar — una CSP estricta bloquea cualquier host externo
 
+## Activación
+
+- Requiere un plan Pro, Max, Team o Enterprise con inicio de sesión en claude.ai (`/login`).
+- Solo en la API de Anthropic — no disponible en Amazon Bedrock, Google Cloud ni Microsoft Foundry.
+- Requiere Claude Code ≥ 2.1.183 o la app de escritorio ≥ 1.13576.0.
+- Desactívalo con el ajuste `disableArtifact` o `CLAUDE_CODE_DISABLE_ARTIFACT=1`.
+
 ## Parámetros
 
 - `file_path` (cadena): Ruta al archivo `.html` o `.md` a renderizar. El archivo se envuelve en un esqueleto de documento al publicarse, así que escribe el contenido de la página directamente — sin etiquetas `<!DOCTYPE>`, `<html>`, `<head>` o `<body>`. La misma ruta → la misma URL al redesplegar; una ruta diferente reclama una URL nueva.

package/concepts/es/Tool-EndConversation.md

@@ -0,0 +1,35 @@
+# EndConversation
+
+Termina la conversación actual e impide que se envíen más mensajes.
+
+## Cuándo usar
+
+- Solo ante abuso sostenido por parte del usuario, o cuando el usuario pide explícitamente una demostración de esta herramienta.
+
+Esta es una acción de último recurso: las propias reglas de la herramienta exigen avisar primero al usuario y confirmar antes de usarla, y nunca debe usarse en situaciones de autolesión o relacionadas con daños.
+
+## Activación
+
+- Requiere Claude Code 2.1.213+ y un modelo de la familia Opus 4.8 / Sonnet 5 / Fable 5 o posterior.
+- Solo sesiones interactivas de terminal — nunca en modo `--bare`, y nunca disponible para subagentes.
+- No disponible en Amazon Bedrock, Claude Platform on AWS, Vertex AI, Microsoft Foundry ni gateways en la nube.
+- Requiere un feature flag del lado del servidor — la mayoría de las sesiones no ofrecen esta herramienta.
+
+## Parámetros
+
+Esta herramienta no toma parámetros.
+
+## Ejemplos
+
+### Ejemplo 1: Terminar la conversación
+
+```
+EndConversation()
+```
+
+El flujo tiene dos pasos: la primera llamada devuelve un mensaje de reflexión; una segunda llamada inmediatamente después termina de verdad la conversación (`ended: true`).
+
+## Notas
+
+- Fuertemente restringida: requiere un modelo compatible, el punto de entrada del CLI y un feature flag del lado del servidor — la mayoría de las sesiones no ofrecen esta herramienta.
+- Una vez terminada, no se pueden enviar más mensajes en la conversación.

package/concepts/es/Tool-LSP.md

@@ -10,6 +10,11 @@ Consulta servidores Language Server Protocol (LSP) para obtener inteligencia de
 - Encontrar las implementaciones de una interfaz o un método abstracto (`goToImplementation`)
 - Recorrer la jerarquía de llamadas de una función (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
 
+## Activación
+
+- Inactivo hasta que se instale un plugin de inteligencia de código para el lenguaje (el binario del servidor se instala por separado).
+- La herramienta solo aparece cuando hay un cliente LSP conectado.
+
 ## Parámetros
 
 - `operation` (string, obligatorio): una de las operaciones enumeradas arriba.

package/concepts/es/Tool-ListAgents.md

@@ -0,0 +1,35 @@
+# ListAgents
+
+Lista los agents a los que puedes `SendMessage`: sub-agents en proceso que lanzaste, otras sesiones locales de Claude en esta máquina, tus sesiones en la nube (cuando esta sesión tiene acceso a la nube) y — cuando Remote Control está conectado — las demás sesiones de tu cuenta. Cada fila está etiquetada por tipo.
+
+## Cuándo usar
+
+- Necesitas el nombre exacto de una sesión par o sub-agent antes de enviarle un mensaje.
+- Quieres ver qué sesiones son alcanzables actualmente desde esta.
+
+## Activación
+
+- Requiere Claude Code 2.1.224+ y mensajería entre sesiones (un feature flag del lado del servidor, desactivado por defecto).
+- La mensajería entre sesiones no está disponible en Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform ni Microsoft Foundry.
+- Se desactiva cuando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `DISABLE_GROWTHBOOK` está establecido.
+- Fuerza su activación con `CLAUDE_CODE_HARBOR_KITE=1`.
+
+## Parámetros
+
+- `channel` (string, opcional): No disponible en esta compilación; déjalo sin establecer.
+- `q` (string, opcional): No disponible en esta compilación; déjalo sin establecer.
+
+## Ejemplos
+
+### Ejemplo 1: Listar agents alcanzables
+
+```
+ListAgents()
+```
+
+Cada fila imprime un nombre — ese nombre es la dirección. Envía con `SendMessage({to: "<name>", message: "..."})`, copiando el nombre exactamente como se imprime. Añade el ` [ref]` de una fila solo cuando el nombre a secas sea ambiguo (dos filas lo comparten, o un error te pide desambiguar).
+
+## Notas
+
+- Solo lectura y seguro para concurrencia.
+- Una sesión en la nube recibe tu mensaje pero aún no puede responder — lee su respuesta en su propia transcripción.

package/concepts/es/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+Lista los conectores MCP instalados para la organización de claude.ai del usuario, opcionalmente filtrados por palabra clave.
+
+## Cuándo usar
+
+- Necesitas saber qué conectores ya están instalados antes de sugerir otros nuevos.
+- El usuario pregunta qué integraciones tiene su organización.
+
+## Activación
+
+- Solo disponible en sesiones remotas (claude.ai) en la API first-party.
+
+## Parámetros
+
+- `keywords` (array de strings, opcional): Filtra la lista — hasta 8 elementos, cada uno de 1 a 64 caracteres. Omítelo para listar todo.
+
+## Ejemplos
+
+### Ejemplo 1: Listar todos los conectores instalados
+
+```
+ListConnectors()
+```
+
+### Ejemplo 2: Filtrar por palabra clave
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## Notas
+
+- Combínalo con `SearchMcpRegistry` (descubrimiento) y `SuggestConnectors` (detalles) para el flujo completo de encontrar y habilitar.

package/concepts/es/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+Lista los recursos expuestos por los servidores MCP conectados, opcionalmente filtrados a un servidor.
+
+## Cuándo usar
+
+- Necesitas descubrir qué recursos (archivos, registros, documentos) ofrece un servidor MCP antes de leerlos.
+- Quieres una vista general de todos los recursos de todos los servidores conectados.
+
+## Activación
+
+- Siempre habilitado, pero no expuesto en la lista de herramientas del modelo — pensado para uso thin-client / sidecar.
+
+## Parámetros
+
+- `server` (string, opcional): Nombre del servidor por el que filtrar los recursos. Omítelo para listar recursos de todos los servidores conectados.
+
+## Ejemplos
+
+### Ejemplo 1: Listar todo
+
+```
+ListMcpResources()
+```
+
+### Ejemplo 2: Listar los recursos de un servidor
+
+```
+ListMcpResources(server="github")
+```
+
+## Notas
+
+- Este es el paso de descubrimiento: pasa las URIs interesantes a `ReadMcpResource` (recurso único) o `ReadMcpResourceDir` (listados de directorio).
+- Los servidores se conectan y desconectan a lo largo de la vida de la sesión; vuelve a listar si se acaba de añadir un servidor.

package/concepts/es/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+Lista los plugins de claude.ai habilitados del usuario, opcionalmente filtrados por palabra clave.
+
+## Cuándo usar
+
+- Necesitas saber qué plugins ya están habilitados — por ejemplo, para confirmar qué se instaló tras una tarjeta de `SuggestPluginInstall`.
+- El usuario pregunta qué plugins tiene.
+
+## Activación
+
+- Requiere permiso de acceso al registro de plugins.
+- La disponibilidad depende del tipo de sesión y del lanzamiento de la función — deshabilitado en entornos HIPAA, siempre disponible en sesiones remotas.
+
+## Parámetros
+
+- `keywords` (array de strings, opcional): Filtra la lista — hasta 8 elementos, cada uno de 1 a 64 caracteres. Omítelo para listar todo.
+
+## Ejemplos
+
+### Ejemplo 1: Listar plugins habilitados
+
+```
+ListPlugins()
+```
+
+### Ejemplo 2: Filtrar por palabra clave
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## Notas
+
+- Si el catálogo de plugins es inalcanzable (forbidden), la herramienta se degrada a una lista vacía con una advertencia en lugar de fallar.

package/concepts/es/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+Lista las skills de claude.ai habilitadas del usuario, opcionalmente filtradas por palabra clave.
+
+## Cuándo usar
+
+- Necesitas la lista autoritativa de skills habilitadas actualmente — antes de invocar una, o para confirmar qué añadió una tarjeta de `SuggestSkills`.
+- El usuario pregunta qué skills tiene.
+
+## Activación
+
+- Requiere permiso de acceso al registro de plugins.
+- Deshabilitado en entornos HIPAA.
+- Siempre disponible en sesiones remotas.
+
+## Parámetros
+
+- `keywords` (array de strings, opcional): Filtra la lista — hasta 8 elementos, cada uno de 1 a 64 caracteres. Omítelo para listar todo.
+
+## Ejemplos
+
+### Ejemplo 1: Listar skills habilitadas
+
+```
+ListSkills()
+```
+
+### Ejemplo 2: Filtrar por palabra clave
+
+```
+ListSkills(keywords=["review"])
+```
+
+## Notas
+
+- Si el catálogo es inalcanzable (forbidden), la herramienta se degrada a una lista vacía con una advertencia en lugar de fallar.
+- Esto lista las skills *habilitadas*; usa `SuggestSkills` para hacer aflorar skills que el usuario podría añadir.

package/concepts/es/Tool-Monitor.md

@@ -10,6 +10,13 @@ Inicia un monitor en segundo plano que transmite eventos desde un script de larg
 - 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
 
+## Activación
+
+- Desactivado por defecto (feature flag del lado del servidor).
+- No disponible en Amazon Bedrock, Google Cloud ni Microsoft Foundry.
+- Desactivado cuando `DISABLE_TELEMETRY` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está establecido.
+- La fuente WebSocket requiere Claude Code 2.1.195+.
+
 ## 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.

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.