claude-mycelium 2.0.0 → 2.2.0

package/dist/coordination/index.js

@@ -5,6 +5,10 @@
  * - Gradient caching
  * - File locks (Phase 3)
  * - Process management (Phase 3)
+ * - Inhibitor signals (Phase 4)
  */
 export * from './gradient-cache.js';
+export * from './file-locks.js';
+export * from './process-manager.js';
+export * from './inhibitors.js';
 //# sourceMappingURL=index.js.map

package/dist/coordination/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/coordination/inhibitors.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Inhibitor Signal System for Claude-Mycelium
+ * Records pattern-specific warnings from failures with exponential decay
+ * Storage: .agent-meta/_inhibitors.ndjson (append-only)
+ * Reference: ADR-002, second-spec §1
+ */
+import type { Inhibitor, Mode, TraceEvent } from '../types/index.js';
+/**
+ * Emit an inhibitor signal after a failure
+ * Appends to NDJSON file for durability
+ */
+export declare function emitInhibitor(params: {
+    trigger: {
+        file?: string;
+        pattern?: string;
+        mode?: Mode;
+    };
+    signal: string;
+    origin: {
+        agent_id: string;
+        trace_id: string;
+        energy_wasted: number;
+        failure_type: 'ci_failed' | 'regression' | 'reverted' | 'loop_detected';
+    };
+    strength: number;
+    half_life_days: number;
+}): Promise<Inhibitor>;
+/**
+ * Query relevant inhibitors for a file + mode combination
+ * Returns inhibitors sorted by current strength (strongest first)
+ * Filters out inhibitors below relevance threshold
+ */
+export declare function queryInhibitors(file: string, mode: Mode): Promise<Array<Inhibitor & {
+    currentStrength: number;
+}>>;
+/**
+ * Calculate current strength with exponential decay
+ * Formula: strength * 0.5^(days / half_life)
+ *
+ * Examples (30-day half-life):
+ * - Day 0: 1.0
+ * - Day 30: 0.5
+ * - Day 60: 0.25
+ * - Day 90: 0.125
+ */
+export declare function calculateCurrentStrength(inhibitor: Inhibitor): number;
+/**
+ * Read all inhibitors from NDJSON file
+ */
+export declare function readInhibitors(): Promise<Inhibitor[]>;
+/**
+ * Extract failure pattern from CI output
+ * Heuristic pattern matching for common failure types
+ */
+export declare function extractFailurePattern(ciOutput: string): string | undefined;
+/**
+ * Summarize CI failure for human-readable signal
+ */
+export declare function summarizeCIFailure(ciOutput: string): string;
+/**
+ * Check if inhibitor should be emitted after an agent run
+ * Cases: CI failed, regression, or loop detected
+ */
+export declare function maybeEmitInhibitor(trace: TraceEvent, ciOutput?: string): Promise<Inhibitor | null>;
+/**
+ * Check for loop pattern (same file + mode, 3+ attempts, no progress)
+ * Must be called after trace is recorded
+ */
+export declare function checkForLoop(file: string, mode: Mode, getRecentTraces: (file: string, mode: Mode, limit: number) => Promise<TraceEvent[]>): Promise<Inhibitor | null>;
+/**
+ * Garbage collect decayed inhibitors (strength < 0.05)
+ * Rewrites the NDJSON file with only relevant inhibitors
+ */
+export declare function gcInhibitors(): Promise<{
+    removed: number;
+    kept: number;
+}>;
+/**
+ * Format inhibitor for display in agent prompts
+ */
+export declare function formatInhibitorForPrompt(inhibitor: Inhibitor & {
+    currentStrength: number;
+}): string;
+//# sourceMappingURL=inhibitors.d.ts.map

package/dist/coordination/inhibitors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inhibitors.d.ts","sourceRoot":"","sources":["../../src/coordination/inhibitors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYrE;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,IAAI,CAAC;KACb,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,CAAC;KACzE,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,SAAS,CAAC,CA8BrB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAqBzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CA2B3D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB3D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAiD3B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,GAClF,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA4C3B;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GACjD,MAAM,CAOR"}

package/dist/coordination/inhibitors.js

