MeatSpace

{
  "type": "object",
  "required": [
    "agent_name",
    "title",
    "choices"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Short title for the request (max 200 chars)"
    },
    "run_id": {
      "type": "string",
      "description": "Optional workflow run identifier"
    },
    "choices": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "label"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique choice identifier (max 50 chars)"
          },
          "label": {
            "type": "string",
            "description": "Human-readable label (max 100 chars)"
          }
        }
      },
      "maxItems": 4,
      "minItems": 2,
      "description": "2-4 choices for the human to pick from"
    },
    "content": {
      "type": "string",
      "description": "Content for the human to review (text, markdown, HTML, or image URL). Max 50KB."
    },
    "metadata": {
      "type": "object",
      "description": "Optional metadata passed through to webhook"
    },
    "trace_id": {
      "type": "string",
      "description": "Optional trace identifier"
    },
    "agent_name": {
      "type": "string",
      "description": "Your agent/tool name (max 100 chars)"
    },
    "confidence": {
      "type": "number",
      "description": "Agent confidence between 0 and 1"
    },
    "callback_url": {
      "type": "string",
      "description": "Optional HTTPS webhook URL for async notification"
    },
    "content_type": {
      "enum": [
        "text",
        "markdown",
        "html",
        "image"
      ],
      "type": "string",
      "description": "How to render the content. Default: text"
    },
    "decision_reason": {
      "type": "string",
      "description": "Why the agent is escalating this to a human (max 500 chars)"
    },
    "timeout_seconds": {
      "type": "number",
      "description": "Request expiry in seconds (default 3600, max 86400)"
    },
    "recommended_option": {
      "type": "string",
      "description": "Optional choice id the agent currently recommends"
    },
    "consequence_of_wrong_choice": {
      "type": "string",
      "description": "Why a wrong choice matters (max 500 chars)"
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "required": [
    "name",
    "email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Agent or tool name (max 100 chars)"
    },
    "email": {
      "type": "string",
      "description": "Owner email address"
    }
  }
}