Workflow Sviluppo Pi

Questa guida riassume un workflow sensato per lavorare sull'integrazione pi in Mayros.

Type Checking e Linting

  • Type check e build: pnpm build
  • Lint: pnpm lint
  • Controllo formato: pnpm format
  • Gate completo prima del push: pnpm lint && pnpm build && pnpm test

Esecuzione Test Pi

Usa lo script dedicato per il set di test di integrazione pi:

bash
scripts/pi/run-tests.sh

Per includere il test live che esercita il comportamento reale del provider:

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

Lo script esegue tutti i test unitari correlati a pi tramite questi glob:

  • 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

Test Manuali

Flusso consigliato:

  • Esegui il gateway in modalità dev:
    • pnpm gateway:dev
  • Attiva l'agente direttamente:
    • pnpm mayros agent --message "Ciao" --thinking low
  • Usa il TUI per debug interattivo:
    • pnpm tui

Per il comportamento delle chiamate agli strumenti, richiedi un'azione read o exec in modo da poter vedere lo streaming degli strumenti e la gestione del payload.

Reset Completo

Lo stato risiede nella directory stato Mayros. Il predefinito è ~/.mayros. Se MAYROS_STATE_DIR è impostato, usa quella directory invece.

Per resettare tutto:

  • mayros.json per la configurazione
  • credentials/ per profili auth e token
  • agents/<agentId>/sessions/ per lo storico sessioni agente
  • agents/<agentId>/sessions.json per l'indice sessioni
  • sessions/ se esistono percorsi legacy
  • workspace/ se vuoi un workspace vuoto

Se vuoi solo resettare le sessioni, elimina agents/<agentId>/sessions/ e agents/<agentId>/sessions.json per quell'agente. Mantieni credentials/ se non vuoi riautenticarti.

Riferimenti