puruto-gateway

このコンテンツはまだ日本語訳がありません。

¿Qué es puruto-gateway?

puruto-gateway es una API REST local (FastAPI scaffold) para descubrir Purutos del ecosistema y exponer comandos base por HTTP. Permite integrar Purutos con scripts, dashboards o herramientas externas sin pasar por el agente.

Cuándo usarlo

Integrar Purutos con scripts de shell o Python
Construir un dashboard web simple sobre el estado del ecosistema
Exponer el status del ecosistema a herramientas de monitorización
Automatizar flujos que no requieren la interfaz del agente

Generarlo

python3 .claude/skills/puruto-generator/scripts/generate.py --name puruto-gateway

Endpoints (MVP)

GET  /health
GET  /purutos
GET  /purutos/{name}
POST /purutos/{name}/{command}   # command ∈ {init, help, list, status}

Respuesta típica de discovery:

{
  "status": "ok",
  "count": 1,
  "items": [
    {
      "name": "puruto-data",
      "path": "/ruta/puruto-data",
      "kind": "puruto-data",
      "commands": ["init", "help", "list", "status"]
    }
  ]
}

Arquitectura

puruto-gateway usa invoker.py (scaffold compartido del ecosistema) para construir invocaciones. El gateway actúa como proxy HTTP → invoker local (stub en el MVP).

Cliente HTTP
    ↓
puruto-gateway (FastAPI)
    ↓
invoker.py
    ↓
puruto-finanzas / puruto-data / ...

Auth (MVP)

Los endpoints /purutos* requieren:

header X-API-Key
variable PURUTO_GATEWAY_API_KEY configurada

Ver también

→ Gateway API (MVP)
→ Seguridad y secretos

Skills incluidas

/init — levanta el servidor REST local
/help — documenta los endpoints disponibles
/list — lista qué Purutos están registrados en el gateway
/status — muestra el estado del servidor y los Purutos registrados