@mostra/protocol 0.0.0-stage → 0.1.0

package/schemas/protocol.schema.json

@@ -0,0 +1,4964 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Mostra protocol types: IDs, revisions and diagnostics",
+  "x-mostra-revisions": {
+    "host-protocol": "2026-10-10"
+  },
+  "$defs": {
+    "ActionError": {
+      "type": "object",
+      "properties": {
+        "message": {
+          "type": "string"
+        },
+        "code": {
+          "type": "string"
+        },
+        "stack": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "description": "An error from server code: its message and diagnostic code."
+    },
+    "Actor": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "viewer",
+            "agent",
+            "host",
+            "mostra"
+          ]
+        },
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind"
+      ],
+      "description": "Who caused an event or wrote a field: a viewer, an agent, a host or Mostra."
+    },
+    "AddedPackage": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "warm": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "name",
+        "version",
+        "warm"
+      ],
+      "description": "A package deps/add settled: its name, exact version and whether it is warm."
+    },
+    "ArtifactCreateParams": {
+      "type": "object",
+      "properties": {
+        "dir": {
+          "type": "string",
+          "pattern": "^\\/"
+        },
+        "template": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "dir"
+      ]
+    },
+    "ArtifactCreateResult": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "dir": {
+          "type": "string"
+        },
+        "files": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "artifactId",
+        "dir",
+        "files"
+      ]
+    },
+    "ArtifactDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "title": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "family": {
+          "type": "string"
+        },
+        "links": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ArtifactLink"
+          }
+        },
+        "mode": {
+          "type": "string",
+          "const": "spa"
+        },
+        "policy": {
+          "$ref": "#/$defs/SubmissionPolicy"
+        },
+        "source": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "latestVersion": {
+          "$ref": "#/$defs/VersionSummary"
+        },
+        "manifest": {
+          "$ref": "#/$defs/ArtifactManifest"
+        },
+        "versions": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/VersionSummary"
+          }
+        }
+      },
+      "required": [
+        "id",
+        "title",
+        "links",
+        "mode",
+        "createdAt",
+        "manifest",
+        "versions"
+      ],
+      "description": "One artifact in full: its summary, the latest manifest and every version."
+    },
+    "ArtifactGetParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        }
+      },
+      "required": [
+        "artifact"
+      ]
+    },
+    "ArtifactId": {
+      "type": "string",
+      "pattern": "^art_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Artifact ID: \"art_\" followed by a 26-character ULID."
+    },
+    "ArtifactLink": {
+      "type": "object",
+      "properties": {
+        "rel": {
+          "type": "string",
+          "minLength": 1
+        },
+        "artifact": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "rel",
+        "artifact"
+      ],
+      "description": "A related artifact: how this one relates (rel) and the other artifact's ID."
+    },
+    "ArtifactListParams": {
+      "type": "object",
+      "properties": {
+        "filter": {
+          "type": "object",
+          "properties": {
+            "family": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      }
+    },
+    "ArtifactListResult": {
+      "type": "object",
+      "properties": {
+        "artifacts": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ArtifactSummary"
+          }
+        }
+      },
+      "required": [
+        "artifacts"
+      ]
+    },
+    "ArtifactManifest": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string"
+        },
+        "family": {
+          "type": "string",
+          "minLength": 1
+        },
+        "links": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ArtifactLink"
+          }
+        },
+        "mode": {
+          "type": "string",
+          "const": "spa"
+        },
+        "submission": {
+          "$ref": "#/$defs/SubmissionPolicy"
+        },
+        "kit": {
+          "type": "object",
+          "properties": {
+            "base": {
+              "type": "string",
+              "enum": [
+                "base",
+                "radix"
+              ]
+            },
+            "theme": {
+              "type": "string"
+            }
+          }
+        },
+        "terminals": {
+          "readOnly": true,
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "command": {
+                "readOnly": true,
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "cwd": {
+                "type": "string"
+              },
+              "env": {
+                "readOnly": true,
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "cols": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "rows": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "input": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "command"
+            ]
+          }
+        },
+        "demos": {
+          "readOnly": true,
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "command": {
+                    "readOnly": true,
+                    "minItems": 1,
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "cwd": {
+                    "type": "string"
+                  },
+                  "ready": {
+                    "type": "string"
+                  },
+                  "bridge": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "command"
+                ]
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "attach": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 65535
+                  },
+                  "bridge": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "attach"
+                ]
+              }
+            ]
+          }
+        },
+        "limits": {
+          "type": "object",
+          "properties": {
+            "heapMb": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "watchdogMs": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "idleMinutes": {
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        },
+        "verify": {
+          "type": "object",
+          "properties": {
+            "viewports": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "frames": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "extraChecks": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "smoke": {
+              "type": "boolean"
+            }
+          }
+        }
+      },
+      "required": [
+        "title"
+      ],
+      "description": "The artifact manifest (INTERFACES §2.2): literal metadata from the entry's defineArtifact call or MDX frontmatter."
+    },
+    "ArtifactProgressParams": {
+      "type": "object",
+      "properties": {
+        "progressToken": {
+          "type": "string",
+          "minLength": 1
+        },
+        "stage": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fraction": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      },
+      "required": [
+        "progressToken",
+        "stage"
+      ],
+      "description": "One stage of a long request (artifact/verify) started."
+    },
+    "ArtifactPublishParams": {
+      "type": "object",
+      "properties": {
+        "source": {
+          "$ref": "#/$defs/SourceRef"
+        },
+        "force": {
+          "type": "boolean"
+        },
+        "policy": {
+          "$ref": "#/$defs/SubmissionPolicy"
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "source"
+      ]
+    },
+    "ArtifactRef": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "artifactId": {
+              "$ref": "#/$defs/ArtifactId"
+            }
+          },
+          "required": [
+            "artifactId"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^\\/"
+            }
+          },
+          "required": [
+            "path"
+          ]
+        }
+      ],
+      "description": "Names an artifact by its ID or by an absolute source path bound to it."
+    },
+    "ArtifactSummary": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "title": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "family": {
+          "type": "string"
+        },
+        "links": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ArtifactLink"
+          }
+        },
+        "mode": {
+          "type": "string",
+          "const": "spa"
+        },
+        "policy": {
+          "$ref": "#/$defs/SubmissionPolicy"
+        },
+        "source": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "latestVersion": {
+          "$ref": "#/$defs/VersionSummary"
+        }
+      },
+      "required": [
+        "id",
+        "title",
+        "links",
+        "mode",
+        "createdAt"
+      ],
+      "description": "One artifact: metadata from its latest version, its source and latest version."
+    },
+    "ArtifactVerifyParams": {
+      "type": "object",
+      "properties": {
+        "source": {
+          "$ref": "#/$defs/SourceRef"
+        },
+        "screenshots": {
+          "$ref": "#/$defs/ScreenshotPolicy"
+        },
+        "progressToken": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        }
+      },
+      "required": [
+        "source"
+      ]
+    },
+    "Batches": {
+      "readOnly": true,
+      "description": "A serialized server-function value: its batches of frames, in order.",
+      "type": "array",
+      "items": {
+        "readOnly": true,
+        "type": "array",
+        "items": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      }
+    },
+    "BundleAsset": {
+      "type": "object",
+      "properties": {
+        "file": {
+          "type": "string",
+          "pattern": "^mostra-[0-9A-Za-z][0-9A-Za-z.+-]*-(darwin|linux)-(arm64|x64)\\.tar\\.gz$"
+        },
+        "sha256": {
+          "$ref": "#/$defs/Sha256"
+        },
+        "size": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "unpackedSize": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "file",
+        "sha256",
+        "size",
+        "unpackedSize"
+      ]
+    },
+    "BundleBrowser": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "const": "chromium-headless-shell"
+        },
+        "revision": {
+          "type": "string",
+          "minLength": 1
+        },
+        "browserVersion": {
+          "type": "string",
+          "minLength": 1
+        },
+        "installer": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^/\\0]"
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/BundleFileEntry"
+          }
+        }
+      },
+      "required": [
+        "name",
+        "revision",
+        "browserVersion",
+        "installer",
+        "files"
+      ]
+    },
+    "BundleFileEntry": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^/\\0]"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "sha256": {
+          "$ref": "#/$defs/Sha256"
+        },
+        "executable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "path",
+        "size",
+        "sha256",
+        "executable"
+      ]
+    },
+    "BundleFiles": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 1
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/BundleFileEntry"
+          }
+        },
+        "links": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/BundleLinkEntry"
+          }
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "files",
+        "links"
+      ]
+    },
+    "BundleInfo": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 1
+        },
+        "name": {
+          "type": "string",
+          "const": "mostra-runtime-bundle"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "platform": {
+          "$ref": "#/$defs/BundlePlatform"
+        },
+        "node": {
+          "type": "object",
+          "properties": {
+            "version": {
+              "type": "string",
+              "minLength": 1
+            },
+            "path": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^[^/\\0]"
+            }
+          },
+          "required": [
+            "version",
+            "path"
+          ]
+        },
+        "entries": {
+          "type": "object",
+          "properties": {
+            "runtime": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^[^/\\0]"
+            },
+            "cli": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^[^/\\0]"
+            },
+            "setup": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^[^/\\0]"
+            }
+          },
+          "required": [
+            "runtime",
+            "cli",
+            "setup"
+          ]
+        },
+        "files": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^[^/\\0]"
+            },
+            "sha256": {
+              "$ref": "#/$defs/Sha256"
+            }
+          },
+          "required": [
+            "path",
+            "sha256"
+          ]
+        },
+        "browser": {
+          "$ref": "#/$defs/BundleBrowser"
+        },
+        "source": {
+          "type": "object",
+          "properties": {
+            "repository": {
+              "type": "string"
+            },
+            "commit": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "repository",
+            "commit"
+          ]
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "name",
+        "version",
+        "platform",
+        "node",
+        "entries",
+        "files",
+        "browser"
+      ]
+    },
+    "BundleLinkEntry": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^/\\0]"
+        },
+        "target": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "path",
+        "target"
+      ]
+    },
+    "BundlePins": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 1
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9A-Za-z][0-9A-Za-z.+-]*$"
+        },
+        "release": {
+          "type": "string",
+          "format": "uri"
+        },
+        "assets": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/BundlePlatform"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/BundleAsset"
+          }
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "version",
+        "release",
+        "assets"
+      ]
+    },
+    "BundlePlatform": {
+      "type": "string",
+      "enum": [
+        "darwin-arm64",
+        "darwin-x64",
+        "linux-x64",
+        "linux-arm64"
+      ]
+    },
+    "BundleSetup": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "platform": {
+          "$ref": "#/$defs/BundlePlatform"
+        },
+        "files": {
+          "$ref": "#/$defs/Sha256"
+        },
+        "browser": {
+          "type": "object",
+          "properties": {
+            "revision": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "revision"
+          ]
+        },
+        "at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "version",
+        "platform",
+        "files",
+        "browser",
+        "at"
+      ]
+    },
+    "CallRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "args": {
+          "$ref": "#/$defs/Batches"
+        }
+      },
+      "required": [
+        "viewId",
+        "args"
+      ],
+      "description": "A plain server-function call: the view and the serialized arguments."
+    },
+    "CapabilityLink": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "tokenId": {
+          "$ref": "#/$defs/TokenId"
+        },
+        "scopes": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/CapabilityScope"
+          }
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "viewer": {
+          "$ref": "#/$defs/Viewer"
+        }
+      },
+      "required": [
+        "url",
+        "tokenId",
+        "scopes"
+      ],
+      "description": "A capability URL with its token ID, scopes and expiry."
+    },
+    "CapabilityScope": {
+      "type": "string",
+      "pattern": "^(view|draft|submit|review|signal|action:(\\*|[^\\s#*]+(#[^\\s#*]+)?))$",
+      "description": "A capability token's scope: view, draft, submit, review, signal, action:*, action:<export> or action:<module path>#<export>."
+    },
+    "CarryOver": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "$ref": "#/$defs/VersionRef"
+        },
+        "orphans": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/OrphanedField"
+          }
+        }
+      },
+      "required": [
+        "version",
+        "orphans"
+      ],
+      "description": "The viewer's answers a version doesn't carry over."
+    },
+    "ChildProcessStatus": {
+      "type": "object",
+      "properties": {
+        "pid": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "kind": {
+          "type": "string"
+        },
+        "ownerRef": {
+          "type": "string"
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        }
+      },
+      "required": [
+        "pid",
+        "kind",
+        "ownerRef",
+        "startedAt"
+      ],
+      "description": "One child process the instance supervises."
+    },
+    "ChooseRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "mutationId": {
+          "$ref": "#/$defs/MutationId"
+        },
+        "baseRevision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "reviewSetId": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_-]{1,64}$"
+        },
+        "candidateId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "label": {
+          "type": "string",
+          "maxLength": 256
+        }
+      },
+      "required": [
+        "viewId",
+        "mutationId",
+        "baseRevision",
+        "reviewSetId",
+        "candidateId"
+      ],
+      "description": "The shell's trusted Choose: the view, mutation, base revision, set and candidate."
+    },
+    "ClientCapabilities": {
+      "type": "object",
+      "properties": {
+        "notifications": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "description": "What the client can handle: the notification methods it accepts."
+    },
+    "ClientInfo": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "version"
+      ],
+      "description": "The client that opens a connection."
+    },
+    "CommentId": {
+      "type": "string",
+      "pattern": "^cmt_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Comment ID: \"cmt_\" followed by a 26-character ULID."
+    },
+    "ControlsPolicy": {
+      "type": "object",
+      "properties": {
+        "submitChannels": {
+          "readOnly": true,
+          "minItems": 1,
+          "maxItems": 2,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/SubmitChannel"
+          }
+        },
+        "controls": {
+          "readOnly": true,
+          "maxItems": 32,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TrustedControl"
+          }
+        }
+      },
+      "required": [
+        "submitChannels"
+      ],
+      "description": "Which submit channels a view accepts and which trusted controls its shell renders (D108)."
+    },
+    "Cursor": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]{0,18})$",
+      "description": "Event cursor: the decimal string of a home-wide event position."
+    },
+    "DeliveryCounts": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string"
+        },
+        "connected": {
+          "type": "boolean"
+        },
+        "pending": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "delivered": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "rejected": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "undeliverable": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "owner",
+        "connected",
+        "pending",
+        "delivered",
+        "rejected",
+        "undeliverable"
+      ],
+      "description": "One host's deliveries by state, and whether it is connected."
+    },
+    "DeliveryId": {
+      "type": "string",
+      "pattern": "^dlv_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Delivery ID: \"dlv_\" followed by a 26-character ULID."
+    },
+    "DeliveryStatus": {
+      "type": "object",
+      "properties": {
+        "deliveryId": {
+          "$ref": "#/$defs/DeliveryId"
+        },
+        "owner": {
+          "type": "string"
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "delivered",
+            "rejected",
+            "undeliverable"
+          ]
+        },
+        "attempts": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "reason": {
+          "type": "string"
+        },
+        "waiting": {
+          "type": "boolean",
+          "const": true
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        }
+      },
+      "required": [
+        "deliveryId",
+        "owner",
+        "state",
+        "attempts",
+        "updatedAt"
+      ],
+      "description": "One submission's delivery to one host: owner, state, attempts and reason."
+    },
+    "DependencyPolicy": {
+      "type": "string",
+      "enum": [
+        "auto",
+        "explicit"
+      ],
+      "description": "How packages enter an artifact's lockfile: auto installs what artifacts import; explicit only what deps/add adds (D43)."
+    },
+    "DepsAddParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/SourceRef"
+        },
+        "packages": {
+          "readOnly": true,
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "artifact",
+        "packages"
+      ]
+    },
+    "DepsAddResult": {
+      "type": "object",
+      "properties": {
+        "packages": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/AddedPackage"
+          }
+        },
+        "lockDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        }
+      },
+      "required": [
+        "packages",
+        "lockDigest"
+      ]
+    },
+    "DevNotifyParams": {
+      "type": "object",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "built",
+            "reloaded",
+            "server-restarted",
+            "submission",
+            "diagnostics"
+          ]
+        },
+        "at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "diagnostics": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Diagnostic"
+          }
+        },
+        "files": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "results": {}
+      },
+      "required": [
+        "sessionId",
+        "kind",
+        "at"
+      ],
+      "description": "One event of a dev session."
+    },
+    "DevStartParams": {
+      "type": "object",
+      "properties": {
+        "source": {
+          "$ref": "#/$defs/SourceRef"
+        },
+        "port": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 65535
+        }
+      },
+      "required": [
+        "source"
+      ]
+    },
+    "DevStartResult": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "port": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 65535
+        },
+        "sessionId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "url",
+        "port",
+        "sessionId"
+      ],
+      "description": "A running dev session."
+    },
+    "DevStopParams": {
+      "type": "object",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "sessionId"
+      ]
+    },
+    "DevStopResult": {
+      "type": "object",
+      "properties": {}
+    },
+    "Diagnostic": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "$ref": "#/$defs/DiagnosticCode"
+        },
+        "severity": {
+          "$ref": "#/$defs/DiagnosticSeverity"
+        },
+        "message": {
+          "type": "string"
+        },
+        "hint": {
+          "type": "string"
+        },
+        "fix": {
+          "$ref": "#/$defs/DiagnosticFix"
+        },
+        "location": {
+          "$ref": "#/$defs/DiagnosticLocation"
+        },
+        "phase": {
+          "$ref": "#/$defs/DiagnosticPhase"
+        },
+        "docs": {
+          "type": "string",
+          "format": "uri"
+        },
+        "count": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "code",
+        "severity",
+        "message",
+        "phase",
+        "docs"
+      ],
+      "description": "One diagnostic: a stable code, severity, message, hint, fix and docs link."
+    },
+    "DiagnosticCode": {
+      "type": "string",
+      "pattern": "^MOSTRA_[A-Z0-9]+_[A-Z0-9_]+$",
+      "description": "Stable diagnostic code: MOSTRA_<AREA>_<NAME>."
+    },
+    "DiagnosticFix": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "replace",
+            "insert",
+            "delete",
+            "command"
+          ]
+        },
+        "file": {
+          "type": "string"
+        },
+        "range": {
+          "readOnly": true,
+          "type": "array",
+          "prefixItems": [
+            {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            }
+          ],
+          "items": false,
+          "minItems": 4,
+          "maxItems": 4
+        },
+        "text": {
+          "type": "string"
+        },
+        "command": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind"
+      ],
+      "description": "A machine-applicable fix; range is [startLine, startColumn, endLine, endColumn], 1-based, end exclusive."
+    },
+    "DiagnosticLocation": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "file": {
+              "type": "string"
+            },
+            "line": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "column": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "file",
+            "line",
+            "column"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "viewport": {
+              "type": "string"
+            },
+            "selector": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "viewport"
+          ]
+        }
+      ],
+      "description": "A 1-based source position, or a place in a rendered viewport."
+    },
+    "DiagnosticPhase": {
+      "type": "string",
+      "enum": [
+        "manifest",
+        "compile",
+        "lint",
+        "runtime",
+        "console",
+        "network",
+        "a11y",
+        "visual",
+        "smoke",
+        "regression",
+        "contract",
+        "publish",
+        "host",
+        "hygiene",
+        "platform"
+      ],
+      "description": "The stage of work that produced the diagnostic."
+    },
+    "DiagnosticSeverity": {
+      "type": "string",
+      "enum": [
+        "error",
+        "warning",
+        "hint"
+      ],
+      "description": "How bad it is: error only for definite failures."
+    },
+    "DocumentRevision": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]{0,15})$",
+      "description": "A draft's or artifact state's revision: a non-negative decimal integer string."
+    },
+    "DocumentSnapshot": {
+      "type": "object",
+      "properties": {
+        "revision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "epoch": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "fields": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/FieldState"
+          }
+        }
+      },
+      "required": [
+        "revision",
+        "epoch",
+        "fields"
+      ],
+      "description": "A document's revision, epoch and fields, as a page loads it."
+    },
+    "DraftMirror": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "draft"
+        },
+        "artifactId": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "viewerId": {
+          "$ref": "#/$defs/ViewerId"
+        },
+        "epoch": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "revision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "fields": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "kind",
+        "artifactId",
+        "viewerId",
+        "epoch",
+        "revision",
+        "fields"
+      ],
+      "description": "A viewer's draft mirrored to a host: always kind draft, never a submission."
+    },
+    "Duration": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]{0,8}[smhd]$",
+      "description": "A duration: a positive whole number and s, m, h or d, such as 30m, 24h or 7d."
+    },
+    "EventFilter": {
+      "type": "object",
+      "properties": {
+        "artifacts": {
+          "readOnly": true,
+          "maxItems": 1000,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ArtifactId"
+          }
+        },
+        "types": {
+          "readOnly": true,
+          "maxItems": 100,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/EventTypePattern"
+          }
+        }
+      },
+      "description": "Which events a reader wants: these artifacts' and these types (patterns allowed)."
+    },
+    "EventRecord": {
+      "type": "object",
+      "properties": {
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "artifactId": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ArtifactId"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "seq": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "type": {
+          "type": "string"
+        },
+        "at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "actor": {
+          "$ref": "#/$defs/Actor"
+        },
+        "causation": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "payload": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "cursor",
+        "artifactId",
+        "seq",
+        "type",
+        "at",
+        "actor",
+        "payload"
+      ],
+      "description": "One durable event: cursor, artifact, per-artifact sequence, type, time, actor, payload."
+    },
+    "EventTypePattern": {
+      "type": "string",
+      "pattern": "^[a-z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*(\\.\\*)?$",
+      "description": "An event type (submission.created) or a family of them (submission.*)."
+    },
+    "EventsAckParams": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "subscriptionId",
+        "cursor"
+      ]
+    },
+    "EventsAckResult": {
+      "type": "object",
+      "properties": {}
+    },
+    "EventsNotifyParams": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "events": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/EventRecord"
+          }
+        },
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "compacted": {
+          "$ref": "#/$defs/Diagnostic"
+        }
+      },
+      "required": [
+        "subscriptionId",
+        "events",
+        "cursor"
+      ],
+      "description": "A subscription's next events, in cursor order, and the cursor examined up to."
+    },
+    "EventsReadParams": {
+      "type": "object",
+      "properties": {
+        "filter": {
+          "$ref": "#/$defs/EventFilter"
+        },
+        "after": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000
+        },
+        "acceptCompacted": {
+          "type": "boolean"
+        }
+      }
+    },
+    "EventsReadResult": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/EventRecord"
+          }
+        },
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "compacted": {
+          "$ref": "#/$defs/Diagnostic"
+        }
+      },
+      "required": [
+        "events",
+        "cursor"
+      ]
+    },
+    "EventsSubscribeParams": {
+      "type": "object",
+      "properties": {
+        "filter": {
+          "$ref": "#/$defs/EventFilter"
+        },
+        "after": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]{0,127}$"
+        }
+      }
+    },
+    "EventsSubscribeResult": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        }
+      },
+      "required": [
+        "subscriptionId",
+        "cursor"
+      ]
+    },
+    "EventsUnsubscribeParams": {
+      "type": "object",
+      "properties": {
+        "subscriptionId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "subscriptionId"
+      ]
+    },
+    "EventsUnsubscribeResult": {
+      "type": "object",
+      "properties": {}
+    },
+    "FieldConflict": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "revision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "value": {},
+        "deleted": {
+          "type": "boolean",
+          "const": true
+        },
+        "updatedBy": {
+          "$ref": "#/$defs/Actor"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        }
+      },
+      "required": [
+        "id",
+        "revision"
+      ],
+      "description": "A field op not applied because the field changed after the base revision."
+    },
+    "FieldOp": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "value": {},
+        "delete": {
+          "type": "boolean",
+          "const": true
+        },
+        "label": {
+          "type": "string",
+          "maxLength": 1024
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "sensitive": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "description": "One change to one field: a value or a delete, with optional label, required and sensitive."
+    },
+    "FieldState": {
+      "type": "object",
+      "properties": {
+        "value": {},
+        "revision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "updatedBy": {
+          "$ref": "#/$defs/Actor"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "label": {
+          "type": "string"
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "sensitive": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "value",
+        "revision",
+        "updatedAt"
+      ],
+      "description": "A field's current value, the revision that wrote it, who wrote it and when."
+    },
+    "FieldsRequest": {
+      "type": "object",
+      "properties": {
+        "mutationId": {
+          "$ref": "#/$defs/MutationId"
+        },
+        "scope": {
+          "type": "string",
+          "enum": [
+            "viewer",
+            "artifact"
+          ]
+        },
+        "baseRevision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "ops": {
+          "readOnly": true,
+          "minItems": 1,
+          "maxItems": 1000,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/FieldOp"
+          }
+        }
+      },
+      "required": [
+        "mutationId",
+        "scope",
+        "baseRevision",
+        "viewId",
+        "ops"
+      ],
+      "description": "A browser mutation: its ID, scope, base revision, view and field ops."
+    },
+    "FollowRequest": {
+      "type": "object",
+      "properties": {
+        "follow": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "follow"
+      ],
+      "description": "Whether the viewer follows the artifact's new versions."
+    },
+    "FrameTicket": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "version": {
+          "$ref": "#/$defs/VersionRef"
+        },
+        "latest": {
+          "$ref": "#/$defs/VersionRef"
+        },
+        "policy": {
+          "$ref": "#/$defs/SubmissionPolicy"
+        },
+        "submitChannels": {
+          "readOnly": true,
+          "minItems": 1,
+          "maxItems": 2,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/SubmitChannel"
+          }
+        },
+        "controls": {
+          "readOnly": true,
+          "maxItems": 32,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TrustedControl"
+          }
+        },
+        "target": {
+          "type": "string",
+          "enum": [
+            "live",
+            "static",
+            "mcp-app",
+            "verify"
+          ]
+        },
+        "src": {
+          "type": "string",
+          "minLength": 1
+        },
+        "artifactOrigin": {
+          "type": "string",
+          "minLength": 1
+        },
+        "follow": {
+          "type": "boolean"
+        },
+        "pinned": {
+          "type": "boolean"
+        },
+        "serverParked": {
+          "type": "boolean",
+          "const": true
+        },
+        "devPreview": {
+          "type": "boolean",
+          "const": true
+        }
+      },
+      "required": [
+        "artifactId",
+        "viewId",
+        "version",
+        "latest",
+        "policy",
+        "submitChannels",
+        "controls",
+        "target",
+        "src",
+        "artifactOrigin",
+        "follow",
+        "pinned"
+      ],
+      "description": "A frame ticket: the view it opens, where to load it, and the view's controls."
+    },
+    "GatewayStatus": {
+      "type": "object",
+      "properties": {
+        "bind": {
+          "type": "string"
+        },
+        "shell": {
+          "type": "string"
+        },
+        "artifacts": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "artifactId": {
+                "type": "string"
+              },
+              "origin": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "artifactId",
+              "origin"
+            ]
+          }
+        }
+      },
+      "required": [
+        "bind",
+        "shell",
+        "artifacts"
+      ],
+      "description": "Where the gateway listens."
+    },
+    "GcRunParams": {
+      "type": "object",
+      "properties": {
+        "dryRun": {
+          "type": "boolean"
+        },
+        "compactEvents": {
+          "type": "object",
+          "properties": {
+            "before": {
+              "type": "string",
+              "pattern": "^[0-9]+$"
+            }
+          },
+          "required": [
+            "before"
+          ]
+        }
+      }
+    },
+    "GcRunResult": {
+      "type": "object",
+      "properties": {
+        "dryRun": {
+          "type": "boolean"
+        },
+        "versions": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "artifactId": {
+                "$ref": "#/$defs/ArtifactId"
+              },
+              "versionId": {
+                "$ref": "#/$defs/VersionId"
+              },
+              "number": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              }
+            },
+            "required": [
+              "artifactId",
+              "versionId",
+              "number",
+              "bytes"
+            ]
+          }
+        },
+        "snapshots": {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "bytes": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "count",
+            "bytes"
+          ]
+        },
+        "lockLayouts": {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "bytes": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "count",
+            "bytes"
+          ]
+        },
+        "storePackages": {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "bytes": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "count",
+            "bytes"
+          ]
+        },
+        "caches": {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "bytes": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "count",
+            "bytes"
+          ]
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "compacted": {
+          "type": "object",
+          "properties": {
+            "artifacts": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "artifactId": {
+                    "$ref": "#/$defs/ArtifactId"
+                  },
+                  "removed": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  }
+                },
+                "required": [
+                  "artifactId",
+                  "removed"
+                ]
+              }
+            },
+            "removed": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "artifacts",
+            "removed"
+          ]
+        },
+        "warnings": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Diagnostic"
+          }
+        }
+      },
+      "required": [
+        "dryRun",
+        "versions",
+        "snapshots",
+        "lockLayouts",
+        "storePackages",
+        "caches",
+        "bytes"
+      ],
+      "description": "What gc reclaimed."
+    },
+    "HomeConfig": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "dependencies": {
+          "$ref": "#/$defs/DependencyPolicy"
+        },
+        "submission": {
+          "$ref": "#/$defs/SubmissionPolicy"
+        },
+        "ports": {
+          "readOnly": true,
+          "maxItems": 32,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/PortName"
+          }
+        },
+        "submitChannels": {
+          "readOnly": true,
+          "minItems": 1,
+          "maxItems": 2,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/SubmitChannel"
+          }
+        }
+      },
+      "description": "Home settings from a spawning host; path is a check against the instance's home (D84), dependencies the dependency policy (D43), submission the home's policy (D102), ports those the host always provides (D105)."
+    },
+    "InstanceCapabilities": {
+      "type": "object",
+      "properties": {
+        "methods": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "notifications": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "ports": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/PortName"
+          }
+        }
+      },
+      "required": [
+        "methods",
+        "notifications",
+        "ports"
+      ],
+      "description": "What the instance offers: methods, notifications and supported ports."
+    },
+    "InstanceCheckParams": {
+      "type": "object",
+      "properties": {
+        "deep": {
+          "type": "boolean"
+        }
+      }
+    },
+    "InstanceCheckResult": {
+      "type": "object",
+      "properties": {
+        "checks": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "ok",
+                  "warning",
+                  "error"
+                ]
+              },
+              "diagnostic": {
+                "$ref": "#/$defs/Diagnostic"
+              }
+            },
+            "required": [
+              "name",
+              "status"
+            ]
+          }
+        }
+      },
+      "required": [
+        "checks"
+      ],
+      "description": "The supervisor's own checks of its home."
+    },
+    "InstanceInfo": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "string"
+        },
+        "home": {
+          "type": "string"
+        },
+        "platform": {
+          "type": "string"
+        },
+        "pid": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "host",
+            "daemon"
+          ]
+        }
+      },
+      "required": [
+        "version",
+        "home",
+        "platform",
+        "pid",
+        "mode"
+      ],
+      "description": "The instance a client is connected to."
+    },
+    "InstanceStatusParams": {
+      "type": "object",
+      "properties": {}
+    },
+    "InstanceStatusResult": {
+      "type": "object",
+      "properties": {
+        "instance": {
+          "$ref": "#/$defs/InstanceInfo"
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "socket": {
+          "type": "string"
+        },
+        "connections": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "processes": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ChildProcessStatus"
+          }
+        },
+        "gateway": {
+          "$ref": "#/$defs/GatewayStatus"
+        },
+        "deliveries": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/DeliveryCounts"
+          }
+        },
+        "workers": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/WorkerStatus"
+          }
+        },
+        "idleExitAt": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "instance",
+        "startedAt",
+        "socket",
+        "connections",
+        "processes"
+      ]
+    },
+    "JsonRpcErrorObject": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "message": {
+          "type": "string"
+        },
+        "data": {}
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "description": "The error of a failed JSON-RPC 2.0 response; Mostra puts the diagnostic in data."
+    },
+    "JsonRpcFailure": {
+      "type": "object",
+      "properties": {
+        "jsonrpc": {
+          "type": "string",
+          "const": "2.0"
+        },
+        "id": {
+          "type": [
+            "string",
+            "number",
+            "null"
+          ]
+        },
+        "error": {
+          "$ref": "#/$defs/JsonRpcErrorObject"
+        }
+      },
+      "required": [
+        "jsonrpc",
+        "id",
+        "error"
+      ],
+      "description": "A failed JSON-RPC 2.0 response; id is null when the request's id was unreadable."
+    },
+    "JsonRpcNotification": {
+      "type": "object",
+      "properties": {
+        "jsonrpc": {
+          "type": "string",
+          "const": "2.0"
+        },
+        "method": {
+          "type": "string"
+        },
+        "params": {
+          "anyOf": [
+            {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            },
+            {
+              "readOnly": true,
+              "type": "array",
+              "items": {}
+            }
+          ]
+        }
+      },
+      "required": [
+        "jsonrpc",
+        "method"
+      ],
+      "description": "A JSON-RPC 2.0 notification: a request without an id, never answered."
+    },
+    "JsonRpcRequest": {
+      "type": "object",
+      "properties": {
+        "jsonrpc": {
+          "type": "string",
+          "const": "2.0"
+        },
+        "id": {
+          "type": [
+            "string",
+            "number"
+          ]
+        },
+        "method": {
+          "type": "string"
+        },
+        "params": {
+          "anyOf": [
+            {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            },
+            {
+              "readOnly": true,
+              "type": "array",
+              "items": {}
+            }
+          ]
+        }
+      },
+      "required": [
+        "jsonrpc",
+        "id",
+        "method"
+      ],
+      "description": "A JSON-RPC 2.0 request: answered by a response with the same id."
+    },
+    "JsonRpcSuccess": {
+      "type": "object",
+      "properties": {
+        "jsonrpc": {
+          "type": "string",
+          "const": "2.0"
+        },
+        "id": {
+          "type": [
+            "string",
+            "number"
+          ]
+        },
+        "result": {}
+      },
+      "required": [
+        "jsonrpc",
+        "id",
+        "result"
+      ],
+      "description": "A successful JSON-RPC 2.0 response."
+    },
+    "LivePushParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        },
+        "key": {
+          "type": "string",
+          "pattern": "^[A-Za-z_$][A-Za-z0-9_$]{0,127}$"
+        },
+        "value": {},
+        "mode": {
+          "type": "string",
+          "enum": [
+            "replace",
+            "append"
+          ]
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "artifact",
+        "key",
+        "value"
+      ],
+      "description": "A value pushed into an artifact's live source."
+    },
+    "LivePushResult": {
+      "type": "object",
+      "properties": {
+        "revision": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "revision"
+      ],
+      "description": "The pushed value's revision."
+    },
+    "LiveRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "keys": {
+          "readOnly": true,
+          "maxItems": 256,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[A-Za-z_$][A-Za-z0-9_$]{0,127}$"
+              },
+              "window": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 100000
+              },
+              "refresh": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "key"
+            ]
+          }
+        }
+      },
+      "required": [
+        "viewId",
+        "keys"
+      ],
+      "description": "Live sources a page reads and keeps running: keys and append windows."
+    },
+    "MostraInitializeParams": {
+      "type": "object",
+      "properties": {
+        "client": {
+          "$ref": "#/$defs/ClientInfo"
+        },
+        "revisions": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "capabilities": {
+          "$ref": "#/$defs/ClientCapabilities"
+        },
+        "ports": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/PortName"
+          }
+        },
+        "home": {
+          "$ref": "#/$defs/HomeConfig"
+        }
+      },
+      "required": [
+        "client",
+        "revisions",
+        "capabilities",
+        "ports"
+      ]
+    },
+    "MostraInitializeResult": {
+      "type": "object",
+      "properties": {
+        "revision": {
+          "$ref": "#/$defs/Revision"
+        },
+        "instance": {
+          "$ref": "#/$defs/InstanceInfo"
+        },
+        "capabilities": {
+          "$ref": "#/$defs/InstanceCapabilities"
+        },
+        "warnings": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Diagnostic"
+          }
+        }
+      },
+      "required": [
+        "revision",
+        "instance",
+        "capabilities",
+        "warnings"
+      ]
+    },
+    "MostraShutdownParams": {
+      "type": "object",
+      "properties": {}
+    },
+    "MostraShutdownResult": {
+      "type": "object",
+      "properties": {}
+    },
+    "MutationId": {
+      "type": "string",
+      "pattern": "^mut_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Mutation ID: \"mut_\" followed by a 26-character ULID."
+    },
+    "MutationResult": {
+      "type": "object",
+      "properties": {
+        "revision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "applied": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "conflicts": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/FieldConflict"
+          }
+        }
+      },
+      "required": [
+        "revision",
+        "applied",
+        "conflicts"
+      ],
+      "description": "A mutation's outcome: the revision after it, the applied field IDs, the conflicts."
+    },
+    "OrphanedField": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "value": {},
+        "fromVersion": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "id",
+        "value",
+        "fromVersion"
+      ],
+      "description": "A draft field a version doesn't cover: its ID, label, value and source version."
+    },
+    "PollResult": {
+      "type": "object",
+      "properties": {
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "events": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/EventRecord"
+          }
+        },
+        "snapshot": {
+          "$ref": "#/$defs/StreamSnapshot"
+        },
+        "ephemeral": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          }
+        }
+      },
+      "required": [
+        "cursor",
+        "events"
+      ],
+      "description": "A long-poll answer: the cursor, the events after the asked one, and a snapshot."
+    },
+    "PortName": {
+      "type": "string",
+      "pattern": "^[a-z][a-zA-Z0-9]*$",
+      "description": "A host port name: identity, submissions, drafts, reviews, addressing, trustedControls, capture, secrets, pty, or ai (reserved). Open for later ports."
+    },
+    "PortSecretsGetParams": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "artifactId",
+        "name"
+      ],
+      "description": "The artifact and the name of the secret its server code asks for."
+    },
+    "PortSecretsGetResult": {
+      "description": "The secret's value, or null when the host has none.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "PortSubmissionsDeliverResult": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "accepted": {
+              "type": "boolean",
+              "const": true
+            }
+          },
+          "required": [
+            "accepted"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "accepted": {
+              "type": "boolean",
+              "const": false
+            },
+            "reason": {
+              "type": "string",
+              "minLength": 1
+            },
+            "retry": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "accepted",
+            "reason",
+            "retry"
+          ]
+        }
+      ]
+    },
+    "PortTrustedControlsActivatedParams": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "control": {
+          "$ref": "#/$defs/TrustedControl"
+        },
+        "viewer": {
+          "$ref": "#/$defs/Viewer"
+        },
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "detail": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "artifactId",
+        "control",
+        "viewer",
+        "viewId"
+      ],
+      "description": "A trusted control a person used: the artifact, control, viewer, view and detail."
+    },
+    "PortTrustedControlsPolicyParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactSummary"
+        }
+      },
+      "required": [
+        "artifact"
+      ],
+      "description": "The artifact a frame is about to show, for its host's controls policy."
+    },
+    "PublishReceipt": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "versionId": {
+          "$ref": "#/$defs/VersionId"
+        },
+        "version": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "url": {
+          "type": "string"
+        },
+        "tokenId": {
+          "$ref": "#/$defs/TokenId"
+        },
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "reused": {
+          "type": "boolean"
+        },
+        "forcedDiagnostics": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "artifactId",
+        "versionId",
+        "version",
+        "cursor",
+        "reused"
+      ],
+      "description": "The receipt of artifact/publish: artifact, version, number, capability URL when served, event cursor, reuse."
+    },
+    "ResultComment": {
+      "type": "object",
+      "properties": {
+        "threadId": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "open",
+            "resolved"
+          ]
+        },
+        "messages": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "author": {
+                "$ref": "#/$defs/Viewer"
+              },
+              "at": {
+                "type": "string",
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+              },
+              "text": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "author",
+              "at",
+              "text"
+            ]
+          }
+        },
+        "anchor": {
+          "type": "object",
+          "properties": {
+            "reviewId": {
+              "type": "string"
+            },
+            "selectors": {
+              "readOnly": true,
+              "type": "array",
+              "items": {}
+            },
+            "rect": {
+              "type": "object",
+              "properties": {
+                "x": {
+                  "type": "number"
+                },
+                "y": {
+                  "type": "number"
+                },
+                "width": {
+                  "type": "number"
+                },
+                "height": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "x",
+                "y",
+                "width",
+                "height"
+              ]
+            },
+            "viewport": {
+              "type": "object",
+              "properties": {
+                "width": {
+                  "type": "number"
+                },
+                "height": {
+                  "type": "number"
+                },
+                "dpr": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "width",
+                "height",
+                "dpr"
+              ]
+            },
+            "page": {
+              "type": "string"
+            },
+            "candidateId": {
+              "type": "string"
+            },
+            "terminal": {
+              "type": "object",
+              "properties": {
+                "rows": {
+                  "readOnly": true,
+                  "type": "array",
+                  "prefixItems": [
+                    {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    },
+                    {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    }
+                  ],
+                  "items": false,
+                  "minItems": 2,
+                  "maxItems": 2
+                },
+                "cols": {
+                  "readOnly": true,
+                  "type": "array",
+                  "prefixItems": [
+                    {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    },
+                    {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    }
+                  ],
+                  "items": false,
+                  "minItems": 2,
+                  "maxItems": 2
+                },
+                "t": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "rows",
+                "cols"
+              ]
+            },
+            "time": {
+              "type": "number"
+            },
+            "slide": {
+              "type": "object",
+              "properties": {
+                "index": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                },
+                "step": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "index",
+                "step"
+              ]
+            }
+          }
+        },
+        "crop": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string"
+            },
+            "width": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "height": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "path",
+            "width",
+            "height"
+          ]
+        }
+      },
+      "required": [
+        "threadId",
+        "status",
+        "messages",
+        "anchor",
+        "crop"
+      ],
+      "description": "One comment thread in results: messages, anchor layers and the screenshot crop."
+    },
+    "Results": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "$ref": "#/$defs/ArtifactId"
+            },
+            "title": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            },
+            "family": {
+              "type": "string"
+            },
+            "links": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/ArtifactLink"
+              }
+            }
+          },
+          "required": [
+            "id",
+            "title",
+            "links"
+          ]
+        },
+        "submission": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "$ref": "#/$defs/SubmissionId"
+            },
+            "at": {
+              "type": "string",
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+            },
+            "epoch": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "previous": {
+              "$ref": "#/$defs/SubmissionId"
+            },
+            "policy": {
+              "$ref": "#/$defs/SubmissionPolicy"
+            },
+            "channel": {
+              "type": "string",
+              "enum": [
+                "shell",
+                "artifact"
+              ]
+            },
+            "viewer": {
+              "$ref": "#/$defs/Viewer"
+            },
+            "versionId": {
+              "$ref": "#/$defs/VersionId"
+            },
+            "version": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "viewId": {
+              "$ref": "#/$defs/ViewId"
+            },
+            "staleView": {
+              "type": "boolean"
+            },
+            "latestVersion": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "draftRevision": {
+              "$ref": "#/$defs/DocumentRevision"
+            },
+            "stateRevision": {
+              "$ref": "#/$defs/DocumentRevision"
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            },
+            "delivery": {
+              "type": "string",
+              "enum": [
+                "pending",
+                "delivered",
+                "rejected",
+                "undeliverable"
+              ]
+            },
+            "deliveries": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/DeliveryStatus"
+              }
+            }
+          },
+          "required": [
+            "id",
+            "at",
+            "epoch",
+            "policy",
+            "channel",
+            "viewer",
+            "versionId",
+            "version",
+            "viewId",
+            "staleView",
+            "draftRevision",
+            "digest",
+            "delivery",
+            "deliveries"
+          ]
+        },
+        "answers": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "fields": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "required": {
+                "type": "boolean"
+              },
+              "sensitive": {
+                "type": "boolean"
+              },
+              "scope": {
+                "type": "string",
+                "enum": [
+                  "viewer",
+                  "artifact"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "scope"
+            ]
+          }
+        },
+        "state": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "choices": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "reviewSetId": {
+                "type": "string"
+              },
+              "candidateId": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "reviewSetId",
+              "candidateId"
+            ]
+          }
+        },
+        "comments": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ResultComment"
+          }
+        },
+        "orphaned": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "value": {},
+              "fromVersion": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              }
+            },
+            "required": [
+              "id",
+              "value",
+              "fromVersion"
+            ]
+          }
+        },
+        "actions": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "runId": {
+                "type": "string"
+              },
+              "action": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string"
+              },
+              "at": {
+                "type": "string",
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+              }
+            },
+            "required": [
+              "runId",
+              "action",
+              "status",
+              "at"
+            ]
+          }
+        },
+        "signals": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "at": {
+                "type": "string",
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+              },
+              "payload": {}
+            },
+            "required": [
+              "name",
+              "at"
+            ]
+          }
+        },
+        "signalsOmitted": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "signalsCompacted": {
+          "type": "boolean",
+          "const": true
+        }
+      },
+      "required": [
+        "artifact",
+        "submission",
+        "answers",
+        "fields",
+        "choices",
+        "comments",
+        "orphaned",
+        "actions",
+        "signals"
+      ],
+      "description": "The complete submission: artifact, submission facts, answers, fields, state, choices, comments, orphans, actions, signals."
+    },
+    "ResultsGetParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        },
+        "submission": {
+          "$ref": "#/$defs/SubmissionId"
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "json",
+            "md"
+          ]
+        }
+      },
+      "required": [
+        "artifact"
+      ]
+    },
+    "ResultsGetResult": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/Results"
+        },
+        {
+          "$ref": "#/$defs/ResultsMarkdown"
+        }
+      ]
+    },
+    "ResultsMarkdown": {
+      "type": "object",
+      "properties": {
+        "submissionId": {
+          "$ref": "#/$defs/SubmissionId"
+        },
+        "markdown": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "submissionId",
+        "markdown"
+      ],
+      "description": "A submission's results as Markdown for agents."
+    },
+    "Revision": {
+      "type": "string",
+      "format": "date",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+      "description": "Protocol revision: a calendar date in YYYY-MM-DD form."
+    },
+    "RunAttachRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "runIds": {
+          "readOnly": true,
+          "maxItems": 100,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 64
+          }
+        },
+        "keyed": {
+          "readOnly": true,
+          "maxItems": 100,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "fnId": {
+                "type": "string",
+                "minLength": 3,
+                "maxLength": 1024
+              },
+              "key": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              }
+            },
+            "required": [
+              "fnId",
+              "key"
+            ]
+          }
+        },
+        "held": {
+          "readOnly": true,
+          "maxItems": 100,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "runId": {
+                "type": "string",
+                "maxLength": 64
+              },
+              "log": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              },
+              "batches": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              }
+            },
+            "required": [
+              "runId",
+              "log",
+              "batches"
+            ]
+          }
+        }
+      },
+      "required": [
+        "viewId"
+      ],
+      "description": "Runs a page reads and follows: by ID, or by function and key."
+    },
+    "RunCancelRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        }
+      },
+      "required": [
+        "viewId"
+      ],
+      "description": "Cancel a run, from a view."
+    },
+    "RunId": {
+      "type": "string",
+      "pattern": "^run_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Action run ID: \"run_\" followed by a 26-character ULID."
+    },
+    "RunProgress": {
+      "type": "object",
+      "properties": {
+        "fraction": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "message": {
+          "type": "string",
+          "maxLength": 1000
+        }
+      },
+      "description": "A run's progress: fraction and message."
+    },
+    "RunRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "fnId": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 1024
+        },
+        "args": {
+          "$ref": "#/$defs/Batches"
+        },
+        "key": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "clientKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 64
+        }
+      },
+      "required": [
+        "viewId",
+        "fnId",
+        "args",
+        "clientKey"
+      ],
+      "description": "Start or join an action run: the function, its arguments and keys."
+    },
+    "RunState": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string"
+        },
+        "fnId": {
+          "type": "string"
+        },
+        "key": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "queued",
+            "running",
+            "waiting",
+            "succeeded",
+            "failed",
+            "cancelled"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "progress": {
+          "$ref": "#/$defs/RunProgress"
+        },
+        "log": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "batches": {
+          "$ref": "#/$defs/Batches"
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "message": {
+              "type": "string"
+            },
+            "code": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "message"
+          ]
+        },
+        "startedAt": {
+          "type": "string"
+        },
+        "finishedAt": {
+          "type": "string"
+        },
+        "joined": {
+          "type": "boolean"
+        },
+        "logFrom": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "batchFrom": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "runId",
+        "fnId",
+        "status",
+        "log",
+        "batches",
+        "startedAt"
+      ],
+      "description": "An action run: status, progress, log and the result written so far."
+    },
+    "ScreenshotPolicy": {
+      "type": "string",
+      "enum": [
+        "on-failure",
+        "always",
+        "never"
+      ],
+      "description": "When screenshots are returned: on failure (the default), always or never."
+    },
+    "SecretDeleteParams": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,127}$"
+        },
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "description": "The secret to delete."
+    },
+    "SecretDeleteResult": {
+      "type": "object",
+      "properties": {
+        "deleted": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "deleted"
+      ],
+      "description": "Whether a secret was deleted."
+    },
+    "SecretEntry": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "scope": {
+          "type": "string",
+          "enum": [
+            "artifact",
+            "home"
+          ]
+        },
+        "artifactId": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "scope",
+        "updatedAt"
+      ],
+      "description": "A secret's name, scope and when it was set; never its value."
+    },
+    "SecretListParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        }
+      },
+      "description": "The artifact whose secrets to list."
+    },
+    "SecretListResult": {
+      "type": "object",
+      "properties": {
+        "secrets": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/SecretEntry"
+          }
+        }
+      },
+      "required": [
+        "secrets"
+      ],
+      "description": "Secrets by name and scope."
+    },
+    "SecretSetParams": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,127}$"
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 65536
+        },
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        }
+      },
+      "required": [
+        "name",
+        "value"
+      ],
+      "description": "A secret's name, value and optional artifact scope."
+    },
+    "Sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$",
+      "description": "A SHA-256 digest in lowercase hex."
+    },
+    "ShellSubmitRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "expectedRevision": {
+          "$ref": "#/$defs/DocumentRevision"
+        }
+      },
+      "required": [
+        "viewId",
+        "expectedRevision"
+      ],
+      "description": "The shell's trusted Submit: the view and the draft revision the viewer saw."
+    },
+    "SignalRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "payload": {}
+      },
+      "required": [
+        "viewId",
+        "name"
+      ],
+      "description": "A browser signal: the view, the signal's name and an optional JSON payload."
+    },
+    "SourceRef": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^\\/"
+            }
+          },
+          "required": [
+            "path"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "artifactId": {
+              "$ref": "#/$defs/ArtifactId"
+            }
+          },
+          "required": [
+            "artifactId"
+          ]
+        }
+      ],
+      "description": "Where to build an artifact from: an absolute source path, or an artifact ID (its last published source path)."
+    },
+    "StateGetParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        },
+        "ids": {
+          "readOnly": true,
+          "maxItems": 10000,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          }
+        }
+      },
+      "required": [
+        "artifact"
+      ]
+    },
+    "StateGetResult": {
+      "type": "object",
+      "properties": {
+        "revision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "fields": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/FieldState"
+          }
+        }
+      },
+      "required": [
+        "revision",
+        "fields"
+      ]
+    },
+    "StatePatchParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        },
+        "ops": {
+          "readOnly": true,
+          "minItems": 1,
+          "maxItems": 1000,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/FieldOp"
+          }
+        },
+        "baseRevision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "mutationId": {
+          "$ref": "#/$defs/MutationId"
+        },
+        "as": {
+          "type": "string",
+          "enum": [
+            "agent",
+            "host"
+          ]
+        }
+      },
+      "required": [
+        "artifact",
+        "ops",
+        "mutationId"
+      ]
+    },
+    "StreamSnapshot": {
+      "type": "object",
+      "properties": {
+        "cursor": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "viewer": {
+          "$ref": "#/$defs/Viewer"
+        },
+        "draft": {
+          "$ref": "#/$defs/DocumentSnapshot"
+        },
+        "state": {
+          "$ref": "#/$defs/DocumentSnapshot"
+        },
+        "submission": {
+          "$ref": "#/$defs/SubmissionSummary"
+        },
+        "latest": {
+          "$ref": "#/$defs/VersionRef"
+        }
+      },
+      "required": [
+        "cursor",
+        "viewer",
+        "draft",
+        "state"
+      ],
+      "description": "Where a page stands: cursor, viewer, draft, artifact state and its submission."
+    },
+    "SubmissionEnvelope": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "submission"
+        },
+        "deliveryId": {
+          "$ref": "#/$defs/DeliveryId"
+        },
+        "submissionId": {
+          "$ref": "#/$defs/SubmissionId"
+        },
+        "artifactId": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "attempt": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "results": {
+          "$ref": "#/$defs/Results"
+        }
+      },
+      "required": [
+        "kind",
+        "deliveryId",
+        "submissionId",
+        "artifactId",
+        "attempt",
+        "results"
+      ],
+      "description": "One submission delivered to a host: delivery ID, attempt and the complete results."
+    },
+    "SubmissionId": {
+      "type": "string",
+      "pattern": "^sub_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Submission ID: \"sub_\" followed by a 26-character ULID."
+    },
+    "SubmissionPolicy": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "policy": {
+              "type": "string",
+              "const": "once"
+            },
+            "scope": {
+              "type": "string",
+              "enum": [
+                "per-artifact",
+                "per-viewer"
+              ]
+            }
+          },
+          "required": [
+            "policy"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "policy": {
+              "type": "string",
+              "const": "epochs"
+            }
+          },
+          "required": [
+            "policy"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "policy": {
+              "type": "string",
+              "const": "none"
+            }
+          },
+          "required": [
+            "policy"
+          ]
+        }
+      ],
+      "description": "A submission policy: once (per-artifact or per-viewer), epochs, or none."
+    },
+    "SubmissionSummary": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/SubmissionId"
+        },
+        "at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "epoch": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "channel": {
+          "type": "string",
+          "enum": [
+            "shell",
+            "artifact"
+          ]
+        },
+        "versionId": {
+          "$ref": "#/$defs/VersionId"
+        },
+        "version": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "staleView": {
+          "type": "boolean"
+        },
+        "draftRevision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "delivery": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "delivered",
+            "rejected",
+            "undeliverable"
+          ]
+        },
+        "deliveries": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/DeliveryStatus"
+          }
+        },
+        "duplicate": {
+          "type": "boolean",
+          "const": true
+        }
+      },
+      "required": [
+        "id",
+        "at",
+        "epoch",
+        "channel",
+        "versionId",
+        "version",
+        "viewId",
+        "staleView",
+        "draftRevision",
+        "digest",
+        "delivery"
+      ],
+      "description": "A submission as a submit answers it: ID, time, epoch, version, view, digest, delivery."
+    },
+    "SubmitChannel": {
+      "type": "string",
+      "enum": [
+        "shell",
+        "artifact"
+      ],
+      "description": "Where a submit comes from: the shell's trusted Submit, or the artifact's code."
+    },
+    "SubmitRequest": {
+      "type": "object",
+      "properties": {
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "expectedRevision": {
+          "$ref": "#/$defs/DocumentRevision"
+        },
+        "channel": {
+          "type": "string",
+          "const": "artifact"
+        }
+      },
+      "required": [
+        "viewId",
+        "expectedRevision",
+        "channel"
+      ],
+      "description": "A browser submit: the view and the draft revision the viewer saw."
+    },
+    "ThreadId": {
+      "type": "string",
+      "pattern": "^thr_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Thread ID: \"thr_\" followed by a 26-character ULID."
+    },
+    "TokenId": {
+      "type": "string",
+      "pattern": "^tok_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Capability token ID: \"tok_\" followed by a 26-character ULID."
+    },
+    "TrustedControl": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,31}$",
+      "description": "A trusted control the shell renders: submit, choose, approve; open for more."
+    },
+    "VerifyVerdict": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "pass",
+            "fail"
+          ]
+        },
+        "artifact": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "path": {
+              "type": "string"
+            },
+            "sourceDigest": {
+              "type": "string"
+            },
+            "envDigest": {
+              "type": "string"
+            },
+            "versionId": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "path",
+            "sourceDigest",
+            "envDigest"
+          ]
+        },
+        "diagnostics": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Diagnostic"
+          }
+        },
+        "screenshots": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "viewport": {
+                "type": "string"
+              },
+              "path": {
+                "type": "string"
+              },
+              "width": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "height": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "tokensEstimate": {
+                "type": "object",
+                "properties": {
+                  "claude": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "gpt": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "gemini": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  }
+                },
+                "required": [
+                  "claude",
+                  "gpt",
+                  "gemini"
+                ]
+              },
+              "returned": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "viewport",
+              "path",
+              "width",
+              "height",
+              "tokensEstimate",
+              "returned"
+            ]
+          }
+        },
+        "aria": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "viewport": {
+                "type": "string"
+              },
+              "path": {
+                "type": "string"
+              },
+              "summary": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "viewport",
+              "path",
+              "summary"
+            ]
+          }
+        },
+        "smoke": {
+          "type": "object",
+          "properties": {
+            "interactions": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "skippedActions": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "stateChanges": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "interactions",
+            "skippedActions",
+            "stateChanges"
+          ]
+        },
+        "regressions": {
+          "type": "object",
+          "properties": {
+            "against": {
+              "type": "string"
+            },
+            "aria": {
+              "type": "string"
+            },
+            "pixels": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "viewport": {
+                    "type": "string"
+                  },
+                  "ratio": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1
+                  }
+                },
+                "required": [
+                  "viewport",
+                  "ratio"
+                ]
+              }
+            },
+            "contracts": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "timingsMs": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "number",
+            "minimum": 0
+          }
+        }
+      },
+      "required": [
+        "status",
+        "artifact",
+        "diagnostics",
+        "screenshots",
+        "aria",
+        "smoke",
+        "regressions",
+        "timingsMs"
+      ],
+      "description": "The verdict of artifact/verify: pass or fail, diagnostics, screenshots with token estimates, ARIA snapshots, the smoke test, regressions and timings."
+    },
+    "VersionId": {
+      "type": "string",
+      "pattern": "^ver_[0-9A-HJKMNP-TV-Z]{26}$",
+      "description": "Version ID: \"ver_\" followed by 26 characters of Crockford base32."
+    },
+    "VersionRef": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/VersionId"
+        },
+        "number": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "id",
+        "number"
+      ],
+      "description": "A version by ID and number."
+    },
+    "VersionSummary": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/VersionId"
+        },
+        "number": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "publishedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        },
+        "sourceDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "envDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "outputDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "forcedDiagnostics": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "collected": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        }
+      },
+      "required": [
+        "id",
+        "number",
+        "publishedAt",
+        "sourceDigest",
+        "envDigest",
+        "outputDigest"
+      ],
+      "description": "One published version."
+    },
+    "ViewContext": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "$ref": "#/$defs/ArtifactId"
+        },
+        "viewId": {
+          "$ref": "#/$defs/ViewId"
+        },
+        "version": {
+          "$ref": "#/$defs/VersionRef"
+        },
+        "latest": {
+          "$ref": "#/$defs/VersionRef"
+        },
+        "policy": {
+          "$ref": "#/$defs/SubmissionPolicy"
+        },
+        "submitChannels": {
+          "readOnly": true,
+          "minItems": 1,
+          "maxItems": 2,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/SubmitChannel"
+          }
+        },
+        "controls": {
+          "readOnly": true,
+          "maxItems": 32,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TrustedControl"
+          }
+        },
+        "target": {
+          "type": "string",
+          "enum": [
+            "live",
+            "static",
+            "mcp-app",
+            "verify"
+          ]
+        }
+      },
+      "required": [
+        "artifactId",
+        "viewId",
+        "version",
+        "latest",
+        "policy",
+        "submitChannels",
+        "controls",
+        "target"
+      ],
+      "description": "What one view is: its artifact, view ID, version, latest version, policy, channels and controls."
+    },
+    "ViewDefaultParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        }
+      },
+      "required": [
+        "artifact"
+      ]
+    },
+    "ViewId": {
+      "type": "string",
+      "pattern": "^vw_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "View ID: \"vw_\" followed by a 26-character ULID."
+    },
+    "ViewLaunchParams": {
+      "type": "object",
+      "properties": {
+        "tokenId": {
+          "$ref": "#/$defs/TokenId"
+        }
+      },
+      "required": [
+        "tokenId"
+      ]
+    },
+    "ViewLaunchResult": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+        }
+      },
+      "required": [
+        "url",
+        "expiresAt"
+      ],
+      "description": "A one-time launch URL for a browser."
+    },
+    "ViewRevokeParams": {
+      "type": "object",
+      "properties": {
+        "tokenId": {
+          "$ref": "#/$defs/TokenId"
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "tokenId"
+      ]
+    },
+    "ViewRevokeResult": {
+      "type": "object",
+      "properties": {}
+    },
+    "ViewRotateParams": {
+      "type": "object",
+      "properties": {
+        "tokenId": {
+          "$ref": "#/$defs/TokenId"
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "tokenId"
+      ]
+    },
+    "ViewUrlParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        },
+        "version": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            {
+              "$ref": "#/$defs/VersionId"
+            }
+          ]
+        },
+        "scopes": {
+          "readOnly": true,
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/CapabilityScope"
+          }
+        },
+        "ttl": {
+          "$ref": "#/$defs/Duration"
+        },
+        "viewer": {
+          "$ref": "#/$defs/ViewerSpec"
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "artifact"
+      ]
+    },
+    "Viewer": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/ViewerId"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "local",
+            "tailnet",
+            "token",
+            "host"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "ref": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "kind"
+      ],
+      "description": "A person who views an artifact: ID, kind, display name and the host's own key."
+    },
+    "ViewerId": {
+      "type": "string",
+      "pattern": "^vwr_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "Viewer ID: \"vwr_\" followed by a 26-character ULID."
+    },
+    "ViewerSpec": {
+      "type": "object",
+      "properties": {
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        }
+      },
+      "required": [
+        "ref"
+      ],
+      "description": "The person a capability link acts for: the host's stable key and a display name."
+    },
+    "WaitCondition": {
+      "type": "string",
+      "pattern": "^(submitted|signal:[A-Za-z0-9][A-Za-z0-9._-]{0,63}|state:[^\\u0000-\\u001f\\u007f]{1,256}|event:[a-z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*(\\.\\*)?)$",
+      "description": "What wait waits for: submitted, signal:<name>, state:<fieldId> or event:<type>."
+    },
+    "WaitParams": {
+      "type": "object",
+      "properties": {
+        "artifact": {
+          "$ref": "#/$defs/ArtifactRef"
+        },
+        "until": {
+          "$ref": "#/$defs/WaitCondition"
+        },
+        "after": {
+          "$ref": "#/$defs/Cursor"
+        },
+        "timeoutMs": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 2147483647
+        }
+      },
+      "required": [
+        "artifact",
+        "until",
+        "timeoutMs"
+      ]
+    },
+    "WaitResult": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "satisfied"
+            },
+            "event": {
+              "$ref": "#/$defs/EventRecord"
+            },
+            "cursor": {
+              "$ref": "#/$defs/Cursor"
+            }
+          },
+          "required": [
+            "status",
+            "event",
+            "cursor"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "still_waiting"
+            },
+            "cursor": {
+              "$ref": "#/$defs/Cursor"
+            }
+          },
+          "required": [
+            "status",
+            "cursor"
+          ]
+        }
+      ]
+    },
+    "WorkerStatus": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "type": "string"
+        },
+        "versionId": {
+          "type": "string"
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "starting",
+            "ready",
+            "backoff",
+            "parked",
+            "stopped"
+          ]
+        },
+        "pid": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "crashes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "lastCause": {
+          "type": "string"
+        },
+        "retryAt": {
+          "type": "string"
+        },
+        "active": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "artifactId",
+        "versionId",
+        "state",
+        "crashes",
+        "active"
+      ],
+      "description": "One artifact version's worker."
+    }
+  }
+}