Flux de développement Pi

Ce guide résume un flux de travail sain pour travailler sur l'intégration pi dans Mayros.

Vérification de types et Linting

  • Vérification de types et build : pnpm build
  • Lint : pnpm lint
  • Vérification de format : pnpm format
  • Gate complet avant push : pnpm lint && pnpm build && pnpm test

Exécuter les tests Pi

Utilisez le script dédié pour l'ensemble de tests d'intégration pi :

bash
scripts/pi/run-tests.sh

Pour inclure le test en direct qui exerce le comportement réel du fournisseur :

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

Le script exécute tous les tests unitaires liés à pi via ces 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

Tests manuels

Flux recommandé :

  • Exécutez la passerelle en mode dev :
    • pnpm gateway:dev
  • Déclenchez l'agent directement :
    • pnpm mayros agent --message "Bonjour" --thinking low
  • Utilisez le TUI pour le débogage interactif :
    • pnpm tui

Pour le comportement des appels d'outils, demandez une action read ou exec afin de voir le streaming et la gestion des payloads d'outils.

Réinitialisation complète

L'état se trouve dans le répertoire d'état Mayros. Par défaut c'est ~/.mayros. Si MAYROS_STATE_DIR est défini, utilisez ce répertoire à la place.

Pour tout réinitialiser :

  • mayros.json pour la config
  • credentials/ pour les profils d'authentification et les tokens
  • agents/<agentId>/sessions/ pour l'historique des sessions de l'agent
  • agents/<agentId>/sessions.json pour l'index des sessions
  • sessions/ si des chemins legacy existent
  • workspace/ si vous voulez un espace de travail vierge

Si vous voulez seulement réinitialiser les sessions, supprimez agents/<agentId>/sessions/ et agents/<agentId>/sessions.json pour cet agent. Gardez credentials/ si vous ne voulez pas vous réauthentifier.

Références