Bound paged retrieval responses

schemas/result.schema.json

@@ -132,6 +132,41 @@
         }
       },
       "additionalProperties": false
+    },
+    "pagination": {
+      "type": "object",
+      "required": [
+        "schema_version",
+        "kind",
+        "returned_count",
+        "limit",
+        "total_count",
+        "has_more",
+        "next_cursor"
+      ],
+      "properties": {
+        "schema_version": { "const": 1 },
+        "kind": {
+          "enum": [
+            "context.items",
+            "changeset.list",
+            "changeset.inspect",
+            "changeset.validate",
+            "changeset.diff",
+            "changeset.diff-chunks"
+          ]
+        },
+        "returned_count": { "type": "integer", "minimum": 0 },
+        "limit": { "type": "integer", "minimum": 1 },
+        "total_count": { "type": "integer", "minimum": 0 },
+        "has_more": { "type": "boolean" },
+        "next_cursor": {
+          "type": ["string", "null"],
+          "minLength": 1,
+          "maxLength": 8192
+        }
+      },
+      "additionalProperties": false
     }
   },
   "oneOf": [
@@ -147,6 +182,7 @@
           "pattern": "^[0-9a-f]{64}$"
         },
         "adapter": { "type": "string" },
+        "pagination": { "$ref": "#/$defs/pagination" },
         "diagnostics": { "$ref": "#/$defs/diagnostics" }
       },
       "additionalProperties": true