wyrm-mcp 4.0.0 → 5.1.0

package/dist/agent-daemon.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Agent daemon process manager.
+ *
+ * Lets an AI client (Claude / Codex / Cursor / etc.) bootstrap, monitor,
+ * and tear down the `wyrm-loop` autonomous scheduler without the
+ * operator running shell commands. The MCP server can spawn the daemon
+ * as a detached background process, write a PID + log file under
+ * `~/.wyrm/`, and check liveness on demand.
+ *
+ * Files (all under `~/.wyrm/`):
+ *   wyrm-loop.pid    PID of the running daemon (single-line)
+ *   wyrm-loop.log    Stdout/stderr of the daemon (rotated at 1MB)
+ *
+ * Single-instance guarantee — if a PID file exists and the process is
+ * alive, `start()` refuses (no fork-bomb). `restart()` is provided as
+ * an explicit operation.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import type Database from 'better-sqlite3';
+export interface DaemonStatus {
+    running: boolean;
+    pid: number | null;
+    pid_file: string;
+    log_file: string;
+    started_at?: string;
+    uptime_seconds?: number;
+    last_action?: {
+        ran_at: string;
+        actor: string;
+        goal_id: number | null;
+        summary: string;
+        result_status: string | null;
+    };
+    active_goals: number;
+    total_iterations: number;
+}
+export interface StartOptions {
+    interval_seconds?: number;
+    max_steps?: number;
+    project_path?: string;
+    verbose?: boolean;
+}
+export interface StartResult {
+    ok: boolean;
+    pid?: number;
+    status?: DaemonStatus;
+    error?: string;
+}
+export declare class AgentDaemon {
+    private db;
+    constructor(db: Database.Database);
+    /** Current daemon status. Always safe to call. */
+    status(): DaemonStatus;
+    /** Start the daemon. No-op if already running. */
+    start(opts?: StartOptions): StartResult;
+    /** Stop the daemon. Sends SIGTERM, then SIGKILL after a grace period. */
+    stop(opts?: {
+        grace_ms?: number;
+    }): Promise<{
+        ok: boolean;
+        was_running: boolean;
+        pid?: number;
+        error?: string;
+    }>;
+    /** Stop + Start in sequence. */
+    restart(opts?: StartOptions): Promise<StartResult>;
+    /** Read the last N lines of the daemon log. */
+    recentLog(lines?: number): string;
+}
+//# sourceMappingURL=agent-daemon.d.ts.map

package/dist/agent-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-daemon.d.ts","sourceRoot":"","sources":["../src/agent-daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqED,qBAAa,WAAW;IACV,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,kDAAkD;IAClD,MAAM,IAAI,YAAY;IAuDtB,kDAAkD;IAClD,KAAK,CAAC,IAAI,GAAE,YAAiB,GAAG,WAAW;IA8D3C,yEAAyE;IACnE,IAAI,CAAC,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgC1H,gCAAgC;IAC1B,OAAO,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAK5D,+CAA+C;IAC/C,SAAS,CAAC,KAAK,SAAK,GAAG,MAAM;CAU9B"}

package/dist/agent-daemon.js

