feat(backend): Implement Agent Health Monitoring with Automatic Failover

[devJaja]

Summary

Enhance agent health monitoring with automatic failover: when an agent fails health checks, tasks are rerouted to alternative agents automatically.

Motivation

Currently, agent failures require manual intervention. Automatic failover improves task completion rates and reduces downtime.

Acceptance Criteria

• Health check runs every 30 seconds for all agents
• Agent marked offline after 3 consecutive failed health checks
• Active tasks on offline agent automatically retried with alternative agent
• Fallback agent selection: same capability, highest reputation
• Agent recovery: marked online after passing health check
• Events emitted: AgentFailedOver, AgentRecovered, AgentMarkedOffline
• Failover logged with correlation ID for tracing
• Unit tests for failover, recovery, and retry logic

Files to Modify

File	Action
backend/src/agents/heartbeat.ts	Enhance with failover logic
backend/src/coordinator/coordinator.ts	Add failover and retry to node execution
backend/src/coordinator/dispatch.ts	Add agent selection fallback
backend/src/services/agentMonitor.ts	New: centralized agent health monitoring
backend/src/agents/heartbeat.test.ts	Add failover tests

How to Contribute

1. Create branch feat/agent-failover
2. Build centralized agent monitoring service
3. Implement automatic failover in coordinator
4. Add recovery detection logic
5. Write comprehensive failover tests
6. Run npm run test && npm run lint before submitting PR

[morelucks]

Hello,

I’m a smart contract and full-stack developer interested in contributing to this issue.

I have experience contributing through OnlyDust and have participated in Drips Wave 1, Wave 2, Wave 5, as well as the GrantFox beta campaign.

My technical background includes Rust, Soroban, Cairo, Solidity, and TypeScript, with a focus on building secure, scalable, and maintainable blockchain applications.

Based on the scope of this issue, I’m confident I can deliver a complete and well-tested solution within 24 hours of assignment. I prioritize clean code, clear documentation, and efficient implementation.

I’d appreciate the opportunity to contribute and help move this issue forward.

Thank you.

[grantfox-oss]

🦊 GrantFox — @morelucks has been assigned to this issue as part of the Third Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #273)
2. Your PR will be reviewed by the Epta-Node maintainers

Good luck! Track your progress on GrantFox.