{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://heartcortex.ai/schemas/1.0/page.schema.json",
  "title": "Page of messages",
  "type": "object",
  "required": ["items"],
  "properties": {
    "items": { "type": "array", "items": { "$ref": "envelope.schema.json" } },
    "nextCursor": { "type": ["string", "null"] },
    "gap": {
      "description": "True when requested history has been discarded by retention, so the sequence is not contiguous.",
      "type": "boolean"
    }
  }
}