create-merlin-brain 3.22.0 → 3.23.0

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"}

package/dist/server/tools/rate-limit.js

@@ -0,0 +1,184 @@
+/**
+ * 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 { z } from 'zod';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { coachWrap } from '../session-coach.js';
+const STATE_DIR = join(homedir(), '.merlin', 'state');
+const RATE_LIMIT_STATE_FILE = join(STATE_DIR, 'rate-limit.json');
+const SESSION_COST_FILE = join(STATE_DIR, 'session-cost.json');
+const CONFIG_FILE = join(STATE_DIR, 'rate-limit-config.json');
+/** Default config values */
+const DEFAULTS = {
+    warningThreshold: 80,
+    autoResume: true,
+    cooldownMinutes: 2,
+    notifyDesktop: true,
+};
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function readJson(filePath) {
+    try {
+        if (!existsSync(filePath))
+            return null;
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function ensureStateDir() {
+    if (!existsSync(STATE_DIR)) {
+        mkdirSync(STATE_DIR, { recursive: true });
+    }
+}
+function readConfig() {
+    const saved = readJson(CONFIG_FILE);
+    return {
+        warningThreshold: saved?.warningThreshold ?? DEFAULTS.warningThreshold,
+        autoResume: saved?.autoResume ?? DEFAULTS.autoResume,
+        cooldownMinutes: saved?.cooldownMinutes ?? DEFAULTS.cooldownMinutes,
+        notifyDesktop: saved?.notifyDesktop ?? DEFAULTS.notifyDesktop,
+    };
+}
+/** Seconds until the estimated reset time (negative = already passed) */
+function secondsUntilReset(estimatedResetAt) {
+    try {
+        const resetMs = new Date(estimatedResetAt).getTime();
+        return Math.round((resetMs - Date.now()) / 1000);
+    }
+    catch {
+        return 0;
+    }
+}
+/** Seconds since a given ISO timestamp */
+function secondsSince(isoTs) {
+    try {
+        return Math.round((Date.now() - new Date(isoTs).getTime()) / 1000);
+    }
+    catch {
+        return 0;
+    }
+}
+/** Determine effective status including cooldown transition */
+function effectiveStatus(state, config, usagePercent) {
+    if (state?.status === 'blocked')
+        return 'blocked';
+    // Cooldown: recently cleared within cooldownMinutes window
+    if (state?.status === 'ok' && state.clearedAt) {
+        const elapsed = secondsSince(state.clearedAt);
+        if (elapsed < config.cooldownMinutes * 60)
+            return 'cooldown';
+    }
+    if (usagePercent >= config.warningThreshold)
+        return 'warning';
+    return 'ok';
+}
+// ── Tool registration ─────────────────────────────────────────────────────────
+export function registerRateLimitTools(ctx) {
+    const { server } = ctx;
+    // ── merlin_rate_limit_status ────────────────────────────────────────────────
+    server.tool('merlin_rate_limit_status', 'Check current rate limit status across providers. Returns current state (ok/warning/blocked/cooldown), time until reset, and session usage metrics. Use before spawning agents to decide whether to throttle. Blocked = stop spawning. Warning = spawn cautiously. Cooldown = recently unblocked, proceed slowly.', {}, async () => {
+        try {
+            const state = readJson(RATE_LIMIT_STATE_FILE);
+            const cost = readJson(SESSION_COST_FILE);
+            const config = readConfig();
+            const usagePercent = cost?.usagePercent ?? 0;
+            const status = effectiveStatus(state, config, usagePercent);
+            let statusLine = '';
+            let recommendation = '';
+            let resetInfo = '';
+            if (status === 'blocked') {
+                const secsLeft = state?.estimatedResetAt ? secondsUntilReset(state.estimatedResetAt) : 0;
+                const minsLeft = secsLeft > 0 ? Math.ceil(secsLeft / 60) : 0;
+                resetInfo = secsLeft > 0
+                    ? `Estimated reset: ~${minsLeft} min (${state.estimatedResetAt})`
+                    : `Reset time has passed — state may clear on next tool call`;
+                statusLine = `**Status: BLOCKED** (trigger: ${state?.trigger ?? 'unknown'})`;
+                recommendation = config.autoResume
+                    ? `Auto-resume is enabled. Do not spawn new agents. Wait ${minsLeft > 0 ? `~${minsLeft} min` : 'for the next tool call to clear state'}.`
+                    : 'Auto-resume is disabled. Manually call merlin_rate_limit_status again after waiting.';
+            }
+            else if (status === 'cooldown') {
+                const elapsed = state?.clearedAt ? secondsSince(state.clearedAt) : 0;
+                const remaining = Math.max(0, config.cooldownMinutes * 60 - elapsed);
+                statusLine = `**Status: COOLDOWN** (${Math.ceil(remaining / 60)} min remaining)`;
+                recommendation = 'Recently unblocked. Proceed cautiously — spawn agents at reduced rate.';
+            }
+            else if (status === 'warning') {
+                statusLine = `**Status: WARNING** (${usagePercent}% usage — threshold: ${config.warningThreshold}%)`;
+                recommendation = 'Approaching rate limits. Avoid spawning multiple parallel agents.';
+            }
+            else {
+                statusLine = `**Status: OK** (${usagePercent}% usage)`;
+                recommendation = 'Normal operations. No restrictions.';
+            }
+            const text = `
+${statusLine}
+
+${resetInfo ? `${resetInfo}\n` : ''}**Recommendation:** ${recommendation}
+
+**Config:** warning at ${config.warningThreshold}% · auto-resume: ${config.autoResume} · cooldown: ${config.cooldownMinutes}min
+
+To update these settings, call \`merlin_rate_limit_configure\`.
+`.trim();
+            return {
+                content: [{ type: 'text', text: coachWrap('merlin_rate_limit_status', text) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `**Error reading rate limit state:** ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+    // ── merlin_rate_limit_configure ─────────────────────────────────────────────
+    server.tool('merlin_rate_limit_configure', 'Configure rate limit thresholds and auto-resume behavior for Merlin. Sets the warning percentage, whether blocked sessions auto-resume, cooldown duration after unblocking, and desktop notifications. Config is persisted to ~/.merlin/state/rate-limit-config.json.', {
+        warningThreshold: z.number().min(1).max(100).optional().describe('Usage percentage at which to warn (default: 80)'),
+        autoResume: z.boolean().optional().describe('Whether to auto-resume blocked sessions when the rate limit clears (default: true)'),
+        cooldownMinutes: z.number().min(0).max(60).optional().describe('Minutes to stay in cooldown after unblocking (default: 2)'),
+        notifyDesktop: z.boolean().optional().describe('Send macOS desktop notification when rate limit is detected (default: true)'),
+    }, async ({ warningThreshold, autoResume, cooldownMinutes, notifyDesktop }) => {
+        try {
+            ensureStateDir();
+            const current = readConfig();
+            const updated = {
+                warningThreshold: warningThreshold ?? current.warningThreshold,
+                autoResume: autoResume ?? current.autoResume,
+                cooldownMinutes: cooldownMinutes ?? current.cooldownMinutes,
+                notifyDesktop: notifyDesktop ?? current.notifyDesktop,
+            };
+            writeFileSync(CONFIG_FILE, JSON.stringify(updated, null, 2), 'utf-8');
+            const text = `
+**Rate limit config updated**
+
+- Warning threshold: ${updated.warningThreshold}%
+- Auto-resume: ${updated.autoResume}
+- Cooldown after unblock: ${updated.cooldownMinutes} min
+- Desktop notifications: ${updated.notifyDesktop}
+
+Saved to \`~/.merlin/state/rate-limit-config.json\`
+`.trim();
+            return {
+                content: [{ type: 'text', text: coachWrap('merlin_rate_limit_configure', text) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `**Error saving rate limit config:** ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/server/tools/rate-limit.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Skills Tools — Discover, load, evolve, and track skills
+ *
+ * Skills are prompt injections stored as .md files in ~/.claude/merlin/skills/.
+ * Claude reads SKILLS-INDEX.md to find relevant skills, then loads the full .md.
+ *
+ * Inspired by OpenSpace's self-evolving skill system:
+ * - Skills track usage and success rates
+ * - Skills can be improved after use (auto-evolution)
+ * - Improvements push to the server for collective intelligence
+ *
+ * Works identically in CLI (via MCP) and Studio (same file paths).
+ */
+import type { ToolContext } from './types.js';
+export declare function registerSkillsTools(ctx: ToolContext): void;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/server/tools/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4H9C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0M1D"}