@cleocode/core 2026.4.41 → 2026.4.43

package/dist/agents/agent-schema.js

@@ -1,82 +0,0 @@
-/**
- * Drizzle ORM schema for the CLEO Agent dimension.
- *
- * Defines the `agent_instances` table that tracks live agent processes,
- * their health (heartbeat protocol), capacity, and error history.
- *
- * This is the DB-backed runtime registry -- distinct from the file-based
- * skill agent registry in `skills/agents/registry.ts` which tracks
- * installed agent *definitions*. This table tracks running agent *instances*.
- *
- * @module agents/agent-schema
- */
-import { sql } from 'drizzle-orm';
-import { index, integer, sqliteTable, text } from 'drizzle-orm/sqlite-core';
-// ============================================================================
-// Canonical enum constants
-// ============================================================================
-/** Agent instance status values matching DB CHECK constraint. */
-export const AGENT_INSTANCE_STATUSES = [
-    'starting',
-    'active',
-    'idle',
-    'error',
-    'crashed',
-    'stopped',
-];
-/** Agent type values for classification. */
-export const AGENT_TYPES = [
-    'orchestrator',
-    'executor',
-    'researcher',
-    'architect',
-    'validator',
-    'documentor',
-    'custom',
-];
-// ============================================================================
-// Agent Instances Table
-// ============================================================================
-export const agentInstances = sqliteTable('agent_instances', {
-    id: text('id').primaryKey(),
-    agentType: text('agent_type', { enum: AGENT_TYPES }).notNull(),
-    status: text('status', { enum: AGENT_INSTANCE_STATUSES }).notNull().default('starting'),
-    // Soft references — no DB-level FK (SQLite cannot ALTER TABLE ADD CONSTRAINT).
-    // Application-layer validation via agentExistsInSignaldockDb (T238).
-    sessionId: text('session_id'),
-    taskId: text('task_id'),
-    startedAt: text('started_at').notNull().default(sql `(datetime('now'))`),
-    lastHeartbeat: text('last_heartbeat').notNull().default(sql `(datetime('now'))`),
-    stoppedAt: text('stopped_at'),
-    errorCount: integer('error_count').notNull().default(0),
-    totalTasksCompleted: integer('total_tasks_completed').notNull().default(0),
-    capacity: text('capacity').notNull().default('1.0'),
-    metadataJson: text('metadata_json').default('{}'),
-    parentAgentId: text('parent_agent_id'),
-}, (table) => [
-    index('idx_agent_instances_status').on(table.status),
-    index('idx_agent_instances_agent_type').on(table.agentType),
-    index('idx_agent_instances_session_id').on(table.sessionId),
-    index('idx_agent_instances_task_id').on(table.taskId),
-    index('idx_agent_instances_parent_agent_id').on(table.parentAgentId),
-    index('idx_agent_instances_last_heartbeat').on(table.lastHeartbeat),
-]);
-// ============================================================================
-// Agent Error Log Table
-// ============================================================================
-export const agentErrorLog = sqliteTable('agent_error_log', {
-    id: integer('id').primaryKey({ autoIncrement: true }),
-    agentId: text('agent_id').notNull(),
-    errorType: text('error_type', {
-        enum: ['retriable', 'permanent', 'unknown'],
-    }).notNull(),
-    message: text('message').notNull(),
-    stack: text('stack'),
-    occurredAt: text('occurred_at').notNull().default(sql `(datetime('now'))`),
-    resolved: integer('resolved', { mode: 'boolean' }).notNull().default(false),
-}, (table) => [
-    index('idx_agent_error_log_agent_id').on(table.agentId),
-    index('idx_agent_error_log_error_type').on(table.errorType),
-    index('idx_agent_error_log_occurred_at').on(table.occurredAt),
-]);
-//# sourceMappingURL=agent-schema.js.map

package/dist/agents/agent-schema.js.map

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

package/dist/agents/capacity.js

