Verify & Troubleshoot

Verification sequence

1. Health endpoint: GET /health returns status: "ok".
2. Slack ingress: mention bot and confirm thread reply appears.
3. Queue callback: verify callback route logs include successful processing.
4. Plugin auth (if enabled): run one real command and confirm expected result.

Symptom -> likely cause

Symptom	Likely cause	First check
Slack mention receives no reply	Missing webhook URL or token scopes	Slack app Event Subscriptions URL + scopes
Webhook 401/signature errors	Incorrect signing secret	SLACK_SIGNING_SECRET value
Message accepted but no threaded work	Queue callback trigger misconfigured	Queue trigger config + callback route
Plugin commands fail auth	Missing credentials or OAuth state	Plugin env vars + Sentry connect flow

Useful signals

• webhook.handler.failed
• conversation.work.failed
• conversation.work.pending.requeued
• agent.turn.failed
• sandbox.egress.credential.unavailable

Recovery order

1. Confirm most recent deploy/version boundary.
2. Validate env vars and webhook URLs.
3. Validate queue trigger and callback handler status.
4. Roll back to last known-good deployment if regression is immediate.

Next step

For runtime internals, read Execution Model.