agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/coordination/swarm-completion.js

@@ -0,0 +1,368 @@
+/**
+ * Swarm Completion Coordinator (ADR-058)
+ *
+ * Tracks swarm task completion state and provides programmatic API
+ * for the Autopilot persistent completion loop. Integrates with
+ * the self-improvement pipeline for learning from completion patterns.
+ */
+import { DriftDetector } from './drift-detector.js';
+const DEFAULT_CONFIG = {
+    maxIterations: 50,
+    timeoutMinutes: 240,
+    enabled: true,
+};
+export class SwarmCompletionCoordinator {
+    tasks = new Map();
+    iterations = 0;
+    startTime = Date.now();
+    config;
+    completionHistory = [];
+    driftDetector;
+    sessionId;
+    lastDriftCheck = 0;
+    learningInitialized = false;
+    learning = null; // AutopilotLearning (lazy loaded)
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.driftDetector = new DriftDetector();
+        this.sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    }
+    /**
+     * Register a task for completion tracking.
+     */
+    addTask(task) {
+        this.tasks.set(task.id, { ...task, createdAt: task.createdAt || Date.now() });
+    }
+    /**
+     * Bulk register tasks.
+     */
+    addTasks(tasks) {
+        for (const task of tasks) {
+            this.addTask(task);
+        }
+    }
+    /**
+     * Update task status with optional agent tracking for drift detection.
+     */
+    updateTask(taskId, status, agentId) {
+        const task = this.tasks.get(taskId);
+        if (task) {
+            const previousOwner = task.owner;
+            task.status = status;
+            if (agentId)
+                task.owner = agentId;
+            if (status === 'completed') {
+                task.completedAt = Date.now();
+                this.completionHistory.push({
+                    taskId,
+                    duration: task.completedAt - (task.createdAt || this.startTime),
+                    iterations: this.iterations,
+                });
+                // Record success episode if learning available
+                if (this.learning) {
+                    this.learning.recordTaskCompletion({
+                        taskId,
+                        subject: task.subject,
+                        status: 'completed',
+                        iterations: this.iterations,
+                        durationMs: task.completedAt - (task.createdAt || this.startTime),
+                    }).catch(() => { });
+                }
+            }
+            else if (status === 'blocked' || status === 'pending') {
+                // Track failures for drift detection
+                this.driftDetector.recordTaskFailure(taskId);
+                if (this.learning) {
+                    this.learning.recordTaskFailure({
+                        taskId,
+                        subject: task.subject,
+                        status,
+                        iterations: this.iterations,
+                        durationMs: Date.now() - (task.createdAt || this.startTime),
+                    }).catch(() => { });
+                }
+            }
+            // Track reassignments
+            if (agentId && previousOwner && agentId !== previousOwner) {
+                this.driftDetector.recordAgentReassignment(taskId, previousOwner, agentId);
+            }
+        }
+    }
+    /**
+     * Remove a task from tracking.
+     */
+    removeTask(taskId) {
+        this.tasks.delete(taskId);
+    }
+    /**
+     * Increment iteration counter, run drift detection, and return current state.
+     * Called by the Stop hook on each re-engagement cycle.
+     */
+    tick() {
+        this.iterations++;
+        const state = this.getState();
+        // Record iteration for drift detection
+        this.driftDetector.recordIteration({ completed: state.completed });
+        // Check for drift every 3+ iterations since last check
+        if (this.iterations - this.lastDriftCheck >= 3) {
+            const signals = this.driftDetector.detectDrift();
+            if (signals.length > 0) {
+                this.applyMitigation(signals);
+            }
+            this.lastDriftCheck = this.iterations;
+            // Record SONA trajectory step if learning available
+            if (this.learning) {
+                this.learning.recordIterationStep(state, signals).catch(() => { });
+            }
+        }
+        return state;
+    }
+    /**
+     * Get current completion state without incrementing iterations.
+     */
+    getState() {
+        let completedCount = 0;
+        let inProgressCount = 0;
+        let pendingCount = 0;
+        let blockedCount = 0;
+        const remaining = [];
+        for (const task of this.tasks.values()) {
+            switch (task.status) {
+                case 'completed':
+                    completedCount++;
+                    break;
+                case 'in_progress':
+                    inProgressCount++;
+                    remaining.push(task);
+                    break;
+                case 'pending':
+                    pendingCount++;
+                    remaining.push(task);
+                    break;
+                case 'blocked':
+                    blockedCount++;
+                    remaining.push(task);
+                    break;
+                default:
+                    remaining.push(task);
+                    break;
+            }
+        }
+        const total = this.tasks.size;
+        return {
+            total,
+            completed: completedCount,
+            inProgress: inProgressCount,
+            pending: pendingCount,
+            blocked: blockedCount,
+            progress: total > 0 ? (completedCount / total) * 100 : 100,
+            isComplete: remaining.length === 0,
+            iterations: this.iterations,
+            elapsedMs: Date.now() - this.startTime,
+            remainingTasks: remaining,
+        };
+    }
+    /**
+     * Check whether the swarm should continue running.
+     * Returns true if there are remaining tasks AND limits are not exceeded.
+     */
+    shouldContinue() {
+        if (!this.config.enabled)
+            return false;
+        const state = this.getState();
+        if (state.isComplete)
+            return false;
+        if (this.iterations >= this.config.maxIterations)
+            return false;
+        const elapsedMinutes = state.elapsedMs / 60000;
+        if (elapsedMinutes >= this.config.timeoutMinutes)
+            return false;
+        return true;
+    }
+    /**
+     * Get remaining tasks sorted by priority (in_progress first, then pending).
+     * Accepts optional pre-computed state to avoid redundant iteration.
+     */
+    getRemainingTasks(precomputed) {
+        const state = precomputed ?? this.getState();
+        const priorityMap = { in_progress: 0, pending: 1, blocked: 2 };
+        return [...state.remainingTasks].sort((a, b) => {
+            return (priorityMap[a.status] ?? 3) - (priorityMap[b.status] ?? 3);
+        });
+    }
+    /**
+     * Generate a re-engagement prompt for the agent.
+     * Includes drift warnings and learning recommendations when available.
+     */
+    async generateReEngagementPrompt() {
+        const state = this.getState();
+        const remaining = this.getRemainingTasks(state);
+        if (state.isComplete) {
+            if (this.learning) {
+                await this.learning.endSwarmTrajectory(state).catch(() => { });
+            }
+            return `All ${state.total} tasks complete. Swarm finished in ${this.iterations} iterations.`;
+        }
+        const taskLines = remaining
+            .slice(0, 10)
+            .map((t, i) => `  ${i + 1}. [${t.status}] ${t.subject}${t.owner ? ` (${t.owner})` : ''}`)
+            .join('\n');
+        const moreCount = remaining.length > 10 ? remaining.length - 10 : 0;
+        const moreText = moreCount > 0 ? `\n  ... and ${moreCount} more` : '';
+        const elapsedMin = Math.round(state.elapsedMs / 60000);
+        const lines = [
+            `Progress: ${Math.round(state.progress)}% (${state.completed}/${state.total})`,
+            `Iteration ${this.iterations}/${this.config.maxIterations}, elapsed ${elapsedMin}/${this.config.timeoutMinutes} minutes`,
+        ];
+        // Add drift warnings
+        const driftMetrics = this.driftDetector.getMetrics();
+        if (driftMetrics.activeSignals.length > 0) {
+            lines.push('');
+            lines.push('DRIFT WARNINGS:');
+            for (const signal of driftMetrics.activeSignals) {
+                lines.push(`  [${signal.severity.toUpperCase()}] ${signal.message}`);
+            }
+        }
+        lines.push('');
+        lines.push('Remaining tasks:');
+        lines.push(taskLines + moreText);
+        // Add learning recommendations if available
+        if (this.learning && this.learningInitialized) {
+            try {
+                const context = await this.learning.getReEngagementContext(remaining);
+                if (context.recommendations.length > 0) {
+                    lines.push('');
+                    lines.push('LEARNING RECOMMENDATIONS:');
+                    for (const rec of context.recommendations) {
+                        lines.push(`  - ${rec}`);
+                    }
+                }
+            }
+            catch {
+                // Learning recommendations unavailable
+            }
+        }
+        lines.push('');
+        lines.push('Continue working on the remaining tasks. Do not stop until all are completed.');
+        return lines.join('\n');
+    }
+    /**
+     * Get completion history for learning/analytics.
+     */
+    getCompletionHistory() {
+        return [...this.completionHistory];
+    }
+    /**
+     * Get average task completion time.
+     */
+    getAverageCompletionTime() {
+        if (this.completionHistory.length === 0)
+            return 0;
+        const total = this.completionHistory.reduce((sum, h) => sum + h.duration, 0);
+        return total / this.completionHistory.length;
+    }
+    /**
+     * Reset state for a new swarm session.
+     */
+    reset() {
+        this.tasks.clear();
+        this.iterations = 0;
+        this.startTime = Date.now();
+        this.completionHistory = [];
+        this.driftDetector.reset();
+        this.lastDriftCheck = 0;
+        this.sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    }
+    /**
+     * Get config.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update config.
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Initialize the learning subsystem (AgentDB + SONA).
+     * Returns true if learning became available.
+     */
+    async initializeLearning() {
+        try {
+            const { AutopilotLearning } = await import('./autopilot-learning.js');
+            this.learning = new AutopilotLearning();
+            const available = await this.learning.initialize();
+            this.learningInitialized = available;
+            if (available) {
+                await this.learning.beginSwarmTrajectory(this.sessionId);
+            }
+            return available;
+        }
+        catch {
+            this.learningInitialized = false;
+            return false;
+        }
+    }
+    /**
+     * Get drift detection metrics.
+     */
+    getDriftMetrics() {
+        return this.driftDetector.getMetrics();
+    }
+    /**
+     * Get learning subsystem metrics.
+     */
+    async getLearningMetrics() {
+        if (!this.learning)
+            return { available: false, episodes: 0, patterns: 0, trajectories: 0 };
+        try {
+            return await this.learning.getMetrics();
+        }
+        catch {
+            return { available: false, episodes: 0, patterns: 0, trajectories: 0 };
+        }
+    }
+    /**
+     * Apply mitigation strategies for detected drift signals.
+     */
+    applyMitigation(signals) {
+        for (const signal of signals) {
+            const strategy = this.driftDetector.suggestMitigation(signal);
+            switch (strategy.action) {
+                case 'reprioritize':
+                    for (const taskId of strategy.taskIds) {
+                        const task = this.tasks.get(taskId);
+                        if (task && task.status !== 'completed') {
+                            task.status = 'pending';
+                            task.owner = undefined;
+                        }
+                    }
+                    break;
+                case 'reassign':
+                    for (const taskId of strategy.taskIds) {
+                        const task = this.tasks.get(taskId);
+                        if (task && task.status !== 'completed') {
+                            task.owner = undefined;
+                        }
+                    }
+                    break;
+                case 'skip':
+                    for (const taskId of strategy.taskIds) {
+                        const task = this.tasks.get(taskId);
+                        if (task && task.status === 'blocked') {
+                            task.status = 'completed';
+                            task.completedAt = Date.now();
+                        }
+                    }
+                    break;
+                case 'escalate':
+                    // Escalation is informational — included in re-engagement prompt
+                    break;
+            }
+        }
+    }
+}
+export const swarmCompletion = new SwarmCompletionCoordinator();
+//# sourceMappingURL=swarm-completion.js.map

