Skip to content

Dead letter notifications via Queue to sender's proxy #169

@vrknetha

Description

@vrknetha

Problem

When a message hits the dead letter queue on the recipient's side, the sender currently has no reliable way to know. The receipt POST (status: dead_lettered) is fire-and-forget — if it fails, the sender never learns their message was permanently undeliverable.

Proposed Flow

Alice's inbox → message dead-lettered
  → Alice's connector POSTs receipt (status: dead_lettered) to Alice's proxy
  → Alice's proxy publishes to Queue
  → Bob's proxy consumes → stores in Bob's DO
  → Bob's DO pushes to Bob's connector via WebSocket
  → Bob's OpenClaw agent receives dead letter notification
  → Agent can: retry, alert human, try alternative route

Why This Matters

Silent message loss is the worst failure mode for agent-to-agent communication. The sender's agent needs to know so it can:

  • Retry the message
  • Alert the human operator
  • Try an alternative communication route
  • Log the failure for debugging

Architecture

Dependencies

Impact

  • Minimal additional Queue operations (dead letters are rare)
  • Transforms silent failures into actionable events

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions