swarm-engine 1.0.0

package/dist/runtime/panes.js.map

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

package/dist/runtime/plan-search.d.ts

@@ -0,0 +1,41 @@
+import { ExecutionPlan } from '../core/types.js';
+import { CostModel, PlanCost } from './cost-model.js';
+import { TraceStore } from './traces.js';
+export interface PlanCandidate {
+    plan: ExecutionPlan;
+    cost: PlanCost;
+    score: number;
+    source: string;
+}
+export interface SearchConfig {
+    maxCandidates: number;
+    constraints?: {
+        maxCostUsd?: number;
+        maxDurationMs?: number;
+        minQuality?: number;
+    };
+}
+/**
+ * Search over candidate execution plans and return ranked alternatives.
+ * Inspired by MCTS but simplified for orchestration-level decisions:
+ * - Enumerate candidates (pattern × model tier permutations)
+ * - Score each with CostModel + trace-informed adjustments
+ * - Return ranked list
+ */
+export declare class PlanSearcher {
+    private costModel;
+    private traceStore;
+    constructor(costModel: CostModel, traceStore?: TraceStore);
+    /**
+     * Search for the best plan among candidates.
+     */
+    search(basePlan: ExecutionPlan, config?: SearchConfig): PlanCandidate[];
+    /**
+     * Get the best plan from search results.
+     */
+    best(basePlan: ExecutionPlan, config?: SearchConfig): PlanCandidate;
+    private withModelOverride;
+    private withPhaseModels;
+    private traceInformedPlan;
+}
+//# sourceMappingURL=plan-search.d.ts.map

package/dist/runtime/plan-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-search.d.ts","sourceRoot":"","sources":["../../src/runtime/plan-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAa,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAoB;gBAE1B,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,UAAU;IAKzD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAE,YAAmC,GAAG,aAAa,EAAE;IAmE7F;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa;IAOnE,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iBAAiB;CA0B1B"}

package/dist/runtime/plan-search.js

