swarm-engine 1.3.0 → 1.41.0

package/dist/runtime/graph-learner.js

@@ -0,0 +1,265 @@
+// ─── Standalone Utilities ─────────────────────────────────────────
+/**
+ * Extract file-like references from a text string.
+ * Matches patterns like "src/runtime/foo.ts", "test/bar.spec.js", "file.ext".
+ */
+export function extractFileReferences(text) {
+    const patterns = [
+        /[\w\-./]+\.\w{1,4}/g, // file.ext or path/to/file.ext
+        /src\/[\w\-./]+/g, // src/path/to/thing
+        /tests?\/[\w\-./]+/g, // test/path or tests/path
+    ];
+    const refs = new Set();
+    for (const pattern of patterns) {
+        const matches = text.match(pattern);
+        if (matches) {
+            for (const m of matches)
+                refs.add(m);
+        }
+    }
+    return [...refs];
+}
+// ─── GraphLearner ─────────────────────────────────────────────────
+/**
+ * Cross-run learning from the execution graph.
+ * Queries accumulated graph data across all past orchestrations to
+ * surface pattern success rates, file co-modifications, and agent
+ * performance by file context.
+ */
+export class GraphLearner {
+    graph;
+    constructor(graph) {
+        this.graph = graph;
+    }
+    /**
+     * Get success/failure stats for a pattern across all recorded runs.
+     * Pass a pattern name to filter, or omit for all patterns.
+     */
+    getPatternStats(patternName) {
+        if (!this.graph)
+            return [];
+        const patternNodes = this.graph.getNodesByType('pattern');
+        const results = [];
+        for (const pNode of patternNodes) {
+            if (patternName && pNode.label !== patternName)
+                continue;
+            // used_pattern edges go orchestration → pattern, so look for incoming edges
+            const incomingEdges = this.graph.getEdges(pNode.id, 'incoming').filter((e) => e.type === 'used_pattern');
+            const orchNodes = incomingEdges
+                .map((e) => this.graph.getNode(e.source))
+                .filter((n) => n !== null);
+            if (orchNodes.length === 0 && !patternName)
+                continue;
+            const successes = orchNodes.filter((o) => o.properties.status === 'completed');
+            const failures = orchNodes.filter((o) => o.properties.status === 'failed');
+            const durations = orchNodes.map((o) => o.properties.durationMs || 0).filter((d) => d > 0);
+            const costs = orchNodes
+                .map((o) => {
+                const usage = o.properties.usage;
+                return usage?.costUsd || 0;
+            })
+                .filter((c) => c > 0);
+            results.push({
+                pattern: pNode.label,
+                totalRuns: orchNodes.length,
+                successCount: successes.length,
+                failCount: failures.length,
+                successRate: orchNodes.length > 0 ? successes.length / orchNodes.length : 0,
+                avgDurationMs: durations.length > 0 ? durations.reduce((a, b) => a + b, 0) / durations.length : 0,
+                avgCostUsd: costs.length > 0 ? costs.reduce((a, b) => a + b, 0) / costs.length : 0,
+            });
+        }
+        return results;
+    }
+    /**
+     * Find files that are frequently modified together across orchestrations.
+     * Returns pairs sorted by co-modification count (descending).
+     */
+    getFileCoModifications(minCount = 2) {
+        if (!this.graph)
+            return [];
+        const fileNodes = this.graph.getNodesByType('file');
+        // Map each file to the set of orchestrations that touched it.
+        // Path: file ←touched_file← agent ←spawned← phase ←contains← orchestration
+        const fileToOrchs = new Map();
+        for (const file of fileNodes) {
+            const orchs = new Set();
+            // agents that touched this file
+            const touchEdges = this.graph.getEdges(file.id, 'incoming').filter((e) => e.type === 'touched_file');
+            for (const te of touchEdges) {
+                // phase that spawned this agent
+                const spawnEdges = this.graph.getEdges(te.source, 'incoming').filter((e) => e.type === 'spawned');
+                for (const se of spawnEdges) {
+                    // orchestration that contains this phase
+                    const containEdges = this.graph.getEdges(se.source, 'incoming').filter((e) => e.type === 'contains');
+                    for (const ce of containEdges) {
+                        orchs.add(ce.source);
+                    }
+                }
+            }
+            if (orchs.size > 0) {
+                fileToOrchs.set(file.id, orchs);
+            }
+        }
+        // Find co-occurring file pairs
+        const pairs = [];
+        const fileIds = [...fileToOrchs.keys()];
+        for (let i = 0; i < fileIds.length; i++) {
+            const orchsA = fileToOrchs.get(fileIds[i]);
+            for (let j = i + 1; j < fileIds.length; j++) {
+                const orchsB = fileToOrchs.get(fileIds[j]);
+                let overlap = 0;
+                for (const o of orchsA) {
+                    if (orchsB.has(o))
+                        overlap++;
+                }
+                if (overlap >= minCount) {
+                    pairs.push({
+                        file1: this.graph.getNode(fileIds[i])?.label || fileIds[i],
+                        file2: this.graph.getNode(fileIds[j])?.label || fileIds[j],
+                        coModCount: overlap,
+                        confidence: overlap >= 5 ? 'EXTRACTED' : overlap >= 3 ? 'INFERRED' : 'AMBIGUOUS',
+                    });
+                }
+            }
+        }
+        return pairs.sort((a, b) => b.coModCount - a.coModCount);
+    }
+    /**
+     * Get agent performance stats segmented by file directory.
+     * Only returns buckets with sampleSize >= 2 to avoid noise.
+     */
+    getAgentFilePerformance(agentType) {
+        if (!this.graph)
+            return [];
+        const agentNodes = this.graph
+            .getNodesByType('agent')
+            .filter((n) => !agentType || n.properties.agentType === agentType || n.label === agentType);
+        // Group by agentType + directory
+        const buckets = new Map();
+        for (const agent of agentNodes) {
+            const aType = agent.properties.agentType || agent.label;
+            const success = agent.properties.status === 'idle';
+            const files = this.graph.getEdges(agent.id, 'outgoing').filter((e) => e.type === 'touched_file');
+            for (const fileEdge of files) {
+                const fileNode = this.graph.getNode(fileEdge.target);
+                const dir = (fileNode?.label || '').split('/').slice(0, -1).join('/') || 'root';
+                const key = `${aType}::${dir}`;
+                const bucket = buckets.get(key) || { success: 0, total: 0 };
+                bucket.total++;
+                if (success)
+                    bucket.success++;
+                buckets.set(key, bucket);
+            }
+        }
+        return [...buckets.entries()]
+            .map(([key, { success, total }]) => {
+            const [at, fp] = key.split('::');
+            return {
+                agentType: at,
+                filePattern: fp,
+                successRate: total > 0 ? success / total : 0,
+                sampleSize: total,
+            };
+        })
+            .filter((r) => r.sampleSize >= 2)
+            .sort((a, b) => b.sampleSize - a.sampleSize);
+    }
+    /**
+     * Record cross-run edges after an orchestration completes.
+     * Links files that were co-modified in this orchestration to files
+     * co-modified in other orchestrations via INFERRED co_modified edges.
+     */
+    recordCrossRunEdges(orchestrationId) {
+        if (!this.graph)
+            return;
+        const orchNode = this.graph.getNode(orchestrationId);
+        if (!orchNode)
+            return;
+        // Collect all file node IDs touched in this orchestration (3-hop BFS covers orch→phase→agent→file)
+        const subgraph = this.graph.bfs(orchestrationId, 3);
+        const fileNodes = subgraph.nodes.filter((n) => n.type === 'file');
+        if (fileNodes.length < 2)
+            return;
+        // Add co_modified edges between all file pairs in this orchestration
+        for (let i = 0; i < fileNodes.length; i++) {
+            for (let j = i + 1; j < fileNodes.length; j++) {
+                this.graph.addEdge({
+                    source: fileNodes[i].id,
+                    target: fileNodes[j].id,
+                    type: 'co_modified',
+                    confidence: 'INFERRED',
+                    properties: { orchestrationId },
+                });
+            }
+        }
+    }
+    /**
+     * Given a list of files from an agent's task, find co-modified files
+     * and format as prompt hint text. Caps at top 5 suggestions.
+     * Skips AMBIGUOUS confidence entries (too noisy).
+     */
+    getCoModHints(files, minCount) {
+        if (!this.graph || files.length === 0)
+            return '';
+        const coMods = this.getFileCoModifications(minCount ?? 2);
+        if (coMods.length === 0)
+            return '';
+        const fileSet = new Set(files);
+        const extracted = [];
+        const inferred = [];
+        for (const coMod of coMods) {
+            if (coMod.confidence === 'AMBIGUOUS')
+                continue;
+            let matchedFile = null;
+            let otherFile = null;
+            if (fileSet.has(coMod.file1) || files.some((f) => coMod.file1.includes(f) || f.includes(coMod.file1))) {
+                matchedFile = coMod.file1;
+                otherFile = coMod.file2;
+            }
+            else if (fileSet.has(coMod.file2) || files.some((f) => coMod.file2.includes(f) || f.includes(coMod.file2))) {
+                matchedFile = coMod.file2;
+                otherFile = coMod.file1;
+            }
+            if (!matchedFile || !otherFile)
+                continue;
+            // Don't suggest files already in the working set
+            if (fileSet.has(otherFile) || files.some((f) => otherFile.includes(f) || f.includes(otherFile)))
+                continue;
+            if (coMod.confidence === 'EXTRACTED') {
+                if (!extracted.includes(otherFile))
+                    extracted.push(otherFile);
+            }
+            else if (coMod.confidence === 'INFERRED') {
+                if (!inferred.includes(otherFile))
+                    inferred.push(otherFile);
+            }
+        }
+        const parts = [];
+        if (extracted.length > 0) {
+            const capped = extracted.slice(0, 5);
+            parts.push(`\n\nNote: These files are typically modified together with the files you're working on: ${capped.join(', ')}`);
+        }
+        if (inferred.length > 0) {
+            const remaining = 5 - (extracted.length > 5 ? 5 : extracted.length);
+            if (remaining > 0) {
+                const capped = inferred.slice(0, remaining);
+                parts.push(`\n\nConsider also reviewing: ${capped.join(', ')}`);
+            }
+        }
+        return parts.join('');
+    }
+    /**
+     * Format pattern stats as context for agent prompts.
+     */
+    formatPatternContext(stats) {
+        if (stats.length === 0)
+            return '';
+        const lines = stats.map((s) => `Pattern "${s.pattern}": ${s.totalRuns} runs, ` +
+            `${Math.round(s.successRate * 100)}% success rate` +
+            (s.avgDurationMs > 0 ? `, avg ${Math.round(s.avgDurationMs / 1000)}s` : '') +
+            (s.avgCostUsd > 0 ? `, avg $${s.avgCostUsd.toFixed(2)}` : ''));
+        return `[Graph Learning — Pattern History]\n${lines.join('\n')}`;
+    }
+}
+//# sourceMappingURL=graph-learner.js.map

