visitkeswick.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "@context": {
          "description": "Optional ARD v0.91 JSON-LD context.",
          "type": "string",
          "const": "https://agenticresourcediscovery.org/context/v1"
        },
        "text": {
          "description": "Natural-language query, e.g. \"boutique hotels in London with a spa\".",
          "type": "string",
          "minLength": 1,
          "maxLength": 2048
        },
        "filter": {
          "description": "Optional dot-path field filters; each value is an array of strings (OR within a field), e.g. {\"tags\":[\"spa\"]}.",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "required": [
        "text"
      ],
      "additionalProperties": false
    },
    "stay": {
      "description": "Optional. When given, results are grounded in live availability and offers for these dates and party. When absent, dates and party written in the question still apply.",
      "type": "object",
      "properties": {
        "checkIn": {
          "description": "Arrival date, ISO YYYY-MM-DD.",
          "type": "string",
          "minLength": 1
        },
        "checkOut": {
          "description": "Departure date, ISO YYYY-MM-DD.",
          "type": "string",
          "minLength": 1
        },
        "party": {
          "type": "object",
          "properties": {
            "adults": {
              "description": "Number of adults.",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 30
            },
            "children": {
              "description": "Number of children.",
              "type": "integer",
              "minimum": 0,
              "maximum": 30
            }
          },
          "required": [
            "adults"
          ]
        }
      },
      "required": [
        "checkIn",
        "checkOut",
        "party"
      ]
    },
    "party": {
      "description": "Who is travelling, when known without dates (children change what suits). Ignored when `stay` carries its own party.",
      "type": "object",
      "properties": {
        "adults": {
          "description": "Number of adults.",
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 30
        },
        "children": {
          "description": "Number of children.",
          "type": "integer",
          "minimum": 0,
          "maximum": 30
        }
      },
      "required": [
        "adults"
      ]
    },
    "assumeParty": {
      "description": "Optional. The party to check live availability for when the question names dates but nobody is counted (\"next weekend\"). The question's own party, `party` or `stay` always wins; `meta.queryValues.guests` stays empty, so the answer can say the party was assumed.",
      "type": "object",
      "properties": {
        "adults": {
          "description": "Number of adults.",
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 30
        },
        "children": {
          "description": "Number of children.",
          "type": "integer",
          "minimum": 0,
          "maximum": 30
        }
      },
      "required": [
        "adults"
      ]
    },
    "pageSize": {
      "description": "Maximum number of results to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "render": {
      "description": "Ask for layout hints alongside the results. Delivery (one body or a stream) is chosen by the Accept header, not here.",
      "type": "object",
      "properties": {
        "a2ui": {
          "description": "Also return `ui`: an A2UI surface for the same results. A hint; the results are complete without it.",
          "type": "boolean"
        },
        "catalogs": {
          "description": "A2UI catalog ids the caller can render.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "query"
  ]
}