{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentwebmap-com/json-schema/agentwebmap-com-resolution-schema.json",
  "title": "Resolution",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentwebmap-com-openapi.json#/components/schemas/Resolution",
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "domain",
        "topic"
      ]
    },
    "best": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "pending",
            "valid",
            "invalid",
            "unreachable"
          ]
        },
        "tier": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "featured",
            "listed",
            "unlisted",
            "rejected",
            null
          ]
        },
        "authority": {
          "type": [
            "integer",
            "null"
          ]
        },
        "verified": {
          "type": "boolean"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "summary": {
          "type": [
            "string",
            "null"
          ]
        },
        "llms_txt": {
          "type": [
            "string",
            "null"
          ]
        },
        "llms_full_txt": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_checked": {
          "type": [
            "string",
            "null"
          ]
        },
        "agent_terms": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "automated_access": {
                  "type": "string",
                  "enum": [
                    "welcome",
                    "limited",
                    "ask",
                    "not_allowed"
                  ]
                },
                "rate_limit": {
                  "type": "string",
                  "maxLength": 100
                },
                "attribution": {
                  "type": "string",
                  "enum": [
                    "required",
                    "appreciated",
                    "none"
                  ]
                },
                "attribution_text": {
                  "type": "string",
                  "maxLength": 200
                },
                "pricing": {
                  "type": "string",
                  "enum": [
                    "free",
                    "freemium",
                    "paid"
                  ]
                },
                "pricing_url": {
                  "type": "string"
                },
                "terms_url": {
                  "type": "string"
                },
                "notes": {
                  "type": "string",
                  "maxLength": 500
                }
              },
              "required": [],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "ai-ml",
              "developer-tools",
              "infrastructure",
              "data-analytics",
              "cybersecurity",
              "finance-payments",
              "ecommerce",
              "productivity",
              "marketing",
              "education",
              "healthcare",
              "media",
              "design",
              "gaming",
              "travel",
              "community",
              "legal",
              "recruiting-careers",
              "industrial-manufacturing",
              "real-estate",
              "arts-culture",
              "sports-fitness",
              "food-dining",
              "automotive",
              "government-public-services",
              "science-research",
              "ai-agents-mcp",
              "apis-sdks",
              "databases",
              "auth-identity",
              "devops-observability",
              "no-code-automation",
              "communications",
              "crypto-web3",
              "saas-business-software",
              "open-source",
              "documentation-reference",
              "fashion-beauty",
              "home-garden",
              "consumer-electronics",
              "pets",
              "insurance",
              "telecom",
              "logistics-shipping",
              "energy-utilities",
              "construction-architecture",
              "agriculture",
              "nonprofit",
              "events",
              "personal-blog",
              "entertainment",
              "local-business"
            ]
          },
          "maxItems": 8,
          "uniqueItems": true,
          "description": "Inferred topic IDs from publisher metadata; empty means unclassified."
        },
        "inferred_tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Topic tags inferred by the AI classifier from the site text."
        },
        "audience": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "developers",
                "consumers",
                "business",
                "mixed"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "agent_uses": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "read_docs",
              "call_api",
              "buy",
              "book",
              "search_content",
              "download_data",
              "contact_support"
            ]
          },
          "uniqueItems": true
        },
        "language": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "type": [
            "string",
            "null"
          ],
          "description": "Published or declared address country preferred; domain/hosting fallback. Null when unknown. Not independently verified headquarters or markets served."
        },
        "country_source": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "owner",
            "structured_data",
            "contact_page",
            "tld",
            "ip",
            "cdn",
            null
          ],
          "description": "owner: owner-declared address; structured_data/contact_page: site-published address; tld: domain inference; ip: non-CDN hosting inference; cdn: location withheld. No source independently verifies headquarters."
        },
        "publisher_country": {
          "type": [
            "string",
            "null"
          ]
        },
        "publisher_country_source": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "owner",
            "structured_data",
            "contact_page",
            null
          ]
        },
        "hosting_country": {
          "type": [
            "string",
            "null"
          ]
        },
        "platform_generated": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "agent_summary": {
          "type": [
            "string",
            "null"
          ]
        },
        "llms_txt_cached": {
          "type": "string"
        },
        "agentic": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "interface",
                "transactional",
                "documentation",
                "informational"
              ],
              "description": "What an agent can do with the site: interface (API or MCP endpoint to call), transactional (buy or book), documentation (docs to read), informational (for people)."
            },
            {
              "type": "null"
            }
          ]
        },
        "section_keys": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "section_partial": {
          "type": "boolean"
        },
        "section_indexed_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "capabilities": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "mcp"
            ]
          },
          "uniqueItems": true,
          "description": "Publisher-declared capabilities. An MCP declaration does not prove availability or protocol compatibility."
        },
        "section_headings": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "key": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "level": {
                "type": "integer"
              },
              "path": {
                "type": "string"
              },
              "line": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "format": {
                "enum": [
                  "markdown",
                  "loose",
                  "setext",
                  "indexed_link"
                ]
              },
              "source_url": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "key",
              "label",
              "level",
              "path",
              "line",
              "format"
            ],
            "additionalProperties": false
          }
        },
        "verified_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "nested_llms_txt": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "contact": {
          "type": [
            "string",
            "null"
          ]
        },
        "sections": {
          "type": [
            "integer",
            "null"
          ]
        },
        "links": {
          "type": [
            "integer",
            "null"
          ]
        },
        "rank": {
          "type": [
            "integer",
            "null"
          ]
        },
        "registered_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "first_seen": {
          "type": [
            "string",
            "null"
          ]
        },
        "badge": {
          "type": "string"
        },
        "claim": {
          "type": "object",
          "properties": {
            "agent_prompt": {
              "type": "string"
            },
            "hint": {
              "type": "string"
            },
            "verification": {
              "type": "string"
            },
            "verify": {
              "type": "string"
            },
            "docs": {
              "type": "string"
            },
            "mcp": {
              "type": "string"
            },
            "benefits": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "agent_prompt",
            "hint",
            "verification",
            "verify",
            "docs",
            "mcp",
            "benefits"
          ],
          "additionalProperties": false
        },
        "domain_country": {
          "type": [
            "string",
            "null"
          ]
        },
        "country_checked_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "country_status": {
          "type": "string"
        },
        "country_evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "country": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "checked_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "method": {
                "type": "string"
              }
            },
            "required": [
              "country",
              "source",
              "url",
              "checked_at",
              "method"
            ],
            "additionalProperties": false
          }
        },
        "why": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "match_score": {
          "type": "number"
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string"
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "excerpt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "source_url": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": true
          }
        },
        "category_evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "enum": [
                  "ai-ml",
                  "developer-tools",
                  "infrastructure",
                  "data-analytics",
                  "cybersecurity",
                  "finance-payments",
                  "ecommerce",
                  "productivity",
                  "marketing",
                  "education",
                  "healthcare",
                  "media",
                  "design",
                  "gaming",
                  "travel",
                  "community",
                  "legal",
                  "recruiting-careers",
                  "industrial-manufacturing",
                  "real-estate",
                  "arts-culture",
                  "sports-fitness",
                  "food-dining",
                  "automotive",
                  "government-public-services",
                  "science-research",
                  "ai-agents-mcp",
                  "apis-sdks",
                  "databases",
                  "auth-identity",
                  "devops-observability",
                  "no-code-automation",
                  "communications",
                  "crypto-web3",
                  "saas-business-software",
                  "open-source",
                  "documentation-reference",
                  "fashion-beauty",
                  "home-garden",
                  "consumer-electronics",
                  "pets",
                  "insurance",
                  "telecom",
                  "logistics-shipping",
                  "energy-utilities",
                  "construction-architecture",
                  "agriculture",
                  "nonprofit",
                  "events",
                  "personal-blog",
                  "entertainment",
                  "local-business"
                ]
              },
              "confidence": {
                "type": "number",
                "minimum": 0,
                "maximum": 1,
                "description": "Deterministic rule strength, not a calibrated probability."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "source": {
                "enum": [
                  "publisher_metadata",
                  "llm"
                ]
              }
            },
            "required": [
              "id",
              "confidence",
              "evidence",
              "source"
            ],
            "additionalProperties": false
          }
        },
        "category_version": {
          "type": [
            "string",
            "null"
          ]
        },
        "categorized_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "capability_evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "const": "mcp"
              },
              "url": {
                "type": "string"
              },
              "source_url": {
                "type": "string"
              },
              "status": {
                "const": "publisher_declared"
              }
            },
            "required": [
              "id",
              "url",
              "source_url",
              "status"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "domain",
        "status",
        "tier",
        "authority",
        "verified",
        "title",
        "summary",
        "llms_txt",
        "llms_full_txt",
        "last_checked",
        "agent_terms",
        "categories",
        "capabilities"
      ],
      "additionalProperties": false
    },
    "read": {
      "type": "object",
      "properties": {
        "llms_txt": {
          "type": [
            "string",
            "null"
          ]
        },
        "llms_full_txt": {
          "type": [
            "string",
            "null"
          ]
        },
        "nested_llms_txt": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "llms_txt",
        "llms_full_txt",
        "nested_llms_txt"
      ],
      "additionalProperties": false
    },
    "terms": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "automated_access": {
              "type": "string",
              "enum": [
                "welcome",
                "limited",
                "ask",
                "not_allowed"
              ]
            },
            "rate_limit": {
              "type": "string",
              "maxLength": 100
            },
            "attribution": {
              "type": "string",
              "enum": [
                "required",
                "appreciated",
                "none"
              ]
            },
            "attribution_text": {
              "type": "string",
              "maxLength": 200
            },
            "pricing": {
              "type": "string",
              "enum": [
                "free",
                "freemium",
                "paid"
              ]
            },
            "pricing_url": {
              "type": "string"
            },
            "terms_url": {
              "type": "string"
            },
            "notes": {
              "type": "string",
              "maxLength": 500
            }
          },
          "required": [],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "health": {
      "type": "object",
      "properties": {
        "ok": {
          "type": "boolean"
        },
        "status": {
          "type": "string",
          "enum": [
            "pending",
            "valid",
            "invalid",
            "unreachable"
          ]
        },
        "tier": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "featured",
            "listed",
            "unlisted",
            "rejected",
            null
          ]
        },
        "authority": {
          "type": [
            "integer",
            "null"
          ]
        },
        "last_checked": {
          "type": [
            "string",
            "null"
          ]
        },
        "checked_minutes_ago": {
          "type": [
            "integer",
            "null"
          ]
        },
        "stale": {
          "type": "boolean"
        },
        "max_age_seconds": {
          "type": "integer",
          "minimum": 0
        },
        "live_checked": {
          "type": "boolean"
        },
        "http_status": {
          "type": [
            "integer",
            "null"
          ]
        },
        "last_valid": {
          "type": [
            "string",
            "null"
          ]
        },
        "content_hash": {
          "type": [
            "string",
            "null"
          ]
        },
        "documentation_indexed_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "recheck_queued": {
          "type": "boolean"
        }
      },
      "required": [
        "ok",
        "status",
        "tier",
        "authority",
        "last_checked",
        "checked_minutes_ago",
        "stale",
        "max_age_seconds",
        "live_checked",
        "http_status",
        "last_valid",
        "content_hash"
      ],
      "additionalProperties": false
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "excerpt": {
            "type": [
              "string",
              "null"
            ]
          },
          "section": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_url": {
            "type": "string"
          },
          "match_score": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "checked_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "content_hash": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url",
          "title",
          "excerpt",
          "section",
          "source_url",
          "match_score",
          "checked_at",
          "content_hash"
        ],
        "additionalProperties": false
      }
    },
    "match": {
      "type": "object",
      "properties": {
        "strength": {
          "type": "string",
          "enum": [
            "domain",
            "strong",
            "weak"
          ]
        },
        "reason": {
          "type": "string"
        }
      },
      "required": [
        "strength",
        "reason"
      ],
      "additionalProperties": false
    },
    "provenance": {
      "type": "object",
      "properties": {
        "selection": {
          "enum": [
            "directory",
            "directory+semantic"
          ]
        },
        "reranked": {
          "type": "boolean"
        },
        "verification": {
          "const": "domain_ownership"
        },
        "terms": {
          "type": "string",
          "enum": [
            "owner_stated",
            "unknown"
          ]
        },
        "excerpts": {
          "const": "publisher_link_metadata"
        },
        "health": {
          "type": "string",
          "enum": [
            "live_check",
            "stored_crawl"
          ]
        }
      },
      "required": [
        "selection",
        "verification",
        "terms",
        "excerpts",
        "health"
      ],
      "additionalProperties": false
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "authority": {
            "type": [
              "integer",
              "null"
            ]
          },
          "tier": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "featured",
              "listed",
              "unlisted",
              "rejected",
              null
            ]
          },
          "verified": {
            "type": "boolean"
          },
          "llms_txt": {
            "type": [
              "string",
              "null"
            ]
          },
          "match_score": {
            "type": "number"
          }
        },
        "required": [
          "domain",
          "title",
          "authority",
          "tier",
          "verified",
          "llms_txt"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "query",
    "mode",
    "best",
    "read",
    "terms",
    "health",
    "sources",
    "match",
    "provenance",
    "alternatives"
  ],
  "additionalProperties": false
}