@clowder-ai/plugin-contract 0.1.0-beta.9 → 0.2.0

package/src/schemas/messaging.schema.json

@@ -11,7 +11,13 @@
     "maxIdempotencyKeyLength": 200,
     "maxElementIdLength": 128,
     "maxElementsPerMessage": 128,
-    "maxAppendOpsPerMessage": 64
+    "maxAppendOpsPerMessage": 64,
+    "maxMessageIdLength": 512,
+    "maxThreadIdLength": 512,
+    "maxActorIdLength": 512,
+    "maxMessageHandleTokenLength": 512,
+    "maxEventIdLength": 720,
+    "maxOccurredAtLength": 27
   },
   "x-clowder-replay-window-default": "P7D",
   "oneOf": [
@@ -33,7 +39,7 @@
       "type": "object",
       "properties": {
         "kind": { "$ref": "#/$defs/ActorKind" },
-        "id": { "type": "string", "minLength": 1 }
+        "id": { "type": "string", "minLength": 1, "maxLength": 512 }
       },
       "required": ["kind", "id"],
       "additionalProperties": false
@@ -115,9 +121,13 @@
       "required": ["epistemicStatus"],
       "additionalProperties": false
     },
+    "MediaType": {
+      "type": "string",
+      "enum": ["image", "file", "audio", "video"]
+    },
     "ElementKind": {
       "type": "string",
-      "enum": ["text", "media_ref", "rich_block"]
+      "enum": ["text", "media_ref", "rich_block", "media_unavailable", "media_warning"]
     },
     "TextElementPayload": {
       "type": "object",
@@ -129,12 +139,60 @@
     },
     "MediaRefElementPayload": {
       "type": "object",
-      "additionalProperties": true
+      "properties": {
+        "type": { "$ref": "#/$defs/MediaType" },
+        "reference": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2048,
+          "description": "pmr_* enters only through a public messaging.send draft that carries sourceEventId; whisper, appendElements, and pmr drafts without sourceEventId are rejected. hmr_* is an opaque identifier, not a bearer token: send, appendElements, and media.read share the same Host authorization decision, and unknown, unauthorized, cross-instance, or revoked references all return MEDIA_ACCESS_DENIED. References without either prefix are legacy opaque values: the Host does not parse, materialize, or expose them through media.read."
+        },
+        "sourceId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "fileName": { "type": "string", "minLength": 1, "maxLength": 512 }
+      },
+      "required": ["type", "reference"],
+      "additionalProperties": true,
+      "allOf": [
+        {
+          "if": { "properties": { "reference": { "pattern": "^pmr_" } }, "required": ["reference"] },
+          "then": { "required": ["sourceId"] }
+        },
+        {
+          "if": { "properties": { "reference": { "pattern": "^hmr_" } }, "required": ["reference"] },
+          "then": { "not": { "required": ["sourceId"] } }
+        }
+      ]
     },
     "RichBlockElementPayload": {
       "type": "object",
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "kind": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "v": { "const": 1 }
+      },
+      "required": ["id", "kind", "v"],
       "additionalProperties": true
     },
