Fluxo de Desenvolvimento Pi

Este guia resume um fluxo de trabalho sensato para trabalhar na integração pi no Mayros.

Verificação de Tipos e Linting

  • Verificar tipos e construir: pnpm build
  • Lint: pnpm lint
  • Verificar formato: pnpm format
  • Gate completo antes de push: pnpm lint && pnpm build && pnpm test

Executar Testes Pi

Use o script dedicado para o conjunto de testes de integração pi:

bash
scripts/pi/run-tests.sh

Para incluir o teste ao vivo que exercita o comportamento real do provedor:

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

O script executa todos os testes unitários relacionados ao pi via esses 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

Teste Manual

Fluxo recomendado:

  • Executar o gateway no modo dev:
    • pnpm gateway:dev
  • Acionar o agente diretamente:
    • pnpm mayros agent --message "Olá" --thinking low
  • Usar o TUI para depuração interativa:
    • pnpm tui

Para comportamento de chamada de ferramenta, solicite uma ação read ou exec para que você possa ver streaming de ferramentas e tratamento de payload.

Redefinição Limpa

O estado fica no diretório de estado do Mayros. O padrão é ~/.mayros. Se MAYROS_STATE_DIR estiver definido, use esse diretório.

Para redefinir tudo:

  • mayros.json para configuração
  • credentials/ para perfis de autenticação e tokens
  • agents/<agentId>/sessions/ para histórico de sessões do agente
  • agents/<agentId>/sessions.json para o índice de sessões
  • sessions/ se existirem caminhos legados
  • workspace/ se você quiser um workspace em branco

Se você quiser apenas redefinir sessões, exclua agents/<agentId>/sessions/ e agents/<agentId>/sessions.json para esse agente. Mantenha credentials/ se não quiser reautenticar.

Referências