overmind-mcp 2.8.52 → 2.9.0

package/dist/services/HermesRunner.js

@@ -0,0 +1,313 @@
+/**
+ * HermesRunner — Thin wrapper around the native Hermes Agent CLI.
+ *
+ * ╔════════════════════════════════════════════════════════════════════════╗
+ * ║  ARCHITECTURE (v3.0 — Refactored)                                       ║
+ * ║                                                                          ║
+ * ║  This runner replaces the 1391-line NousHermesRunner. It does NOT:       ║
+ * ║    - Resolve tokens (Hermes .env per-profile does that)                  ║
+ * ║    - Detect providers (Hermes config.yaml does that)                     ║
+ * ║    - Manage HERMES_HOME custom paths (Hermes ~/.hermes native)           ║
+ * ║    - Filter config.yaml (1 config per profile now)                       ║
+ * ║    - Find the hermes binary (it's in PATH)                               ║
+ * ║                                                                          ║
+ * ║  It DOES:                                                                ║
+ * ║    - Spawn: hermes -p <profile> chat -q "<prompt>" -Q --yolo             ║
+ * ║    - Capture stdout (response) + stderr (session_id + diagnostics)       ║
+ * ║    - Handle timeout + abort signal                                       ║
+ * ║    - Register with agent_lifecycle + processRegistry (UI parity)         ║
+ * ║                                                                          ║
+ * ║  Profile management is handled by AgentManager via:                      ║
+ * ║    hermes profile create / delete / list / show                          ║
+ * ║                                                                          ║
+ * ║  Session resume is handled by:                                           ║
+ * ║    hermes -p <name> chat -q "<prompt>" --resume <sessionId>              ║
+ * ╚════════════════════════════════════════════════════════════════════════╝
+ */
+import { spawn } from 'child_process';
+import { CONFIG, getWorkspaceDir } from '../lib/config.js';
+import { getLastSessionId, saveSessionId } from '../lib/sessions.js';
+import { linkSessionToPid } from '../lib/processRegistry.js';
+import { withSpan } from '../lib/telemetry.js';
+import { rootLogger } from '../lib/logger.js';
+import { registerProcess, updateProcessStatus, } from '../lib/processRegistry.js';
+import { registerLiveAgent, appendLiveOutput, setLiveStatus, unregisterLiveAgent, } from '../lib/agent_lifecycle.js';
+import { killProcessTree } from './hermes/processUtils.js';
+const logger = rootLogger.child({ module: 'HermesRunner' });
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Kill a child process tree, cross-platform. */
+function killChildTree(child) {
+    return killProcessTree(child);
+}
+/** Extract session_id from Hermes stderr output. */
+function extractSessionId(stderr) {
+    // Hermes outputs: "session_id: 20260628_114351_3fa469"
+    const match = stderr.match(/session_id:\s*(\S+)/i);
+    return match?.[1];
+}
+/** Check if an error output indicates a retryable failure. */
+function isRetryableError(stderr, stdout) {
+    const combined = (stderr + ' ' + stdout).toLowerCase();
+    return (combined.includes('401') ||
+        combined.includes('unauthorized') ||
+        combined.includes('invalid api key') ||
+        combined.includes('authentication failed') ||
+        combined.includes('429') ||
+        combined.includes('rate limit') ||
+        combined.includes('quota') ||
+        combined.includes('503') ||
+        combined.includes('service unavailable'));
+}
+// ─── Main Class ───────────────────────────────────────────────────────────────
+export class HermesRunner {
+    timeoutMs;
+    MAX_BUF = 10 * 1024 * 1024; // 10MB buffer limit
+    constructor() {
+        this.timeoutMs = CONFIG.TIMEOUT_MS || 900000; // 15 min default
+    }
+    async runAgent(options) {
+        if (options.agentName) {
+            if (!/^[a-zA-Z0-9_-]+$/.test(options.agentName)) {
+                return {
+                    result: '',
+                    error: `INVALID_AGENT_NAME: '${options.agentName}' contains invalid characters. Only [a-zA-Z0-9_-] allowed.`,
+                };
+            }
+        }
+        logger.info({ agentName: options.agentName, model: options.model, sessionId: options.sessionId }, '[RUN_AGENT] Starting Hermes thin-wrapper run.');
+        try {
+            const result = await withSpan('hermes.runAgent', async (span) => {
+                span.setAttribute('agentName', options.agentName || '');
+                span.setAttribute('model', options.model || '');
+                span.setAttribute('runner', 'hermes');
+                return await this.runAgentInternal(options);
+            }, {
+                agentName: options.agentName || '',
+                model: options.model || '',
+                runner: 'hermes',
+            });
+            if (options.agentName && result.sessionId) {
+                await saveSessionId(options.agentName, result.sessionId, options.configPath, 'hermes');
+            }
+            return result;
+        }
+        catch (error) {
+            logger.error({ error: error instanceof Error ? error.message : String(error), agentName: options.agentName }, '[RUN_AGENT] Hermes runner threw.');
+            throw error;
+        }
+    }
+    async runAgentInternal(options) {
+        const { prompt, agentName, silent } = options;
+        let { sessionId } = options;
+        const cwd = options.cwd || process.cwd();
+        const configPath = options.configPath || getWorkspaceDir();
+        // ─── Auto Resume ─────────────────────────────────────────────────────────
+        if (options.autoResume && agentName && !sessionId) {
+            const lastId = await getLastSessionId(agentName, configPath, 'hermes');
+            if (lastId) {
+                sessionId = lastId;
+                logger.info({ sessionId }, '[RUN_AGENT] Auto-resume session.');
+            }
+        }
+        // ─── Build CLI args ──────────────────────────────────────────────────────
+        // Global flags come BEFORE the subcommand; subcommand flags come AFTER.
+        //
+        // hermes -p <profile> chat -q "<prompt>" -Q --yolo --pass-session-id
+        //        ^^^^^^^^^^^      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+        //        profile           quiet query
+        //
+        const cleanArgs = [];
+        // Profile selection — agentName maps to a Hermes profile
+        if (agentName) {
+            cleanArgs.push('-p', agentName);
+        }
+        // Subcommand
+        cleanArgs.push('chat');
+        // Query (non-interactive mode)
+        cleanArgs.push('-q', prompt);
+        // Quiet mode: suppress banner, spinner, tool previews
+        cleanArgs.push('-Q');
+        // Bypass all approval prompts (yolo mode — no human-in-the-loop)
+        cleanArgs.push('--yolo');
+        // Include session ID in output for extraction
+        cleanArgs.push('--pass-session-id');
+        // Tag as third-party integration (not shown in user session lists)
+        cleanArgs.push('--source', 'tool');
+        // Model override (optional — profile config.yaml is the default)
+        if (options.model) {
+            cleanArgs.push('--model', options.model);
+        }
+        // Provider override (optional — profile config.yaml is the default)
+        if (options.provider) {
+            cleanArgs.push('--provider', options.provider);
+        }
+        // Resume a previous session
+        if (sessionId) {
+            cleanArgs.push('--resume', sessionId);
+        }
+        // ─── Spawn ───────────────────────────────────────────────────────────────
+        const timeoutMs = this.timeoutMs;
+        const HARD_TIMEOUT_MS = 60000;
+        let currentChildRef = null;
+        return new Promise((resolve) => {
+            let resolved = false;
+            let currentSessionId = sessionId;
+            const abortListener = () => {
+                if (currentChildRef) {
+                    killChildTree(currentChildRef).then(() => {
+                        safeResolve({ result: '', error: 'ABORTED', rawOutput: '' });
+                    });
+                }
+                else {
+                    safeResolve({ result: '', error: 'ABORTED', rawOutput: '' });
+                }
+            };
+            const safeResolve = (v) => {
+                if (!resolved) {
+                    resolved = true;
+                    if (options.signal) {
+                        options.signal.removeEventListener('abort', abortListener);
+                    }
+                    resolve(v);
+                }
+            };
+            // ─── Spawn the Hermes process ──────────────────────────────────────────
+            const child = spawn('hermes', cleanArgs, {
+                cwd,
+                shell: false,
+                windowsHide: true,
+                env: {
+                    ...process.env,
+                    // Ensure Python uses UTF-8 (avoids Windows encoding crashes)
+                    PYTHONIOENCODING: 'utf-8',
+                    PYTHONUNBUFFERED: '1',
+                    TERM: 'emacs',
+                    // Disable interactive prompt_toolkit
+                    PROMPT_TOOLKIT_NO_INTERACTIVE: '1',
+                },
+            });
+            currentChildRef = child;
+            if (child.pid) {
+                void registerProcess(child.pid, { agentName: agentName || '', runner: 'hermes', configPath });
+                void registerLiveAgent({
+                    pid: child.pid,
+                    runner: 'hermes',
+                    agentName: agentName || '',
+                    sessionId: currentSessionId || '',
+                    cleanupFn: async () => { await killChildTree(child); },
+                    childRef: child,
+                });
+                child.once('exit', (code) => {
+                    setLiveStatus(child.pid, code === 0 ? 'done' : 'failed', code ?? null);
+                    void unregisterLiveAgent(child.pid);
+                });
+            }
+            // ─── Capture output ────────────────────────────────────────────────────
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (d) => {
+                const chunk = d.toString();
+                if (child.pid) {
+                    void appendLiveOutput(child.pid, chunk);
+                }
+                if (stdout.length + chunk.length > this.MAX_BUF) {
+                    stdout = stdout.slice(-this.MAX_BUF);
+                }
+                else {
+                    stdout += chunk;
+                }
+                if (!silent && agentName) {
+                    process.stderr.write(`[Hermes:${agentName}] ${chunk}`);
+                }
+            });
+            child.stderr?.on('data', (d) => {
+                const chunk = d.toString();
+                if (stderr.length + chunk.length > this.MAX_BUF) {
+                    stderr = stderr.slice(-this.MAX_BUF);
+                }
+                else {
+                    stderr += chunk;
+                }
+                if (!silent && agentName) {
+                    process.stderr.write(`[Hermes:${agentName}:ERR] ${chunk}`);
+                }
+            });
+            // ─── Timeout ───────────────────────────────────────────────────────────
+            const timer = setTimeout(() => {
+                if (child.stdin && !child.stdin.destroyed) {
+                    try {
+                        child.stdin.write('\n');
+                    }
+                    catch { /* ignore */ }
+                }
+                setTimeout(async () => {
+                    await killChildTree(child);
+                    safeResolve({ result: '', error: 'HARD_TIMEOUT', rawOutput: stdout + stderr });
+                }, HARD_TIMEOUT_MS);
+            }, timeoutMs);
+            // ─── Process exit ──────────────────────────────────────────────────────
+            child.on('close', async (code) => {
+                clearTimeout(timer);
+                if (child.pid) {
+                    void updateProcessStatus(child.pid, code === 0 ? 'done' : 'failed', code, configPath);
+                }
+                // Extract session_id from stderr
+                const extractedSid = extractSessionId(stderr);
+                if (extractedSid) {
+                    currentSessionId = extractedSid;
+                }
+                // Save session linkage
+                if (currentSessionId && agentName) {
+                    await saveSessionId(agentName, currentSessionId, configPath, 'hermes');
+                    if (child.pid) {
+                        void linkSessionToPid(currentSessionId, child.pid, configPath);
+                    }
+                }
+                // ─── Error handling ──────────────────────────────────────────────────
+                if (code !== 0) {
+                    const retryable = isRetryableError(stderr, stdout);
+                    if (retryable) {
+                        // Surface the error — the caller (run_hermes.ts) handles session cleanup + retry
+                        logger.warn({ agentName, code, retryable, sessionId: currentSessionId }, '[RUN_AGENT] Hermes exited with retryable error.');
+                    }
+                    if (!stdout.trim()) {
+                        safeResolve({
+                            result: '',
+                            error: `EXIT_CODE_${code}`,
+                            rawOutput: stderr || stdout,
+                            sessionId: currentSessionId,
+                        });
+                        return;
+                    }
+                }
+                // ─── Success ─────────────────────────────────────────────────────────
+                safeResolve({
+                    result: stdout.trim(),
+                    sessionId: currentSessionId,
+                    rawOutput: stdout,
+                });
+            });
+            child.on('error', (err) => {
+                clearTimeout(timer);
+                killChildTree(child).then(() => {
+                    safeResolve({
+                        result: '',
+                        error: `SPAWN_ERROR: ${err.message}`,
+                        rawOutput: '',
+                    });
+                });
+            });
+            // ─── Abort signal ──────────────────────────────────────────────────────
+            if (options.signal) {
+                if (options.signal.aborted) {
+                    killChildTree(child).then(() => {
+                        safeResolve({ result: '', error: 'ABORTED', rawOutput: '' });
+                    });
+                    return;
+                }
+                options.signal.addEventListener('abort', abortListener);
+            }
+        });
+    }
+}
+//# sourceMappingURL=HermesRunner.js.map