@@ -0,0 +1,140 @@
+import { rewritePlan } from './rewriter.js';
+/**
+ * Search over candidate execution plans and return ranked alternatives.
+ * Inspired by MCTS but simplified for orchestration-level decisions:
+ * - Enumerate candidates (pattern × model tier permutations)
+ * - Score each with CostModel + trace-informed adjustments
+ * - Return ranked list
+ */
+export class PlanSearcher {
+    costModel;
+    traceStore;
+    constructor(costModel, traceStore) {
+        this.costModel = costModel;
+        this.traceStore = traceStore ?? null;
+    }
+    /**
+     * Search for the best plan among candidates.
+     */
+    search(basePlan, config = { maxCandidates: 5 }) {
+        const candidates = [];
+        // Candidate 1: the base plan as-is
+        const baseCost = this.costModel.estimate(basePlan);
+        candidates.push({
+            plan: basePlan,
+            cost: baseCost,
+            score: this.costModel.score(basePlan, config.constraints),
+            source: 'base',
+        });
+        // Candidate 2: all-sonnet variant (cheaper)
+        const sonnetPlan = this.withModelOverride(basePlan, 'sonnet');
+        if (sonnetPlan) {
+            const { plan: rewritten } = rewritePlan(sonnetPlan);
+            candidates.push({
+                plan: rewritten,
+                cost: this.costModel.estimate(rewritten),
+                score: this.costModel.score(rewritten, config.constraints),
+                source: 'all-sonnet',
+            });
+        }
+        // Candidate 3: all-opus variant (highest quality)
+        const opusPlan = this.withModelOverride(basePlan, 'opus');
+        if (opusPlan) {
+            const { plan: rewritten } = rewritePlan(opusPlan);
+            candidates.push({
+                plan: rewritten,
+                cost: this.costModel.estimate(rewritten),
+                score: this.costModel.score(rewritten, config.constraints),
+                source: 'all-opus',
+            });
+        }
+        // Candidate 4: research-sonnet + implement-opus (hybrid cost/quality)
+        const hybridPlan = this.withPhaseModels(basePlan, {
+            research: 'sonnet',
+            implement: 'opus',
+            review: 'sonnet',
+        });
+        if (hybridPlan) {
+            const { plan: rewritten } = rewritePlan(hybridPlan);
+            candidates.push({
+                plan: rewritten,
+                cost: this.costModel.estimate(rewritten),
+                score: this.costModel.score(rewritten, config.constraints),
+                source: 'hybrid-model-mix',
+            });
+        }
+        // Candidate 5: trace-informed (use the pattern from the most successful similar trace)
+        if (this.traceStore) {
+            const tracePlan = this.traceInformedPlan(basePlan);
+            if (tracePlan) {
+                candidates.push(tracePlan);
+            }
+        }
+        // Sort by score (lower is better) and deduplicate
+        candidates.sort((a, b) => a.score - b.score);
+        // Limit candidates
+        return candidates.slice(0, config.maxCandidates);
+    }
+    /**
+     * Get the best plan from search results.
+     */
+    best(basePlan, config) {
+        const candidates = this.search(basePlan, config);
+        return candidates[0]; // search always returns at least the base plan
+    }
+    // ─── Candidate Generators ─────────────────────────────────
+    withModelOverride(plan, model) {
+        const clone = structuredClone(plan);
+        let changed = false;
+        for (const phase of clone.phases) {
+            for (const agent of phase.agents) {
+                if (agent.model !== model) {
+                    agent.model = model;
+                    changed = true;
+                }
+            }
+        }
+        return changed ? clone : null;
+    }
+    withPhaseModels(plan, phaseModels) {
+        const clone = structuredClone(plan);
+        let changed = false;
+        for (const phase of clone.phases) {
+            const targetModel = Object.entries(phaseModels).find(([key]) => phase.name.includes(key))?.[1];
+            if (targetModel) {
+                for (const agent of phase.agents) {
+                    if (agent.model !== targetModel) {
+                        agent.model = targetModel;
+                        changed = true;
+                    }
+                }
+            }
+        }
+        return changed ? clone : null;
+    }
+    traceInformedPlan(basePlan) {
+        if (!this.traceStore)
+            return null;
+        const similar = this.traceStore.findSimilar(basePlan.task, 5);
+        const successful = similar.filter(t => t.status === 'completed');
+        if (successful.length === 0)
+            return null;
+        // Find the most efficient successful trace
+        const best = successful.sort((a, b) => {
+            // Score by efficiency: lower tokens + shorter duration = better
+            return (a.totalTokens + a.durationMs / 100) - (b.totalTokens + b.durationMs / 100);
+        })[0];
+        // If the best trace used a different pattern, that's interesting but we can't change pattern here
+        // Instead, copy model assignments from the trace's phases to our plan
+        const clone = structuredClone(basePlan);
+        // We don't have model info in traces currently, so just note this as a trace-backed plan
+        const cost = this.costModel.estimate(clone);
+        return {
+            plan: clone,
+            cost,
+            score: this.costModel.score(clone) * 0.9, // 10% bonus for trace-informed plans
+            source: `trace-informed (${best.pattern}, ${best.totalTokens} tokens)`,
+        };
+    }
+}
+//# sourceMappingURL=plan-search.js.map

package/dist/runtime/plan-search.js.map

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

package/dist/runtime/plugins.d.ts

@@ -0,0 +1,59 @@
+import { EventBus } from '../core/event-bus.js';
+export interface PluginTool {
+    name: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<unknown>;
+}
+export interface PluginHooks {
+    beforeToolUse?: (context: {
+        tool: string;
+        agentName: string;
+    }) => Promise<void>;
+    afterToolUse?: (context: {
+        tool: string;
+        agentName: string;
+        result: unknown;
+    }) => Promise<void>;
+    onPhaseComplete?: (context: {
+        phaseName: string;
+        status: string;
+        agentCount: number;
+    }) => Promise<void>;
+    onOrchestrationComplete?: (context: {
+        pattern: string;
+        status: string;
+        durationMs: number;
+    }) => Promise<void>;
+}
+export interface SwarmPlugin {
+    name: string;
+    version?: string;
+    description?: string;
+    tools?: PluginTool[];
+    hooks?: PluginHooks;
+    onLoad?(): Promise<void>;
+    onUnload?(): Promise<void>;
+}
+export interface PluginManifest {
+    name: string;
+    version: string;
+    description?: string;
+    entry: string;
+}
+export declare class PluginLoader {
+    private plugins;
+    private tools;
+    private bus;
+    constructor(bus?: EventBus);
+    loadAll(cwd?: string): Promise<number>;
+    loadDir(dir: string): Promise<number>;
+    private reg;
+    getAllTools(): PluginTool[];
+    listPlugins(): SwarmPlugin[];
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    /** Wire plugin lifecycle hooks to the event bus */
+    wireHooks(bus: EventBus): void;
+    unloadAll(): Promise<void>;
+}
+//# sourceMappingURL=plugins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/runtime/plugins.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAAE;AAEnK,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxG,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/G;AAED,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAAE;AACvL,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AAEvG,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,GAAG,CAAkB;gBACjB,GAAG,CAAC,EAAE,QAAQ;IAEpB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAuB7B,GAAG;IAOjB,WAAW,IAAI,UAAU,EAAE;IAC3B,WAAW,IAAI,WAAW,EAAE;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7E,mDAAmD;IACnD,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IA4CxB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}

