egutierrez
40710b924d
Pipeline de creacion formalizado con 3 mejoras:
1. Display name automatico (paso 7): create-full.sh ahora configura
el display name en Matrix via PUT al profile API con el token
del bot recien creado. Evita que los bots aparezcan como @id:server.
2. Health check post-arranque: nuevo script health-check.sh que busca
en los logs del launcher mensajes de arranque exitoso ("e2ee ready",
"runner started", etc.) con timeout configurable (default 30s).
3. Notificacion enriquecida: notify-developer.sh ahora incluye
descripcion del agente (leida de config.yaml), tools habilitadas,
formato markdown con estructura clara, y reintentos con backoff
(hasta 3 intentos) si el envio de DM falla.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
233 lines
8.4 KiB
Bash
Executable File
233 lines
8.4 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# create-full.sh — pipeline completo para crear un agente o robot funcional
|
|
#
|
|
# Pipeline de 7 pasos:
|
|
# 1. SCAFFOLD → crear archivos base desde template
|
|
# 2. BUILD → go build -tags goolm ./...
|
|
# 3. REGISTER → crear usuario Matrix + token
|
|
# 4. VERIFY E2EE → cross-signing + recovery key
|
|
# 5. CONVERT (robot) → eliminar LLM/prompts si type=robot
|
|
# 6. AUTO-AVATAR → generar y aplicar foto de perfil
|
|
# 7. DISPLAY NAME → configurar nombre visible en Matrix
|
|
#
|
|
# Pasos posteriores (manuales o via father-bot):
|
|
# 8. PERSONALIZE → config.yaml, agent.go, system prompt
|
|
# 9. REBUILD → recompilar tras personalizacion
|
|
# 10. START/RESTART → arrancar el launcher con el bot
|
|
# 11. HEALTH CHECK → ./dev-scripts/agent/health-check.sh <id>
|
|
# 12. SELF-INTRODUCE → ./dev-scripts/agent/notify-developer.sh <id>
|
|
#
|
|
# Uso:
|
|
# ./dev-scripts/agent/create-full.sh <agent-id> "Display Name" # agente (default)
|
|
# ./dev-scripts/agent/create-full.sh <agent-id> "Display Name" --type robot # robot
|
|
#
|
|
# Requisitos en .env:
|
|
# MATRIX_ADMIN_TOKEN, MATRIX_HOMESERVER, MATRIX_SERVER_NAME
|
|
# DEVELOPER_MATRIX_USERS (opcional, para notificación al developer)
|
|
|
|
source "$(dirname "$0")/../_common.sh"
|
|
load_env
|
|
|
|
need_arg "${1:-}"
|
|
|
|
ID="$1"
|
|
DISPLAYNAME="${2:-$ID}"
|
|
TYPE="agent"
|
|
NORM="$(normalize_id "$ID")"
|
|
SCRIPT_DIR="$(dirname "$0")"
|
|
|
|
# Parse --type flag
|
|
shift 2 2>/dev/null || shift 1 2>/dev/null || true
|
|
while [[ $# -gt 0 ]]; do
|
|
case "$1" in
|
|
--type)
|
|
TYPE="${2:-agent}"
|
|
shift 2
|
|
;;
|
|
--type=*)
|
|
TYPE="${1#--type=}"
|
|
shift
|
|
;;
|
|
*)
|
|
shift
|
|
;;
|
|
esac
|
|
done
|
|
|
|
if [[ "$TYPE" == "robot" ]]; then
|
|
TYPE_LABEL="robot"
|
|
TYPE_EMOJI="🤖"
|
|
else
|
|
TYPE_LABEL="agente"
|
|
TYPE_EMOJI="🧠"
|
|
fi
|
|
|
|
echo ""
|
|
echo -e "${BLU}═══════════════════════════════════════════════════════${RST}"
|
|
echo -e "${BLU} Creando ${TYPE_LABEL}: ${GRN}$ID${BLU} ($DISPLAYNAME) ${TYPE_EMOJI}${RST}"
|
|
echo -e "${BLU}═══════════════════════════════════════════════════════${RST}"
|
|
echo ""
|
|
|
|
# ── Paso 1: Scaffold ─────────────────────────────────────────────────────
|
|
TOTAL_STEPS=7
|
|
[[ "$TYPE" == "robot" ]] && TOTAL_STEPS=8
|
|
|
|
info "Paso 1/${TOTAL_STEPS} — Scaffold (agent.go, config.yaml, prompts, launcher)"
|
|
echo ""
|
|
|
|
"$SCRIPT_DIR/new-agent.sh" "$ID" "$DISPLAYNAME"
|
|
|
|
echo ""
|
|
|
|
# ── Paso 2: Verificar compilación ─────────────────────────────────────────
|
|
info "Paso 2/${TOTAL_STEPS} — Verificando compilación..."
|
|
|
|
if "$GO" build -tags goolm ./... 2>&1; then
|
|
ok "Compilación exitosa"
|
|
else
|
|
fail "Error de compilación — revisa agents/$ID/agent.go y cmd/launcher/main.go"
|
|
fi
|
|
|
|
echo ""
|
|
|
|
# ── Paso 3: Registrar en Matrix ──────────────────────────────────────────
|
|
info "Paso 3/${TOTAL_STEPS} — Registrando en Matrix..."
|
|
echo ""
|
|
|
|
# Reload .env in case new-agent.sh or previous steps changed it
|
|
load_env
|
|
|
|
"$SCRIPT_DIR/register.sh" "$ID" "$DISPLAYNAME"
|
|
|
|
echo ""
|
|
|
|
# ── Paso 4: Verificar E2EE ───────────────────────────────────────────────
|
|
info "Paso 4/${TOTAL_STEPS} — Verificación E2EE (cross-signing + recovery key)..."
|
|
echo ""
|
|
|
|
# Reload .env to pick up token, password, pickle key from register.sh
|
|
load_env
|
|
|
|
"$SCRIPT_DIR/verify.sh" "$ID"
|
|
|
|
echo ""
|
|
|
|
# ── Paso 5 (robots): Convertir a robot ───────────────────────────────────
|
|
if [[ "$TYPE" == "robot" ]]; then
|
|
info "Paso 5/${TOTAL_STEPS} — Convirtiendo a robot..."
|
|
echo ""
|
|
|
|
"$SCRIPT_DIR/convert-to-robot.sh" "$ID" "$DISPLAYNAME"
|
|
|
|
# Rebuild after conversion
|
|
info "Recompilando tras conversión..."
|
|
"$GO" build -tags goolm ./... 2>&1 || fail "Error de compilación tras conversión a robot"
|
|
ok "Recompilación exitosa"
|
|
|
|
echo ""
|
|
fi
|
|
|
|
# ── Paso auto-avatar: Generar avatar automatico ─────────────────────────
|
|
AVATAR_STEP=$((TOTAL_STEPS - 2))
|
|
info "Paso ${AVATAR_STEP}/${TOTAL_STEPS} — Generando avatar automatico..."
|
|
echo ""
|
|
|
|
# Resuelve el binario de agentctl
|
|
if [[ -f "$REPO_ROOT/bin/agentctl" ]]; then
|
|
CTL="$REPO_ROOT/bin/agentctl"
|
|
else
|
|
CTL="$GO run -tags goolm ./cmd/agentctl"
|
|
fi
|
|
|
|
if $CTL auto-avatar "$ID" 2>&1; then
|
|
ok "Avatar generado y aplicado"
|
|
else
|
|
warn "No se pudo generar avatar automatico (se puede hacer despues con: agentctl auto-avatar $ID)"
|
|
fi
|
|
|
|
echo ""
|
|
|
|
# ── Paso display name: Configurar nombre visible en Matrix ──────────────
|
|
DISPLAYNAME_STEP=$((TOTAL_STEPS - 1))
|
|
info "Paso ${DISPLAYNAME_STEP}/${TOTAL_STEPS} — Configurando display name en Matrix..."
|
|
echo ""
|
|
|
|
# Reload .env to pick up token from register.sh
|
|
load_env
|
|
|
|
TOKEN_VAR="MATRIX_TOKEN_${NORM}"
|
|
BOT_TOKEN="${!TOKEN_VAR:-}"
|
|
|
|
if [[ -n "$BOT_TOKEN" ]]; then
|
|
USER_ID="@${ID}:${MATRIX_SERVER_NAME}"
|
|
if curl -sf -X PUT \
|
|
"${MATRIX_HOMESERVER}/_matrix/client/v3/profile/${USER_ID}/displayname" \
|
|
-H "Authorization: Bearer $BOT_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d "{\"displayname\": \"${DISPLAYNAME}\"}" >/dev/null 2>&1; then
|
|
ok "Display name configurado: $DISPLAYNAME"
|
|
else
|
|
warn "No se pudo configurar display name (se puede hacer despues manualmente)"
|
|
fi
|
|
else
|
|
warn "Token del bot no encontrado — display name no configurado"
|
|
fi
|
|
|
|
echo ""
|
|
|
|
# ── Paso final: Notificar al developer ───────────────────────────────────
|
|
NOTIFY_STEP=$TOTAL_STEPS
|
|
info "Paso ${NOTIFY_STEP}/${TOTAL_STEPS} — Notificando a desarrolladores..."
|
|
echo ""
|
|
|
|
"$SCRIPT_DIR/notify-developer.sh" "$ID" "$TYPE" "$DISPLAYNAME" || true
|
|
|
|
echo ""
|
|
|
|
# ── Resumen ──────────────────────────────────────────────────────────────
|
|
echo -e "${GRN}═══════════════════════════════════════════════════════${RST}"
|
|
echo -e "${GRN} ✓ ${TYPE_LABEL^} $ID creado exitosamente ${TYPE_EMOJI}${RST}"
|
|
echo -e "${GRN}═══════════════════════════════════════════════════════${RST}"
|
|
echo ""
|
|
echo -e " ${BLU}Archivos creados:${RST}"
|
|
echo -e " agents/$ID/agent.go"
|
|
echo -e " agents/$ID/config.yaml"
|
|
if [[ "$TYPE" != "robot" ]]; then
|
|
echo -e " agents/$ID/prompts/system.md"
|
|
fi
|
|
echo ""
|
|
echo -e " ${BLU}Variables en .env:${RST}"
|
|
echo -e " MATRIX_TOKEN_${NORM}"
|
|
echo -e " MATRIX_PASSWORD_${NORM}"
|
|
echo -e " PICKLE_KEY_${NORM}"
|
|
echo -e " SSSS_RECOVERY_KEY_${NORM}"
|
|
echo ""
|
|
echo -e " ${BLU}Launcher actualizado:${RST}"
|
|
echo -e " cmd/launcher/main.go (import)"
|
|
echo ""
|
|
echo -e "${YLW}Siguientes pasos (8-12 del pipeline):${RST}"
|
|
echo ""
|
|
if [[ "$TYPE" == "robot" ]]; then
|
|
echo -e " ${BLU}8. PERSONALIZE${RST} — añadir comandos custom:"
|
|
echo -e " ${DIM}agents/$ID/commands.go${RST}"
|
|
echo -e " ${DIM}cmd/launcher/main.go${RST} (registrar comandos)"
|
|
else
|
|
echo -e " ${BLU}8. PERSONALIZE${RST} — personalizar los archivos del agente:"
|
|
echo -e " ${DIM}agents/$ID/agent.go${RST} — reglas de decisión"
|
|
echo -e " ${DIM}agents/$ID/config.yaml${RST} — LLM, tools, personalidad"
|
|
echo -e " ${DIM}agents/$ID/prompts/system.md${RST} — system prompt"
|
|
fi
|
|
echo ""
|
|
echo -e " ${BLU}9. REBUILD${RST}:"
|
|
echo -e " ${DIM}go build -tags goolm ./...${RST}"
|
|
echo ""
|
|
echo -e " ${BLU}10. START${RST}:"
|
|
echo -e " ${DIM}./dev-scripts/server/start.sh${RST}"
|
|
echo ""
|
|
echo -e " ${BLU}11. HEALTH CHECK${RST}:"
|
|
echo -e " ${DIM}./dev-scripts/agent/health-check.sh $ID${RST}"
|
|
echo ""
|
|
echo -e " ${BLU}12. SELF-INTRODUCE${RST} (tras health check ok):"
|
|
echo -e " ${DIM}./dev-scripts/agent/notify-developer.sh $ID $TYPE \"$DISPLAYNAME\"${RST}"
|
|
echo ""
|