@runcore-sh/runcore 0.1.2

package/dist/agents/cooldown.js

@@ -0,0 +1,396 @@
+/**
+ * Task Cooldown Manager — prevents repeatedly-failing tasks from being
+ * retried too aggressively, reducing GC pressure from excessive agent spawns.
+ *
+ * Tracks failure counts per board task ID with exponential backoff cooldowns.
+ * Persists state to disk so cooldowns survive process restarts.
+ *
+ * Usage:
+ *   const cooldown = TaskCooldownManager.getInstance();
+ *   await cooldown.init();
+ *   cooldown.recordFailure("task-123", "Build feature X", "TypeError: ...");
+ *   if (cooldown.isOnCooldown("task-123")) { skip task }
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { createLogger } from "../utils/logger.js";
+import { logActivity } from "../activity/log.js";
+import { recordCooldownActivation, recordCooldownSkip } from "../metrics/firewall-metrics.js";
+const log = createLogger("cooldown");
+const DEFAULT_CONFIG = {
+    baseCooldownMs: 30 * 60 * 1000, // 30 min
+    maxCooldownMs: 4 * 60 * 60 * 1000, // 4 hours
+    backoffMultiplier: 2,
+    persistPath: join(process.cwd(), "brain", "agents", "cooldowns.json"),
+    maxEntries: 200,
+    maxTotalFailures: 6,
+};
+// ─── Singleton ──────────────────────────────────────────────────────────────
+let instance = null;
+// ─── Manager ────────────────────────────────────────────────────────────────
+export class TaskCooldownManager {
+    config;
+    entries = new Map();
+    dirty = false;
+    persistTimer = null;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /** Get or create the singleton instance. */
+    static getInstance(config) {
+        if (!instance) {
+            instance = new TaskCooldownManager(config);
+        }
+        return instance;
+    }
+    /** Reset singleton (for testing). */
+    static resetInstance() {
+        if (instance) {
+            instance.shutdown();
+            instance = null;
+        }
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────────────────
+    /** Load persisted cooldown state from disk. */
+    async init() {
+        try {
+            const raw = await readFile(this.config.persistPath, "utf-8");
+            const data = JSON.parse(raw);
+            for (const entry of data) {
+                this.entries.set(entry.taskId, entry);
+            }
+            // Prune expired entries on load
+            this.pruneExpired();
+            log.info(`Loaded ${this.entries.size} cooldown entries from disk`);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === "ENOENT") {
+                log.info("No cooldown state on disk, starting fresh");
+            }
+            else {
+                log.warn(`Failed to load cooldown state: ${err.message}`);
+            }
+        }
+    }
+    /** Flush pending changes and stop the persist timer. */
+    shutdown() {
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = null;
+        }
+        if (this.dirty) {
+            this.persistSync();
+        }
+    }
+    // ── Core API ──────────────────────────────────────────────────────────────
+    /**
+     * Record a task failure. Increments the failure count and resets the
+     * cooldown timer. Schedules a debounced persist to disk.
+     */
+    recordFailure(taskId, label, error) {
+        const existing = this.entries.get(taskId);
+        // DASH-143: Dedup burst — if the same task was recorded within 30s,
+        // skip to prevent double-counting from multiple recording paths
+        // (immediate failure handler + batch completion handler).
+        if (existing) {
+            const sinceLast = Date.now() - new Date(existing.lastFailedAt).getTime();
+            if (sinceLast < 30_000) {
+                log.debug(`Skipping duplicate failure record for ${taskId} (${sinceLast}ms since last)`);
+                return;
+            }
+        }
+        const failureCount = (existing?.failureCount ?? 0) + 1;
+        const entry = {
+            taskId,
+            lastFailedAt: new Date().toISOString(),
+            failureCount,
+            lastError: error?.slice(0, 300),
+            label: label ?? existing?.label,
+        };
+        this.entries.set(taskId, entry);
+        this.dirty = true;
+        this.schedulePersist();
+        recordCooldownActivation();
+        // Check if task is now permanently blocked
+        if (failureCount >= this.config.maxTotalFailures) {
+            log.warn(`Task ${taskId} BLOCKED after ${failureCount} failures — needs manual clearCooldown()`, {
+                taskId,
+                failureCount,
+                label,
+            });
+            logActivity({
+                source: "agent",
+                summary: `BLOCKED: ${label ?? taskId} permanently blocked after ${failureCount} failures — needs human intervention`,
+                detail: error?.slice(0, 200),
+                actionLabel: "AUTONOMOUS",
+                reason: "task permanently blocked (DASH-143 hard cap)",
+            });
+        }
+        else {
+            const cooldownMs = this.calculateCooldown(failureCount);
+            const cooldownMin = Math.round(cooldownMs / 60_000);
+            log.info(`Task ${taskId} failed ${failureCount} time(s), cooldown ${cooldownMin}min`, {
+                taskId,
+                failureCount,
+                cooldownMin,
+                label,
+            });
+            logActivity({
+                source: "agent",
+                summary: `Cooldown: ${label ?? taskId} failed ${failureCount}x, backing off ${cooldownMin}min`,
+                detail: error?.slice(0, 200),
+                actionLabel: "AUTONOMOUS",
+                reason: "task cooldown escalation",
+            });
+        }
+    }
+    /**
+     * Check if a task is currently on cooldown (or permanently blocked).
+     *
+     * DASH-143 fix: cooldown expiration no longer deletes the entry. Failure
+     * history is preserved so the hard cap (maxTotalFailures) works across
+     * cooldown cycles. Only clearCooldown() resets failure history.
+     */
+    isOnCooldown(taskId) {
+        const entry = this.entries.get(taskId);
+        if (!entry)
+            return false;
+        // Hard cap: permanently blocked until manual clearCooldown()
+        if (entry.failureCount >= this.config.maxTotalFailures)
+            return true;
+        const cooldownMs = this.calculateCooldown(entry.failureCount);
+        const elapsed = Date.now() - new Date(entry.lastFailedAt).getTime();
+        // Cooldown expired — task is retryable, but keep the entry so
+        // failureCount accumulates across cycles (DASH-143)
+        if (elapsed >= cooldownMs)
+            return false;
+        return true;
+    }
+    /**
+     * Check if a task has been permanently blocked (exceeded maxTotalFailures).
+     * These tasks will never be retried until manually cleared.
+     */
+    isBlocked(taskId) {
+        const entry = this.entries.get(taskId);
+        return entry != null && entry.failureCount >= this.config.maxTotalFailures;
+    }
+    /**
+     * Check cooldown and log a skip message if the task is on cooldown.
+     * Returns true if the task should be skipped.
+     */
+    shouldSkip(taskId) {
+        if (!this.isOnCooldown(taskId))
+            return false;
+        recordCooldownSkip();
+        if (this.isBlocked(taskId)) {
+            const entry = this.entries.get(taskId);
+            log.info(`Skipping task ${taskId} — permanently blocked after ${entry?.failureCount} failures (needs manual clear)`, {
+                taskId,
+                failureCount: entry?.failureCount,
+                label: entry?.label,
+            });
+        }
+        else {
+            const status = this.getStatus(taskId);
+            if (status) {
+                const remainMin = Math.round(status.remainingMs / 60_000);
+                log.info(`Skipping task ${taskId} — on cooldown for ${remainMin} more min (${status.failureCount} failures)`, {
+                    taskId,
+                    remainingMin: remainMin,
+                    failureCount: status.failureCount,
+                    label: status.label,
+                });
+            }
+        }
+        return true;
+    }
+    /** Get detailed status for a single task's cooldown. */
+    getStatus(taskId) {
+        const entry = this.entries.get(taskId);
+        if (!entry)
+            return null;
+        // Blocked tasks: report as permanently on cooldown
+        if (entry.failureCount >= this.config.maxTotalFailures) {
+            return {
+                taskId,
+                label: entry.label,
+                failureCount: entry.failureCount,
+                cooldownMs: Infinity,
+                remainingMs: Infinity,
+                expiresAt: "blocked",
+                lastFailedAt: entry.lastFailedAt,
+                lastError: entry.lastError,
+            };
+        }
+        const cooldownMs = this.calculateCooldown(entry.failureCount);
+        const elapsed = Date.now() - new Date(entry.lastFailedAt).getTime();
+        const remainingMs = Math.max(0, cooldownMs - elapsed);
+        if (remainingMs === 0)
+            return null;
+        return {
+            taskId,
+            label: entry.label,
+            failureCount: entry.failureCount,
+            cooldownMs,
+            remainingMs,
+            expiresAt: new Date(new Date(entry.lastFailedAt).getTime() + cooldownMs).toISOString(),
+            lastFailedAt: entry.lastFailedAt,
+            lastError: entry.lastError,
+        };
+    }
+    /** Clear cooldown for a specific task (e.g., after manual intervention). */
+    clearCooldown(taskId) {
+        if (this.entries.delete(taskId)) {
+            this.dirty = true;
+            this.schedulePersist();
+            log.info(`Cooldown cleared for task ${taskId}`);
+        }
+    }
+    /** Clear all cooldowns. */
+    clearAll() {
+        if (this.entries.size > 0) {
+            this.entries.clear();
+            this.dirty = true;
+            this.schedulePersist();
+            log.info("All cooldowns cleared");
+        }
+    }
+    /**
+     * Remove expired cooldown entries that are safe to prune.
+     * Entries at or above the hard failure cap are NEVER pruned — they
+     * represent permanently blocked tasks that need manual clearCooldown().
+     * Entries with failure history but expired cooldowns are pruned after
+     * 24 hours of inactivity (enough time that if the task succeeds on
+     * the next retry, the entry is no longer needed).
+     */
+    pruneExpired() {
+        const now = Date.now();
+        const STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
+        let pruned = 0;
+        for (const [taskId, entry] of this.entries) {
+            // Never prune permanently blocked entries
+            if (entry.failureCount >= this.config.maxTotalFailures)
+                continue;
+            const cooldownMs = this.calculateCooldown(entry.failureCount);
+            const elapsed = now - new Date(entry.lastFailedAt).getTime();
+            // Only prune if cooldown expired AND entry is stale (24h inactive)
+            if (elapsed >= cooldownMs + STALE_THRESHOLD_MS) {
+                this.entries.delete(taskId);
+                pruned++;
+            }
+        }
+        if (pruned > 0) {
+            this.dirty = true;
+            this.schedulePersist();
+            log.info(`Pruned ${pruned} stale cooldown entries`);
+        }
+        return pruned;
+    }
+    /** List all active cooldowns and blocked tasks with status details. */
+    listActiveCooldowns() {
+        this.pruneExpired();
+        const results = [];
+        for (const [taskId] of this.entries) {
+            const status = this.getStatus(taskId);
+            if (status)
+                results.push(status);
+        }
+        // Blocked tasks (Infinity) sort last, then by remaining time
+        results.sort((a, b) => {
+            if (a.remainingMs === Infinity && b.remainingMs === Infinity)
+                return 0;
+            if (a.remainingMs === Infinity)
+                return 1;
+            if (b.remainingMs === Infinity)
+                return -1;
+            return a.remainingMs - b.remainingMs;
+        });
+        return results;
+    }
+    /** Get summary for planner context (what tasks are on cooldown or blocked). */
+    getCooldownContext() {
+        const active = this.listActiveCooldowns();
+        if (active.length === 0)
+            return null;
+        const lines = active.map((s) => {
+            if (s.expiresAt === "blocked") {
+                return `- ${s.label ?? s.taskId}: BLOCKED (${s.failureCount} failures, needs human intervention)`;
+            }
+            const remainMin = Math.round(s.remainingMs / 60_000);
+            return `- ${s.label ?? s.taskId}: failed ${s.failureCount}x, ${remainMin}min remaining`;
+        });
+        return lines.join("\n");
+    }
+    /** Get the failure count for a task (0 if not tracked). */
+    getFailureCount(taskId) {
+        return this.entries.get(taskId)?.failureCount ?? 0;
+    }
+    /** Get total number of tracked entries (active + expired pending prune). */
+    get size() {
+        return this.entries.size;
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    /**
+     * Calculate exponential backoff cooldown.
+     * Formula: base × multiplier^(failureCount - 1), capped at max.
+     *
+     *   Failures → Cooldown (with defaults):
+     *     1 → 30min
+     *     2 → 60min
+     *     3 → 120min
+     *     4 → 240min (capped at 4hr)
+     *     5+ → 240min (capped at 4hr)
+     */
+    calculateCooldown(failureCount) {
+        const { baseCooldownMs, maxCooldownMs, backoffMultiplier } = this.config;
+        return Math.min(baseCooldownMs * Math.pow(backoffMultiplier, Math.max(0, failureCount - 1)), maxCooldownMs);
+    }
+    /** Debounced persist — waits 5s after last change before writing to disk. */
+    schedulePersist() {
+        if (this.persistTimer)
+            return;
+        this.persistTimer = setTimeout(() => {
+            this.persistTimer = null;
+            this.persistAsync().catch((err) => {
+                log.warn(`Failed to persist cooldowns: ${err.message}`);
+            });
+        }, 5_000);
+    }
+    async persistAsync() {
+        if (!this.dirty)
+            return;
+        // Prune before persisting
+        this.pruneExpired();
+        // Enforce max entries: keep the most recent
+        if (this.entries.size > this.config.maxEntries) {
+            const sorted = [...this.entries.entries()]
+                .sort((a, b) => new Date(b[1].lastFailedAt).getTime() - new Date(a[1].lastFailedAt).getTime());
+            this.entries = new Map(sorted.slice(0, this.config.maxEntries));
+        }
+        const data = [...this.entries.values()];
+        try {
+            await mkdir(dirname(this.config.persistPath), { recursive: true });
+            await writeFile(this.config.persistPath, JSON.stringify(data, null, 2), "utf-8");
+            this.dirty = false;
+            log.debug(`Persisted ${data.length} cooldown entries to disk`);
+        }
+        catch (err) {
+            log.warn(`Failed to write cooldown file: ${err.message}`);
+        }
+    }
+    /** Synchronous persist for shutdown path (best-effort). */
+    persistSync() {
+        try {
+            const { writeFileSync, mkdirSync } = require("node:fs");
+            const data = [...this.entries.values()];
+            mkdirSync(dirname(this.config.persistPath), { recursive: true });
+            writeFileSync(this.config.persistPath, JSON.stringify(data, null, 2), "utf-8");
+            this.dirty = false;
+        }
+        catch {
+            // Best effort on shutdown
+        }
+    }
+}
+//# sourceMappingURL=cooldown.js.map

