@appsolutely-io/waypoint 0.0.0-stage → 0.1.1-next.0

package/dist/schema.json

@@ -0,0 +1,2900 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://waypoint.example/schema",
+  "title": "WaypointProtocol",
+  "$defs": {
+    "Problem": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "enum": [
+            "update-required",
+            "in-doubt",
+            "replaced",
+            "retryable",
+            "refused",
+            "closed",
+            "full",
+            "declined",
+            "unavailable",
+            "sign-in",
+            "rate-limited",
+            "step-up-cancelled",
+            "mismatch",
+            "invalid-read",
+            "invalid-plan",
+            "needs-attention",
+            "stopped",
+            "plan-changed",
+            "agreement-expired"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "retryAfter": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "confirmation": {
+          "type": "object",
+          "description": "Why a confirmation was refused; only with code refused.",
+          "properties": {
+            "reason": {
+              "enum": ["expired", "used", "stale", "mismatch", "missing"]
+            }
+          },
+          "required": ["reason"]
+        }
+      },
+      "required": ["code", "id"]
+    },
+    "Negotiation": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "supported": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "offer": {
+          "$ref": "#/$defs/NegotiationOfferWire"
+        }
+      },
+      "required": ["protocol", "supported"]
+    },
+    "NegotiationOfferWire": {
+      "type": "object",
+      "properties": {
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": ["capabilities"]
+    },
+    "Negotiated": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "agreementId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9._~-]+$"
+        }
+      },
+      "required": ["protocol", "capabilities"]
+    },
+    "CanonicalRequest": {
+      "type": "object",
+      "properties": {
+        "method": {
+          "enum": ["POST", "PUT", "PATCH", "GET"]
+        },
+        "path": {
+          "type": "string",
+          "pattern": "^/[^?#]*$"
+        },
+        "body": {
+          "type": "string"
+        },
+        "headers": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["method", "path", "body", "headers", "digest"],
+      "additionalProperties": false
+    },
+    "ReadTemplate": {
+      "type": "object",
+      "properties": {
+        "method": {
+          "const": "GET"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "fields": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": ["method", "path", "rows", "fields"],
+      "additionalProperties": false
+    },
+    "Step": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "resource": {
+          "type": "string",
+          "minLength": 1
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "fields": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "view": {
+          "type": "string",
+          "minLength": 1
+        },
+        "tier": {
+          "enum": ["low", "sensitive"]
+        },
+        "undo": {
+          "type": "string",
+          "pattern": "^(compare-and-set|archive-created|inverse:[a-zA-Z0-9._-]+|none)$"
+        },
+        "stepUp": {
+          "type": "boolean"
+        },
+        "request": {
+          "$ref": "#/$defs/CanonicalRequest"
+        },
+        "before": {
+          "type": "object"
+        },
+        "after": {
+          "type": "object"
+        },
+        "planningRead": {
+          "$ref": "#/$defs/ReadTemplate"
+        }
+      },
+      "required": [
+        "id",
+        "operation",
+        "resource",
+        "rows",
+        "fields",
+        "view",
+        "tier",
+        "undo",
+        "stepUp"
+      ]
+    },
+    "ImmediateDraft": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "immediate"
+        },
+        "stage": {
+          "const": "draft"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "allOf": [
+              {
+                "$ref": "#/$defs/Step"
+              },
+              {
+                "required": ["planningRead"],
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": ["request"]
+                    },
+                    {
+                      "required": ["before"]
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      },
+      "required": ["kind", "stage", "id", "steps"],
+      "additionalProperties": false
+    },
+    "ImmediatePlan": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "immediate"
+        },
+        "stage": {
+          "const": "final"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "allOf": [
+              {
+                "$ref": "#/$defs/Step"
+              },
+              {
+                "required": ["request", "before", "after"],
+                "not": {
+                  "required": ["planningRead"]
+                }
+              }
+            ]
+          }
+        },
+        "stepUpCount": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "required": ["kind", "stage", "id", "digest", "steps", "stepUpCount"],
+      "additionalProperties": false
+    },
+    "TimedPlan": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "timed"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "values": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": {}
+          }
+        },
+        "start": {
+          "type": ["string", "null"]
+        },
+        "end": {
+          "type": ["string", "null"]
+        }
+      },
+      "required": ["kind", "id", "values", "start", "end"],
+      "additionalProperties": false,
+      "not": {
+        "properties": {
+          "start": {
+            "const": null
+          },
+          "end": {
+            "const": null
+          }
+        }
+      }
+    },
+    "Plan": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/ImmediateDraft"
+        },
+        {
+          "$ref": "#/$defs/ImmediatePlan"
+        },
+        {
+          "$ref": "#/$defs/TimedPlan"
+        }
+      ]
+    },
+    "PlanState": {
+      "enum": [
+        "proposed",
+        "awaiting-confirmation",
+        "running",
+        "undoing",
+        "completed",
+        "submitted",
+        "undone",
+        "needs-attention",
+        "cancelled"
+      ]
+    },
+    "Outcome": {
+      "type": "object",
+      "properties": {
+        "stepId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "attributed": {
+          "type": "boolean"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "The host's plain words for why the step failed, shown to the user; only for a failed step. Optional."
+        },
+        "retryable": {
+          "type": "boolean",
+          "description": "Whether the failed step can be tried again. Optional."
+        }
+      },
+      "required": ["stepId", "status", "attributed"]
+    },
+    "ConfirmationItem": {
+      "type": "object",
+      "properties": {
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "before": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "after": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        }
+      },
+      "required": ["label"]
+    },
+    "ConfirmationSchedule": {
+      "type": "object",
+      "properties": {
+        "start": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "end": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "startText": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "endText": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        }
+      },
+      "required": ["start", "end", "startText", "endText"]
+    },
+    "ConfirmationRecord": {
+      "type": "object",
+      "description": "What the host will apply, issued and worded by the host; confirmed only by sending its single-use token.",
+      "properties": {
+        "token": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "conversationId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "heading": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ConfirmationItem"
+          },
+          "maxItems": 1000
+        },
+        "schedule": {
+          "$ref": "#/$defs/ConfirmationSchedule"
+        },
+        "irreversible": {
+          "type": "boolean"
+        },
+        "undo": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "verificationCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "actionLabel": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        }
+      },
+      "required": [
+        "token",
+        "expiresAt",
+        "planId",
+        "conversationId",
+        "revision",
+        "heading",
+        "items",
+        "irreversible",
+        "undo",
+        "verificationCount"
+      ]
+    },
+    "PlanRecord": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "state": {
+          "$ref": "#/$defs/PlanState"
+        },
+        "plan": {
+          "$ref": "#/$defs/Plan"
+        },
+        "outcomes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Outcome"
+          }
+        },
+        "undoPlanId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "recovery": {
+          "$ref": "#/$defs/RecoveryView"
+        },
+        "confirmation": {
+          "$ref": "#/$defs/ConfirmationRecord"
+        }
+      },
+      "required": ["protocol", "id", "state", "plan", "outcomes"]
+    },
+    "RecoveryPhase": {
+      "enum": [
+        "proposal",
+        "initial-review",
+        "forward-active",
+        "readback",
+        "completed",
+        "cancelled",
+        "left-known",
+        "left-unconfirmed",
+        "left-reopened"
+      ]
+    },
+    "IntentKind": {
+      "enum": ["stop", "cancel-initial", "cancel-review", "leave", "keep"]
+    },
+    "WinnerKind": {
+      "enum": ["stop", "cancel-initial", "cancel-review", "leave", "keep"]
+    },
+    "IntentCause": {
+      "enum": [
+        "user",
+        "connection-lost",
+        "renewal-refused",
+        "step-failed",
+        "step-up-failed",
+        "identity-lost",
+        "attribution-missing",
+        "plan-changed",
+        "adapter-configuration"
+      ]
+    },
+    "IntentWinner": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "$ref": "#/$defs/WinnerKind"
+        },
+        "cause": {
+          "$ref": "#/$defs/IntentCause"
+        }
+      },
+      "required": ["kind", "cause"],
+      "additionalProperties": false
+    },
+    "RecoveryView": {
+      "type": "object",
+      "properties": {
+        "profile": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "x-open-enum": ["plan-recovery-v1"]
+        },
+        "phase": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "x-open-enum": "RecoveryPhase"
+        },
+        "generation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "round": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "conversationId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "reviewId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "slots": {
+          "type": "object",
+          "properties": {
+            "stop": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "cancel-initial": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "cancel-review": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "leave": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "keep": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "stop",
+            "cancel-initial",
+            "cancel-review",
+            "leave",
+            "keep"
+          ],
+          "additionalProperties": false
+        },
+        "winner": {
+          "$ref": "#/$defs/IntentWinner"
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "stepId": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128
+              },
+              "truth": {
+                "enum": ["done", "not-done", "unknown"]
+              }
+            },
+            "required": ["stepId", "truth"],
+            "additionalProperties": false
+          }
+        },
+        "versions": {
+          "$ref": "#/$defs/DecisionVersions"
+        },
+        "decisionKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "evidenceDigest": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_-]{43}$"
+        },
+        "unknownCount": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "remaining": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "sealed": {
+          "type": "boolean"
+        },
+        "contradictedAfterSeal": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "maxItems": 256
+        }
+      },
+      "required": [
+        "profile",
+        "phase",
+        "generation",
+        "round",
+        "revision",
+        "conversationId",
+        "slots",
+        "versions"
+      ],
+      "additionalProperties": false
+    },
+    "IntentTarget": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "enum": ["generation", "review", "execution"]
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        }
+      },
+      "required": ["type", "id"],
+      "additionalProperties": false
+    },
+    "IntentRequest": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "$ref": "#/$defs/IntentKind"
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "target": {
+          "$ref": "#/$defs/IntentTarget"
+        },
+        "capturedRound": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "expectedSlotVersion": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "correlation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "cause": {
+          "$ref": "#/$defs/IntentCause"
+        },
+        "payload": {
+          "type": "string",
+          "maxLength": 4096
+        },
+        "acknowledgment": {
+          "$ref": "#/$defs/LeaveAcknowledgment"
+        },
+        "review": {
+          "enum": ["forward-only", "end-retention"]
+        }
+      },
+      "required": [
+        "kind",
+        "planId",
+        "target",
+        "capturedRound",
+        "expectedSlotVersion",
+        "correlation",
+        "cause"
+      ],
+      "additionalProperties": false
+    },
+    "PlanIntentReply": {
+      "type": "object",
+      "properties": {
+        "planId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "kind": {
+          "$ref": "#/$defs/IntentKind"
+        },
+        "capturedRound": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "correlation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "effectiveRound": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "slotVersion": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "resolvedTarget": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "requestedTargetApplied": {
+          "type": "boolean"
+        },
+        "replacement": {
+          "$ref": "#/$defs/IntentTarget"
+        },
+        "result": {
+          "enum": [
+            "applied",
+            "replaced",
+            "already-closed",
+            "already-stopped",
+            "defeated",
+            "superseded",
+            "needs-review",
+            "conflict",
+            "unavailable",
+            "invalid-target",
+            "refused",
+            "kept",
+            "already-kept",
+            "sealed"
+          ]
+        },
+        "keys": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          }
+        },
+        "winner": {
+          "$ref": "#/$defs/IntentWinner"
+        },
+        "phase": {
+          "$ref": "#/$defs/RecoveryPhase"
+        },
+        "safetyApplied": {
+          "type": "boolean"
+        },
+        "dispositionApplied": {
+          "type": "boolean"
+        },
+        "forwardClosed": {
+          "type": "boolean"
+        },
+        "count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "requestKey": {
+          "enum": ["requestAlreadyStopped", "requestTargetStopped"]
+        },
+        "savedDisposition": {
+          "type": "object",
+          "properties": {
+            "phase": {
+              "enum": ["left-known", "left-unconfirmed"]
+            },
+            "count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": ["phase", "count"],
+          "additionalProperties": false
+        },
+        "finalHistory": {
+          "$ref": "#/$defs/FinalHistory"
+        }
+      },
+      "required": [
+        "planId",
+        "kind",
+        "capturedRound",
+        "correlation",
+        "effectiveRound",
+        "slotVersion",
+        "result",
+        "keys",
+        "phase"
+      ],
+      "additionalProperties": false
+    },
+    "ExecutionAcceptance": {
+      "type": "object",
+      "properties": {
+        "planId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "executionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "fence": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": ["planId", "executionId", "fence"],
+      "additionalProperties": false
+    },
+    "ReplyDecline": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "decline"
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        }
+      },
+      "required": ["kind", "planId", "clientReplyId"],
+      "additionalProperties": false
+    },
+    "CardAnswer": {
+      "description": "The answer the host applied to a card, as it was sent without its protocol; only with answered. A host may leave out a form's values.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "const": "action"
+            },
+            "clientReplyId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "blockId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "actionId": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": ["kind", "clientReplyId", "blockId", "actionId"]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "const": "form"
+            },
+            "clientReplyId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "blockId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "values": {
+              "type": "object"
+            }
+          },
+          "required": ["kind", "clientReplyId", "blockId"]
+        }
+      ]
+    },
+    "BlockMarkdown": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "markdown"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "text": {
+              "type": "string"
+            }
+          },
+          "required": ["text"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockCard": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "card"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string",
+              "minLength": 1
+            },
+            "blocks": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/Block"
+              }
+            }
+          },
+          "required": ["title", "blocks"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockDetails": {
+      "type": "object",
+      "description": "Supporting detail behind a disclosure: closed until the user opens it, so the answer comes first.",
+      "properties": {
+        "type": {
+          "const": "details",
+          "description": "The block's type: `details`."
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The block's id, unique in its message."
+        },
+        "fallback": {
+          "type": "string",
+          "description": "Plain text shown by a client that does not know the type."
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "summary": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200,
+              "description": "The words on the closed disclosure."
+            },
+            "blocks": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/Block"
+              },
+              "description": "The supporting detail, shown when the disclosure is open."
+            }
+          },
+          "required": ["summary", "blocks"],
+          "description": "The disclosure's words and what it holds."
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to a card nested in this block, named in `answer`. An answer marks the message's own block, so a details block that holds a form or buttons is the one marked (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockList": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "list"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "required": ["items"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockTable": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "table"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "columns": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "rows": {
+              "type": "array",
+              "items": {
+                "type": "array",
+                "items": {}
+              }
+            }
+          },
+          "required": ["columns", "rows"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockForm": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "form"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "fields": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "required": {
+                    "type": "boolean"
+                  },
+                  "value": {
+                    "description": "What the host already knows for the field: the form starts with it, and the user may change it. Optional.",
+                    "type": "string"
+                  }
+                },
+                "required": ["name", "label"]
+              }
+            }
+          },
+          "required": ["fields"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockChoice": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "choice"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "enum": ["single", "multi", "text"]
+            },
+            "options": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "required": ["mode", "options"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockButtons": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "buttons"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "actions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "required": ["id", "label"]
+              }
+            }
+          },
+          "required": ["actions"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockDiff": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "diff"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "before": {},
+            "after": {}
+          },
+          "required": ["before", "after"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockPlan": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "plan"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "planId": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": ["planId"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockRouteLink": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "route-link"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string",
+              "minLength": 1
+            },
+            "route": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": ["label", "route"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "BlockNotice": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "notice"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "text": {
+              "type": "string",
+              "minLength": 1
+            },
+            "tone": {
+              "enum": ["info", "warning", "error"]
+            }
+          },
+          "required": ["text"]
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "ExtensionBlock": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9._-]+/[a-zA-Z0-9._-]+$"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {},
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"]
+    },
+    "Block": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/BlockMarkdown"
+        },
+        {
+          "$ref": "#/$defs/BlockCard"
+        },
+        {
+          "$ref": "#/$defs/BlockDetails"
+        },
+        {
+          "$ref": "#/$defs/BlockList"
+        },
+        {
+          "$ref": "#/$defs/BlockTable"
+        },
+        {
+          "$ref": "#/$defs/BlockForm"
+        },
+        {
+          "$ref": "#/$defs/BlockChoice"
+        },
+        {
+          "$ref": "#/$defs/BlockButtons"
+        },
+        {
+          "$ref": "#/$defs/BlockDiff"
+        },
+        {
+          "$ref": "#/$defs/BlockPlan"
+        },
+        {
+          "$ref": "#/$defs/BlockRouteLink"
+        },
+        {
+          "$ref": "#/$defs/BlockNotice"
+        },
+        {
+          "$ref": "#/$defs/BlockFormFill"
+        },
+        {
+          "$ref": "#/$defs/ExtensionBlock"
+        }
+      ]
+    },
+    "Message": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientMessageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "role": {
+          "enum": ["user", "assistant"]
+        },
+        "content": {
+          "type": "string"
+        },
+        "blocks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Block"
+          }
+        },
+        "createdAt": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "status": {
+          "enum": ["writing", "completed", "failed", "unavailable", "stopped"]
+        },
+        "versionIndex": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "versionCount": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "sources": {
+          "description": "What the reply drew on. `[n]` in its content cites the n-th source. Optional.",
+          "type": "array",
+          "maxItems": 50,
+          "items": {
+            "$ref": "#/$defs/Source"
+          }
+        }
+      },
+      "required": ["id", "role", "content", "blocks", "createdAt"]
+    },
+    "Source": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["id", "title", "url"]
+    },
+    "Conversation": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string"
+        },
+        "messages": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Message"
+          }
+        },
+        "replyOverdueAt": {
+          "type": ["number", "null"]
+        },
+        "replyStatus": {
+          "enum": ["expected", "unavailable", "failed", "complete"]
+        },
+        "mode": {
+          "const": "form-fill"
+        },
+        "subject": {
+          "$ref": "#/$defs/FormSubject"
+        },
+        "parentConversationId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "field": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["protocol", "id", "title", "messages"],
+      "allOf": [
+        {
+          "if": {
+            "required": ["mode"]
+          },
+          "then": {
+            "required": ["subject"]
+          }
+        }
+      ]
+    },
+    "ReplyMessage": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "message"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "content": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientMessageId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "kind",
+        "protocol",
+        "clientReplyId",
+        "content",
+        "clientMessageId"
+      ]
+    },
+    "ReplyConfirm": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "confirm"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        },
+        "confirmationToken": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        }
+      },
+      "required": [
+        "kind",
+        "protocol",
+        "clientReplyId",
+        "planId",
+        "confirmationToken"
+      ]
+    },
+    "ReplyForm": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "form"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "blockId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "values": {
+          "type": "object"
+        }
+      },
+      "required": ["kind", "protocol", "clientReplyId", "blockId", "values"]
+    },
+    "ReplyAction": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "action"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "blockId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "actionId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["kind", "protocol", "clientReplyId", "blockId", "actionId"]
+    },
+    "ReplyToolResult": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "tool-result"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "callId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "result": {},
+        "problem": {
+          "$ref": "#/$defs/Problem"
+        }
+      },
+      "required": ["kind", "protocol", "clientReplyId", "callId", "result"]
+    },
+    "ReplyPlanValues": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "plan.values"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "stepId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "rows": {
+                "type": "object"
+              },
+              "versions": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            },
+            "required": ["stepId", "rows", "versions"]
+          }
+        }
+      },
+      "required": ["kind", "protocol", "clientReplyId", "planId", "steps"]
+    },
+    "Reply": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/ReplyMessage"
+        },
+        {
+          "$ref": "#/$defs/ReplyConfirm"
+        },
+        {
+          "$ref": "#/$defs/ReplyForm"
+        },
+        {
+          "$ref": "#/$defs/ReplyAction"
+        },
+        {
+          "$ref": "#/$defs/ReplyToolResult"
+        },
+        {
+          "$ref": "#/$defs/ReplyPlanValues"
+        },
+        {
+          "$ref": "#/$defs/ReplyFormFill"
+        },
+        {
+          "$ref": "#/$defs/ReplyStop"
+        }
+      ]
+    },
+    "ReplyStop": {
+      "description": "Asks the host to stop writing a reply. Sent only under the negotiated `reply-stop` capability.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "stop"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "versionIndex": {
+          "description": "The version of the message the stop is for, numbered as the message's `versionIndex` (1 for a message with one version). A host ignores a stop for a version it is not writing. Optional: without it, the stop is for the version being written when it arrives.",
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "required": ["kind", "protocol", "clientReplyId", "messageId"]
+    },
+    "ManifestEntry": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "enum": [
+            "read",
+            "planning-read",
+            "update",
+            "create",
+            "action",
+            "bulk"
+          ]
+        },
+        "method": {
+          "enum": ["GET", "POST", "PUT", "PATCH"]
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "resource": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fields": {
+          "type": "object",
+          "additionalProperties": {
+            "enum": ["low", "sensitive", "human-only"]
+          }
+        },
+        "returns": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "filterable": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "permission": {
+          "type": "string",
+          "minLength": 1
+        },
+        "view": {
+          "type": "string",
+          "minLength": 1
+        },
+        "undo": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "id",
+        "kind",
+        "method",
+        "path",
+        "resource",
+        "fields",
+        "returns",
+        "filterable",
+        "permission",
+        "view",
+        "undo"
+      ]
+    },
+    "ToolCall": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "method": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "query": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "label": {
+          "description": "The host's plain words for the read, shown to the user while it runs, for example \"Reading 3 orders…\". Optional.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        }
+      },
+      "required": ["id", "operation", "method", "path"]
+    },
+    "FrameMessageStart": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "message.start"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "role": {
+          "enum": ["user", "assistant"]
+        }
+      },
+      "required": ["type", "protocol", "sequence", "messageId", "role"]
+    },
+    "FrameTextDelta": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "text.delta"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "text": {
+          "type": "string"
+        }
+      },
+      "required": ["type", "protocol", "sequence", "messageId", "text"]
+    },
+    "FrameBlock": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "block"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "block": {
+          "$ref": "#/$defs/Block"
+        }
+      },
+      "required": ["type", "protocol", "sequence", "messageId", "block"]
+    },
+    "FramePlanDraft": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "plan.draft"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "plan": {
+          "$ref": "#/$defs/ImmediateDraft"
+        }
+      },
+      "required": ["type", "protocol", "sequence", "messageId", "plan"]
+    },
+    "FramePlanFinal": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "plan.final"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "plan": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/ImmediatePlan"
+            },
+            {
+              "$ref": "#/$defs/TimedPlan"
+            }
+          ]
+        }
+      },
+      "required": ["type", "protocol", "sequence", "messageId", "plan"]
+    },
+    "FramePlanStep": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "plan.step"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "outcome": {
+          "$ref": "#/$defs/Outcome"
+        }
+      },
+      "required": ["type", "protocol", "sequence", "planId", "outcome"]
+    },
+    "FrameToolCall": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "tool.call"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "call": {
+          "$ref": "#/$defs/ToolCall"
+        }
+      },
+      "required": ["type", "protocol", "sequence", "call"]
+    },
+    "FramePlanningRead": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "planning-read"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "stepId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "template": {
+          "$ref": "#/$defs/ReadTemplate"
+        }
+      },
+      "required": [
+        "type",
+        "protocol",
+        "sequence",
+        "planId",
+        "stepId",
+        "template"
+      ]
+    },
+    "FrameMessageEnd": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "message.end"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "enum": ["completed", "failed", "unavailable", "stopped"]
+        }
+      },
+      "required": ["type", "protocol", "sequence", "messageId", "status"]
+    },
+    "FrameStale": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "stale"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "reads": {
+          "type": "array",
+          "items": {
+            "enum": ["conversation", "conversations", "plans", "flows"]
+          }
+        }
+      },
+      "required": ["type", "protocol", "sequence", "reads"]
+    },
+    "FrameProblem": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "problem"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "problem": {
+          "$ref": "#/$defs/Problem"
+        }
+      },
+      "required": ["type", "protocol", "sequence", "problem"]
+    },
+    "Frame": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/FrameMessageStart"
+        },
+        {
+          "$ref": "#/$defs/FrameTextDelta"
+        },
+        {
+          "$ref": "#/$defs/FrameBlock"
+        },
+        {
+          "$ref": "#/$defs/FramePlanDraft"
+        },
+        {
+          "$ref": "#/$defs/FramePlanFinal"
+        },
+        {
+          "$ref": "#/$defs/FramePlanStep"
+        },
+        {
+          "$ref": "#/$defs/FrameToolCall"
+        },
+        {
+          "$ref": "#/$defs/FramePlanningRead"
+        },
+        {
+          "$ref": "#/$defs/FrameMessageEnd"
+        },
+        {
+          "$ref": "#/$defs/FrameStale"
+        },
+        {
+          "$ref": "#/$defs/FrameProblem"
+        }
+      ]
+    },
+    "FlowParameter": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "enum": ["string", "number", "boolean"]
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "default": {}
+      },
+      "required": ["name", "type", "label", "required"]
+    },
+    "Flow": {
+      "type": "object",
+      "properties": {
+        "format": {
+          "const": "1.0"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "enum": ["structured", "prompt"]
+        },
+        "parameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/FlowParameter"
+          }
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "minLength": 1
+              },
+              "arguments": {
+                "type": "object"
+              }
+            },
+            "required": ["operation", "arguments"]
+          }
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "body": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "format",
+        "id",
+        "title",
+        "kind",
+        "parameters",
+        "tags",
+        "body"
+      ],
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "kind": {
+                "const": "structured"
+              }
+            }
+          },
+          "then": {
+            "required": ["steps"]
+          },
+          "else": {
+            "not": {
+              "required": ["steps"]
+            }
+          }
+        }
+      ]
+    },
+    "CreateConversation": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mode": {
+          "const": "form-fill"
+        },
+        "subject": {
+          "$ref": "#/$defs/FormSubject"
+        },
+        "parentConversationId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "field": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientCreationId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["protocol", "title"],
+      "allOf": [
+        {
+          "if": {
+            "required": ["mode"]
+          },
+          "then": {
+            "required": ["subject"]
+          }
+        }
+      ]
+    },
+    "PlanCommand": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "action": {
+          "enum": ["stop", "heartbeat", "resume", "retry-undo"]
+        },
+        "planId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["protocol", "action", "planId"]
+    },
+    "RunFlow": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "flowId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "values": {
+          "type": "object"
+        }
+      },
+      "required": ["protocol", "flowId", "values"]
+    },
+    "PatchFlow": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "flowId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "favourite": {
+          "type": "boolean"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["protocol", "flowId", "favourite", "title"]
+    },
+    "FormSubject": {
+      "type": "object",
+      "properties": {
+        "key": {
+          "type": "string",
+          "minLength": 1
+        },
+        "resource": {
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "route": {
+          "type": "string"
+        },
+        "state": {
+          "enum": ["pending", "bound", "unlinked"]
+        },
+        "record": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": ["key", "resource", "label", "route", "state"],
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "state": {
+                "const": "bound"
+              }
+            }
+          },
+          "then": {
+            "required": ["record"]
+          }
+        }
+      ]
+    },
+    "FormValidation": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "enum": ["valid", "invalid"]
+        },
+        "messages": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "guidance": {
+          "type": "string"
+        }
+      },
+      "required": ["status", "messages"],
+      "additionalProperties": false
+    },
+    "FormFillValue": {
+      "type": "object",
+      "properties": {
+        "label": {
+          "type": "string"
+        },
+        "value": {},
+        "validation": {
+          "$ref": "#/$defs/FormValidation"
+        }
+      },
+      "required": ["value", "validation"],
+      "additionalProperties": false
+    },
+    "FormFillField": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "tier": {
+          "const": "low"
+        },
+        "value": {}
+      },
+      "required": ["name", "label", "tier", "value"],
+      "additionalProperties": false
+    },
+    "FormFillRequest": {
+      "type": "object",
+      "properties": {
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "text": {
+          "type": "string"
+        },
+        "references": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "attachments": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "field": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fields": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/FormFillField"
+          }
+        }
+      },
+      "required": ["requestId", "text", "references", "attachments", "fields"],
+      "additionalProperties": false
+    },
+    "BlockFormFill": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "const": "form.fill"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fallback": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "properties": {
+            "requestId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "values": {
+              "type": "object",
+              "minProperties": 1,
+              "additionalProperties": {
+                "$ref": "#/$defs/FormFillValue"
+              }
+            }
+          },
+          "required": ["requestId", "values"],
+          "additionalProperties": false
+        },
+        "answered": {
+          "type": "boolean",
+          "description": "Whether the host holds an answer to this card; it holds one at most (see the README's Card answers)."
+        },
+        "answer": {
+          "$ref": "#/$defs/CardAnswer"
+        }
+      },
+      "required": ["type", "id", "fallback", "body"],
+      "additionalProperties": false
+    },
+    "ReplyFormFill": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "form-fill"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1
+        },
+        "clientReplyId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "request": {
+          "$ref": "#/$defs/FormFillRequest"
+        }
+      },
+      "required": ["kind", "protocol", "clientReplyId", "request"],
+      "additionalProperties": false
+    },
+    "LeaveAcknowledgment": {
+      "type": "object",
+      "properties": {
+        "sourceDecisionKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "evidenceVersion": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "winnerVersion": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "decisionResolutionVersion": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "evidenceDigest": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_-]{43}$"
+        },
+        "unknownCount": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "sourceDecisionKey",
+        "evidenceVersion",
+        "winnerVersion",
+        "decisionResolutionVersion",
+        "evidenceDigest",
+        "unknownCount"
+      ],
+      "additionalProperties": false
+    },
+    "DecisionVersions": {
+      "type": "object",
+      "properties": {
+        "evidence": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "winner": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "decisionResolution": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": ["evidence", "winner", "decisionResolution"],
+      "additionalProperties": false
+    },
+    "KeptFact": {
+      "type": "object",
+      "properties": {
+        "keepEffect": {
+          "enum": [
+            "forward-closed",
+            "decision-closed",
+            "retention-ended",
+            "leave-completed"
+          ]
+        },
+        "actorCause": {
+          "$ref": "#/$defs/IntentCause"
+        },
+        "round": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": ["keepEffect", "actorCause", "round"],
+      "additionalProperties": false
+    },
+    "FinalHistory": {
+      "type": "object",
+      "properties": {
+        "winner": {
+          "$ref": "#/$defs/IntentWinner"
+        },
+        "keptFact": {
+          "$ref": "#/$defs/KeptFact"
+        },
+        "relation": {
+          "enum": [
+            "keptElsewhere",
+            "leaveCompletedByKeep",
+            "leaveCoveredByKeep"
+          ]
+        },
+        "requestedTargetApplied": {
+          "type": "boolean"
+        },
+        "contradictedAfterSeal": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "maxItems": 256
+        }
+      },
+      "required": ["winner", "keptFact"],
+      "additionalProperties": false
+    }
+  },
+  "oneOf": [
+    {
+      "$ref": "#/$defs/Negotiation"
+    },
+    {
+      "$ref": "#/$defs/Negotiated"
+    },
+    {
+      "$ref": "#/$defs/Conversation"
+    },
+    {
+      "$ref": "#/$defs/Reply"
+    },
+    {
+      "$ref": "#/$defs/Frame"
+    },
+    {
+      "$ref": "#/$defs/PlanRecord"
+    }
+  ]
+}