@mdbase-dev/connect-protocol 0.1.0-beta.31 → 0.1.0-beta.33

package/schemas/connect-problems.v1.catalog.json

@@ -53,11 +53,39 @@
       }
     },
     "authority_authorization_changed": { "category": "authorization", "recovery": "reauthorize" },
+    "authorization_binding_incompatible": {
+      "category": "compatibility",
+      "recovery": "upgrade_application",
+      "details": {
+        "required": ["contract", "required", "supported", "peer"],
+        "properties": {
+          "contract": { "type": "string" },
+          "required": { "type": "array", "items": { "type": "integer" } },
+          "supported": { "type": "array", "items": { "type": "integer" } },
+          "peer": { "type": "string" },
+          "operation": { "type": "string" }
+        }
+      }
+    },
     "authorization_cancelled": { "category": "cancellation", "recovery": "none" },
     "authorization_expired": { "category": "authorization", "recovery": "reauthorize" },
     "authorization_replayed": { "category": "integrity", "recovery": "reauthorize" },
     "browser_required": { "category": "compatibility", "recovery": "none" },
     "callback_url_required": { "category": "validation", "recovery": "fix_request" },
+    "capability_contract_incompatible": {
+      "category": "compatibility",
+      "recovery": "upgrade_application",
+      "details": {
+        "required": ["contract", "required", "supported", "peer"],
+        "properties": {
+          "contract": { "type": "string" },
+          "required": { "type": "array", "items": { "type": "integer" } },
+          "supported": { "type": "array", "items": { "type": "integer" } },
+          "peer": { "type": "string" },
+          "operation": { "type": "string" }
+        }
+      }
+    },
     "change_cursor_reset": { "category": "conflict", "recovery": "refresh" },
     "collection_access_denied": { "category": "authorization", "recovery": "reauthorize" },
     "collection_configuration_invalid": {
@@ -143,6 +171,20 @@
     "device_authorization_failed": { "category": "authorization", "recovery": "reauthorize" },
     "direct_operation_rejected": { "category": "authorization", "recovery": "reauthorize" },
     "discovery_failed": { "category": "availability", "recovery": "retry" },
+    "durable_mutation_unsupported": {
+      "category": "compatibility",
+      "recovery": "upgrade_connector",
+      "details": {
+        "required": ["contract", "required", "supported", "peer"],
+        "properties": {
+          "contract": { "type": "string" },
+          "required": { "type": "array", "items": { "type": "integer" } },
+          "supported": { "type": "array", "items": { "type": "integer" } },
+          "peer": { "type": "string" },
+          "operation": { "type": "string" }
+        }
+      }
+    },
     "encrypted_relay_rejected": { "category": "authorization", "recovery": "reauthorize" },
     "encryption_required": { "category": "authorization", "recovery": "reauthorize" },
     "expired_token": { "category": "authorization", "recovery": "reauthorize" },
@@ -205,6 +247,15 @@
     "manifest_load_failed": { "category": "availability", "recovery": "retry" },
     "manifest_required": { "category": "validation", "recovery": "fix_request" },
     "missing_grant_key": { "category": "authorization", "recovery": "reauthorize" },
+    "mutation_recovery_expired": { "category": "compatibility", "recovery": "none" },
+    "mutation_request_conflict": {
+      "category": "conflict",
+      "recovery": "resolve_conflict",
+      "details": {
+        "required": ["request_id"],
+        "properties": { "request_id": { "type": "string" } }
+      }
+    },
     "no_pending_mutation": { "category": "conflict", "recovery": "refresh" },
     "not_authorized": { "category": "authorization", "recovery": "reauthorize" },
     "not_remote_authority": { "category": "compatibility", "recovery": "choose_collection" },
@@ -227,7 +278,14 @@
         }
       }
     },
-    "operation_outcome_unknown": { "category": "conflict", "recovery": "resolve_outcome" },
+    "operation_outcome_unknown": {
+      "category": "conflict",
+      "recovery": "resolve_outcome",
+      "details": {
+        "required": ["request_id"],
+        "properties": { "request_id": { "type": "string" } }
+      }
+    },
     "path_occupied": { "category": "conflict", "recovery": "resolve_conflict" },
     "pending_mutation_unresolved": { "category": "conflict", "recovery": "resolve_outcome" },
     "query_snapshot_changed": { "category": "conflict", "recovery": "refresh" },
@@ -244,6 +302,11 @@
     "reconnect_required": { "category": "authorization", "recovery": "reauthorize" },
     "redirect_uri_required": { "category": "validation", "recovery": "fix_request" },
     "reference_updates_unsupported": { "category": "compatibility", "recovery": "fix_request" },
