swarm-engine 1.0.0

package/dist/runtime/compaction.js

@@ -0,0 +1,36 @@
+import { estimateTokens } from '../utils/tokens.js';
+export const DEFAULT_COMPACTION = {
+    enabled: true,
+    maxContextTokens: 150_000,
+    targetTokens: 80_000,
+    preserveRecentTurns: 10,
+    strategy: 'summarize',
+};
+export class CompactionManager {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_COMPACTION, ...config };
+    }
+    needsCompaction(tokens) {
+        return this.config.enabled && tokens >= this.config.maxContextTokens;
+    }
+    generateCompactionInstruction() {
+        return `## Context Management\nYour context limit is ~${this.config.maxContextTokens} tokens. Summarize earlier findings when conversation gets long.`;
+    }
+    buildContextPrefix(phaseOutputs, maxTokens) {
+        const max = maxTokens ?? this.config.targetTokens;
+        const sections = [];
+        for (const [phase, outputs] of phaseOutputs) {
+            sections.push(`## Context from ${phase}:\n${outputs.join('\n\n')}`);
+        }
+        let combined = sections.join('\n\n');
+        if (estimateTokens(combined) > max) {
+            const targetChars = max * 4;
+            if (combined.length > targetChars) {
+                combined = `[Earlier context truncated]\n\n...${combined.slice(combined.length - targetChars)}`;
+            }
+        }
+        return combined;
+    }
+}
+//# sourceMappingURL=compaction.js.map

package/dist/runtime/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/runtime/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUpD,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD,OAAO,EAAE,IAAI;IACb,gBAAgB,EAAE,OAAO;IACzB,YAAY,EAAE,MAAM;IACpB,mBAAmB,EAAE,EAAE;IACvB,QAAQ,EAAE,WAAW;CACtB,CAAC;AASF,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAmB;IAEjC,YAAY,MAAkC;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAAC;IACrD,CAAC;IAED,eAAe,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;IACvE,CAAC;IAED,6BAA6B;QAC3B,OAAO,iDAAiD,IAAI,CAAC,MAAM,CAAC,gBAAgB,kEAAkE,CAAC;IACzJ,CAAC;IAED,kBAAkB,CAAC,YAAmC,EAAE,SAAkB;QACxE,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,mBAAmB,KAAK,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErC,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,GAAG,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,GAAG,GAAG,CAAC,CAAC;YAC5B,IAAI,QAAQ,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;gBAClC,QAAQ,GAAG,qCAAqC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;YAClG,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/runtime/compounder.d.ts

@@ -0,0 +1,66 @@
+import type { ExecutionTrace } from './traces.js';
+export declare const PROBLEM_CATEGORIES: readonly ["architecture", "debugging", "performance", "security", "testing", "refactoring", "integration", "deployment", "convention"];
+export type ProblemCategory = typeof PROBLEM_CATEGORIES[number];
+export interface SolutionDoc {
+    title: string;
+    category: ProblemCategory;
+    problem: string;
+    solution: string;
+    context: string;
+    keyFiles: string[];
+    pattern: string;
+    outcome: 'success' | 'partial' | 'failed';
+    tokens: number;
+    duration: number;
+    createdAt: string;
+    lastVerified?: string;
+    stale: boolean;
+}
+/**
+ * Knowledge Compounder — extracts, stores, and manages solution docs
+ * from orchestration traces. Each successful fix becomes a reusable
+ * lesson that makes future work easier.
+ */
+export declare class KnowledgeCompounder {
+    private docsDir;
+    constructor(docsDir?: string);
+    /**
+     * Extract a solution doc from a completed orchestration trace.
+     */
+    extractFromTrace(trace: ExecutionTrace, reflections: string[]): SolutionDoc | null;
+    /**
+     * Store a solution doc as a markdown file.
+     */
+    store(doc: SolutionDoc): string;
+    /**
+     * List all solution docs, optionally filtered by category.
+     */
+    list(category?: ProblemCategory): SolutionDoc[];
+    /**
+     * Find relevant solutions for a task.
+     */
+    findRelevant(task: string, limit?: number): SolutionDoc[];
+    /**
+     * Check for stale solutions (not verified in 30+ days).
+     */
+    findStale(daysThreshold?: number): SolutionDoc[];
+    /**
+     * Format solutions for injection into agent context.
+     */
+    formatForContext(docs: SolutionDoc[]): string;
+    /**
+     * Get stats about the knowledge base.
+     */
+    stats(): {
+        total: number;
+        byCategory: Record<string, number>;
+        staleCount: number;
+    };
+    private classifyCategory;
+    private generateTitle;
+    private extractSolution;
+    private extractKeyFiles;
+    private slugify;
+    private parseDoc;
+}
+//# sourceMappingURL=compounder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compounder.d.ts","sourceRoot":"","sources":["../../src/runtime/compounder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,kBAAkB,wIAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,CAAC,EAAE,MAAM;IAW5B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,IAAI;IAwBlF;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM;IA+C/B;;OAEG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,WAAW,EAAE;IAqB/C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,WAAW,EAAE;IAkB5D;;OAEG;IACH,SAAS,CAAC,aAAa,GAAE,MAAW,GAAG,WAAW,EAAE;IAWpD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM;IAe7C;;OAEG;IACH,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAelF,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,QAAQ;CAkCjB"}

