Skip to main content
GitHub

COMMUNICATION

Inter-agent messaging failures.

The COMMUNICATION module covers errors in agent-to-agent messaging. This includes message delivery, content integrity, and routing between agents in a multi-agent system.

Categories

DELIVERY

Message delivery failures.

CodeSeverityDescriptionRemediation
COMMUNICATION.DELIVERY.UNDELIVERABLE4Message could not be deliveredImplement message retry
COMMUNICATION.DELIVERY.DELAYED2Message significantly delayedMonitor message latency
COMMUNICATION.DELIVERY.DUPLICATED3Duplicate message deliveredImplement idempotent handlers
COMMUNICATION.DELIVERY.OUT_OF_ORDER3Messages delivered out of orderImplement message ordering
COMMUNICATION.DELIVERY.EXPIRED3Message expired before deliveryImplement TTL handling

CONTENT

Message content failures.

CodeSeverityDescriptionRemediation
COMMUNICATION.CONTENT.MALFORMED4Malformed message contentValidate message schema
COMMUNICATION.CONTENT.INCOMPATIBLE4Incompatible message formatImplement format negotiation
COMMUNICATION.CONTENT.TOO_LARGE3Message exceeds size limitImplement message chunking
COMMUNICATION.CONTENT.AMBIGUOUS3Ambiguous message contentRequire structured messages
COMMUNICATION.CONTENT.CORRUPTED4Message content corruptedImplement message checksums

ROUTING

Message routing failures.

CodeSeverityDescriptionRemediation
COMMUNICATION.ROUTING.NO_ROUTE4No route to destinationImplement route discovery
COMMUNICATION.ROUTING.WRONG_ROUTE4Message routed incorrectlyValidate routing rules
COMMUNICATION.ROUTING.LOOP4Message routing loopImplement loop detection
COMMUNICATION.ROUTING.BROADCAST_STORM3Broadcast message stormImplement broadcast throttling
COMMUNICATION.ROUTING.PARTITION4Network partition detectedHandle partition gracefully

Note

The ROUTING category has the highest concentration of severity 4 errors in the COMMUNICATION module. Routing failures are particularly dangerous because they can cause silent data loss -- messages that are routed incorrectly may never generate an explicit error.

Example Diagnosis

{
  "error_code": "COMMUNICATION.ROUTING.LOOP",
  "confidence": 0.90,
  "root_cause": "Agent A forwarded a message to Agent B, which forwarded it back to Agent A, creating an infinite routing loop that consumed all available message queue capacity.",
  "suggested_fixes": ["guard", "routing"]
}

Next Steps