package/dist/services/HermesRunner.js.map

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

package/dist/services/KanbanAdapter.d.ts

@@ -0,0 +1,135 @@
+/**
+ * KanbanAdapter — Thin wrapper around `hermes kanban` CLI.
+ *
+ * ╔════════════════════════════════════════════════════════════════════════╗
+ * ║  PURPOSE (v3.0 — Refactored)                                             ║
+ * ║                                                                          ║
+ * ║  Replaces the old swarm.ts (368 lines) and the parallel orchestration    ║
+ * ║  in dispatcher.ts with native Hermes Kanban tasks.                       ║
+ * ║                                                                          ║
+ * ║  Kanban = durable SQLite-backed task board shared across all Hermes      ║
+ * ║  profiles. The dispatcher loop (60s default) atomically claims ready     ║
+ * ║  tasks and spawns the assigned profile as its own OS process.            ║
+ * ║                                                                          ║
+ * ║  YOLO CONFIG (no human-in-the-loop):                                     ║
+ * ║    - autoReclaim on crash/timeout                                        ║
+ * ║    - maxRetries: 5 (vs default 2) before block                           ║
+ * ║    - autoUnblock via admin API (no manual human intervention)            ║
+ * ║    - dispatcherTick: 30s (vs default 60s — faster pickup)               ║
+ * ╚════════════════════════════════════════════════════════════════════════╝
+ */
+export declare const YOLO_CONFIG: {
+    readonly autoReclaim: true;
+    readonly maxRetries: 5;
+    readonly autoUnblock: true;
+    readonly reclaimStaleMs: 900000;
+    readonly dispatcherTickSeconds: 30;
+    readonly goalModeMaxTurns: 20;
+};
+export interface CreateTaskOptions {
+    title: string;
+    assignee: string;
+    body?: string;
+    tenant?: string;
+    parents?: string[];
+    priority?: number;
+    workspace?: 'scratch' | `dir:${string}` | 'worktree';
+    idempotencyKey?: string;
+    maxRuntime?: string;
+    goalMode?: boolean;
+    goalMaxTurns?: number;
+    skills?: string[];
+}
+export interface TaskStatus {
+    id: string;
+    title: string;
+    assignee: string;
+    status: string;
+    body?: string;
+    tenant?: string;
+    workspace?: string;
+}
+export interface TaskResult {
+    id: string;
+    status: string;
+    summary?: string;
+    metadata?: Record<string, unknown>;
+    error?: string;
+    durationMs?: number;
+}
+export interface TaskSummary {
+    id: string;
+    title: string;
+    assignee: string;
+    status: string;
+    tenant?: string;
+}
+export declare class KanbanAdapter {
+    private board?;
+    constructor(board?: string);
+    private get boardArgs();
+    /**
+     * Initialize the kanban board (idempotent).
+     */
+    init(): Promise<void>;
+    /**
+     * Force a dispatcher tick immediately (don't wait for the 60s loop).
+     */
+    nudge(): Promise<void>;
+    /**
+     * Create a single task.
+     */
+    createTask(opts: CreateTaskOptions): Promise<{
+        taskId: string;
+    }>;
+    /**
+     * Create multiple independent tasks in parallel (fan-out).
+     */
+    createParallelTasks(tasks: CreateTaskOptions[]): Promise<string[]>;
+    /**
+     * Create a pipeline (sequential chain: task[0] → task[1] → task[2]...).
+     * Each task has the previous one as parent.
+     */
+    createPipeline(tasks: CreateTaskOptions[]): Promise<string[]>;
+    /**
+     * Get the status of a task.
+     */
+    getStatus(taskId: string): Promise<TaskStatus>;
+    /**
+     * Wait for a task to complete (polling loop).
+     * YOLO: auto-reclaim on stale claims.
+     */
+    wait(taskId: string, timeoutMs?: number): Promise<TaskResult>;
+    /**
+     * Reclaim a task (abort running worker, reset to ready).
+     */
+    reclaim(taskId: string): Promise<void>;
+    /**
+     * Unblock a blocked task.
+     */
+    unblock(taskId: string): Promise<void>;
+    /**
+     * Archive a task.
+     */
+    archive(taskId: string): Promise<void>;
+    /**
+     * List tasks with optional filter.
+     */
+    listTasks(filter?: {
+        status?: string;
+        assignee?: string;
+        tenant?: string;
+    }): Promise<TaskSummary[]>;
+    /**
+     * Add a comment to a task (inter-agent protocol).
+     */
+    comment(taskId: string, body: string): Promise<void>;
+    /**
+     * Create a board for a specific project/workstream.
+     */
+    createBoard(slug: string, name: string, opts?: {
+        description?: string;
+        switch?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=KanbanAdapter.d.ts.map

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

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