package/dist/runtime/graph-learner.js.map

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

package/dist/runtime/graph-meta-adversarial.d.ts

@@ -0,0 +1,113 @@
+import type { ExecutionGraph } from './execution-graph.js';
+export interface Vulnerability {
+    system: 'patternSelector' | 'dropout' | 'causal' | 'heuristic';
+    severity: 'low' | 'medium' | 'high';
+    description: string;
+    perturbation: string;
+    originalOutput: string;
+    perturbedOutput: string;
+    sensitivityScore: number;
+}
+export interface SelfAuditReport {
+    vulnerabilities: Vulnerability[];
+    overallRisk: 'low' | 'medium' | 'high';
+    recommendations: string[];
+    systemsAudited: string[];
+    totalTrials: number;
+}
+type PerturbStrategy = 'noise' | 'swap' | 'truncate' | 'prefix';
+/**
+ * Red-teams the orchestration engine's own decision-making subsystems
+ * by perturbing inputs and checking if outputs change dramatically
+ * (sensitivity analysis). This is a testing/auditing tool, not a
+ * runtime component.
+ */
+export declare class MetaAdversarialTester {
+    private graph;
+    constructor(graph: ExecutionGraph);
+    /**
+     * Test if a pattern selector is fragile to input perturbation.
+     * Generates perturbation pairs and checks if the recommendation changes.
+     */
+    testPatternSelector(selector: {
+        selectPattern: (task: string, ctx?: any) => {
+            pattern: string;
+            confidence: number;
+            alternatives?: Array<{
+                pattern: string;
+                confidence: number;
+            }>;
+        };
+    }, numTrials?: number): Vulnerability[];
+    /**
+     * Test if a dropout predictor makes wrong decisions at boundaries.
+     * Varies agent type, phase kind, and file count to find flip points.
+     */
+    testDropoutPredictor(dropout: {
+        predictRedundant: (agents: Array<{
+            id: string;
+            agentType: string;
+        }>, phaseKind: string, fileCount: number, pattern: string, threshold?: number) => Array<{
+            shouldDropOut: boolean;
+            predictedContribution: number;
+        }>;
+    }, numTrials?: number): Vulnerability[];
+    /**
+     * Test if a causal engine finds spurious correlations.
+     * Creates synthetic scenarios with known confounders and Simpson's paradox data.
+     */
+    testCausalEngine(causal: {
+        estimateCausalEffect: (treatment: string, treatmentValue: string, controlValue: string) => {
+            effect: number;
+            confidence: string;
+            sampleCount: number;
+        };
+    }, numTrials?: number): Vulnerability[];
+    /**
+     * Run a comprehensive audit across all provided subsystems.
+     */
+    runFullAudit(systems: {
+        patternSelector?: {
+            selectPattern: (task: string, ctx?: any) => {
+                pattern: string;
+                confidence: number;
+                alternatives?: Array<{
+                    pattern: string;
+                    confidence: number;
+                }>;
+            };
+        };
+        dropout?: {
+            predictRedundant: (agents: Array<{
+                id: string;
+                agentType: string;
+            }>, phaseKind: string, fileCount: number, pattern: string, threshold?: number) => Array<{
+                shouldDropOut: boolean;
+                predictedContribution: number;
+            }>;
+        };
+        causal?: {
+            estimateCausalEffect: (treatment: string, treatmentValue: string, controlValue: string) => {
+                effect: number;
+                confidence: string;
+                sampleCount: number;
+            };
+        };
+    }): SelfAuditReport;
+    private generateRecommendations;
+    /**
+     * Compute sensitivity between two pattern selection results.
+     * Uses 1 - cosine similarity of the confidence distributions.
+     */
+    private computePatternSensitivity;
+    /**
+     * Deterministic text perturbation given a strategy and optional RNG.
+     * - noise: insert random words between existing words
+     * - swap: swap two adjacent words
+     * - truncate: remove last ~20% of text
+     * - prefix: add misleading prefix
+     */
+    static perturbText(text: string, strategy: PerturbStrategy, rng?: () => number): string;
+}
+export {};
+//# sourceMappingURL=graph-meta-adversarial.d.ts.map

package/dist/runtime/graph-meta-adversarial.d.ts.map

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