@soleri/core 9.5.0 → 9.7.0

package/dist/subagent/dispatcher.js

@@ -0,0 +1,271 @@
+/**
+ * SubagentDispatcher — the core orchestrator for subagent execution.
+ *
+ * Composes: TaskCheckout, WorkspaceResolver, ConcurrencyManager,
+ * OrphanReaper, and RuntimeAdapterRegistry to dispatch tasks to
+ * child agent processes.
+ */
+import { TaskCheckout } from './task-checkout.js';
+import { WorkspaceResolver } from './workspace-resolver.js';
+import { ConcurrencyManager } from './concurrency-manager.js';
+import { OrphanReaper } from './orphan-reaper.js';
+import { aggregate } from './result-aggregator.js';
+import { GoalAncestry } from '../planning/goal-ancestry.js';
+const DEFAULT_TIMEOUT = 300_000; // 5 minutes
+const DEFAULT_MAX_CONCURRENT = 3;
+export class SubagentDispatcher {
+    checkout = new TaskCheckout();
+    workspace;
+    concurrency = new ConcurrencyManager();
+    reaper;
+    adapterRegistry;
+    goalAncestry;
+    constructor(config) {
+        this.adapterRegistry = config.adapterRegistry;
+        if (config.goalRepository) {
+            this.goalAncestry = new GoalAncestry(config.goalRepository);
+        }
+        this.workspace = new WorkspaceResolver(config.baseDir ?? process.cwd());
+        this.reaper = new OrphanReaper((taskId) => {
+            // On orphan: release the task claim and clean up workspace
+            this.checkout.release(taskId);
+            this.workspace.cleanup(taskId);
+        });
+    }
+    /**
+     * Dispatch one or more tasks to subagents.
+     *
+     * Tasks run in parallel by default (controlled by options.parallel).
+     * Each task goes through: claim → resolve workspace → acquire slot →
+     * execute via adapter → collect result.
+     */
+    async dispatch(tasks, options = {}) {
+        const { parallel = true, maxConcurrent = DEFAULT_MAX_CONCURRENT, worktreeIsolation = false, timeout = DEFAULT_TIMEOUT, onTaskUpdate, } = options;
+        if (tasks.length === 0) {
+            return aggregate([]);
+        }
+        // Resolve dependency order
+        const ordered = this.resolveDependencies(tasks);
+        if (parallel) {
+            // Run independent tasks in parallel, respecting dependencies
+            const results = await this.dispatchParallel(ordered, {
+                maxConcurrent,
+                worktreeIsolation,
+                timeout,
+                onTaskUpdate,
+            });
+            return aggregate(results);
+        }
+        // Sequential dispatch — await in loop is intentional (tasks must run one at a time)
+        const results = [];
+        for (const task of ordered) {
+            // eslint-disable-line no-await-in-loop
+            onTaskUpdate?.(task.taskId, 'running');
+            const result = await this.executeTask(task, worktreeIsolation, timeout);
+            results.push(result);
+            onTaskUpdate?.(task.taskId, result.status);
+            // Stop on failure in sequential mode
+            if (result.exitCode !== 0)
+                break;
+        }
+        return aggregate(results);
+    }
+    /** Clean up all resources (worktrees, claims, concurrency) */
+    cleanup() {
+        this.workspace.cleanupAll();
+        this.checkout.releaseAll();
+        this.concurrency.reset();
+        this.reaper.clear();
+    }
+    /** Run orphan detection and cleanup */
+    reapOrphans() {
+        const orphaned = this.reaper.reap();
+        return orphaned.map((p) => ({
+            taskId: p.taskId,
+            status: 'orphaned',
+            exitCode: 1,
+            error: `Process ${p.pid} died unexpectedly`,
+            durationMs: Date.now() - p.registeredAt,
+            pid: p.pid,
+        }));
+    }
+    // ── Internal ──────────────────────────────────────────────────────
+    async dispatchParallel(tasks, opts) {
+        const results = new Map();
+        const pending = new Map();
+        const completed = new Set();
+        // Initialize all tasks as pending
+        for (const task of tasks) {
+            pending.set(task.taskId, task);
+        }
+        // Process in waves until all done
+        while (pending.size > 0) {
+            // Find tasks whose dependencies are all completed
+            const ready = [];
+            for (const [_id, task] of pending) {
+                const deps = task.dependencies ?? [];
+                if (deps.every((d) => completed.has(d))) {
+                    ready.push(task);
+                }
+            }
+            if (ready.length === 0 && pending.size > 0) {
+                // Deadlock — remaining tasks have unmet dependencies
+                for (const [deadId, task] of pending) {
+                    results.set(deadId, {
+                        taskId: deadId,
+                        status: 'failed',
+                        exitCode: 1,
+                        error: `Unresolvable dependencies: ${(task.dependencies ?? []).filter((d) => !completed.has(d)).join(', ')}`,
+                        durationMs: 0,
+                    });
+                }
+                break;
+            }
+            // Dispatch ready tasks in parallel with concurrency control
+            // eslint-disable-next-line no-await-in-loop -- waves must complete before next wave
+            const waveResults = await Promise.allSettled(ready.map(async (task) => {
+                opts.onTaskUpdate?.(task.taskId, 'running');
+                await this.concurrency.acquire(task.runtime ?? 'default', opts.maxConcurrent);
+                try {
+                    return await this.executeTask(task, opts.worktreeIsolation, task.timeout ?? opts.timeout);
+                }
+                finally {
+                    this.concurrency.release(task.runtime ?? 'default');
+                }
+            }));
+            // Collect results
+            for (let i = 0; i < ready.length; i++) {
+                const task = ready[i];
+                const settled = waveResults[i];
+                const result = settled.status === 'fulfilled'
+                    ? settled.value
+                    : {
+                        taskId: task.taskId,
+                        status: 'failed',
+                        exitCode: 1,
+                        error: settled.reason?.message ?? 'Unknown error',
+                        durationMs: 0,
+                    };
+                results.set(task.taskId, result);
+                completed.add(task.taskId);
+                pending.delete(task.taskId);
+                opts.onTaskUpdate?.(task.taskId, result.status);
+            }
+        }
+        // Return in original task order
+        return tasks.map((t) => results.get(t.taskId));
+    }
+    async executeTask(task, worktreeIsolation, timeout) {
+        const startTime = Date.now();
+        // 1. Claim the task
+        const claimed = this.checkout.claim(task.taskId, 'dispatcher');
+        if (!claimed) {
+            return {
+                taskId: task.taskId,
+                status: 'failed',
+                exitCode: 1,
+                error: 'Task already claimed by another process',
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // 2. Resolve workspace
+        const workspace = this.workspace.resolve(task.taskId, task.workspace, worktreeIsolation);
+        // 3. Get adapter
+        const adapterType = task.runtime ?? this.getDefaultAdapterType();
+        let adapter;
+        try {
+            adapter = this.adapterRegistry.get(adapterType);
+        }
+        catch {
+            this.checkout.release(task.taskId);
+            return {
+                taskId: task.taskId,
+                status: 'failed',
+                exitCode: 1,
+                error: `Adapter '${adapterType}' not found in registry`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // 4. Inject goal ancestry context if available
+        let enrichedConfig = { ...task.config, timeout };
+        const goalId = task.config?.goalId;
+        if (goalId && this.goalAncestry) {
+            enrichedConfig =
+                this.goalAncestry.inject({ config: enrichedConfig }, goalId).config ?? enrichedConfig;
+        }
+        // 5. Execute with timeout
+        try {
+            const resultPromise = adapter.execute({
+                runId: `subagent-${task.taskId}-${Date.now()}`,
+                prompt: task.prompt,
+                workspace,
+                config: enrichedConfig,
+            });
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('Task timed out')), timeout);
+            });
+            const adapterResult = await Promise.race([resultPromise, timeoutPromise]);
+            return {
+                taskId: task.taskId,
+                status: adapterResult.exitCode === 0 ? 'completed' : 'failed',
+                exitCode: adapterResult.exitCode,
+                summary: adapterResult.summary,
+                usage: adapterResult.usage,
+                sessionState: adapterResult.sessionState,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                taskId: task.taskId,
+                status: 'failed',
+                exitCode: 1,
+                error: err instanceof Error ? err.message : String(err),
+                durationMs: Date.now() - startTime,
+            };
+        }
+        finally {
+            // Cleanup
+            this.checkout.release(task.taskId);
+            if (worktreeIsolation) {
+                this.workspace.cleanup(task.taskId);
+            }
+        }
+    }
+    /** Topological sort by dependencies (stable — preserves input order for equal deps) */
+    resolveDependencies(tasks) {
+        const taskMap = new Map(tasks.map((t) => [t.taskId, t]));
+        const sorted = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (id) => {
+            if (visited.has(id))
+                return;
+            if (visiting.has(id))
+                return; // cycle — skip
+            visiting.add(id);
+            const task = taskMap.get(id);
+            if (task) {
+                for (const dep of task.dependencies ?? []) {
+                    visit(dep);
+                }
+                visited.add(id);
+                visiting.delete(id);
+                sorted.push(task);
+            }
+        };
+        for (const task of tasks) {
+            visit(task.taskId);
+        }
+        return sorted;
+    }
+    getDefaultAdapterType() {
+        try {
+            return this.adapterRegistry.getDefault().type;
+        }
+        catch {
+            return 'claude-code';
+        }
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/subagent/dispatcher.js.map

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

package/dist/subagent/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Subagent runtime engine — spawn, manage, and aggregate results
+ * from child agent processes.
+ *
+ * @module subagent
+ */
+export type { SubagentTask, SubagentStatus, SubagentResult, DispatchOptions, AggregatedResult, ClaimInfo, WorktreeInfo, TrackedProcess, } from './types.js';
+export { TaskCheckout } from './task-checkout.js';
+export { WorkspaceResolver } from './workspace-resolver.js';
+export { ConcurrencyManager } from './concurrency-manager.js';
+export { OrphanReaper } from './orphan-reaper.js';
+export { aggregate as aggregateResults } from './result-aggregator.js';
+export { SubagentDispatcher } from './dispatcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/subagent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/subagent/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/subagent/index.js

@@ -0,0 +1,15 @@
+/**
+ * Subagent runtime engine — spawn, manage, and aggregate results
+ * from child agent processes.
+ *
+ * @module subagent
+ */
+// Components
+export { TaskCheckout } from './task-checkout.js';
+export { WorkspaceResolver } from './workspace-resolver.js';
+export { ConcurrencyManager } from './concurrency-manager.js';
+export { OrphanReaper } from './orphan-reaper.js';
+export { aggregate as aggregateResults } from './result-aggregator.js';
+// Dispatcher
+export { SubagentDispatcher } from './dispatcher.js';
+//# sourceMappingURL=index.js.map

package/dist/subagent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subagent/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,aAAa;AACb,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/subagent/orphan-reaper.d.ts

@@ -0,0 +1,37 @@
+/**
+ * OrphanReaper — tracks spawned child processes and detects dead/orphaned ones.
+ *
+ * Uses `process.kill(pid, 0)` (signal 0) as an existence check:
+ * - No error → process is alive
+ * - ESRCH → process is dead (reap it)
+ * - EPERM → process is alive but we lack permission to signal it
+ */
+import type { TrackedProcess } from './types.js';
+export declare class OrphanReaper {
+    private readonly tracked;
+    private readonly onOrphan?;
+    constructor(onOrphan?: (taskId: string, pid: number) => void);
+    /** Start tracking a process. */
+    register(pid: number, taskId: string): void;
+    /** Stop tracking a process (called on normal completion). */
+    unregister(pid: number): void;
+    /**
+     * Check each tracked PID for liveness. Dead processes are removed from
+     * tracking, the onOrphan callback is invoked, and they are returned.
+     */
+    reap(): TrackedProcess[];
+    /** Return all currently tracked processes. */
+    listTracked(): TrackedProcess[];
+    /** Check if a PID is currently tracked. */
+    isTracked(pid: number): boolean;
+    /** Clear all tracked processes without killing them. */
+    clear(): void;
+    /**
+     * Signal-0 existence check.
+     * - No error → alive
+     * - EPERM   → alive (exists but we can't signal it)
+     * - ESRCH   → dead
+     */
+    private isAlive;
+}
+//# sourceMappingURL=orphan-reaper.d.ts.map

package/dist/subagent/orphan-reaper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-reaper.d.ts","sourceRoot":"","sources":["../../src/subagent/orphan-reaper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAwC;gBAEtD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI;IAI5D,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3C,6DAA6D;IAC7D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;;OAGG;IACH,IAAI,IAAI,cAAc,EAAE;IAcxB,8CAA8C;IAC9C,WAAW,IAAI,cAAc,EAAE;IAI/B,2CAA2C;IAC3C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/B,wDAAwD;IACxD,KAAK,IAAI,IAAI;IAMb;;;;;OAKG;IACH,OAAO,CAAC,OAAO;CAWhB"}

package/dist/subagent/orphan-reaper.js

@@ -0,0 +1,71 @@
+/**
+ * OrphanReaper — tracks spawned child processes and detects dead/orphaned ones.
+ *
+ * Uses `process.kill(pid, 0)` (signal 0) as an existence check:
+ * - No error → process is alive
+ * - ESRCH → process is dead (reap it)
+ * - EPERM → process is alive but we lack permission to signal it
+ */
+export class OrphanReaper {
+    tracked = new Map();
+    onOrphan;
+    constructor(onOrphan) {
+        this.onOrphan = onOrphan;
+    }
+    /** Start tracking a process. */
+    register(pid, taskId) {
+        this.tracked.set(pid, { pid, taskId, registeredAt: Date.now() });
+    }
+    /** Stop tracking a process (called on normal completion). */
+    unregister(pid) {
+        this.tracked.delete(pid);
+    }
+    /**
+     * Check each tracked PID for liveness. Dead processes are removed from
+     * tracking, the onOrphan callback is invoked, and they are returned.
+     */
+    reap() {
+        const reaped = [];
+        for (const [pid, entry] of this.tracked) {
+            if (!this.isAlive(pid)) {
+                this.tracked.delete(pid);
+                this.onOrphan?.(entry.taskId, pid);
+                reaped.push(entry);
+            }
+        }
+        return reaped;
+    }
+    /** Return all currently tracked processes. */
+    listTracked() {
+        return [...this.tracked.values()];
+    }
+    /** Check if a PID is currently tracked. */
+    isTracked(pid) {
+        return this.tracked.has(pid);
+    }
+    /** Clear all tracked processes without killing them. */
+    clear() {
+        this.tracked.clear();
+    }
+    // ── internals ──────────────────────────────────────────────────────
+    /**
+     * Signal-0 existence check.
+     * - No error → alive
+     * - EPERM   → alive (exists but we can't signal it)
+     * - ESRCH   → dead
+     */
+    isAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'EPERM')
+                return true;
+            // ESRCH or any other error → treat as dead
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=orphan-reaper.js.map

package/dist/subagent/orphan-reaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-reaper.js","sourceRoot":"","sources":["../../src/subagent/orphan-reaper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,OAAO,YAAY;IACN,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,QAAQ,CAAyC;IAElE,YAAY,QAAgD;QAC1D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,gCAAgC;IAChC,QAAQ,CAAC,GAAW,EAAE,MAAc;QAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,6DAA6D;IAC7D,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,MAAM,MAAM,GAAqB,EAAE,CAAC;QAEpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzB,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8CAA8C;IAC9C,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,2CAA2C;IAC3C,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,wDAAwD;IACxD,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,sEAAsE;IAEtE;;;;;OAKG;IACK,OAAO,CAAC,GAAW;QACzB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC;YAClC,2CAA2C;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/subagent/result-aggregator.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Result aggregator — merges results from multiple parallel subagent
+ * executions into a single summary.
+ */
+import type { AggregatedResult, SubagentResult } from './types.js';
+export declare function aggregate(results: SubagentResult[]): AggregatedResult;
+//# sourceMappingURL=result-aggregator.d.ts.map

package/dist/subagent/result-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-aggregator.d.ts","sourceRoot":"","sources":["../../src/subagent/result-aggregator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,gBAAgB,CA0DrE"}

package/dist/subagent/result-aggregator.js

@@ -0,0 +1,57 @@
+/**
+ * Result aggregator — merges results from multiple parallel subagent
+ * executions into a single summary.
+ */
+export function aggregate(results) {
+    if (results.length === 0) {
+        return {
+            status: 'all-passed',
+            totalTasks: 0,
+            completed: 0,
+            failed: 0,
+            totalUsage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
+            filesChanged: [],
+            combinedSummary: '',
+            durationMs: 0,
+            results: [],
+        };
+    }
+    const completed = results.filter((r) => r.exitCode === 0).length;
+    const failed = results.length - completed;
+    const status = failed === 0 ? 'all-passed' : completed === 0 ? 'all-failed' : 'partial';
+    const totalUsage = {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+    };
+    for (const r of results) {
+        totalUsage.inputTokens += r.usage?.inputTokens ?? 0;
+        totalUsage.outputTokens += r.usage?.outputTokens ?? 0;
+        totalUsage.totalTokens += r.usage?.totalTokens ?? 0;
+    }
+    const fileSet = new Set();
+    for (const r of results) {
+        if (r.filesChanged) {
+            for (const f of r.filesChanged)
+                fileSet.add(f);
+        }
+    }
+    const combinedSummary = results
+        .filter((r) => r.summary)
+        .map((r) => `[${r.taskId}] ${r.summary}`)
+        .join('\n');
+    // Parallel wall-clock: max of all durations
+    const durationMs = Math.max(...results.map((r) => r.durationMs));
+    return {
+        status,
+        totalTasks: results.length,
+        completed,
+        failed,
+        totalUsage,
+        filesChanged: [...fileSet],
+        combinedSummary,
+        durationMs,
+        results,
+    };
+}
+//# sourceMappingURL=result-aggregator.js.map

package/dist/subagent/result-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-aggregator.js","sourceRoot":"","sources":["../../src/subagent/result-aggregator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;YAC/D,YAAY,EAAE,EAAE;YAChB,eAAe,EAAE,EAAE;YACnB,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAE1C,MAAM,MAAM,GACV,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3E,MAAM,UAAU,GAAG;QACjB,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;KACf,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,UAAU,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;QACpD,UAAU,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QACtD,UAAU,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,OAAO;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACxC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,4CAA4C;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjE,OAAO;QACL,MAAM;QACN,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,SAAS;QACT,MAAM;QACN,UAAU;QACV,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC;QAC1B,eAAe;QACf,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/subagent/task-checkout.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Atomic task claim system — prevents two subagents from working the same task.
+ *
+ * Pure in-memory Map backing store. No async, no external deps.
+ */
+import type { ClaimInfo } from './types.js';
+export declare class TaskCheckout {
+    private readonly claims;
+    /**
+     * Attempt to claim a task for a claimer.
+     * Returns true if the claim succeeds (or the same claimer already holds it).
+     * Returns false if the task is already claimed by a different claimer.
+     */
+    claim(taskId: string, claimerId: string): boolean;
+    /**
+     * Release a claimed task. Returns true if released, false if not claimed.
+     */
+    release(taskId: string): boolean;
+    /**
+     * Get claim info for a task, or undefined if unclaimed.
+     */
+    getClaimer(taskId: string): ClaimInfo | undefined;
+    /**
+     * List all active claims.
+     */
+    listClaimed(): ClaimInfo[];
+    /**
+     * Check whether a task is available (unclaimed).
+     */
+    isAvailable(taskId: string): boolean;
+    /**
+     * Clear all claims. Useful for cleanup between dispatch rounds.
+     */
+    releaseAll(): void;
+}
+//# sourceMappingURL=task-checkout.d.ts.map

package/dist/subagent/task-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-checkout.d.ts","sourceRoot":"","sources":["../../src/subagent/task-checkout.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IASjD;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjD;;OAEG;IACH,WAAW,IAAI,SAAS,EAAE;IAI1B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/subagent/task-checkout.js

@@ -0,0 +1,52 @@
+/**
+ * Atomic task claim system — prevents two subagents from working the same task.
+ *
+ * Pure in-memory Map backing store. No async, no external deps.
+ */
+export class TaskCheckout {
+    claims = new Map();
+    /**
+     * Attempt to claim a task for a claimer.
+     * Returns true if the claim succeeds (or the same claimer already holds it).
+     * Returns false if the task is already claimed by a different claimer.
+     */
+    claim(taskId, claimerId) {
+        const existing = this.claims.get(taskId);
+        if (existing) {
+            return existing.claimerId === claimerId;
+        }
+        this.claims.set(taskId, { taskId, claimerId, claimedAt: Date.now() });
+        return true;
+    }
+    /**
+     * Release a claimed task. Returns true if released, false if not claimed.
+     */
+    release(taskId) {
+        return this.claims.delete(taskId);
+    }
+    /**
+     * Get claim info for a task, or undefined if unclaimed.
+     */
+    getClaimer(taskId) {
+        return this.claims.get(taskId);
+    }
+    /**
+     * List all active claims.
+     */
+    listClaimed() {
+        return [...this.claims.values()];
+    }
+    /**
+     * Check whether a task is available (unclaimed).
+     */
+    isAvailable(taskId) {
+        return !this.claims.has(taskId);
+    }
+    /**
+     * Clear all claims. Useful for cleanup between dispatch rounds.
+     */
+    releaseAll() {
+        this.claims.clear();
+    }
+}
+//# sourceMappingURL=task-checkout.js.map

package/dist/subagent/task-checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-checkout.js","sourceRoot":"","sources":["../../src/subagent/task-checkout.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,YAAY;IACN,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,MAAc,EAAE,SAAiB;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAc;QACxB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}