Flujo de Trabajo de Desarrollo de Pi

Esta guía resume un flujo de trabajo sensato para trabajar en la integración de pi en Mayros.

Verificación de Tipos y Linting

  • Verificar tipos y construir: pnpm build
  • Lint: pnpm lint
  • Verificar formato: pnpm format
  • Puerta completa antes de hacer push: pnpm lint && pnpm build && pnpm test

Ejecutar Tests de Pi

Usa el script dedicado para el conjunto de tests de integración de pi:

bash
scripts/pi/run-tests.sh

Para incluir el test en vivo que ejercita el comportamiento real del proveedor:

bash
scripts/pi/run-tests.sh --live

El script ejecuta todos los tests unitarios relacionados con pi vía estos globs:

  • src/agents/pi-*.test.ts
  • src/agents/pi-embedded-*.test.ts
  • src/agents/pi-tools*.test.ts
  • src/agents/pi-settings.test.ts
  • src/agents/pi-tool-definition-adapter.test.ts
  • src/agents/pi-extensions/*.test.ts

Pruebas Manuales

Flujo recomendado:

  • Ejecuta el gateway en modo dev:
    • pnpm gateway:dev
  • Activa el agente directamente:
    • pnpm mayros agent --message "Hola" --thinking low
  • Usa el TUI para depuración interactiva:
    • pnpm tui

Para comportamiento de llamadas a herramientas, solicita una acción read o exec para que puedas ver el streaming de herramientas y manejo de payloads.

Reinicio Limpio

El estado vive bajo el directorio de estado de Mayros. El predeterminado es ~/.mayros. Si MAYROS_STATE_DIR está establecido, usa ese directorio en su lugar.

Para reiniciar todo:

  • mayros.json para configuración
  • credentials/ para perfiles de autenticación y tokens
  • agents/<agentId>/sessions/ para historial de sesión del agente
  • agents/<agentId>/sessions.json para el índice de sesión
  • sessions/ si existen rutas legacy
  • workspace/ si quieres un espacio de trabajo en blanco

Si solo quieres reiniciar sesiones, elimina agents/<agentId>/sessions/ y agents/<agentId>/sessions.json para ese agente. Mantén credentials/ si no quieres volver a autenticarte.

Referencias