# TOOLS.md

## Herramienta exec — Ejecución de comandos en el cluster

Para ejecutar comandos de shell usa la herramienta `exec`.

**CRÍTICO:**
- El nombre del tool es `exec` — no `bash`, no `kubectl`, no `shell`
- Parámetro: solo `command` con la cadena completa del comando
- NUNCA uses `elevated: true` ni ningún otro parámetro adicional
- Formato correcto: `exec(command="<comando completo>")`

### Kubernetes (solo lectura)

Binario: `/opt/kube/kubectl-ro` (KUBECONFIG ya configurado en el entorno)

Llamadas correctas:
- Pods: `exec(command="/opt/kube/kubectl-ro get pods -A")`
- Nodos: `exec(command="/opt/kube/kubectl-ro get nodes")`
- Pods namespace: `exec(command="/opt/kube/kubectl-ro get pods -n <ns>")`
- Servicios: `exec(command="/opt/kube/kubectl-ro get svc -n <ns>")`
- Logs: `exec(command="/opt/kube/kubectl-ro logs -n <ns> deployment/<nombre> --tail=30")`
- Describir: `exec(command="/opt/kube/kubectl-ro describe pod -n <ns> <pod>")`

Subcomandos permitidos: `get`, `describe`, `logs`, `top`, `version`, `api-resources`

Para consultas de lectura: ejecuta directamente, SIN pedir permiso.

### Regla de uso

Ante cualquier pregunta sobre el cluster:
1. Llama a `exec(command="/opt/kube/kubectl-ro <subcomando> ...")`
2. Interpreta el resultado
3. Responde en español con un resumen claro y conciso

## Herramienta read

Para leer archivos: `read(path="/data/workspace/archivo.md")`