{
  "version": "2.0-draft",
  "masterAiIntegrated": false,
  "queryTypes": [
    {
      "type": "lookup",
      "purpose": "Fetch canonical data about known entities."
    },
    {
      "type": "search",
      "purpose": "Find candidates matching structured or natural-language criteria."
    },
    {
      "type": "compare",
      "purpose": "Compare selected entities across requested fields/metrics."
    },
    {
      "type": "recommend",
      "purpose": "Rank candidates for a task under explicit constraints."
    },
    {
      "type": "explain",
      "purpose": "Return evidence supporting a fact, comparison or recommendation."
    },
    {
      "type": "history",
      "purpose": "Return state or events at/between dates."
    },
    {
      "type": "graph",
      "purpose": "Traverse verified relationships."
    },
    {
      "type": "status",
      "purpose": "Return operational/freshness state where available."
    }
  ],
  "request": {
    "request_id": "string",
    "query_type": "lookup|search|compare|recommend|explain|history|graph|status",
    "natural_language": "optional string",
    "task_ids": "optional string[]",
    "required_capabilities": "optional string[]",
    "preferred_capabilities": "optional string[]",
    "constraints": "optional canonical constraint[]",
    "candidate_ids": "optional string[]",
    "fields": "optional string[]",
    "evidence_requirement": "primary_only|high_confidence|any_public",
    "freshness_requirement_days": "optional integer",
    "as_of": "optional ISO datetime",
    "max_results": "optional integer"
  },
  "rules": [
    "Hard constraints are applied before ranking.",
    "Unknown does not satisfy a hard requirement by default.",
    "Recommendations expose why candidates passed or failed.",
    "Material recommendation reasons reference evidence or explicitly state evidence is pending.",
    "Artificial Index does not execute third-party actions through this query contract."
  ]
}