+    "registry_backup_invalid": { "category": "integrity", "recovery": "contact_support" },
+    "registry_busy": { "category": "availability", "recovery": "retry" },
+    "registry_corrupt": { "category": "integrity", "recovery": "repair_collection" },
+    "registry_migration_failed": { "category": "internal", "recovery": "contact_support" },
+    "registry_schema_incompatible": { "category": "compatibility", "recovery": "upgrade_connector" },
     "relay_authorization_expired": { "category": "authorization", "recovery": "reauthorize" },
     "relay_unavailable": { "category": "availability", "recovery": "retry" },
     "sandbox_unsupported": { "category": "compatibility", "recovery": "fix_request" },
@@ -254,6 +317,20 @@
     "temporarily_unavailable": { "category": "availability", "recovery": "retry" },
     "timeout": { "category": "availability", "recovery": "retry" },
     "token_exchange_failed": { "category": "availability", "recovery": "retry" },
+    "transport_protocol_incompatible": {
+      "category": "compatibility",
+      "recovery": "upgrade_connector",
+      "details": {
+        "required": ["contract", "required", "supported", "peer"],
+        "properties": {
+          "contract": { "type": "string" },
+          "required": { "type": "array", "items": { "type": "integer" } },
+          "supported": { "type": "array", "items": { "type": "integer" } },
+          "peer": { "type": "string" },
+          "operation": { "type": "string" }
+        }
+      }
+    },
     "type_pack_provision_failed": { "category": "validation", "recovery": "repair_collection" },
     "unknown_collection": { "category": "selection", "recovery": "choose_collection" },
     "unsafe_file_path": { "category": "validation", "recovery": "fix_request" },

package/schemas/connect-protocol.v1.schema.json

@@ -22,7 +22,35 @@
       "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", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync"]
+      "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",
@@ -83,7 +111,7 @@
     "relayHello": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["type", "protocol_version", "connector_version", "capabilities"],
+      "required": ["type", "protocol_version", "connector_version", "capabilities", "contract_support"],
       "properties": {
         "type": { "const": "relay_hello" },
         "protocol_version": { "const": 1 },
@@ -92,13 +120,14 @@
           "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"],
+      "required": ["type", "protocol_version", "session_id", "capabilities", "contract_support"],
       "properties": {
         "type": { "const": "relay_welcome" },
         "protocol_version": { "const": 1 },
@@ -107,18 +136,31 @@
           "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", "update_url"],
+      "required": ["type", "protocol_version", "code", "message", "minimum_connector_version", "update_url"],
       "properties": {
         "type": { "const": "relay_incompatible" },
         "protocol_version": { "const": 1 },
-        "code": { "const": "connector_upgrade_required" },
+        "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://" }
       }
     },
@@ -128,7 +170,7 @@
       "required": ["type", "protocol_version", "request_id", "grant_id", "collection_id", "application_id", "operation", "input"],
       "properties": {
         "type": { "const": "operation_request" },
-        "protocol_version": { "const": 1 },
+        "protocol_version": { "const": 2 },
         "request_id": { "$ref": "#/$defs/uuid" },
         "grant_id": { "$ref": "#/$defs/uuid" },
         "collection_id": { "$ref": "#/$defs/uuid" },
@@ -142,7 +184,7 @@
       "additionalProperties": false,
       "required": ["protocol_version", "request_id", "input"],
       "properties": {
-        "protocol_version": { "const": 1 },
+        "protocol_version": { "const": 2 },
         "request_id": { "$ref": "#/$defs/uuid" },
         "input": true
       }
@@ -152,7 +194,7 @@
       "additionalProperties": false,
       "required": ["protocol_version", "request_id", "ok"],
       "properties": {
-        "protocol_version": { "const": 1 },
+        "protocol_version": { "const": 2 },
         "request_id": { "$ref": "#/$defs/uuid" },
         "ok": { "type": "boolean" },
         "result": true,
@@ -178,7 +220,7 @@
       "required": ["type", "protocol_version", "request_id", "ok"],
       "properties": {
         "type": { "const": "operation_response" },
-        "protocol_version": { "const": 1 },
+        "protocol_version": { "const": 2 },
         "request_id": { "$ref": "#/$defs/uuid" },
         "ok": { "type": "boolean" },
         "result": true,
@@ -247,11 +289,12 @@
     "applicationAuthorizationBinding": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["protocol_version", "authorization_id", "application_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", "requested_operations"],
+      "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": 2 },
+        "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" },
@@ -264,6 +307,7 @@
         "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,
@@ -309,6 +353,11 @@
           "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": {
@@ -383,9 +432,46 @@
           "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": "^/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": "^/x-[^/]+(?:/.*)?$", "maxLength": 1024 },
+        "value": { "oneOf": [
+          { "type": "string" },
+          { "type": "number" },
+          { "type": "boolean" },
+          { "type": "null" }
+        ] }
+      }
+    },
     "authorizationOfferRequest": {
       "type": "object",
       "additionalProperties": false,
@@ -418,12 +504,14 @@
     "authorizationActivationRequest": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["type", "protocol_version", "request_id", "authorization_id", "collection_id", "requirements", "provisions", "contract_setups", "grant"],
+      "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" },
@@ -454,6 +542,8 @@
           "maxItems": 20,
           "items": { "$ref": "#/$defs/contractSetupChoice" }
         },