@@ -1,116 +0,0 @@
-/**
- * Capacity tracking and load balancing for the Agent dimension.
- *
- * Tracks per-agent capacity (0.0-1.0) and provides queries for
- * capacity-aware work distribution.
- *
- * @module agents/capacity
- */
-import { eq } from 'drizzle-orm';
-import { getDb } from '../store/sqlite.js';
-import { agentInstances } from './agent-schema.js';
-import { listAgentInstances } from './registry.js';
-// ============================================================================
-// Capacity Updates
-// ============================================================================
-/**
- * Update the capacity value for an agent instance.
- *
- * @param id - Agent instance ID
- * @param capacity - New capacity value (0.0 to 1.0)
- * @param cwd - Working directory
- * @returns Updated agent row, or null if not found
- */
-export async function updateCapacity(id, capacity, cwd) {
-    if (capacity < 0 || capacity > 1) {
-        throw new Error(`Capacity must be between 0.0 and 1.0, got ${capacity}`);
-    }
-    const db = await getDb(cwd);
-    const existing = await db.select().from(agentInstances).where(eq(agentInstances.id, id)).get();
-    if (!existing)
-        return null;
-    const capacityStr = capacity.toFixed(4);
-    await db.update(agentInstances).set({ capacity: capacityStr }).where(eq(agentInstances.id, id));
-    return { ...existing, capacity: capacityStr };
-}
-// ============================================================================
-// Capacity Queries
-// ============================================================================
-/**
- * Get the total available capacity across all active agents.
- *
- * Only considers agents in 'active' or 'idle' status.
- * Returns the sum of all capacity values.
- */
-export async function getAvailableCapacity(cwd) {
-    const agents = await listAgentInstances({ status: ['active', 'idle'] }, cwd);
-    return agents.reduce((sum, agent) => sum + parseCapacity(agent.capacity), 0);
-}
-/**
- * Find the agent with the most available capacity.
- *
- * @param agentType - Optional type filter
- * @param cwd - Working directory
- * @returns Agent with highest capacity, or null if no active agents
- */
-export async function findLeastLoadedAgent(agentType, cwd) {
-    const filters = agentType
-        ? { status: ['active', 'idle'], agentType }
-        : { status: ['active', 'idle'] };
-    const agents = await listAgentInstances(filters, cwd);
-    if (agents.length === 0)
-        return null;
-    let best = agents[0];
-    let bestCapacity = parseCapacity(best.capacity);
-    for (let i = 1; i < agents.length; i++) {
-        const cap = parseCapacity(agents[i].capacity);
-        if (cap > bestCapacity) {
-            best = agents[i];
-            bestCapacity = cap;
-        }
-    }
-    return best;
-}
-/**
- * Check if the system is overloaded (total capacity below threshold).
- *
- * @param threshold - Minimum acceptable capacity (default: 0.1)
- * @param cwd - Working directory
- * @returns true if total available capacity is below the threshold
- */
-export async function isOverloaded(threshold = 0.1, cwd) {
-    const capacity = await getAvailableCapacity(cwd);
-    return capacity < threshold;
-}
-/**
- * Get a capacity summary across the entire agent pool.
- *
- * @param threshold - Overload threshold (default: 0.1)
- * @param cwd - Working directory
- */
-export async function getCapacitySummary(threshold = 0.1, cwd) {
-    const agents = await listAgentInstances({ status: ['active', 'idle'] }, cwd);
-    const totalCapacity = agents.reduce((sum, a) => sum + parseCapacity(a.capacity), 0);
-    const activeAgentCount = agents.length;
-    return {
-        totalCapacity,
-        activeAgentCount,
-        averageCapacity: activeAgentCount > 0 ? totalCapacity / activeAgentCount : 0,
-        overloaded: totalCapacity < threshold,
-        threshold,
-    };
-}
-// ============================================================================
-// Utilities
-// ============================================================================
-/**
- * Parse a capacity string to a number.
- * The DB stores capacity as TEXT to avoid floating-point representation issues.
- */
-function parseCapacity(value) {
-    if (!value)
-        return 0;
-    const parsed = parseFloat(value);
-    return Number.isNaN(parsed) ? 0 : Math.max(0, Math.min(1, parsed));
-}
-//# sourceMappingURL=capacity.js.map

package/dist/agents/capacity.js.map

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

package/dist/agents/execution-learning.js

