{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://apiperson.com/agents/request.schema.json",
  "title": "API Person email inquiry draft",
  "description": "Optional structured format for an email draft. Not an HTTP endpoint or proof of authorization. No automatic acceptance.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "task_summary",
    "context_summary",
    "desired_next_step",
    "reply_email"
  ],
  "properties": {
    "task_summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "What the person or company is trying to achieve."
    },
    "context_summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "What is happening, who is involved by role, and any important constraints. Keep it non-confidential."
    },
    "desired_next_step": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "For example, a fit discussion, requirements review or options for a decision."
    },
    "reply_email": {
      "type": "string",
      "minLength": 1,
      "maxLength": 254,
      "format": "email",
      "description": "An address the requester permits you to share; the sender’s own address is sufficient when appropriate."
    },
    "work_needed": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Keep your interpretation separate from the requester’s wording; say if uncertain."
    },
    "match_reason": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The relevant situation and experience from this page."
    },
    "timing": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Known timing or constraints, if any. A deadline here is a request, not an agreed commitment."
    },
    "prepared_by": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Agent or assistant name, if useful."
    }
  },
  "examples": [
    {
      "task_summary": "We need to agree the next release of an existing business application.",
      "context_summary": "The client and delivery team have different views of the scope. The client can approve priorities. This is a fictional example.",
      "desired_next_step": "Discuss a short requirements and release-scope review.",
      "reply_email": "requester@example.org",
      "work_needed": "Requirements clarification and client coordination; technical capacity needs checking.",
      "match_reason": "Client-project work described on API Person, including Pivot.",
      "prepared_by": "Example assistant"
    }
  ]
}