@@ -0,0 +1,290 @@
+/**
+ * Inhibitor Signal System for Claude-Mycelium
+ * Records pattern-specific warnings from failures with exponential decay
+ * Storage: .agent-meta/_inhibitors.ndjson (append-only)
+ * Reference: ADR-002, second-spec §1
+ */
+import { v4 as uuidv4 } from 'uuid';
+import * as path from 'path';
+import { appendFile, readFile, fileExists, writeFile } from '../utils/file-utils.js';
+import { logInfo, logError } from '../utils/logger.js';
+// Compute file path at runtime to respect TEST_META_DIR
+function getInhibitorsFile() {
+    const META_DIR = process.env.TEST_META_DIR || '.agent-meta';
+    return path.join(META_DIR, '_inhibitors.ndjson');
+}
+const INHIBITOR_RELEVANCE_THRESHOLD = 0.2;
+const INHIBITOR_GC_THRESHOLD = 0.05;
+const DEFAULT_HALF_LIFE_DAYS = 30;
+/**
+ * Emit an inhibitor signal after a failure
+ * Appends to NDJSON file for durability
+ */
+export async function emitInhibitor(params) {
+    const inhibitor = {
+        id: uuidv4(),
+        timestamp: new Date().toISOString(),
+        trigger: params.trigger,
+        signal: params.signal,
+        origin: params.origin,
+        strength: params.strength,
+        half_life_days: params.half_life_days,
+    };
+    try {
+        // Append to NDJSON file
+        const line = JSON.stringify(inhibitor) + '\n';
+        appendFile(getInhibitorsFile(), line);
+        logInfo('Inhibitor emitted', {
+            id: inhibitor.id,
+            file: inhibitor.trigger.file,
+            mode: inhibitor.trigger.mode,
+            pattern: inhibitor.trigger.pattern,
+            failure_type: inhibitor.origin.failure_type,
+            energy_wasted: `$${inhibitor.origin.energy_wasted.toFixed(4)}`,
+        });
+        return inhibitor;
+    }
+    catch (error) {
+        logError('Failed to emit inhibitor', error, { inhibitor });
+        throw error;
+    }
+}
+/**
+ * Query relevant inhibitors for a file + mode combination
+ * Returns inhibitors sorted by current strength (strongest first)
+ * Filters out inhibitors below relevance threshold
+ */
+export async function queryInhibitors(file, mode) {
+    try {
+        const all = await readInhibitors();
+        return all
+            .map(i => ({ ...i, currentStrength: calculateCurrentStrength(i) }))
+            .filter(i => {
+            // Must be strong enough to be relevant
+            if (i.currentStrength < INHIBITOR_RELEVANCE_THRESHOLD)
+                return false;
+            // Check trigger match
+            const matchesFile = !i.trigger.file || i.trigger.file === file;
+            const matchesMode = !i.trigger.mode || i.trigger.mode === mode;
+            return matchesFile && matchesMode;
+        })
+            .sort((a, b) => b.currentStrength - a.currentStrength);
+    }
+    catch (error) {
+        logError('Failed to query inhibitors', error, { file, mode });
+        return [];
+    }
+}
+/**
+ * Calculate current strength with exponential decay
+ * Formula: strength * 0.5^(days / half_life)
+ *
+ * Examples (30-day half-life):
+ * - Day 0: 1.0
+ * - Day 30: 0.5
+ * - Day 60: 0.25
+ * - Day 90: 0.125
+ */
+export function calculateCurrentStrength(inhibitor) {
+    const ageMs = Date.now() - Date.parse(inhibitor.timestamp);
+    const ageDays = ageMs / (1000 * 60 * 60 * 24);
+    const halfLives = ageDays / inhibitor.half_life_days;
+    return inhibitor.strength * Math.pow(0.5, halfLives);
+}
+/**
+ * Read all inhibitors from NDJSON file
+ */
+export async function readInhibitors() {
+    try {
+        if (!fileExists(getInhibitorsFile())) {
+            return [];
+        }
+        const content = readFile(getInhibitorsFile());
+        const lines = content.trim().split('\n').filter(line => line.length > 0);
+        const inhibitors = [];
+        for (const line of lines) {
+            try {
+                const inhibitor = JSON.parse(line);
+                inhibitors.push(inhibitor);
+            }
+            catch (error) {
+                logError('Failed to parse inhibitor line', error, {
+                    line: line.substring(0, 100),
+                });
+                // Skip corrupted lines
+            }
+        }
+        return inhibitors;
+    }
+    catch (error) {
+        logError('Failed to read inhibitors', error);
+        return [];
+    }
+}
+/**
+ * Extract failure pattern from CI output
+ * Heuristic pattern matching for common failure types
+ */
+export function extractFailurePattern(ciOutput) {
+    if (ciOutput.includes('TypeError'))
+        return 'changes causing TypeError';
+    if (ciOutput.includes('Cannot find module'))
+        return 'breaking imports';
+    if (ciOutput.includes('is not assignable'))
+        return 'type mismatches';
+    if (ciOutput.includes('ENOENT'))
+        return 'missing file references';
+    if (ciOutput.includes('ReferenceError'))
+        return 'undefined variable references';
+    if (ciOutput.includes('SyntaxError'))
+        return 'syntax errors';
+    return undefined;
+}
+/**
+ * Summarize CI failure for human-readable signal
+ */
+export function summarizeCIFailure(ciOutput) {
+    const lines = ciOutput.split('\n').filter(line => line.trim().length > 0);
+    // Find the first error line
+    for (const line of lines) {
+        if (line.includes('Error:') ||
+            line.includes('error TS') ||
+            line.includes('✖') ||
+            line.includes('FAIL')) {
+            return line.trim().substring(0, 150); // First 150 chars
+        }
+    }
+    return lines[0]?.substring(0, 150) || 'CI failure (no details available)';
+}
+/**
+ * Check if inhibitor should be emitted after an agent run
+ * Cases: CI failed, regression, or loop detected
+ */
+export async function maybeEmitInhibitor(trace, ciOutput) {
+    try {
+        // Case 1: CI failed
+        if (!trace.ci_passed && ciOutput) {
+            return await emitInhibitor({
+                trigger: {
+                    file: trace.file_path,
+                    mode: trace.mode,
+                    pattern: extractFailurePattern(ciOutput),
+                },
+                signal: `CI failed: ${summarizeCIFailure(ciOutput)}`,
+                origin: {
+                    agent_id: trace.agent_id || 'unknown',
+                    trace_id: trace.id,
+                    energy_wasted: trace.cost?.estimated_usd || 0,
+                    failure_type: 'ci_failed',
+                },
+                strength: 1.0,
+                half_life_days: DEFAULT_HALF_LIFE_DAYS,
+            });
+        }
+        // Case 2: Regression (gradient increased instead of decreased)
+        if (trace.gradient_delta < -0.02) {
+            // Made things worse
+            return await emitInhibitor({
+                trigger: {
+                    file: trace.file_path,
+                    mode: trace.mode,
+                },
+                signal: `${trace.mode} made ${trace.file_path} worse. Gradient increased by ${Math.abs(trace.gradient_delta).toFixed(2)}.`,
+                origin: {
+                    agent_id: trace.agent_id || 'unknown',
+                    trace_id: trace.id,
+                    energy_wasted: trace.cost?.estimated_usd || 0,
+                    failure_type: 'regression',
+                },
+                strength: 1.0,
+                half_life_days: DEFAULT_HALF_LIFE_DAYS,
+            });
+        }
+        // Case 3: Loop detection is handled separately via checkForLoop()
+        return null;
+    }
+    catch (error) {
+        logError('Failed to check for inhibitor emission', error, { trace });
+        return null;
+    }
+}
+/**
+ * Check for loop pattern (same file + mode, 3+ attempts, no progress)
+ * Must be called after trace is recorded
+ */
+export async function checkForLoop(file, mode, getRecentTraces) {
+    try {
+        const recentTraces = await getRecentTraces(file, mode, 5);
+        // Need at least 3 attempts
+        if (recentTraces.length < 3) {
+            return null;
+        }
+        // Check if all recent attempts had poor efficiency (<0.02)
+        const isLoop = recentTraces.every(t => {
+            const efficiency = t.efficiency || 0;
+            return efficiency < 0.02;
+        });
+        if (!isLoop) {
+            return null;
+        }
+        // Calculate total waste
+        const totalWasted = recentTraces.reduce((sum, t) => sum + (t.cost?.estimated_usd || 0), 0);
+        return await emitInhibitor({
+            trigger: {
+                file,
+                mode,
+            },
+            signal: `${mode} is stuck on ${file}. ${recentTraces.length} attempts with no improvement. Total wasted: $${totalWasted.toFixed(2)}.`,
+            origin: {
+                agent_id: recentTraces[0]?.agent_id || 'unknown',
+                trace_id: recentTraces[0]?.id || 'unknown',
+                energy_wasted: totalWasted,
+                failure_type: 'loop_detected',
+            },
+            strength: 1.0,
+            half_life_days: 60, // Longer half-life for loops
+        });
+    }
+    catch (error) {
+        logError('Failed to check for loop', error, { file, mode });
+        return null;
+    }
+}
+/**
+ * Garbage collect decayed inhibitors (strength < 0.05)
+ * Rewrites the NDJSON file with only relevant inhibitors
+ */
+export async function gcInhibitors() {
+    try {
+        const all = await readInhibitors();
+        const active = all.filter(i => calculateCurrentStrength(i) >= INHIBITOR_GC_THRESHOLD);
+        // Rewrite file with only active inhibitors
+        if (active.length < all.length) {
+            const lines = active.map(i => JSON.stringify(i) + '\n').join('');
+            writeFile(getInhibitorsFile(), lines);
+            logInfo('Inhibitor GC complete', {
+                removed: all.length - active.length,
+                kept: active.length,
+            });
+        }
+        return {
+            removed: all.length - active.length,
+            kept: active.length,
+        };
+    }
+    catch (error) {
+        logError('Failed to GC inhibitors', error);
+        return { removed: 0, kept: 0 };
+    }
+}
+/**
+ * Format inhibitor for display in agent prompts
+ */
+export function formatInhibitorForPrompt(inhibitor) {
+    const strengthPercent = Math.round(inhibitor.currentStrength * 100);
+    const patternText = inhibitor.trigger.pattern || 'this approach';
+    return `⚠️ **[Strength: ${strengthPercent}%]** ${patternText}
+   ${inhibitor.signal}
+   _Origin: ${inhibitor.origin.failure_type} by ${inhibitor.origin.agent_id}, wasted $${inhibitor.origin.energy_wasted.toFixed(4)}_`;
+}
+//# sourceMappingURL=inhibitors.js.map

