Document event and action interoperability

public/connect/schemas/catalog.json

@@ -3,6 +3,7 @@
   "schemas": {
     "app_manifest": "./mdbase-app.schema.json",
     "data_contract": "./data-contract.schema.json",
+    "event_action_interop": "./interop/v0.1/profile.schema.json",
     "connect_protocol": "./connect-protocol.v1.schema.json",
     "encrypted_relay": "./encrypted-relay.v1.schema.json",
     "notification_webhook": "./notification-webhook.v1.schema.json",

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

@@ -429,8 +429,9 @@
     "collectionContract": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "version", "digest", "schema", "implementations"],
+      "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" },

public/connect/schemas/data-contract.schema.json

@@ -1,21 +1,107 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://mdbase.dev/schemas/v0.3/data-contract.schema.json",
-  "title": "mdbase v0.3 data contract frontmatter",
+  "title": "mdbase v0.3 contract frontmatter",
   "type": "object",
-  "required": ["kind", "id", "version", "schema"],
+  "required": ["kind", "contract_type", "id", "version"],
   "properties": {
-    "kind": { "const": "mdbase.contract" },
-    "id": { "$ref": "#/$defs/contractId" },
-    "version": { "$ref": "#/$defs/semanticVersion" },
-    "name": { "type": "string", "minLength": 1 },
-    "description": { "type": "string" },
-    "schema": { "$ref": "#/$defs/schemaWrapper" },
-    "binding_schema": { "$ref": "#/$defs/schemaWrapper" }
+    "kind": {
+      "const": "mdbase.contract"
+    },
+    "contract_type": {
+      "enum": ["record", "event", "action"]
+    },
+    "id": {
+      "$ref": "#/$defs/contractId"
+    },
+    "version": {
+      "$ref": "#/$defs/semanticVersion"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "record_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "binding_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "data_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "source_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "input_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "output_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "error_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "provider_schema": {
+      "$ref": "#/$defs/schemaWrapper"
+    },
+    "behavior": {
+      "$ref": "#/$defs/actionBehavior"
+    }
   },
   "patternProperties": {
     "^x-[A-Za-z][A-Za-z0-9._:-]{0,127}$": true
   },
+  "oneOf": [
+    {
+      "properties": {
+        "contract_type": { "const": "record" },
+        "record_schema": true,
+        "binding_schema": true,
+        "data_schema": false,
+        "source_schema": false,
+        "input_schema": false,
+        "output_schema": false,
+        "error_schema": false,
+        "provider_schema": false,
+        "behavior": false
+      },
+      "required": ["record_schema"]
+    },
+    {
+      "properties": {
+        "contract_type": { "const": "event" },
+        "record_schema": false,
+        "binding_schema": false,
+        "data_schema": true,
+        "source_schema": true,
+        "input_schema": false,
+        "output_schema": false,
+        "error_schema": false,
+        "provider_schema": false,
+        "behavior": false
+      },
+      "required": ["data_schema"]
+    },
+    {
+      "properties": {
+        "contract_type": { "const": "action" },
+        "record_schema": false,
+        "binding_schema": false,
+        "data_schema": false,
+        "source_schema": false,
+        "input_schema": true,
+        "output_schema": true,
+        "error_schema": true,
+        "provider_schema": true,
+        "behavior": true
+      },
+      "required": ["input_schema"]
+    }
+  ],
   "additionalProperties": false,
   "$defs": {
     "contractId": {
@@ -32,9 +118,16 @@
       "type": "object",
       "required": ["dialect"],
       "properties": {
-        "dialect": { "const": "json-schema-2020-12" },
-        "value": { "type": "object" },
-        "ref": { "type": "string", "minLength": 1 }
+        "dialect": {
+          "const": "json-schema-2020-12"
+        },
+        "value": {
+          "type": "object"
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        }
       },
       "oneOf": [
         {
@@ -53,6 +146,18 @@
         }
       ],
       "additionalProperties": false
+    },
+    "actionBehavior": {
+      "type": "object",
+      "properties": {
+        "idempotency": {
+          "enum": ["none", "optional", "required"]
+        },
+        "cancellation": {
+          "enum": ["none", "cooperative"]
+        }
+      },
+      "additionalProperties": false
     }
   }
 }

public/connect/schemas/interop/v0.1/action-cancellation.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/action-cancellation.schema.json",
+  "title": "mdbase action cancellation request",
+  "$ref": "profile.schema.json#/$defs/actionCancellation"
+}

public/connect/schemas/interop/v0.1/action-invocation.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/action-invocation.schema.json",
+  "title": "mdbase admitted action invocation",
+  "$ref": "profile.schema.json#/$defs/actionInvocation"
+}

public/connect/schemas/interop/v0.1/action-outcome.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/action-outcome.schema.json",
+  "title": "mdbase action outcome",
+  "$ref": "profile.schema.json#/$defs/actionOutcome"
+}

public/connect/schemas/interop/v0.1/action-provider-declaration.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/action-provider-declaration.schema.json",
+  "title": "mdbase action-provider declaration",
+  "$ref": "profile.schema.json#/$defs/actionProviderDeclaration"
+}

public/connect/schemas/interop/v0.1/action-request.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/action-request.schema.json",
+  "title": "mdbase action request",
+  "$ref": "profile.schema.json#/$defs/actionRequest"
+}

public/connect/schemas/interop/v0.1/conformance-claim.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/conformance-claim.schema.json",
+  "title": "mdbase interoperability conformance claim",
+  "$ref": "profile.schema.json#/$defs/conformanceClaim"
+}

public/connect/schemas/interop/v0.1/event-source-declaration.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/event-source-declaration.schema.json",
+  "title": "mdbase event-source declaration",
+  "$ref": "profile.schema.json#/$defs/eventSourceDeclaration"
+}

public/connect/schemas/interop/v0.1/event.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/interop/v0.1/event.schema.json",
+  "title": "mdbase CloudEvents event envelope",
+  "$ref": "profile.schema.json#/$defs/event"
+}