Outils et sessions

inspect_project#

Paramètres : directory absolu et type facultatif (node, maven, gradle). Retourne le type, le gestionnaire, les scripts, les avertissements et le plan. Aucun téléchargement, aucune commande, aucune écriture.

install_project#

Paramètres : directory, type facultatif et javaVersion facultatif. Prépare les outils et les dépendances Node, ou le JDK et la compilation Java. Retourne un identifiant de session.

start_project#

Paramètres : directory, type, javaVersion, script facultatifs et skipInstall (défaut false). Prépare puis lance le projet en arrière-plan.

json

{
  "directory": "/home/user/projets/mon-app",
  "type": "node",
  "script": "dev",
  "skipInstall": false
}

get_logs et stop_project#

Les deux outils prennent sessionId, retourné par l’installation ou le lancement. get_logs expose l’état, les logs récents, le code de sortie et le signal. stop_project arrête la session et ses sous-processus.

États d’une session#

État	Signification
`running`	Tâche en cours, y compris l’installation
`stopping`	Arrêt demandé
`stopped`	Session arrêtée
`completed`	Commande terminée avec succès
`failed`	Échec de la tâche

running ne signifie pas « application prête ». Consultez les logs de l’application pour connaître son état et son URL.

Limites et nettoyage#

Une seule session active par dossier. Le serveur conserve au maximum 20 sessions et les 65 536 derniers caractères de logs de chacune. truncated indique une sortie tronquée.

Les sessions sont en mémoire. Les processus actifs sont arrêtés à la déconnexion normale ou sur SIGINT/SIGTERM. Un SIGKILL ne permet pas ce nettoyage. Les fichiers .env ne sont pas lus pour être transmis au modèle, mais les scripts peuvent afficher des données sensibles dans les logs.