@@ -0,0 +1,268 @@
+/**
+ * Agent daemon process manager.
+ *
+ * Lets an AI client (Claude / Codex / Cursor / etc.) bootstrap, monitor,
+ * and tear down the `wyrm-loop` autonomous scheduler without the
+ * operator running shell commands. The MCP server can spawn the daemon
+ * as a detached background process, write a PID + log file under
+ * `~/.wyrm/`, and check liveness on demand.
+ *
+ * Files (all under `~/.wyrm/`):
+ *   wyrm-loop.pid    PID of the running daemon (single-line)
+ *   wyrm-loop.log    Stdout/stderr of the daemon (rotated at 1MB)
+ *
+ * Single-instance guarantee — if a PID file exists and the process is
+ * alive, `start()` refuses (no fork-bomb). `restart()` is provided as
+ * an explicit operation.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import { spawn } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, statSync, openSync, renameSync, unlinkSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const WYRM_DIR = join(homedir(), '.wyrm');
+const PID_FILE = join(WYRM_DIR, 'wyrm-loop.pid');
+const LOG_FILE = join(WYRM_DIR, 'wyrm-loop.log');
+const LOG_FILE_OLD = join(WYRM_DIR, 'wyrm-loop.log.1');
+const MAX_LOG_BYTES = 1_000_000;
+function ensureWyrmDir() {
+    if (!existsSync(WYRM_DIR))
+        mkdirSync(WYRM_DIR, { recursive: true });
+}
+function rotateLogIfLarge() {
+    try {
+        if (existsSync(LOG_FILE) && statSync(LOG_FILE).size > MAX_LOG_BYTES) {
+            if (existsSync(LOG_FILE_OLD))
+                unlinkSync(LOG_FILE_OLD);
+            renameSync(LOG_FILE, LOG_FILE_OLD);
+        }
+    }
+    catch { /* best-effort */ }
+}
+function readPid() {
+    try {
+        const raw = readFileSync(PID_FILE, 'utf-8').trim();
+        const pid = parseInt(raw, 10);
+        return Number.isFinite(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        // signal 0 doesn't kill; just checks existence + permission
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Find the bundled `wyrm-loop` script path. Resolves relative to this
+ * module so it works whether installed via npm, run from source, or
+ * invoked from a global symlink. */
+function locateLoopBinary() {
+    // 1. import.meta.url → packages/mcp-server/dist/agent-daemon.js
+    try {
+        const here = fileURLToPath(import.meta.url);
+        const candidates = [
+            // installed alongside (dist/wyrm-loop.js)
+            resolve(dirname(here), 'wyrm-loop.js'),
+            // source layout
+            resolve(dirname(here), '..', 'dist', 'wyrm-loop.js'),
+        ];
+        for (const p of candidates) {
+            if (existsSync(p))
+                return p;
+        }
+    }
+    catch { /* fall through */ }
+    // 2. Look in PATH for the `wyrm-loop` binary (set up by `npm install -g`)
+    const pathDirs = (process.env.PATH ?? '').split(':');
+    for (const dir of pathDirs) {
+        const cand = join(dir, 'wyrm-loop');
+        if (existsSync(cand))
+            return cand;
+    }
+    return null;
+}
+export class AgentDaemon {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Current daemon status. Always safe to call. */
+    status() {
+        const pid = readPid();
+        const running = pid != null && isProcessAlive(pid);
+        let started_at;
+        let uptime_seconds;
+        try {
+            if (existsSync(PID_FILE)) {
+                const st = statSync(PID_FILE);
+                started_at = st.mtime.toISOString();
+                uptime_seconds = Math.round((Date.now() - st.mtime.getTime()) / 1000);
+            }
+        }
+        catch { /* best-effort */ }
+        // Read latest agent_actions row for "last action" summary
+        let last_action;
+        try {
+            const row = this.db.prepare(`
+        SELECT actor, goal_id, action_kind, summary, result_status, ran_at
+        FROM agent_actions ORDER BY id DESC LIMIT 1
+      `).get();
+            if (row)
+                last_action = {
+                    ran_at: row.ran_at, actor: row.actor, goal_id: row.goal_id,
+                    summary: `${row.action_kind}: ${row.summary}`.slice(0, 200),
+                    result_status: row.result_status,
+                };
+        }
+        catch { /* table may not exist on pre-v5 DBs */ }
+        let active_goals = 0;
+        let total_iterations = 0;
+        try {
+            active_goals = this.db.prepare(`SELECT COUNT(*) as c FROM goals WHERE status = 'active'`).get().c;
+            total_iterations = this.db.prepare(`SELECT COALESCE(SUM(iterations_count), 0) as c FROM goals`).get().c;
+        }
+        catch { /* pre-v5 DB */ }
+        return {
+            running,
+            pid: running ? pid : null,
+            pid_file: PID_FILE,
+            log_file: LOG_FILE,
+            started_at: running ? started_at : undefined,
+            uptime_seconds: running ? uptime_seconds : undefined,
+            last_action,
+            active_goals,
+            total_iterations,
+        };
+    }
+    /** Start the daemon. No-op if already running. */
+    start(opts = {}) {
+        ensureWyrmDir();
+        rotateLogIfLarge();
+        const cur = this.status();
+        if (cur.running) {
+            return { ok: true, pid: cur.pid ?? undefined, status: cur };
+        }
+        // Clear stale PID file from a crashed prior run
+        if (existsSync(PID_FILE)) {
+            try {
+                unlinkSync(PID_FILE);
+            }
+            catch { /* ignore */ }
+        }
+        const binary = locateLoopBinary();
+        if (!binary) {
+            return { ok: false, error: 'Could not locate wyrm-loop binary. Run `npm install -g wyrm-mcp` or `npm run build` in packages/mcp-server.' };
+        }
+        const args = ['--interval', String(opts.interval_seconds ?? 600)];
+        if (opts.max_steps)
+            args.push('--max-steps', String(opts.max_steps));
+        if (opts.project_path)
+            args.push('--project', opts.project_path);
+        if (opts.verbose)
+            args.push('--verbose');
+        // Open the log file once, share fd with the child
+        let logFd;
+        try {
+            logFd = openSync(LOG_FILE, 'a');
+        }
+        catch (err) {
+            return { ok: false, error: `Could not open log file ${LOG_FILE}: ${err.message}` };
+        }
+        let child;
+        try {
+            child = spawn('node', [binary, ...args], {
+                detached: true,
+                stdio: ['ignore', logFd, logFd],
+                env: { ...process.env, WYRM_LOOP_LOG: opts.verbose ? '1' : '0' },
+            });
+        }
+        catch (err) {
+            return { ok: false, error: `spawn failed: ${err.message}` };
+        }
+        if (!child.pid) {
+            return { ok: false, error: 'spawn returned no PID' };
+        }
+        try {
+            writeFileSync(PID_FILE, String(child.pid), 'utf-8');
+        }
+        catch (err) {
+            // Process is up but we can't track it — kill to keep state consistent
+            try {
+                process.kill(child.pid, 'SIGTERM');
+            }
+            catch { /* ignore */ }
+            return { ok: false, error: `Could not write PID file: ${err.message}` };
+        }
+        // unref so this process doesn't wait on the child
+        child.unref();
+        // Brief settle delay so status() reflects the new state
+        return { ok: true, pid: child.pid, status: this.status() };
+    }
+    /** Stop the daemon. Sends SIGTERM, then SIGKILL after a grace period. */
+    async stop(opts = {}) {
+        const pid = readPid();
+        if (pid == null) {
+            return { ok: true, was_running: false };
+        }
+        if (!isProcessAlive(pid)) {
+            // Stale PID file
+            try {
+                unlinkSync(PID_FILE);
+            }
+            catch { /* ignore */ }
+            return { ok: true, was_running: false, pid };
+        }
+        try {
+            process.kill(pid, 'SIGTERM');
+        }
+        catch (err) {
+            return { ok: false, was_running: true, pid, error: `SIGTERM failed: ${err.message}` };
+        }
+        const grace = Math.max(100, Math.min(opts.grace_ms ?? 3000, 30_000));
+        const start = Date.now();
+        while (Date.now() - start < grace) {
+            if (!isProcessAlive(pid))
+                break;
+            await new Promise(r => setTimeout(r, 100));
+        }
+        if (isProcessAlive(pid)) {
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch { /* may already be dead */ }
+        }
+        try {
+            unlinkSync(PID_FILE);
+        }
+        catch { /* ignore */ }
+        return { ok: true, was_running: true, pid };
+    }
+    /** Stop + Start in sequence. */
+    async restart(opts = {}) {
+        await this.stop({ grace_ms: 3000 });
+        return this.start(opts);
+    }
+    /** Read the last N lines of the daemon log. */
+    recentLog(lines = 40) {
+        try {
+            if (!existsSync(LOG_FILE))
+                return '(log file does not exist)';
+            const raw = readFileSync(LOG_FILE, 'utf-8');
+            const all = raw.split('\n');
+            return all.slice(-Math.max(1, Math.min(lines, 1000))).join('\n');
+        }
+        catch (err) {
+            return `(could not read log: ${err.message})`;
+        }
+    }
+}
+//# sourceMappingURL=agent-daemon.js.map

package/dist/agent-daemon.js.map

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

package/dist/agent-loop.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Agent loop — OODA + ReAct (Observe → Orient → Decide → Act).
+ *
+ * This is the thing that turns Wyrm from "memory tool" into "agent".
+ * Given a goal (or ad-hoc query), we run a multi-turn loop where:
+ *
+ *   1. Observe — assemble relevant context from Wyrm's own data
+ *                (failures, truths, sessions, symbols, prior iterations)
+ *   2. Orient   — LLM synthesises: "given this context, what's the state?"
+ *   3. Decide   — LLM proposes ONE action: either a Wyrm tool call,
+ *                 an external MCP server call, or 'done' / 'block' / 'escalate'
+ *   4. Act      — execute the proposed action, capture result
+ *   5. Loop     — feed result back into the next Observe step
+ *
+ * Each iteration logs to `goal_iterations` if attached to a goal.
+ * Hard caps: `max_iterations` per goal, ~60s wall clock per iteration,
+ * actions matched against a whitelist (no `wyrm_audit_export` or other
+ * data-exfiltration tools from inside the loop).
+ *
+ * LLM protocol — JSON envelope works with both:
+ *   - Ollama JSON mode  (most models 7B+)
+ *   - OpenAI native function calling  (gpt-4o, gpt-4o-mini, ...)
+ *
+ * The response shape we ask for:
+ *   {"thought":"...","action":"<tool_name>","args":{...}} or
+ *   {"thought":"...","action":"done","summary":"..."} or
+ *   {"thought":"...","action":"block","reason":"..."}
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import type Database from 'better-sqlite3';
+import { OutboundMcpClient } from './mcp-client.js';
+export interface AgentAction {
+    thought?: string;
+    action: string;
+    args?: Record<string, unknown>;
+    summary?: string;
+    reason?: string;
+}
+export interface IterationResult {
+    iteration_num: number;
+    observe_summary: string;
+    orient_summary: string;
+    decided: AgentAction;
+    action_result: string;
+    outcome: 'progressed' | 'blocked' | 'done' | 'error';
+    latency_ms: number;
+    tokens_in?: number;
+    tokens_out?: number;
+    model: string;
+    degraded: boolean;
+}
+export interface ToolDispatcher {
+    (toolName: string, args: Record<string, unknown>): Promise<{
+        ok: boolean;
+        result?: unknown;
+        error?: string;
+    }>;
+}
+export declare class AgentLoop {
+    private db;
+    private externalClient;
+    private internalToolDispatch;
+    private subAgent;
+    private goals;
+    private failures;
+    constructor(db: Database.Database, externalClient: OutboundMcpClient, internalToolDispatch: ToolDispatcher);
+    /** Run ONE OODA iteration on a goal. Returns the iteration result. */
+    iterate(goal_id: number, opts?: {
+        ollama_url?: string;
+        openai_api_key?: string;
+        model_override?: string;
+    }): Promise<IterationResult | null>;
+    /** Iterate until done / blocked / cap hit. Returns the array of iterations. */
+    pursue(goal_id: number, opts?: {
+        max_steps?: number;
+        ollama_url?: string;
+        openai_api_key?: string;
+        model_override?: string;
+    }): Promise<IterationResult[]>;
+    private observe;
+    private orientAndDecide;
+    private act;
+}
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAwBpD,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/G;AAED,qBAAa,SAAS;IAMlB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,oBAAoB;IAP9B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAkB;gBAGxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,iBAAiB,EACjC,oBAAoB,EAAE,cAAc;IAO9C,sEAAsE;IAChE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA+EjJ,+EAA+E;IACzE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAgB/J,OAAO,CAAC,OAAO;YAwED,eAAe;YA0Ef,GAAG;CA4BlB"}