package/dist/agentic-flow/src/coordination/swarm-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-completion.js","sourceRoot":"","sources":["../../../../src/coordination/swarm-completion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Swarm Completion Coordinator (ADR-058)\n *\n * Tracks swarm task completion state and provides programmatic API\n * for the Autopilot persistent completion loop. Integrates with\n * the self-improvement pipeline for learning from completion patterns.\n */\n\nimport { DriftDetector, DriftMetrics, DriftSignal, MitigationStrategy } from './drift-detector.js';\n\nexport interface SwarmTask {\n  id: string;\n  subject: string;\n  status: 'pending' | 'in_progress' | 'completed' | 'blocked';\n  owner?: string;\n  source?: string;\n  createdAt?: number;\n  completedAt?: number;\n}\n\nexport interface CompletionState {\n  total: number;\n  completed: number;\n  inProgress: number;\n  pending: number;\n  blocked: number;\n  progress: number;\n  isComplete: boolean;\n  iterations: number;\n  elapsedMs: number;\n  remainingTasks: SwarmTask[];\n}\n\nexport interface CompletionConfig {\n  maxIterations: number;\n  timeoutMinutes: number;\n  enabled: boolean;\n}\n\nconst DEFAULT_CONFIG: CompletionConfig = {\n  maxIterations: 50,\n  timeoutMinutes: 240,\n  enabled: true,\n};\n\nexport class SwarmCompletionCoordinator {\n  private tasks = new Map<string, SwarmTask>();\n  private iterations = 0;\n  private startTime = Date.now();\n  private config: CompletionConfig;\n  private completionHistory: Array<{\n    taskId: string;\n    duration: number;\n    iterations: number;\n  }> = [];\n  private driftDetector: DriftDetector;\n  private sessionId: string;\n  private lastDriftCheck = 0;\n  private learningInitialized = false;\n  private learning: any = null; // AutopilotLearning (lazy loaded)\n\n  constructor(config: Partial<CompletionConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.driftDetector = new DriftDetector();\n    this.sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n  }\n\n  /**\n   * Register a task for completion tracking.\n   */\n  addTask(task: SwarmTask): void {\n    this.tasks.set(task.id, { ...task, createdAt: task.createdAt || Date.now() });\n  }\n\n  /**\n   * Bulk register tasks.\n   */\n  addTasks(tasks: SwarmTask[]): void {\n    for (const task of tasks) {\n      this.addTask(task);\n    }\n  }\n\n  /**\n   * Update task status with optional agent tracking for drift detection.\n   */\n  updateTask(taskId: string, status: SwarmTask['status'], agentId?: string): void {\n    const task = this.tasks.get(taskId);\n    if (task) {\n      const previousOwner = task.owner;\n      task.status = status;\n      if (agentId) task.owner = agentId;\n\n      if (status === 'completed') {\n        task.completedAt = Date.now();\n        this.completionHistory.push({\n          taskId,\n          duration: task.completedAt - (task.createdAt || this.startTime),\n          iterations: this.iterations,\n        });\n        // Record success episode if learning available\n        if (this.learning) {\n          this.learning.recordTaskCompletion({\n            taskId,\n            subject: task.subject,\n            status: 'completed',\n            iterations: this.iterations,\n            durationMs: task.completedAt - (task.createdAt || this.startTime),\n          }).catch(() => {});\n        }\n      } else if (status === 'blocked' || status === 'pending') {\n        // Track failures for drift detection\n        this.driftDetector.recordTaskFailure(taskId);\n        if (this.learning) {\n          this.learning.recordTaskFailure({\n            taskId,\n            subject: task.subject,\n            status,\n            iterations: this.iterations,\n            durationMs: Date.now() - (task.createdAt || this.startTime),\n          }).catch(() => {});\n        }\n      }\n\n      // Track reassignments\n      if (agentId && previousOwner && agentId !== previousOwner) {\n        this.driftDetector.recordAgentReassignment(taskId, previousOwner, agentId);\n      }\n    }\n  }\n\n  /**\n   * Remove a task from tracking.\n   */\n  removeTask(taskId: string): void {\n    this.tasks.delete(taskId);\n  }\n\n  /**\n   * Increment iteration counter, run drift detection, and return current state.\n   * Called by the Stop hook on each re-engagement cycle.\n   */\n  tick(): CompletionState {\n    this.iterations++;\n    const state = this.getState();\n\n    // Record iteration for drift detection\n    this.driftDetector.recordIteration({ completed: state.completed });\n\n    // Check for drift every 3+ iterations since last check\n    if (this.iterations - this.lastDriftCheck >= 3) {\n      const signals = this.driftDetector.detectDrift();\n      if (signals.length > 0) {\n        this.applyMitigation(signals);\n      }\n      this.lastDriftCheck = this.iterations;\n\n      // Record SONA trajectory step if learning available\n      if (this.learning) {\n        this.learning.recordIterationStep(state, signals).catch(() => {});\n      }\n    }\n\n    return state;\n  }\n\n  /**\n   * Get current completion state without incrementing iterations.\n   */\n  getState(): CompletionState {\n    let completedCount = 0;\n    let inProgressCount = 0;\n    let pendingCount = 0;\n    let blockedCount = 0;\n    const remaining: SwarmTask[] = [];\n\n    for (const task of this.tasks.values()) {\n      switch (task.status) {\n        case 'completed': completedCount++; break;\n        case 'in_progress': inProgressCount++; remaining.push(task); break;\n        case 'pending': pendingCount++; remaining.push(task); break;\n        case 'blocked': blockedCount++; remaining.push(task); break;\n        default: remaining.push(task); break;\n      }\n    }\n\n    const total = this.tasks.size;\n    return {\n      total,\n      completed: completedCount,\n      inProgress: inProgressCount,\n      pending: pendingCount,\n      blocked: blockedCount,\n      progress: total > 0 ? (completedCount / total) * 100 : 100,\n      isComplete: remaining.length === 0,\n      iterations: this.iterations,\n      elapsedMs: Date.now() - this.startTime,\n      remainingTasks: remaining,\n    };\n  }\n\n  /**\n   * Check whether the swarm should continue running.\n   * Returns true if there are remaining tasks AND limits are not exceeded.\n   */\n  shouldContinue(): boolean {\n    if (!this.config.enabled) return false;\n\n    const state = this.getState();\n    if (state.isComplete) return false;\n    if (this.iterations >= this.config.maxIterations) return false;\n\n    const elapsedMinutes = state.elapsedMs / 60000;\n    if (elapsedMinutes >= this.config.timeoutMinutes) return false;\n\n    return true;\n  }\n\n  /**\n   * Get remaining tasks sorted by priority (in_progress first, then pending).\n   * Accepts optional pre-computed state to avoid redundant iteration.\n   */\n  getRemainingTasks(precomputed?: CompletionState): SwarmTask[] {\n    const state = precomputed ?? this.getState();\n    const priorityMap: Record<string, number> = { in_progress: 0, pending: 1, blocked: 2 };\n    return [...state.remainingTasks].sort((a, b) => {\n      return (priorityMap[a.status] ?? 3) - (priorityMap[b.status] ?? 3);\n    });\n  }\n\n  /**\n   * Generate a re-engagement prompt for the agent.\n   * Includes drift warnings and learning recommendations when available.\n   */\n  async generateReEngagementPrompt(): Promise<string> {\n    const state = this.getState();\n    const remaining = this.getRemainingTasks(state);\n\n    if (state.isComplete) {\n      if (this.learning) {\n        await this.learning.endSwarmTrajectory(state).catch(() => {});\n      }\n      return `All ${state.total} tasks complete. Swarm finished in ${this.iterations} iterations.`;\n    }\n\n    const taskLines = remaining\n      .slice(0, 10)\n      .map((t, i) => `  ${i + 1}. [${t.status}] ${t.subject}${t.owner ? ` (${t.owner})` : ''}`)\n      .join('\\n');\n\n    const moreCount = remaining.length > 10 ? remaining.length - 10 : 0;\n    const moreText = moreCount > 0 ? `\\n  ... and ${moreCount} more` : '';\n\n    const elapsedMin = Math.round(state.elapsedMs / 60000);\n\n    const lines = [\n      `Progress: ${Math.round(state.progress)}% (${state.completed}/${state.total})`,\n      `Iteration ${this.iterations}/${this.config.maxIterations}, elapsed ${elapsedMin}/${this.config.timeoutMinutes} minutes`,\n    ];\n\n    // Add drift warnings\n    const driftMetrics = this.driftDetector.getMetrics();\n    if (driftMetrics.activeSignals.length > 0) {\n      lines.push('');\n      lines.push('DRIFT WARNINGS:');\n      for (const signal of driftMetrics.activeSignals) {\n        lines.push(`  [${signal.severity.toUpperCase()}] ${signal.message}`);\n      }\n    }\n\n    lines.push('');\n    lines.push('Remaining tasks:');\n    lines.push(taskLines + moreText);\n\n    // Add learning recommendations if available\n    if (this.learning && this.learningInitialized) {\n      try {\n        const context = await this.learning.getReEngagementContext(remaining);\n        if (context.recommendations.length > 0) {\n          lines.push('');\n          lines.push('LEARNING RECOMMENDATIONS:');\n          for (const rec of context.recommendations) {\n            lines.push(`  - ${rec}`);\n          }\n        }\n      } catch {\n        // Learning recommendations unavailable\n      }\n    }\n\n    lines.push('');\n    lines.push('Continue working on the remaining tasks. Do not stop until all are completed.');\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Get completion history for learning/analytics.\n   */\n  getCompletionHistory(): typeof this.completionHistory {\n    return [...this.completionHistory];\n  }\n\n  /**\n   * Get average task completion time.\n   */\n  getAverageCompletionTime(): number {\n    if (this.completionHistory.length === 0) return 0;\n    const total = this.completionHistory.reduce((sum, h) => sum + h.duration, 0);\n    return total / this.completionHistory.length;\n  }\n\n  /**\n   * Reset state for a new swarm session.\n   */\n  reset(): void {\n    this.tasks.clear();\n    this.iterations = 0;\n    this.startTime = Date.now();\n    this.completionHistory = [];\n    this.driftDetector.reset();\n    this.lastDriftCheck = 0;\n    this.sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n  }\n\n  /**\n   * Get config.\n   */\n  getConfig(): CompletionConfig {\n    return { ...this.config };\n  }\n\n  /**\n   * Update config.\n   */\n  setConfig(config: Partial<CompletionConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Initialize the learning subsystem (AgentDB + SONA).\n   * Returns true if learning became available.\n   */\n  async initializeLearning(): Promise<boolean> {\n    try {\n      const { AutopilotLearning } = await import('./autopilot-learning.js');\n      this.learning = new AutopilotLearning();\n      const available = await this.learning.initialize();\n      this.learningInitialized = available;\n      if (available) {\n        await this.learning.beginSwarmTrajectory(this.sessionId);\n      }\n      return available;\n    } catch {\n      this.learningInitialized = false;\n      return false;\n    }\n  }\n\n  /**\n   * Get drift detection metrics.\n   */\n  getDriftMetrics(): DriftMetrics {\n    return this.driftDetector.getMetrics();\n  }\n\n  /**\n   * Get learning subsystem metrics.\n   */\n  async getLearningMetrics(): Promise<any> {\n    if (!this.learning) return { available: false, episodes: 0, patterns: 0, trajectories: 0 };\n    try {\n      return await this.learning.getMetrics();\n    } catch {\n      return { available: false, episodes: 0, patterns: 0, trajectories: 0 };\n    }\n  }\n\n  /**\n   * Apply mitigation strategies for detected drift signals.\n   */\n  private applyMitigation(signals: DriftSignal[]): void {\n    for (const signal of signals) {\n      const strategy: MitigationStrategy = this.driftDetector.suggestMitigation(signal);\n      switch (strategy.action) {\n        case 'reprioritize':\n          for (const taskId of strategy.taskIds) {\n            const task = this.tasks.get(taskId);\n            if (task && task.status !== 'completed') {\n              task.status = 'pending';\n              task.owner = undefined;\n            }\n          }\n          break;\n        case 'reassign':\n          for (const taskId of strategy.taskIds) {\n            const task = this.tasks.get(taskId);\n            if (task && task.status !== 'completed') {\n              task.owner = undefined;\n            }\n          }\n          break;\n        case 'skip':\n          for (const taskId of strategy.taskIds) {\n            const task = this.tasks.get(taskId);\n            if (task && task.status === 'blocked') {\n              task.status = 'completed';\n              task.completedAt = Date.now();\n            }\n          }\n          break;\n        case 'escalate':\n          // Escalation is informational — included in re-engagement prompt\n          break;\n      }\n    }\n  }\n\n}\n\nexport const swarmCompletion = new SwarmCompletionCoordinator();\n"]}

package/dist/agentic-flow/src/core/long-running-agent.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Long-Running Agent with Provider Fallback
+ *
+ * Demonstrates how to use ProviderManager for resilient, cost-optimized agents
+ * that can run for hours or days with automatic provider switching.
+ */
+import { ProviderConfig, FallbackStrategy } from './provider-manager.js';
+export interface LongRunningAgentConfig {
+    agentName: string;
+    providers: ProviderConfig[];
+    fallbackStrategy?: FallbackStrategy;
+    checkpointInterval?: number;
+    maxRuntime?: number;
+    costBudget?: number;
+    performanceTarget?: number;
+}
+export interface AgentCheckpoint {
+    timestamp: Date;
+    taskProgress: number;
+    currentProvider: string;
+    totalCost: number;
+    totalTokens: number;
+    completedTasks: number;
+    failedTasks: number;
+    state: Record<string, any>;
+}
+export declare class LongRunningAgent {
+    private providerManager;
+    private config;
+    private startTime;
+    private checkpoints;
+    private currentState;
+    private isRunning;
+    private checkpointInterval?;
+    constructor(config: LongRunningAgentConfig);
+    /**
+     * Start the agent with automatic checkpointing
+     */
+    start(): Promise<void>;
+    /**
+     * Execute a task with automatic provider fallback
+     */
+    executeTask<T>(task: {
+        name: string;
+        complexity: 'simple' | 'medium' | 'complex';
+        estimatedTokens?: number;
+        execute: (provider: string) => Promise<T>;
+    }): Promise<T>;
+    /**
+     * Save checkpoint of current state
+     */
+    private saveCheckpoint;
+    /**
+     * Calculate task progress (override in subclass)
+     */
+    protected calculateProgress(): number;
+    /**
+     * Get current status
+     */
+    getStatus(): {
+        isRunning: boolean;
+        runtime: number;
+        completedTasks: number;
+        failedTasks: number;
+        totalCost: number;
+        totalTokens: number;
+        providers: any[];
+        lastCheckpoint?: AgentCheckpoint;
+    };
+    /**
+     * Get detailed metrics
+     */
+    getMetrics(): {
+        providers: import("./provider-manager.js").ProviderMetrics[];
+        health: import("./provider-manager.js").ProviderHealth[];
+        costs: {
+            total: number;
+            byProvider: Record<import("./provider-manager.js").ProviderType, number>;
+            totalTokens: number;
+        };
+        checkpoints: AgentCheckpoint[];
+    };
+    /**
+     * Restore from checkpoint
+     */
+    restoreFromCheckpoint(checkpoint: AgentCheckpoint): void;
+    /**
+     * Stop the agent
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=long-running-agent.d.ts.map

package/dist/agentic-flow/src/core/long-running-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-running-agent.d.ts","sourceRoot":"","sources":["../../../../src/core/long-running-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG1F,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,kBAAkB,CAAC,CAAiB;gBAEhC,MAAM,EAAE,sBAAsB;IAgB1C;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;OAEG;IACU,WAAW,CAAC,CAAC,EACxB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KAC3C,GACA,OAAO,CAAC,CAAC,CAAC;IA8Db;;OAEG;IACH,OAAO,CAAC,cAAc;IAoDtB;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,MAAM;IASrC;;OAEG;IACI,SAAS,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,GAAG,EAAE,CAAC;QACjB,cAAc,CAAC,EAAE,eAAe,CAAC;KAClC;IAuBD;;OAEG;IACI,UAAU;;;;;;;;;;IASjB;;OAEG;IACI,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAQ/D;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAqBnC"}