@cleocode/core 2026.4.9 → 2026.4.12

package/dist/agents/health-monitor.js

@@ -0,0 +1,217 @@
+/**
+ * Agent Health Monitoring -- Heartbeat and crash detection for live agent instances.
+ *
+ * Provides the public-facing health API specified by T039:
+ *   - `recordHeartbeat`    — update last_heartbeat for a live agent
+ *   - `checkAgentHealth`   — check health of a specific agent by ID
+ *   - `detectStaleAgents`  — find agents whose heartbeat is older than threshold
+ *   - `detectCrashedAgents` — find active agents with no heartbeat for >3 min
+ *
+ * These functions delegate to the lower-level `registry.ts` primitives
+ * (`heartbeat`, `checkAgentHealth`, `listAgentInstances`) and add the
+ * named, task-spec-aligned surface required for T039.
+ *
+ * @module agents/health-monitor
+ * @task T039
+ * @epic T038
+ */
+import { heartbeat, listAgentInstances, markCrashed } from './registry.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default heartbeat interval (30 seconds) per BRAIN spec. */
+export const HEARTBEAT_INTERVAL_MS = 30_000;
+/** Default staleness threshold: 3 minutes without a heartbeat. */
+export const STALE_THRESHOLD_MS = 3 * 60_000;
+/** Statuses considered "alive" for health-check purposes. */
+const ALIVE_STATUSES = ['starting', 'active', 'idle'];
+// ============================================================================
+// recordHeartbeat
+// ============================================================================
+/**
+ * Record a heartbeat for an agent instance.
+ *
+ * Updates `last_heartbeat` to the current time and returns the agent's
+ * current {@link AgentInstanceStatus}. Returns `null` if the agent does not
+ * exist or is already in a terminal state (`stopped` / `crashed`).
+ *
+ * This is the primary mechanism by which long-running agents signal liveness.
+ * Call this every {@link HEARTBEAT_INTERVAL_MS} (30 s) from the agent loop.
+ *
+ * @param agentId - The agent instance ID (e.g. `agt_20260322120000_a1b2c3`)
+ * @param cwd - Working directory used to resolve the tasks.db path (optional)
+ * @returns The agent's current status, or `null` if not found / terminal
+ *
+ * @remarks
+ * Terminal agents (`stopped`, `crashed`) will NOT have their heartbeat
+ * updated — the existing status is returned as-is so callers can detect
+ * external shutdown signals.
+ *
+ * @example
+ * ```ts
+ * // Inside the agent's main loop:
+ * const heartbeatTimer = setInterval(async () => {
+ *   const status = await recordHeartbeat(agentId);
+ *   if (status === 'stopped' || status === null) {
+ *     // Orchestrator shut us down — exit cleanly
+ *     clearInterval(heartbeatTimer);
+ *     process.exit(0);
+ *   }
+ * }, HEARTBEAT_INTERVAL_MS);
+ * ```
+ */
+export async function recordHeartbeat(agentId, cwd) {
+    return heartbeat(agentId, cwd);
+}
+// ============================================================================
+// checkAgentHealth
+// ============================================================================
+/**
+ * Check the health of a specific agent instance by ID.
+ *
+ * Queries the agent's current record and returns a structured
+ * {@link AgentHealthStatus} describing staleness, heartbeat age, and
+ * whether the agent is considered healthy relative to `thresholdMs`.
+ *
+ * Returns `null` if the agent ID is not found in the database.
+ *
+ * @param agentId - The agent instance ID to check
+ * @param thresholdMs - Staleness threshold in milliseconds (default: 3 minutes)
+ * @param cwd - Working directory used to resolve the tasks.db path (optional)
+ * @returns {@link AgentHealthStatus} or `null` if the agent does not exist
+ *
+ * @remarks
+ * Returns null if the agent is not found. A non-null result includes
+ * staleness status based on the threshold comparison.
+ *
+ * @example
+ * ```ts
+ * const health = await checkAgentHealth('agt_20260322120000_a1b2c3');
+ * if (health && health.stale) {
+ *   console.log(`Agent stale for ${health.heartbeatAgeMs}ms — presumed crashed`);
+ * }
+ * ```
+ */
+export async function checkAgentHealth(agentId, thresholdMs = STALE_THRESHOLD_MS, cwd) {
+    const all = await listAgentInstances(undefined, cwd);
+    const agent = all.find((a) => a.id === agentId);
+    if (!agent)
+        return null;
+    return buildHealthStatus(agent, thresholdMs);
+}
+// ============================================================================
+// detectStaleAgents
+// ============================================================================
+/**
+ * Find all non-terminal agents whose last heartbeat is older than `thresholdMs`.
+ *
+ * "Stale" means an agent with status `starting`, `active`, or `idle` has
+ * not sent a heartbeat within the threshold window. This is a precursor to
+ * crash detection — a stale agent may still recover if it is under heavy load.
+ *
+ * Agents with status `stopped` or `crashed` are excluded — they are already
+ * in a terminal state and do not participate in the heartbeat protocol.
+ *
+ * @param thresholdMs - Staleness threshold in ms (default: 3 minutes / 180 000 ms)
+ * @param cwd - Working directory used to resolve the tasks.db path (optional)
+ * @returns Array of {@link AgentHealthStatus} for each stale agent, sorted by
+ *   heartbeat age descending (most-stale first)
+ *
+ * @remarks
+ * The default threshold matches the crash-detection window specified in T039:
+ * "timeout detection after 3 minutes".
+ *
+ * @example
+ * ```ts
+ * const stale = await detectStaleAgents();
+ * for (const s of stale) {
+ *   console.log(`${s.agentId} has been stale for ${s.heartbeatAgeMs / 1000}s`);
+ * }
+ * ```
+ */
+export async function detectStaleAgents(thresholdMs = STALE_THRESHOLD_MS, cwd) {
+    const agents = await listAgentInstances({ status: ALIVE_STATUSES }, cwd);
+    return agents
+        .map((a) => buildHealthStatus(a, thresholdMs))
+        .filter((s) => s.stale)
+        .sort((a, b) => b.heartbeatAgeMs - a.heartbeatAgeMs);
+}
+// ============================================================================
+// detectCrashedAgents
+// ============================================================================
+/**
+ * Find agents with status `active` whose heartbeat has been silent for
+ * longer than `thresholdMs`, and mark them as `crashed` in the database.
+ *
+ * An agent is considered crashed when it:
+ * 1. Has status `active` (not `idle`, `starting`, `stopped`, or `crashed`)
+ * 2. Has not sent a heartbeat for longer than `thresholdMs`
+ *
+ * Each detected agent is immediately marked `crashed` via {@link markCrashed},
+ * incrementing its error count and writing a reason to `agent_error_log`.
+ *
+ * @param thresholdMs - Crash threshold in ms (default: 3 minutes / 180 000 ms)
+ * @param cwd - Working directory used to resolve the tasks.db path (optional)
+ * @returns Array of agent instance rows for each agent that was just marked
+ *   `crashed`, sorted by last heartbeat ascending (oldest first).
+ *
+ * @remarks
+ * This function is WRITE-side: it mutates the database. Callers should run
+ * it on a schedule (e.g. every 60 s) from an orchestrator or health watchdog.
+ * For a read-only view, use {@link detectStaleAgents} instead.
+ *
+ * @example
+ * ```ts
+ * // Inside an orchestrator health watchdog:
+ * const crashed = await detectCrashedAgents();
+ * if (crashed.length > 0) {
+ *   logger.warn({ crashed: crashed.map(a => a.id) }, 'Agents marked crashed');
+ * }
+ * ```
+ */
+export async function detectCrashedAgents(thresholdMs = STALE_THRESHOLD_MS, cwd) {
+    // Only consider agents that are explicitly 'active' — idle/starting agents
+    // may not yet have established a regular heartbeat interval.
+    const activeAgents = await listAgentInstances({ status: 'active' }, cwd);
+    const cutoff = new Date(Date.now() - thresholdMs).toISOString();
+    const crashed = [];
+    for (const agent of activeAgents) {
+        if (agent.lastHeartbeat < cutoff) {
+            const updated = await markCrashed(agent.id, `Heartbeat timeout — no heartbeat for >${Math.round(thresholdMs / 1000)}s`, cwd);
+            if (updated) {
+                crashed.push(updated);
+            }
+        }
+    }
+    // Sort oldest-heartbeat first (most severely stale)
+    crashed.sort((a, b) => {
+        const aHb = a.lastHeartbeat ?? '';
+        const bHb = b.lastHeartbeat ?? '';
+        return aHb < bHb ? -1 : aHb > bHb ? 1 : 0;
+    });
+    return crashed;
+}
+// ============================================================================
+// Internal helpers
+// ============================================================================
+/**
+ * Build an {@link AgentHealthStatus} from a raw agent row.
+ */
+function buildHealthStatus(agent, thresholdMs) {
+    const lastHeartbeatMs = new Date(agent.lastHeartbeat).getTime();
+    const heartbeatAgeMs = Date.now() - lastHeartbeatMs;
+    const stale = ALIVE_STATUSES.includes(agent.status)
+        ? heartbeatAgeMs > thresholdMs
+        : false;
+    const healthy = !stale && ALIVE_STATUSES.includes(agent.status);
+    return {
+        agentId: agent.id,
+        status: agent.status,
+        lastHeartbeat: agent.lastHeartbeat,
+        heartbeatAgeMs,
+        healthy,
+        stale,
+        thresholdMs,
+    };
+}
+//# sourceMappingURL=health-monitor.js.map

