create-merlin-brain 3.22.0 → 4.0.0

package/dist/server/tools/hud.js

@@ -0,0 +1,295 @@
+/**
+ * HUD Tools
+ * MCP tools for reading and writing live session HUD metrics.
+ *
+ * merlin_hud_status  — read all metrics (agents, tasks, cost, context, rate limit, git)
+ * merlin_hud_update  — write a single metric (called by hooks and agents)
+ *
+ * All state lives in ~/.merlin/state/ as small JSON files.
+ * Missing files are handled gracefully — metrics fall back to null.
+ */
+import { z } from 'zod';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { execSync } from 'child_process';
+import { homedir } from 'os';
+import { join } from 'path';
+const STATE_DIR = join(homedir(), '.merlin', 'state');
+const MERLIN_DIR = join(homedir(), '.claude', 'merlin');
+// ── State file paths ────────────────────────────────────────────────────────
+const STATE_FILES = {
+    agents: join(STATE_DIR, 'agents.json'),
+    tasks: join(STATE_DIR, 'tasks.json'),
+    sessionCost: join(STATE_DIR, 'session-cost.json'),
+    lastContext: join(STATE_DIR, 'last-context.json'),
+    rateLimit: join(STATE_DIR, 'rate-limit.json'),
+};
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function ensureStateDir() {
+    if (!existsSync(STATE_DIR)) {
+        mkdirSync(STATE_DIR, { recursive: true });
+    }
+}
+function readJson(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeJson(filePath, data) {
+    ensureStateDir();
+    writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf8');
+}
+function readVersion() {
+    const versionFile = join(MERLIN_DIR, 'VERSION');
+    if (!existsSync(versionFile))
+        return null;
+    return readFileSync(versionFile, 'utf8').trim() || null;
+}
+function readGitBranch() {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', { timeout: 500, stdio: ['pipe', 'pipe', 'pipe'] })
+            .toString()
+            .trim();
+    }
+    catch {
+        return null;
+    }
+}
+function readGitInfo() {
+    const branch = readGitBranch();
+    let repoName = null;
+    try {
+        const remote = execSync('git remote get-url origin', { timeout: 500, stdio: ['pipe', 'pipe', 'pipe'] })
+            .toString()
+            .trim();
+        // Extract repo name from URL (handles HTTPS and SSH)
+        const match = remote.match(/[:/]([^/]+\/[^/.]+)(\.git)?$/);
+        repoName = match ? match[1] : null;
+    }
+    catch {
+        // no remote — that's fine
+    }
+    return { branch, repoName };
+}
+function secondsToHuman(elapsed) {
+    if (elapsed < 60)
+        return `${elapsed}s`;
+    if (elapsed < 3600)
+        return `${Math.floor(elapsed / 60)}m`;
+    return `${Math.floor(elapsed / 3600)}h`;
+}
+function readAgentMetrics() {
+    const data = readJson(STATE_FILES.agents);
+    return {
+        active: typeof data?.active === 'number' ? data.active : 0,
+        names: Array.isArray(data?.names) ? data.names : [],
+    };
+}
+function readTaskMetrics() {
+    const data = readJson(STATE_FILES.tasks);
+    if (!data)
+        return null;
+    return {
+        done: typeof data.done === 'number' ? data.done : 0,
+        total: typeof data.total === 'number' ? data.total : 0,
+        current: typeof data.current === 'string' ? data.current : null,
+    };
+}
+function readCostMetrics() {
+    const data = readJson(STATE_FILES.sessionCost);
+    if (!data)
+        return null;
+    const raw = data.total;
+    const total = typeof raw === 'number'
+        ? raw.toFixed(2)
+        : typeof raw === 'string'
+            ? raw
+            : null;
+    if (total === null)
+        return null;
+    return { total, currency: 'USD' };
+}
+function readContextMetrics() {
+    const data = readJson(STATE_FILES.lastContext);
+    if (!data)
+        return null;
+    const ts = typeof data.timestamp === 'number' ? data.timestamp : null;
+    if (!ts)
+        return null;
+    const elapsed = Math.floor(Date.now() / 1000) - ts;
+    return {
+        ageSeconds: elapsed,
+        ageHuman: secondsToHuman(elapsed),
+        lastQuery: typeof data.query === 'string' ? data.query : null,
+    };
+}
+function readRateLimitMetrics() {
+    const data = readJson(STATE_FILES.rateLimit);
+    const raw = typeof data?.status === 'string' ? data.status.toUpperCase() : 'OK';
+    const status = raw === 'WARN' ? 'WARN' : raw === 'BLOCKED' ? 'BLOCKED' : 'OK';
+    return {
+        status,
+        remainingTokens: typeof data?.remainingTokens === 'number' ? data.remainingTokens : null,
+        resetsAt: typeof data?.resetsAt === 'string' ? data.resetsAt : null,
+    };
+}
+// ── Zod schemas ──────────────────────────────────────────────────────────────
+const HudUpdateSchema = z.object({
+    metric: z.enum(['agents', 'tasks', 'cost', 'context', 'rateLimit']),
+    value: z.union([z.string(), z.number()]),
+});
+// ── Tool registration ────────────────────────────────────────────────────────
+export function registerHudTools(ctx) {
+    const { server } = ctx;
+    // ── merlin_hud_status ─────────────────────────────────────────────────────
+    server.tool('merlin_hud_status', 'Get real-time HUD metrics for the current Merlin session: active agents, task progress, ' +
+        'session cost, context freshness (time since last Sights call), rate limit health, and git ' +
+        'branch/repo info. Use to display a live statusline, build a session dashboard, or check ' +
+        'session health at a glance. Returns structured JSON with all available metrics; missing ' +
+        'state files produce null values rather than errors.', {}, async () => {
+        const version = readVersion();
+        const agents = readAgentMetrics();
+        const tasks = readTaskMetrics();
+        const cost = readCostMetrics();
+        const context = readContextMetrics();
+        const rateLimit = readRateLimitMetrics();
+        const git = readGitInfo();
+        // Build human-readable statusline
+        const parts = [];
+        if (version)
+            parts.push(`v${version}`);
+        parts.push(`${agents.active} agents`);
+        if (tasks)
+            parts.push(`${tasks.done}/${tasks.total} tasks`);
+        if (cost)
+            parts.push(`$${cost.total}`);
+        if (git.branch)
+            parts.push(git.branch);
+        if (context)
+            parts.push(`ctx:${context.ageHuman}`);
+        parts.push(`rate:${rateLimit.status}`);
+        const statusLine = parts.join(' | ');
+        const payload = {
+            statusLine,
+            metrics: {
+                version,
+                agents,
+                tasks,
+                cost,
+                context,
+                rateLimit,
+                git,
+            },
+            stateDir: STATE_DIR,
+            generatedAt: new Date().toISOString(),
+        };
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(payload, null, 2),
+                }],
+        };
+    });
+    // ── merlin_hud_update ─────────────────────────────────────────────────────
+    server.tool('merlin_hud_update', 'Update a single HUD metric so the statusline stays current. Called by hooks and agents ' +
+        'after state changes: e.g. set agents=2 when a new agent starts, set cost=1.24 after a ' +
+        'routing call, set context timestamp when Sights is queried. ' +
+        'metric: one of agents | tasks | cost | context | rateLimit. ' +
+        'value: a number (for agents/cost) or a JSON string with structured fields.', {
+        metric: z.enum(['agents', 'tasks', 'cost', 'context', 'rateLimit'])
+            .describe('Which metric to update'),
+        value: z.union([z.string(), z.number()])
+            .describe('New value — number for scalar metrics, JSON string for structured ones'),
+    }, async (raw) => {
+        const parsed = HudUpdateSchema.safeParse(raw);
+        if (!parsed.success) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Invalid input: ${parsed.error.message}`,
+                    }],
+                isError: true,
+            };
+        }
+        const { metric, value } = parsed.data;
+        try {
+            ensureStateDir();
+            switch (metric) {
+                case 'agents': {
+                    const count = typeof value === 'number' ? value : parseInt(String(value), 10);
+                    const existing = readJson(STATE_FILES.agents) ?? {};
+                    writeJson(STATE_FILES.agents, { ...existing, active: isNaN(count) ? 0 : count });
+                    break;
+                }
+                case 'tasks': {
+                    // value can be "3/8" or a JSON string like {"done":3,"total":8}
+                    if (typeof value === 'string' && value.includes('/')) {
+                        const [done, total] = value.split('/').map(Number);
+                        const existing = readJson(STATE_FILES.tasks) ?? {};
+                        writeJson(STATE_FILES.tasks, { ...existing, done: done ?? 0, total: total ?? 0 });
+                    }
+                    else if (typeof value === 'string') {
+                        try {
+                            const obj = JSON.parse(value);
+                            const existing = readJson(STATE_FILES.tasks) ?? {};
+                            writeJson(STATE_FILES.tasks, { ...existing, ...obj });
+                        }
+                        catch {
+                            return {
+                                content: [{
+                                        type: 'text',
+                                        text: 'tasks value must be "done/total" (e.g. "3/8") or a JSON object.',
+                                    }],
+                                isError: true,
+                            };
+                        }
+                    }
+                    break;
+                }
+                case 'cost': {
+                    const total = typeof value === 'number'
+                        ? value.toFixed(2)
+                        : String(value).replace(/^\$/, '');
+                    const existing = readJson(STATE_FILES.sessionCost) ?? {};
+                    writeJson(STATE_FILES.sessionCost, { ...existing, total });
+                    break;
+                }
+                case 'context': {
+                    const ts = Math.floor(Date.now() / 1000);
+                    const query = typeof value === 'string' ? value : null;
+                    const existing = readJson(STATE_FILES.lastContext) ?? {};
+                    writeJson(STATE_FILES.lastContext, { ...existing, timestamp: ts, query });
+                    break;
+                }
+                case 'rateLimit': {
+                    const statusRaw = String(value).toUpperCase();
+                    const status = statusRaw === 'WARN' ? 'WARN' : statusRaw === 'BLOCKED' ? 'BLOCKED' : 'OK';
+                    const existing = readJson(STATE_FILES.rateLimit) ?? {};
+                    writeJson(STATE_FILES.rateLimit, { ...existing, status });
+                    break;
+                }
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `HUD metric '${metric}' updated.`,
+                    }],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to write HUD state: ${msg}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=hud.js.map

package/dist/server/tools/hud.js.map

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

package/dist/server/tools/index.d.ts

@@ -11,6 +11,7 @@ export { registerVerificationTools } from './verification.js';
 export { registerAdaptiveTools } from './adaptive.js';
 export { registerAgentTools } from './agents.js';
 export { registerDiscoveryTools } from './discoveries.js';
+export { registerHelpTools } from './help.js';
 export { registerRouteTools } from './route.js';
 export { registerSightsIndexTools } from './sights-index.js';
 export { registerAgentsIndexTools } from './agents-index.js';
@@ -19,4 +20,8 @@ export { registerSessionSearchTools } from './session-search.js';
 export { registerPromoteTools } from './promote.js';
 export { registerLearningTools } from './learning.js';
 export { registerChallengeTools } from './challenge.js';
+export { registerAutoModeTools } from './auto-mode.js';
+export { registerDreamTools } from './dream.js';
+export { registerComputerUseTools } from './computer-use.js';
+export { registerSkillsTools } from './skills.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/server/tools/index.js

@@ -10,6 +10,7 @@ export { registerVerificationTools } from './verification.js';
 export { registerAdaptiveTools } from './adaptive.js';
 export { registerAgentTools } from './agents.js';
 export { registerDiscoveryTools } from './discoveries.js';
+export { registerHelpTools } from './help.js';
 export { registerRouteTools } from './route.js';
 export { registerSightsIndexTools } from './sights-index.js';
 export { registerAgentsIndexTools } from './agents-index.js';
@@ -18,4 +19,8 @@ export { registerSessionSearchTools } from './session-search.js';
 export { registerPromoteTools } from './promote.js';
 export { registerLearningTools } from './learning.js';
 export { registerChallengeTools } from './challenge.js';
+export { registerAutoModeTools } from './auto-mode.js';
+export { registerDreamTools } from './dream.js';
+export { registerComputerUseTools } from './computer-use.js';
+export { registerSkillsTools } from './skills.js';
 //# sourceMappingURL=index.js.map

package/dist/server/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/server/tools/provider-ask.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Multi-Provider CLI Orchestration Tools
+ *
+ * Delegate tasks to external AI CLI tools (claude, codex, gemini) and
+ * capture their output as artifacts. Supports parallel synthesis across
+ * multiple providers for second opinions and architectural decisions.
+ */
+import type { ToolContext } from './types.js';
+export declare function registerProviderTools(ctx: ToolContext): void;
+//# sourceMappingURL=provider-ask.d.ts.map

package/dist/server/tools/provider-ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-ask.d.ts","sourceRoot":"","sources":["../../../src/server/tools/provider-ask.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsN9C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0F5D"}

package/dist/server/tools/provider-ask.js

@@ -0,0 +1,234 @@
+/**
+ * Multi-Provider CLI Orchestration Tools
+ *
+ * Delegate tasks to external AI CLI tools (claude, codex, gemini) and
+ * capture their output as artifacts. Supports parallel synthesis across
+ * multiple providers for second opinions and architectural decisions.
+ */
+import { z } from 'zod';
+import { spawn } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// ── Constants ─────────────────────────────────────────────────────────────────
+const ARTIFACTS_DIR = join(homedir(), '.merlin', 'artifacts', 'ask');
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/** Build the shell command array for a given provider. */
+function buildCommand(provider, prompt) {
+    switch (provider) {
+        case 'claude':
+            return ['claude', '-p', prompt, '--output-format', 'text'];
+        case 'codex':
+            return ['codex', 'exec', prompt];
+        case 'gemini':
+            return ['gemini', '-p', prompt];
+    }
+}
+/** Check whether a CLI binary exists on PATH. */
+async function isBinaryAvailable(bin) {
+    return new Promise((resolve) => {
+        const proc = spawn('which', [bin], { stdio: 'pipe' });
+        proc.on('close', (code) => resolve(code === 0));
+        proc.on('error', () => resolve(false));
+    });
+}
+/** Build a URL-friendly slug from a prompt string. */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .slice(0, 40);
+}
+/** Ensure the artifacts directory exists. */
+function ensureArtifactsDir() {
+    if (!existsSync(ARTIFACTS_DIR)) {
+        mkdirSync(ARTIFACTS_DIR, { recursive: true });
+    }
+}
+/** Save the result to a markdown artifact file. Returns the path. */
+function saveArtifact(provider, prompt, output, exitCode, timestamp) {
+    ensureArtifactsDir();
+    const slug = slugify(prompt);
+    const filename = `${provider}-${slug}-${timestamp}.md`;
+    const filePath = join(ARTIFACTS_DIR, filename);
+    const content = [
+        `# Provider Ask — ${provider}`,
+        '',
+        `**Timestamp:** ${timestamp}`,
+        `**Exit Code:** ${exitCode}`,
+        '',
+        '## Prompt',
+        '',
+        prompt,
+        '',
+        '## Output',
+        '',
+        output || '_(no output)_',
+    ].join('\n');
+    writeFileSync(filePath, content, 'utf-8');
+    return filePath;
+}
+/** Spawn one provider CLI and return its result. */
+async function runProvider(provider, prompt, agentPrompt, timeoutMs, timestamp) {
+    const startTime = Date.now();
+    const available = await isBinaryAvailable(provider === 'claude' ? 'claude' : provider);
+    if (!available) {
+        return {
+            provider,
+            output: '',
+            exitCode: -1,
+            durationMs: 0,
+            artifactPath: null,
+            error: `CLI not found: '${provider}' is not installed or not on PATH. Install it and try again.`,
+        };
+    }
+    const fullPrompt = agentPrompt ? `${agentPrompt}\n\n${prompt}` : prompt;
+    const cmdArgs = buildCommand(provider, fullPrompt);
+    const [cmd, ...args] = cmdArgs;
+    // Strip env vars known to interfere with Codex
+    const env = { ...process.env };
+    if (provider === 'codex') {
+        delete env['RUST_LOG'];
+        delete env['RUST_BACKTRACE'];
+    }
+    return new Promise((resolve) => {
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        const proc = spawn(cmd, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env,
+        });
+        proc.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+        proc.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            proc.kill('SIGTERM');
+        }, timeoutMs);
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            const durationMs = Date.now() - startTime;
+            const output = Buffer.concat(stdoutChunks).toString('utf-8').trim();
+            const stderr = Buffer.concat(stderrChunks).toString('utf-8').trim();
+            const exitCode = timedOut ? 124 : (code ?? -1);
+            let error = null;
+            if (timedOut) {
+                error = `Timed out after ${timeoutMs / 1000}s`;
+            }
+            else if (exitCode !== 0 && !output) {
+                error = stderr || `Process exited with code ${exitCode}`;
+            }
+            const artifactPath = saveArtifact(provider, prompt, output || stderr, exitCode, timestamp);
+            resolve({ provider, output: output || stderr, exitCode, durationMs, artifactPath, error });
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({
+                provider,
+                output: '',
+                exitCode: -1,
+                durationMs: Date.now() - startTime,
+                artifactPath: null,
+                error: `Failed to spawn process: ${err.message}`,
+            });
+        });
+    });
+}
+/** Format a single provider result for display. */
+function formatResult(result) {
+    const statusLine = result.error
+        ? `Status: ERROR — ${result.error}`
+        : `Status: OK (exit ${result.exitCode}, ${result.durationMs}ms)`;
+    const artifactLine = result.artifactPath ? `Artifact: ${result.artifactPath}` : '';
+    const lines = [
+        `## ${result.provider.toUpperCase()}`,
+        statusLine,
+        artifactLine,
+        '',
+        result.error && !result.output ? '_No output._' : result.output,
+    ].filter((l) => l !== undefined);
+    return lines.join('\n');
+}
+/** Build a comparison table from multiple results. */
+function buildSynthesis(results, prompt) {
+    const rows = results.map((r) => {
+        const status = r.error ? 'ERROR' : 'OK';
+        const preview = (r.output || '').slice(0, 120).replace(/\n/g, ' ');
+        return `| ${r.provider} | ${status} | ${r.durationMs}ms | ${preview}... |`;
+    });
+    return [
+        '## Synthesis Comparison',
+        '',
+        `**Prompt:** ${prompt}`,
+        '',
+        '| Provider | Status | Duration | Output Preview |',
+        '|----------|--------|----------|----------------|',
+        ...rows,
+        '',
+        '### Full Outputs',
+        '',
+        ...results.map(formatResult),
+    ].join('\n');
+}
+// ── Tool Registration ─────────────────────────────────────────────────────────
+export function registerProviderTools(ctx) {
+    const { server } = ctx;
+    // ── merlin_ask_provider ───────────────────────────────────────────────────
+    server.tool('merlin_ask_provider', 'Delegate a task to an external AI CLI provider (claude, codex, or gemini) and capture the result. ' +
+        'Use for multi-model synthesis, second opinions, or leveraging provider-specific strengths. ' +
+        'Automatically detects if the CLI is installed and saves an artifact to ~/.merlin/artifacts/ask/. ' +
+        'Returns the full output text so Merlin can incorporate it into orchestration decisions.', {
+        provider: z.enum(['claude', 'codex', 'gemini']).describe('Which AI CLI to invoke: claude (Claude Code), codex (OpenAI Codex CLI), or gemini (Google Gemini CLI)'),
+        prompt: z.string().describe('The task or question to send to the provider'),
+        agentPrompt: z.string().optional().describe('Optional role/persona template to prepend before the main prompt (e.g., "You are a senior security engineer.")'),
+        timeoutSeconds: z.number().optional().default(120).describe('Maximum seconds to wait for the provider to respond (default: 120)'),
+    }, async ({ provider, prompt, agentPrompt, timeoutSeconds }) => {
+        const timeoutMs = (timeoutSeconds ?? 120) * 1000;
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const result = await runProvider(provider, prompt, agentPrompt, timeoutMs, timestamp);
+        if (result.error && !result.output) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Provider ask failed — ${provider}: ${result.error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const text = [
+            formatResult(result),
+            result.artifactPath ? `\nArtifact saved to: ${result.artifactPath}` : '',
+        ]
+            .join('\n')
+            .trim();
+        return { content: [{ type: 'text', text }] };
+    });
+    // ── merlin_ask_synthesis ──────────────────────────────────────────────────
+    server.tool('merlin_ask_synthesis', 'Run the same prompt through multiple AI CLI providers in parallel and synthesize the results. ' +
+        'Ideal for architecture decisions, code review, security analysis, or any task where multiple perspectives add value. ' +
+        'Returns a comparison table plus each provider\'s full output. ' +
+        'Artifacts for each provider are saved to ~/.merlin/artifacts/ask/.', {
+        providers: z.array(z.enum(['claude', 'codex', 'gemini'])).describe('Which AI CLIs to query in parallel — all must be installed locally'),
+        prompt: z.string().describe('The task or question to send to all providers'),
+        synthesize: z.boolean().optional().default(true).describe('When true (default), includes a comparison table at the top of the response'),
+    }, async ({ providers, prompt, synthesize }) => {
+        if (providers.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No providers specified. Pass at least one of: claude, codex, gemini.' }],
+                isError: true,
+            };
+        }
+        const timeoutMs = 180 * 1000; // synthesis allows longer per-provider timeout
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const results = await Promise.all(providers.map((p) => runProvider(p, prompt, undefined, timeoutMs, timestamp)));
+        const text = synthesize !== false
+            ? buildSynthesis(results, prompt)
+            : results.map(formatResult).join('\n\n---\n\n');
+        return { content: [{ type: 'text', text }] };
+    });
+}
+//# sourceMappingURL=provider-ask.js.map

package/dist/server/tools/provider-ask.js.map

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

package/dist/server/tools/rate-limit.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Rate Limit Tools
+ * Monitor Claude/provider rate-limit state and configure auto-resume behavior.
+ * State is written by the rate-limit-watch.sh PostToolUse hook.
+ */
+import type { ToolContext } from './types.js';
+export declare function registerRateLimitTools(ctx: ToolContext): void;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/server/tools/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/server/tools/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0G9C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA8H7D"}