@clowder-ai/plugin-contract 0.1.0-beta.1 → 0.1.0-beta.11

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
@@ -291,20 +297,32 @@
       "required": ["address", "idempotencyKey", "payload"],
       "additionalProperties": false
     },
+    "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$"
+        }
+      ]
+    },
     "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": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "revision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "threadId": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "replyTo": { "type": "string", "minLength": 1, "maxLength": 256 },
         "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 +331,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 +342,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": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "threadId": { "type": "string", "minLength": 1, "maxLength": 512 },
         "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,23 +369,26 @@
     "SendReceipt": {
       "type": "object",
       "properties": {
-        "messageId": { "type": "string", "minLength": 1 },
-        "threadId": { "type": "string", "minLength": 1 },
-        "revision": { "type": "integer", "minimum": 1 },
-        "publishSequence": { "type": "integer", "minimum": 0 }
+        "messageId": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "threadId": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "revision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "messageHandle": { "$ref": "#/$defs/MessageHandle" },
+        "publishSequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
       },
-      "required": ["messageId", "threadId", "revision"],
+      "required": ["messageId", "threadId", "revision", "messageHandle"],
       "additionalProperties": false
     },
     "AppendReceipt": {
       "type": "object",
       "properties": {
-        "messageId": { "type": "string", "minLength": 1 },
-        "revision": { "type": "integer", "minimum": 1 },
-        "appendSequence": { "type": "integer", "minimum": 0 },
+        "messageId": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "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"],
@@ -381,7 +402,7 @@
       "type": "object",
       "properties": {
         "kind": { "const": "message" },
-        "token": { "type": "string", "minLength": 1 }
+        "token": { "type": "string", "minLength": 1, "maxLength": 512 }
       },
       "required": ["kind", "token"],
       "additionalProperties": false
@@ -391,7 +412,7 @@
       "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" },
@@ -405,6 +426,7 @@
     "SubscriptionCursor": {
       "type": "string",
       "minLength": 1,
+      "maxLength": 512,
       "description": "Opaque, subscription-local acknowledgement token."
     },
     "SubscriptionNormalResponse": {
@@ -428,6 +450,7 @@
         "events": {
           "type": "array",
           "items": { "$ref": "#/$defs/MessageOutputEvent" },
+          "minItems": 0,
           "maxItems": 0
         },
         "ackToken": { "type": "null" },
@@ -442,6 +465,7 @@
         "events": {
           "type": "array",
           "items": { "$ref": "#/$defs/MessageOutputEvent" },
+          "minItems": 0,
           "maxItems": 0
         },
         "ackToken": { "type": "null" },
@@ -462,12 +486,165 @@
       "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
+    },
+    "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" }
+      ]
+    },
+    "M0CDeliverInput": {
+      "type": "object",
+      "properties": {
+        "deliveryId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "threadHandle": { "$ref": "#/$defs/ThreadHandleAddress" },
+        "envelope": { "$ref": "#/$defs/MessageEnvelope" }
+      },
+      "required": ["deliveryId", "threadHandle", "envelope"],
+      "additionalProperties": false
+    },
+    "M0CDeliverResult": {
+      "type": "object",
+      "properties": {
+        "deliveryId": { "type": "string", "minLength": 1, "maxLength": 128 }
+      },
+      "required": ["deliveryId"],
+      "additionalProperties": false
     }
   }
 }

package/src/schemas/physical-limb.schema.json

