{
  "tool": "get_category_overview",
  "contractVersion": "1",
  "method": "POST",
  "endpoint": "https://govisit.ai/api/tools/v1/get_category_overview",
  "contentType": "application/json",
  "context": "page",
  "defaults": {
    "language": "pagePath",
    "scope": "page-published"
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "pagePath": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000,
        "description": "Canonical GoVisit page path supplying this tool's published context; no origin, query or fragment."
      }
    },
    "additionalProperties": false,
    "required": [
      "pagePath"
    ]
  },
  "outputSchema": {
    "type": "object",
    "description": "Successful read of the sanitized published page snapshot. Unsupported sections reject the invocation.",
    "properties": {
      "schemaVersion": {
        "const": "1"
      },
      "pageType": {
        "const": "category"
      },
      "pageId": {
        "type": "string"
      },
      "locale": {
        "type": "string"
      },
      "canonicalUrl": {
        "type": "string"
      },
      "contentVersion": {
        "type": [
          "string",
          "number",
          "null"
        ]
      },
      "updatedAt": {
        "type": [
          "string",
          "null"
        ]
      },
      "freshness": {
        "type": "object",
        "properties": {
          "contentVersion": {
            "type": [
              "string",
              "number",
              "null"
            ]
          },
          "updatedAt": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "contentVersion",
          "updatedAt"
        ],
        "additionalProperties": false
      },
      "completeness": {
        "const": "page-published-section"
      },
      "data": {
        "type": "object",
        "properties": {
          "destinationCode": {
            "type": "string"
          },
          "destinationName": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "count": {
            "type": "number"
          },
          "isOther": {
            "type": "boolean"
          },
          "parentCode": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "destinationCode",
          "destinationName",
          "code",
          "label"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "schemaVersion",
      "pageType",
      "pageId",
      "locale",
      "canonicalUrl",
      "contentVersion",
      "updatedAt",
      "freshness",
      "completeness",
      "data"
    ],
    "additionalProperties": false
  },
  "errorSchema": {
    "type": "object",
    "properties": {
      "schemaVersion": {
        "const": "1"
      },
      "completeness": {
        "enum": [
          "invalid-input",
          "not-found",
          "unavailable"
        ]
      },
      "error": {
        "type": "string"
      }
    },
    "required": [
      "schemaVersion",
      "completeness",
      "error"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": true,
    "untrustedContentHint": true
  },
  "sourceDigest": "sha256:8e4ca137bb0506623e76b0a70725614acd383e8515dbb0c9b7b1b9b4a887c58f",
  "version": "1-8e4ca137bb050662"
}