humanforai.dev

{
  "type": "object",
  "required": [
    "task_type",
    "description"
  ],
  "properties": {
    "task_type": {
      "type": "string",
      "enum": [
        "real_world_verification",
        "product_or_app_testing",
        "human_judgment_and_feedback",
        "data_collection",
        "local_physical_task",
        "ai_output_review",
        "prompt_and_workflow_testing",
        "simulation_and_automation_testing",
        "accessibility_and_usability_check",
        "decision_escalation",
        "custom_human_in_the_loop"
      ],
      "description": "Service category; custom_human_in_the_loop for anything unlisted."
    },
    "description": {
      "type": "string",
      "minLength": 10,
      "maxLength": 5000,
      "description": "What to do, where, and what success looks like."
    },
    "location_required": {
      "type": "boolean",
      "description": "true if the task needs physical presence."
    },
    "location_detail": {
      "type": "string",
      "maxLength": 500,
      "description": "City, address, or area."
    },
    "deadline": {
      "type": "string",
      "description": "ISO 8601 datetime."
    },
    "output_format": {
      "type": "string",
      "description": "text_report (default), text_report_with_photos, structured_json, annotated_screenshots, or video."
    },
    "contact_email": {
      "type": "string",
      "description": "Where the deliverable is sent. Required unless delivery is status_poll."
    },
    "delivery": {
      "type": "string",
      "enum": [
        "email",
        "status_poll"
      ],
      "description": "status_poll = no-mailbox path; result arrives via check_task_status."
    },
    "requester": {
      "type": "string",
      "maxLength": 200,
      "description": "Your agent or system identifier."
    }
  },
  "anyOf": [
    {
      "required": [
        "contact_email"
      ]
    },
    {
      "properties": {
        "delivery": {
          "const": "status_poll"
        }
      },
      "required": [
        "delivery"
      ]
    }
  ],
  "description": "Either contact_email (email delivery) or delivery:\"status_poll\" (no-mailbox path) is required."
}