@mdbase-dev/sdk 0.0.0-stage → 0.1.0-beta.149

package/node_modules/@mdbase-dev/connect-protocol/schemas/connect-protocol.v1.schema.json

@@ -0,0 +1,901 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/connect/schemas/connect-protocol.v1.json",
+  "title": "mdbase connect protocol 1",
+  "description": "Canonical wire shapes shared by applications, the control plane, and connectors.",
+  "oneOf": [
+    { "$ref": "#/$defs/relayHello" },
+    { "$ref": "#/$defs/relayWelcome" },
+    { "$ref": "#/$defs/relayIncompatible" },
+    { "$ref": "#/$defs/relayOperationRequest" },
+    { "$ref": "#/$defs/relayOperationResponse" },
+    { "$ref": "#/$defs/relayPolicySnapshot" },
+    { "$ref": "#/$defs/relayPolicyApplied" },
+    { "$ref": "#/$defs/authorizationOfferRequest" },
+    { "$ref": "#/$defs/authorizationOfferResponse" },
+    { "$ref": "#/$defs/authorizationActivationRequest" },
+    { "$ref": "#/$defs/authorizationActivationResponse" }
+  ],
+  "$defs": {
+    "uuid": {
+      "type": "string",
+      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+    },
+    "operation": {
+      "enum": ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "assess_collection_setup", "apply_collection_setup", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync"]
+    },
+    "connectContractRequirements": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operation_transport", "authorization_binding", "semantic_capabilities"],
+      "properties": {
+        "operation_transport": { "type": "integer", "minimum": 1 },
+        "authorization_binding": { "type": "integer", "minimum": 1 },
+        "semantic_capabilities": { "type": "integer", "minimum": 1 },
+        "durable_mutation": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "connectContractSupport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operation_transport", "authorization_binding", "semantic_capabilities", "durable_mutation"],
+      "properties": {
+        "operation_transport": { "$ref": "#/$defs/versionSet" },
+        "authorization_binding": { "$ref": "#/$defs/versionSet" },
+        "semantic_capabilities": { "$ref": "#/$defs/versionSet" },
+        "durable_mutation": { "$ref": "#/$defs/versionSet" }
+      }
+    },
+    "versionSet": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "integer", "minimum": 1 }
+    },
+    "contractRequirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "digest"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" },
+        "version": { "$ref": "#/$defs/semanticVersion" },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "semanticVersion": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "grantScope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["access", "contracts"],
+      "properties": {
+        "access": { "enum": ["contract", "full_collection"] },
+        "contracts": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/collectionContract" }
+        }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["severity", "code", "message"],
+      "properties": {
+        "severity": { "enum": ["error", "warning", "info"] },
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "field": { "type": "string" },
+        "type": { "type": "string" },
+        "schema_location": { "type": "string" },
+        "details": true
+      }
+    },
+    "operationEnvelope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["valid", "result", "diagnostics"],
+      "properties": {
+        "valid": { "type": "boolean" },
+        "result": true,
+        "diagnostics": { "type": "array", "items": { "$ref": "#/$defs/diagnostic" } }
+      }
+    },
+    "relayHello": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "connector_version", "capabilities", "contract_support"],
+      "properties": {
+        "type": { "const": "relay_hello" },
+        "protocol_version": { "const": 1 },
+        "connector_version": { "type": "string", "minLength": 1, "maxLength": 100 },
+        "capabilities": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 100 }
+        },
+        "contract_support": { "$ref": "#/$defs/connectContractSupport" }
+      }
+    },
+    "relayWelcome": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "session_id", "capabilities", "contract_support"],
+      "properties": {
+        "type": { "const": "relay_welcome" },
+        "protocol_version": { "const": 1 },
+        "session_id": { "type": "string", "minLength": 1, "maxLength": 100 },
+        "capabilities": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 100 }
+        },
+        "contract_support": { "$ref": "#/$defs/connectContractSupport" }
+      }
+    },
+    "relayIncompatible": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "code", "message", "minimum_connector_version", "update_url"],
+      "properties": {
+        "type": { "const": "relay_incompatible" },
+        "protocol_version": { "const": 1 },
+        "code": { "enum": ["connector_upgrade_required", "transport_protocol_incompatible", "authorization_binding_incompatible", "capability_contract_incompatible", "durable_mutation_unsupported"] },
+        "message": { "type": "string", "minLength": 1 },
+        "details": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["contract", "required", "supported", "peer"],
+          "properties": {
+            "contract": { "enum": ["operation_transport", "authorization_binding", "semantic_capabilities", "durable_mutation"] },
+            "required": { "$ref": "#/$defs/versionSet" },
+            "supported": { "type": "array", "uniqueItems": true, "items": { "type": "integer", "minimum": 1 } },
+            "peer": { "const": "connector" }
+          }
+        },
+        "minimum_connector_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?$" },
+        "update_url": { "type": "string", "format": "uri", "pattern": "^https://" }
+      }
+    },
+    "relayOperationRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "grant_id", "collection_id", "application_id", "operation", "input"],
+      "properties": {
+        "type": { "const": "operation_request" },
+        "protocol_version": { "const": 3 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "grant_id": { "$ref": "#/$defs/uuid" },
+        "collection_id": { "$ref": "#/$defs/uuid" },
+        "application_id": { "$ref": "#/$defs/uuid" },
+        "operation": { "$ref": "#/$defs/operation" },
+        "input": true
+      }
+    },
+    "operationHttpRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol_version", "request_id", "input"],
+      "properties": {
+        "protocol_version": { "const": 3 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "input": true
+      }
+    },
+    "operationHttpResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol_version", "request_id", "ok"],
+      "properties": {
+        "protocol_version": { "const": 3 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "ok": { "type": "boolean" },
+        "result": true,
+        "problem": { "$ref": "https://schemas.mdbase.dev/connect/problem/v1" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "ok": { "const": true } }, "required": ["ok"] },
+          "then": {
+            "required": ["result"],
+            "not": { "properties": { "problem": true }, "required": ["problem"] }
+          },
+          "else": {
+            "required": ["problem"],
+            "not": { "properties": { "result": true }, "required": ["result"] }
+          }
+        }
+      ]
+    },
+    "relayOperationResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "ok"],
+      "properties": {
+        "type": { "const": "operation_response" },
+        "protocol_version": { "const": 3 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "ok": { "type": "boolean" },
+        "result": true,
+        "problem": { "$ref": "https://schemas.mdbase.dev/connect/problem/v1" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "ok": { "const": true } }, "required": ["ok"] },
+          "then": {
+            "properties": { "result": true },
+            "required": ["result"],
+            "not": { "properties": { "problem": true }, "required": ["problem"] }
+          },
+          "else": {
+            "properties": { "problem": true },
+            "required": ["problem"],
+            "not": { "properties": { "result": true }, "required": ["result"] }
+          }
+        }
+      ]
+    },
+    "grantPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "application_id", "collection_id", "operations", "scope", "application_name", "application_distribution", "application_homepage", "application_origin", "collection_name", "created_at", "encryption", "application_authorization"],
+      "properties": {
+        "account_id": { "$ref": "#/$defs/uuid" },
+        "id": { "$ref": "#/$defs/uuid" },
+        "application_id": { "$ref": "#/$defs/uuid" },
+        "collection_id": { "$ref": "#/$defs/uuid" },
+        "operations": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/operation" } },
+        "scope": { "$ref": "#/$defs/grantScope" },
+        "application_name": { "type": "string", "minLength": 1 },
+        "application_distribution": { "enum": ["web", "portable"] },
+        "application_homepage": { "type": "string" },
+        "application_project_url": { "type": "string", "format": "uri" },
+        "application_origin": {
+          "anyOf": [
+            { "const": "null" },
+            { "type": "string", "format": "uri" }
+          ]
+        },
+        "application_icon": { "type": "string" },
+        "collection_name": { "type": "string", "minLength": 1 },
+        "notification_criteria": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/notificationCriterion" }
+        },
+        "created_at": { "type": "string", "format": "date-time" },
+        "encryption": { "$ref": "#/$defs/grantEncryption" },
+        "file_capability": {
+          "$ref": "https://mdbase.dev/connect/schemas/files.v1.json#/$defs/fileCapability"
+        },
+        "application_declaration": {},
+        "application_authorization": { "$ref": "#/$defs/applicationAuthorizationProof" }
+      }
+    },
+    "applicationAuthorizationProof": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["binding", "signature"],
+      "properties": {
+        "binding": { "$ref": "#/$defs/applicationAuthorizationBinding" },
+        "signature": { "type": "string", "pattern": "^[A-Za-z0-9_-]{86}$" }
+      }
+    },
+    "applicationAuthorizationBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol_version", "authorization_id", "application_id", "application_declaration_id", "application_manifest_digest", "application_installation_id", "installation_signing_public_key", "grant_agreement_public_key", "grant_signing_public_key", "flow", "authorization_nonce", "issued_at", "expires_at", "code_challenge", "contracts", "requested_operations"],
+      "properties": {
+        "protocol_version": { "const": 4 },
+        "authorization_id": { "$ref": "#/$defs/uuid" },
+        "application_id": { "$ref": "#/$defs/uuid" },
+        "application_declaration_id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)+$" },
+        "application_manifest_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "application_installation_id": { "$ref": "#/$defs/uuid" },
+        "installation_signing_public_key": { "$ref": "#/$defs/p256PublicKey" },
+        "grant_agreement_public_key": { "$ref": "#/$defs/p256PublicKey" },
+        "grant_signing_public_key": { "$ref": "#/$defs/p256PublicKey" },
+        "flow": { "enum": ["authorization_code", "device_code"] },
+        "authorization_nonce": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" },
+        "issued_at": { "type": "string", "format": "date-time" },
+        "expires_at": { "type": "string", "format": "date-time" },
+        "redirect_uri": { "type": "string", "format": "uri" },
+        "state": { "type": "string", "maxLength": 500 },
+        "code_challenge": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" },
+        "contracts": { "$ref": "#/$defs/connectContractRequirements" },
+        "requested_operations": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/operation" }
+        },
+        "requested_files": {
+          "$ref": "https://mdbase.dev/connect/schemas/files.v1.json#/$defs/applicationFileRequirement"
+        },
+        "collection_id": { "$ref": "#/$defs/uuid" }
+      }
+    },
+    "p256PublicKey": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{87}$"
+    },
+    "authorizationCollectionOffer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["collection_id", "display_name", "spec_version", "contracts"],
+      "properties": {
+        "collection_id": { "$ref": "#/$defs/uuid" },
+        "display_name": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "spec_version": { "type": "string", "minLength": 1, "maxLength": 30 },
+        "contracts": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/collectionContract" }
+        },
+        "types": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/authorizationTypeCandidate" }
+        }
+      }
+    },
+    "applicationRequirements": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contracts"],
+      "properties": {
+        "contracts": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/contractRequirement" }
+        },
+        "configuration": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/configurationRequirement" }
+        },
+        "access": { "enum": ["contract", "full_collection"] },
+        "collection_kind": { "const": "hosted" },
+        "files": {
+          "$ref": "https://mdbase.dev/connect/schemas/files.v1.json#/$defs/applicationFileRequirement"
+        }
+      }
+    },
+    "typePackProvision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["manifest", "resources", "provides"],
+      "properties": {
+        "manifest": { "$ref": "#/$defs/typePackManifest" },
+        "resources": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/typePackSourceResource" }
+        },
+        "provides": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/contractRequirement" }
+        }
+      }
+    },
+    "typePackManifest": {
+      "type": "object",
+      "required": ["kind", "id", "version", "resources"],
+      "properties": {
+        "kind": { "const": "mdbase.type-pack" },
+        "id": { "type": "string", "minLength": 3 },
+        "version": { "$ref": "#/$defs/semanticVersion" },
+        "name": { "type": "string", "minLength": 1 },
+        "description": { "type": "string" },
+        "resources": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/typePackManifestResource" }
+        }
+      },
+      "patternProperties": { "^x-[A-Za-z][A-Za-z0-9._:-]{0,127}$": true },
+      "additionalProperties": false
+    },
+    "typePackManifestResource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "mode", "source", "target", "digest"],
+      "properties": {
+        "kind": { "enum": ["contract", "type", "schema"] },
+        "mode": { "enum": ["managed", "seed"] },
+        "upgrade_from": {
+          "oneOf": [
+            { "$ref": "#/$defs/typePackUpgradeBaseline" },
+            { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/typePackUpgradeBaseline" } }
+          ]
+        },
+        "source": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "target": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "typePackUpgradeBaseline": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["digest", "document"],
+      "properties": {
+        "digest": { "$ref": "#/$defs/digest" },
+        "document": { "type": "string", "maxLength": 262144 },
+        "version": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "typePackSourceResource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "document"],
+      "properties": {
+        "source": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "document": { "type": "string", "maxLength": 262144 }
+      }
+    },
+    "applicationProvisions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type_packs"],
+      "properties": {
+        "type_packs": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/typePackProvision" }
+        },
+        "configuration": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/configurationProvision" }
+        }
+      }
+    },
+    "configurationRequirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "predicate", "value"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+        "path": { "type": "string", "pattern": "^(?:/settings/record_extensions|/x-[^/]+(?:/.*)?)$", "maxLength": 1024 },
+        "predicate": { "const": "contains" },
+        "value": { "oneOf": [
+          { "type": "string" },
+          { "type": "number" },
+          { "type": "boolean" },
+          { "type": "null" }
+        ] }
+      }
+    },
+    "configurationProvision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requirement", "operation", "path", "value"],
+      "properties": {
+        "requirement": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+        "operation": { "const": "set_add" },
+        "path": { "type": "string", "pattern": "^(?:/settings/record_extensions|/x-[^/]+(?:/.*)?)$", "maxLength": 1024 },
+        "value": { "oneOf": [
+          { "type": "string" },
+          { "type": "number" },
+          { "type": "boolean" },
+          { "type": "null" }
+        ] }
+      }
+    },
+    "authorizationOfferRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "authorization_id"],
+      "properties": {
+        "type": { "const": "authorization_offer_request" },
+        "protocol_version": { "const": 1 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "authorization_id": { "$ref": "#/$defs/uuid" },
+        "requirements": { "$ref": "#/$defs/applicationRequirements" },
+        "provisions": { "$ref": "#/$defs/applicationProvisions" }
+      }
+    },
+    "authorizationOfferResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "paused", "collections"],
+      "properties": {
+        "type": { "const": "authorization_offer_response" },
+        "protocol_version": { "const": 1 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "paused": { "type": "boolean" },
+        "collections": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": { "$ref": "#/$defs/authorizationCollectionOffer" }
+        }
+      }
+    },
+    "authorizationActivationRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "authorization_id", "application_declaration_id", "application_manifest_digest", "collection_id", "requirements", "provisions", "contract_setups", "grant"],
+      "properties": {
+        "type": { "const": "authorization_activation_request" },
+        "protocol_version": { "const": 1 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "authorization_id": { "$ref": "#/$defs/uuid" },
+        "application_declaration_id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)+$" },
+        "application_manifest_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "collection_id": { "$ref": "#/$defs/uuid" },
+        "requirements": { "$ref": "#/$defs/applicationRequirements" },
+        "provisions": { "$ref": "#/$defs/applicationProvisions" },
+        "contract_setups": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/contractSetupChoice" }
+        },
+        "grant": { "$ref": "#/$defs/grantPolicy" }
+      }
+    },
+    "authorizationActivationResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "ok", "contracts", "contract_setups"],
+      "properties": {
+        "type": { "const": "authorization_activation_response" },
+        "protocol_version": { "const": 1 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "ok": { "type": "boolean" },
+        "contracts": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/collectionContract" }
+        },
+        "contract_setups": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/contractSetupChoice" }
+        },
+        "setup_assessment": true,
+        "provision_receipt": true,
+        "error": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["code", "message"],
+          "properties": {
+            "code": { "type": "string", "minLength": 1 },
+            "message": { "type": "string", "minLength": 1 },
+            "details": true
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "ok": { "const": true } }, "required": ["ok"] },
+          "then": {
+            "not": { "properties": { "error": true }, "required": ["error"] }
+          },
+          "else": {
+            "required": ["error"]
+          }
+        }
+      ]
+    },
+    "notificationCriterion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "event", "presentation"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" },
+        "event": { "$ref": "#/$defs/contractRequirement" },
+        "if": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["$expr"],
+          "properties": { "$expr": { "type": "string", "minLength": 1, "maxLength": 4096 } }
+        },
+        "debounce": { "type": "string", "pattern": "^[0-9]+(ms|s|m|h|d)$" },
+        "minimum_interval": { "type": "string", "pattern": "^[0-9]+(ms|s|m|h|d)$" },
+        "presentation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["title"],
+          "properties": {
+            "title": { "type": "string", "minLength": 1, "maxLength": 80 },
+            "body": { "type": "string", "maxLength": 160 },
+            "tag": { "type": "string", "minLength": 1, "maxLength": 80 }
+          }
+        }
+      }
+    },
+    "grantEncryption": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol_version", "suite", "key_id", "scope_epoch", "connector_id", "collection_id", "application_agreement_public_key", "connector_agreement_public_key"],
+      "properties": {
+        "protocol_version": { "const": 1 },
+        "suite": { "const": "P256-HKDF-SHA256-AES256GCM" },
+        "key_id": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "scope_epoch": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "connector_id": { "$ref": "#/$defs/uuid" },
+        "collection_id": { "$ref": "#/$defs/uuid" },
+        "application_agreement_public_key": { "type": "string", "minLength": 80, "maxLength": 200, "pattern": "^[A-Za-z0-9_-]+$" },
+        "connector_agreement_public_key": { "type": "string", "minLength": 80, "maxLength": 200, "pattern": "^[A-Za-z0-9_-]+$" }
+      }
+    },
+    "relayPolicySnapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "revision", "grants"],
+      "oneOf": [
+        { "required": ["connector_id", "sequence", "lease_issued_at_ms", "lease_expires_at_ms"] },
+        { "not": { "anyOf": [
+          { "required": ["connector_id"] },
+          { "required": ["sequence"] },
+          { "required": ["lease_issued_at_ms"] },
+          { "required": ["lease_expires_at_ms"] }
+        ] } }
+      ],
+      "properties": {
+        "type": { "const": "policy_snapshot" },
+        "protocol_version": { "const": 1 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "revision": { "$ref": "#/$defs/digest" },
+        "connector_id": { "$ref": "#/$defs/uuid" },
+        "sequence": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "lease_issued_at_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "lease_expires_at_ms": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "grants": { "type": "array", "items": { "$ref": "#/$defs/grantPolicy" } }
+      }
+    },
+    "relayPolicyApplied": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "revision", "ok"],
+      "properties": {
+        "type": { "const": "policy_applied" },
+        "protocol_version": { "const": 1 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "revision": { "$ref": "#/$defs/digest" },
+        "ok": { "type": "boolean" },
+        "error": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["code", "message"],
+          "properties": {
+            "code": { "type": "string", "minLength": 1 },
+            "message": { "type": "string" },
+            "details": true
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "ok": { "const": true } }, "required": ["ok"] },
+          "then": { "not": { "properties": { "error": true }, "required": ["error"] } },
+          "else": { "required": ["error"] }
+        }
+      ]
+    },
+    "collectionDescription": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol_version", "collection_id", "display_name", "spec_version", "operations", "change_cursor", "types", "contracts"],
+      "properties": {
+        "protocol_version": { "const": 1 },
+        "collection_id": { "$ref": "#/$defs/uuid" },
+        "display_name": { "type": "string", "minLength": 1 },
+        "spec_version": { "type": "string", "minLength": 1 },
+        "operations": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/operation" } },
+        "authority_capabilities": { "type": "array", "items": { "type": "string" } },
+        "change_cursor": { "type": "integer", "minimum": 0 },
+        "types": { "type": "array", "items": { "$ref": "#/$defs/collectionType" } },
+        "contracts": { "type": "array", "items": { "$ref": "#/$defs/collectionContract" } },
+        "configuration": { "type": "object", "description": "Canonical portable collection settings. Extension and implementation-specific values are omitted." }
+      }
+    },
+    "dataContractSelector": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "type": "string" }, "version": { "type": "string" }, "type": { "type": "string" }
+      }
+    },
+    "readInput": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "paths": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "string", "minLength": 1 } },
+        "include_body": { "type": "boolean", "description": "Batch default true; point-read defaults unchanged." },
+        "include_document": { "type": "boolean", "default": false },
+        "contract": { "$ref": "#/$defs/dataContractSelector" }
+      },
+      "oneOf": [{ "required": ["path"] }, { "required": ["paths"] }],
+      "allOf": [{ "if": { "required": ["contract"] }, "then": { "properties": { "include_document": { "const": false } } } }]
+    },
+    "recordDocument": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "revision", "types", "frontmatter", "effective_frontmatter", "file"],
+      "properties": {
+        "path": { "type": "string" }, "revision": { "type": "string" },
+        "types": { "type": "array", "items": { "type": "string" } },
+        "frontmatter": { "type": "object" }, "effective_frontmatter": { "type": "object" },
+        "body": { "type": "string" }, "document": { "type": "string" },
+        "file": { "type": "object" }, "contract": { "type": "object" }
+      }
+    },
+    "readManyDocumentItem": {
+      "oneOf": [
+        {
+          "type": "object", "additionalProperties": false, "required": ["path", "status", "record"],
+          "properties": { "path": { "type": "string" }, "status": { "const": "found" }, "record": { "$ref": "#/$defs/recordDocument" } }
+        },
+        {
+          "type": "object", "additionalProperties": false, "required": ["path", "status"],
+          "properties": { "path": { "type": "string" }, "status": { "const": "missing" } }
+        },
+        {
+          "type": "object", "additionalProperties": false, "required": ["path", "status", "error"],
+          "properties": {
+            "path": { "type": "string" }, "status": { "const": "error" },
+            "error": {
+              "type": "object", "additionalProperties": false, "required": ["code", "message"],
+              "properties": { "code": { "type": "string" }, "message": { "type": "string" } }
+            }
+          }
+        }
+      ]
+    },
+    "readManyDocumentsResult": {
+      "description": "Ordered items including duplicates. Serialized operation envelope maximum 8 MiB; overflow fails explicitly and asks callers to split, never truncates.",
+      "type": "object", "additionalProperties": false, "required": ["items"],
+      "properties": { "items": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/readManyDocumentItem" } } }
+    },
+    "queryRecord": {
+      "type": "object", "additionalProperties": false, "required": ["path", "types", "file"],
+      "properties": {
+        "path": { "type": "string" }, "revision": { "type": "string" },
+        "types": { "type": "array", "items": { "type": "string" } },
+        "frontmatter": { "type": "object" }, "effective_frontmatter": { "type": "object" },
+        "body": { "type": "string" }, "values": { "type": "object" },
+        "file": { "type": "object" }, "contract": { "type": "object" }
+      }
+    },
+    "queryMetadataRecord": {
+      "type": "object", "additionalProperties": false, "required": ["path", "types", "revision", "values"],
+      "properties": {
+        "path": { "type": "string" }, "revision": { "type": "string" },
+        "types": { "type": "array", "items": { "type": "string" } },
+        "values": { "type": "object" }, "contract": { "type": "object" }
+      }
+    },
+    "queryMetadataResult": {
+      "type": "object", "additionalProperties": false, "required": ["output", "results"],
+      "properties": {
+        "output": { "const": "metadata" },
+        "results": { "type": "array", "items": { "$ref": "#/$defs/queryMetadataRecord" } },
+        "meta": { "type": "object" }
+      }
+    },
+    "collectionType": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "schema", "extensions"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "integer", "minimum": 1 },
+        "description": { "type": "string" },
+        "revision": { "$ref": "#/$defs/digest" },
+        "path": { "type": "string", "minLength": 1, "description": "Collection-relative source path." },
+        "definition": { "type": "object", "description": "Complete portable type frontmatter, including extension declarations." },
+        "schema": { "type": "object" },
+        "collection": { "type": "object" },
+        "lifecycle": { "type": "object" },
+        "extensions": { "type": "object" }
+      }
+    },
+    "authorizationTypeCandidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "revision", "schema", "extensions"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 100 },
+        "version": { "type": "integer", "minimum": 1 },
+        "description": { "type": "string" },
+        "revision": { "$ref": "#/$defs/digest" },
+        "schema": { "type": "object" },
+        "extensions": { "type": "object", "maxProperties": 0 }
+      }
+    },
+    "collectionContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract_type", "id", "version", "digest", "schema", "implementations"],
+      "properties": {
+        "contract_type": { "const": "record" },
+        "id": { "type": "string", "minLength": 1 },
+        "version": { "$ref": "#/$defs/semanticVersion" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "schema": { "type": "object" },
+        "binding_schema": { "type": "object" },
+        "implementations": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/collectionContractImplementation" }
+        }
+      }
+    },
+    "collectionContractImplementation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type_name", "type_version", "digest", "fields"],
+      "properties": {
+        "type_name": { "type": "string", "minLength": 1 },
+        "type_version": { "type": "integer", "minimum": 1 },
+        "type_path": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "fields": {
+          "type": "object",
+          "additionalProperties": { "type": "string", "minLength": 1 }
+        },
+        "binding": { "type": "object" }
+      }
+    },
+    "contractSetupChoice": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["contract", "mode"],
+          "properties": {
+            "contract": { "$ref": "#/$defs/contractRequirement" },
+            "mode": { "const": "starter" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["contract", "mode", "type_name", "type_revision", "fields"],
+          "properties": {
+            "contract": { "$ref": "#/$defs/contractRequirement" },
+            "mode": { "const": "existing" },
+            "type_name": { "type": "string", "minLength": 1, "maxLength": 100 },
+            "type_revision": { "$ref": "#/$defs/digest" },
+            "fields": {
+              "type": "object",
+              "maxProperties": 100,
+              "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 500 }
+            },
+            "binding": { "type": "object" }
+          }
+        }
+      ]
+    },
+    "changesPage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["events", "cursor", "has_more", "reset"],
+      "properties": {
+        "events": { "type": "array", "items": { "$ref": "#/$defs/change" } },
+        "cursor": { "type": "integer", "minimum": 0 },
+        "has_more": { "type": "boolean" },
+        "reset": { "type": "boolean" }
+      }
+    },
+    "change": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cursor", "type", "occurred_at", "payload"],
+      "properties": {
+        "cursor": { "type": "integer", "minimum": 1 },
+        "type": { "type": "string", "minLength": 1 },
+        "occurred_at": { "type": "string", "format": "date-time" },
+        "payload": { "type": "object" }
+      }
+    }
+  }
+}