package/dist/coordination/inhibitors.js.map

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

package/dist/coordination/process-manager.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Process management for spawning and managing agent workers
+ * Each agent runs as an independent Node.js process via child_process.fork()
+ *
+ * Reference: ADR-004 lines 15-28
+ */
+import { ChildProcess } from 'child_process';
+export interface SpawnOptions {
+    agentId: string;
+    maxIterations?: number;
+    timeout?: number;
+}
+export interface AgentProcess {
+    child: ChildProcess;
+    agentId: string;
+    startedAt: Date;
+    timeout: NodeJS.Timeout | null;
+}
+/**
+ * Spawn an agent worker process
+ *
+ * @param options - Agent spawn options
+ * @returns ChildProcess handle
+ */
+export declare function spawnAgent(options: SpawnOptions): ChildProcess;
+/**
+ * Kill an agent process
+ *
+ * @param agentId - Agent to kill
+ * @returns true if agent was killed, false if not found
+ */
+export declare function killAgent(agentId: string): boolean;
+/**
+ * List all active agent processes
+ *
+ * @returns Array of active agent IDs with metadata
+ */
+export declare function listAgents(): Array<{
+    agentId: string;
+    pid: number;
+    startedAt: Date;
+    uptime: number;
+}>;
+/**
+ * Check if an agent is running
+ *
+ * @param agentId - Agent to check
+ * @returns true if agent is running
+ */
+export declare function isAgentRunning(agentId: string): boolean;
+/**
+ * Get agent process info
+ *
+ * @param agentId - Agent to get info for
+ * @returns Agent info or null if not found
+ */
+export declare function getAgentInfo(agentId: string): {
+    agentId: string;
+    pid: number;
+    startedAt: Date;
+    uptime: number;
+} | null;
+/**
+ * Kill all active agents
+ */
+export declare function killAllAgents(): void;
+/**
+ * Wait for all agents to complete
+ *
+ * @returns Promise that resolves when all agents have exited
+ */
+export declare function waitForAllAgents(): Promise<void>;
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/coordination/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/coordination/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,YAAY,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAChC;AAID;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAmD9D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAalD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,KAAK,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAoBD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAYP;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAQpC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQtD"}