package/dist/runtime/plugins.js

@@ -0,0 +1,121 @@
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join, extname, resolve } from 'path';
+import { pathToFileURL } from 'url';
+export class PluginLoader {
+    plugins = new Map();
+    tools = new Map();
+    bus;
+    constructor(bus) { this.bus = bus ?? null; }
+    async loadAll(cwd) {
+        let n = 0;
+        n += await this.loadDir(join(cwd ?? process.cwd(), '.swarm', 'plugins'));
+        n += await this.loadDir(join(process.env.HOME ?? '', '.swarm', 'plugins'));
+        return n;
+    }
+    async loadDir(dir) {
+        if (!existsSync(dir))
+            return 0;
+        let n = 0;
+        for (const e of readdirSync(dir, { withFileTypes: true })) {
+            try {
+                if (e.isFile() && ['.ts', '.js'].includes(extname(e.name))) {
+                    const mod = await import(pathToFileURL(join(dir, e.name)).href);
+                    await this.reg(mod.default ?? mod);
+                    n++;
+                }
+                else if (e.isDirectory() && existsSync(join(dir, e.name, 'plugin.json'))) {
+                    const m = JSON.parse(readFileSync(join(dir, e.name, 'plugin.json'), 'utf-8'));
+                    const entryPath = resolve(join(dir, e.name, m.entry));
+                    const pluginRoot = resolve(join(dir, e.name));
+                    if (!entryPath.startsWith(pluginRoot + '/') && entryPath !== pluginRoot) {
+                        throw new Error(`Plugin entry path escapes plugin directory: ${m.entry}`);
+                    }
+                    const mod = await import(pathToFileURL(entryPath).href);
+                    const p = mod.default ?? mod;
+                    p.name = m.name;
+                    p.version = m.version;
+                    await this.reg(p);
+                    n++;
+                }
+            }
+            catch (err) {
+                this.bus?.emit('system:warning', { message: `Plugin failed: ${e.name}` }, 'plugins');
+            }
+        }
+        return n;
+    }
+    async reg(plugin) {
+        if (!plugin.name)
+            throw new Error('Plugin needs name');
+        if (plugin.onLoad)
+            await plugin.onLoad();
+        if (plugin.tools)
+            for (const t of plugin.tools)
+                this.tools.set(`${plugin.name}:${t.name}`, t);
+        this.plugins.set(plugin.name, plugin);
+    }
+    getAllTools() { return [...this.tools.values()]; }
+    listPlugins() { return [...this.plugins.values()]; }
+    async callTool(name, args) {
+        const t = this.tools.get(name);
+        if (!t)
+            throw new Error(`Tool not found: ${name}`);
+        return t.execute(args);
+    }
+    /** Wire plugin lifecycle hooks to the event bus */
+    wireHooks(bus) {
+        for (const plugin of this.plugins.values()) {
+            if (!plugin.hooks)
+                continue;
+            if (plugin.hooks.beforeToolUse) {
+                const hook = plugin.hooks.beforeToolUse;
+                bus.on('agent:tool-use', async (event) => {
+                    const data = event.data;
+                    try {
+                        await hook({ tool: String(data.tool ?? ''), agentName: String(data.agentType ?? '') });
+                    }
+                    catch { /* Don't crash on hook failure */ }
+                });
+            }
+            if (plugin.hooks.onPhaseComplete) {
+                const hook = plugin.hooks.onPhaseComplete;
+                bus.on('orchestration:phase-complete', async (event) => {
+                    const data = event.data;
+                    try {
+                        await hook({
+                            phaseName: String(data.phase ?? ''),
+                            status: String(data.status ?? ''),
+                            agentCount: Number(data.agentCount ?? 0),
+                        });
+                    }
+                    catch { /* Don't crash on hook failure */ }
+                });
+            }
+            if (plugin.hooks.onOrchestrationComplete) {
+                const hook = plugin.hooks.onOrchestrationComplete;
+                bus.on('orchestration:complete', async (event) => {
+                    const data = event.data;
+                    try {
+                        await hook({
+                            pattern: String(data.pattern ?? ''),
+                            status: String(data.status ?? ''),
+                            durationMs: Number(data.durationMs ?? 0),
+                        });
+                    }
+                    catch { /* Don't crash on hook failure */ }
+                });
+            }
+        }
+    }
+    async unloadAll() {
+        for (const p of this.plugins.values())
+            if (p.onUnload)
+                try {
+                    await p.onUnload();
+                }
+                catch { }
+        this.plugins.clear();
+        this.tools.clear();
+    }
+}
+//# sourceMappingURL=plugins.js.map