@@ -0,0 +1,319 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://clowder-ai.dev/schemas/physical-limb/v0.1",
+  "title": "Clowder AI Physical Limb Contribution (v0.1)",
+  "description": "Typed, bounded contract for a Host-governed physical limb contribution. Raw sensor media is intentionally absent.",
+  "x-clowder-physical-limb-grants": [
+    "limb.action.motion",
+    "limb.action.display",
+    "limb.action.light",
+    "limb.action.speaker",
+    "limb.observe.touch",
+    "limb.sensor.microphone",
+    "limb.sensor.camera"
+  ],
+  "x-clowder-physical-limb-bounds": {
+    "maxIdentifierLength": 128,
+    "maxTranscriptCodePoints": 4096,
+    "maxTouchDurationMs": 10000,
+    "minListenDurationMs": 100,
+    "maxListenDurationMs": 30000,
+    "maxActionTimeoutMs": 30000
+  },
+  "$defs": {
+    "PhysicalLimbIdentifier": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "PhysicalLimbGrant": {
+      "type": "string",
+      "enum": [
+        "limb.action.motion",
+        "limb.action.display",
+        "limb.action.light",
+        "limb.action.speaker",
+        "limb.observe.touch",
+        "limb.sensor.microphone",
+        "limb.sensor.camera"
+      ]
+    },
+    "PhysicalLimbSafePose": {
+      "type": "object",
+      "properties": {
+        "yawDeg": { "type": "number", "minimum": -90, "maximum": 90 },
+        "pitchDeg": { "type": "number", "minimum": -90, "maximum": 90 },
+        "timeoutMs": { "type": "integer", "minimum": 100, "maximum": 30000 }
+      },
+      "required": ["yawDeg", "pitchDeg", "timeoutMs"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbContribution": {
+      "type": "object",
+      "properties": {
+        "contributionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeType": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "displayName": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "grants": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/PhysicalLimbGrant" },
+          "minItems": 1,
+          "maxItems": 7,
+          "uniqueItems": true
+        },
+        "safePose": { "$ref": "#/$defs/PhysicalLimbSafePose" }
+      },
+      "required": ["contributionId", "nodeType", "displayName", "grants", "safePose"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbExpressionSource": {
+      "type": "object",
+      "properties": {
+        "kind": { "type": "string", "enum": ["cat_state", "play", "degraded"] },
+        "ref": { "$ref": "#/$defs/PhysicalLimbIdentifier" }
+      },
+      "required": ["kind", "ref"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbTouchPayload": {
+      "type": "object",
+      "properties": {
+        "gesture": { "type": "string", "enum": ["tap", "stroke"] },
+        "durationMs": { "type": "integer", "minimum": 0, "maximum": 10000 },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 }
+      },
+      "required": ["gesture", "durationMs", "confidence"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbTranscriptPayload": {
+      "type": "object",
+      "properties": {
+        "interactionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "text": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "language": { "type": "string", "minLength": 1, "maxLength": 32 },
+        "captureDurationMs": { "type": "integer", "minimum": 100, "maximum": 30000 }
+      },
+      "required": ["interactionId", "text", "captureDurationMs"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbTouchObservation": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "observationId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "occurredAt": { "type": "string", "format": "date-time" },
+        "sessionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "kind": { "const": "touch" },
+        "payload": { "$ref": "#/$defs/PhysicalLimbTouchPayload" }
+      },
+      "required": ["v", "observationId", "nodeId", "occurredAt", "sessionId", "kind", "payload"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbTranscriptObservation": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "observationId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "occurredAt": { "type": "string", "format": "date-time" },
+        "sessionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "kind": { "const": "transcript" },
+        "payload": { "$ref": "#/$defs/PhysicalLimbTranscriptPayload" }
+      },
+      "required": ["v", "observationId", "nodeId", "occurredAt", "sessionId", "kind", "payload"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbObservation": {
+      "oneOf": [
+        { "$ref": "#/$defs/PhysicalLimbTouchObservation" },
+        { "$ref": "#/$defs/PhysicalLimbTranscriptObservation" }
+      ]
+    },
+    "PhysicalLimbMotionPayload": {
+      "type": "object",
+      "properties": {
+        "yawDeg": { "type": "number", "minimum": -90, "maximum": 90 },
+        "pitchDeg": { "type": "number", "minimum": -90, "maximum": 90 },
+        "speedDps": { "type": "number", "exclusiveMinimum": 0, "maximum": 240 },
+        "accelerationDps2": { "type": "number", "exclusiveMinimum": 0, "maximum": 720 }
+      },
+      "required": ["yawDeg", "pitchDeg", "speedDps", "accelerationDps2"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbDisplayPayload": {
+      "type": "object",
+      "properties": {
+        "expression": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "expressionSource": { "$ref": "#/$defs/PhysicalLimbExpressionSource" }
+      },
+      "required": ["expression", "expressionSource"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbRgb": {
+      "type": "array",
+      "items": { "type": "integer", "minimum": 0, "maximum": 255 },
+      "minItems": 3,
+      "maxItems": 3
+    },
+    "PhysicalLimbLightPayload": {
+      "type": "object",
+      "properties": {
+        "colors": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/PhysicalLimbRgb" },
+          "minItems": 1,
+          "maxItems": 256
+        }
+      },
+      "required": ["colors"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbSpeakerPayload": {
+      "type": "object",
+      "properties": {
+        "text": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "voiceProfileRef": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "volumePercent": { "type": "integer", "minimum": 0, "maximum": 100 }
+      },
+      "required": ["text", "voiceProfileRef", "volumePercent"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbMotionAction": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "actionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "deadlineUnixMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 30000 },
+        "cancelToken": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "kind": { "const": "motion" },
+        "payload": { "$ref": "#/$defs/PhysicalLimbMotionPayload" }
+      },
+      "required": ["v", "actionId", "nodeId", "deadlineUnixMs", "timeoutMs", "cancelToken", "kind", "payload"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbDisplayAction": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "actionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "deadlineUnixMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 30000 },
+        "cancelToken": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "kind": { "const": "display" },
+        "payload": { "$ref": "#/$defs/PhysicalLimbDisplayPayload" }
+      },
+      "required": ["v", "actionId", "nodeId", "deadlineUnixMs", "timeoutMs", "cancelToken", "kind", "payload"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbLightAction": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "actionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "deadlineUnixMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 30000 },
+        "cancelToken": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "kind": { "const": "light" },
+        "payload": { "$ref": "#/$defs/PhysicalLimbLightPayload" }
+      },
+      "required": ["v", "actionId", "nodeId", "deadlineUnixMs", "timeoutMs", "cancelToken", "kind", "payload"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbSpeakerAction": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "actionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "deadlineUnixMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 30000 },
+        "cancelToken": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "kind": { "const": "speaker" },
+        "payload": { "$ref": "#/$defs/PhysicalLimbSpeakerPayload" }
+      },
+      "required": ["v", "actionId", "nodeId", "deadlineUnixMs", "timeoutMs", "cancelToken", "kind", "payload"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbAction": {
+      "oneOf": [
+        { "$ref": "#/$defs/PhysicalLimbMotionAction" },
+        { "$ref": "#/$defs/PhysicalLimbDisplayAction" },
+        { "$ref": "#/$defs/PhysicalLimbLightAction" },
+        { "$ref": "#/$defs/PhysicalLimbSpeakerAction" }
+      ]
+    },
+    "PhysicalLimbCancel": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "actionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "cancelToken": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "reason": { "type": "string", "enum": ["user", "timeout", "lease_lost", "host_lost", "superseded"] }
+      },
+      "required": ["v", "nodeId", "actionId", "cancelToken", "reason"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbActionResult": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "actionId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "outcome": { "type": "string", "enum": ["succeeded", "refused", "failed", "canceled"] },
+        "reason": { "type": "string", "maxLength": 512 },
+        "observedAt": { "type": "string", "format": "date-time" }
+      },
+      "required": ["v", "actionId", "nodeId", "outcome", "observedAt"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbReadinessReason": {
+      "type": "string",
+      "enum": [
+        "gateway_disconnected",
+        "device_disconnected",
+        "firmware_incompatible",
+        "sensor_unavailable",
+        "speech_dependency_missing",
+        "skin_unavailable",
+        "grant_revoked",
+        "host_unavailable"
+      ]
+    },
+    "PhysicalLimbReadyReadiness": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "status": { "const": "ready" },
+        "observedAt": { "type": "string", "format": "date-time" }
+      },
+      "required": ["v", "nodeId", "status", "observedAt"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbUnavailableReadiness": {
+      "type": "object",
+      "properties": {
+        "v": { "const": 1 },
+        "nodeId": { "$ref": "#/$defs/PhysicalLimbIdentifier" },
+        "status": { "type": "string", "enum": ["degraded", "offline"] },
+        "reason": { "$ref": "#/$defs/PhysicalLimbReadinessReason" },
+        "observedAt": { "type": "string", "format": "date-time" }
+      },
+      "required": ["v", "nodeId", "status", "reason", "observedAt"],
+      "additionalProperties": false
+    },
+    "PhysicalLimbReadiness": {
+      "oneOf": [
+        { "$ref": "#/$defs/PhysicalLimbReadyReadiness" },
+        { "$ref": "#/$defs/PhysicalLimbUnavailableReadiness" }
+      ]
+    }
+  },
+  "$ref": "#/$defs/PhysicalLimbContribution"
+}