package/dist/runtime/compounder.js

@@ -0,0 +1,276 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { redactSecrets } from '../utils/redact.js';
+// Problem categories (from CE, adapted for coding orchestration)
+export const PROBLEM_CATEGORIES = [
+    'architecture', // Design decisions, system structure
+    'debugging', // Bug diagnosis and resolution
+    'performance', // Performance optimization techniques
+    'security', // Security fixes and patterns
+    'testing', // Test strategies and patterns
+    'refactoring', // Code improvement patterns
+    'integration', // Cross-system integration patterns
+    'deployment', // Deployment and infrastructure
+    'convention', // Project-specific conventions
+];
+/**
+ * Knowledge Compounder — extracts, stores, and manages solution docs
+ * from orchestration traces. Each successful fix becomes a reusable
+ * lesson that makes future work easier.
+ */
+export class KnowledgeCompounder {
+    docsDir;
+    constructor(docsDir) {
+        this.docsDir = docsDir ?? join(homedir(), '.swarm', 'solutions');
+        if (!existsSync(this.docsDir)) {
+            mkdirSync(this.docsDir, { recursive: true });
+        }
+        for (const cat of PROBLEM_CATEGORIES) {
+            const catDir = join(this.docsDir, cat);
+            if (!existsSync(catDir))
+                mkdirSync(catDir, { recursive: true });
+        }
+    }
+    /**
+     * Extract a solution doc from a completed orchestration trace.
+     */
+    extractFromTrace(trace, reflections) {
+        if (trace.status !== 'completed')
+            return null;
+        const category = this.classifyCategory(trace.task, reflections);
+        const keyFiles = this.extractKeyFiles(reflections);
+        const doc = {
+            title: this.generateTitle(trace.task),
+            category,
+            problem: redactSecrets(trace.task),
+            solution: this.extractSolution(trace, reflections),
+            context: `Pattern: ${trace.pattern}, ${trace.agentCount} agents, ${trace.phaseCount} phases`,
+            keyFiles,
+            pattern: trace.pattern,
+            outcome: 'success',
+            tokens: trace.totalTokens,
+            duration: trace.durationMs,
+            createdAt: new Date().toISOString(),
+            stale: false,
+        };
+        return doc;
+    }
+    /**
+     * Store a solution doc as a markdown file.
+     */
+    store(doc) {
+        if (!PROBLEM_CATEGORIES.includes(doc.category)) {
+            doc = { ...doc, category: 'convention' };
+        }
+        const safeKeyFiles = doc.keyFiles.map(f => redactSecrets(f));
+        doc = { ...doc, problem: redactSecrets(doc.problem), solution: redactSecrets(doc.solution), keyFiles: safeKeyFiles };
+        const slug = this.slugify(doc.title);
+        const filename = `${new Date().toISOString().split('T')[0]}-${slug}.md`;
+        const filePath = join(this.docsDir, doc.category, filename);
+        const frontmatter = [
+            '---',
+            `title: "${doc.title}"`,
+            `category: ${doc.category}`,
+            `pattern: ${doc.pattern}`,
+            `outcome: ${doc.outcome}`,
+            `tokens: ${doc.tokens}`,
+            `duration: ${doc.duration}`,
+            `created: ${doc.createdAt}`,
+        ];
+        if (doc.lastVerified)
+            frontmatter.push(`verified: ${doc.lastVerified}`);
+        frontmatter.push(`stale: ${doc.stale}`);
+        frontmatter.push('---');
+        const body = [
+            '',
+            `# ${doc.title}`,
+            '',
+            '## Problem',
+            doc.problem,
+            '',
+            '## Solution',
+            doc.solution,
+            '',
+            '## Context',
+            doc.context,
+            '',
+            '## Key Files',
+            ...doc.keyFiles.map(f => `- ${f}`),
+            '',
+        ];
+        const content = [...frontmatter, ...body].join('\n');
+        writeFileSync(filePath, content);
+        return filePath;
+    }
+    /**
+     * List all solution docs, optionally filtered by category.
+     */
+    list(category) {
+        const docs = [];
+        const categories = category ? [category] : [...PROBLEM_CATEGORIES];
+        for (const cat of categories) {
+            const catDir = join(this.docsDir, cat);
+            if (!existsSync(catDir))
+                continue;
+            const files = readdirSync(catDir).filter(f => f.endsWith('.md'));
+            for (const file of files) {
+                try {
+                    const content = readFileSync(join(catDir, file), 'utf-8');
+                    const doc = this.parseDoc(content, cat);
+                    if (doc)
+                        docs.push(doc);
+                }
+                catch { /* skip malformed docs */ }
+            }
+        }
+        return docs.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    /**
+     * Find relevant solutions for a task.
+     */
+    findRelevant(task, limit = 5) {
+        const keywords = task.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+        const all = this.list();
+        return all
+            .map(doc => ({
+            doc,
+            score: keywords.reduce((s, kw) => s + (doc.problem.toLowerCase().includes(kw) ? 2 : 0) +
+                (doc.solution.toLowerCase().includes(kw) ? 1 : 0) +
+                (doc.title.toLowerCase().includes(kw) ? 3 : 0), 0),
+        }))
+            .filter(({ score }) => score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map(({ doc }) => doc);
+    }
+    /**
+     * Check for stale solutions (not verified in 30+ days).
+     */
+    findStale(daysThreshold = 30) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - daysThreshold);
+        const cutoffStr = cutoff.toISOString();
+        return this.list().filter(doc => {
+            const lastCheck = doc.lastVerified ?? doc.createdAt;
+            return lastCheck < cutoffStr;
+        });
+    }
+    /**
+     * Format solutions for injection into agent context.
+     */
+    formatForContext(docs) {
+        if (docs.length === 0)
+            return '';
+        const lines = ['## Relevant Past Solutions', ''];
+        for (const doc of docs) {
+            lines.push(`### ${doc.title} (${doc.category})`);
+            lines.push(`Problem: ${doc.problem.slice(0, 100)}`);
+            lines.push(`Solution: ${doc.solution.slice(0, 200)}`);
+            lines.push(`Pattern: ${doc.pattern} | Outcome: ${doc.outcome}`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get stats about the knowledge base.
+     */
+    stats() {
+        const all = this.list();
+        const byCategory = {};
+        for (const doc of all) {
+            byCategory[doc.category] = (byCategory[doc.category] ?? 0) + 1;
+        }
+        return {
+            total: all.length,
+            byCategory,
+            staleCount: this.findStale().length,
+        };
+    }
+    // ─── Helpers ────────────────────────────────────────────────
+    classifyCategory(task, reflections) {
+        const text = `${task} ${reflections.join(' ')}`.toLowerCase();
+        if (text.includes('security') || text.includes('vulnerability') || text.includes('auth'))
+            return 'security';
+        if (text.includes('performance') || text.includes('slow') || text.includes('optimize'))
+            return 'performance';
+        if (text.includes('test') || text.includes('coverage') || text.includes('spec'))
+            return 'testing';
+        if (text.includes('refactor') || text.includes('clean') || text.includes('simplif'))
+            return 'refactoring';
+        if (text.includes('bug') || text.includes('fix') || text.includes('error') || text.includes('debug'))
+            return 'debugging';
+        if (text.includes('deploy') || text.includes('ci') || text.includes('pipeline'))
+            return 'deployment';
+        if (text.includes('architect') || text.includes('design') || text.includes('structure'))
+            return 'architecture';
+        if (text.includes('integrat') || text.includes('api') || text.includes('connect'))
+            return 'integration';
+        return 'convention';
+    }
+    generateTitle(task) {
+        const firstSentence = task.split(/[.!?\n]/)[0]?.trim() ?? task;
+        return firstSentence.slice(0, 60);
+    }
+    extractSolution(trace, reflections) {
+        const parts = [];
+        for (const phase of trace.phases) {
+            if (phase.status === 'completed') {
+                parts.push(`${phase.name}: ${phase.agentCount} agent(s), ${phase.tokens} tokens, ${phase.confidence} confidence`);
+            }
+        }
+        if (reflections.length > 0) {
+            parts.push('');
+            parts.push('Key learnings:');
+            for (const r of reflections.slice(0, 3)) {
+                parts.push(r.slice(0, 200));
+            }
+        }
+        return parts.join('\n');
+    }
+    extractKeyFiles(reflections) {
+        const files = new Set();
+        const text = reflections.join('\n');
+        const matches = text.match(/[\w./]+\.(?:ts|js|py|go|rs|java|rb|md|json|yml|yaml)/g);
+        if (matches) {
+            for (const m of matches)
+                files.add(m);
+        }
+        return [...files].slice(0, 10);
+    }
+    slugify(text) {
+        return text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 50);
+    }
+    parseDoc(content, category) {
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!fmMatch)
+            return null;
+        const get = (key) => {
+            const match = fmMatch[1].match(new RegExp(`^${key}:\\s*"?(.+?)"?$`, 'm'));
+            return match?.[1] ?? '';
+        };
+        const body = content.match(/\n---\n\n([\s\S]*)/)?.[1] ?? '';
+        const problemMatch = body.match(/## Problem\n([\s\S]*?)(?=\n## |$)/);
+        const solutionMatch = body.match(/## Solution\n([\s\S]*?)(?=\n## |$)/);
+        const keyFilesMatch = body.match(/## Key Files\n([\s\S]*?)(?=\n## |$)/);
+        const keyFiles = keyFilesMatch
+            ? keyFilesMatch[1].trim().split('\n').map(l => l.replace(/^- /, '').trim()).filter(Boolean)
+            : [];
+        return {
+            title: get('title'),
+            category,
+            problem: problemMatch?.[1]?.trim() ?? '',
+            solution: solutionMatch?.[1]?.trim() ?? '',
+            context: '',
+            keyFiles,
+            pattern: get('pattern'),
+            outcome: get('outcome') || 'success',
+            tokens: parseInt(get('tokens')) || 0,
+            duration: parseInt(get('duration')) || 0,
+            createdAt: get('created') || new Date().toISOString(),
+            lastVerified: get('verified') || undefined,
+            stale: get('stale') === 'true',
+        };
+    }
+}
+//# sourceMappingURL=compounder.js.map

package/dist/runtime/compounder.js.map

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

package/dist/runtime/cost-model.d.ts

@@ -0,0 +1,24 @@
+import { ExecutionPlan } from '../core/types.js';
+import { StatsCollector } from './stats.js';
+export interface PlanCost {
+    totalTokens: number;
+    costUsd: number;
+    estimatedDurationMs: number;
+    qualityScore: number;
+}
+export declare class CostModel {
+    private stats;
+    constructor(stats?: StatsCollector);
+    /** Estimate cost of a full execution plan */
+    estimate(plan: ExecutionPlan): PlanCost;
+    /** Score a plan for ranking (lower is better, like query cost) */
+    score(plan: ExecutionPlan, constraints?: {
+        maxCostUsd?: number;
+        maxDurationMs?: number;
+        minQuality?: number;
+    }): number;
+    private estimateAgentTokens;
+    private estimateAgentCost;
+    private estimateAgentDuration;
+}
+//# sourceMappingURL=cost-model.d.ts.map

package/dist/runtime/cost-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-model.d.ts","sourceRoot":"","sources":["../../src/runtime/cost-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA8B,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAoCD,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAwB;gBAEzB,KAAK,CAAC,EAAE,cAAc;IAIlC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ;IAwCvC,kEAAkE;IAClE,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAmBtH,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,qBAAqB;CAY9B"}

package/dist/runtime/cost-model.js

@@ -0,0 +1,120 @@
+// Known model pricing (per million tokens, approximate)
+const MODEL_PRICING = {
+    opus: { input: 15.0, output: 75.0 },
+    sonnet: { input: 3.0, output: 15.0 },
+    haiku: { input: 0.25, output: 1.25 },
+};
+// Quality multipliers by model tier (relative to opus = 1.0)
+const MODEL_QUALITY = {
+    opus: 1.0,
+    sonnet: 0.85,
+    haiku: 0.65,
+};
+// Default token estimates when no stats available (per agent type)
+const DEFAULT_TOKENS = {
+    researcher: 5000,
+    implementer: 15000,
+    reviewer: 8000,
+    tester: 10000,
+    debugger: 12000,
+    planner: 6000,
+    judge: 5000,
+    refactorer: 12000,
+    integrator: 8000,
+    'devils-advocate': 6000,
+    grounding: 4000,
+    sentinel: 3000,
+    guardian: 4000,
+    librarian: 3000,
+    documenter: 5000,
+    orchestrator: 8000,
+};
+export class CostModel {
+    stats;
+    constructor(stats) {
+        this.stats = stats ?? null;
+    }
+    /** Estimate cost of a full execution plan */
+    estimate(plan) {
+        let totalTokens = 0;
+        let costUsd = 0;
+        let totalSequentialDuration = 0;
+        let qualitySum = 0;
+        let agentCount = 0;
+        for (const phase of plan.phases) {
+            let phaseDuration = 0;
+            let phaseMaxDuration = 0;
+            for (const agent of phase.agents) {
+                const tokens = this.estimateAgentTokens(agent);
+                const cost = this.estimateAgentCost(agent, tokens);
+                const duration = this.estimateAgentDuration(agent, tokens);
+                const quality = MODEL_QUALITY[agent.model] ?? 0.8;
+                totalTokens += tokens;
+                costUsd += cost;
+                qualitySum += quality;
+                agentCount++;
+                if (phase.parallel) {
+                    phaseMaxDuration = Math.max(phaseMaxDuration, duration);
+                }
+                else {
+                    phaseDuration += duration;
+                }
+            }
+            totalSequentialDuration += phase.parallel ? phaseMaxDuration : phaseDuration;
+        }
+        return {
+            totalTokens,
+            costUsd: Math.round(costUsd * 10000) / 10000,
+            estimatedDurationMs: totalSequentialDuration,
+            qualityScore: agentCount > 0 ? Math.round((qualitySum / agentCount) * 100) / 100 : 0,
+        };
+    }
+    /** Score a plan for ranking (lower is better, like query cost) */
+    score(plan, constraints) {
+        const est = this.estimate(plan);
+        // Penalty for violating constraints
+        let penalty = 0;
+        if (constraints?.maxCostUsd && est.costUsd > constraints.maxCostUsd) {
+            penalty += (est.costUsd - constraints.maxCostUsd) * 100;
+        }
+        if (constraints?.maxDurationMs && est.estimatedDurationMs > constraints.maxDurationMs) {
+            penalty += ((est.estimatedDurationMs - constraints.maxDurationMs) / 1000) * 10;
+        }
+        if (constraints?.minQuality && est.qualityScore < constraints.minQuality) {
+            penalty += (constraints.minQuality - est.qualityScore) * 50;
+        }
+        // Composite score: cost + time + quality inversion + penalties
+        return est.costUsd + (est.estimatedDurationMs / 60000) + (1 - est.qualityScore) * 2 + penalty;
+    }
+    estimateAgentTokens(agent) {
+        // Try historical stats first
+        if (this.stats) {
+            const profile = this.stats.getAgentProfile(agent.type, agent.model);
+            if (profile && profile.sampleCount >= 3) {
+                return profile.p50Tokens;
+            }
+        }
+        // Fall back to defaults
+        return DEFAULT_TOKENS[agent.type] ?? 8000;
+    }
+    estimateAgentCost(agent, tokens) {
+        const pricing = MODEL_PRICING[agent.model] ?? MODEL_PRICING.sonnet;
+        // Assume 60% input, 40% output split
+        const inputTokens = tokens * 0.6;
+        const outputTokens = tokens * 0.4;
+        return (inputTokens * pricing.input + outputTokens * pricing.output) / 1_000_000;
+    }
+    estimateAgentDuration(agent, tokens) {
+        // Try historical stats
+        if (this.stats) {
+            const profile = this.stats.getAgentProfile(agent.type, agent.model);
+            if (profile && profile.sampleCount >= 3) {
+                return profile.avgDurationMs;
+            }
+        }
+        // Rough estimate: 1 token ≈ 30ms for opus, 15ms for sonnet, 5ms for haiku
+        const msPerToken = { opus: 30, sonnet: 15, haiku: 5 };
+        return tokens * (msPerToken[agent.model] ?? 20);
+    }
+}
+//# sourceMappingURL=cost-model.js.map

package/dist/runtime/cost-model.js.map

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

package/dist/runtime/distiller.d.ts

@@ -0,0 +1,21 @@
+export interface DistillerConfig {
+    enabled: boolean;
+    maxInputTokens: number;
+    targetTokens: number;
+    model: string;
+}
+export declare const DEFAULT_DISTILLER: DistillerConfig;
+export declare class ContextDistiller {
+    private config;
+    constructor(config?: Partial<DistillerConfig>);
+    /**
+     * Distill phase outputs into a concise summary.
+     * Returns the original if short enough, or a compressed version.
+     */
+    distill(phaseOutputs: string[], phaseName: string): Promise<string>;
+    /**
+     * Check if distillation would help for this content.
+     */
+    shouldDistill(content: string): boolean;
+}
+//# sourceMappingURL=distiller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"distiller.d.ts","sourceRoot":"","sources":["../../src/runtime/distiller.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,iBAAiB,EAAE,eAK/B,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAI7C;;;OAGG;IACG,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+CzE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGxC"}

package/dist/runtime/distiller.js

@@ -0,0 +1,70 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { estimateTokens } from '../utils/tokens.js';
+import { redactSecrets } from '../utils/redact.js';
+export const DEFAULT_DISTILLER = {
+    enabled: true,
+    maxInputTokens: 4000, // ~16K chars
+    targetTokens: 1000, // ~4K chars
+    model: 'haiku',
+};
+export class ContextDistiller {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_DISTILLER, ...config };
+    }
+    /**
+     * Distill phase outputs into a concise summary.
+     * Returns the original if short enough, or a compressed version.
+     */
+    async distill(phaseOutputs, phaseName) {
+        if (!this.config.enabled)
+            return phaseOutputs.join('\n\n');
+        const combined = redactSecrets(phaseOutputs.join('\n\n'));
+        const inputTokens = estimateTokens(combined);
+        // Don't distill if already short
+        if (inputTokens <= this.config.maxInputTokens) {
+            return combined;
+        }
+        // Use claude CLI for distillation (cheapest model, async to avoid blocking)
+        try {
+            const prompt = `Summarize the following agent output into a concise technical brief. Preserve:
+- File paths and line numbers
+- Key decisions and their rationale
+- Code patterns found
+- Errors and blockers
+- Action items
+
+Remove verbose tool output, repeated content, and intermediate exploration steps.
+
+Target: ${this.config.targetTokens} tokens maximum.
+
+## Agent Output from ${phaseName}:
+
+${combined}`;
+            const execFileAsync = promisify(execFile);
+            const { stdout } = await execFileAsync('claude', [
+                '-p', prompt,
+                '--model', 'claude-haiku-4-5-20251001',
+                '--max-tokens', String(this.config.targetTokens * 4),
+                '--no-input',
+            ], { encoding: 'utf-8', timeout: 30000 });
+            return `[Distilled from ${phaseName} — ${inputTokens} tokens → ~${estimateTokens(stdout)} tokens]\n\n${stdout.trim()}`;
+        }
+        catch {
+            // Fallback: simple truncation if claude CLI fails
+            const targetChars = this.config.targetTokens * 4;
+            if (combined.length > targetChars) {
+                return `[Truncated from ${phaseName}]\n\n${combined.slice(0, targetChars)}...`;
+            }
+            return combined;
+        }
+    }
+    /**
+     * Check if distillation would help for this content.
+     */
+    shouldDistill(content) {
+        return this.config.enabled && estimateTokens(content) > this.config.maxInputTokens;
+    }
+}
+//# sourceMappingURL=distiller.js.map