{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agent-call.local/contracts/ai-config.schema.json",
  "title": "Immutable AI agent version",
  "type": "object",
  "additionalProperties": false,
  "required": ["agent_version_id", "immutable", "llm", "prompt", "tts", "asr", "conversation"],
  "properties": {
    "agent_version_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"},
    "immutable": {"const": true},
    "llm": {
      "type": "object",
      "additionalProperties": false,
      "required": ["provider_ref", "model"],
      "properties": {
        "provider_ref": {"type": "string", "minLength": 1, "maxLength": 128},
        "credential_ref": {"type": "string", "minLength": 1, "maxLength": 128},
        "model": {"type": "string", "minLength": 1, "maxLength": 128},
        "temperature": {"type": "number", "minimum": 0, "maximum": 2},
        "max_tokens": {"type": "integer", "minimum": 1},
        "timeout_ms": {"type": "integer", "minimum": 1}
      }
    },
    "prompt": {
      "type": "object",
      "additionalProperties": false,
      "required": ["text", "allowed_variables"],
      "properties": {
        "text": {"type": "string", "minLength": 1, "maxLength": 32768},
        "allowed_variables": {
          "type": "array",
          "maxItems": 32,
          "items": {"type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"}
        },
        "max_bytes": {"type": "integer", "minimum": 1, "maximum": 32768}
      }
    },
    "tts": {
      "type": "object",
      "additionalProperties": false,
      "required": ["provider_ref", "model", "voice", "format"],
      "properties": {
        "provider_ref": {"type": "string", "minLength": 1, "maxLength": 128},
        "credential_ref": {"type": "string", "minLength": 1, "maxLength": 128},
        "model": {"type": "string", "minLength": 1, "maxLength": 128},
        "voice": {"type": "string", "minLength": 1, "maxLength": 128},
        "speed": {"type": "number", "minimum": 0.25, "maximum": 3},
        "timeout_ms": {"type": "integer", "minimum": 1},
        "format": {
          "type": "object",
          "additionalProperties": false,
          "required": ["encoding", "sample_rate_hz", "channels"],
          "properties": {
            "encoding": {"enum": ["pcm_s16le", "pcma"]},
            "sample_rate_hz": {"type": "integer", "minimum": 8000, "maximum": 48000},
            "channels": {"const": 1}
          }
        }
      }
    },
    "asr": {
      "type": "object",
      "additionalProperties": false,
      "required": ["provider_ref", "language", "input"],
      "properties": {
        "provider_ref": {"type": "string", "minLength": 1, "maxLength": 128},
        "credential_ref": {"type": "string", "minLength": 1, "maxLength": 128},
        "model": {"type": "string", "minLength": 1, "maxLength": 128},
        "language": {"type": "string", "minLength": 1, "maxLength": 32},
        "interim": {"type": "boolean"},
        "timeout_ms": {"type": "integer", "minimum": 1},
        "input": {
          "type": "object",
          "additionalProperties": false,
          "required": ["encoding", "sample_rate_hz", "channels", "sample_width_bytes"],
          "properties": {
            "encoding": {"const": "pcm_s16le"},
            "sample_rate_hz": {"type": "integer", "minimum": 8000, "maximum": 48000},
            "channels": {"const": 1},
            "sample_width_bytes": {"const": 2}
          }
        }
      }
    },
    "conversation": {
      "type": "object",
      "additionalProperties": false,
      "required": ["opening", "allow_interrupt", "silence_timeout_ms", "max_duration_ms", "max_turns", "sentence_max_chars", "max_pending_audio_chunks"],
      "properties": {
        "opening": {"type": "string", "maxLength": 32768},
        "allow_interrupt": {"type": "boolean"},
        "silence_timeout_ms": {"type": "integer", "minimum": 1},
        "max_duration_ms": {"type": "integer", "minimum": 1, "maximum": 3600000},
        "max_turns": {"type": "integer", "minimum": 1, "maximum": 1000},
        "sentence_max_chars": {"type": "integer", "minimum": 1},
        "max_pending_audio_chunks": {"type": "integer", "minimum": 1}
      }
    },
    "metadata": {"type": "object", "additionalProperties": true}
  }
}