+        "setup_assessment": true,
+        "provision_receipt": true,
         "error": {
           "type": "object",
           "additionalProperties": false,

package/schemas/encrypted-relay.v1.schema.json

@@ -14,7 +14,7 @@
       "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", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "file_control"]
+      "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", "file_control"]
     },
     "envelope": {
       "type": "object",

package/schemas/encrypted-relay.v2.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/connect/schemas/encrypted-relay.v2.json",
+  "title": "mdbase connect encrypted operation transport 2",
+  "description": "Opaque authenticated operation envelopes routed between an application and authority.",
+  "oneOf": [
+    { "$ref": "#/$defs/request" },
+    { "$ref": "#/$defs/response" },
+    { "$ref": "#/$defs/rejected" }
+  ],
+  "$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", "file_control"]
+    },
+    "envelope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "suite", "request_id", "grant_id", "application_id", "connector_id", "collection_id", "operation", "scope_epoch", "key_id", "counter", "ciphertext"],
+      "properties": {
+        "type": { "enum": ["encrypted_operation_request", "encrypted_operation_response"] },
+        "protocol_version": { "const": 2 },
+        "suite": { "const": "P256-HKDF-SHA256-AES256GCM" },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "grant_id": { "$ref": "#/$defs/uuid" },
+        "application_id": { "$ref": "#/$defs/uuid" },
+        "connector_id": { "$ref": "#/$defs/uuid" },
+        "collection_id": { "$ref": "#/$defs/uuid" },
+        "operation": { "$ref": "#/$defs/operation" },
+        "scope_epoch": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "key_id": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "counter": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$" },
+        "ciphertext": { "type": "string", "minLength": 1, "maxLength": 2800000, "pattern": "^[A-Za-z0-9_-]+$" }
+      }
+    },
+    "request": {
+      "allOf": [
+        { "$ref": "#/$defs/envelope" },
+        { "type": "object", "properties": { "type": { "const": "encrypted_operation_request" } } }
+      ]
+    },
+    "response": {
+      "allOf": [
+        { "$ref": "#/$defs/envelope" },
+        { "type": "object", "properties": { "type": { "const": "encrypted_operation_response" } } }
+      ]
+    },
+    "rejected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "protocol_version", "request_id", "problem"],
+      "properties": {
+        "type": { "const": "encrypted_operation_rejected" },
+        "protocol_version": { "const": 2 },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "problem": { "$ref": "https://schemas.mdbase.dev/connect/problem/v1" }
+      }
+    }
+  }
+}

package/schemas/files.v1.schema.json

@@ -323,7 +323,7 @@
     "transferStatus": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["protocol_version", "type", "transfer_id", "state", "received", "received_bytes"],
+      "required": ["protocol_version", "type", "transfer_id", "state", "received", "received_bytes", "uploaded_parts"],
       "properties": {
         "protocol_version": { "const": 1 },
         "type": { "const": "file_transfer_status" },
@@ -334,7 +334,12 @@
           "uniqueItems": true,
           "items": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
         },
-        "received_bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        "received_bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "uploaded_parts": {
+          "type": "array",
+          "maxItems": 10000,
+          "items": { "$ref": "#/$defs/uploadedPart" }
+        }
       }
     },
     "prepareUploadPartRequest": {

package/schemas/mdbase-app.schema.json

@@ -39,6 +39,11 @@
       "additionalProperties": false,
       "required": ["type_packs"],
       "properties": {
+        "configuration": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/configurationProvision" }
+        },
         "type_packs": {
           "type": "array",
           "maxItems": 20,
@@ -118,6 +123,11 @@
           "description": "Require a durable provider-backed collection with direct sync support."
         },
         "files": { "$ref": "#/$defs/fileRequirement" },
+        "configuration": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/configurationRequirement" }
+        },
         "contracts": {
           "type": "array",
           "maxItems": 20,
@@ -146,6 +156,46 @@
         }
       }
     },
+    "configurationValue": {
+      "anyOf": [
+        { "type": "string" },
+        { "type": "number" },
+        { "type": "boolean" },
+        { "type": "null" }
+      ]
+    },
+    "configurationRequirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "predicate", "value"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        },
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "predicate": { "const": "contains" },
+        "value": { "$ref": "#/$defs/configurationValue" }
+      }
+    },
+    "configurationProvision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requirement", "operation", "path", "value"],
+      "properties": {
+        "requirement": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        },
+        "operation": { "const": "set_add" },
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "value": { "$ref": "#/$defs/configurationValue" }
+      }
+    },
     "applicationCapability": {
       "enum": [
         "collection.inspect",
@@ -169,6 +219,7 @@
         "definitions.update",
         "definitions.type-pack.inspect",
         "definitions.type-pack.apply",
+        "collection.setup.apply",
         "timers.list",
         "timers.put",
         "timers.cancel",