https://raw.githubusercontent.com/acp-protocol/acp-spec/main/schemas/v1/vars.schema.json

{
  "$schema": "https://json-schema.org/draft-07/schema#",
  "$id": "https://acp-protocol.dev/schemas/v1/vars.schema.json",
  "title": "ACP Variables File",
  "description": "AI Context Protocol variables file format (.acp.vars.json)",
  "type": "object",
  "required": [
    "version",
    "variables"
  ],
  "properties": {
    "version": {
      "type": "string",
      "description": "ACP specification version",
      "pattern": "^\\d+\\.\\d+\\.\\d+",
      "examples": [
        "1.0.0"
      ]
    },
    "variables": {
      "type": "object",
      "description": "Map of variable names to variable entries",
      "additionalProperties": {
        "$ref": "#/$defs/variable_entry"
      }
    }
  },
  "$defs": {
    "variable_entry": {
      "type": "object",
      "required": [
        "type",
        "value"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "symbol",
            "file",
            "domain",
            "layer",
            "pattern",
            "context"
          ],
          "description": "Variable type"
        },
        "value": {
          "type": "string",
          "description": "Reference value (qualified name, path, etc.)"
        },
        "description": {
          "type": "string",
          "description": "Human-readable description"
        },
        "refs": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "default": [],
          "description": "References to other variables (for inheritance chains)"
        },
        "source": {
          "type": "string",
          "description": "Source file path where the variable is defined"
        },
        "lines": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "minItems": 2,
          "maxItems": 2,
          "description": "[start_line, end_line] range in source file"
        }
      }
    }
  }
}