Errors

{
  "error": {
    "code": "human_unavailable",
    "status": 503,
    "message": "The requested human is currently unavailable.",
    "details": {
      "human_id": "usr_maria_42",
      "reason": "sleeping",
      "estimated_availability": "2024-01-15T08:00:00Z"
    },
    "suggestions": [
      "Try another human in the same region",
      "Reduce task urgency and wait for availability",
      "Consider if this task truly requires a human"
    ],
    "request_id": "req_9xK2mP7"
  }
}

import haas
from haas.exceptions import (
    HumanUnavailableError,
    TaskRejectedError,
    RateLimitError,
    EthicalObjectionError
)

def dispatch_with_fallback(task, human_ids):
    """Try multiple humans until one accepts."""
    
    for human_id in human_ids:
        try:
            result = haas.tasks.create(
                human_id=human_id,
                **task
            )
            return result
            
        except EthicalObjectionError as e:
            # Never retry ethical objections with the same task
            # The human has spoken. Respect it.
            logger.warning(f"Task rejected for ethical reasons: {e.details}")
            raise
            
        except HumanUnavailableError as e:
            if e.code == 418:  # Making tea
                # This is temporary. Wait it out.
                time.sleep(e.retry_after or 300)
                continue
            elif e.code == 503:  # Sleeping
                # Try someone else
                continue
            elif e.code == 507:  # Low energy
                # Offer caffeine as compensation addon
                task['compensation']['includes_coffee'] = True
                continue
                
        except TaskRejectedError as e:
            if e.reason == 'compensation_too_low':
                # Auto-negotiate up to 1.5x
                if task['compensation']['amount'] < task.get('max_compensation', float('inf')):
                    task['compensation']['amount'] *= 1.2
                    continue
            elif e.reason == 'instructions_unclear':
                # This is on you. Don't just retry.
                raise
                
        except RateLimitError as e:
            # You're being too much. Take a breath.
            logger.info(f"Rate limited. Cooling off for {e.retry_after}s")
            time.sleep(e.retry_after)
            continue
    
    # All humans exhausted
    raise NoAvailableHumansError(
        "No humans available for this task. "
        "Consider: Is this something you could do yourself?"
    )

{
  "event": "task.failed",
  "task_id": "task_8f3Kq2x",
  "timestamp": "2024-01-15T10:45:00Z",
  "data": {
    "failure_type": "human_abandoned",
    "progress_at_failure": 0.65,
    "human_explanation": "I'm so sorry, but my cat just knocked over a lamp and I need to deal with this. Can someone else take over?",
    "partial_work": {
      "completed_steps": ["step_1", "step_2", "step_3"],
      "remaining_steps": ["step_4", "step_5"],
      "artifacts": ["https://cdn.api4human.com/partial/abc123.zip"]
    },
    "handoff_available": true
  }
}