overmind-mcp 3.4.2 → 3.5.0

package/dist/services/HermesGatewayRunner.js

@@ -0,0 +1,249 @@
+/**
+ * HermesGatewayRunner — HTTP-based runner for the Hermes API Server.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║  ARCHITECTURE (v3.5 — Gateway Integration)                           ║
+ * ║                                                                      ║
+ * ║  Replaces the subprocess spawn in HermesRunner with HTTP+SSE calls    ║
+ * ║  to the Hermes API Server (gateway/platforms/api_server.py).          ║
+ * ║                                                                      ║
+ * ║  BENEFITS over HermesRunner (spawn):                                 ║
+ * ║    - No Python startup per call (~5-10s saved)                        ║
+ * ║    - SSE streaming output in real-time                                ║
+ * ║    - Native session management via X-Hermes-Session-Id header         ║
+ * ║    - Proper abort via fetch AbortController                           ║
+ * ║    - Model/provider swap via config, not CLI flags                    ║
+ * ║                                                                      ║
+ * ║  ENDPOINTS USED:                                                     ║
+ * ║    POST /v1/chat/completions   → main chat (streaming SSE or JSON)   ║
+ * ║    GET  /health                → connectivity check                  ║
+ * ║                                                                      ║
+ * ║  FALLBACK:                                                           ║
+ * ║    If the API server is not running, falls back to HermesRunner       ║
+ * ║    (subprocess spawn) for backward compatibility.                    ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { HermesGatewayManager } from './HermesGatewayManager.js';
+import { registerLiveAgent, appendLiveOutput, setLiveStatus, unregisterLiveAgent, } from '../lib/agent_lifecycle.js';
+import { registerProcess } from '../lib/processRegistry.js';
+import { withSpan } from '../lib/telemetry.js';
+import { rootLogger } from '../lib/logger.js';
+import { saveSessionId, getLastSessionId } from '../lib/sessions.js';
+import { getWorkspaceDir } from '../lib/config.js';
+const logger = rootLogger.child({ module: 'HermesGatewayRunner' });
+/** Pseudo-PID for gateway runs (no real OS process to track) */
+let gatewayPidCounter = 70000;
+/** In-memory session map for gateway runs: agentName → sessionId */
+const gatewaySessions = new Map();
+/**
+ * Runner that talks to the Hermes API Server via HTTP+SSE.
+ *
+ * Falls back to HermesRunner (subprocess spawn) if the API server is not
+ * available — ensuring zero downtime during the migration.
+ */
+export class HermesGatewayRunner {
+    manager;
+    constructor() {
+        this.manager = HermesGatewayManager.getInstance();
+    }
+    /**
+     * Run a prompt against the Hermes API Server.
+     *
+     * If the server is not reachable, returns an error with transport='fallback-spawn'
+     * so the caller can decide to use the old HermesRunner.
+     */
+    async runAgent(options) {
+        const { agentName } = options;
+        let { sessionId } = options;
+        // ─── Resolve session ──────────────────────────────────────────────────
+        if (options.autoResume && agentName && !sessionId) {
+            // Try in-memory gateway sessions first
+            const gwSession = gatewaySessions.get(agentName);
+            if (gwSession) {
+                sessionId = gwSession;
+            }
+            else {
+                // Fall back to persisted sessions (from spawn mode)
+                const lastId = await getLastSessionId(agentName, getWorkspaceDir(), 'hermes');
+                if (lastId) {
+                    sessionId = lastId;
+                    logger.info({ sessionId }, '[GatewayRunner] Auto-resume from persisted sessions.');
+                }
+            }
+        }
+        return withSpan('hermes.gateway.runAgent', async (span) => {
+            span.setAttribute('agentName', agentName || '');
+            span.setAttribute('transport', 'gateway-http');
+            // ─── Ensure gateway is ready ──────────────────────────────────────
+            const gw = await this.manager.ensureReady();
+            if (!gw) {
+                return {
+                    result: '',
+                    error: 'GATEWAY_NOT_READY',
+                    transport: 'fallback-spawn',
+                };
+            }
+            // ─── Register a pseudo-agent for lifecycle tracking ───────────────
+            const pseudoPid = ++gatewayPidCounter;
+            const abortController = new AbortController();
+            registerLiveAgent({
+                pid: pseudoPid,
+                runner: 'hermes-gateway',
+                agentName: agentName || 'anonymous',
+                sessionId: sessionId || '',
+                abortController,
+                cleanupFn: async () => {
+                    abortController.abort();
+                },
+                childRef: null, // No child process — HTTP-based
+            });
+            // Also register in processRegistry for cross-system visibility
+            void registerProcess(pseudoPid, {
+                agentName: agentName || '',
+                runner: 'hermes-gateway',
+                configPath: getWorkspaceDir(),
+            });
+            try {
+                const result = await this.executeChat(gw, options, sessionId, pseudoPid, abortController.signal);
+                // Save session linkage
+                if (result.sessionId && agentName) {
+                    gatewaySessions.set(agentName, result.sessionId);
+                    await saveSessionId(agentName, result.sessionId, getWorkspaceDir(), 'hermes');
+                }
+                setLiveStatus(pseudoPid, result.error ? 'failed' : 'done', result.error ? 1 : 0);
+                return result;
+            }
+            catch (error) {
+                const errMsg = error instanceof Error ? error.message : String(error);
+                logger.error({ error: errMsg, agentName }, '[GatewayRunner] Run failed.');
+                setLiveStatus(pseudoPid, 'failed', 1);
+                return {
+                    result: '',
+                    error: `GATEWAY_ERROR: ${errMsg}`,
+                    transport: 'gateway-http',
+                };
+            }
+            finally {
+                unregisterLiveAgent(pseudoPid);
+            }
+        }, { agentName: agentName || '', transport: 'gateway-http' });
+    }
+    /**
+     * Execute a chat completion against the API server.
+     *
+     * Uses streaming SSE to get real-time output, assembling the final
+     * text from delta chunks.
+     */
+    async executeChat(gw, options, sessionId, pseudoPid, externalSignal) {
+        const { prompt, agentName, silent } = options;
+        // Build request headers
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${gw.apiKey}`,
+        };
+        // Session management via header
+        if (sessionId) {
+            headers['X-Hermes-Session-Id'] = sessionId;
+        }
+        // Profile selection via header (maps to -p <profile>)
+        const profile = options.profile || agentName;
+        if (profile && profile !== 'default') {
+            headers['X-Hermes-Profile'] = profile;
+        }
+        // Build request body (OpenAI chat completions format)
+        const body = {
+            model: options.model || 'hermes-agent',
+            messages: [{ role: 'user', content: prompt }],
+            stream: true, // Always stream — we assemble the final text
+        };
+        // Combine abort signals
+        const combinedSignal = externalSignal;
+        logger.info({ url: gw.url, agentName, sessionId: sessionId?.slice(0, 20), profile }, '[GatewayRunner] POST /v1/chat/completions (streaming)');
+        const response = await fetch(`${gw.url}/v1/chat/completions`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: combinedSignal,
+        });
+        if (!response.ok) {
+            const errText = await response.text().catch(() => '(no body)');
+            return {
+                result: '',
+                error: `HTTP_${response.status}: ${errText.slice(0, 500)}`,
+                transport: 'gateway-http',
+            };
+        }
+        // ─── Parse SSE stream ────────────────────────────────────────────────
+        const fullText = await this.parseSSEStream(response, pseudoPid, silent, agentName);
+        // Extract session ID from response headers
+        const responseSessionId = response.headers.get('x-hermes-session-id') || undefined;
+        return {
+            result: fullText.trim(),
+            sessionId: responseSessionId || sessionId,
+            rawOutput: fullText,
+            model: options.model,
+            transport: 'gateway-http',
+        };
+    }
+    /**
+     * Parse the SSE stream from /v1/chat/completions.
+     *
+     * Format (OpenAI-compatible):
+     *   data: {"choices":[{"delta":{"content":"hello"}}]}
+     *   data: {"choices":[{"delta":{"content":" world"}}]}
+     *   data: [DONE]
+     *
+     * Assembles full text, streams chunks to agent_lifecycle in real-time.
+     */
+    async parseSSEStream(response, pseudoPid, silent, agentName) {
+        let fullText = '';
+        const reader = response.body?.getReader();
+        if (!reader) {
+            throw new Error('No response body for SSE stream');
+        }
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // Process complete SSE events (separated by \n\n)
+                const events = buffer.split('\n\n');
+                buffer = events.pop() || ''; // Keep incomplete chunk in buffer
+                for (const event of events) {
+                    const line = event.trim();
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const data = line.slice(6); // Remove "data: " prefix
+                    // End of stream
+                    if (data === '[DONE]')
+                        continue;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const delta = parsed.choices?.[0]?.delta;
+                        if (delta?.content) {
+                            const chunk = delta.content;
+                            fullText += chunk;
+                            // Stream to agent_lifecycle for real-time output
+                            appendLiveOutput(pseudoPid, chunk);
+                            // Also write to stderr for live monitoring (matching HermesRunner pattern)
+                            if (!silent && agentName) {
+                                process.stderr.write(`[HermesGW:${agentName}] ${chunk}`);
+                            }
+                        }
+                    }
+                    catch {
+                        // Non-JSON line (e.g., comments) — skip
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock?.();
+        }
+        return fullText;
+    }
+}
+//# sourceMappingURL=HermesGatewayRunner.js.map

package/dist/services/HermesGatewayRunner.js.map

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

package/dist/tools/run_hermes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_hermes.d.ts","sourceRoot":"","sources":["../../src/tools/run_hermes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAqBZ,CAAC;AAIjB,wBAAsB,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC;;;;;;;;;;;;GA8FzE"}
+{"version":3,"file":"run_hermes.d.ts","sourceRoot":"","sources":["../../src/tools/run_hermes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAqBZ,CAAC;AAIjB,wBAAsB,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC;;;;;;;;;;;;GAsHzE"}

package/dist/tools/run_hermes.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { HermesRunner } from '../services/HermesRunner.js';
+import { HermesGatewayRunner } from '../services/HermesGatewayRunner.js';
 import { storeRun } from '../memory/MemoryFactory.js';
 import { getWorkspaceDir } from '../lib/config.js';
 import { deleteSessionId } from '../lib/sessions.js';
@@ -35,32 +36,34 @@ export async function runHermesAgent(args) {
             isError: true,
         };
     }
-    const runner = new HermesRunner();
     const { prompt, agentName, autoResume, sessionId, path: argPath, config: argConfig, silent, model, provider, signal, overmindMode, } = args;
     const finalPath = argPath || getWorkspaceDir();
     const finalConfig = argConfig || getWorkspaceDir();
     const start = Date.now();
-    let result = await runner.runAgent({
+    // ─── Try Gateway HTTP first, fall back to subprocess spawn ────────────────
+    // The Hermes API Server (port 8642) provides HTTP+SSE chat without the
+    // ~5-10s Python startup overhead per call. If it's not running, we
+    // transparently fall back to the old HermesRunner (subprocess spawn).
+    const gatewayRunner = new HermesGatewayRunner();
+    const gwResult = await gatewayRunner.runAgent({
         prompt,
         agentName,
         autoResume,
         sessionId,
-        cwd: finalPath,
-        configPath: finalConfig,
-        silent,
         model,
         provider,
         signal,
+        silent,
     });
-    // Retry if session invalid
-    if (result.error?.includes('session') || result.error?.includes('EXIT_CODE_1')) {
-        if (agentName)
-            await deleteSessionId(agentName, finalConfig, 'hermes');
-        result = await runner.runAgent({
+    let result;
+    // If gateway returned GATEWAY_NOT_READY, fall back to subprocess spawn
+    if (gwResult.transport === 'fallback-spawn' || gwResult.error === 'GATEWAY_NOT_READY') {
+        const spawnRunner = new HermesRunner();
+        result = await spawnRunner.runAgent({
             prompt,
             agentName,
-            autoResume: false,
-            sessionId: undefined,
+            autoResume,
+            sessionId,
             cwd: finalPath,
             configPath: finalConfig,
             silent,
@@ -68,6 +71,26 @@ export async function runHermesAgent(args) {
             provider,
             signal,
         });
+        // Retry if session invalid (spawn mode only — gateway handles sessions natively)
+        if (result.error?.includes('session') || result.error?.includes('EXIT_CODE_1')) {
+            if (agentName)
+                await deleteSessionId(agentName, finalConfig, 'hermes');
+            result = await spawnRunner.runAgent({
+                prompt,
+                agentName,
+                autoResume: false,
+                sessionId: undefined,
+                cwd: finalPath,
+                configPath: finalConfig,
+                silent,
+                model,
+                provider,
+                signal,
+            });
+        }
+    }
+    else {
+        result = gwResult;
     }
     const durationMs = Date.now() - start;
     // En mode Overmind (appel MCP), le run est déjà stocké par le MCP Server via memory_runs

package/dist/tools/run_hermes.js.map

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

package/docs/kanbanroadmap.md

@@ -0,0 +1,108 @@
+# Kanban Roadmap — Overmind v4.0 (FUTURE)
+
+> Statut: **DRAFT** — pas implémenté. Sauvegardé comme roadmap possible.
+> Date: 2026-07-08
+
+## Vision
+
+Overmind devient l'orchestrateur. Hermes Gateway devient le backbone d'exécution.
+Le Kanban Hermes est exposé via MCP comme **UN SEUL outil** `kanban_hub` (pas 15 outils séparés).
+
+## Architecture cible
+
+```
+OVERMIND MCP (:3099)          → Management + Orchestration
+  └─ kanban_hub (1 tool MCP)  → Wrappe `hermes kanban` CLI
+  └─ a2a_hub (1 tool MCP)     → Communication inter-workers
+  └─ run_agent, memory_*, etc → Multi-runner + PostgreSQL
+
+HERMES GATEWAY (backbone)     → Execution engine natif
+  └─ Dispatcher (tick 60s)
+  └─ Kanban board (kanban.db)
+  └─ 9 kanban_* tools (injectés aux workers)
+  └─ Dashboard + /kanban slash
+  └─ Remote gateway (OAuth)
+```
+
+## Outil MCP unique: `kanban_hub`
+
+UN SEUL outil MCP avec `action` enum (comme `a2a_hub` et `agent_control`):
+
+```typescript
+kanban_hub({
+  action: "create",       // create|list|show|complete|block|unblock|comment|link|dispatch|stats|archive|boards|watch|init
+  title: "...",           // pour create
+  assignee: "sniperbot",  // pour create
+  taskId: "t_abc123",     // pour show/complete/block/unblock/comment/archive
+  body: "...",            // pour create/comment
+  parents: ["t_001"],     // pour create (dependencies)
+  reason: "...",          // pour block
+  status: "running",      // pour list (filter)
+  board: "my-project",    // multi-board
+  // ... etc
+})
+```
+
+Avantages d'un seul outil:
+- Schema compact (1 entrée dans tools/list au lieu de 15)
+- L'agent découvre toutes les actions dans la description
+- Pattern identique à a2a_hub et agent_control (cohérent)
+- Moins de pollution du context window de l'agent
+
+## Ce qui serait supprimé d'Overmind (redondant)
+
+| Fichier | Raison |
+|---------|--------|
+| `src/services/KanbanAdapter.ts` (420 lignes) | Remplacé par `kanban_hub` MCP tool |
+| `src/lib/orchestration/dispatcher.ts` | Gateway dispatcher natif |
+| `src/bridge/ScenarioLoader.ts` (17KB) | Kanban pipeline + decompose natif |
+| YOLO_CONFIG | Retry/circuit-breaker natifs du dispatcher |
+
+## Ce qui reste dans Overmind (son vrai rôle wrapper)
+
+- `run_agent` — Multi-runner spawn direct (Mode A)
+- `create_agent` / `list_agents` / `delete_agent` / `update_agent_config`
+- `memory_search` / `memory_store` / `memory_runs` — PostgreSQL vector
+- `agent_control` — Process lifecycle
+- `a2a_hub` — Communication inter-workers HTTP
+- `kanban_hub` — Wrap Kanban Hermes (NOUVEAU, futur)
+- `config_example` / `create_prompt` / `edit_prompt`
+- `run_agents_parallel` — Pour runners non-Hermes
+
+## Phases d'implémentation (futur)
+
+### Phase 1 — Nettoyage
+- Supprimer KanbanAdapter.ts, dispatcher.ts, ScenarioLoader.ts
+- Nettoyer imports
+- Build + test
+
+### Phase 2 — Outil `kanban_hub` MCP unique
+- Créer `src/tools/kanban_hub.ts`
+- 1 schéma Zod avec `action` enum
+- Chaque action appelle `hermes kanban <verb>` via CLI
+- Enregistrer dans server.ts
+- Build + lint + test
+
+### Phase 3 — Gateway lifecycle
+- `gateway_control` intégré à `agent_control` (action: "gateway_start/stop/status")
+- Modifier install-overmind-native.sh pour démarrer gateway
+- systemd service inclut `hermes gateway start`
+
+### Phase 4 — Install scripts
+- postinstall.mjs détecte Hermes, propose install
+- verify-install.mjs vérifie gateway + kanban.db
+
+### Phase 5 — Remote Gateway
+- Documenter Desktop → Server Gateway (OAuth)
+- `docs/REMOTE_GATEWAY.md`
+
+### Phase 6 — A2A + Kanban fusion
+- a2a_hub utilise kanban_create comme fallback durable
+- Si worker HTTP injoignable → tâche kanban
+
+## Prérequis
+
+- Hermes Agent installé sur le serveur (`pip install hermes-agent` ou `hermes setup`)
+- `hermes gateway start` fonctionnel
+- `~/.hermes/kanban.db` accessible (symlink ~/.hermes → ~/.overmind/hermes)
+- Hermes v0.18.1+ (Kanban v1 complet)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overmind-mcp",
-  "version": "3.4.2",
+  "version": "3.5.0",
   "description": "Orchestrateur universel agents IA multi-modeles via MCP. Inclut le protocole 'Custom-Nickname' pour identifier vos agents avec des surnoms originaux (The Chaos Prophet, Shadow Sniper, etc.), l'isolation mémoire (Private Memory Context) et le support pour QwenCli et Nous Hermes. Installation automatique des dépendances Docker (PostgreSQL, pgvector) inclus.",
   "type": "module",
   "main": "dist/index.js",

package/scripts/auto-install.mjs

@@ -17,6 +17,7 @@ import { existsSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
+import { randomBytes } from 'crypto';
 import { createInterface } from 'readline';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -219,6 +220,7 @@ async function createEnvConfig() {
   if (!existsSync(envFile)) {
     logSection('CRÉATION CONFIGURATION');
 
+    const randomPwd = randomBytes(18).toString('base64url');
     const envContent = `# OverMind-MCP Environment Configuration
 # Généré automatiquement par npm install
 
@@ -226,8 +228,8 @@ async function createEnvConfig() {
 POSTGRES_HOST=localhost
 POSTGRES_PORT=5432
 POSTGRES_USER=postgres
-POSTGRES_PASSWORD=overmind_temp_password_change_me
-POSTGRES_DB=overmind
+POSTGRES_PASSWORD=${randomPwd}
+POSTGRES_DATABASE=overmind_memory
 
 # OpenTelemetry (optionnel)
 OTEL_ENABLED=false

package/scripts/install-dependencies.mjs

@@ -16,6 +16,7 @@ import { existsSync } from 'fs';
 import { join } from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
+import { randomBytes } from 'crypto';
 import { createInterface } from 'readline';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -299,8 +300,9 @@ async function installPostgreSQLDocker() {
       'docker', 'run', '-d',
       '--name', containerName,
       '-p', '5432:5432',
-      '-e', 'POSTGRES_PASSWORD=overmind_temp_password_change_me',
+      '-e', `POSTGRES_PASSWORD=${randomBytes(18).toString('base64url')}`,
       '-e', 'POSTGRES_USER=postgres',
+      '-e', 'POSTGRES_DB=overmind_memory',
       '-v', 'overmind_postgres_data:/var/lib/postgresql/data',
       '--restart', 'unless-stopped',
       'pgvector/pgvector:pg16'
@@ -348,7 +350,7 @@ async function installPostgreSQLDocker() {
     console.log(`   Container: ${containerName}`);
     console.log('   Port: 5432');
     console.log('   User: postgres');
-    console.log('   Password: overmind_temp_password_change_me (À CHANGER !)');
+    console.log('   Password: (généré automatiquement — voir ~/.overmind/.env)');
     console.log('   Extension: vector (pgvector)');
 
     return { type: 'docker', container: containerName, hasPgvector: true };
@@ -442,7 +444,7 @@ async function main() {
    • Container: ${installResult.container}
    • Port: 5432
    • User: postgres
-   • Password: overmind_temp_password_change_me (CHANGEZ-LE !)
+   • Password: (généré automatiquement — voir ~/.overmind/.env)
    • Extension: vector (pgvector)
 
 ═════════════════════════════════════════════════════════════════════