Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Debug & Operations

Debug & Operations Commands

These commands are hidden by default and visible with the --all flag. They are used for troubleshooting and operations.

Dead Letters

Manage failed events that could not be processed. Dead letters capture events that exhausted their retry budget — typically webhook deliveries, agent callbacks, or channel sends that repeatedly errored.
When to use: if a message appears stuck (received on the channel but never processed, or an outbound reply that never arrived), start with omni dead-letters list to see if the event landed in the dead-letter queue. Use stats for an aggregate health check, get to inspect the failure, and retry once the underlying issue is resolved. The dead-letters command is hidden from default omni --help — it is visible via omni --all and intended for operators and debugging.

omni dead-letters list

List dead letters with optional filters.
omni dead-letters list [options]

omni dead-letters get

Get dead letter details.
omni dead-letters get <id>

omni dead-letters stats

Get dead letter statistics.
omni dead-letters stats

omni dead-letters retry

Retry processing a failed event.
omni dead-letters retry <id>

omni dead-letters resolve

Mark a dead letter as resolved (acknowledged, no retry needed).
omni dead-letters resolve [options] <id>

omni dead-letters abandon

Abandon a dead letter — stop all retry attempts.
omni dead-letters abandon <id>
# List recent failures
omni dead-letters list

# Check failure stats
omni dead-letters stats

# Retry a specific event
omni dead-letters retry dl-abc123

# Mark as resolved (no retry)
omni dead-letters resolve dl-abc123

Payloads

Inspect event payloads at different processing stages.

omni payloads list

List payloads for an event.
omni payloads list <eventId>

omni payloads get

Get a specific payload stage.
omni payloads get <eventId> <stage>
Stages: webhook_raw, agent_request, agent_response, channel_send, error.

omni payloads delete

Delete payloads for an event.
omni payloads delete [options] <eventId>

omni payloads config

List or update payload storage configuration.
omni payloads config [options] [eventType]

omni payloads stats

Get payload storage statistics.
omni payloads stats
# Inspect all payload stages for an event
omni payloads list evt-abc123

# Get the raw webhook payload
omni payloads get evt-abc123 webhook_raw

# Check storage stats
omni payloads stats