package/dist/coordination/process-manager.js

@@ -0,0 +1,144 @@
+/**
+ * Process management for spawning and managing agent workers
+ * Each agent runs as an independent Node.js process via child_process.fork()
+ *
+ * Reference: ADR-004 lines 15-28
+ */
+import { fork } from 'child_process';
+import * as path from 'path';
+const activeAgents = new Map();
+/**
+ * Spawn an agent worker process
+ *
+ * @param options - Agent spawn options
+ * @returns ChildProcess handle
+ */
+export function spawnAgent(options) {
+    const { agentId, maxIterations = 10, timeout = 300_000, // 5 minutes default
+     } = options;
+    // Path to the compiled worker file
+    const workerPath = path.join(__dirname, '../agent/worker.js');
+    const child = fork(workerPath, [], {
+        env: {
+            ...process.env,
+            AGENT_ID: agentId,
+            MAX_ITERATIONS: String(maxIterations),
+        },
+        stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+    });
+    // Set up timeout
+    const timer = setTimeout(() => {
+        console.warn(`[process-manager] Agent ${agentId} timed out after ${timeout}ms`);
+        child.kill('SIGTERM');
+    }, timeout);
+    // Clean up on exit
+    child.on('exit', (code, signal) => {
+        clearTimeout(timer);
+        activeAgents.delete(agentId);
+        console.log(`[process-manager] Agent ${agentId} exited with code ${code}, signal ${signal}`);
+    });
+    // Handle IPC messages
+    child.on('message', (message) => {
+        console.log(`[process-manager] Message from ${agentId}:`, message);
+    });
+    // Handle errors
+    child.on('error', (error) => {
+        console.error(`[process-manager] Error from agent ${agentId}:`, error);
+    });
+    // Track the agent
+    activeAgents.set(agentId, {
+        child,
+        agentId,
+        startedAt: new Date(),
+        timeout: timer,
+    });
+    return child;
+}
+/**
+ * Kill an agent process
+ *
+ * @param agentId - Agent to kill
+ * @returns true if agent was killed, false if not found
+ */
+export function killAgent(agentId) {
+    const agent = activeAgents.get(agentId);
+    if (!agent) {
+        return false;
+    }
+    if (agent.timeout) {
+        clearTimeout(agent.timeout);
+    }
+    agent.child.kill('SIGTERM');
+    activeAgents.delete(agentId);
+    return true;
+}
+/**
+ * List all active agent processes
+ *
+ * @returns Array of active agent IDs with metadata
+ */
+export function listAgents() {
+    const agents = [];
+    for (const [agentId, agent] of activeAgents) {
+        if (agent.child.pid) {
+            agents.push({
+                agentId,
+                pid: agent.child.pid,
+                startedAt: agent.startedAt,
+                uptime: Date.now() - agent.startedAt.getTime(),
+            });
+        }
+    }
+    return agents;
+}
+/**
+ * Check if an agent is running
+ *
+ * @param agentId - Agent to check
+ * @returns true if agent is running
+ */
+export function isAgentRunning(agentId) {
+    return activeAgents.has(agentId);
+}
+/**
+ * Get agent process info
+ *
+ * @param agentId - Agent to get info for
+ * @returns Agent info or null if not found
+ */
+export function getAgentInfo(agentId) {
+    const agent = activeAgents.get(agentId);
+    if (!agent || !agent.child.pid) {
+        return null;
+    }
+    return {
+        agentId,
+        pid: agent.child.pid,
+        startedAt: agent.startedAt,
+        uptime: Date.now() - agent.startedAt.getTime(),
+    };
+}
+/**
+ * Kill all active agents
+ */
+export function killAllAgents() {
+    for (const [agentId, agent] of activeAgents) {
+        if (agent.timeout) {
+            clearTimeout(agent.timeout);
+        }
+        agent.child.kill('SIGTERM');
+    }
+    activeAgents.clear();
+}
+/**
+ * Wait for all agents to complete
+ *
+ * @returns Promise that resolves when all agents have exited
+ */
+export async function waitForAllAgents() {
+    const promises = Array.from(activeAgents.values()).map((agent) => new Promise((resolve) => {
+        agent.child.once('exit', () => resolve());
+    }));
+    await Promise.all(promises);
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/coordination/process-manager.js.map

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

package/dist/core/agent-executor.d.ts

@@ -16,12 +16,15 @@ import type { Mode, TraceEvent } from '../types/index.js';
 export interface AgentRunResult {
     success: boolean;
     changes: string[];
-    trace: TraceEvent;
+    trace?: TraceEvent;
     cost: number;
+    error?: string;
 }
 export interface AgentExecuteOptions {
     dryRun?: boolean;
     maxRetries?: number;
+    agentId?: string;
+    taskId?: string;
 }
 /**
  * Execute agent work on a single file

package/dist/core/agent-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../../src/core/agent-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAIjF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAuKzB"}
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../../src/core/agent-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAIjF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAkMzB"}