overmind-mcp 3.4.3 → 3.5.0

package/dist/services/HermesGatewayManager.d.ts

@@ -0,0 +1,92 @@
+/**
+ * HermesGatewayManager — Manages the Hermes API Server lifecycle.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║  PURPOSE                                                              ║
+ * ║                                                                      ║
+ * ║  Singleton that detects, validates, and ensures the Hermes API        ║
+ * ║  Server (gateway/platforms/api_server.py) is reachable.               ║
+ * ║                                                                      ║
+ * ║  The API Server is a platform adapter inside the Hermes gateway       ║
+ * ║  process. It exposes an OpenAI-compatible HTTP+SSE API:               ║
+ * ║                                                                      ║
+ * ║    GET  /health                → {"status": "ok", ...}               ║
+ * ║    GET  /v1/models             → OpenAI model list                    ║
+ * ║    GET  /v1/capabilities       → Feature flags                       ║
+ * ║    POST /v1/chat/completions   → Chat (streaming SSE or JSON)        ║
+ * ║    POST /v1/responses          → Responses API (stateful)            ║
+ * ║    POST /v1/runs               → Async run (returns run_id)          ║
+ * ║    GET  /v1/runs/{id}/events   → SSE lifecycle events                ║
+ * ║    POST /v1/runs/{id}/stop     → Interrupt a run                     ║
+ * ║    POST /v1/runs/{id}/approval → Resolve pending approval            ║
+ * ║                                                                      ║
+ * ║  Configuration (read from Hermes .env):                               ║
+ * ║    API_SERVER_ENABLED=1        → enables the adapter                 ║
+ * ║    API_SERVER_KEY=<secret>     → Bearer token for auth               ║
+ * ║    API_SERVER_PORT=8642        → listen port (default: 8642)         ║
+ * ║    API_SERVER_HOST=127.0.0.1   → listen host (default: loopback)    ║
+ * ║                                                                      ║
+ * ║  This manager does NOT start the gateway — that's Hermes' job         ║
+ * ║  (via `hermes gateway start`). It only detects and health-checks.     ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+export interface GatewayInfo {
+    /** Base URL of the API server, e.g. http://127.0.0.1:8642 */
+    url: string;
+    /** Bearer token for Authorization header */
+    apiKey: string;
+    /** Port the server listens on */
+    port: number;
+    /** Host the server listens on */
+    host: string;
+    /** True if the last health check succeeded */
+    healthy: boolean;
+    /** PID of the gateway process (from health/detailed), if available */
+    pid: number | null;
+    /** Hermes version reported by the server */
+    version: string | null;
+}
+/**
+ * Singleton manager for the Hermes API Server connection.
+ *
+ * Call `await HermesGatewayManager.getInstance()` to get a healthy gateway
+ * info object. The first call probes the server; subsequent calls return
+ * the cached state with periodic re-validation.
+ */
+export declare class HermesGatewayManager {
+    private static instance;
+    private cachedInfo;
+    private lastHealthCheck;
+    private readonly HEALTH_CHECK_TTL_MS;
+    private constructor();
+    static getInstance(): HermesGatewayManager;
+    /**
+     * Probe the API server health endpoint.
+     * Returns the raw JSON response or null on failure.
+     */
+    private probeHealth;
+    /**
+     * Get detailed health info (includes PID, gateway state, platform status).
+     */
+    getDetailedHealth(): Promise<Record<string, unknown> | null>;
+    /**
+     * Ensure the API server is reachable. Probes health, caches result.
+     *
+     * @param forceRefresh Skip the cache TTL and re-probe.
+     * @returns GatewayInfo if healthy, null if unreachable.
+     */
+    ensureReady(forceRefresh?: boolean): Promise<GatewayInfo | null>;
+    /**
+     * Check if the gateway is ready (quick boolean check).
+     */
+    isReady(): Promise<boolean>;
+    /**
+     * Get cached info without probing. Returns last known state.
+     */
+    getCachedInfo(): GatewayInfo | null;
+    /**
+     * Force a fresh health check on next ensureReady() call.
+     */
+    invalidate(): void;
+}
+//# sourceMappingURL=HermesGatewayManager.d.ts.map