package/dist/agents/health-monitor.js.map

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

package/dist/agents/index.js

@@ -0,0 +1,29 @@
+/**
+ * Agent dimension -- runtime tracking, health monitoring, self-healing, and capacity.
+ *
+ * This module provides the complete Agent dimension for the BRAIN specification:
+ *
+ * - **Registry**: CRUD for agent instances (register, deregister, heartbeat, queries)
+ * - **Health**: Crash detection via heartbeat protocol, health reports
+ * - **Self-Healing**: Retry with exponential backoff, crashed agent recovery
+ * - **Capacity**: Load awareness, least-loaded agent selection, overload detection
+ *
+ * @module agents
+ */
+// Load-balancing registry: task-count capacity, specializations, performance recording
+export { getAgentCapacity, getAgentSpecializations, getAgentsByCapacity, MAX_TASKS_PER_AGENT, recordAgentPerformance, updateAgentSpecializations, } from './agent-registry.js';
+// Schema & types
+export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, agentErrorLog, agentInstances, } from './agent-schema.js';
+// Capacity tracking
+export { findLeastLoadedAgent, getAvailableCapacity, getCapacitySummary, isOverloaded, updateCapacity, } from './capacity.js';
+// Execution learning, failure pattern tracking, and self-healing
+export { getAgentPerformanceHistory, getSelfHealingSuggestions, processAgentLifecycleEvent, recordAgentExecution, recordFailurePattern, storeHealingStrategy, } from './execution-learning.js';
+// Health monitoring (T039)
+export { checkAgentHealth, detectCrashedAgents, detectStaleAgents, HEARTBEAT_INTERVAL_MS, recordHeartbeat, STALE_THRESHOLD_MS, } from './health-monitor.js';
+// Registry (CRUD, heartbeat, health, errors)
+// Note: registry.checkAgentHealth (thresholdMs, cwd) -> AgentInstanceRow[] is exported
+// as findStaleAgentRows to avoid conflict with health-monitor.checkAgentHealth (T039).
+export { checkAgentHealth as findStaleAgentRows, classifyError, deregisterAgent, generateAgentId, getAgentErrorHistory, getAgentInstance, getHealthReport, heartbeat, incrementTasksCompleted, listAgentInstances, markCrashed, registerAgent, updateAgentStatus, } from './registry.js';
+// Retry & self-healing
+export { calculateDelay, createRetryPolicy, DEFAULT_RETRY_POLICY, recoverCrashedAgents, shouldRetry, withRetry, } from './retry.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,uFAAuF;AACvF,OAAO,EAGL,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,iBAAiB;AACjB,OAAO,EACL,uBAAuB,EACvB,WAAW,EAMX,aAAa,EACb,cAAc,GAGf,MAAM,mBAAmB,CAAC;AAC3B,oBAAoB;AACpB,OAAO,EAEL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,iEAAiE;AACjE,OAAO,EAIL,0BAA0B,EAC1B,yBAAyB,EAEzB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,2BAA2B;AAC3B,OAAO,EAEL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,6CAA6C;AAC7C,uFAAuF;AACvF,uFAAuF;AACvF,OAAO,EAEL,gBAAgB,IAAI,kBAAkB,EACtC,aAAa,EACb,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,uBAAuB,EAEvB,kBAAkB,EAClB,WAAW,EAEX,aAAa,EAEb,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,uBAAuB;AACvB,OAAO,EAEL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EAGpB,oBAAoB,EACpB,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/agents/registry.js

