overmind-mcp 2.8.6 → 2.8.8

package/dist/bridge/BridgeProxy.js

@@ -0,0 +1,265 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — BridgeProxy (Daemon RPC Layer)                  ║
+ * ║                                                                      ║
+ * ║   Couche basse : transport JSON-RPC 2.0 vers Overmind MCP Server.   ║
+ * ║   Gère : reconnexion, health checks, circuit breaker, SSE streaming.║
+ * ║                                                                      ║
+ * ║   ARCHITECTURE                                                       ║
+ * ║   ─────────────                                                      ║
+ * ║   OverBridgeService → BridgeProxy → HTTP localhost:3099/mcp          ║
+ * ║                                              → Overmind MCP Server  ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { DEFAULT_BRIDGE_CONFIG, DEFAULT_CIRCUIT_CONFIG } from './types.js';
+import { createBridgeLogger, parseMcpResponseBody, withRetry, } from './utils.js';
+// ─── Circuit Breaker ───────────────────────────────────────────────────────
+class CircuitBreaker {
+    config;
+    state = 'closed';
+    failureCount = 0;
+    successCount = 0;
+    lastFailureAt = 0;
+    constructor(config) {
+        this.config = config;
+    }
+    get currentState() {
+        // Auto-transition open → half-open après resetTimeout
+        if (this.state === 'open' && Date.now() - this.lastFailureAt > this.config.resetTimeoutMs) {
+            this.state = 'half-open';
+        }
+        return this.state;
+    }
+    recordSuccess() {
+        if (this.state === 'half-open') {
+            this.successCount++;
+            if (this.successCount >= this.config.successThreshold) {
+                this.state = 'closed';
+                this.failureCount = 0;
+                this.successCount = 0;
+            }
+        }
+        else {
+            this.failureCount = 0;
+        }
+    }
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureAt = Date.now();
+        this.successCount = 0;
+        if (this.failureCount >= this.config.failureThreshold) {
+            this.state = 'open';
+        }
+    }
+    canExecute() {
+        return this.currentState !== 'open';
+    }
+}
+// ─── BridgeProxy ───────────────────────────────────────────────────────────
+export class BridgeProxy {
+    rpcId = 1;
+    config;
+    circuit;
+    log;
+    constructor(config, circuitConfig, logger) {
+        this.config = { ...DEFAULT_BRIDGE_CONFIG, ...config };
+        this.circuit = new CircuitBreaker({ ...DEFAULT_CIRCUIT_CONFIG, ...circuitConfig });
+        this.log = logger ?? createBridgeLogger('bridge-proxy');
+    }
+    get mcpUrl() {
+        return this.config.mcpUrl;
+    }
+    get agentTimeout() {
+        return this.config.agentTimeoutMs;
+    }
+    get circuitState() {
+        return this.circuit.currentState;
+    }
+    // ─── Core RPC Call ───────────────────────────────────────────────────────
+    /**
+     * Appelle un tool MCP via JSON-RPC 2.0 sur HTTP.
+     *
+     * TIMEOUT STRATEGY (3 couches) :
+     *   1. AbortController sur le fetch initial
+     *   2. Body reader avec deadline absolue
+     *   3. Promise.race per-chunk (sécurité si le serveur ne produit plus)
+     *
+     * @param toolName  Nom de l'outil MCP (ex: 'run_agent', 'memory_search')
+     * @param args      Arguments de l'outil
+     * @param timeoutMs Timeout en ms (default: config.defaultTimeoutMs)
+     */
+    async call(toolName, args, timeoutMs) {
+        const timeout = timeoutMs ?? this.config.defaultTimeoutMs;
+        // Circuit breaker gate
+        if (!this.circuit.canExecute()) {
+            throw Object.assign(new Error(`Circuit breaker OPEN — too many failures. Retry after ${this.config.retryDelayMs}ms`), { code: 'ECIRCUITOPEN' });
+        }
+        const request = {
+            jsonrpc: '2.0',
+            id: this.rpcId++,
+            method: 'tools/call',
+            params: { name: toolName, arguments: args },
+        };
+        this.log.info(`→ MCP ${toolName} (timeout: ${timeout / 1000}s)`);
+        const startTime = Date.now();
+        try {
+            const response = await this._fetch(request, timeout);
+            const elapsed = Date.now() - startTime;
+            this.circuit.recordSuccess();
+            this.log.info(`← MCP ${toolName} OK (${elapsed}ms)`);
+            return response;
+        }
+        catch (err) {
+            const error = err;
+            this.circuit.recordFailure();
+            // Erreurs transitoires → retry automatique
+            const retryable = ['ETIMEDOUT', 'EBODYREAD', 'ECONNRESET', 'ECONNREFUSED'];
+            if (retryable.includes(error?.code ?? '')) {
+                this.log.warn(`🔁 ${error.code} on ${toolName}, retrying...`);
+                return withRetry(() => this._fetch(request, timeout), {
+                    maxAttempts: this.config.maxRetries,
+                    delayMs: this.config.retryDelayMs,
+                }, this.log);
+            }
+            throw err;
+        }
+    }
+    // ─── JSON-RPC Protocol Ping ──────────────────────────────────────────────
+    /**
+     * Envoie une requête de ping JSON-RPC standard légère au serveur.
+     */
+    async ping(timeoutMs) {
+        const timeout = timeoutMs ?? 5_000;
+        const request = {
+            jsonrpc: '2.0',
+            id: this.rpcId++,
+            method: 'ping',
+            params: {},
+        };
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeout);
+            const response = await fetch(this.config.mcpUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json',
+                },
+                body: JSON.stringify(request),
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!response.ok)
+                return false;
+            const bodyText = await response.text();
+            const parsed = JSON.parse(bodyText.trim());
+            return parsed && parsed.jsonrpc === '2.0' && !parsed.error;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ─── Health Check ────────────────────────────────────────────────────────
+    async healthCheck() {
+        const startTime = Date.now();
+        const isOnline = await this.ping(5_000);
+        if (isOnline) {
+            return {
+                status: 'online',
+                mcpUrl: this.config.mcpUrl,
+                circuitState: this.circuit.currentState,
+                latencyMs: Date.now() - startTime,
+                checkedAt: Date.now(),
+            };
+        }
+        else {
+            return {
+                status: this.circuit.currentState === 'open' ? 'offline' : 'degraded',
+                mcpUrl: this.config.mcpUrl,
+                circuitState: this.circuit.currentState,
+                checkedAt: Date.now(),
+            };
+        }
+    }
+    // ─── Internal Fetch ──────────────────────────────────────────────────────
+    async _fetch(request, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let response;
+        try {
+            response = await fetch(this.config.mcpUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json, text/event-stream',
+                },
+                body: JSON.stringify(request),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            const error = err;
+            if (error.name === 'TimeoutError' || error.type === 'TimeoutError' || error.name === 'AbortError') {
+                throw Object.assign(new Error(`TIMEOUT: ${request.params.name} no response after ${timeoutMs / 1000}s`), { code: 'ETIMEDOUT', toolName: request.params.name, timeoutMs });
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok) {
+            throw Object.assign(new Error(`MCP HTTP ${response.status}: ${response.statusText}`), { code: 'EHTTPSTATUS', status: response.status });
+        }
+        // Lecture du body avec timeout effectif (3 couches)
+        const text = await this._readBody(response, timeoutMs);
+        return parseMcpResponseBody(text);
+    }
+    /**
+     * Lecture du body response avec 3 couches de timeout :
+     *   1. Deadline absolue (startRead + timeoutMs)
+     *   2. Promise.race per-chunk
+     *   3. reader.cancel() sur timeout
+     */
+    async _readBody(response, timeoutMs) {
+        if (!response.body) {
+            throw Object.assign(new Error('Response body is null'), { code: 'EBODYREAD' });
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        const chunks = [];
+        const startRead = Date.now();
+        try {
+            while (true) {
+                // Couche 1 — deadline absolue
+                if (Date.now() - startRead > timeoutMs) {
+                    reader.cancel();
+                    throw Object.assign(new Error(`Body read timeout after ${timeoutMs / 1000}s`), { code: 'EBODYREAD' });
+                }
+                // Couche 2+3 — Promise.race per-chunk (avec cleanup du timeout)
+                let raceTimer;
+                const { done, value } = await Promise.race([
+                    reader.read(),
+                    new Promise((_, reject) => {
+                        raceTimer = setTimeout(() => reject(Object.assign(new Error(`Chunk read timeout after ${timeoutMs / 1000}s`), { code: 'EBODYREAD' })), timeoutMs);
+                    }),
+                ]);
+                if (raceTimer) {
+                    clearTimeout(raceTimer);
+                }
+                if (done)
+                    break;
+                chunks.push(decoder.decode(value, { stream: true }));
+            }
+            chunks.push(decoder.decode());
+            return chunks.join('');
+        }
+        catch (err) {
+            const error = err;
+            if (error?.code === 'EBODYREAD')
+                throw err;
+            throw Object.assign(new Error(`Body read failed: ${error.message}`), { code: 'EBODYREAD' });
+        }
+    }
+}
+//# sourceMappingURL=BridgeProxy.js.map

package/dist/bridge/BridgeProxy.js.map

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

package/dist/bridge/OverBridgeService.d.ts

@@ -0,0 +1,96 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — OverBridgeService (High-Level API)              ║
+ * ║                                                                      ║
+ * ║   API haut niveau : agents, memory, cron, runs, sessions.           ║
+ * ║   Wrappe BridgeProxy pour fournir des méthodes métier claires.      ║
+ * ║                                                                      ║
+ * ║   ARCHITECTURE                                                       ║
+ * ║   ─────────────                                                      ║
+ * ║   App/Route → OverBridgeService → BridgeProxy → Overmind MCP        ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import type { AgentResult, RunAgentOptions, AgentControlOptions, MemorySearchOptions, MemoryStoreOptions, MemoryRunsOptions, UpdateAgentConfigOptions, CreatePromptOptions, EditPromptOptions, BridgeConfig, SessionState, RunnerType, HealthStatus } from './types.js';
+import { BridgeProxy } from './BridgeProxy.js';
+import { type BridgeLogger } from './utils.js';
+export declare class OverBridgeService {
+    private readonly proxy;
+    private session;
+    private heartbeatInterval;
+    constructor(config?: Partial<BridgeConfig>, logger?: BridgeLogger, initialSessionId?: string);
+    get proxyAccess(): BridgeProxy;
+    get sessionId(): string | undefined;
+    get sessionInfo(): SessionState;
+    /**
+     * Initialise la connexion au serveur MCP, vérifie la santé initiale
+     * et configure éventuellement un heartbeat périodique.
+     */
+    connect(healthCheckIntervalMs?: number): Promise<HealthStatus>;
+    /**
+     * Ferme proprement le service en annulant le heartbeat actif.
+     */
+    disconnect(): void;
+    /** Force un reset de session — le prochain appel démarre une nouvelle session */
+    resetSession(): void;
+    /** Force un sessionId spécifique (ex: reçu d'un env var) */
+    setSession(id: string): void;
+    private updateSession;
+    /**
+     * Exécute un agent via `run_agent`.
+     * Gère automatiquement la session continuity.
+     */
+    runAgent(options: RunAgentOptions): Promise<AgentResult>;
+    /**
+     * Raccourci : run agent avec contexte Discord auto-formaté.
+     */
+    runAgentForDiscord(agentName: string, runner: RunnerType, message: string, discordContext: {
+        channelId?: string;
+        userId?: string;
+        username?: string;
+    }): Promise<AgentResult>;
+    private _processAgentResponse;
+    /** Status d'un agent en cours */
+    agentStatus(options: AgentControlOptions): Promise<AgentResult>;
+    /** Kill un agent */
+    killAgent(agentName: string, runner?: RunnerType): Promise<AgentResult>;
+    /** Recherche sémantique dans la mémoire Overmind */
+    memorySearch(options: MemorySearchOptions): Promise<AgentResult>;
+    /** Stocke une connaissance dans la mémoire Overmind */
+    memoryStore(options: MemoryStoreOptions): Promise<AgentResult>;
+    /** Historique et statistiques des runs en mémoire */
+    memoryRuns(options?: MemoryRunsOptions): Promise<AgentResult>;
+    /** Liste tous les agents disponibles */
+    listAgents(details?: boolean): Promise<AgentResult>;
+    /** Crée un nouvel agent */
+    createAgent(name: string, runner: RunnerType, prompt: string, model?: string, copyEnvFrom?: string, mode?: string, cliPath?: string): Promise<AgentResult>;
+    /** Supprime un agent */
+    deleteAgent(name: string): Promise<AgentResult>;
+    /** Récupère la configuration détaillée d'un agent */
+    getAgentConfigs(name: string): Promise<AgentResult>;
+    /** Met à jour la configuration d'un agent */
+    updateAgentConfig(options: UpdateAgentConfigOptions): Promise<AgentResult>;
+    /** Crée ou écrase un fichier prompt */
+    createPrompt(options: CreatePromptOptions): Promise<AgentResult>;
+    /** Modifie un prompt par recherche-remplacement */
+    editPrompt(options: EditPromptOptions): Promise<AgentResult>;
+    /** Lance plusieurs agents en parallèle via run_agents_parallel */
+    runParallel(agents: Array<{
+        taskId?: string;
+        runner: RunnerType;
+        prompt: string;
+        agentName: string;
+        path?: string;
+        model?: string;
+        mode?: string;
+    }>, waitAll?: boolean): Promise<AgentResult>;
+    /** Recherche séquentielle groupée en mémoire */
+    batchSearch(queries: string[], agentName?: string, limit?: number): Promise<AgentResult[]>;
+    /** Stockage séquentiel groupé en mémoire */
+    batchStore(texts: Array<{
+        text: string;
+        source?: 'user' | 'agent' | 'pattern' | 'error' | 'decision';
+    }>, agentName?: string): Promise<AgentResult[]>;
+    /** Appel MCP raw — pour les tools non wrappés */
+    rawCall(toolName: string, args: Record<string, unknown>, timeoutMs?: number): Promise<AgentResult>;
+}
+//# sourceMappingURL=OverBridgeService.d.ts.map

package/dist/bridge/OverBridgeService.d.ts.map

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