package/dist/services/HermesGatewayManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HermesGatewayManager.d.ts","sourceRoot":"","sources":["../../src/services/HermesGatewayManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AASH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA8FD;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAE9C,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;;OAGG;YACW,WAAW;IAczB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAgBlE;;;;;OAKG;IACG,WAAW,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA+DpE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjC;;OAEG;IACH,aAAa,IAAI,WAAW,GAAG,IAAI;IAInC;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/services/HermesGatewayManager.js

@@ -0,0 +1,255 @@
+/**
+ * HermesGatewayManager — Manages the Hermes API Server lifecycle.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║  PURPOSE                                                              ║
+ * ║                                                                      ║
+ * ║  Singleton that detects, validates, and ensures the Hermes API        ║
+ * ║  Server (gateway/platforms/api_server.py) is reachable.               ║
+ * ║                                                                      ║
+ * ║  The API Server is a platform adapter inside the Hermes gateway       ║
+ * ║  process. It exposes an OpenAI-compatible HTTP+SSE API:               ║
+ * ║                                                                      ║
+ * ║    GET  /health                → {"status": "ok", ...}               ║
+ * ║    GET  /v1/models             → OpenAI model list                    ║
+ * ║    GET  /v1/capabilities       → Feature flags                       ║
+ * ║    POST /v1/chat/completions   → Chat (streaming SSE or JSON)        ║
+ * ║    POST /v1/responses          → Responses API (stateful)            ║
+ * ║    POST /v1/runs               → Async run (returns run_id)          ║
+ * ║    GET  /v1/runs/{id}/events   → SSE lifecycle events                ║
+ * ║    POST /v1/runs/{id}/stop     → Interrupt a run                     ║
+ * ║    POST /v1/runs/{id}/approval → Resolve pending approval            ║
+ * ║                                                                      ║
+ * ║  Configuration (read from Hermes .env):                               ║
+ * ║    API_SERVER_ENABLED=1        → enables the adapter                 ║
+ * ║    API_SERVER_KEY=<secret>     → Bearer token for auth               ║
+ * ║    API_SERVER_PORT=8642        → listen port (default: 8642)         ║
+ * ║    API_SERVER_HOST=127.0.0.1   → listen host (default: loopback)    ║
+ * ║                                                                      ║
+ * ║  This manager does NOT start the gateway — that's Hermes' job         ║
+ * ║  (via `hermes gateway start`). It only detects and health-checks.     ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { rootLogger } from '../lib/logger.js';
+const logger = rootLogger.child({ module: 'HermesGatewayManager' });
+/**
+ * Resolve the Hermes home directory.
+ * On Windows: AppData\Local\hermes (official install)
+ * On Linux/macOS: ~/.hermes
+ */
+function getHermesHome() {
+    // 1. Explicit env var
+    if (process.env.HERMES_HOME)
+        return process.env.HERMES_HOME;
+    // 2. Windows official install
+    if (process.platform === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA || process.env.USERPROFILE || os.homedir();
+        return path.join(localAppData, 'hermes');
+    }
+    // 3. POSIX
+    return path.join(os.homedir(), '.hermes');
+}
+/**
+ * Read API_SERVER_KEY from the Hermes .env file.
+ * The key is required by the API server for Bearer auth.
+ */
+function readApiKeyFromEnv() {
+    const hermesHome = getHermesHome();
+    const envPath = path.join(hermesHome, '.env');
+    try {
+        const content = fs.readFileSync(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('API_SERVER_KEY=')) {
+                const value = trimmed.slice('API_SERVER_KEY='.length).trim();
+                // Remove surrounding quotes if present
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    return value.slice(1, -1);
+                }
+                return value;
+            }
+        }
+    }
+    catch {
+        // .env not found or unreadable
+    }
+    // Fallback: environment variable
+    return process.env.API_SERVER_KEY || null;
+}
+/** Read port from .env or use default */
+function readPortFromEnv() {
+    const hermesHome = getHermesHome();
+    const envPath = path.join(hermesHome, '.env');
+    try {
+        const content = fs.readFileSync(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('API_SERVER_PORT=')) {
+                const port = parseInt(trimmed.slice('API_SERVER_PORT='.length).trim(), 10);
+                if (!isNaN(port) && port > 0 && port < 65536)
+                    return port;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Fallback: env var or default
+    const envPort = parseInt(process.env.API_SERVER_PORT || '', 10);
+    return !isNaN(envPort) && envPort > 0 ? envPort : 8642;
+}
+/** Read host from .env or use default */
+function readHostFromEnv() {
+    const hermesHome = getHermesHome();
+    const envPath = path.join(hermesHome, '.env');
+    try {
+        const content = fs.readFileSync(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('API_SERVER_HOST=')) {
+                return trimmed.slice('API_SERVER_HOST='.length).trim().replace(/['"]/g, '');
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return process.env.API_SERVER_HOST || '127.0.0.1';
+}
+/**
+ * Singleton manager for the Hermes API Server connection.
+ *
+ * Call `await HermesGatewayManager.getInstance()` to get a healthy gateway
+ * info object. The first call probes the server; subsequent calls return
+ * the cached state with periodic re-validation.
+ */
+export class HermesGatewayManager {
+    static instance = null;
+    cachedInfo = null;
+    lastHealthCheck = 0;
+    HEALTH_CHECK_TTL_MS = 10_000; // re-check at most every 10s
+    constructor() { }
+    static getInstance() {
+        if (!HermesGatewayManager.instance) {
+            HermesGatewayManager.instance = new HermesGatewayManager();
+        }
+        return HermesGatewayManager.instance;
+    }
+    /**
+     * Probe the API server health endpoint.
+     * Returns the raw JSON response or null on failure.
+     */
+    async probeHealth(baseUrl, apiKey) {
+        try {
+            const response = await fetch(`${baseUrl}/health`, {
+                method: 'GET',
+                headers: { Authorization: `Bearer ${apiKey}` },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get detailed health info (includes PID, gateway state, platform status).
+     */
+    async getDetailedHealth() {
+        const info = await this.ensureReady();
+        if (!info)
+            return null;
+        try {
+            const response = await fetch(`${info.url}/health/detailed`, {
+                method: 'GET',
+                headers: { Authorization: `Bearer ${info.apiKey}` },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Ensure the API server is reachable. Probes health, caches result.
+     *
+     * @param forceRefresh Skip the cache TTL and re-probe.
+     * @returns GatewayInfo if healthy, null if unreachable.
+     */
+    async ensureReady(forceRefresh = false) {
+        const now = Date.now();
+        if (!forceRefresh &&
+            this.cachedInfo &&
+            this.cachedInfo.healthy &&
+            now - this.lastHealthCheck < this.HEALTH_CHECK_TTL_MS) {
+            return this.cachedInfo;
+        }
+        // Read config from Hermes .env
+        const apiKey = readApiKeyFromEnv();
+        const port = readPortFromEnv();
+        const host = readHostFromEnv();
+        const baseUrl = `http://${host}:${port}`;
+        if (!apiKey) {
+            logger.warn('[HermesGatewayManager] API_SERVER_KEY not found in Hermes .env — API server not configured.');
+            this.cachedInfo = {
+                url: baseUrl,
+                apiKey: '',
+                port,
+                host,
+                healthy: false,
+                pid: null,
+                version: null,
+            };
+            return null;
+        }
+        // Probe health
+        const health = await this.probeHealth(baseUrl, apiKey);
+        const healthy = health?.status === 'ok';
+        this.cachedInfo = {
+            url: baseUrl,
+            apiKey,
+            port,
+            host,
+            healthy,
+            pid: null,
+            version: health?.version || null,
+        };
+        this.lastHealthCheck = now;
+        if (healthy) {
+            logger.info({ url: baseUrl, version: this.cachedInfo.version }, '[HermesGatewayManager] ✅ API server healthy.');
+        }
+        else {
+            logger.warn({ url: baseUrl }, '[HermesGatewayManager] ⚠️ API server not reachable. Run `hermes gateway restart` after setting API_SERVER_ENABLED=1.');
+        }
+        return healthy ? this.cachedInfo : null;
+    }
+    /**
+     * Check if the gateway is ready (quick boolean check).
+     */
+    async isReady() {
+        const info = await this.ensureReady();
+        return info !== null;
+    }
+    /**
+     * Get cached info without probing. Returns last known state.
+     */
+    getCachedInfo() {
+        return this.cachedInfo;
+    }
+    /**
+     * Force a fresh health check on next ensureReady() call.
+     */
+    invalidate() {
+        this.lastHealthCheck = 0;
+    }
+}
+//# sourceMappingURL=HermesGatewayManager.js.map

package/dist/services/HermesGatewayManager.js.map

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

package/dist/services/HermesGatewayRunner.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 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.                    ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+export interface GatewayRunOptions {
+    prompt: string;
+    agentName?: string;
+    sessionId?: string;
+    autoResume?: boolean;
+    model?: string;
+    provider?: string;
+    signal?: AbortSignal;
+    silent?: boolean;
+    /** Profile name for Hermes (maps to -p flag in spawn mode) */
+    profile?: string;
+}
+export interface GatewayRunResult {
+    result: string;
+    sessionId?: string;
+    error?: string;
+    rawOutput?: string;
+    model?: string;
+    /** How the run was executed */
+    transport: 'gateway-http' | 'fallback-spawn';
+}
+/**
+ * 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 declare class HermesGatewayRunner {
+    private manager;
+    constructor();
+    /**
+     * 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.
+     */
+    runAgent(options: GatewayRunOptions): Promise<GatewayRunResult>;
+    /**
+     * Execute a chat completion against the API server.
+     *
+     * Uses streaming SSE to get real-time output, assembling the final
+     * text from delta chunks.
+     */
+    private executeChat;
+    /**
+     * 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.
+     */
+    private parseSSEStream;
+}
+//# sourceMappingURL=HermesGatewayRunner.d.ts.map

package/dist/services/HermesGatewayRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HermesGatewayRunner.d.ts","sourceRoot":"","sources":["../../src/services/HermesGatewayRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAiBH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,SAAS,EAAE,cAAc,GAAG,gBAAgB,CAAC;CAC9C;AAQD;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAuB;;IAMtC;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuFrE;;;;;OAKG;YACW,WAAW;IAwEzB;;;;;;;;;OASG;YACW,cAAc;CA8D7B"}

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IACpF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACvF,oGAAoG;IACpG,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpD,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAqC;IACxE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,iBAAiB;IACrE,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B,EAAE,CAAC;YACvF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,EACJ,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,SAAS,EACjB,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,YAAY,GACb,GAAG,IAAI,CAAC;IACT,MAAM,SAAS,GAAG,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/C,MAAM,WAAW,GAAG,SAAS,IAAI,eAAe,EAAE,CAAC;IAEnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,6EAA6E;IAC7E,uEAAuE;IACvE,mEAAmE;IACnE,sEAAsE;IACtE,MAAM,aAAa,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC;QAC5C,MAAM;QACN,SAAS;QACT,UAAU;QACV,SAAS;QACT,KAAK;QACL,QAAQ;QACR,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,MAAkG,CAAC;IAEvG,uEAAuE;IACvE,IAAI,QAAQ,CAAC,SAAS,KAAK,gBAAgB,IAAI,QAAQ,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;QACtF,MAAM,WAAW,GAAG,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;YAClC,MAAM;YACN,SAAS;YACT,UAAU;YACV,SAAS;YACT,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,WAAW;YACvB,MAAM;YACN,KAAK;YACL,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;QAEH,iFAAiF;QACjF,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/E,IAAI,SAAS;gBAAE,MAAM,eAAe,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YACvE,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;gBAClC,MAAM;gBACN,SAAS;gBACT,UAAU,EAAE,KAAK;gBACjB,SAAS,EAAE,SAAS;gBACpB,GAAG,EAAE,SAAS;gBACd,UAAU,EAAE,WAAW;gBACvB,MAAM;gBACN,KAAK;gBACL,QAAQ;gBACR,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IACtC,yFAAyF;IACzF,oFAAoF;IACpF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC;gBACb,MAAM,EAAE,QAAQ;gBAChB,SAAS;gBACT,MAAM;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU;gBACV,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK;gBACtB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,uFAAuF;YACvF,OAAO,CAAC,KAAK,CACX,wCAAwC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK;QACd,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;YAC9C,GAAG,CAAC,MAAM,CAAC,SAAS;gBAClB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;gBACtE,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC"}

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.3",
+  "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",