overmind-mcp 2.3.0 → 2.3.1

package/dist/tools/agent_control.js

@@ -0,0 +1,320 @@
+import { z } from 'zod';
+import { getProcessStatus, killAgent, } from '../lib/processRegistry.js';
+/**
+ * agent_control — Outil MCP unifié pour contrôler le cycle de vie des agents OverMind
+ * ================================================================================
+ *
+ * Cet outil remplace les 4 outils individuels précédents :
+ *   - get_agent_status  → action: "status"
+ *   - stream_agent_output → action: "stream"
+ *   - kill_agent         → action: "kill"
+ *   - wait_agent         → action: "wait"
+ *
+ * L'UNIFICATION est intentionnelle :
+ *   - Un seul appel MCP pour la toolbox du client (pas 4 imports)
+ *   - Cohérence des paramètres (agentName, runner, config communs)
+ *   - Comportement déterministe : chaque action a une sémantique claire
+ *   - Debugging simplifié : une seule source de vérité
+ *
+ * ─── SÉMANTIQUE DES ACTIONS ──────────────────────────────────────────────────
+ *
+ * status ─── Lecture pure, zero side-effect
+ *   → Retourne l'état courant du process (pid, status, sessionId, outputBuffer)
+ *   → NE MODIFIE PAS le registry (pas de mise à jour de timestamps artificiels)
+ *   → Use-case : dashboard, polling léger, diagnostic
+ *
+ * stream ─── Lecture + indicateur de complétude
+ *   → Retourne outputBuffer ET un flag isComplete
+ *   → Use-case : récupérer la sortie en temps réel sans savoir si c'est fini
+ *   → Option sinceTimestamp pour ne récupérer que le增量 (si implémenté)
+ *
+ * kill ─── Action destructive, irréversible
+ *   → Tue le process tree via taskkill /F /T (Windows) ou kill -9 (Unix)
+ *   → Met à jour le status → 'failed' dans le registry
+ *   → Use-case : abort d'urgence, kill-switch
+ *
+ * wait ─── Blocage async avec polling
+ *   → Poll toutes les 1s jusqu'à status !== 'running' ou timeout
+ *   → Retourne le résultat final (outputBuffer ou erreur)
+ *   → Use-case : synchronisation dans un workflow d'orchestration
+ *
+ * ─── ÉTATS DU PROCESS ─────────────────────────────────────────────────────────
+ *
+ * running  → Process actif, PID valide, output en cours d'accumulation
+ * done     → Process terminé avec code 0, outputBuffer gelé
+ * failed   → Process terminé avec erreur (exit code != 0 ou crash)
+ * orphaned → Parent mort mais child tourne encore (detecté via isPidAlive)
+ *
+ * ─── ERREURS COMMUNES ─────────────────────────────────────────────────────────
+ *
+ * AGENT_NOT_FOUND    → Agent absent du registry (jamais lancé ou déjà nettoyé)
+ * AGENT_NOT_RUNNING  → Action "kill" sur un agent déjà terminé
+ * KILL_FAILED        → taskkill/kill a échoué (pas assez de permissions, etc.)
+ * WAIT_TIMEOUT       → Action "wait" a atteint le timeout sans terminaison
+ * ORPHANED_PROCESS    → Status 'orphaned' détecté (process zombie)
+ *
+ * ─── EXEMPLES ─────────────────────────────────────────────────────────────────
+ *
+ * // Vérifier si un agent tourne encore
+ * agent_control({ agentName: "sniper_analyst", runner: "kilo", action: "status" })
+ *
+ * // Récupérer la sortie sans bloquer
+ * agent_control({ agentName: "sniper_analyst", runner: "kilo", action: "stream" })
+ *
+ * // Forcer l'arrêt d'un agent
+ * agent_control({ agentName: "sniper_analyst", runner: "kilo", action: "kill" })
+ *
+ * // Attendre la fin d'un agent (max 5 min)
+ * agent_control({ agentName: "sniper_analyst", runner: "kilo", action: "wait", timeoutMs: 300000 })
+ */
+// ─── SCHÉMA ZOD ────────────────────────────────────────────────────────────────
+export const agentControlSchema = z
+    .object({
+    agentName: z.string().describe('Nom unique de l agent à contrôler'),
+    runner: z
+        .enum(['claude', 'gemini', 'kilo', 'qwencli', 'openclaw', 'cline', 'opencode', 'hermes'])
+        .optional()
+        .describe("Type de runner de l'agent (optionnel — déduit du registry si omis)"),
+    config: z
+        .string()
+        .optional()
+        .describe('Chemin racine Overmind (dossier contenant .claude/)'),
+    action: z
+        .enum(['status', 'stream', 'kill', 'wait'])
+        .describe('Action à effectuer.\n' +
+        '  status  — Lire l\'état courant (pid, status, sessionId, outputBuffer)\n' +
+        '  stream  — Lire l\'output en temps réel + flag isComplete\n' +
+        '  kill    — Forcer l\'arrêt du process tree (irréversible)\n' +
+        '  wait    — Bloquer jusqu\'à terminaison naturelle (max timeoutMs)'),
+    timeoutMs: z
+        .number()
+        .optional()
+        .default(900000)
+        .describe('Timeout pour action="wait" en ms (défaut: 900000 = 15 min)'),
+    sinceTimestamp: z
+        .number()
+        .optional()
+        .describe('Pour action="stream" : ne retourner que l\'output après ce timestamp (ms epoch)'),
+})
+    .passthrough();
+/** Construit un rapport d'état formaté depuis une ProcessEntry */
+function formatStatus(entry, _action) {
+    const lines = [];
+    lines.push(`**Agent:** ${entry.agentName}`);
+    lines.push(`**Runner:** ${entry.runner || 'inconnu'}`);
+    lines.push(`**Status:** ${entry.status}`);
+    lines.push(`**Started:** ${new Date(entry.ts).toISOString()}`);
+    if (entry.pid)
+        lines.push(`**PID:** ${entry.pid}`);
+    if (entry.id)
+        lines.push(`**Session ID:** ${entry.id}`);
+    if (entry.exitCode !== null && entry.exitCode !== undefined) {
+        lines.push(`**Exit Code:** ${entry.exitCode}`);
+    }
+    if (entry.lastOutputAt) {
+        lines.push(`**Last Output:** ${new Date(entry.lastOutputAt).toISOString()}`);
+    }
+    const bufLen = entry.outputBuffer?.length ?? 0;
+    if (bufLen > 0) {
+        lines.push(`\n**Output Buffer (${bufLen} chars):**`);
+        // On limite l'output dans le rapport à 2000 derniers caractères
+        const preview = entry.outputBuffer.slice(-2000);
+        lines.push('```');
+        lines.push(preview);
+        lines.push('```');
+    }
+    else {
+        lines.push('\n_(output vide ou pas encore de sortie)_');
+    }
+    return lines.join('\n');
+}
+/** Récupère l'entrée depuis le registry ou retourne une erreur structurée */
+async function resolveEntry(agentName, runner, configPath) {
+    const entry = await getProcessStatus(agentName, runner, configPath);
+    if (!entry) {
+        return {
+            error: `Agent "${agentName}" (runner: ${runner || 'any'}) non trouvé dans le registry. ` +
+                `Il n'est pas en cours d'exécution ou a été nettoyé (TTL 1h après terminaison).`,
+            code: 'AGENT_NOT_FOUND',
+        };
+    }
+    return entry;
+}
+/** Action STATUS — lecture pure */
+async function doStatus(agentName, runner, configPath) {
+    const resolved = await resolveEntry(agentName, runner, configPath);
+    if ('error' in resolved) {
+        return { content: [{ type: 'text', text: resolved.error }], isError: true };
+    }
+    const isZombie = resolved.status === 'running' && !!resolved.pid;
+    return {
+        content: [{ type: 'text', text: formatStatus(resolved, 'status') }],
+        isError: isZombie,
+    };
+}
+/** Action STREAM — lecture + complétude */
+async function doStream(agentName, runner, configPath, sinceTimestamp) {
+    const resolved = await resolveEntry(agentName, runner, configPath);
+    if ('error' in resolved) {
+        return { content: [{ type: 'text', text: resolved.error }], isError: true };
+    }
+    const isComplete = resolved.status === 'done' ||
+        resolved.status === 'failed' ||
+        resolved.status === 'orphaned';
+    const output = resolved.outputBuffer || '';
+    // Filtering by sinceTimestamp is best-effort if lastOutputAt is available
+    if (sinceTimestamp && resolved.lastOutputAt && resolved.lastOutputAt > sinceTimestamp) {
+        // NOTE: per-chunk timestamps ne sont pas encore implémentés dans processRegistry.
+        // Pour l'instant on retourne tout l'outputBuffer. La filtering precise
+        // nécéssite d'ajouter un tableau de chunks avec timestamps dans ProcessEntry.
+    }
+    const lines = [];
+    lines.push(`**Agent:** ${resolved.agentName}`);
+    lines.push(`**Status:** ${resolved.status}`);
+    lines.push(`**isComplete:** ${isComplete}`);
+    if (resolved.pid)
+        lines.push(`**PID:** ${resolved.pid}`);
+    if (resolved.lastOutputAt) {
+        lines.push(`**Last Output At:** ${new Date(resolved.lastOutputAt).toISOString()}`);
+    }
+    lines.push(`\n**Output (${output.length} chars):**`);
+    lines.push('```');
+    lines.push(output || '(no output yet)');
+    lines.push('```');
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: isComplete && resolved.status === 'failed',
+    };
+}
+/** Action KILL — destruction */
+async function doKill(agentName, runner, configPath) {
+    const resolved = await resolveEntry(agentName, runner, configPath);
+    if ('error' in resolved) {
+        return { content: [{ type: 'text', text: resolved.error }], isError: true };
+    }
+    if (resolved.status !== 'running') {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Agent "${agentName}" n'est pas en cours d'exécution (status: ${resolved.status}). ` +
+                        `Impossible de tuer un agent déjà terminé.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const killResult = await killAgent(agentName, runner, configPath);
+    if (!killResult.killed) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Échec du kill pour "${agentName}". ` +
+                        `Le process n'a pas pu être terminé (possible: permissions insuffisantes, ` +
+                        `process déjà terminé entre-temps).`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Agent "${agentName}" tué avec succès (PID: ${killResult.pid}). ` +
+                    `Status mis à jour → 'failed' dans le registry.`,
+            },
+        ],
+    };
+}
+/** Action WAIT — blocage async */
+async function doWait(agentName, runner, configPath, timeoutMs) {
+    const start = Date.now();
+    const pollInterval = 1000; // 1 seconde entre chaque poll
+    // Premier check immédiat
+    {
+        const resolved = await resolveEntry(agentName, runner, configPath);
+        if ('error' in resolved) {
+            return { content: [{ type: 'text', text: resolved.error }], isError: true };
+        }
+        if (resolved.status === 'done') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: resolved.outputBuffer || 'Agent terminé avec succès.',
+                    },
+                ],
+            };
+        }
+        if (resolved.status === 'failed' || resolved.status === 'orphaned') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Agent terminé avec erreur (${resolved.status}):\n\n${resolved.outputBuffer || 'N/A'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Boucle de polling
+    while (Date.now() - start < timeoutMs) {
+        await new Promise((r) => setTimeout(r, pollInterval));
+        const resolved = await resolveEntry(agentName, runner, configPath);
+        if ('error' in resolved) {
+            return { content: [{ type: 'text', text: resolved.error }], isError: true };
+        }
+        if (resolved.status === 'done') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: resolved.outputBuffer || 'Agent terminé avec succès.',
+                    },
+                ],
+            };
+        }
+        if (resolved.status === 'failed' || resolved.status === 'orphaned') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Agent terminé avec erreur (${resolved.status}):\n\n${resolved.outputBuffer || 'N/A'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Status still 'running' — continue polling
+    }
+    // Timeout atteint
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Timeout de ${timeoutMs}ms atteint. ` +
+                    `L'agent "${agentName}" est toujours en cours d'exécution (status: running). ` +
+                    `Utilisez action="kill" pour forcer l'arrêt ou augmentez timeoutMs.`,
+            },
+        ],
+        isError: true,
+    };
+}
+// ─── FONCTION PRINCIPALE ───────────────────────────────────────────────────────
+export async function agentControl(args) {
+    const { agentName, runner, config: configPath, action, timeoutMs, sinceTimestamp } = args;
+    switch (action) {
+        case 'status':
+            return doStatus(agentName, runner, configPath);
+        case 'stream':
+            return doStream(agentName, runner, configPath, sinceTimestamp);
+        case 'kill':
+            return doKill(agentName, runner, configPath);
+        case 'wait':
+            return doWait(agentName, runner, configPath, timeoutMs ?? 900000);
+    }
+}
+//# sourceMappingURL=agent_control.js.map

package/dist/tools/agent_control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_control.js","sourceRoot":"","sources":["../../src/tools/agent_control.ts"],"names":[],"mappings":"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"}

package/docs/INDEX.md

@@ -97,13 +97,18 @@ Documentation des prompts système pour chaque runner :
 - Hermes
 - Minimax 4
 
+## 🛠️ Reference des Outils
+
+### [`agent_control.md`](./agent_control.md)
+Contrôle unifié du cycle de vie des agents OverMind via le Process Registry.
+- Remplace les 4 outils précédents : get_agent_status, stream_agent_output, kill_agent, wait_agent
+- Patterns async : fire & forget, blocking wait, orchestration séquentielle, fan-out parallèle
+- Dashboard temps réel par PID
+- Lookup par sessionId, timestamp, PID
+- Codes d'erreur structurés
+
 ### [`api/tools.md`](./api/tools.md)
-Référence complète des outils MCP :
-- `run_agent` - Exécuter un agent
-- `create_agent` - Créer un nouvel agent
-- `list_agents` - Lister les agents
-- `memory_search` - Recherche mémoire
-- `run_agents_parallel` - Exécution parallèle
+Référence complète des outils MCP (14 outils)
 
 ## 📝 Changelog