CONSENSUS
Agreement and conflict resolution failures.
The CONSENSUS module covers errors in multi-agent agreement protocols, conflict resolution, and voting mechanisms. These errors arise when multiple agents need to reach a shared decision.
Categories
AGREEMENT
Agreement failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
CONSENSUS.AGREEMENT.TIMEOUT | 3 | Consensus timeout | Implement timeout handling |
CONSENSUS.AGREEMENT.QUORUM_FAILED | 4 | Failed to reach quorum | Handle quorum failures |
CONSENSUS.AGREEMENT.INCONSISTENT | 5 | Inconsistent agreement state | Implement consensus validation |
CONSENSUS.AGREEMENT.REJECTED | 3 | Proposal rejected | Handle rejection gracefully |
CONSENSUS.AGREEMENT.STALE_VOTE | 2 | Stale vote received | Implement vote freshness |
CONFLICT
Conflict resolution failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
CONSENSUS.CONFLICT.UNRESOLVED | 4 | Conflict unresolved | Implement conflict escalation |
CONSENSUS.CONFLICT.RESOLUTION_REJECTED | 3 | Resolution rejected by parties | Implement resolution retry |
CONSENSUS.CONFLICT.CASCADING | 5 | Cascading conflicts | Implement conflict isolation |
CONSENSUS.CONFLICT.BIAS | 4 | Biased conflict resolution | Implement fair resolution |
CONSENSUS.CONFLICT.DEADLOCK | 5 | Conflict resolution deadlock | Implement deadlock breaking |
Warning
The CONFLICT category contains two severity 5 codes: CASCADING and DEADLOCK. Cascading conflicts are particularly dangerous because a single unresolved conflict can propagate across the entire multi-agent system, creating a chain reaction of failures.
VOTING
Voting failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
CONSENSUS.VOTING.INVALID_VOTE | 3 | Invalid vote received | Validate vote format |
CONSENSUS.VOTING.DUPLICATE_VOTE | 3 | Duplicate vote detected | Implement vote deduplication |
CONSENSUS.VOTING.COERCED_VOTE | 5 | Vote coercion detected | Implement vote privacy |
CONSENSUS.VOTING.SPLIT_VOTE | 2 | Split vote result | Implement tiebreaker |
CONSENSUS.VOTING.ABSTENTION_FLOOD | 3 | Too many abstentions | Handle abstentions |
Example Diagnosis
{
"error_code": "CONSENSUS.AGREEMENT.QUORUM_FAILED",
"confidence": 0.87,
"root_cause": "Only 2 of 5 required agents responded within the consensus timeout window, preventing quorum from being reached.",
"suggested_fixes": ["parameter", "retry"]
}