@@ -1,474 +0,0 @@
-/**
- * Agent Execution Learning — Agent dimension BRAIN integration.
- *
- * Tracks which agent types succeed or fail on which task types, logs agent
- * decisions to brain_decisions with structured context, provides queries to
- * retrieve agent performance history, and implements basic self-healing by
- * recording failure patterns as brain_observations and surfacing healing
- * suggestions when the same failure pattern recurs.
- *
- * This module bridges the agent registry (tasks.db) with the cognitive
- * memory layer (brain.db) without introducing circular dependencies:
- * - Tasks.db agent tables: agent_instances, agent_error_log (agent-schema.ts)
- * - Brain.db tables: brain_decisions, brain_patterns, brain_observations
- *
- * All brain.db writes are best-effort — failures are silently swallowed so
- * agent lifecycle events never fail due to a brain.db write error.
- *
- * @module agents/execution-learning
- * @task T034
- * @epic T029
- */
-import { randomBytes } from 'node:crypto';
-import { getBrainAccessor } from '../store/brain-accessor.js';
-// ============================================================================
-// ID generation helpers
-// ============================================================================
-/** Generate a unique brain_decisions ID with `AGT-` prefix. */
-function generateDecisionId() {
-    return `AGT-${randomBytes(5).toString('hex')}`;
-}
-/** Generate a unique brain_patterns ID with `P-agt-` prefix. */
-function generatePatternId() {
-    return `P-agt-${randomBytes(4).toString('hex')}`;
-}
-/** Generate a unique brain_observations ID with `O-agt-` prefix. */
-function generateObservationId() {
-    return `O-agt-${randomBytes(4).toString('hex')}`;
-}
-/** Normalised ISO timestamp in SQLite-friendly format (space separator). */
-function nowSql() {
-    return new Date().toISOString().replace('T', ' ').slice(0, 19);
-}
-// ============================================================================
-// Execution event logging
-// ============================================================================
-/**
- * Record an agent execution event to brain_decisions.
- *
- * Each event becomes a `tactical` decision entry describing which agent type
- * handled which task type and whether it succeeded. This gives the BRAIN
- * system a queryable history of agent-task execution for pattern extraction.
- *
- * The call is best-effort — if brain.db is unavailable the error is swallowed
- * and null is returned so agent lifecycle code is never disrupted.
- *
- * @param event - Execution event to record
- * @param cwd - Working directory (resolves brain.db path)
- * @returns The stored decision row, or null on failure
- */
-export async function recordAgentExecution(event, cwd) {
-    try {
-        const brain = await getBrainAccessor(cwd);
-        return await _recordAgentExecutionWithAccessor(event, brain);
-    }
-    catch {
-        // Best-effort — never propagate brain.db write failures to callers
-        return null;
-    }
-}
-/**
- * Internal implementation that accepts a pre-constructed accessor.
- * Separated for testability without touching the real file system.
- *
- * @internal
- */
-export async function _recordAgentExecutionWithAccessor(event, brain) {
-    const id = generateDecisionId();
-    const outcomeMap = {
-        success: 'success',
-        failure: 'failure',
-        partial: 'mixed',
-    };
-    const decisionText = `Agent type "${event.agentType}" ${event.outcome === 'success' ? 'successfully completed' : `failed (${event.errorType ?? 'unknown'}) on`} task ${event.taskId} (type: ${event.taskType})`;
-    const rationale = [
-        `Agent: ${event.agentId}`,
-        `Task type: ${event.taskType}`,
-        `Outcome: ${event.outcome}`,
-        event.taskLabels?.length ? `Labels: ${event.taskLabels.join(', ')}` : null,
-        event.errorMessage ? `Error: ${event.errorMessage}` : null,
-        event.durationMs != null ? `Duration: ${event.durationMs}ms` : null,
-    ]
-        .filter(Boolean)
-        .join(' | ');
-    const alternativesJson = JSON.stringify({
-        agentId: event.agentId,
-        agentType: event.agentType,
-        taskType: event.taskType,
-        taskLabels: event.taskLabels ?? [],
-        errorType: event.errorType ?? null,
-        durationMs: event.durationMs ?? null,
-        sessionId: event.sessionId ?? null,
-    });
-    const row = await brain.addDecision({
-        id,
-        type: 'tactical',
-        decision: decisionText,
-        rationale,
-        confidence: event.outcome === 'success' ? 'high' : event.outcome === 'partial' ? 'medium' : 'low',
-        outcome: outcomeMap[event.outcome],
-        alternativesJson,
-        contextTaskId: event.taskId,
-        contextEpicId: null,
-        contextPhase: null,
-        createdAt: nowSql(),
-        updatedAt: null,
-    });
-    return row;
-}
-// ============================================================================
-// Performance queries
-// ============================================================================
-/**
- * Retrieve agent execution performance history from brain_decisions.
- *
- * Queries all `tactical` decisions recorded by `recordAgentExecution` and
- * aggregates them into per-(agentType, taskType) performance summaries.
- *
- * @param filters - Optional filters to narrow results
- * @param cwd - Working directory
- * @returns Array of performance summaries sorted by agentType then taskType
- */
-export async function getAgentPerformanceHistory(filters = {}, cwd) {
-    try {
-        const brain = await getBrainAccessor(cwd);
-        return await _getAgentPerformanceHistoryWithAccessor(filters, brain);
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Internal implementation with injected accessor for testability.
- *
- * @internal
- */
-export async function _getAgentPerformanceHistoryWithAccessor(filters, brain) {
-    const decisions = await brain.findDecisions({
-        type: 'tactical',
-        limit: filters.limit ?? 500,
-    });
-    // Only process rows that were written by recordAgentExecution
-    const agentDecisions = decisions.filter((d) => d.id.startsWith('AGT-'));
-    // Aggregate per (agentType, taskType)
-    const buckets = new Map();
-    for (const d of agentDecisions) {
-        let meta = {};
-        try {
-            meta = d.alternativesJson ? JSON.parse(d.alternativesJson) : {};
-        }
-        catch {
-            continue;
-        }
-        const agentType = meta.agentType;
-        const taskType = meta.taskType;
-        if (!agentType || !taskType)
-            continue;
-        // Apply optional filters
-        if (filters.agentType && agentType !== filters.agentType)
-            continue;
-        if (filters.taskType && taskType !== filters.taskType)
-            continue;
-        const key = `${agentType}::${taskType}`;
-        const existing = buckets.get(key) ?? {
-            agentType,
-            taskType,
-            successes: 0,
-            failures: 0,
-            total: 0,
-            lastOutcome: null,
-            lastSeenAt: null,
-        };
-        existing.total += 1;
-        const outcome = d.outcome;
-        if (outcome === 'success') {
-            existing.successes += 1;
-            existing.lastOutcome = 'success';
-        }
-        else if (outcome === 'failure') {
-            existing.failures += 1;
-            existing.lastOutcome = 'failure';
-        }
-        else if (outcome === 'mixed') {
-            existing.lastOutcome = 'partial';
-        }
-        // Track most-recent timestamp
-        if (!existing.lastSeenAt || (d.createdAt && d.createdAt > existing.lastSeenAt)) {
-            existing.lastSeenAt = d.createdAt;
-        }
-        buckets.set(key, existing);
-    }
-    return Array.from(buckets.values())
-        .map((b) => ({
-        agentType: b.agentType,
-        taskType: b.taskType,
-        totalAttempts: b.total,
-        successCount: b.successes,
-        failureCount: b.failures,
-        successRate: b.total > 0 ? Math.round((b.successes / b.total) * 1000) / 1000 : 0,
-        lastOutcome: b.lastOutcome,
-        lastSeenAt: b.lastSeenAt,
-    }))
-        .sort((a, b) => a.agentType.localeCompare(b.agentType) || a.taskType.localeCompare(b.taskType));
-}
-// ============================================================================
-// Failure pattern recording
-// ============================================================================
-/**
- * Record a task failure pattern to brain_patterns.
- *
- * When a task fails, the (agentType, taskType, errorType) combination is
- * stored as a `failure` pattern in brain.db. On subsequent failures matching
- * the same combination, the frequency counter is incremented and the success
- * rate updated. This data is what powers `getSelfHealingSuggestions`.
- *
- * The call is best-effort and never throws.
- *
- * @param event - A failure execution event (outcome must be 'failure')
- * @param cwd - Working directory
- * @returns The upserted pattern row, or null on error
- */
-export async function recordFailurePattern(event, cwd) {
-    if (event.outcome !== 'failure')
-        return null;
-    try {
-        const brain = await getBrainAccessor(cwd);
-        return await _recordFailurePatternWithAccessor(event, brain);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Internal implementation with injected accessor.
- *
- * @internal
- */
-export async function _recordFailurePatternWithAccessor(event, brain) {
-    const errorType = event.errorType ?? 'unknown';
-    const patternText = `Agent type "${event.agentType}" fails on task type "${event.taskType}" with ${errorType} error`;
-    const contextText = `Failure pattern detected: ${event.agentType} agent encountering ${errorType} errors on ${event.taskType} tasks`;
-    // Look for an existing matching pattern (search by prefix naming convention)
-    const existing = await brain.findPatterns({ type: 'failure', limit: 200 });
-    const match = existing.find((p) => p.pattern === patternText);
-    if (match) {
-        // Update frequency counter and keep success_rate at 0 (all failures)
-        const newFrequency = match.frequency + 1;
-        const suggestion = buildHealingSuggestion(event.agentType, event.taskType, errorType, newFrequency);
-        await brain.updatePattern(match.id, {
-            frequency: newFrequency,
-            successRate: 0,
-            mitigation: suggestion,
-        });
-        return {
-            ...match,
-            frequency: newFrequency,
-            successRate: 0,
-            mitigation: suggestion,
-        };
-    }
-    // Create new failure pattern
-    const id = generatePatternId();
-    const now = nowSql();
-    const suggestion = buildHealingSuggestion(event.agentType, event.taskType, errorType, 1);
-    return brain.addPattern({
-        id,
-        type: 'failure',
-        pattern: patternText,
-        context: contextText,
-        frequency: 1,
-        successRate: 0,
-        impact: 'medium',
-        antiPattern: `${event.agentType} assigned to ${event.taskType} task with ${errorType} error risk`,
-        mitigation: suggestion,
-        examplesJson: JSON.stringify([event.taskId]),
-        extractedAt: now,
-        updatedAt: null,
-    });
-}
-// ============================================================================
-// Self-healing: observation storage
-// ============================================================================
-/**
- * Store a healing strategy observation to brain_observations.
- *
- * When a failure pattern reaches a significant frequency threshold (≥ 3),
- * a `change` observation is recorded to represent the healing action
- * recommended for future recurrences of the same pattern.
- *
- * The call is best-effort and never throws.
- *
- * @param event - The failure event that triggered healing
- * @param strategy - Human-readable healing strategy description
- * @param cwd - Working directory
- * @returns The stored observation row, or null on error
- */
-export async function storeHealingStrategy(event, strategy, cwd) {
-    if (event.outcome !== 'failure')
-        return null;
-    try {
-        const brain = await getBrainAccessor(cwd);
-        return await _storeHealingStrategyWithAccessor(event, strategy, brain);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Internal implementation with injected accessor.
- *
- * @internal
- */
-export async function _storeHealingStrategyWithAccessor(event, strategy, brain) {
-    const id = generateObservationId();
-    const now = nowSql();
-    return brain.addObservation({
-        id,
-        type: 'change',
-        title: `Healing strategy: ${event.agentType} on ${event.taskType}`,
-        subtitle: `Error type: ${event.errorType ?? 'unknown'}`,
-        narrative: strategy,
-        factsJson: JSON.stringify([
-            `Agent: ${event.agentType}`,
-            `Task type: ${event.taskType}`,
-            `Error: ${event.errorMessage ?? 'unspecified'}`,
-            `Suggested action: ${strategy}`,
-        ]),
-        conceptsJson: JSON.stringify([
-            'self-healing',
-            'agent-execution',
-            event.agentType,
-            event.taskType,
-        ]),
-        project: null,
-        filesReadJson: null,
-        filesModifiedJson: null,
-        sourceSessionId: event.sessionId ?? null,
-        sourceType: 'agent',
-        contentHash: null,
-        discoveryTokens: null,
-        createdAt: now,
-        updatedAt: null,
-    });
-}
-// ============================================================================
-// Self-healing: suggestion retrieval
-// ============================================================================
-/**
- * Get self-healing suggestions for a given agent type and task type.
- *
- * Queries brain_patterns for known failure patterns matching the
- * (agentType, taskType) combination and returns healing suggestions
- * ordered by frequency (most-seen first).
- *
- * Returns an empty array if no failure patterns are found or brain.db
- * is unavailable.
- *
- * @param agentType - The agent type to check
- * @param taskType - The task type to check
- * @param cwd - Working directory
- * @returns Array of healing suggestions, highest frequency first
- */
-export async function getSelfHealingSuggestions(agentType, taskType, cwd) {
-    try {
-        const brain = await getBrainAccessor(cwd);
-        return await _getSelfHealingSuggestionsWithAccessor(agentType, taskType, brain);
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Internal implementation with injected accessor.
- *
- * @internal
- */
-export async function _getSelfHealingSuggestionsWithAccessor(agentType, taskType, brain) {
-    const patterns = await brain.findPatterns({ type: 'failure', limit: 200 });
-    const prefix = `Agent type "${agentType}" fails on task type "${taskType}"`;
-    const matches = patterns.filter((p) => p.pattern.startsWith(prefix) && p.mitigation);
-    return matches
-        .map((p) => ({
-        patternId: p.id,
-        failurePattern: p.pattern,
-        frequency: p.frequency,
-        suggestion: p.mitigation,
-        confidence: Math.min(0.3 + p.frequency * 0.1, 0.9),
-    }))
-        .sort((a, b) => b.frequency - a.frequency);
-}
-// ============================================================================
-// Compound: record event + update patterns + suggest healing
-// ============================================================================
-/**
- * Full agent lifecycle event processor.
- *
- * Convenience function that:
- * 1. Records the execution event to brain_decisions
- * 2. On failure: records/updates the failure pattern in brain_patterns
- * 3. On failure with frequency ≥ 3: stores a healing strategy observation
- *
- * Returns a structured result with the recorded IDs and any healing
- * suggestions that now apply.
- *
- * All operations are best-effort — the call never throws.
- *
- * @param event - The execution event
- * @param cwd - Working directory
- */
-export async function processAgentLifecycleEvent(event, cwd) {
-    const result = {
-        decisionId: null,
-        patternId: null,
-        observationId: null,
-        healingSuggestions: [],
-    };
-    try {
-        const brain = await getBrainAccessor(cwd);
-        // 1. Record decision
-        const decision = await _recordAgentExecutionWithAccessor(event, brain);
-        if (decision)
-            result.decisionId = decision.id;
-        // 2. On failure: record/update failure pattern
-        if (event.outcome === 'failure') {
-            const pattern = await _recordFailurePatternWithAccessor(event, brain);
-            if (pattern) {
-                result.patternId = pattern.id;
-                // 3. When pattern is well-established, store a healing strategy observation
-                if (pattern.frequency >= 3 && pattern.mitigation) {
-                    const obs = await _storeHealingStrategyWithAccessor(event, pattern.mitigation, brain);
-                    if (obs)
-                        result.observationId = obs.id;
-                }
-            }
-        }
-        // 4. Retrieve current suggestions (applies to all outcomes — useful for
-        //    monitoring even successful retries of previously-failing patterns)
-        if (event.outcome !== 'success') {
-            result.healingSuggestions = await _getSelfHealingSuggestionsWithAccessor(event.agentType, event.taskType, brain);
-        }
-    }
-    catch {
-        // Best-effort — never propagate failures
-    }
-    return result;
-}
-// ============================================================================
-// Internal: healing suggestion builder
-// ============================================================================
-/**
- * Build a human-readable healing mitigation string for a failure pattern.
- */
-function buildHealingSuggestion(agentType, taskType, errorType, frequency) {
-    if (errorType === 'retriable') {
-        return `Retry with exponential backoff. Consider switching to a different ${agentType} agent instance if failures exceed threshold (seen ${frequency}x).`;
-    }
-    if (errorType === 'permanent') {
-        return `Reassign task to a different agent type — ${agentType} has a permanent failure on ${taskType} tasks. Check permissions, inputs, and dependencies (seen ${frequency}x).`;
-    }
-    if (frequency >= 5) {
-        return `High-frequency unknown failure (${frequency}x): escalate to orchestrator for manual investigation of ${agentType} on ${taskType} tasks.`;
-    }
-    return `Unknown failure for ${agentType} on ${taskType} tasks (${frequency}x). Check agent logs, retry with fresh context, or reassign to a different agent type.`;
-}
-//# sourceMappingURL=execution-learning.js.map