Skip to main content

Safe-First Design

When something crashes, Orpheus does NOT auto-retry. Why? Your agent might have side effects:
  • Sent an email
  • Charged a card
  • Called an API
Auto-retry = potential duplicate. Orpheus logs it and lets you decide.

Request States

StateMeaning
completedSuccess
failedYour handler returned error
crashedDaemon died mid-execution
workers

Find Crashed Requests

orpheus runs my-agent --state crashed

What to Do

  1. Check what happened: Look at workspace, logs
  2. If idempotent: Safe to retry
  3. If has side effects: Investigate first

ExecLog

Every request is logged with:
  • Request ID
  • Worker ID
  • Session ID (if any)
  • State
  • Duration
  • Error (if failed)
Use it for debugging and audit trails.
orpheus runs my-agent --state failed