create-merlin-brain 3.22.0 → 4.0.0

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

package/dist/server/tools/skills.js

@@ -0,0 +1,326 @@
+/**
+ * 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 { z } from 'zod';
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync, mkdirSync } from 'fs';
+import { join, relative, basename } from 'path';
+import { homedir } from 'os';
+import { coachWrap } from '../session-coach.js';
+// ─── Paths ────────────────────────────────────────────────────────────────────
+const SKILLS_DIR = join(homedir(), '.claude', 'merlin', 'skills');
+const SKILLS_INDEX = join(SKILLS_DIR, 'SKILLS-INDEX.md');
+const SKILL_STATS_FILE = join(homedir(), '.claude', 'merlin', 'skill-stats.json');
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function loadStats() {
+    try {
+        if (existsSync(SKILL_STATS_FILE)) {
+            return JSON.parse(readFileSync(SKILL_STATS_FILE, 'utf-8'));
+        }
+    }
+    catch { /* ignore */ }
+    return {};
+}
+function saveStats(stats) {
+    try {
+        mkdirSync(join(homedir(), '.claude', 'merlin'), { recursive: true });
+        writeFileSync(SKILL_STATS_FILE, JSON.stringify(stats, null, 2), 'utf-8');
+    }
+    catch { /* non-critical */ }
+}
+/** Find all .md files recursively in a directory */
+function findSkillFiles(dir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    for (const entry of readdirSync(dir)) {
+        const fullPath = join(dir, entry);
+        try {
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                results.push(...findSkillFiles(fullPath));
+            }
+            else if (entry.endsWith('.md') && entry !== 'SKILLS-INDEX.md') {
+                results.push(fullPath);
+            }
+        }
+        catch { /* skip unreadable */ }
+    }
+    return results;
+}
+/** Parse frontmatter from a skill .md file */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const result = {};
+    for (const line of match[1].split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx > 0) {
+            const key = line.slice(0, colonIdx).trim();
+            let value = line.slice(colonIdx + 1).trim();
+            // Parse arrays
+            if (typeof value === 'string' && value.startsWith('[')) {
+                try {
+                    value = JSON.parse(value.replace(/'/g, '"'));
+                }
+                catch { /* keep as string */ }
+            }
+            // Parse numbers
+            if (typeof value === 'string' && /^\d+$/.test(value)) {
+                value = parseInt(value, 10);
+            }
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/** Search skills by keyword matching against tags and name */
+function searchSkills(query) {
+    const files = findSkillFiles(SKILLS_DIR);
+    const queryWords = query.toLowerCase().split(/\s+/);
+    const results = [];
+    for (const filePath of files) {
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const fm = parseFrontmatter(content);
+            const id = fm.id || basename(filePath, '.md');
+            const name = fm.name || id;
+            const tags = fm.tags || [];
+            const domain = fm.domain || '';
+            const category = fm.category || '';
+            // Score: exact tag match = 3, partial tag match = 2, name match = 2, domain/category = 1
+            let score = 0;
+            const allSearchable = [...tags, name.toLowerCase(), domain, category];
+            for (const word of queryWords) {
+                for (const term of allSearchable) {
+                    if (term === word)
+                        score += 3;
+                    else if (term.includes(word) || word.includes(term))
+                        score += 1;
+                }
+            }
+            if (score > 0) {
+                const relPath = relative(SKILLS_DIR, filePath).replace(/\.md$/, '');
+                results.push({ id, name, path: relPath, score, tags });
+            }
+        }
+        catch { /* skip unreadable */ }
+    }
+    return results.sort((a, b) => b.score - a.score);
+}
+// ─── Register Tools ───────────────────────────────────────────────────────────
+export function registerSkillsTools(ctx) {
+    const { server } = ctx;
+    // ── merlin_find_skill — search the skills index ──────────────────────────
+    server.tool('merlin_find_skill', 'Search the Merlin Skills Index for relevant skills to load. ' +
+        'Describe what you need (e.g., "react performance", "stripe payments", "telegram bot") ' +
+        'and get back the best matching skills with their file paths. ' +
+        'Load the top 1-3 skills by reading their .md files.', {
+        query: z.string().describe('What kind of skill you need (e.g., "react hooks", "security audit", "whatsapp messaging")'),
+        limit: z.number().optional().describe('Max results to return (default 5)'),
+    }, async ({ query, limit }) => {
+        const maxResults = Math.min(limit || 5, 20);
+        // First try local file search
+        const localResults = searchSkills(query);
+        // Also try server index if available
+        let serverResults = [];
+        try {
+            const skills = await ctx.client.request(`/api/skills/search?q=${encodeURIComponent(query)}&limit=${maxResults}`);
+            serverResults = skills.skills || [];
+        }
+        catch { /* server unavailable — local-only is fine */ }
+        // Merge results (local first, deduplicated)
+        const seen = new Set();
+        const merged = [];
+        for (const r of localResults.slice(0, maxResults)) {
+            seen.add(r.id);
+            const stats = loadStats()[r.id];
+            const successRate = stats && stats.usageCount > 0
+                ? `${Math.round((stats.successCount / stats.usageCount) * 100)}%`
+                : 'new';
+            merged.push(`**${r.name}** (${r.path})\n` +
+                `  Tags: ${r.tags.join(', ')}\n` +
+                `  Score: ${r.score} | Success: ${successRate} | Uses: ${stats?.usageCount || 0}\n` +
+                `  Load: Read ~/.claude/merlin/skills/${r.path}.md`);
+        }
+        for (const r of serverResults) {
+            if (!seen.has(r.id) && merged.length < maxResults) {
+                seen.add(r.id);
+                merged.push(`**${r.name}** (server)\n` +
+                    `  ${r.description}\n` +
+                    `  Install: merlin_install_skill("${r.id}")`);
+            }
+        }
+        const response = merged.length > 0
+            ? `Found ${merged.length} skill(s) for "${query}":\n\n${merged.join('\n\n')}`
+            : `No skills found for "${query}". You can create one with merlin_evolve_skill after completing the task.`;
+        return {
+            content: [{ type: 'text', text: coachWrap('merlin_find_skill', response) }],
+        };
+    });
+    // ── merlin_track_skill — record skill usage outcome ──────────────────────
+    server.tool('merlin_track_skill', 'Record that a skill was used and whether it helped. ' +
+        'Call this after using a skill to track quality. ' +
+        'Skills with high success rates get recommended more often.', {
+        skillId: z.string().describe('The skill ID (from frontmatter)'),
+        success: z.boolean().describe('Did the skill help accomplish the task?'),
+        feedback: z.string().optional().describe('What worked or didn\'t work'),
+    }, async ({ skillId, success, feedback }) => {
+        const stats = loadStats();
+        if (!stats[skillId]) {
+            stats[skillId] = { usageCount: 0, successCount: 0, failCount: 0, lastUsed: '', version: 1 };
+        }
+        stats[skillId].usageCount++;
+        if (success)
+            stats[skillId].successCount++;
+        else
+            stats[skillId].failCount++;
+        stats[skillId].lastUsed = new Date().toISOString();
+        saveStats(stats);
+        // Push stats to server (background, non-blocking)
+        try {
+            void ctx.client.request('/api/skills/usage', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ skillId, success, feedback }),
+            });
+        }
+        catch { /* non-critical */ }
+        const rate = Math.round((stats[skillId].successCount / stats[skillId].usageCount) * 100);
+        const response = success
+            ? `Tracked: ${skillId} succeeded (${rate}% success rate, ${stats[skillId].usageCount} uses)`
+            : `Tracked: ${skillId} failed (${rate}% success rate). ${feedback ? `Feedback: ${feedback}` : 'Consider evolving this skill.'}`;
+        return {
+            content: [{ type: 'text', text: coachWrap('merlin_track_skill', response) }],
+        };
+    });
+    // ── merlin_evolve_skill — improve or create a skill ──────────────────────
+    server.tool('merlin_evolve_skill', 'Improve an existing skill or create a new one based on what you learned during a task. ' +
+        'This is how skills self-evolve: after using a skill, if you found it lacking or wrong, ' +
+        'update it with better instructions. New skills are created from successful task patterns.', {
+        skillId: z.string().describe('Skill ID to evolve (or new ID for a new skill)'),
+        name: z.string().describe('Human-readable skill name'),
+        domain: z.enum(['coding', 'non-coding']).describe('Top-level domain'),
+        category: z.string().describe('Sub-category (e.g., frontend, security, communication, automation)'),
+        tags: z.array(z.string()).describe('Search tags for discovery'),
+        content: z.string().describe('The full skill instructions (markdown)'),
+        reason: z.string().describe('Why this skill was created or what changed'),
+    }, async ({ skillId, name, domain, category, tags, content, reason }) => {
+        // Determine file path
+        const categoryDir = join(SKILLS_DIR, domain === 'non-coding' ? category : `coding`);
+        // For non-coding, use the category directly; for coding, check if the category subdir makes more sense
+        const targetDir = existsSync(join(SKILLS_DIR, category)) ? join(SKILLS_DIR, category) : categoryDir;
+        mkdirSync(targetDir, { recursive: true });
+        const filePath = join(targetDir, `${skillId}.md`);
+        // Check if evolving an existing skill
+        let version = 1;
+        const evolutionLog = [];
+        if (existsSync(filePath)) {
+            const existing = readFileSync(filePath, 'utf-8');
+            const fm = parseFrontmatter(existing);
+            version = (fm.version || 0) + 1;
+            const existingEvolution = fm.evolution || [];
+            evolutionLog.push(...existingEvolution);
+        }
+        evolutionLog.push(`v${version}: ${reason}`);
+        // Write the skill file
+        const frontmatter = [
+            '---',
+            `id: ${skillId}`,
+            `name: ${name}`,
+            `domain: ${domain}`,
+            `category: ${category}`,
+            `tags: [${tags.join(', ')}]`,
+            `version: ${version}`,
+            `source: ${version === 1 ? 'evolved' : 'evolved'}`,
+            `successRate: 0`,
+            `usageCount: 0`,
+            `evolution:`,
+            ...evolutionLog.map(e => `  - "${e}"`),
+            '---',
+            '',
+        ].join('\n');
+        writeFileSync(filePath, frontmatter + content, 'utf-8');
+        // Update stats
+        const stats = loadStats();
+        if (stats[skillId]) {
+            stats[skillId].lastEvolved = new Date().toISOString();
+            stats[skillId].version = version;
+        }
+        saveStats(stats);
+        // Push to server (background)
+        try {
+            void ctx.client.request('/api/skills', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    id: skillId, name, domain, category, tags,
+                    content, version, reason,
+                }),
+            });
+        }
+        catch { /* non-critical */ }
+        // Update the index file
+        updateSkillsIndex();
+        const action = version === 1 ? 'Created' : `Evolved to v${version}`;
+        const response = `${action}: **${name}** (${skillId})\n` +
+            `Path: ${relative(join(homedir(), '.claude', 'merlin'), filePath)}\n` +
+            `Reason: ${reason}\n` +
+            `Tags: ${tags.join(', ')}`;
+        return {
+            content: [{ type: 'text', text: coachWrap('merlin_evolve_skill', response) }],
+        };
+    });
+}
+// ─── Index Regeneration ───────────────────────────────────────────────────────
+/** Rebuild SKILLS-INDEX.md from all skill files on disk */
+function updateSkillsIndex() {
+    const files = findSkillFiles(SKILLS_DIR);
+    const byCategory = new Map();
+    for (const filePath of files) {
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const fm = parseFrontmatter(content);
+            const id = fm.id || basename(filePath, '.md');
+            const name = fm.name || id;
+            const tags = fm.tags || [];
+            const domain = fm.domain || 'coding';
+            const category = fm.category || 'other';
+            const key = `${domain} > ${category}`;
+            const relPath = relative(SKILLS_DIR, filePath).replace(/\.md$/, '');
+            if (!byCategory.has(key))
+                byCategory.set(key, []);
+            byCategory.get(key).push({ id, name, tags, relPath });
+        }
+        catch { /* skip */ }
+    }
+    const lines = [
+        '# Merlin Skills Index',
+        '',
+        'Search this index to find skills. Load by reading the .md file.',
+        'Only load 1-3 per task. After use, track with merlin_track_skill.',
+        '',
+    ];
+    for (const [category, skills] of [...byCategory.entries()].sort()) {
+        lines.push(`## ${category}`);
+        for (const s of skills) {
+            lines.push(`- \`${s.relPath}\` — ${s.name} — [${s.tags.join(', ')}]`);
+        }
+        lines.push('');
+    }
+    try {
+        writeFileSync(SKILLS_INDEX, lines.join('\n'), 'utf-8');
+    }
+    catch { /* non-critical */ }
+}
+//# sourceMappingURL=skills.js.map

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

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

package/dist/server/tools/team-workers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Team Workers Tools — Spawn parallel AI CLI workers in tmux panes.
+ * Job state persisted to ~/.merlin/state/team/ for status/cleanup queries.
+ */
+import type { ToolContext } from './types.js';
+export declare function registerTeamWorkerTools(ctx: ToolContext): void;
+//# sourceMappingURL=team-workers.d.ts.map

package/dist/server/tools/team-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-workers.d.ts","sourceRoot":"","sources":["../../../src/server/tools/team-workers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0H9C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA4J9D"}