{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Agent Tool surface",
  "type": "object",
  "required": [
    "schema_version",
    "surface_id",
    "scope"
  ],
  "properties": {
    "schema_version": {
      "type": "string"
    },
    "surface_id": {
      "type": "string"
    },
    "scope": {
      "type": "string"
    },
    "created_at": {
      "type": "string"
    },
    "producer": {
      "type": "string"
    },
    "tool_refs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "loaded_tools": {
      "type": "array",
      "items": {}
    },
    "deferred_tools": {
      "type": "array",
      "items": {}
    },
    "blocked_tools": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "excluded_tools": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "selection_policy": {
      "type": "object",
      "additionalProperties": true
    },
    "default_tool_choice": {},
    "capability_requirements": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "model_capabilities": {
      "type": "object",
      "additionalProperties": true
    },
    "role_constraints": {
      "type": "object",
      "additionalProperties": true
    },
    "surface_reason": {
      "type": "string"
    },
    "policy_refs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "runtime_refs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true
}