+    "MediaUnavailableElementPayload": {
+      "type": "object",
+      "properties": {
+        "type": { "$ref": "#/$defs/MediaType" },
+        "fileName": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "reason": { "type": "string", "enum": ["source_expired", "timeout", "unavailable"] }
+      },
+      "required": ["type", "reason"],
+      "additionalProperties": false
+    },
+    "MediaWarningElementPayload": {
+      "type": "object",
+      "properties": {
+        "mediaElementId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "stage": { "type": "string", "enum": ["transcription", "preview"] },
+        "reason": { "type": "string", "enum": ["timeout", "processing_failed"] }
+      },
+      "required": ["mediaElementId", "stage", "reason"],
+      "additionalProperties": false
+    },
     "TextMessageElement": {
       "type": "object",
       "properties": {
@@ -159,6 +217,20 @@
       "required": ["elementId", "kind", "payload"],
       "additionalProperties": false
     },
+    "PmrMediaRefElementMatch": {
+      "type": "object",
+      "properties": {
+        "kind": { "const": "media_ref" },
+        "payload": {
+          "type": "object",
+          "properties": {
+            "reference": { "type": "string", "pattern": "^pmr_" }
+          },
+          "required": ["reference"]
+        }
+      },
+      "required": ["kind", "payload"]
+    },
     "RichBlockMessageElement": {
       "type": "object",
       "properties": {
@@ -171,11 +243,37 @@
       "required": ["elementId", "kind", "payload"],
       "additionalProperties": false
     },
+    "MediaUnavailableMessageElement": {
+      "type": "object",
+      "properties": {
+        "elementId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "kind": { "const": "media_unavailable" },
+        "payload": { "$ref": "#/$defs/MediaUnavailableElementPayload" },
+        "derivedFromElementId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "epistemicStatus": { "$ref": "#/$defs/EpistemicStatus" }
+      },
+      "required": ["elementId", "kind", "payload"],
+      "additionalProperties": false
+    },
+    "MediaWarningMessageElement": {
+      "type": "object",
+      "properties": {
+        "elementId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "kind": { "const": "media_warning" },
+        "payload": { "$ref": "#/$defs/MediaWarningElementPayload" },
+        "derivedFromElementId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "epistemicStatus": { "$ref": "#/$defs/EpistemicStatus" }
+      },
+      "required": ["elementId", "kind", "payload"],
+      "additionalProperties": false
+    },
     "MessageElement": {
       "oneOf": [
         { "$ref": "#/$defs/TextMessageElement" },
         { "$ref": "#/$defs/MediaRefMessageElement" },
-        { "$ref": "#/$defs/RichBlockMessageElement" }
+        { "$ref": "#/$defs/RichBlockMessageElement" },
+        { "$ref": "#/$defs/MediaUnavailableMessageElement" },
+        { "$ref": "#/$defs/MediaWarningMessageElement" }
       ]
     },
     "MessagePayload": {
@@ -278,6 +376,12 @@
         { "$ref": "#/$defs/SystemAudience" }
       ]
     },
+    "MessageId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "description": "Host message id."
+    },
     "MessageDraft": {
       "type": "object",
       "properties": {
@@ -285,26 +389,82 @@
         "draftAudience": { "$ref": "#/$defs/DraftAudience" },
         "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200 },
         "sourceEventId": { "type": "string", "minLength": 1, "maxLength": 512 },
-        "replyTo": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "replyTo": { "$ref": "#/$defs/MessageId" },
         "payload": { "$ref": "#/$defs/DraftPayload" }
       },
       "required": ["address", "idempotencyKey", "payload"],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "draftAudience": {
+                "type": "object",
+                "properties": { "kind": { "const": "whisper" } },
+                "required": ["kind"]
+              }
+            },
+            "required": ["draftAudience"]
+          },
+          "then": {
+            "properties": {
+              "payload": {
+                "properties": {
+                  "elements": {
+                    "not": { "contains": { "$ref": "#/$defs/PmrMediaRefElementMatch" } }
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "payload": {
+                "properties": {
+                  "elements": {
+                    "contains": { "$ref": "#/$defs/PmrMediaRefElementMatch" }
+                  }
+                }
+              }
+            }
+          },
+          "then": { "required": ["sourceEventId"] }
+        }
+      ]
+    },
+    "OccurredAt": {
+      "oneOf": [
+        {
+          "type": "string",
+          "maxLength": 24,
+          "format": "date-time",
+          "pattern": "Z$"
+        },
+        {
+          "type": "string",
+          "minLength": 27,
+          "maxLength": 27,
+          "pattern": "^[+-][0-9]{6}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]\\.[0-9]{3}Z$"
+        }
+      ]
+    },
+    "ThreadId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512
     },
     "MessageEnvelope": {
       "type": "object",
       "properties": {
-        "messageId": { "type": "string", "minLength": 1 },
-        "revision": { "type": "integer", "minimum": 1 },
-        "threadId": { "type": "string", "minLength": 1 },
-        "replyTo": { "type": "string", "minLength": 1 },
+        "messageId": { "$ref": "#/$defs/MessageId" },
+        "revision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "threadId": { "$ref": "#/$defs/ThreadId" },
+        "replyTo": { "$ref": "#/$defs/MessageId" },
         "actor": { "$ref": "#/$defs/ActorRef" },
         "audience": { "$ref": "#/$defs/CanonicalAudience" },
-        "occurredAt": {
-          "type": "string",
-          "format": "date-time",
-          "pattern": "Z$"
-        },
+        "occurredAt": { "$ref": "#/$defs/OccurredAt" },
         "payload": { "$ref": "#/$defs/MessagePayload" }
       },
       "required": ["messageId", "revision", "threadId", "actor", "audience", "occurredAt", "payload"],
@@ -313,8 +473,8 @@
     "MessagePublishEvent": {
       "type": "object",
       "properties": {
-        "eventId": { "type": "string", "minLength": 1 },
-        "sequence": { "type": "integer", "minimum": 0 },
+        "eventId": { "type": "string", "minLength": 1, "maxLength": 720 },
+        "sequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
         "type": { "const": "message.publish" },
         "envelope": { "$ref": "#/$defs/MessageEnvelope" }
       },
@@ -324,14 +484,14 @@
     "MessageElementsAppendEvent": {
       "type": "object",
       "properties": {
-        "eventId": { "type": "string", "minLength": 1 },
-        "sequence": { "type": "integer", "minimum": 0 },
+        "eventId": { "type": "string", "minLength": 1, "maxLength": 720 },
+        "sequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
         "type": { "const": "message.elements.append" },
-        "messageId": { "type": "string", "minLength": 1 },
-        "threadId": { "type": "string", "minLength": 1 },
+        "messageId": { "$ref": "#/$defs/MessageId" },
+        "threadId": { "$ref": "#/$defs/ThreadId" },
         "operationId": { "type": "string", "minLength": 1, "maxLength": 200 },
-        "baseRevision": { "type": "integer", "minimum": 1 },
-        "revision": { "type": "integer", "minimum": 1 },
+        "baseRevision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "revision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
         "elements": {
           "type": "array",
           "items": { "$ref": "#/$defs/MessageElement" },
@@ -351,24 +511,31 @@
     "SendReceipt": {
       "type": "object",
       "properties": {
-        "messageId": { "type": "string", "minLength": 1 },
-        "threadId": { "type": "string", "minLength": 1 },
-        "revision": { "type": "integer", "minimum": 1 },
-        "handle": { "$ref": "#/$defs/MessageHandle" },
-        "publishSequence": { "type": "integer", "minimum": 0 }
+        "messageId": { "$ref": "#/$defs/MessageId" },
+        "threadId": { "$ref": "#/$defs/ThreadId" },
+        "revision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "messageHandle": { "$ref": "#/$defs/MessageHandle" },
+        "publishSequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "pendingPublication": {
+          "const": true,
+          "description": "The Host accepted and reserved this message, but media import is still pending and the message is not yet published or readable."
+        }
       },
-      "required": ["messageId", "threadId", "revision"],
-      "additionalProperties": false
+      "required": ["messageId", "threadId", "revision", "messageHandle"],
+      "additionalProperties": false,
+      "not": { "required": ["publishSequence", "pendingPublication"] }
     },
     "AppendReceipt": {
       "type": "object",
       "properties": {
-        "messageId": { "type": "string", "minLength": 1 },
-        "revision": { "type": "integer", "minimum": 1 },
-        "appendSequence": { "type": "integer", "minimum": 0 },
+        "messageId": { "$ref": "#/$defs/MessageId" },
+        "revision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "appendSequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
         "appliedElementIds": {
           "type": "array",
-          "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+          "items": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "minItems": 1,
+          "maxItems": 32
         }
       },
       "required": ["messageId", "revision", "appliedElementIds"],
@@ -376,13 +543,13 @@
     },
     "MessagingErrorCode": {
       "type": "string",
-      "enum": ["VALIDATION", "PERMISSION", "NOT_FOUND", "CONFLICT", "RETRYABLE_INFLIGHT", "STALE_CURSOR"]
+      "enum": ["VALIDATION", "PERMISSION", "NOT_FOUND", "CONFLICT", "RETRYABLE_INFLIGHT", "STALE_CURSOR", "MEDIA_ACCESS_DENIED", "MESSAGE_NOT_PUBLISHED"]
     },
     "MessageHandle": {
       "type": "object",
       "properties": {
         "kind": { "const": "message" },
-        "token": { "type": "string", "minLength": 1 }
+        "token": { "type": "string", "minLength": 1, "maxLength": 512 }
       },
       "required": ["kind", "token"],
       "additionalProperties": false
@@ -392,12 +559,13 @@
       "properties": {
         "handle": { "$ref": "#/$defs/MessageHandle" },
         "operationId": { "type": "string", "minLength": 1, "maxLength": 200 },
-        "baseRevision": { "type": "integer", "minimum": 1 },
+        "baseRevision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
         "elements": {
           "type": "array",
           "items": { "$ref": "#/$defs/MessageElement" },
           "minItems": 1,
-          "maxItems": 32
+          "maxItems": 32,
+          "not": { "contains": { "$ref": "#/$defs/PmrMediaRefElementMatch" } }
         }
       },
       "required": ["handle", "operationId", "elements"],
@@ -406,6 +574,7 @@
     "SubscriptionCursor": {
       "type": "string",
       "minLength": 1,
+      "maxLength": 512,
       "description": "Opaque, subscription-local acknowledgement token."
     },
     "SubscriptionNormalResponse": {
@@ -429,6 +598,7 @@
         "events": {
           "type": "array",
           "items": { "$ref": "#/$defs/MessageOutputEvent" },
+          "minItems": 0,
           "maxItems": 0
         },
         "ackToken": { "type": "null" },
@@ -443,6 +613,7 @@
         "events": {
           "type": "array",
           "items": { "$ref": "#/$defs/MessageOutputEvent" },
+          "minItems": 0,
           "maxItems": 0
         },
         "ackToken": { "type": "null" },
@@ -463,12 +634,492 @@
       "properties": {
         "envelopes": {
           "type": "array",
-          "items": { "$ref": "#/$defs/MessageEnvelope" }
+          "items": { "$ref": "#/$defs/MessageEnvelope" },
+          "maxItems": 128
         },
-        "resumeSequence": { "type": "integer", "minimum": 0 }
+        "resumeSequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
       },
       "required": ["envelopes", "resumeSequence"],
       "additionalProperties": false
+    },
+    "FrontendDisplayUrl": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2048,
+      "format": "uri",
+      "pattern": "^https?://",
+      "description": "Absolute browser-facing http(s) URL. Userinfo and the case-insensitive query keys bearer, access_token, token, secret, and api_key are forbidden by semantic validation."
+    },
+    "DeliveryPresentationActor": {
+      "type": "object",
+      "properties": {
+        "displayName": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "emoji": { "type": "string", "minLength": 1, "maxLength": 32 }
+      },
+      "required": ["displayName", "emoji"],
+      "additionalProperties": false
+    },
+    "DeliveryPresentationThread": {
+      "type": "object",
+      "properties": {
+        "shortId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "title": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "featId": { "type": "string", "minLength": 1, "maxLength": 128 }
+      },
+      "required": ["shortId"],
+      "additionalProperties": false
+    },
+    "DeliveryPresentationContext": {
+      "type": "object",
+      "properties": {
+        "actor": { "$ref": "#/$defs/DeliveryPresentationActor" },
+        "thread": { "$ref": "#/$defs/DeliveryPresentationThread" },
+        "deepLinkUrl": { "$ref": "#/$defs/FrontendDisplayUrl" }
+      },
+      "required": ["actor", "thread"],
+      "additionalProperties": false
+    },
+    "MediaReadInput": {
+      "type": "object",
+      "properties": {
+        "reference": { "type": "string", "pattern": "^hmr_", "maxLength": 2048 },
+        "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "limit": { "type": "integer", "minimum": 1, "maximum": 524288 }
+      },
+      "required": ["reference", "offset", "limit"],
+      "additionalProperties": false
+    },
+    "MediaReadResult": {
+      "type": "object",
+      "properties": {
+        "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "dataBase64": { "type": "string", "maxLength": 699052, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" },
+        "nextOffset": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "done": { "type": "boolean" }
+      },
+      "required": ["offset", "dataBase64", "done"],
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": { "properties": { "done": { "const": false } }, "required": ["done"] },
+          "then": {
+            "properties": { "dataBase64": { "minLength": 4 } },
+            "required": ["nextOffset"]
+          }
+        },
+        { "if": { "properties": { "done": { "const": true } }, "required": ["done"] }, "then": { "not": { "required": ["nextOffset"] } } }
+      ]
+    },
+    "PluginMessageDelivery": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "message"
+        },
+        "deliveryId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "threadId": {
+          "$ref": "#/$defs/ThreadId"
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "envelope": {
+          "$ref": "#/$defs/MessageEnvelope"
+        },
+        "presentation": {
+          "$ref": "#/$defs/DeliveryPresentationContext"
+        }
+      },
+      "required": [
+        "kind",
+        "deliveryId",
+        "threadId",
+        "envelope"
+      ],
+      "additionalProperties": false
+    },
+    "PluginExecutionStartedDelivery": {
+      "type": "object",
+      "properties": {
+        "deliveryId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "threadId": {
+          "$ref": "#/$defs/ThreadId"
+        },
+        "state": {
+          "const": "started"
+        },
+        "presentation": {
+          "$ref": "#/$defs/DeliveryPresentationContext"
+        },
+        "placeholderLine": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "replyTo": {
+          "$ref": "#/$defs/MessageId"
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "kind": {
+          "const": "execution_status"
+        }
+      },
+      "required": [
+        "executionId",
+        "deliveryId",
+        "threadId",
+        "state",
+        "presentation",
+        "kind"
+      ],
+      "additionalProperties": false
+    },
+    "PluginExecutionCatchingUpDelivery": {
+      "type": "object",
+      "properties": {
+        "deliveryId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "threadId": {
+          "$ref": "#/$defs/ThreadId"
+        },
+        "state": {
+          "const": "catching_up"
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "kind": {
+          "const": "execution_status"
+        }
+      },
+      "required": [
+        "executionId",
+        "deliveryId",
+        "threadId",
+        "state",
+        "kind"
+      ],
+      "additionalProperties": false
+    },
+    "PluginExecutionBlockedDelivery": {
+      "type": "object",
+      "properties": {
+        "deliveryId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "threadId": {
+          "$ref": "#/$defs/ThreadId"
+        },
+        "state": {
+          "const": "blocked"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "recoveryUrl": {
+          "$ref": "#/$defs/FrontendDisplayUrl"
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "kind": {
+          "const": "execution_status"
+        }
+      },
+      "required": [
+        "executionId",
+        "deliveryId",
+        "threadId",
+        "state",
+        "reason",
+        "kind"
+      ],
+      "additionalProperties": false
+    },
+    "PluginExecutionResumedDelivery": {
+      "type": "object",
+      "properties": {
+        "deliveryId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "threadId": {
+          "$ref": "#/$defs/ThreadId"
+        },
+        "state": {
+          "const": "resumed"
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "kind": {
+          "const": "execution_status"
+        }
+      },
+      "required": [
+        "executionId",
+        "deliveryId",
+        "threadId",
+        "state",
+        "kind"
+      ],
+      "additionalProperties": false
+    },
+    "PluginExecutionSettledDelivery": {
+      "type": "object",
+      "properties": {
+        "deliveryId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "threadId": {
+          "$ref": "#/$defs/ThreadId"
+        },
+        "state": {
+          "const": "settled"
+        },
+        "chainDone": {
+          "type": "boolean"
+        },
+        "outcome": {
+          "type": "string",
+          "enum": [
+            "completed",
+            "failed",
+            "cancelled"
+          ]
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "kind": {
+          "const": "execution_status"
+        }
+      },
+      "required": [
+        "executionId",
+        "deliveryId",
+        "threadId",
+        "state",
+        "chainDone",
+        "outcome",
+        "kind"
+      ],
+      "additionalProperties": false
+    },
+    "PluginExecutionStatusDelivery": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/PluginExecutionStartedDelivery"
+        },
+        {
+          "$ref": "#/$defs/PluginExecutionCatchingUpDelivery"
+        },
+        {
+          "$ref": "#/$defs/PluginExecutionBlockedDelivery"
+        },
+        {
+          "$ref": "#/$defs/PluginExecutionResumedDelivery"
+        },
+        {
+          "$ref": "#/$defs/PluginExecutionSettledDelivery"
+        }
+      ]
+    },
+    "PluginDeliveryInput": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/PluginMessageDelivery"
+        },
+        {
+          "$ref": "#/$defs/PluginExecutionStatusDelivery"
+        }
+      ]
+    },
+    "PluginDeliveryReceipt": {
+      "type": "object",
+      "properties": {
+        "deliveryId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        }
+      },
+      "required": [
+        "deliveryId"
+      ],
+      "additionalProperties": false
+    },
+
+
+
+
+
+
+    "M0CSubscribeInput": {
+      "type": "object",
+      "properties": {
+        "handle": { "type": "string", "minLength": 1, "maxLength": 256 }
+      },
+      "required": ["handle"],
+      "additionalProperties": false
+    },
+    "M0CSubscribeResult": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": { "type": "string", "minLength": 1, "maxLength": 128 }
+      },
+      "required": ["subscriptionId"],
+      "additionalProperties": false
+    },
+    "M0CReadInput": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "limit": { "type": "integer", "minimum": 1, "maximum": 32 }
+      },
+      "required": ["subscriptionId", "limit"],
+      "additionalProperties": false
+    },
+    "M0CReadNormalResult": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MessageOutputEvent" },
+          "minItems": 1,
+          "maxItems": 32
+        },
+        "ackToken": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "stale": { "const": false }
+      },
+      "required": ["events", "ackToken", "stale"],
+      "additionalProperties": false
+    },
+    "M0CReadEmptyResult": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MessageOutputEvent" },
+          "minItems": 0,
+          "maxItems": 0
+        },
+        "ackToken": { "type": "null" },
+        "stale": { "const": false }
+      },
+      "required": ["events", "ackToken", "stale"],
+      "additionalProperties": false
+    },
+    "M0CReadStaleResult": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MessageOutputEvent" },
+          "minItems": 0,
+          "maxItems": 0
+        },
+        "ackToken": { "type": "null" },
+        "stale": { "const": true }
+      },
+      "required": ["events", "ackToken", "stale"],
+      "additionalProperties": false
+    },
+    "M0CReadResult": {
+      "oneOf": [
+        { "$ref": "#/$defs/M0CReadNormalResult" },
+        { "$ref": "#/$defs/M0CReadEmptyResult" },
+        { "$ref": "#/$defs/M0CReadStaleResult" }
+      ]
+    },
+    "M0CAckInput": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "ackToken": { "type": "string", "minLength": 1, "maxLength": 512 }
+      },
+      "required": ["subscriptionId", "ackToken"],
+      "additionalProperties": false
+    },
+    "M0CAckResult": {
+      "type": "null"
+    },
+    "M0CSnapshotInput": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "maxItems": { "type": "integer", "minimum": 1, "maximum": 64 },
+        "pageToken": { "type": "string", "minLength": 1, "maxLength": 512 }
+      },
+      "required": ["subscriptionId", "maxItems"],
+      "additionalProperties": false
+    },
+    "M0CSnapshotIntermediateResult": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MessageEnvelope" },
+          "minItems": 1,
+          "maxItems": 64
+        },
+        "nextPageToken": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "snapshotAckToken": { "type": "null" }
+      },
+      "required": ["items", "nextPageToken", "snapshotAckToken"],
+      "additionalProperties": false
+    },
+    "M0CSnapshotFinalResult": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MessageEnvelope" },
+          "maxItems": 64
+        },
+        "nextPageToken": { "type": "null" },
+        "snapshotAckToken": { "type": "string", "minLength": 1, "maxLength": 512 }
+      },
+      "required": ["items", "nextPageToken", "snapshotAckToken"],
+      "additionalProperties": false
+    },
+    "M0CSnapshotResult": {
+      "oneOf": [
+        { "$ref": "#/$defs/M0CSnapshotIntermediateResult" },
+        { "$ref": "#/$defs/M0CSnapshotFinalResult" }
+      ]
     }
   }
 }