{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://sunterminal.net/schemas/error-v1.schema.json",
  "title": "Sun Terminal consultation error v1",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_version",
    "error"
  ],
  "properties": {
    "schema_version": {
      "const": "sun-terminal.error@1"
    },
    "error": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "code",
        "message",
        "retryable"
      ],
      "properties": {
        "code": {
          "enum": [
            "agent_door_unavailable",
            "encounter_failed",
            "encounter_recovery_required",
            "idempotency_commit_unknown",
            "idempotency_conflict",
            "idempotency_key_expired",
            "instrument_not_found",
            "instrument_version_unavailable",
            "invalid_json",
            "invalid_request",
            "method_not_allowed",
            "payload_too_large",
            "rate_limit_unavailable",
            "rate_limited",
            "service_unavailable"
          ]
        },
        "message": {
          "type": "string",
          "minLength": 1
        },
        "retryable": {
          "type": "boolean"
        }
      },
      "oneOf": [
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "agent_door_unavailable"
            },
            "retryable": {
              "const": true
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "encounter_failed"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "encounter_recovery_required"
            },
            "retryable": {
              "const": true
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "idempotency_commit_unknown"
            },
            "retryable": {
              "const": true
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "idempotency_conflict"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "idempotency_key_expired"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "instrument_not_found"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "instrument_version_unavailable"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "invalid_json"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "invalid_request"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "method_not_allowed"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "payload_too_large"
            },
            "retryable": {
              "const": false
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "rate_limit_unavailable"
            },
            "retryable": {
              "const": true
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "rate_limited"
            },
            "retryable": {
              "const": true
            }
          }
        },
        {
          "type": "object",
          "required": [
            "code",
            "retryable"
          ],
          "properties": {
            "code": {
              "const": "service_unavailable"
            },
            "retryable": {
              "const": true
            }
          }
        }
      ]
    }
  },
  "examples": [
    {
      "schema_version": "sun-terminal.error@1",
      "error": {
        "code": "idempotency_conflict",
        "message": "This idempotency key is already bound to different canonical input.",
        "retryable": false
      }
    }
  ]
}