package/dist/agents/cooldown.js.map

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

package/dist/agents/dedup-guard.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Dedup Guard — prevents the autonomous planner from spawning agents
+ * that duplicate work already in progress or recently completed.
+ *
+ * Three checks, cheapest first:
+ *   1. Active agent with same label (~0ms, in-memory)
+ *   2. Recent task with same label (~5ms, reads task JSON files)
+ *   3. Recent git commits touching related files (~50ms, shell out to git)
+ */
+export interface DedupResult {
+    blocked: boolean;
+    reason?: string;
+}
+export declare function checkDedup(label: string, prompt: string): Promise<DedupResult>;
+//# sourceMappingURL=dedup-guard.d.ts.map

package/dist/agents/dedup-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup-guard.d.ts","sourceRoot":"","sources":["../../src/agents/dedup-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0BD,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqFpF"}

package/dist/agents/dedup-guard.js

@@ -0,0 +1,128 @@
+/**
+ * Dedup Guard — prevents the autonomous planner from spawning agents
+ * that duplicate work already in progress or recently completed.
+ *
+ * Three checks, cheapest first:
+ *   1. Active agent with same label (~0ms, in-memory)
+ *   2. Recent task with same label (~5ms, reads task JSON files)
+ *   3. Recent git commits touching related files (~50ms, shell out to git)
+ */
+import { execSync } from "node:child_process";
+import { activeProcesses } from "./spawn.js";
+import { listTasks } from "./store.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("dedup-guard");
+// ─── Constants ──────────────────────────────────────────────────────────────
+const DEDUP_RECENT_WINDOW_MS = 2 * 60 * 60 * 1000; // 2 hours
+/** Shorter window for failed tasks — blocks immediate re-planning while
+ *  cooldown manager handles longer-term backoff (DASH-143). */
+const DEDUP_FAILED_WINDOW_MS = 5 * 60 * 1000; // 5 minutes
+const GIT_LOOKBACK_MINUTES = 30;
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/** Normalize a label for fuzzy matching: lowercase, trim whitespace. */
+function normalize(label) {
+    return label.toLowerCase().trim();
+}
+/** Fuzzy match: either label contains the other (after normalization). */
+function fuzzyMatch(a, b) {
+    const na = normalize(a);
+    const nb = normalize(b);
+    return na.includes(nb) || nb.includes(na);
+}
+/** Extract file paths from a prompt string. */
+function extractFilePaths(prompt) {
+    const regex = /(?:src\/|brain\/|public\/)[^\s"'`,)}\]]+(?:\.ts|\.js|\.md|\.json|\.yaml|\.yml)?/g;
+    const matches = prompt.match(regex) ?? [];
+    // Deduplicate
+    return [...new Set(matches)];
+}
+// ─── Main ───────────────────────────────────────────────────────────────────
+export async function checkDedup(label, prompt) {
+    // Check 1: Active agent with same label (~0ms)
+    for (const [, proc] of activeProcesses) {
+        // activeProcesses is Map<taskId, ChildProcess> — we need labels from tasks
+        // Skip this map-based check; we'll rely on the task list check below
+        void proc;
+    }
+    // Better: check running tasks via store (covers both pool and direct spawns)
+    try {
+        const tasks = await listTasks();
+        for (const t of tasks) {
+            if (t.status === "running" && fuzzyMatch(t.label, label)) {
+                return {
+                    blocked: true,
+                    reason: `Active agent already running: "${t.label}"`,
+                };
+            }
+        }
+    }
+    catch (err) {
+        log.debug(`Check 1 (active agents) failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Check 2: Recent task with same label (~5ms)
+    try {
+        const tasks = await listTasks();
+        const cutoff = Date.now() - DEDUP_RECENT_WINDOW_MS;
+        const failedCutoff = Date.now() - DEDUP_FAILED_WINDOW_MS;
+        for (const t of tasks) {
+            const ts = t.finishedAt || t.createdAt;
+            if (!ts)
+                continue;
+            const taskTime = new Date(ts).getTime();
+            if (t.status === "running" || t.status === "completed") {
+                if (taskTime < cutoff)
+                    continue;
+                if (fuzzyMatch(t.label, label)) {
+                    return {
+                        blocked: true,
+                        reason: `Recent task (${t.status}) with same label: "${t.label}"`,
+                    };
+                }
+            }
+            else if (t.status === "failed") {
+                // DASH-143: Block re-spawning recently-failed tasks — prevents
+                // rapid retry loops before cooldown manager kicks in.
+                if (taskTime < failedCutoff)
+                    continue;
+                if (fuzzyMatch(t.label, label)) {
+                    return {
+                        blocked: true,
+                        reason: `Recently failed task (cooldown active): "${t.label}"`,
+                    };
+                }
+            }
+        }
+    }
+    catch (err) {
+        log.debug(`Check 2 (recent tasks) failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Check 3: Recent agent git commits touching related files (~50ms)
+    // Only blocks on commits made by autonomous agents (contains "Auto-committed"
+    // in the git log). Human/manual commits should not prevent agents from working.
+    try {
+        const paths = extractFilePaths(prompt);
+        if (paths.length > 0) {
+            const pathArgs = paths.map((p) => `"${p}"`).join(" ");
+            const cmd = `git log --oneline --since="${GIT_LOOKBACK_MINUTES} minutes ago" --grep="Auto-committed" -- ${pathArgs}`;
+            const result = execSync(cmd, {
+                encoding: "utf-8",
+                timeout: 5000,
+                stdio: ["pipe", "pipe", "pipe"],
+            }).trim();
+            if (result.length > 0) {
+                const commitCount = result.split("\n").length;
+                const firstCommit = result.split("\n")[0];
+                return {
+                    blocked: true,
+                    reason: `${commitCount} recent agent commit(s) touching related files: ${firstCommit}`,
+                };
+            }
+        }
+    }
+    catch {
+        // Git command failed — fail open (don't block)
+        log.debug("Check 3 (git commits) failed or no git — skipping");
+    }
+    return { blocked: false };
+}
+//# sourceMappingURL=dedup-guard.js.map

package/dist/agents/dedup-guard.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,34 @@
+export type { AgentTask, AgentTaskStatus, CreateTaskInput } from "./types.js";
+export type { GcMetrics, GcPhaseTiming } from "./instance-manager.js";
+export { ensureDirs, createTask, readTask, listTasks, updateTask, readTaskOutput, } from "./store.js";
+export { cancelAgent, setOnBatchComplete, setAgentPool, hasAgentPool, isAgentsBusy, activeAgentCount } from "./spawn.js";
+export { recoverTasks, startAgentMonitor, stopAgentMonitor } from "./monitor.js";
+export { acquireLocks, releaseLocks, releaseFileLock, forceReleaseLock, listLocks, checkLocks, getLocksForAgent, pruneAllStaleLocks, type FileLock, type LockConflict, type AcquireResult, } from "./locks.js";
+export { Orchestrator, parseFilesFromOutput, type WorkflowTaskDef, type CreateWorkflowInput, type Workflow, type WorkflowTask, type WorkflowResult, type WorkflowStatus, type TaskStatus, type FileConflict, type ConflictStrategy, type ExecutionMode, type OrchestratorReport, } from "./orchestration.js";
+export { TaskCooldownManager, type CooldownConfig, type CooldownEntry, type CooldownStatus, } from "./cooldown.js";
+export { WorkflowEngine, parseWorkflowFile, type WorkflowDefinition, type StepDef, type Condition, type FailurePolicy, type WorkflowRun, type StepResult, type StepStatus, } from "./workflow.js";
+import type { CreateTaskInput, AgentTask } from "./types.js";
+/** Create a task and immediately spawn it. */
+export declare function submitTask(input: CreateTaskInput): Promise<AgentTask>;
+/** Get a single task by ID. */
+export declare function getTask(id: string): Promise<AgentTask | null>;
+/** Get task output (stdout log). */
+export declare function getTaskOutput(id: string): Promise<string>;
+/** Cancel a running task. */
+export declare function cancelTask(id: string): Promise<boolean>;
+/**
+ * Initialize: ensure directories exist.
+ * Does NOT run recovery — call recoverAndStartMonitor() after the
+ * RuntimeManager is initialized so the monitor can skip tasks it manages.
+ */
+export declare function initAgents(): Promise<void>;
+/**
+ * Recover tasks from previous session and start the monitor poll loop.
+ * Must be called AFTER createRuntime() so recoverTasks() can check the
+ * runtime registry and skip tasks that RuntimeManager already handles.
+ * This prevents the double-recovery race that caused DASH-82.
+ */
+export declare function recoverAndStartMonitor(): Promise<void>;
+/** Shutdown: stop the monitor. Does NOT kill detached processes. */
+export declare function shutdownAgents(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9E,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK7D,8CAA8C;AAC9C,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAI3E;AAED,+BAA+B;AAC/B,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAEnE;AAED,oCAAoC;AACpC,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/D;AAED,6BAA6B;AAC7B,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG5D;AAED,oEAAoE;AACpE,wBAAgB,cAAc,IAAI,IAAI,CAErC"}