{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schemaVersion",
    "installationId",
    "items",
    "nextCursor"
  ],
  "properties": {
    "schemaVersion": {
      "const": 1
    },
    "installationId": {
      "$ref": "#/$defs/d0_installationId"
    },
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/d1_observation"
      }
    },
    "nextCursor": {
      "oneOf": [
        {
          "$ref": "#/$defs/d2_cursor"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "$defs": {
    "d0_installationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "d2_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "d3_dateTime": {
      "type": "string",
      "format": "date-time"
    },
    "d4_uint256": {
      "type": "string",
      "pattern": "^(0|[1-9][0-9]*)$",
      "maxLength": 78,
      "format": "uint256-decimal"
    },
    "d1_observation": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "cursor",
        "telemetryId",
        "installationId",
        "bootId",
        "sequence",
        "observedAt",
        "receivedAt",
        "counterEpoch",
        "cumulativeWorkUnits",
        "provenance",
        "softwareVersion"
      ],
      "properties": {
        "cursor": {
          "$ref": "#/$defs/d2_cursor"
        },
        "telemetryId": {
          "type": "string",
          "format": "uuid"
        },
        "installationId": {
          "$ref": "#/$defs/d0_installationId"
        },
        "bootId": {
          "type": "string",
          "format": "uuid"
        },
        "sequence": {
          "type": "integer",
          "minimum": 0
        },
        "observedAt": {
          "$ref": "#/$defs/d3_dateTime"
        },
        "receivedAt": {
          "$ref": "#/$defs/d3_dateTime"
        },
        "counterEpoch": {
          "type": "string",
          "format": "uuid"
        },
        "cumulativeWorkUnits": {
          "$ref": "#/$defs/d4_uint256"
        },
        "provenance": {
          "enum": [
            "hardware",
            "simulated",
            "replay",
            "derived"
          ]
        },
        "softwareVersion": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        }
      }
    }
  },
  "$comment": "Public response structure from source snapshot 9e38b9313c9b4926ad15c7cd691d7f5789bdbc55. See endpoint notes for semantic constraints."
}
