swarm-engine 1.0.0

package/dist/runtime/heuristics.js

@@ -0,0 +1,188 @@
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { redactSecrets } from '../utils/redact.js';
+export class HeuristicStore {
+    db;
+    constructor(dbPath) {
+        const path = dbPath ?? join(homedir(), '.swarm', 'data', 'heuristics.db');
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        this.db = new Database(path);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('busy_timeout = 5000');
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS heuristics (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        task_pattern TEXT NOT NULL,
+        lesson TEXT NOT NULL,
+        source TEXT NOT NULL,
+        confidence REAL DEFAULT 0.8,
+        use_count INTEGER DEFAULT 0,
+        success_when_used INTEGER DEFAULT 0,
+        created_at TEXT DEFAULT (datetime('now'))
+      );
+      CREATE INDEX IF NOT EXISTS idx_heuristics_pattern ON heuristics(task_pattern);
+      CREATE VIRTUAL TABLE IF NOT EXISTS heuristics_fts USING fts5(task_pattern, lesson, content=heuristics, content_rowid=id);
+      CREATE TRIGGER IF NOT EXISTS heuristics_ai AFTER INSERT ON heuristics BEGIN
+        INSERT INTO heuristics_fts(rowid, task_pattern, lesson) VALUES (new.id, new.task_pattern, new.lesson);
+      END;
+      CREATE TRIGGER IF NOT EXISTS heuristics_ad AFTER DELETE ON heuristics BEGIN
+        INSERT INTO heuristics_fts(heuristics_fts, rowid, task_pattern, lesson) VALUES('delete', old.id, old.task_pattern, old.lesson);
+      END;
+    `);
+    }
+    /** Extract heuristics from a completed execution trace */
+    extractFromTrace(trace) {
+        const heuristics = [];
+        const taskPattern = this.normalizeTask(trace.task);
+        if (trace.status === 'completed') {
+            // Success heuristics
+            heuristics.push({
+                taskPattern,
+                lesson: `Pattern "${trace.pattern}" succeeded for this type of task. Used ${trace.agentCount} agents across ${trace.phaseCount} phases. Cost: ${trace.totalTokens} tokens in ${Math.round(trace.durationMs / 1000)}s.`,
+                source: 'success',
+                confidence: 0.9,
+                useCount: 0,
+                successWhenUsed: 0,
+            });
+            // Extract lessons from phases
+            for (const phase of trace.phases) {
+                if (phase.confidence === 'high' && phase.tokens < 5000) {
+                    heuristics.push({
+                        taskPattern,
+                        lesson: `Phase "${phase.name}" was efficient (${phase.tokens} tokens, high confidence). Consider using cheaper model for this phase type.`,
+                        source: 'success',
+                        confidence: 0.8,
+                        useCount: 0,
+                        successWhenUsed: 0,
+                    });
+                }
+            }
+        }
+        else if (trace.status === 'failed') {
+            // Failure heuristics
+            const failedPhases = trace.phases.filter(p => p.status === 'failed');
+            for (const phase of failedPhases) {
+                heuristics.push({
+                    taskPattern,
+                    lesson: `Phase "${phase.name}" failed for this task type. Consider adding more context, using a stronger model, or decomposing differently.`,
+                    source: 'failure',
+                    confidence: 0.85,
+                    useCount: 0,
+                    successWhenUsed: 0,
+                });
+            }
+        }
+        // Extract from reflections
+        for (const reflection of trace.reflections) {
+            if (reflection.length > 50) {
+                heuristics.push({
+                    taskPattern,
+                    lesson: reflection.slice(0, 500),
+                    source: 'reflection',
+                    confidence: 0.7,
+                    useCount: 0,
+                    successWhenUsed: 0,
+                });
+            }
+        }
+        // Store all extracted heuristics
+        for (const h of heuristics) {
+            this.store(h);
+        }
+        return heuristics;
+    }
+    /** Store a heuristic */
+    store(h) {
+        const result = this.db.prepare(`
+      INSERT INTO heuristics (task_pattern, lesson, source, confidence, use_count, success_when_used)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(redactSecrets(h.taskPattern), redactSecrets(h.lesson), h.source, h.confidence, h.useCount, h.successWhenUsed);
+        return result.lastInsertRowid;
+    }
+    /** Retrieve relevant heuristics for a task using FTS5 */
+    retrieve(task, limit = 5) {
+        const normalized = this.normalizeTask(task);
+        const safeQuery = '"' + normalized.replace(/"/g, '') + '"';
+        try {
+            const rows = this.db.prepare(`
+        SELECT h.*, rank
+        FROM heuristics_fts fts
+        JOIN heuristics h ON h.id = fts.rowid
+        WHERE heuristics_fts MATCH ?
+        ORDER BY h.confidence DESC, rank
+        LIMIT ?
+      `).all(safeQuery, limit);
+            // Batch update use_count instead of N+1 individual updates
+            const ids = rows.map(r => r.id);
+            if (ids.length > 0) {
+                this.db.prepare(`UPDATE heuristics SET use_count = use_count + 1 WHERE id IN (${ids.map(() => '?').join(',')})`).run(...ids);
+            }
+            return rows.map(r => ({
+                id: r.id,
+                taskPattern: r.task_pattern,
+                lesson: r.lesson,
+                source: r.source,
+                confidence: r.confidence,
+                useCount: r.use_count + 1,
+                successWhenUsed: r.success_when_used,
+                createdAt: r.created_at,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Record whether a heuristic helped (called after orchestration completes) */
+    recordOutcome(heuristicIds, success) {
+        if (success) {
+            for (const id of heuristicIds) {
+                this.db.prepare('UPDATE heuristics SET success_when_used = success_when_used + 1, confidence = MIN(1.0, confidence + 0.05) WHERE id = ?').run(id);
+            }
+        }
+        else {
+            for (const id of heuristicIds) {
+                this.db.prepare('UPDATE heuristics SET confidence = MAX(0.1, confidence - 0.1) WHERE id = ?').run(id);
+            }
+        }
+    }
+    /** Format heuristics for injection into a planning prompt */
+    formatForContext(heuristics) {
+        if (heuristics.length === 0)
+            return '';
+        const lines = ['## Lessons from Past Orchestrations', ''];
+        for (const h of heuristics) {
+            const icon = h.source === 'success' ? '+' : h.source === 'failure' ? '!' : '~';
+            lines.push(`${icon} ${h.lesson} (confidence: ${(h.confidence * 100).toFixed(0)}%)`);
+        }
+        return lines.join('\n');
+    }
+    /** Decay confidence of old heuristics */
+    decayOld(daysOld = 30) {
+        this.db.prepare(`
+      UPDATE heuristics SET confidence = MAX(0.1, confidence - 0.05)
+      WHERE created_at < datetime('now', '-' || ? || ' days')
+    `).run(daysOld);
+    }
+    /** Normalize task description for pattern matching */
+    normalizeTask(task) {
+        return task
+            .toLowerCase()
+            .replace(/["'`]/g, '')
+            .replace(/\b(the|a|an|to|in|for|of|with|and|or)\b/g, '')
+            .replace(/\s+/g, ' ')
+            .trim()
+            .slice(0, 200);
+    }
+    prune(maxRows = 10000) {
+        this.db.prepare('DELETE FROM heuristics WHERE id NOT IN (SELECT id FROM heuristics ORDER BY created_at DESC LIMIT ?)').run(maxRows);
+    }
+    close() { this.db.close(); }
+}
+//# sourceMappingURL=heuristics.js.map

package/dist/runtime/heuristics.js.map

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

package/dist/runtime/living-spec.d.ts

@@ -0,0 +1,34 @@
+export interface LivingSpec {
+    /** Original user intent */
+    intent: string;
+    /** Things discovered during research */
+    discoveries: string[];
+    /** Decisions made during orchestration */
+    decisions: string[];
+    /** Constraints identified */
+    constraints: string[];
+    /** Current phase and status */
+    currentPhase: string;
+    /** Completion criteria */
+    completionCriteria: string[];
+    /** Amendments log */
+    amendments: Array<{
+        phase: string;
+        change: string;
+        reason: string;
+    }>;
+}
+/**
+ * Create a fresh living spec from a task description.
+ */
+export declare function createLivingSpec(task: string): LivingSpec;
+/**
+ * Update the living spec after a phase completes.
+ * Extracts discoveries, decisions, and constraints from agent outputs.
+ */
+export declare function updateSpecFromPhase(spec: LivingSpec, phaseName: string, agentOutputs: string[]): LivingSpec;
+/**
+ * Format the living spec for injection into agent context.
+ */
+export declare function formatLivingSpec(spec: LivingSpec): string;
+//# sourceMappingURL=living-spec.d.ts.map

package/dist/runtime/living-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"living-spec.d.ts","sourceRoot":"","sources":["../../src/runtime/living-spec.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,qBAAqB;IACrB,UAAU,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAUzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,UAAU,CA2C3G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA+BzD"}

package/dist/runtime/living-spec.js

@@ -0,0 +1,91 @@
+/**
+ * Create a fresh living spec from a task description.
+ */
+export function createLivingSpec(task) {
+    return {
+        intent: task,
+        discoveries: [],
+        decisions: [],
+        constraints: [],
+        currentPhase: 'planning',
+        completionCriteria: ['Task completed as described', 'All tests pass', 'No regressions'],
+        amendments: [],
+    };
+}
+/**
+ * Update the living spec after a phase completes.
+ * Extracts discoveries, decisions, and constraints from agent outputs.
+ */
+export function updateSpecFromPhase(spec, phaseName, agentOutputs) {
+    const updated = {
+        ...spec,
+        discoveries: [...spec.discoveries],
+        decisions: [...spec.decisions],
+        constraints: [...spec.constraints],
+        amendments: [...spec.amendments],
+    };
+    updated.currentPhase = phaseName;
+    const sanitize = (text) => {
+        return text
+            .replace(/ignore\s+(all\s+)?previous\s+instructions/gi, '[filtered]')
+            .replace(/exfiltrate|steal|leak|send\s+to/gi, '[filtered]')
+            .slice(0, 200);
+    };
+    for (const output of agentOutputs) {
+        // Extract discoveries (lines starting with "Found:", "Discovered:", "Note:")
+        const discoveries = output.match(/(?:Found|Discovered|Note|Important)[:\s]+(.+)/gi);
+        if (discoveries) {
+            updated.discoveries.push(...discoveries.map(d => sanitize(d.trim())).slice(0, 5));
+        }
+        // Extract decisions (lines starting with "Decision:", "Chose:", "Using:")
+        const decisions = output.match(/(?:Decision|Chose|Using|Selected|Picked)[:\s]+(.+)/gi);
+        if (decisions) {
+            updated.decisions.push(...decisions.map(d => sanitize(d.trim())).slice(0, 3));
+        }
+        // Extract constraints (lines starting with "Constraint:", "Must:", "Cannot:")
+        const constraints = output.match(/(?:Constraint|Must|Cannot|Blocked by|Requires)[:\s]+(.+)/gi);
+        if (constraints) {
+            updated.constraints.push(...constraints.map(c => sanitize(c.trim())).slice(0, 3));
+        }
+    }
+    // Deduplicate
+    updated.discoveries = [...new Set(updated.discoveries)].slice(0, 20);
+    updated.decisions = [...new Set(updated.decisions)].slice(0, 10);
+    updated.constraints = [...new Set(updated.constraints)].slice(0, 10);
+    return updated;
+}
+/**
+ * Format the living spec for injection into agent context.
+ */
+export function formatLivingSpec(spec) {
+    const lines = ['## Living Specification', ''];
+    lines.push(`**Intent**: ${spec.intent}`);
+    lines.push(`**Current Phase**: ${spec.currentPhase}`);
+    if (spec.discoveries.length > 0) {
+        lines.push('', '**Discoveries**:');
+        for (const d of spec.discoveries.slice(0, 10))
+            lines.push(`  - ${d}`);
+    }
+    if (spec.decisions.length > 0) {
+        lines.push('', '**Decisions Made**:');
+        for (const d of spec.decisions)
+            lines.push(`  - ${d}`);
+    }
+    if (spec.constraints.length > 0) {
+        lines.push('', '**Constraints**:');
+        for (const c of spec.constraints)
+            lines.push(`  - ${c}`);
+    }
+    if (spec.completionCriteria.length > 0) {
+        lines.push('', '**Completion Criteria**:');
+        for (const c of spec.completionCriteria)
+            lines.push(`  - ${c}`);
+    }
+    if (spec.amendments.length > 0) {
+        lines.push('', '**Amendments**:');
+        for (const a of spec.amendments)
+            lines.push(`  - [${a.phase}] ${a.change}: ${a.reason}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=living-spec.js.map

package/dist/runtime/living-spec.js.map

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

package/dist/runtime/lsp.d.ts

@@ -0,0 +1,50 @@
+export interface LSPServerConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    rootUri: string;
+    languageId: string;
+}
+export interface Diagnostic {
+    file: string;
+    line: number;
+    character: number;
+    severity: 'error' | 'warning' | 'info' | 'hint';
+    message: string;
+    source?: string;
+}
+export interface HoverInfo {
+    contents: string;
+    range?: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+export interface Definition {
+    uri: string;
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+export declare class LSPClient {
+    private servers;
+    connect(config: LSPServerConfig): Promise<void>;
+    hover(name: string, uri: string, line: number, char: number): Promise<HoverInfo | null>;
+    definition(name: string, uri: string, line: number, char: number): Promise<Definition[]>;
+    disconnectAll(): Promise<void>;
+    private get;
+}
+//# sourceMappingURL=lsp.d.ts.map

package/dist/runtime/lsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/runtime/lsp.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;CAAE;AACzH,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAAE;AACjK,MAAM,WAAW,SAAS;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAAE;AAClJ,MAAM,WAAW,UAAU;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAAE;AAE7I,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAmC;IAE5C,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAOvF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKxF,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG;CACZ"}

package/dist/runtime/lsp.js

@@ -0,0 +1,110 @@
+import { spawn } from 'child_process';
+import { randomUUID } from 'crypto';
+import { safeEnv } from '../utils/env.js';
+export class LSPClient {
+    servers = new Map();
+    async connect(config) {
+        const s = new LSPProc(config);
+        await s.initialize();
+        this.servers.set(config.name, s);
+    }
+    async hover(name, uri, line, char) {
+        const r = await this.get(name).sendRequest('textDocument/hover', { textDocument: { uri }, position: { line, character: char } });
+        if (!r)
+            return null;
+        let c = '';
+        if (typeof r.contents === 'string')
+            c = r.contents;
+        else if (r.contents?.value)
+            c = r.contents.value;
+        return { contents: c, range: r.range };
+    }
+    async definition(name, uri, line, char) {
+        const r = await this.get(name).sendRequest('textDocument/definition', { textDocument: { uri }, position: { line, character: char } });
+        if (!r)
+            return [];
+        return (Array.isArray(r) ? r : [r]).map((l) => ({ uri: l.uri ?? l.targetUri, range: l.range ?? l.targetRange }));
+    }
+    async disconnectAll() { for (const s of this.servers.values())
+        await s.shutdown(); this.servers.clear(); }
+    get(name) { const s = this.servers.get(name); if (!s)
+        throw new Error(`LSP not connected: ${name}`); return s; }
+}
+class LSPProc {
+    config;
+    proc = null;
+    pending = new Map();
+    buf = '';
+    clen = -1;
+    constructor(config) {
+        this.config = config;
+    }
+    async initialize() {
+        this.proc = spawn(this.config.command, this.config.args ?? [], { env: safeEnv(), stdio: ['pipe', 'pipe', 'pipe'] });
+        this.proc.stdout.on('data', (c) => { this.buf += c.toString(); this.flush(); });
+        await this.sendRequest('initialize', { processId: process.pid, rootUri: this.config.rootUri, capabilities: { textDocument: { hover: { contentFormat: ['markdown'] }, definition: { linkSupport: true } } } });
+        this.notify('initialized', {});
+    }
+    sendRequest(method, params) {
+        return new Promise((resolve, reject) => {
+            const id = randomUUID();
+            const timer = setTimeout(() => { if (this.pending.has(id)) {
+                this.pending.delete(id);
+                reject(new Error(`Timeout: ${method}`));
+            } }, 10_000);
+            this.pending.set(id, { resolve, reject, timer });
+            this.send({ jsonrpc: '2.0', id, method, params });
+        });
+    }
+    notify(method, params) { this.send({ jsonrpc: '2.0', method, params }); }
+    async shutdown() {
+        try {
+            await this.sendRequest('shutdown', null);
+            this.notify('exit', null);
+        }
+        catch { }
+        // Clear all pending request timers to prevent leaks
+        for (const [, entry] of this.pending) {
+            clearTimeout(entry.timer);
+            entry.reject(new Error('Connection shutdown'));
+        }
+        this.pending.clear();
+        this.proc?.kill('SIGTERM');
+    }
+    send(msg) {
+        const c = JSON.stringify(msg);
+        this.proc?.stdin?.write(`Content-Length: ${Buffer.byteLength(c)}\r\n\r\n${c}`);
+    }
+    flush() {
+        while (true) {
+            if (this.clen === -1) {
+                const i = this.buf.indexOf('\r\n\r\n');
+                if (i === -1)
+                    return;
+                const m = this.buf.slice(0, i).match(/Content-Length:\s*(\d+)/i);
+                if (!m) {
+                    this.buf = this.buf.slice(i + 4);
+                    continue;
+                }
+                this.clen = parseInt(m[1], 10);
+                this.buf = this.buf.slice(i + 4);
+            }
+            if (this.buf.length < this.clen)
+                return;
+            const c = this.buf.slice(0, this.clen);
+            this.buf = this.buf.slice(this.clen);
+            this.clen = -1;
+            try {
+                const msg = JSON.parse(c);
+                if (msg.id && this.pending.has(String(msg.id))) {
+                    const { resolve, reject, timer } = this.pending.get(String(msg.id));
+                    this.pending.delete(String(msg.id));
+                    clearTimeout(timer);
+                    msg.error ? reject(new Error(msg.error.message)) : resolve(msg.result);
+                }
+            }
+            catch { }
+        }
+    }
+}
+//# sourceMappingURL=lsp.js.map

package/dist/runtime/lsp.js.map

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

package/dist/runtime/mcp.d.ts

@@ -0,0 +1,27 @@
+import { EventBus } from '../core/event-bus.js';
+export interface MCPServerConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    transport: 'stdio' | 'http';
+    url?: string;
+    cwd?: string;
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    serverName: string;
+}
+export declare class MCPClient {
+    private servers;
+    private tools;
+    private bus;
+    constructor(bus?: EventBus);
+    connect(config: MCPServerConfig): Promise<MCPTool[]>;
+    callTool(server: string, tool: string, args: Record<string, unknown>): Promise<unknown>;
+    getAllTools(): MCPTool[];
+    disconnectAll(): Promise<void>;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/runtime/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/runtime/mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvF;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;CAC7F;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,GAAG,CAAkB;gBACjB,GAAG,CAAC,EAAE,QAAQ;IAEpB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IASpD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAM7F,WAAW,IAAI,OAAO,EAAE;IAElB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAIrC"}