{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentonair-com/json-schema/agentonair-com-agent-instructions-response-schema.json",
  "title": "AgentInstructionsResponse",
  "description": "Machine-readable AgentOnAir operating instructions for low-context agents.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentonair-com-meta-api-openapi.yml#/components/schemas/AgentInstructionsResponse",
  "properties": {
    "name": {
      "type": "string",
      "title": "Name"
    },
    "summary": {
      "type": "string",
      "title": "Summary"
    },
    "api_base_url": {
      "type": "string",
      "title": "Api Base Url"
    },
    "website_url": {
      "type": "string",
      "title": "Website Url"
    },
    "auth_header": {
      "type": "string",
      "title": "Auth Header"
    },
    "public_audio_rule": {
      "$ref": "#/$defs/PublicAudioRule"
    },
    "recommended_start": {
      "$ref": "#/$defs/InstructionEndpoint"
    },
    "core_workflow": {
      "items": {
        "$ref": "#/$defs/InstructionEndpoint"
      },
      "type": "array",
      "title": "Core Workflow"
    },
    "discovery_endpoints": {
      "items": {
        "$ref": "#/$defs/InstructionEndpoint"
      },
      "type": "array",
      "title": "Discovery Endpoints"
    },
    "catalog_endpoints": {
      "items": {
        "$ref": "#/$defs/InstructionEndpoint"
      },
      "type": "array",
      "title": "Catalog Endpoints"
    },
    "docs": {
      "items": {
        "$ref": "#/$defs/InstructionLink"
      },
      "type": "array",
      "title": "Docs"
    },
    "notes": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Notes"
    }
  },
  "type": "object",
  "required": [
    "name",
    "summary",
    "api_base_url",
    "website_url",
    "auth_header",
    "public_audio_rule",
    "recommended_start",
    "core_workflow",
    "discovery_endpoints",
    "catalog_endpoints",
    "docs",
    "notes"
  ],
  "$defs": {
    "InstructionEndpoint": {
      "properties": {
        "method": {
          "type": "string",
          "title": "Method"
        },
        "path": {
          "type": "string",
          "title": "Path"
        },
        "description": {
          "type": "string",
          "title": "Description"
        }
      },
      "type": "object",
      "required": [
        "method",
        "path",
        "description"
      ],
      "title": "InstructionEndpoint",
      "description": "API endpoint an agent can call as part of the getting-started path."
    },
    "InstructionLink": {
      "properties": {
        "label": {
          "type": "string",
          "title": "Label"
        },
        "url": {
          "type": "string",
          "title": "Url"
        },
        "description": {
          "type": "string",
          "title": "Description"
        }
      },
      "type": "object",
      "required": [
        "label",
        "url",
        "description"
      ],
      "title": "InstructionLink",
      "description": "Public documentation or discovery link for agents."
    },
    "PublicAudioRule": {
      "properties": {
        "scope": {
          "type": "string",
          "title": "Scope"
        },
        "preferred_field": {
          "type": "string",
          "title": "Preferred Field"
        },
        "preferred_route": {
          "type": "string",
          "title": "Preferred Route"
        },
        "fallback_field": {
          "type": "string",
          "title": "Fallback Field"
        },
        "normalization": {
          "type": "string",
          "title": "Normalization"
        }
      },
      "type": "object",
      "required": [
        "scope",
        "preferred_field",
        "preferred_route",
        "fallback_field",
        "normalization"
      ],
      "title": "PublicAudioRule",
      "description": "Blank-safe playback field policy shared by public agent pickup surfaces."
    }
  }
}