@@ -0,0 +1,314 @@
+/**
+ * Agent instance registry -- runtime tracking of live agent processes.
+ *
+ * Provides CRUD operations for the `agent_instances` table:
+ * registration, deregistration, heartbeat, status updates, and queries.
+ *
+ * This is the DB-backed runtime registry for live agent *instances*.
+ * The file-based registry in `skills/agents/registry.ts` tracks installed
+ * agent *definitions* -- those are complementary, not competing, concepts.
+ *
+ * @module agents/registry
+ */
+import { randomBytes } from 'node:crypto';
+import { and, eq, inArray, lt, sql } from 'drizzle-orm';
+import { getDb } from '../store/sqlite.js';
+import { agentErrorLog, agentInstances, } from './agent-schema.js';
+// ============================================================================
+// ID generation
+// ============================================================================
+/**
+ * Generate a unique agent instance ID.
+ * Format: `agt_{YYYYMMDDHHmmss}_{6hex}`
+ */
+export function generateAgentId() {
+    const now = new Date();
+    const ts = now.toISOString().replace(/[-:T]/g, '').substring(0, 14);
+    const hex = randomBytes(3).toString('hex');
+    return `agt_${ts}_${hex}`;
+}
+/**
+ * Register a new agent instance in the database.
+ * Sets initial status to 'starting' and records the first heartbeat.
+ */
+export async function registerAgent(opts, cwd) {
+    const db = await getDb(cwd);
+    const id = generateAgentId();
+    const now = new Date().toISOString();
+    const row = {
+        id,
+        agentType: opts.agentType,
+        status: 'starting',
+        sessionId: opts.sessionId ?? null,
+        taskId: opts.taskId ?? null,
+        startedAt: now,
+        lastHeartbeat: now,
+        stoppedAt: null,
+        errorCount: 0,
+        totalTasksCompleted: 0,
+        capacity: '1.0',
+        metadataJson: opts.metadata ? JSON.stringify(opts.metadata) : '{}',
+        parentAgentId: opts.parentAgentId ?? null,
+    };
+    await db.insert(agentInstances).values(row);
+    return row;
+}
+/**
+ * Deregister (stop) an agent instance.
+ * Sets status to 'stopped' and records the stop timestamp.
+ */
+export async function deregisterAgent(id, cwd) {
+    const db = await getDb(cwd);
+    const now = new Date().toISOString();
+    const existing = await db.select().from(agentInstances).where(eq(agentInstances.id, id)).get();
+    if (!existing)
+        return null;
+    // Already stopped -- idempotent
+    if (existing.status === 'stopped')
+        return existing;
+    await db
+        .update(agentInstances)
+        .set({ status: 'stopped', stoppedAt: now })
+        .where(eq(agentInstances.id, id));
+    return { ...existing, status: 'stopped', stoppedAt: now };
+}
+// ============================================================================
+// Heartbeat
+// ============================================================================
+/**
+ * Record a heartbeat for an agent instance.
+ * Updates `last_heartbeat` and returns the current status so the agent
+ * can detect if it has been externally marked for shutdown.
+ */
+export async function heartbeat(id, cwd) {
+    const db = await getDb(cwd);
+    const now = new Date().toISOString();
+    const existing = await db.select().from(agentInstances).where(eq(agentInstances.id, id)).get();
+    if (!existing)
+        return null;
+    // Do not update heartbeat for terminal states
+    if (existing.status === 'stopped' || existing.status === 'crashed') {
+        return existing.status;
+    }
+    await db.update(agentInstances).set({ lastHeartbeat: now }).where(eq(agentInstances.id, id));
+    return existing.status;
+}
+/**
+ * Update agent status with optional error tracking.
+ * When status is 'error' or 'crashed', increments the error count
+ * and logs the error to the agent_error_log table.
+ */
+export async function updateAgentStatus(id, opts, cwd) {
+    const db = await getDb(cwd);
+    const existing = await db.select().from(agentInstances).where(eq(agentInstances.id, id)).get();
+    if (!existing)
+        return null;
+    const updates = {
+        status: opts.status,
+    };
+    if (opts.taskId !== undefined) {
+        updates.taskId = opts.taskId;
+    }
+    // If transitioning to active, update heartbeat
+    if (opts.status === 'active') {
+        updates.lastHeartbeat = new Date().toISOString();
+    }
+    // Track errors
+    if (opts.status === 'error' || opts.status === 'crashed') {
+        updates.errorCount = existing.errorCount + 1;
+        if (opts.error) {
+            const errorType = classifyError(new Error(opts.error));
+            await db.insert(agentErrorLog).values({
+                agentId: id,
+                errorType,
+                message: opts.error,
+                occurredAt: new Date().toISOString(),
+            });
+        }
+    }
+    // If stopped, set stoppedAt
+    if (opts.status === 'stopped') {
+        updates.stoppedAt = new Date().toISOString();
+    }
+    await db.update(agentInstances).set(updates).where(eq(agentInstances.id, id));
+    return { ...existing, ...updates };
+}
+/**
+ * Increment the completed task count for an agent.
+ */
+export async function incrementTasksCompleted(id, cwd) {
+    const db = await getDb(cwd);
+    await db
+        .update(agentInstances)
+        .set({ totalTasksCompleted: sql `${agentInstances.totalTasksCompleted} + 1` })
+        .where(eq(agentInstances.id, id));
+}
+/**
+ * List agent instances with optional filters.
+ */
+export async function listAgentInstances(filters, cwd) {
+    const db = await getDb(cwd);
+    const conditions = [];
+    if (filters?.status) {
+        const statuses = Array.isArray(filters.status) ? filters.status : [filters.status];
+        conditions.push(inArray(agentInstances.status, statuses));
+    }
+    if (filters?.agentType) {
+        const types = Array.isArray(filters.agentType) ? filters.agentType : [filters.agentType];
+        conditions.push(inArray(agentInstances.agentType, types));
+    }
+    if (filters?.sessionId) {
+        conditions.push(eq(agentInstances.sessionId, filters.sessionId));
+    }
+    if (filters?.parentAgentId) {
+        conditions.push(eq(agentInstances.parentAgentId, filters.parentAgentId));
+    }
+    if (conditions.length === 0) {
+        return db.select().from(agentInstances).all();
+    }
+    return db
+        .select()
+        .from(agentInstances)
+        .where(and(...conditions))
+        .all();
+}
+/**
+ * Get a single agent instance by ID.
+ */
+export async function getAgentInstance(id, cwd) {
+    const db = await getDb(cwd);
+    const row = await db.select().from(agentInstances).where(eq(agentInstances.id, id)).get();
+    return row ?? null;
+}
+// ============================================================================
+// Error classification
+// ============================================================================
+/** Patterns indicating retriable errors. */
+const RETRIABLE_PATTERNS = [
+    /timeout/i,
+    /ECONNREFUSED/,
+    /ECONNRESET/,
+    /EPIPE/,
+    /ETIMEDOUT/,
+    /rate.?limit/i,
+    /429/,
+    /503/,
+    /502/,
+    /SQLITE_BUSY/i,
+    /database is locked/i,
+    /temporarily unavailable/i,
+    /too many requests/i,
+    /network/i,
+    /socket hang up/i,
+];
+/** Patterns indicating permanent (non-retriable) errors. */
+const PERMANENT_PATTERNS = [
+    /permission denied/i,
+    /EACCES/,
+    /authentication/i,
+    /unauthorized/i,
+    /401/,
+    /403/,
+    /404/,
+    /not found/i,
+    /invalid.*token/i,
+    /SQLITE_CONSTRAINT/i,
+    /syntax error/i,
+    /type error/i,
+    /reference error/i,
+];
+/**
+ * Classify an error as retriable, permanent, or unknown.
+ *
+ * Retriable errors are transient conditions (network, rate limits, locks)
+ * where a retry may succeed. Permanent errors are structural (auth,
+ * not found, constraint violations) where retrying is pointless.
+ */
+export function classifyError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    for (const pattern of RETRIABLE_PATTERNS) {
+        if (pattern.test(message))
+            return 'retriable';
+    }
+    for (const pattern of PERMANENT_PATTERNS) {
+        if (pattern.test(message))
+            return 'permanent';
+    }
+    return 'unknown';
+}
+/**
+ * Get the error history for a specific agent.
+ */
+export async function getAgentErrorHistory(agentId, cwd) {
+    const db = await getDb(cwd);
+    return db.select().from(agentErrorLog).where(eq(agentErrorLog.agentId, agentId)).all();
+}
+// ============================================================================
+// Health Monitoring
+// ============================================================================
+/**
+ * Check agent health by finding instances whose last heartbeat exceeds the threshold.
+ * Default threshold: 30000ms (30 seconds) as specified by the BRAIN spec.
+ *
+ * Returns agents that appear to have crashed (stale heartbeat).
+ */
+export async function checkAgentHealth(thresholdMs = 30_000, cwd) {
+    const db = await getDb(cwd);
+    const cutoff = new Date(Date.now() - thresholdMs).toISOString();
+    return db
+        .select()
+        .from(agentInstances)
+        .where(and(inArray(agentInstances.status, ['active', 'idle', 'starting']), lt(agentInstances.lastHeartbeat, cutoff)))
+        .all();
+}
+/**
+ * Mark an agent instance as crashed.
+ * Increments error count and sets status to 'crashed'.
+ */
+export async function markCrashed(id, reason, cwd) {
+    return updateAgentStatus(id, { status: 'crashed', error: reason ?? 'Heartbeat timeout — agent presumed crashed' }, cwd);
+}
+/**
+ * Generate a health report summarizing all agent instances.
+ * Includes counts by status and identifies stale agents.
+ */
+export async function getHealthReport(thresholdMs = 30_000, cwd) {
+    const allAgents = await listAgentInstances(undefined, cwd);
+    const staleAgents = await checkAgentHealth(thresholdMs, cwd);
+    const report = {
+        total: allAgents.length,
+        active: 0,
+        idle: 0,
+        starting: 0,
+        error: 0,
+        crashed: 0,
+        stopped: 0,
+        totalErrors: 0,
+        staleAgents,
+    };
+    for (const agent of allAgents) {
+        switch (agent.status) {
+            case 'active':
+                report.active++;
+                break;
+            case 'idle':
+                report.idle++;
+                break;
+            case 'starting':
+                report.starting++;
+                break;
+            case 'error':
+                report.error++;
+                break;
+            case 'crashed':
+                report.crashed++;
+                break;
+            case 'stopped':
+                report.stopped++;
+                break;
+        }
+        report.totalErrors += agent.errorCount;
+    }
+    return report;
+}
+//# sourceMappingURL=registry.js.map

package/dist/agents/registry.js.map

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