package/dist/runtime/plugins.js.map

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

package/dist/runtime/reflexion.d.ts

@@ -0,0 +1,22 @@
+import { PhaseInstance } from '../core/types.js';
+export interface Reflection {
+    phaseName: string;
+    summary: string;
+    whatWorked: string[];
+    whatFailed: string[];
+    improvements: string[];
+    confidence: 'high' | 'medium' | 'low';
+}
+export declare class ReflectionEngine {
+    /**
+     * Generate a reflection from phase results.
+     * This is a deterministic analysis — no LLM calls.
+     * The reflection gets stored in memory and injected into subsequent phases.
+     */
+    reflect(phase: PhaseInstance): Reflection;
+    /**
+     * Format a reflection for injection into subsequent agent context.
+     */
+    format(reflection: Reflection): string;
+}
+//# sourceMappingURL=reflexion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reflexion.d.ts","sourceRoot":"","sources":["../../src/runtime/reflexion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,qBAAa,gBAAgB;IAC3B;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU;IAyDzC;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;CAuBvC"}

package/dist/runtime/reflexion.js

@@ -0,0 +1,85 @@
+export class ReflectionEngine {
+    /**
+     * Generate a reflection from phase results.
+     * This is a deterministic analysis — no LLM calls.
+     * The reflection gets stored in memory and injected into subsequent phases.
+     */
+    reflect(phase) {
+        const whatWorked = [];
+        const whatFailed = [];
+        const improvements = [];
+        // Analyze each agent's result
+        for (const agent of phase.agents) {
+            if (agent.status === 'shutdown' || agent.status === 'idle') {
+                const conf = agent.result?.confidence ?? 'medium';
+                if (conf === 'high') {
+                    whatWorked.push(`${agent.config.name}: completed with high confidence`);
+                }
+                else if (conf === 'low') {
+                    whatFailed.push(`${agent.config.name}: low confidence — results may be unreliable`);
+                    improvements.push(`Consider re-running ${agent.config.name} with more specific instructions`);
+                }
+                // Check for blockers
+                if (agent.result?.blockers && agent.result.blockers.length > 0) {
+                    whatFailed.push(`${agent.config.name}: reported blockers: ${agent.result.blockers.join(', ')}`);
+                    improvements.push(`Address blockers before proceeding: ${agent.result.blockers.join(', ')}`);
+                }
+                // Check token efficiency
+                if (agent.usage.totalTokens > 50000) {
+                    improvements.push(`${agent.config.name} used ${agent.usage.totalTokens} tokens — consider using a cheaper model or narrower scope`);
+                }
+            }
+            else if (agent.status === 'error') {
+                whatFailed.push(`${agent.config.name}: failed with error: ${agent.error ?? 'unknown'}`);
+                improvements.push(`Retry ${agent.config.name} with different approach or model`);
+            }
+            else if (agent.status === 'timeout') {
+                whatFailed.push(`${agent.config.name}: timed out`);
+                improvements.push(`Increase timeout for ${agent.config.name} or split into smaller tasks`);
+            }
+        }
+        // Phase-level analysis
+        if (phase.agents.length > 1 && !phase.config.parallel) {
+            improvements.push('This sequential phase has multiple agents — consider parallelizing');
+        }
+        // Overall confidence
+        const errorCount = phase.agents.filter(a => a.status === 'error' || a.status === 'timeout').length;
+        const lowConfCount = phase.agents.filter(a => a.result?.confidence === 'low').length;
+        const confidence = errorCount > 0 ? 'low' :
+            lowConfCount > 0 ? 'medium' : 'high';
+        return {
+            phaseName: phase.config.name,
+            summary: `Phase ${phase.config.name}: ${phase.agents.length} agents, ${phase.usage.totalTokens} tokens, ${Math.round(phase.usage.durationMs / 1000)}s. ${whatFailed.length} issues found.`,
+            whatWorked,
+            whatFailed,
+            improvements,
+            confidence,
+        };
+    }
+    /**
+     * Format a reflection for injection into subsequent agent context.
+     */
+    format(reflection) {
+        const lines = [
+            `## Reflection from ${reflection.phaseName}`,
+            `Confidence: ${reflection.confidence}`,
+        ];
+        if (reflection.whatWorked.length > 0) {
+            lines.push('\nWhat worked:');
+            for (const w of reflection.whatWorked)
+                lines.push(`  + ${w}`);
+        }
+        if (reflection.whatFailed.length > 0) {
+            lines.push('\nIssues:');
+            for (const f of reflection.whatFailed)
+                lines.push(`  - ${f}`);
+        }
+        if (reflection.improvements.length > 0) {
+            lines.push('\nImprovement notes for subsequent phases:');
+            for (const i of reflection.improvements)
+                lines.push(`  → ${i}`);
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=reflexion.js.map

package/dist/runtime/reflexion.js.map

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

package/dist/runtime/review-schema.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Structured review findings schema.
+ * Inspired by Compound Engineering's tiered review system.
+ *
+ * Enables: confidence gating (suppress low-confidence findings),
+ * severity classification (P0-P3), and autofix categorization.
+ */
+export type Severity = 'P0' | 'P1' | 'P2' | 'P3';
+export type AutofixClass = 'safe_auto' | 'gated_auto' | 'manual' | 'advisory';
+export interface ReviewFinding {
+    id: string;
+    severity: Severity;
+    confidence: number;
+    category: string;
+    title: string;
+    description: string;
+    file?: string;
+    line?: number;
+    autofixClass: AutofixClass;
+    suggestedFix?: string;
+    cweId?: string;
+    reviewer: string;
+}
+export interface ReviewReport {
+    orchestrationId: string;
+    timestamp: string;
+    reviewers: string[];
+    findings: ReviewFinding[];
+    summary: ReviewSummary;
+    gateResult: 'pass' | 'fail' | 'warn';
+}
+export interface ReviewSummary {
+    totalFindings: number;
+    bySeverity: Record<Severity, number>;
+    byCategory: Record<string, number>;
+    avgConfidence: number;
+    gatedCount: number;
+    autofixableCount: number;
+}
+export interface ReviewGateConfig {
+    minConfidence: number;
+    failOnP0: boolean;
+    failOnP1Count: number;
+    maxFindings: number;
+}
+export declare const DEFAULT_GATE_CONFIG: ReviewGateConfig;
+/**
+ * Parse agent review output into structured findings.
+ * Agents are instructed to output in a specific format;
+ * this parser extracts structured data from their prose.
+ */
+export declare function parseReviewOutput(output: string, reviewer: string): ReviewFinding[];
+/**
+ * Apply confidence gating — suppress low-confidence findings.
+ */
+export declare function applyConfidenceGate(findings: ReviewFinding[], minConfidence?: number): {
+    kept: ReviewFinding[];
+    gated: ReviewFinding[];
+};
+/**
+ * Evaluate the review gate — pass, fail, or warn.
+ */
+export declare function evaluateGate(findings: ReviewFinding[], config?: ReviewGateConfig): {
+    result: 'pass' | 'fail' | 'warn';
+    reason: string;
+};
+/**
+ * Generate a review summary from findings.
+ */
+export declare function summarizeFindings(findings: ReviewFinding[], config?: ReviewGateConfig): ReviewSummary;
+/**
+ * Format findings for display.
+ */
+export declare function formatFindings(findings: ReviewFinding[]): string;
+//# sourceMappingURL=review-schema.d.ts.map

package/dist/runtime/review-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-schema.d.ts","sourceRoot":"","sources":["../../src/runtime/review-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACjD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAsEnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,aAAa,GAAE,MAA0C,GAAG;IACzH,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAaA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,MAAM,GAAE,gBAAsC,GAAG;IACvG,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAmBA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,MAAM,GAAE,gBAAsC,GAAG,aAAa,CAuB1H;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAwBhE"}